@superpanel-sdk/runtime 0.2.3 → 0.5.0

package/dist/core/office-hours/index.js

@@ -0,0 +1,187 @@
+import { z } from 'zod';
+const WEEKDAYS = ['mon', 'tue', 'wed', 'thu', 'fri', 'sat', 'sun'];
+const windowSchema = z.object({ start: z.string(), end: z.string() }).strict();
+const hoursSchema = z.array(windowSchema);
+const officeHoursSchema = z
+    .object({
+    timezone: z.string(),
+    week: z
+        .object({
+        mon: hoursSchema,
+        tue: hoursSchema,
+        wed: hoursSchema,
+        thu: hoursSchema,
+        fri: hoursSchema,
+        sat: hoursSchema,
+        sun: hoursSchema,
+    })
+        .strict(),
+    holidays: z.array(z.object({ date: z.string(), hours: hoursSchema }).strict()),
+    overrides: z.array(z.object({ date: z.string(), hours: hoursSchema }).strict()),
+})
+    .strict();
+const TIME_RE = /^(?:[01]\d|2[0-3]):[0-5]\d$/;
+const MONTH_DAY_RE = /^(0[1-9]|1[0-2])-(0[1-9]|[12]\d|3[01])$/;
+const YEAR_DATE_RE = /^(\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\d|3[01])$/;
+const DAYS_IN_MONTH = [31, 29, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31];
+const WEEKDAY_FROM_SHORT = {
+    Mon: 'mon',
+    Tue: 'tue',
+    Wed: 'wed',
+    Thu: 'thu',
+    Fri: 'fri',
+    Sat: 'sat',
+    Sun: 'sun',
+};
+function parseClockMinutes(time) {
+    if (time === '24:00')
+        return 24 * 60;
+    if (!TIME_RE.test(time))
+        return null;
+    return Number(time.slice(0, 2)) * 60 + Number(time.slice(3, 5));
+}
+function isIanaTimezone(name) {
+    try {
+        Intl.DateTimeFormat('en-US', { timeZone: name });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function isMonthDay(date) {
+    const match = MONTH_DAY_RE.exec(date);
+    if (!match)
+        return false;
+    return Number(match[2]) <= DAYS_IN_MONTH[Number(match[1]) - 1];
+}
+function isRealDate(date) {
+    const match = YEAR_DATE_RE.exec(date);
+    if (!match)
+        return false;
+    const year = Number(match[1]);
+    const month = Number(match[2]);
+    const day = Number(match[3]);
+    const utc = new Date(Date.UTC(year, month - 1, day));
+    return utc.getUTCFullYear() === year && utc.getUTCMonth() === month - 1 && utc.getUTCDate() === day;
+}
+function validateWindows(hours, path, issues) {
+    const ranges = [];
+    for (const [index, window] of hours.entries()) {
+        const start = parseClockMinutes(window.start);
+        const end = parseClockMinutes(window.end);
+        if (window.start === '24:00' || start == null) {
+            issues.push(`${path}[${index}].start must be HH:mm (00:00–23:59)`);
+            continue;
+        }
+        if (end == null) {
+            issues.push(`${path}[${index}].end must be HH:mm or 24:00`);
+            continue;
+        }
+        if (start >= end) {
+            issues.push(`${path}[${index}].start must be earlier than end`);
+            continue;
+        }
+        ranges.push({ start, end });
+    }
+    ranges.sort((a, b) => a.start - b.start);
+    for (let i = 1; i < ranges.length; i += 1) {
+        if (ranges[i].start < ranges[i - 1].end) {
+            issues.push(`${path} windows must not overlap`);
+            return;
+        }
+    }
+}
+function validateOfficeHoursRules(config) {
+    const issues = [];
+    if (!isIanaTimezone(config.timezone))
+        issues.push(`timezone must be an IANA time zone name`);
+    for (const day of WEEKDAYS)
+        validateWindows(config.week[day], `week.${day}`, issues);
+    const holidayDates = new Set();
+    for (const [index, holiday] of config.holidays.entries()) {
+        if (!isMonthDay(holiday.date))
+            issues.push(`holidays[${index}].date must be MM-DD`);
+        else if (holidayDates.has(holiday.date))
+            issues.push(`holidays date ${holiday.date} is repeated`);
+        else
+            holidayDates.add(holiday.date);
+        validateWindows(holiday.hours, `holidays[${index}].hours`, issues);
+    }
+    const overrideDates = new Set();
+    for (const [index, override] of config.overrides.entries()) {
+        if (!isRealDate(override.date))
+            issues.push(`overrides[${index}].date must be a real YYYY-MM-DD`);
+        else if (overrideDates.has(override.date))
+            issues.push(`overrides date ${override.date} is repeated`);
+        else
+            overrideDates.add(override.date);
+        validateWindows(override.hours, `overrides[${index}].hours`, issues);
+    }
+    return issues;
+}
+export function parseOfficeHours(value) {
+    const shape = officeHoursSchema.safeParse(value);
+    if (!shape.success) {
+        return {
+            ok: false,
+            issues: shape.error.issues.map((issue) => {
+                const path = issue.path.join('.');
+                return path ? `${path}: ${issue.message}` : issue.message;
+            }),
+        };
+    }
+    const issues = validateOfficeHoursRules(shape.data);
+    if (issues.length > 0)
+        return { ok: false, issues };
+    return { ok: true, value: shape.data };
+}
+function localClock(now, timezone) {
+    const parts = Object.fromEntries(new Intl.DateTimeFormat('en-US', {
+        timeZone: timezone,
+        weekday: 'short',
+        year: 'numeric',
+        month: '2-digit',
+        day: '2-digit',
+        hour: '2-digit',
+        minute: '2-digit',
+        hourCycle: 'h23',
+    })
+        .formatToParts(new Date(now))
+        .map((part) => [part.type, part.value]));
+    const weekday = WEEKDAY_FROM_SHORT[parts.weekday ?? ''];
+    if (!weekday)
+        throw new Error(`could not read weekday in ${timezone}`);
+    return {
+        date: `${parts.year}-${parts.month}-${parts.day}`,
+        monthDay: `${parts.month}-${parts.day}`,
+        weekday,
+        minutes: Number(parts.hour) * 60 + Number(parts.minute),
+    };
+}
+function hoursForDate(config, now) {
+    const clock = localClock(now, config.timezone);
+    const override = config.overrides.find((entry) => entry.date === clock.date);
+    if (override)
+        return override.hours;
+    const holiday = config.holidays.find((entry) => entry.date === clock.monthDay);
+    if (holiday)
+        return holiday.hours;
+    return config.week[clock.weekday];
+}
+export function resolveOfficeHours(config, now) {
+    if (!config)
+        return null;
+    const today = hoursForDate(config, now);
+    const clock = localClock(now, config.timezone);
+    return {
+        ...structuredClone(config),
+        open: today.some((window) => {
+            const start = parseClockMinutes(window.start);
+            const end = parseClockMinutes(window.end);
+            return start != null && end != null && clock.minutes >= start && clock.minutes < end;
+        }),
+        today: structuredClone(today),
+    };
+}
+//# sourceMappingURL=index.js.map