import { nextLocalHour, QUIET_END_HOUR, QUIET_START_HOUR } from './clock.ts' import { deleteState, OVERRIDE_KEY, setState } from './store.ts' import { computeStatus, parseNow } from './status-core.ts' import type { QuietOverride, QuietStatus } from './types.ts' export type OverrideInput = | { /** 'off' = quiet off until the next 10 PM; 'on' = quiet on now until the next 8 AM; 'clear' = back to the clock. */ mode: 'on' | 'off' | 'clear' /** Who asked (e.g. 'kent' or a bot name), stored for the record. */ by?: string /** Optional ISO instant to treat as now (tests). */ now?: string } | 'on' | 'off' | 'clear' /** Pure: the override record for `mode` set at `now`. */ export function buildOverride(mode: 'on' | 'off', now: Date, by?: string | null): QuietOverride { const expires = mode === 'off' ? nextLocalHour(now, QUIET_START_HOUR) : nextLocalHour(now, QUIET_END_HOUR) return { mode, setAt: now.toISOString(), expiresAt: expires.toISOString(), by: by ?? null } } /** * Kent's quiet-hours override, shared by every bot. * - `'off'` ("quiet off"): quiet hours off until the next 10:00 PM MT. * - `'on'` ("quiet on"): quiet on now, until the next 8:00 AM MT. * - `'clear'`: drop any override; the clock decides again. * * @param input.mode - 'on' | 'off' | 'clear' (a bare string also works) * @returns `{ ok, mode, override, status }` with the resulting status * * @example * import override from 'kody:@kentcdodds/quiet-hours/override' * await override({ mode: 'off', by: 'kent' }) * // => { ok: true, mode: 'off', override: { mode: 'off', expiresAt: '...' }, status: { quiet: false, ... } } */ export default async function override(input: OverrideInput) { const normalized = typeof input === 'string' ? { mode: input } : input const mode = normalized?.mode if (mode !== 'on' && mode !== 'off' && mode !== 'clear') { throw new Error("override mode must be 'on', 'off', or 'clear'.") } const now = parseNow((normalized as { now?: string }).now) if (mode === 'clear') { await deleteState(OVERRIDE_KEY) return { ok: true as const, mode, override: null, status: computeStatus(now, null) as QuietStatus } } const by = (normalized as { by?: string }).by const record = buildOverride(mode, now, typeof by === 'string' ? by.trim() || null : null) await setState(OVERRIDE_KEY, record) return { ok: true as const, mode, override: record, status: computeStatus(now, record) } }