@j13b/scheduler 0.0.0-stage → 0.1.1

package/dist/generators/yearly.js

@@ -0,0 +1,37 @@
+import { computeSpanEnd, isNonexistentWallTime, monthLength, utcToWallParts, wallTimeToUtc } from "../tz.js";
+import { TooManyOccurrencesError, intersects } from "./types.js";
+// src/generators/yearly.ts
+function generateYearly(rule, tz, windowStart, windowEnd, disambiguation = "compatible") {
+	if (rule.yearInterval <= 0) throw new Error(`YearlyRule.yearInterval must be > 0 (got ${rule.yearInterval})`);
+	if (rule.month < 0 || rule.month > 11) throw new Error(`YearlyRule.month must be in 0..11 (got ${rule.month})`);
+	if (rule.day < 1 || rule.day > 31) throw new Error(`YearlyRule.day must be in 1..31 (got ${rule.day})`);
+	if (rule.count != null && rule.count < 0) throw new Error(`YearlyRule.count must be >= 0 (got ${rule.count})`);
+	const seriesEnd = rule.seriesEnd ?? Number.POSITIVE_INFINITY;
+	const effectiveEnd = Math.min(windowEnd, seriesEnd);
+	if (rule.seriesStart >= effectiveEnd) return [];
+	const startYear = utcToWallParts(rule.seriesStart, tz).year;
+	const endYear = utcToWallParts(Math.min(effectiveEnd, Number.MAX_SAFE_INTEGER), tz).year;
+	const out = [];
+	let count = 0;
+	for (let year = startYear; year <= endYear; year += rule.yearInterval) {
+		const day = Math.min(rule.day, monthLength(year, rule.month));
+		if (disambiguation === "skip" && isNonexistentWallTime(year, rule.month, day, rule.timeOfDay, tz)) continue;
+		const occStart = wallTimeToUtc(year, rule.month, day, rule.timeOfDay, tz, disambiguation);
+		const occEnd = computeSpanEnd(occStart, rule.timeSpan, tz);
+		if (occStart < rule.seriesStart) continue;
+		if (occStart >= seriesEnd) continue;
+		if (rule.count != null && count >= rule.count) break;
+		count++;
+		if (intersects(occStart, occEnd, windowStart, windowEnd)) {
+			out.push({
+				startTimestamp: occStart,
+				endTimestamp: occEnd
+			});
+			if (out.length > 1e4) throw new TooManyOccurrencesError("yearly");
+		}
+	}
+	return out;
+}
+export { generateYearly };
+
+//# sourceMappingURL=yearly.js.map

package/dist/generators/yearly.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"yearly.js","names":[],"sources":["../../src/generators/yearly.ts"],"sourcesContent":["import type { Disambiguation, YearlyRule } from \"../types.js\";\nimport {\n  computeSpanEnd,\n  isNonexistentWallTime,\n  monthLength,\n  utcToWallParts,\n  wallTimeToUtc,\n} from \"../tz.js\";\nimport {\n  MAX_OCCURRENCES_PER_GENERATE,\n  type Occurrence,\n  TooManyOccurrencesError,\n  intersects,\n} from \"./types.js\";\n\n// Simple yearly recurrence: a single month + day. Day clamps to month\n// length (Feb 29 → Feb 28 in non-leap years, Apr 31 → Apr 30, etc.).\nexport function generateYearly(\n  rule: YearlyRule,\n  tz: string | undefined,\n  windowStart: number,\n  windowEnd: number,\n  disambiguation: Disambiguation = \"compatible\"\n): Occurrence[] {\n  if (rule.yearInterval <= 0) {\n    throw new Error(`YearlyRule.yearInterval must be > 0 (got ${rule.yearInterval})`);\n  }\n  if (rule.month < 0 || rule.month > 11) {\n    throw new Error(`YearlyRule.month must be in 0..11 (got ${rule.month})`);\n  }\n  if (rule.day < 1 || rule.day > 31) {\n    throw new Error(`YearlyRule.day must be in 1..31 (got ${rule.day})`);\n  }\n  if (rule.count != null && rule.count < 0) {\n    throw new Error(`YearlyRule.count must be >= 0 (got ${rule.count})`);\n  }\n\n  const seriesEnd = rule.seriesEnd ?? Number.POSITIVE_INFINITY;\n  const effectiveEnd = Math.min(windowEnd, seriesEnd);\n  if (rule.seriesStart >= effectiveEnd) return [];\n\n  const startYear = utcToWallParts(rule.seriesStart, tz).year;\n  const endYear = utcToWallParts(Math.min(effectiveEnd, Number.MAX_SAFE_INTEGER), tz).year;\n\n  const out: Occurrence[] = [];\n  let count = 0;\n\n  for (let year = startYear; year <= endYear; year += rule.yearInterval) {\n    const day = Math.min(rule.day, monthLength(year, rule.month));\n    if (\n      disambiguation === \"skip\" &&\n      isNonexistentWallTime(year, rule.month, day, rule.timeOfDay, tz)\n    ) {\n      continue;\n    }\n    const occStart = wallTimeToUtc(year, rule.month, day, rule.timeOfDay, tz, disambiguation);\n    const occEnd = computeSpanEnd(occStart, rule.timeSpan, tz);\n\n    if (occStart < rule.seriesStart) continue;\n    if (occStart >= seriesEnd) continue;\n\n    if (rule.count != null && count >= rule.count) break;\n    count++;\n\n    if (intersects(occStart, occEnd, windowStart, windowEnd)) {\n      out.push({ startTimestamp: occStart, endTimestamp: occEnd });\n      if (out.length > MAX_OCCURRENCES_PER_GENERATE) {\n        throw new TooManyOccurrencesError(\"yearly\");\n      }\n    }\n  }\n  return out;\n}\n"],"mappings":";;;AAiBA,SAAgB,eACd,MACA,IACA,aACA,WACA,iBAAiC,cACnB;CACd,IAAI,KAAK,gBAAgB,GACvB,MAAM,IAAI,MAAM,4CAA4C,KAAK,aAAa,EAAE;CAElF,IAAI,KAAK,QAAQ,KAAK,KAAK,QAAQ,IACjC,MAAM,IAAI,MAAM,0CAA0C,KAAK,MAAM,EAAE;CAEzE,IAAI,KAAK,MAAM,KAAK,KAAK,MAAM,IAC7B,MAAM,IAAI,MAAM,wCAAwC,KAAK,IAAI,EAAE;CAErE,IAAI,KAAK,SAAS,QAAQ,KAAK,QAAQ,GACrC,MAAM,IAAI,MAAM,sCAAsC,KAAK,MAAM,EAAE;CAGrE,MAAM,YAAY,KAAK,aAAa,OAAO;CAC3C,MAAM,eAAe,KAAK,IAAI,WAAW,SAAS;CAClD,IAAI,KAAK,eAAe,cAAc,OAAO,CAAC;CAE9C,MAAM,YAAY,eAAe,KAAK,aAAa,EAAE,CAAC,CAAC;CACvD,MAAM,UAAU,eAAe,KAAK,IAAI,cAAc,OAAO,gBAAgB,GAAG,EAAE,CAAC,CAAC;CAEpF,MAAM,MAAoB,CAAC;CAC3B,IAAI,QAAQ;CAEZ,KAAK,IAAI,OAAO,WAAW,QAAQ,SAAS,QAAQ,KAAK,cAAc;EACrE,MAAM,MAAM,KAAK,IAAI,KAAK,KAAK,YAAY,MAAM,KAAK,KAAK,CAAC;EAC5D,IACE,mBAAmB,UACnB,sBAAsB,MAAM,KAAK,OAAO,KAAK,KAAK,WAAW,EAAE,GAE/D;EAEF,MAAM,WAAW,cAAc,MAAM,KAAK,OAAO,KAAK,KAAK,WAAW,IAAI,cAAc;EACxF,MAAM,SAAS,eAAe,UAAU,KAAK,UAAU,EAAE;EAEzD,IAAI,WAAW,KAAK,aAAa;EACjC,IAAI,YAAY,WAAW;EAE3B,IAAI,KAAK,SAAS,QAAQ,SAAS,KAAK,OAAO;EAC/C;EAEA,IAAI,WAAW,UAAU,QAAQ,aAAa,SAAS,GAAG;GACxD,IAAI,KAAK;IAAE,gBAAgB;IAAU,cAAc;GAAO,CAAC;GAC3D,IAAI,IAAI,SAAA,KACN,MAAM,IAAI,wBAAwB,QAAQ;EAE9C;CACF;CACA,OAAO;AACT"}

package/dist/in_memory_port.d.ts

@@ -0,0 +1,19 @@
+import { SchedulerPort } from './port.js';
+import { Alteration, ScheduleTemplate } from './types.js';
+export declare class InMemorySchedulerPort<TPayload extends {
+    type: string;
+}> implements SchedulerPort<TPayload> {
+    private _templates;
+    private _alterations;
+    listTemplates(_start: number, _end: number): Promise<ScheduleTemplate<TPayload>[]>;
+    getTemplate(id: string): Promise<ScheduleTemplate<TPayload> | null>;
+    addTemplate(template: ScheduleTemplate<TPayload>): Promise<void>;
+    updateTemplate(template: ScheduleTemplate<TPayload>): Promise<void>;
+    removeTemplate(id: string): Promise<void>;
+    listAlterations(_start: number, _end: number): Promise<Alteration<TPayload>[]>;
+    listAlterationsByTemplate(templateId: string): Promise<Alteration<TPayload>[]>;
+    addAlteration(alteration: Alteration<TPayload>): Promise<void>;
+    removeAlteration(id: string): Promise<void>;
+    removeAlterationsForTemplate(templateId: string): Promise<void>;
+}
+//# sourceMappingURL=in_memory_port.d.ts.map

package/dist/in_memory_port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in_memory_port.d.ts","sourceRoot":"","sources":["../src/in_memory_port.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAO/D,qBAAa,qBAAqB,CAAC,QAAQ,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAClE,YAAW,aAAa,CAAC,QAAQ,CAAC;IAElC,OAAO,CAAC,UAAU,CAAiD;IACnE,OAAO,CAAC,YAAY,CAA2C;IAEzD,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,QAAQ,CAAC,EAAE,CAAC;IAIlF,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;IAKnE,WAAW,CAAC,QAAQ,EAAE,gBAAgB,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAOhE,cAAc,CAAC,QAAQ,EAAE,gBAAgB,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAOnE,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzC,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;IAI9E,yBAAyB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;IAI9E,aAAa,CAAC,UAAU,EAAE,UAAU,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAO9D,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3C,4BAA4B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAKtE"}

package/dist/in_memory_port.js

@@ -0,0 +1,45 @@
+// src/in_memory_port.ts
+var InMemorySchedulerPort = class {
+	_templates = /* @__PURE__ */ new Map();
+	_alterations = /* @__PURE__ */ new Map();
+	async listTemplates(_start, _end) {
+		return [...this._templates.values()].map(clone);
+	}
+	async getTemplate(id) {
+		const t = this._templates.get(id);
+		return t == null ? null : clone(t);
+	}
+	async addTemplate(template) {
+		if (this._templates.has(template.id)) throw new Error(`Template already exists: ${template.id}`);
+		this._templates.set(template.id, clone(template));
+	}
+	async updateTemplate(template) {
+		if (!this._templates.has(template.id)) throw new Error(`No template with id ${template.id}`);
+		this._templates.set(template.id, clone(template));
+	}
+	async removeTemplate(id) {
+		this._templates.delete(id);
+	}
+	async listAlterations(_start, _end) {
+		return [...this._alterations.values()].map(clone);
+	}
+	async listAlterationsByTemplate(templateId) {
+		return [...this._alterations.values()].filter((a) => a.templateId === templateId).map(clone);
+	}
+	async addAlteration(alteration) {
+		if (this._alterations.has(alteration.id)) throw new Error(`Alteration already exists: ${alteration.id}`);
+		this._alterations.set(alteration.id, clone(alteration));
+	}
+	async removeAlteration(id) {
+		this._alterations.delete(id);
+	}
+	async removeAlterationsForTemplate(templateId) {
+		for (const [id, a] of this._alterations) if (a.templateId === templateId) this._alterations.delete(id);
+	}
+};
+function clone(value) {
+	return JSON.parse(JSON.stringify(value));
+}
+export { InMemorySchedulerPort };
+
+//# sourceMappingURL=in_memory_port.js.map

package/dist/in_memory_port.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in_memory_port.js","names":[],"sources":["../src/in_memory_port.ts"],"sourcesContent":["import type { SchedulerPort } from \"./port.js\";\nimport type { Alteration, ScheduleTemplate } from \"./types.js\";\n\n// Reference port. Stores templates and alterations in plain Maps. Returns\n// deep-cloned copies so callers can't mutate internal state.\n//\n// Range queries return everything and let the Scheduler filter — correct,\n// but O(n) per query. A real backend would index on seriesStart/seriesEnd.\nexport class InMemorySchedulerPort<TPayload extends { type: string }>\n  implements SchedulerPort<TPayload>\n{\n  private _templates = new Map<string, ScheduleTemplate<TPayload>>();\n  private _alterations = new Map<string, Alteration<TPayload>>();\n\n  async listTemplates(_start: number, _end: number): Promise<ScheduleTemplate<TPayload>[]> {\n    return [...this._templates.values()].map(clone);\n  }\n\n  async getTemplate(id: string): Promise<ScheduleTemplate<TPayload> | null> {\n    const t = this._templates.get(id);\n    return t == null ? null : clone(t);\n  }\n\n  async addTemplate(template: ScheduleTemplate<TPayload>): Promise<void> {\n    if (this._templates.has(template.id)) {\n      throw new Error(`Template already exists: ${template.id}`);\n    }\n    this._templates.set(template.id, clone(template));\n  }\n\n  async updateTemplate(template: ScheduleTemplate<TPayload>): Promise<void> {\n    if (!this._templates.has(template.id)) {\n      throw new Error(`No template with id ${template.id}`);\n    }\n    this._templates.set(template.id, clone(template));\n  }\n\n  async removeTemplate(id: string): Promise<void> {\n    this._templates.delete(id);\n  }\n\n  async listAlterations(_start: number, _end: number): Promise<Alteration<TPayload>[]> {\n    return [...this._alterations.values()].map(clone);\n  }\n\n  async listAlterationsByTemplate(templateId: string): Promise<Alteration<TPayload>[]> {\n    return [...this._alterations.values()].filter((a) => a.templateId === templateId).map(clone);\n  }\n\n  async addAlteration(alteration: Alteration<TPayload>): Promise<void> {\n    if (this._alterations.has(alteration.id)) {\n      throw new Error(`Alteration already exists: ${alteration.id}`);\n    }\n    this._alterations.set(alteration.id, clone(alteration));\n  }\n\n  async removeAlteration(id: string): Promise<void> {\n    this._alterations.delete(id);\n  }\n\n  async removeAlterationsForTemplate(templateId: string): Promise<void> {\n    for (const [id, a] of this._alterations) {\n      if (a.templateId === templateId) this._alterations.delete(id);\n    }\n  }\n}\n\nfunction clone<T>(value: T): T {\n  return JSON.parse(JSON.stringify(value)) as T;\n}\n"],"mappings":";AAQA,IAAa,wBAAb,MAEA;CACE,6BAAqB,IAAI,IAAwC;CACjE,+BAAuB,IAAI,IAAkC;CAE7D,MAAM,cAAc,QAAgB,MAAqD;EACvF,OAAO,CAAC,GAAG,KAAK,WAAW,OAAO,CAAC,CAAC,CAAC,IAAI,KAAK;CAChD;CAEA,MAAM,YAAY,IAAwD;EACxE,MAAM,IAAI,KAAK,WAAW,IAAI,EAAE;EAChC,OAAO,KAAK,OAAO,OAAO,MAAM,CAAC;CACnC;CAEA,MAAM,YAAY,UAAqD;EACrE,IAAI,KAAK,WAAW,IAAI,SAAS,EAAE,GACjC,MAAM,IAAI,MAAM,4BAA4B,SAAS,IAAI;EAE3D,KAAK,WAAW,IAAI,SAAS,IAAI,MAAM,QAAQ,CAAC;CAClD;CAEA,MAAM,eAAe,UAAqD;EACxE,IAAI,CAAC,KAAK,WAAW,IAAI,SAAS,EAAE,GAClC,MAAM,IAAI,MAAM,uBAAuB,SAAS,IAAI;EAEtD,KAAK,WAAW,IAAI,SAAS,IAAI,MAAM,QAAQ,CAAC;CAClD;CAEA,MAAM,eAAe,IAA2B;EAC9C,KAAK,WAAW,OAAO,EAAE;CAC3B;CAEA,MAAM,gBAAgB,QAAgB,MAA+C;EACnF,OAAO,CAAC,GAAG,KAAK,aAAa,OAAO,CAAC,CAAC,CAAC,IAAI,KAAK;CAClD;CAEA,MAAM,0BAA0B,YAAqD;EACnF,OAAO,CAAC,GAAG,KAAK,aAAa,OAAO,CAAC,CAAC,CAAC,QAAQ,MAAM,EAAE,eAAe,UAAU,CAAC,CAAC,IAAI,KAAK;CAC7F;CAEA,MAAM,cAAc,YAAiD;EACnE,IAAI,KAAK,aAAa,IAAI,WAAW,EAAE,GACrC,MAAM,IAAI,MAAM,8BAA8B,WAAW,IAAI;EAE/D,KAAK,aAAa,IAAI,WAAW,IAAI,MAAM,UAAU,CAAC;CACxD;CAEA,MAAM,iBAAiB,IAA2B;EAChD,KAAK,aAAa,OAAO,EAAE;CAC7B;CAEA,MAAM,6BAA6B,YAAmC;EACpE,KAAK,MAAM,CAAC,IAAI,MAAM,KAAK,cACzB,IAAI,EAAE,eAAe,YAAY,KAAK,aAAa,OAAO,EAAE;CAEhE;AACF;AAEA,SAAS,MAAS,OAAa;CAC7B,OAAO,KAAK,MAAM,KAAK,UAAU,KAAK,CAAC;AACzC"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { Scheduler } from './scheduler.js';
+export { InMemorySchedulerPort } from './in_memory_port.js';
+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

@@ -0,0 +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;AACpB,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

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

package/dist/occurrence_key.d.ts

@@ -0,0 +1,6 @@
+import { Occurrence } from './generators/types.js';
+export interface KeyedOccurrence extends Occurrence {
+    occurrenceKey: string;
+}
+export declare function assignOccurrenceKeys(occurrences: readonly Occurrence[], tz: string | undefined): KeyedOccurrence[];
+//# sourceMappingURL=occurrence_key.d.ts.map

package/dist/occurrence_key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"occurrence_key.d.ts","sourceRoot":"","sources":["../src/occurrence_key.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAgBxD,MAAM,WAAW,eAAgB,SAAQ,UAAU;IACjD,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,SAAS,UAAU,EAAE,EAClC,EAAE,EAAE,MAAM,GAAG,SAAS,GACrB,eAAe,EAAE,CAUnB"}

package/dist/occurrence_key.js

@@ -0,0 +1,25 @@
+import { utcToWallParts } from "./tz.js";
+// src/occurrence_key.ts
+function assignOccurrenceKeys(occurrences, tz) {
+	const counts = /* @__PURE__ */ new Map();
+	return occurrences.map((occ) => {
+		const w = utcToWallParts(occ.startTimestamp, tz);
+		const date = `${_pad4(w.year)}-${_pad2(w.month + 1)}-${_pad2(w.day)}`;
+		const idx = counts.get(date) ?? 0;
+		counts.set(date, idx + 1);
+		const occurrenceKey = idx === 0 ? date : `${date}#${idx}`;
+		return {
+			...occ,
+			occurrenceKey
+		};
+	});
+}
+function _pad2(n) {
+	return n < 10 ? `0${n}` : String(n);
+}
+function _pad4(n) {
+	return n < 10 ? `000${n}` : n < 100 ? `00${n}` : n < 1e3 ? `0${n}` : String(n);
+}
+export { assignOccurrenceKeys };
+
+//# sourceMappingURL=occurrence_key.js.map

package/dist/occurrence_key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"occurrence_key.js","names":[],"sources":["../src/occurrence_key.ts"],"sourcesContent":["import type { Occurrence } from \"./generators/types.js\";\nimport { utcToWallParts } from \"./tz.js\";\n\n// A key identifies a specific occurrence within a template's series. It must\n// be:\n//   - Stable across small rule edits (e.g. tweaking timeOfDay)\n//   - Unique within a single generate() call's output for one template\n//\n// Format: `YYYY-MM-DD` (in the template's tz), with `#N` suffix when multiple\n// occurrences land on the same calendar day. Index is 0-based by emission\n// order within that day.\n//\n// Trade-off: changing timeOfDay across the date boundary moves an event to\n// a different day, which orphans alterations on it. We accept that as the\n// cost of human-readable, edit-tolerant keys. Same goes for timezone changes.\n\nexport interface KeyedOccurrence extends Occurrence {\n  occurrenceKey: string;\n}\n\nexport function assignOccurrenceKeys(\n  occurrences: readonly Occurrence[],\n  tz: string | undefined\n): KeyedOccurrence[] {\n  const counts = new Map<string, number>();\n  return occurrences.map((occ) => {\n    const w = utcToWallParts(occ.startTimestamp, tz);\n    const date = `${_pad4(w.year)}-${_pad2(w.month + 1)}-${_pad2(w.day)}`;\n    const idx = counts.get(date) ?? 0;\n    counts.set(date, idx + 1);\n    const occurrenceKey = idx === 0 ? date : `${date}#${idx}`;\n    return { ...occ, occurrenceKey };\n  });\n}\n\nfunction _pad2(n: number): string {\n  return n < 10 ? `0${n}` : String(n);\n}\n\nfunction _pad4(n: number): string {\n  return n < 10 ? `000${n}` : n < 100 ? `00${n}` : n < 1000 ? `0${n}` : String(n);\n}\n"],"mappings":";;AAoBA,SAAgB,qBACd,aACA,IACmB;CACnB,MAAM,yBAAS,IAAI,IAAoB;CACvC,OAAO,YAAY,KAAK,QAAQ;EAC9B,MAAM,IAAI,eAAe,IAAI,gBAAgB,EAAE;EAC/C,MAAM,OAAO,GAAG,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,EAAE,QAAQ,CAAC,EAAE,GAAG,MAAM,EAAE,GAAG;EAClE,MAAM,MAAM,OAAO,IAAI,IAAI,KAAK;EAChC,OAAO,IAAI,MAAM,MAAM,CAAC;EACxB,MAAM,gBAAgB,QAAQ,IAAI,OAAO,GAAG,KAAK,GAAG;EACpD,OAAO;GAAE,GAAG;GAAK;EAAc;CACjC,CAAC;AACH;AAEA,SAAS,MAAM,GAAmB;CAChC,OAAO,IAAI,KAAK,IAAI,MAAM,OAAO,CAAC;AACpC;AAEA,SAAS,MAAM,GAAmB;CAChC,OAAO,IAAI,KAAK,MAAM,MAAM,IAAI,MAAM,KAAK,MAAM,IAAI,MAAO,IAAI,MAAM,OAAO,CAAC;AAChF"}

package/dist/port.d.ts

@@ -0,0 +1,16 @@
+import { Alteration, ScheduleTemplate } from './types.js';
+export interface SchedulerPort<TPayload extends {
+    type: string;
+}> {
+    listTemplates(start: number, end: number): Promise<ScheduleTemplate<TPayload>[]>;
+    getTemplate(id: string): Promise<ScheduleTemplate<TPayload> | null>;
+    addTemplate(template: ScheduleTemplate<TPayload>): Promise<void>;
+    updateTemplate(template: ScheduleTemplate<TPayload>): Promise<void>;
+    removeTemplate(id: string): Promise<void>;
+    listAlterations(start: number, end: number): Promise<Alteration<TPayload>[]>;
+    listAlterationsByTemplate(templateId: string): Promise<Alteration<TPayload>[]>;
+    addAlteration(alteration: Alteration<TPayload>): Promise<void>;
+    removeAlteration(id: string): Promise<void>;
+    removeAlterationsForTemplate(templateId: string): Promise<void>;
+}
+//# sourceMappingURL=port.d.ts.map

package/dist/port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"port.d.ts","sourceRoot":"","sources":["../src/port.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAW/D,MAAM,WAAW,aAAa,CAAC,QAAQ,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE;IAE9D,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACjF,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,CAAC;IACpE,WAAW,CAAC,QAAQ,EAAE,gBAAgB,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjE,cAAc,CAAC,QAAQ,EAAE,gBAAgB,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpE,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAG1C,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAE7E,yBAAyB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC/E,aAAa,CAAC,UAAU,EAAE,UAAU,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/D,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAI5C,4BAA4B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjE"}

package/dist/scheduler.d.ts

@@ -0,0 +1,24 @@
+import { IEventBroadcast } from '@j13b/state';
+import { SchedulerPort } from './port.js';
+import { ScheduleTemplate, ScheduledEvent, TimeSpan } from './types.js';
+export declare class Scheduler<TPayload extends {
+    type: string;
+}> {
+    private readonly _port;
+    private readonly _changed;
+    constructor(port: SchedulerPort<TPayload>);
+    get changed(): IEventBroadcast<void>;
+    list(windowStart: number, windowEnd: number): Promise<ScheduledEvent<TPayload>[]>;
+    next(templateId: string, after: number): Promise<ScheduledEvent<TPayload> | null>;
+    nextDue(after: number, limit?: number): Promise<ScheduledEvent<TPayload>[]>;
+    add(template: ScheduleTemplate<TPayload>): Promise<void>;
+    update(delta: {
+        id: string;
+    } & Partial<Omit<ScheduleTemplate<TPayload>, "id">>): Promise<void>;
+    remove(id: string): Promise<void>;
+    reschedule(templateId: string, occurrenceKey: string, newStart: number, newTimeSpan?: TimeSpan, payloadOverride?: Partial<TPayload>): Promise<string>;
+    cancel(templateId: string, occurrenceKey: string): Promise<string>;
+    private _generateKeyed;
+    private _removeExistingAlteration;
+}
+//# sourceMappingURL=scheduler.d.ts.map

package/dist/scheduler.d.ts.map

@@ -0,0 +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,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"}

package/dist/scheduler.js

@@ -0,0 +1,241 @@
+import { applyAlterations } from "./alterations.js";
+import { generateAnchored } from "./generators/anchored.js";
+import { generateDaysOfMonth } from "./generators/days_of_month.js";
+import { generateDaysOfWeek } from "./generators/days_of_week.js";
+import { generateDaysOfYear } from "./generators/days_of_year.js";
+import { generateInstant } from "./generators/instant.js";
+import { generateLocalDateTime } from "./generators/local_date_time.js";
+import { generateMonthsOfYear } from "./generators/months_of_year.js";
+import { generateWeeksOfMonth } from "./generators/weeks_of_month.js";
+import { generateYearly } from "./generators/yearly.js";
+import { assignOccurrenceKeys } from "./occurrence_key.js";
+import { isValidTimeZone } from "./tz.js";
+import { validateRule, validateTimeSpan } from "./validate_rule.js";
+import { Event } from "@j13b/state";
+// src/scheduler.ts
+var DAY_MS = 864e5;
+var NEXT_SEARCH_HORIZON_MS = 1825 * DAY_MS;
+var Scheduler = class {
+	_port;
+	_changed = new Event();
+	constructor(port) {
+		this._port = port;
+	}
+	get changed() {
+		return this._changed.broadcast;
+	}
+	async list(windowStart, windowEnd) {
+		if (windowEnd <= windowStart) return [];
+		const [templates, alterations] = await Promise.all([this._port.listTemplates(windowStart, windowEnd), this._port.listAlterations(windowStart, windowEnd)]);
+		const out = [];
+		for (const tpl of templates) {
+			const keyed = this._generateKeyed(tpl, windowStart, windowEnd);
+			const events = applyAlterations(tpl.id, tpl.payload, keyed, alterations, tpl.timezone, windowStart, windowEnd);
+			out.push(...events);
+		}
+		out.sort((a, b) => a.startTimestamp - b.startTimestamp);
+		return out;
+	}
+	async next(templateId, after) {
+		const tpl = await this._port.getTemplate(templateId);
+		if (tpl == null) return null;
+		const horizonEnd = after + NEXT_SEARCH_HORIZON_MS;
+		let windowStart = after;
+		let windowSize = DAY_MS;
+		while (windowStart < horizonEnd) {
+			const windowEnd = Math.min(windowStart + windowSize, horizonEnd);
+			const alterations = await this._port.listAlterationsByTemplate(templateId);
+			const keyed = this._generateKeyed(tpl, windowStart, windowEnd);
+			const firstAfter = applyAlterations(tpl.id, tpl.payload, keyed, alterations, tpl.timezone, windowStart, windowEnd).find((e) => e.startTimestamp > after);
+			if (firstAfter != null) return firstAfter;
+			windowStart = windowEnd;
+			windowSize = Math.min(windowSize * 2, 365 * DAY_MS);
+		}
+		return null;
+	}
+	async nextDue(after, limit = 10) {
+		if (limit <= 0) return [];
+		const horizonEnd = after + NEXT_SEARCH_HORIZON_MS;
+		const out = [];
+		let windowStart = after;
+		let windowSize = DAY_MS;
+		while (windowStart < horizonEnd && out.length < limit) {
+			const windowEnd = Math.min(windowStart + windowSize, horizonEnd);
+			const events = await this.list(windowStart, windowEnd);
+			for (const e of events) if (e.startTimestamp > after) {
+				out.push(e);
+				if (out.length >= limit) break;
+			}
+			windowStart = windowEnd;
+			windowSize = Math.min(windowSize * 2, 365 * DAY_MS);
+		}
+		return out;
+	}
+	async add(template) {
+		validateRule(template.rule);
+		_validateTimezone(template.timezone);
+		_validateDisambiguation(template.disambiguation);
+		const normalized = {
+			...template,
+			rule: _normalizeRule(template.rule)
+		};
+		await this._port.addTemplate(normalized);
+		this._changed.notify();
+	}
+	async update(delta) {
+		const existing = await this._port.getTemplate(delta.id);
+		if (existing == null) throw new Error(`No template with id ${delta.id}`);
+		const merged = {
+			...existing,
+			...delta,
+			id: delta.id
+		};
+		validateRule(merged.rule);
+		_validateTimezone(merged.timezone);
+		_validateDisambiguation(merged.disambiguation);
+		const updated = {
+			...merged,
+			rule: _normalizeRule(merged.rule)
+		};
+		const ruleChanged = !_rulesEqual(existing.rule, updated.rule);
+		await this._port.updateTemplate(updated);
+		if (ruleChanged) await this._port.removeAlterationsForTemplate(updated.id);
+		this._changed.notify();
+	}
+	async remove(id) {
+		await this._port.removeAlterationsForTemplate(id);
+		await this._port.removeTemplate(id);
+		this._changed.notify();
+	}
+	async reschedule(templateId, occurrenceKey, newStart, newTimeSpan, payloadOverride) {
+		if (newTimeSpan != null) validateTimeSpan(newTimeSpan);
+		const id = `alt-${templateId}-${occurrenceKey}-${Date.now()}`;
+		await this._removeExistingAlteration(templateId, occurrenceKey);
+		const alt = {
+			id,
+			templateId,
+			occurrenceKey,
+			kind: "reschedule",
+			startTimestamp: newStart,
+			timeSpan: newTimeSpan,
+			payloadOverride
+		};
+		await this._port.addAlteration(alt);
+		this._changed.notify();
+		return id;
+	}
+	async cancel(templateId, occurrenceKey) {
+		const id = `alt-${templateId}-${occurrenceKey}-${Date.now()}`;
+		await this._removeExistingAlteration(templateId, occurrenceKey);
+		const alt = {
+			id,
+			templateId,
+			occurrenceKey,
+			kind: "cancel"
+		};
+		await this._port.addAlteration(alt);
+		this._changed.notify();
+		return id;
+	}
+	_generateKeyed(tpl, windowStart, windowEnd) {
+		const tz = tpl.timezone;
+		const dis = tpl.disambiguation ?? "compatible";
+		let occurrences;
+		switch (tpl.rule.kind) {
+			case "instant":
+				occurrences = generateInstant(tpl.rule, tz, windowStart, windowEnd);
+				break;
+			case "localDateTime":
+				occurrences = generateLocalDateTime(tpl.rule, tz, windowStart, windowEnd, dis);
+				break;
+			case "anchored":
+				occurrences = generateAnchored(tpl.rule, tz, windowStart, windowEnd);
+				break;
+			case "daysOfWeek":
+				occurrences = generateDaysOfWeek(tpl.rule, tz, windowStart, windowEnd, dis);
+				break;
+			case "weeksOfMonth":
+				occurrences = generateWeeksOfMonth(tpl.rule, tz, windowStart, windowEnd, dis);
+				break;
+			case "monthsOfYear":
+				occurrences = generateMonthsOfYear(tpl.rule, tz, windowStart, windowEnd, dis);
+				break;
+			case "yearly":
+				occurrences = generateYearly(tpl.rule, tz, windowStart, windowEnd, dis);
+				break;
+			case "daysOfMonth":
+				occurrences = generateDaysOfMonth(tpl.rule, tz, windowStart, windowEnd, dis);
+				break;
+			case "daysOfYear":
+				occurrences = generateDaysOfYear(tpl.rule, tz, windowStart, windowEnd, dis);
+				break;
+			default: {
+				const _exhaustive = tpl.rule;
+				throw new Error(`Unknown rule kind: ${JSON.stringify(_exhaustive)}`);
+			}
+		}
+		return assignOccurrenceKeys(occurrences, tz);
+	}
+	async _removeExistingAlteration(templateId, occurrenceKey) {
+		const existing = await this._port.listAlterationsByTemplate(templateId);
+		for (const alt of existing) if (alt.occurrenceKey === occurrenceKey) await this._port.removeAlteration(alt.id);
+	}
+};
+function _normalizeRule(rule) {
+	if (rule.timeSpan != null) return rule;
+	return {
+		...rule,
+		timeSpan: {
+			type: "duration",
+			ms: 1
+		}
+	};
+}
+function _validateTimezone(tz) {
+	if (typeof tz !== "string" || tz.length === 0) throw new Error("ScheduleTemplate.timezone is required (use 'UTC' for zone-free scheduling)");
+	if (!isValidTimeZone(tz)) throw new Error(`Unknown timezone '${tz}' (expected an IANA zone name or 'UTC')`);
+}
+var _DISAMBIGUATIONS = [
+	"compatible",
+	"earlier",
+	"later",
+	"reject",
+	"skip"
+];
+function _validateDisambiguation(d) {
+	if (d == null) return;
+	if (!_DISAMBIGUATIONS.includes(d)) throw new Error(`Unknown disambiguation '${d}' (expected one of ${_DISAMBIGUATIONS.join(", ")})`);
+}
+function _rulesEqual(a, b) {
+	return JSON.stringify(_canonicalize(a)) === JSON.stringify(_canonicalize(b));
+}
+function _canonicalize(rule) {
+	if (rule.kind === "daysOfWeek") return {
+		...rule,
+		days: [...new Set(rule.days)].sort((a, b) => a - b)
+	};
+	if (rule.kind === "weeksOfMonth") return {
+		...rule,
+		days: [...new Set(rule.days)].sort((a, b) => a - b),
+		weeks: [...new Set(rule.weeks)].sort((a, b) => a - b)
+	};
+	if (rule.kind === "monthsOfYear") return {
+		...rule,
+		months: [...new Set(rule.months)].sort((a, b) => a - b),
+		weeks: [...new Set(rule.weeks)].sort((a, b) => a - b),
+		days: [...new Set(rule.days)].sort((a, b) => a - b)
+	};
+	if (rule.kind === "daysOfMonth") return {
+		...rule,
+		months: [...new Set(rule.months)].sort((a, b) => a - b),
+		daysOfMonth: [...new Set(rule.daysOfMonth)].sort((a, b) => a - b)
+	};
+	if (rule.kind === "daysOfYear") return {
+		...rule,
+		daysOfYear: [...new Set(rule.daysOfYear)].sort((a, b) => a - b)
+	};
+	return rule;
+}
+export { Scheduler };
+
+//# sourceMappingURL=scheduler.js.map

package/dist/scheduler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.js","names":[],"sources":["../src/scheduler.ts"],"sourcesContent":["import { Event, type IEventBroadcast } from \"@j13b/state\";\nimport { applyAlterations } from \"./alterations.js\";\nimport { generateAnchored } from \"./generators/anchored.js\";\nimport { generateDaysOfMonth } from \"./generators/days_of_month.js\";\nimport { generateDaysOfWeek } from \"./generators/days_of_week.js\";\nimport { generateDaysOfYear } from \"./generators/days_of_year.js\";\nimport { generateInstant } from \"./generators/instant.js\";\nimport { generateLocalDateTime } from \"./generators/local_date_time.js\";\nimport { generateMonthsOfYear } from \"./generators/months_of_year.js\";\nimport type { Occurrence } from \"./generators/types.js\";\nimport { generateWeeksOfMonth } from \"./generators/weeks_of_month.js\";\nimport { generateYearly } from \"./generators/yearly.js\";\nimport { assignOccurrenceKeys } from \"./occurrence_key.js\";\nimport type { SchedulerPort } from \"./port.js\";\nimport type {\n  Alteration,\n  Disambiguation,\n  RecurrenceRule,\n  ScheduleTemplate,\n  ScheduledEvent,\n  TimeSpan,\n} from \"./types.js\";\nimport { isValidTimeZone } from \"./tz.js\";\nimport { validateRule, validateTimeSpan } from \"./validate_rule.js\";\n\nconst DAY_MS = 24 * 60 * 60 * 1000;\n// Search horizon for next() / nextDue() before giving up. Five years covers\n// every realistic use; if you need longer, call list() with an explicit\n// window.\nconst NEXT_SEARCH_HORIZON_MS = 5 * 365 * DAY_MS;\n\nexport class Scheduler<TPayload extends { type: string }> {\n  private readonly _port: SchedulerPort<TPayload>;\n  // Fires after every successful write (add/update/remove/reschedule/cancel).\n  // The Dispatcher subscribes via .changed so a new event added during a\n  // sleep can interrupt the sleep and re-query nextDue().\n  private readonly _changed = new Event<void>();\n\n  constructor(port: SchedulerPort<TPayload>) {\n    this._port = port;\n  }\n\n  get changed(): IEventBroadcast<void> {\n    return this._changed.broadcast;\n  }\n\n  // ─── Reads ──────────────────────────────────────────────────\n\n  // All occurrences whose [start, end) intersects [windowStart, windowEnd),\n  // sorted ascending by startTimestamp. Honors alterations.\n  async list(windowStart: number, windowEnd: number): Promise<ScheduledEvent<TPayload>[]> {\n    if (windowEnd <= windowStart) return [];\n    const [templates, alterations] = await Promise.all([\n      this._port.listTemplates(windowStart, windowEnd),\n      this._port.listAlterations(windowStart, windowEnd),\n    ]);\n    const out: ScheduledEvent<TPayload>[] = [];\n    for (const tpl of templates) {\n      const keyed = this._generateKeyed(tpl, windowStart, windowEnd);\n      const events = applyAlterations(\n        tpl.id,\n        tpl.payload,\n        keyed,\n        alterations,\n        tpl.timezone,\n        windowStart,\n        windowEnd\n      );\n      out.push(...events);\n    }\n    out.sort((a, b) => a.startTimestamp - b.startTimestamp);\n    return out;\n  }\n\n  // Earliest occurrence of one template strictly after `after`. Returns null\n  // if no occurrence exists within NEXT_SEARCH_HORIZON_MS.\n  async next(templateId: string, after: number): Promise<ScheduledEvent<TPayload> | null> {\n    const tpl = await this._port.getTemplate(templateId);\n    if (tpl == null) return null;\n\n    // Expanding-window search. Doubles each iteration until horizon.\n    const horizonEnd = after + NEXT_SEARCH_HORIZON_MS;\n    let windowStart = after;\n    let windowSize = DAY_MS;\n    while (windowStart < horizonEnd) {\n      const windowEnd = Math.min(windowStart + windowSize, horizonEnd);\n      const alterations = await this._port.listAlterationsByTemplate(templateId);\n      const keyed = this._generateKeyed(tpl, windowStart, windowEnd);\n      const events = applyAlterations(\n        tpl.id,\n        tpl.payload,\n        keyed,\n        alterations,\n        tpl.timezone,\n        windowStart,\n        windowEnd\n      );\n      const firstAfter = events.find((e) => e.startTimestamp > after);\n      if (firstAfter != null) return firstAfter;\n      windowStart = windowEnd;\n      windowSize = Math.min(windowSize * 2, 365 * DAY_MS);\n    }\n    return null;\n  }\n\n  // The next `limit` occurrences globally after `after`, sorted ascending.\n  // Defaults to 10. Searches in expanding windows like next().\n  async nextDue(after: number, limit = 10): Promise<ScheduledEvent<TPayload>[]> {\n    if (limit <= 0) return [];\n    const horizonEnd = after + NEXT_SEARCH_HORIZON_MS;\n    const out: ScheduledEvent<TPayload>[] = [];\n    let windowStart = after;\n    let windowSize = DAY_MS;\n    while (windowStart < horizonEnd && out.length < limit) {\n      const windowEnd = Math.min(windowStart + windowSize, horizonEnd);\n      const events = await this.list(windowStart, windowEnd);\n      for (const e of events) {\n        if (e.startTimestamp > after) {\n          out.push(e);\n          if (out.length >= limit) break;\n        }\n      }\n      windowStart = windowEnd;\n      windowSize = Math.min(windowSize * 2, 365 * DAY_MS);\n    }\n    return out;\n  }\n\n  // ─── Writes ─────────────────────────────────────────────────\n\n  async add(template: ScheduleTemplate<TPayload>): Promise<void> {\n    validateRule(template.rule);\n    _validateTimezone(template.timezone);\n    _validateDisambiguation(template.disambiguation);\n    const normalized: ScheduleTemplate<TPayload> = {\n      ...template,\n      rule: _normalizeRule(template.rule),\n    };\n    await this._port.addTemplate(normalized);\n    this._changed.notify();\n  }\n\n  // Partial update. Caller supplies any subset of the template fields plus\n  // the id. If the rule changes (kind or any field), all alterations for\n  // this template are wiped — same policy as activity-board, made explicit.\n  async update(\n    delta: { id: string } & Partial<Omit<ScheduleTemplate<TPayload>, \"id\">>\n  ): Promise<void> {\n    const existing = await this._port.getTemplate(delta.id);\n    if (existing == null) throw new Error(`No template with id ${delta.id}`);\n    const merged: ScheduleTemplate<TPayload> = {\n      ...existing,\n      ...delta,\n      id: delta.id,\n    };\n    validateRule(merged.rule);\n    _validateTimezone(merged.timezone);\n    _validateDisambiguation(merged.disambiguation);\n    const updated: ScheduleTemplate<TPayload> = {\n      ...merged,\n      rule: _normalizeRule(merged.rule),\n    };\n    const ruleChanged = !_rulesEqual(existing.rule, updated.rule);\n    await this._port.updateTemplate(updated);\n    if (ruleChanged) {\n      await this._port.removeAlterationsForTemplate(updated.id);\n    }\n    this._changed.notify();\n  }\n\n  async remove(id: string): Promise<void> {\n    await this._port.removeAlterationsForTemplate(id);\n    await this._port.removeTemplate(id);\n    this._changed.notify();\n  }\n\n  // Adds or replaces a reschedule alteration for the given occurrence.\n  // Caller is responsible for providing a valid occurrenceKey (typically\n  // taken from a prior list() result). If `newTimeSpan` is omitted, the\n  // rescheduled occurrence inherits the original's UTC duration (i.e. moves\n  // in time but keeps the same length).\n  async reschedule(\n    templateId: string,\n    occurrenceKey: string,\n    newStart: number,\n    newTimeSpan?: TimeSpan,\n    payloadOverride?: Partial<TPayload>\n  ): Promise<string> {\n    if (newTimeSpan != null) validateTimeSpan(newTimeSpan);\n    const id = `alt-${templateId}-${occurrenceKey}-${Date.now()}`;\n    await this._removeExistingAlteration(templateId, occurrenceKey);\n    const alt: Alteration<TPayload> = {\n      id,\n      templateId,\n      occurrenceKey,\n      kind: \"reschedule\",\n      startTimestamp: newStart,\n      timeSpan: newTimeSpan,\n      payloadOverride,\n    };\n    await this._port.addAlteration(alt);\n    this._changed.notify();\n    return id;\n  }\n\n  async cancel(templateId: string, occurrenceKey: string): Promise<string> {\n    const id = `alt-${templateId}-${occurrenceKey}-${Date.now()}`;\n    await this._removeExistingAlteration(templateId, occurrenceKey);\n    const alt: Alteration<TPayload> = {\n      id,\n      templateId,\n      occurrenceKey,\n      kind: \"cancel\",\n    };\n    await this._port.addAlteration(alt);\n    this._changed.notify();\n    return id;\n  }\n\n  // ─── Internals ──────────────────────────────────────────────\n\n  private _generateKeyed(tpl: ScheduleTemplate<TPayload>, windowStart: number, windowEnd: number) {\n    const tz = tpl.timezone;\n    const dis = tpl.disambiguation ?? \"compatible\";\n    let occurrences: Occurrence[];\n    switch (tpl.rule.kind) {\n      case \"instant\":\n        // Absolute start — no wall-clock ambiguity, disambiguation N/A.\n        occurrences = generateInstant(tpl.rule, tz, windowStart, windowEnd);\n        break;\n      case \"localDateTime\":\n        occurrences = generateLocalDateTime(tpl.rule, tz, windowStart, windowEnd, dis);\n        break;\n      case \"anchored\":\n        // Absolute stepping — no wall-clock ambiguity, disambiguation N/A.\n        occurrences = generateAnchored(tpl.rule, tz, windowStart, windowEnd);\n        break;\n      case \"daysOfWeek\":\n        occurrences = generateDaysOfWeek(tpl.rule, tz, windowStart, windowEnd, dis);\n        break;\n      case \"weeksOfMonth\":\n        occurrences = generateWeeksOfMonth(tpl.rule, tz, windowStart, windowEnd, dis);\n        break;\n      case \"monthsOfYear\":\n        occurrences = generateMonthsOfYear(tpl.rule, tz, windowStart, windowEnd, dis);\n        break;\n      case \"yearly\":\n        occurrences = generateYearly(tpl.rule, tz, windowStart, windowEnd, dis);\n        break;\n      case \"daysOfMonth\":\n        occurrences = generateDaysOfMonth(tpl.rule, tz, windowStart, windowEnd, dis);\n        break;\n      case \"daysOfYear\":\n        occurrences = generateDaysOfYear(tpl.rule, tz, windowStart, windowEnd, dis);\n        break;\n      default: {\n        // Exhaustiveness guard — adding a new kind without handling it here\n        // is a compile error.\n        const _exhaustive: never = tpl.rule;\n        throw new Error(`Unknown rule kind: ${JSON.stringify(_exhaustive)}`);\n      }\n    }\n    return assignOccurrenceKeys(occurrences, tz);\n  }\n\n  private async _removeExistingAlteration(\n    templateId: string,\n    occurrenceKey: string\n  ): Promise<void> {\n    const existing = await this._port.listAlterationsByTemplate(templateId);\n    for (const alt of existing) {\n      if (alt.occurrenceKey === occurrenceKey) {\n        await this._port.removeAlteration(alt.id);\n      }\n    }\n  }\n}\n\n// ─── Validation ───────────────────────────────────────────────\n\n// Returns a copy of `rule` with timeSpan defaulted when omitted, so\n// generators don't have to handle undefined repeatedly.\nfunction _normalizeRule(rule: RecurrenceRule): RecurrenceRule {\n  if (rule.timeSpan != null) return rule;\n  return { ...rule, timeSpan: { type: \"duration\", ms: 1 } };\n}\n\nfunction _validateTimezone(tz: string): void {\n  if (typeof tz !== \"string\" || tz.length === 0) {\n    throw new Error(\"ScheduleTemplate.timezone is required (use 'UTC' for zone-free scheduling)\");\n  }\n  if (!isValidTimeZone(tz)) {\n    throw new Error(`Unknown timezone '${tz}' (expected an IANA zone name or 'UTC')`);\n  }\n}\n\nconst _DISAMBIGUATIONS: readonly Disambiguation[] = [\n  \"compatible\",\n  \"earlier\",\n  \"later\",\n  \"reject\",\n  \"skip\",\n];\n\nfunction _validateDisambiguation(d: Disambiguation | undefined): void {\n  if (d == null) return;\n  if (!_DISAMBIGUATIONS.includes(d)) {\n    throw new Error(\n      `Unknown disambiguation '${d}' (expected one of ${_DISAMBIGUATIONS.join(\", \")})`\n    );\n  }\n}\n\nfunction _rulesEqual(a: RecurrenceRule, b: RecurrenceRule): boolean {\n  return JSON.stringify(_canonicalize(a)) === JSON.stringify(_canonicalize(b));\n}\n\nfunction _canonicalize(rule: RecurrenceRule): unknown {\n  // Sort + dedup any array selectors so reorderings or duplicates don't\n  // false-flag a rule change (which would wipe alterations).\n  if (rule.kind === \"daysOfWeek\") {\n    return { ...rule, days: [...new Set(rule.days)].sort((a, b) => a - b) };\n  }\n  if (rule.kind === \"weeksOfMonth\") {\n    return {\n      ...rule,\n      days: [...new Set(rule.days)].sort((a, b) => a - b),\n      weeks: [...new Set(rule.weeks)].sort((a, b) => a - b),\n    };\n  }\n  if (rule.kind === \"monthsOfYear\") {\n    return {\n      ...rule,\n      months: [...new Set(rule.months)].sort((a, b) => a - b),\n      weeks: [...new Set(rule.weeks)].sort((a, b) => a - b),\n      days: [...new Set(rule.days)].sort((a, b) => a - b),\n    };\n  }\n  if (rule.kind === \"daysOfMonth\") {\n    return {\n      ...rule,\n      months: [...new Set(rule.months)].sort((a, b) => a - b),\n      daysOfMonth: [...new Set(rule.daysOfMonth)].sort((a, b) => a - b),\n    };\n  }\n  if (rule.kind === \"daysOfYear\") {\n    return {\n      ...rule,\n      daysOfYear: [...new Set(rule.daysOfYear)].sort((a, b) => a - b),\n    };\n  }\n  return rule;\n}\n"],"mappings":"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"}