Skip to content

Project NOMAD is an offline-first knowledge and education server. Wikipedia, thousands of books, courses, maps, and optional local AI, all running on hardware you own with no internet required.

TypeScript
1.2 KB
Raw Blame
import { DateTime } from 'luxon'

/**
 * Shared update-window helpers used by both the core auto-update
 * ({@link AutoUpdateService}) and the per-app auto-update ({@link AppAutoUpdateService}).
 *
 * The window is interpreted in the container's local time (set via the TZ env var).
 * Windows that wrap past midnight (start > end, e.g. 22:00-02:00) are supported.
 */

/** Parse an "HH:MM" 24-hour string into minutes-since-midnight, or null if malformed. */
export function parseWindowMinutes(hhmm: string): number | null {
  const match = /^([01]\d|2[0-3]):([0-5]\d)$/.exec(hhmm)
  if (!match) return null
  return Number(match[1]) * 60 + Number(match[2])
}

/** Whether `now` falls inside the [windowStart, windowEnd) window (handles midnight wrap). */
export function isWithinWindow(
  windowStart: string,
  windowEnd: string,
  now: DateTime = DateTime.now()
): boolean {
  const start = parseWindowMinutes(windowStart)
  const end = parseWindowMinutes(windowEnd)
  if (start === null || end === null) return false

  const current = now.hour * 60 + now.minute
  if (start === end) return false // zero-length window
  if (start < end) {
    return current >= start && current < end
  }
  // Wraps midnight
  return current >= start || current < end
}