@j13b/scheduler 0.1.0 → 0.1.1

package/README.md

@@ -63,6 +63,7 @@ See [`src/index.ts`](./src/index.ts) for the full export list. Notable types:
 
 - `RecurrenceRule` — discriminated union over the nine rule kinds.
 - `ScheduleTemplate` — `{ id, rule, timezone, disambiguation?, payload }`. `timezone` is required and validated at write time (use `"UTC"` for zone-free scheduling; it's ignored by the absolute `instant`/`anchored` rules).
+- `validateRule(rule)` — checks a rule's whole shape (every required field present, typed and in range; no fields its kind lacks) and throws an `Error` naming the field and the form it expects. `Scheduler.add`/`update` run it, so a rule from JSON or an LLM fails with a clear message instead of crashing a generator. `validateTimeSpan` and `RULE_KINDS` are exported too.
 - `ScheduledEvent` — `{ templateId, occurrenceKey, startTimestamp, endTimestamp, payload, alterationId? }`.
 - `Disambiguation` — DST-edge resolution policy: `"compatible" | "earlier" | "later" | "reject" | "skip"`.
 - `SchedulerPort` — async storage interface; an `InMemorySchedulerPort` ships with the package.

package/dist/cjs/index.d.ts

@@ -4,3 +4,4 @@ export type { SchedulerPort } from "./port.js";
 export { Dispatcher, type DispatcherConfig } from "./dispatcher.js";
 export { type DispatcherStore, InMemoryDispatcherStore } from "./dispatcher_store.js";
 export { Day, Month, type RecurrenceRule, type InstantRule, type LocalDateTimeRule, type AnchoredRule, type DaysOfWeekRule, type WeeksOfMonthRule, type MonthsOfYearRule, type YearlyRule, type DaysOfMonthRule, type DaysOfYearRule, type ScheduleTemplate, type Alteration, type ScheduledEvent, type TimeSpan, type Disambiguation, } from "./types.js";
+export { RULE_KINDS, validateRule, validateTimeSpan } from "./validate_rule.js";

package/dist/cjs/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Month = exports.Day = exports.InMemoryDispatcherStore = exports.Dispatcher = exports.InMemorySchedulerPort = exports.Scheduler = void 0;
+exports.validateTimeSpan = exports.validateRule = exports.RULE_KINDS = exports.Month = exports.Day = exports.InMemoryDispatcherStore = exports.Dispatcher = exports.InMemorySchedulerPort = exports.Scheduler = void 0;
 var scheduler_js_1 = require("./scheduler.js");
 Object.defineProperty(exports, "Scheduler", { enumerable: true, get: function () { return scheduler_js_1.Scheduler; } });
 var in_memory_port_js_1 = require("./in_memory_port.js");
@@ -12,3 +12,7 @@ Object.defineProperty(exports, "InMemoryDispatcherStore", { enumerable: true, ge
 var types_js_1 = require("./types.js");
 Object.defineProperty(exports, "Day", { enumerable: true, get: function () { return types_js_1.Day; } });
 Object.defineProperty(exports, "Month", { enumerable: true, get: function () { return types_js_1.Month; } });
+var validate_rule_js_1 = require("./validate_rule.js");
+Object.defineProperty(exports, "RULE_KINDS", { enumerable: true, get: function () { return validate_rule_js_1.RULE_KINDS; } });
+Object.defineProperty(exports, "validateRule", { enumerable: true, get: function () { return validate_rule_js_1.validateRule; } });
+Object.defineProperty(exports, "validateTimeSpan", { enumerable: true, get: function () { return validate_rule_js_1.validateTimeSpan; } });

package/dist/cjs/scheduler.d.ts

@@ -1,6 +1,6 @@
 import { type IEventBroadcast } from "@j13b/state";
 import type { SchedulerPort } from "./port.js";
-import type { RecurrenceRule, ScheduleTemplate, ScheduledEvent, TimeSpan } from "./types.js";
+import type { ScheduleTemplate, ScheduledEvent, TimeSpan } from "./types.js";
 export declare class Scheduler<TPayload extends {
     type: string;
 }> {
@@ -21,4 +21,3 @@ export declare class Scheduler<TPayload extends {
     private _generateKeyed;
     private _removeExistingAlteration;
 }
-export declare function validateRule(rule: RecurrenceRule): void;

package/dist/cjs/scheduler.js

@@ -1,7 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Scheduler = void 0;
-exports.validateRule = validateRule;
 const state_1 = require("@j13b/state");
 const alterations_js_1 = require("./alterations.js");
 const anchored_js_1 = require("./generators/anchored.js");
@@ -15,6 +14,7 @@ const weeks_of_month_js_1 = require("./generators/weeks_of_month.js");
 const yearly_js_1 = require("./generators/yearly.js");
 const occurrence_key_js_1 = require("./occurrence_key.js");
 const tz_js_1 = require("./tz.js");
+const validate_rule_js_1 = require("./validate_rule.js");
 const DAY_MS = 24 * 60 * 60 * 1000;
 // Search horizon for next() / nextDue() before giving up. Five years covers
 // every realistic use; if you need longer, call list() with an explicit
@@ -100,7 +100,7 @@ class Scheduler {
     }
     // ─── Writes ─────────────────────────────────────────────────
     async add(template) {
-        validateRule(template.rule);
+        (0, validate_rule_js_1.validateRule)(template.rule);
         _validateTimezone(template.timezone);
         _validateDisambiguation(template.disambiguation);
         const normalized = {
@@ -122,7 +122,7 @@ class Scheduler {
             ...delta,
             id: delta.id,
         };
-        validateRule(merged.rule);
+        (0, validate_rule_js_1.validateRule)(merged.rule);
         _validateTimezone(merged.timezone);
         _validateDisambiguation(merged.disambiguation);
         const updated = {
@@ -148,7 +148,7 @@ class Scheduler {
     // in time but keeps the same length).
     async reschedule(templateId, occurrenceKey, newStart, newTimeSpan, payloadOverride) {
         if (newTimeSpan != null)
-            _validateTimeSpan(newTimeSpan);
+            (0, validate_rule_js_1.validateTimeSpan)(newTimeSpan);
         const id = `alt-${templateId}-${occurrenceKey}-${Date.now()}`;
         await this._removeExistingAlteration(templateId, occurrenceKey);
         const alt = {
@@ -232,153 +232,6 @@ class Scheduler {
 }
 exports.Scheduler = Scheduler;
 // ─── Validation ───────────────────────────────────────────────
-function validateRule(rule) {
-    switch (rule.kind) {
-        case "instant":
-            _validateTimeSpan(rule.timeSpan);
-            return;
-        case "localDateTime":
-            if (!Number.isInteger(rule.year)) {
-                throw new Error("LocalDateTimeRule.year must be an integer");
-            }
-            if (rule.month < 0 || rule.month > 11) {
-                throw new Error("LocalDateTimeRule.month must be in 0..11");
-            }
-            if (rule.day < 1 || rule.day > 31)
-                throw new Error("LocalDateTimeRule.day must be in 1..31");
-            _validateTimeOfDay(rule.timeOfDay);
-            _validateTimeSpan(rule.timeSpan);
-            return;
-        case "anchored":
-            if (rule.intervalMs <= 0)
-                throw new Error("AnchoredRule.intervalMs must be > 0");
-            _validateTimeSpan(rule.timeSpan);
-            _validateSeries(rule.seriesStart, rule.seriesEnd, rule.count);
-            return;
-        case "daysOfWeek":
-            if (rule.weekInterval <= 0)
-                throw new Error("DaysOfWeekRule.weekInterval must be > 0");
-            if (rule.days.length === 0)
-                throw new Error("DaysOfWeekRule.days must be non-empty");
-            _validateTimeOfDay(rule.timeOfDay);
-            _validateTimeSpan(rule.timeSpan);
-            _validateSeries(rule.seriesStart, rule.seriesEnd, rule.count);
-            return;
-        case "weeksOfMonth":
-            if (rule.monthInterval <= 0)
-                throw new Error("WeeksOfMonthRule.monthInterval must be > 0");
-            if (rule.weeks.length === 0)
-                throw new Error("WeeksOfMonthRule.weeks must be non-empty");
-            for (const w of rule.weeks) {
-                if (w === 0 || w < -5 || w > 5) {
-                    throw new Error("WeeksOfMonthRule.weeks entries must be in [-5..-1] or [1..5]");
-                }
-            }
-            if (rule.days.length === 0)
-                throw new Error("WeeksOfMonthRule.days must be non-empty");
-            _validateTimeOfDay(rule.timeOfDay);
-            _validateTimeSpan(rule.timeSpan);
-            _validateSeries(rule.seriesStart, rule.seriesEnd, rule.count);
-            return;
-        case "monthsOfYear":
-            if (rule.yearInterval <= 0)
-                throw new Error("MonthsOfYearRule.yearInterval must be > 0");
-            if (rule.months.length === 0)
-                throw new Error("MonthsOfYearRule.months must be non-empty");
-            for (const m of rule.months) {
-                if (m < 0 || m > 11) {
-                    throw new Error("MonthsOfYearRule.months entries must be in 0..11");
-                }
-            }
-            if (rule.weeks.length === 0)
-                throw new Error("MonthsOfYearRule.weeks must be non-empty");
-            for (const w of rule.weeks) {
-                if (w === 0 || w < -5 || w > 5) {
-                    throw new Error("MonthsOfYearRule.weeks entries must be in [-5..-1] or [1..5]");
-                }
-            }
-            if (rule.days.length === 0)
-                throw new Error("MonthsOfYearRule.days must be non-empty");
-            _validateTimeOfDay(rule.timeOfDay);
-            _validateTimeSpan(rule.timeSpan);
-            _validateSeries(rule.seriesStart, rule.seriesEnd, rule.count);
-            return;
-        case "yearly":
-            if (rule.yearInterval <= 0)
-                throw new Error("YearlyRule.yearInterval must be > 0");
-            if (rule.month < 0 || rule.month > 11) {
-                throw new Error("YearlyRule.month must be in 0..11");
-            }
-            if (rule.day < 1 || rule.day > 31)
-                throw new Error("YearlyRule.day must be in 1..31");
-            _validateTimeOfDay(rule.timeOfDay);
-            _validateTimeSpan(rule.timeSpan);
-            _validateSeries(rule.seriesStart, rule.seriesEnd, rule.count);
-            return;
-        case "daysOfMonth":
-            if (rule.yearInterval <= 0)
-                throw new Error("DaysOfMonthRule.yearInterval must be > 0");
-            if (rule.months.length === 0)
-                throw new Error("DaysOfMonthRule.months must be non-empty");
-            for (const m of rule.months) {
-                if (m < 0 || m > 11) {
-                    throw new Error("DaysOfMonthRule.months entries must be in 0..11");
-                }
-            }
-            if (rule.daysOfMonth.length === 0) {
-                throw new Error("DaysOfMonthRule.daysOfMonth must be non-empty");
-            }
-            for (const d of rule.daysOfMonth) {
-                if (d < 1 || d > 31) {
-                    throw new Error("DaysOfMonthRule.daysOfMonth entries must be in 1..31");
-                }
-            }
-            _validateTimeOfDay(rule.timeOfDay);
-            _validateTimeSpan(rule.timeSpan);
-            _validateSeries(rule.seriesStart, rule.seriesEnd, rule.count);
-            return;
-        case "daysOfYear":
-            if (rule.yearInterval <= 0)
-                throw new Error("DaysOfYearRule.yearInterval must be > 0");
-            if (rule.daysOfYear.length === 0) {
-                throw new Error("DaysOfYearRule.daysOfYear must be non-empty");
-            }
-            for (const d of rule.daysOfYear) {
-                if (d < 1 || d > 366) {
-                    throw new Error("DaysOfYearRule.daysOfYear entries must be in 1..366");
-                }
-            }
-            _validateTimeOfDay(rule.timeOfDay);
-            _validateTimeSpan(rule.timeSpan);
-            _validateSeries(rule.seriesStart, rule.seriesEnd, rule.count);
-            return;
-        default: {
-            const _exhaustive = rule;
-            throw new Error(`Unknown rule kind: ${JSON.stringify(_exhaustive)}`);
-        }
-    }
-}
-// Validates the TimeSpan shape. Throws on { type: "duration", ms < 1 } or
-// { type: "hourSpan", hours <= 0 }. Undefined is valid (defaults to 1ms).
-function _validateTimeSpan(span) {
-    if (span == null)
-        return;
-    if (span.type === "duration") {
-        if (span.ms < 1) {
-            throw new Error(`timeSpan.ms must be >= 1 if supplied (got ${span.ms})`);
-        }
-        return;
-    }
-    if (span.type === "hourSpan") {
-        if (!Number.isFinite(span.hours) || span.hours <= 0) {
-            throw new Error(`timeSpan.hours must be > 0 (got ${span.hours})`);
-        }
-        return;
-    }
-    // Exhaustiveness — TS will flag a missing case if TimeSpan grows.
-    const _exhaustive = span;
-    throw new Error(`Unknown TimeSpan type: ${JSON.stringify(_exhaustive)}`);
-}
 // Returns a copy of `rule` with timeSpan defaulted when omitted, so
 // generators don't have to handle undefined repeatedly.
 function _normalizeRule(rule) {
@@ -408,17 +261,6 @@ function _validateDisambiguation(d) {
         throw new Error(`Unknown disambiguation '${d}' (expected one of ${_DISAMBIGUATIONS.join(", ")})`);
     }
 }
-function _validateTimeOfDay(ms) {
-    if (ms < 0 || ms >= 24 * 60 * 60 * 1000) {
-        throw new Error(`timeOfDay must be in [0, 86_400_000) (got ${ms})`);
-    }
-}
-function _validateSeries(start, end, count) {
-    if (end != null && end <= start)
-        throw new Error("seriesEnd must be > seriesStart");
-    if (count != null && count < 0)
-        throw new Error("count must be >= 0");
-}
 function _rulesEqual(a, b) {
     return JSON.stringify(_canonicalize(a)) === JSON.stringify(_canonicalize(b));
 }

package/dist/cjs/validate_rule.d.ts

@@ -0,0 +1,4 @@
+import type { RecurrenceRule, TimeSpan } from "./types.js";
+export declare const RULE_KINDS: RecurrenceRule["kind"][];
+export declare function validateRule(rule: RecurrenceRule): void;
+export declare function validateTimeSpan(span: unknown): asserts span is TimeSpan | undefined;

package/dist/cjs/validate_rule.js

@@ -0,0 +1,267 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RULE_KINDS = void 0;
+exports.validateRule = validateRule;
+exports.validateTimeSpan = validateTimeSpan;
+// ─── Rule validation ──────────────────────────────────────────
+//
+// A rule often comes from outside the type system: JSON in a database, a
+// request body, or an LLM tool call. So validation checks the WHOLE shape —
+// every required field present, of the right type, in range, and no fields
+// the kind does not have — and throws an Error that names the field and the
+// form it expects. A bad rule never reaches a generator, where it would crash
+// with "Cannot read properties of undefined" or "Invalid time value".
+const DAY_MS = 24 * 60 * 60 * 1000;
+const DAYS_HINT = "Day numbers 0..6 (0=Sunday, 1=Monday … 6=Saturday)";
+const MONTHS_HINT = "Month numbers 0..11 (0=January … 11=December)";
+const WEEKS_HINT = "week-of-month numbers 1..5 (1=first) or -1..-5 (-1=last)";
+const TIME_OF_DAY_HINT = "ms after local midnight, 0..86_399_999 (7:00 = 25_200_000)";
+const TIMESTAMP_HINT = "a UTC timestamp in ms";
+// The common series fields every repeating kind has.
+const SERIES = {
+    timeSpan: { required: false, check: (v) => validateTimeSpan(v) },
+    seriesStart: { required: true, check: timestamp },
+    seriesEnd: { required: true, check: nullable(timestamp, "null (no end)") },
+    count: {
+        required: false,
+        check: nullable(int(0, Number.MAX_SAFE_INTEGER, "a whole number >= 0"), "null"),
+    },
+};
+const TIME_OF_DAY = { required: true, check: int(0, DAY_MS - 1, TIME_OF_DAY_HINT) };
+const KINDS = {
+    instant: {
+        name: "InstantRule",
+        fields: {
+            startOn: { required: true, check: timestamp },
+            timeSpan: { required: false, check: (v) => validateTimeSpan(v) },
+        },
+    },
+    localDateTime: {
+        name: "LocalDateTimeRule",
+        fields: {
+            year: { required: true, check: int(1, 9999, "a year such as 2026") },
+            month: { required: true, check: int(0, 11, MONTHS_HINT) },
+            day: { required: true, check: int(1, 31, "a day of the month 1..31") },
+            timeOfDay: TIME_OF_DAY,
+            timeSpan: { required: false, check: (v) => validateTimeSpan(v) },
+        },
+    },
+    anchored: {
+        name: "AnchoredRule",
+        fields: {
+            anchorDate: { required: true, check: timestamp },
+            intervalMs: { required: true, check: positive("an interval in ms > 0") },
+            ...SERIES,
+        },
+    },
+    daysOfWeek: {
+        name: "DaysOfWeekRule",
+        fields: {
+            days: { required: true, check: intList(0, 6, DAYS_HINT) },
+            weekInterval: {
+                required: true,
+                check: int(1, Number.MAX_SAFE_INTEGER, "a whole number >= 1 (1 = every week)"),
+            },
+            timeOfDay: TIME_OF_DAY,
+            ...SERIES,
+        },
+    },
+    weeksOfMonth: {
+        name: "WeeksOfMonthRule",
+        fields: {
+            days: { required: true, check: intList(0, 6, DAYS_HINT) },
+            weeks: { required: true, check: weekList },
+            monthInterval: {
+                required: true,
+                check: int(1, Number.MAX_SAFE_INTEGER, "a whole number >= 1 (1 = every month)"),
+            },
+            timeOfDay: TIME_OF_DAY,
+            ...SERIES,
+        },
+    },
+    monthsOfYear: {
+        name: "MonthsOfYearRule",
+        fields: {
+            months: { required: true, check: intList(0, 11, MONTHS_HINT) },
+            weeks: { required: true, check: weekList },
+            days: { required: true, check: intList(0, 6, DAYS_HINT) },
+            yearInterval: {
+                required: true,
+                check: int(1, Number.MAX_SAFE_INTEGER, "a whole number >= 1 (1 = every year)"),
+            },
+            timeOfDay: TIME_OF_DAY,
+            ...SERIES,
+        },
+    },
+    yearly: {
+        name: "YearlyRule",
+        fields: {
+            month: { required: true, check: int(0, 11, MONTHS_HINT) },
+            day: { required: true, check: int(1, 31, "a day of the month 1..31") },
+            yearInterval: {
+                required: true,
+                check: int(1, Number.MAX_SAFE_INTEGER, "a whole number >= 1 (1 = every year)"),
+            },
+            timeOfDay: TIME_OF_DAY,
+            ...SERIES,
+        },
+    },
+    daysOfMonth: {
+        name: "DaysOfMonthRule",
+        fields: {
+            months: { required: true, check: intList(0, 11, MONTHS_HINT) },
+            daysOfMonth: { required: true, check: intList(1, 31, "days of the month 1..31") },
+            yearInterval: {
+                required: true,
+                check: int(1, Number.MAX_SAFE_INTEGER, "a whole number >= 1 (1 = every year)"),
+            },
+            timeOfDay: TIME_OF_DAY,
+            ...SERIES,
+        },
+    },
+    daysOfYear: {
+        name: "DaysOfYearRule",
+        fields: {
+            daysOfYear: { required: true, check: intList(1, 366, "days of the year 1..366") },
+            yearInterval: {
+                required: true,
+                check: int(1, Number.MAX_SAFE_INTEGER, "a whole number >= 1 (1 = every year)"),
+            },
+            timeOfDay: TIME_OF_DAY,
+            ...SERIES,
+        },
+    },
+};
+// The rule kinds, in the order the types declare them.
+exports.RULE_KINDS = Object.keys(KINDS);
+// Throws when `rule` is not a valid RecurrenceRule. The message names the
+// first wrong field and the form it expects.
+function validateRule(rule) {
+    const raw = rule;
+    if (typeof raw !== "object" || raw == null || Array.isArray(raw)) {
+        throw new Error(`A rule must be an object with a "kind" (one of ${exports.RULE_KINDS.join(", ")})`);
+    }
+    const obj = raw;
+    const kind = KINDS[obj.kind];
+    if (kind == null) {
+        throw new Error(`Unknown rule kind ${JSON.stringify(obj.kind)} (expected one of ${exports.RULE_KINDS.join(", ")})`);
+    }
+    const known = Object.keys(kind.fields);
+    for (const key of Object.keys(obj)) {
+        if (key !== "kind" && !known.includes(key)) {
+            throw new Error(`${kind.name} has no field "${key}" (its fields are: ${known.join(", ")})`);
+        }
+    }
+    for (const [field, spec] of Object.entries(kind.fields)) {
+        const label = `${kind.name}.${field}`;
+        if (obj[field] === undefined) {
+            if (spec.required)
+                throw new Error(`${label} is required: ${describe(spec, label)}`);
+            continue;
+        }
+        spec.check(obj[field], label);
+    }
+    const seriesStart = obj.seriesStart;
+    const seriesEnd = obj.seriesEnd;
+    if (seriesStart != null && seriesEnd != null && seriesEnd <= seriesStart) {
+        throw new Error(`${kind.name}.seriesEnd must be > seriesStart`);
+    }
+}
+// Throws when `span` is not a TimeSpan. Undefined is valid (the rule's
+// default span applies).
+function validateTimeSpan(span) {
+    if (span === undefined)
+        return;
+    const form = '{ "type": "duration", "ms": <ms >= 1> } or { "type": "hourSpan", "hours": <hours > 0> }';
+    if (typeof span !== "object" || span == null) {
+        throw new Error(`timeSpan must be ${form}`);
+    }
+    const s = span;
+    if (s.type === "duration") {
+        if (typeof s.ms !== "number" || !Number.isFinite(s.ms) || s.ms < 1) {
+            throw new Error(`timeSpan.ms must be >= 1 if supplied (got ${String(s.ms)})`);
+        }
+        return;
+    }
+    if (s.type === "hourSpan") {
+        if (typeof s.hours !== "number" || !Number.isFinite(s.hours) || s.hours <= 0) {
+            throw new Error(`timeSpan.hours must be > 0 (got ${String(s.hours)})`);
+        }
+        return;
+    }
+    throw new Error(`timeSpan must be ${form} (got type ${JSON.stringify(s.type)})`);
+}
+// ─── Field checks ─────────────────────────────────────────────
+// What the field should hold, for "is required" messages: each check is
+// called on undefined and its message reused.
+function describe(spec, label) {
+    try {
+        spec.check(undefined, label);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        const at = msg.indexOf(" must be ");
+        if (at >= 0)
+            return msg.slice(at + " must be ".length).replace(/ \(got [^)]*\)$/, "");
+    }
+    return "see the rule's type";
+}
+function show(v) {
+    return v === undefined ? "nothing" : JSON.stringify(v);
+}
+function isInt(v) {
+    return typeof v === "number" && Number.isInteger(v);
+}
+function int(min, max, hint) {
+    return (v, field) => {
+        if (!isInt(v) || v < min || v > max)
+            throw new Error(`${field} must be ${hint} (got ${show(v)})`);
+    };
+}
+function positive(hint) {
+    return (v, field) => {
+        if (typeof v !== "number" || !Number.isFinite(v) || v <= 0) {
+            throw new Error(`${field} must be ${hint} (got ${show(v)})`);
+        }
+    };
+}
+function timestamp(v, field) {
+    if (typeof v !== "number" || !Number.isFinite(v)) {
+        throw new Error(`${field} must be ${TIMESTAMP_HINT} (got ${show(v)})`);
+    }
+}
+function nullable(check, nullHint) {
+    return (v, field) => {
+        if (v === null)
+            return;
+        try {
+            check(v, field);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            throw new Error(msg.replace(/ \(got /, ` or ${nullHint} (got `));
+        }
+    };
+}
+function intList(min, max, hint) {
+    return (v, field) => {
+        const form = `a non-empty array of ${hint}`;
+        if (!Array.isArray(v) || v.length === 0)
+            throw new Error(`${field} must be ${form} (got ${show(v)})`);
+        for (const x of v) {
+            if (!isInt(x) || x < min || x > max) {
+                throw new Error(`${field} must be ${form} (got ${show(v)}; ${show(x)} is out of range)`);
+            }
+        }
+    };
+}
+function weekList(v, field) {
+    const form = `a non-empty array of ${WEEKS_HINT}`;
+    if (!Array.isArray(v) || v.length === 0)
+        throw new Error(`${field} must be ${form} (got ${show(v)})`);
+    for (const w of v) {
+        if (!isInt(w) || w === 0 || w < -5 || w > 5) {
+            throw new Error(`${field} must be ${form} (got ${show(v)}; ${show(w)} is out of range)`);
+        }
+    }
+}

package/dist/index.d.ts

@@ -4,4 +4,5 @@ export type { SchedulerPort } from './port.js';
 export { Dispatcher, type DispatcherConfig } from './dispatcher.js';
 export { type DispatcherStore, InMemoryDispatcherStore } from './dispatcher_store.js';
 export { Day, Month, type RecurrenceRule, type InstantRule, type LocalDateTimeRule, type AnchoredRule, type DaysOfWeekRule, type WeeksOfMonthRule, type MonthsOfYearRule, type YearlyRule, type DaysOfMonthRule, type DaysOfYearRule, type ScheduleTemplate, type Alteration, type ScheduledEvent, type TimeSpan, type Disambiguation, } from './types.js';
+export { RULE_KINDS, validateRule, validateTimeSpan } from './validate_rule.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,YAAY,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACpE,OAAO,EAAE,KAAK,eAAe,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AACtF,OAAO,EACL,GAAG,EACH,KAAK,EACL,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,QAAQ,EACb,KAAK,cAAc,GACpB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,YAAY,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACpE,OAAO,EAAE,KAAK,eAAe,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AACtF,OAAO,EACL,GAAG,EACH,KAAK,EACL,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,QAAQ,EACb,KAAK,cAAc,GACpB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -3,4 +3,5 @@ import { InMemorySchedulerPort } from "./in_memory_port.js";
 import { Dispatcher } from "./dispatcher.js";
 import { InMemoryDispatcherStore } from "./dispatcher_store.js";
 import { Day, Month } from "./types.js";
-export { Day, Dispatcher, InMemoryDispatcherStore, InMemorySchedulerPort, Month, Scheduler };
+import { RULE_KINDS, validateRule, validateTimeSpan } from "./validate_rule.js";
+export { Day, Dispatcher, InMemoryDispatcherStore, InMemorySchedulerPort, Month, RULE_KINDS, Scheduler, validateRule, validateTimeSpan };

package/dist/scheduler.d.ts

@@ -1,6 +1,6 @@
 import { IEventBroadcast } from '@j13b/state';
 import { SchedulerPort } from './port.js';
-import { RecurrenceRule, ScheduleTemplate, ScheduledEvent, TimeSpan } from './types.js';
+import { ScheduleTemplate, ScheduledEvent, TimeSpan } from './types.js';
 export declare class Scheduler<TPayload extends {
     type: string;
 }> {
@@ -21,5 +21,4 @@ export declare class Scheduler<TPayload extends {
     private _generateKeyed;
     private _removeExistingAlteration;
 }
-export declare function validateRule(rule: RecurrenceRule): void;
 //# sourceMappingURL=scheduler.d.ts.map

package/dist/scheduler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../src/scheduler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAa1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,KAAK,EAGV,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,QAAQ,EACT,MAAM,YAAY,CAAC;AASpB,qBAAa,SAAS,CAAC,QAAQ,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE;IACtD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA0B;IAIhD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;gBAElC,IAAI,EAAE,aAAa,CAAC,QAAQ,CAAC;IAIzC,IAAI,OAAO,IAAI,eAAe,CAAC,IAAI,CAAC,CAEnC;IAMK,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,CAAC;IA0BjF,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;IA+BjF,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,CAAC;IAuBvE,GAAG,CAAC,QAAQ,EAAE,gBAAgB,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAexD,MAAM,CACV,KAAK,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,CAAC,GACtE,OAAO,CAAC,IAAI,CAAC;IAuBV,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWjC,UAAU,CACd,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,QAAQ,EACtB,eAAe,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,GAClC,OAAO,CAAC,MAAM,CAAC;IAkBZ,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAgBxE,OAAO,CAAC,cAAc;YA4CR,yBAAyB;CAWxC;AAID,wBAAgB,YAAY,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CA6GvD"}
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../src/scheduler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAa1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,KAAK,EAIV,gBAAgB,EAChB,cAAc,EACd,QAAQ,EACT,MAAM,YAAY,CAAC;AAUpB,qBAAa,SAAS,CAAC,QAAQ,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE;IACtD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA0B;IAIhD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;gBAElC,IAAI,EAAE,aAAa,CAAC,QAAQ,CAAC;IAIzC,IAAI,OAAO,IAAI,eAAe,CAAC,IAAI,CAAC,CAEnC;IAMK,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,CAAC;IA0BjF,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;IA+BjF,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,CAAC;IAuBvE,GAAG,CAAC,QAAQ,EAAE,gBAAgB,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAexD,MAAM,CACV,KAAK,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,CAAC,GACtE,OAAO,CAAC,IAAI,CAAC;IAuBV,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWjC,UAAU,CACd,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,QAAQ,EACtB,eAAe,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,GAClC,OAAO,CAAC,MAAM,CAAC;IAkBZ,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAgBxE,OAAO,CAAC,cAAc;YA4CR,yBAAyB;CAWxC"}