@j13b/scheduler 0.0.0-stage → 0.1.1

package/dist/validate_rule.js

@@ -0,0 +1,280 @@
+// src/validate_rule.ts
+var DAYS_HINT = "Day numbers 0..6 (0=Sunday, 1=Monday … 6=Saturday)";
+var MONTHS_HINT = "Month numbers 0..11 (0=January … 11=December)";
+var WEEKS_HINT = "week-of-month numbers 1..5 (1=first) or -1..-5 (-1=last)";
+var TIME_OF_DAY_HINT = "ms after local midnight, 0..86_399_999 (7:00 = 25_200_000)";
+var TIMESTAMP_HINT = "a UTC timestamp in ms";
+var 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")
+	}
+};
+var TIME_OF_DAY = {
+	required: true,
+	check: int(0, 86399999, TIME_OF_DAY_HINT)
+};
+var 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
+		}
+	}
+};
+var RULE_KINDS = Object.keys(KINDS);
+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 ${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 ${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] === void 0) {
+			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`);
+}
+function validateTimeSpan(span) {
+	if (span === void 0) 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)})`);
+}
+function describe(spec, label) {
+	try {
+		spec.check(void 0, 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 + 9).replace(/ \(got [^)]*\)$/, "");
+	}
+	return "see the rule's type";
+}
+function show(v) {
+	return v === void 0 ? "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)`);
+}
+export { RULE_KINDS, validateRule, validateTimeSpan };
+
+//# sourceMappingURL=validate_rule.js.map

package/dist/validate_rule.js.map

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

package/package.json

@@ -1,6 +1,78 @@
 {
   "name": "@j13b/scheduler",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "description": "A timezone-aware recurrence and dispatch engine: a pure-data rule DSL, IANA timezones, DST-aware generators and a cron-style dispatcher.",
+  "license": "MIT",
+  "author": "Jared J Barnes",
+  "type": "module",
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/index.d.ts",
+        "default": "./dist/cjs/index.js"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "src",
+    "tsconfig.json",
+    "LICENSE",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "vite build && node scripts/build-cjs.mjs",
+    "check:types": "tsc --noEmit",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "lint": "biome lint .",
+    "lint:fix": "biome lint --write .",
+    "format": "biome format --write .",
+    "check": "biome check .",
+    "check:fix": "biome check --write .",
+    "prepublishOnly": "npm run check:types && npm run test:run && npm run build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jaredjbarnes/scheduler.git"
+  },
+  "homepage": "https://github.com/jaredjbarnes/scheduler#readme",
+  "bugs": {
+    "url": "https://github.com/jaredjbarnes/scheduler/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "scheduler",
+    "recurrence",
+    "rrule",
+    "calendar",
+    "timezone",
+    "dst",
+    "cron",
+    "dispatcher"
+  ],
+  "peerDependencies": {
+    "@j13b/state": "^0.2.0"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^1.9.4",
+    "@j13b/state": "^0.2.0",
+    "@types/node": "^20.0.0",
+    "@vitest/coverage-v8": "^4.1.9",
+    "typescript": "^5.4.0",
+    "vite": "^8.1.3",
+    "vite-plugin-dts": "^4.2.0",
+    "vitest": "^4.1.9"
+  }
+}

package/src/__tests__/alterations.test.ts

@@ -0,0 +1,177 @@
+import { describe, expect, test } from "vitest";
+import { applyAlterations } from "../alterations.js";
+import { type KeyedOccurrence, assignOccurrenceKeys } from "../occurrence_key.js";
+import type { Alteration } from "../types.js";
+
+interface CronPayload {
+  type: "cron";
+  command: string;
+}
+
+const HOUR = 3_600_000;
+const TPL_ID = "tpl-1";
+const PAYLOAD: CronPayload = { type: "cron", command: "ls" };
+
+function keyed(starts: number[], duration: number): KeyedOccurrence[] {
+  return assignOccurrenceKeys(
+    starts.map((s) => ({ startTimestamp: s, endTimestamp: s + duration })),
+    "UTC"
+  );
+}
+
+describe("assignOccurrenceKeys", () => {
+  test("YYYY-MM-DD when one per day", () => {
+    const k = keyed([Date.UTC(2026, 4, 11, 9), Date.UTC(2026, 4, 12, 9)], HOUR);
+    expect(k.map((o) => o.occurrenceKey)).toEqual(["2026-05-11", "2026-05-12"]);
+  });
+
+  test("YYYY-MM-DD#N when multiple per day", () => {
+    const k = keyed(
+      [Date.UTC(2026, 4, 11, 9), Date.UTC(2026, 4, 11, 15), Date.UTC(2026, 4, 11, 21)],
+      HOUR
+    );
+    expect(k.map((o) => o.occurrenceKey)).toEqual(["2026-05-11", "2026-05-11#1", "2026-05-11#2"]);
+  });
+
+  test("respects tz when bucketing", () => {
+    // 2026-05-12T03:00Z is May 11 21:00 in America/Denver (MDT, -06)
+    const k = assignOccurrenceKeys(
+      [
+        { startTimestamp: Date.UTC(2026, 4, 11, 21), endTimestamp: 0 }, // 15:00 Denver = May 11
+        { startTimestamp: Date.UTC(2026, 4, 12, 3), endTimestamp: 0 }, // 21:00 Denver = May 11
+      ],
+      "America/Denver"
+    );
+    expect(k.map((o) => o.occurrenceKey)).toEqual(["2026-05-11", "2026-05-11#1"]);
+  });
+});
+
+describe("applyAlterations", () => {
+  const winStart = Date.UTC(2026, 4, 11);
+  const winEnd = Date.UTC(2026, 4, 14);
+  const occs = keyed(
+    [
+      Date.UTC(2026, 4, 11, 9), // key 2026-05-11
+      Date.UTC(2026, 4, 12, 9), // key 2026-05-12
+      Date.UTC(2026, 4, 13, 9), // key 2026-05-13
+    ],
+    HOUR
+  );
+
+  test("no alterations: emits all base occurrences", () => {
+    const out = applyAlterations(TPL_ID, PAYLOAD, occs, [], "UTC", winStart, winEnd);
+    expect(out).toHaveLength(3);
+    expect(out.every((o) => o.alterationId == null)).toBe(true);
+  });
+
+  test("cancel suppresses the matched occurrence", () => {
+    const alt: Alteration<CronPayload> = {
+      id: "a1",
+      templateId: TPL_ID,
+      occurrenceKey: "2026-05-12",
+      kind: "cancel",
+    };
+    const out = applyAlterations(TPL_ID, PAYLOAD, occs, [alt], "UTC", winStart, winEnd);
+    expect(out).toHaveLength(2);
+    expect(out.map((o) => o.occurrenceKey)).toEqual(["2026-05-11", "2026-05-13"]);
+  });
+
+  test("reschedule shifts the time and tags alterationId", () => {
+    const newStart = Date.UTC(2026, 4, 12, 17);
+    const alt: Alteration<CronPayload> = {
+      id: "a1",
+      templateId: TPL_ID,
+      occurrenceKey: "2026-05-12",
+      kind: "reschedule",
+      startTimestamp: newStart,
+      timeSpan: { type: "duration", ms: 2 * HOUR },
+    };
+    const out = applyAlterations(TPL_ID, PAYLOAD, occs, [alt], "UTC", winStart, winEnd);
+    const moved = out.find((o) => o.occurrenceKey === "2026-05-12");
+    expect(moved?.startTimestamp).toBe(newStart);
+    expect(moved?.endTimestamp).toBe(newStart + 2 * HOUR);
+    expect(moved?.alterationId).toBe("a1");
+  });
+
+  test("reschedule without timeSpan inherits original duration", () => {
+    const newStart = Date.UTC(2026, 4, 12, 17);
+    const alt: Alteration<CronPayload> = {
+      id: "a1",
+      templateId: TPL_ID,
+      occurrenceKey: "2026-05-12",
+      kind: "reschedule",
+      startTimestamp: newStart,
+      // no timeSpan → inherits original UTC duration (1 hour)
+    };
+    const out = applyAlterations(TPL_ID, PAYLOAD, occs, [alt], "UTC", winStart, winEnd);
+    const moved = out.find((o) => o.occurrenceKey === "2026-05-12");
+    expect(moved?.endTimestamp).toBe(newStart + HOUR);
+  });
+
+  test("payloadOverride merges into base payload", () => {
+    const alt: Alteration<CronPayload> = {
+      id: "a1",
+      templateId: TPL_ID,
+      occurrenceKey: "2026-05-12",
+      kind: "reschedule",
+      startTimestamp: Date.UTC(2026, 4, 12, 9), // same time
+      timeSpan: { type: "duration", ms: HOUR },
+      payloadOverride: { command: "echo override" },
+    };
+    const out = applyAlterations(TPL_ID, PAYLOAD, occs, [alt], "UTC", winStart, winEnd);
+    const moved = out.find((o) => o.occurrenceKey === "2026-05-12");
+    expect(moved?.payload).toEqual({ type: "cron", command: "echo override" });
+  });
+
+  test("reschedule that moves event out of window is not emitted", () => {
+    const alt: Alteration<CronPayload> = {
+      id: "a1",
+      templateId: TPL_ID,
+      occurrenceKey: "2026-05-12",
+      kind: "reschedule",
+      startTimestamp: Date.UTC(2026, 5, 1), // out of window
+      timeSpan: { type: "duration", ms: HOUR },
+    };
+    const out = applyAlterations(TPL_ID, PAYLOAD, occs, [alt], "UTC", winStart, winEnd);
+    expect(out.map((o) => o.occurrenceKey)).toEqual(["2026-05-11", "2026-05-13"]);
+  });
+
+  test("orphan reschedule (original outside window, new time inside) is emitted", () => {
+    const alt: Alteration<CronPayload> = {
+      id: "orphan",
+      templateId: TPL_ID,
+      occurrenceKey: "2026-05-01",
+      kind: "reschedule",
+      startTimestamp: Date.UTC(2026, 4, 12, 13),
+      timeSpan: { type: "duration", ms: HOUR },
+    };
+    const out = applyAlterations(TPL_ID, PAYLOAD, occs, [alt], "UTC", winStart, winEnd);
+    expect(out.find((o) => o.alterationId === "orphan")).toBeDefined();
+    expect(out).toHaveLength(4); // 3 base + 1 orphan
+  });
+
+  test("alterations for other templates are ignored", () => {
+    const alt: Alteration<CronPayload> = {
+      id: "wrong",
+      templateId: "other-template",
+      occurrenceKey: "2026-05-12",
+      kind: "cancel",
+    };
+    const out = applyAlterations(TPL_ID, PAYLOAD, occs, [alt], "UTC", winStart, winEnd);
+    expect(out).toHaveLength(3);
+  });
+
+  test("output is sorted ascending by startTimestamp", () => {
+    const alt: Alteration<CronPayload> = {
+      id: "a1",
+      templateId: TPL_ID,
+      occurrenceKey: "2026-05-11",
+      kind: "reschedule",
+      startTimestamp: Date.UTC(2026, 4, 13, 18), // move the 11th to after the 13th
+      timeSpan: { type: "duration", ms: HOUR },
+    };
+    const out = applyAlterations(TPL_ID, PAYLOAD, occs, [alt], "UTC", winStart, winEnd);
+    const starts = out.map((o) => o.startTimestamp);
+    expect(starts).toEqual([...starts].sort((a, b) => a - b));
+  });
+});

package/src/__tests__/anchored.test.ts

@@ -0,0 +1,107 @@
+import { describe, expect, test } from "vitest";
+import { generateAnchored } from "../generators/anchored.js";
+import type { AnchoredRule } from "../types.js";
+
+const HOUR = 3_600_000;
+const DAY = 24 * HOUR;
+
+describe("generateAnchored", () => {
+  test("emits occurrences at intervalMs from anchor within window", () => {
+    const rule: AnchoredRule = {
+      kind: "anchored",
+      anchorDate: Date.UTC(2026, 4, 11, 9, 0, 0),
+      intervalMs: 6 * HOUR,
+      timeSpan: { type: "duration", ms: HOUR },
+      seriesStart: Date.UTC(2026, 4, 11),
+      seriesEnd: null,
+    };
+    const out = generateAnchored(rule, undefined, Date.UTC(2026, 4, 11), Date.UTC(2026, 4, 12));
+    // Anchor 09:00 + 6h steps = 09, 15, 21 on the 11th (3 events)
+    expect(out.map((o) => new Date(o.startTimestamp).toISOString())).toEqual([
+      "2026-05-11T09:00:00.000Z",
+      "2026-05-11T15:00:00.000Z",
+      "2026-05-11T21:00:00.000Z",
+    ]);
+  });
+
+  test("fast-forwards into the future without count", () => {
+    const rule: AnchoredRule = {
+      kind: "anchored",
+      anchorDate: Date.UTC(2020, 0, 1),
+      intervalMs: DAY,
+      timeSpan: { type: "duration", ms: HOUR },
+      seriesStart: Date.UTC(2020, 0, 1),
+      seriesEnd: null,
+    };
+    const out = generateAnchored(rule, undefined, Date.UTC(2026, 4, 11), Date.UTC(2026, 4, 14));
+    // 3 days in window, daily cadence, anchor far in the past → 3 events
+    expect(out).toHaveLength(3);
+    expect(new Date(out[0].startTimestamp).toISOString()).toBe("2026-05-11T00:00:00.000Z");
+  });
+
+  test("respects count and counts from anchor (not from window start)", () => {
+    const rule: AnchoredRule = {
+      kind: "anchored",
+      anchorDate: Date.UTC(2026, 4, 11),
+      intervalMs: DAY,
+      timeSpan: { type: "duration", ms: HOUR },
+      seriesStart: Date.UTC(2026, 4, 11),
+      seriesEnd: null,
+      count: 3,
+    };
+    // Window covers many days, but count=3 caps at 3 events
+    const out = generateAnchored(rule, undefined, Date.UTC(2026, 4, 11), Date.UTC(2026, 4, 30));
+    expect(out).toHaveLength(3);
+  });
+
+  test("count=3 with window after the 3rd event → empty", () => {
+    const rule: AnchoredRule = {
+      kind: "anchored",
+      anchorDate: Date.UTC(2026, 4, 11),
+      intervalMs: DAY,
+      timeSpan: { type: "duration", ms: HOUR },
+      seriesStart: Date.UTC(2026, 4, 11),
+      seriesEnd: null,
+      count: 3,
+    };
+    const out = generateAnchored(rule, undefined, Date.UTC(2026, 4, 20), Date.UTC(2026, 4, 30));
+    expect(out).toHaveLength(0);
+  });
+
+  test("respects seriesEnd as exclusive bound", () => {
+    const rule: AnchoredRule = {
+      kind: "anchored",
+      anchorDate: Date.UTC(2026, 4, 11),
+      intervalMs: DAY,
+      timeSpan: { type: "duration", ms: HOUR },
+      seriesStart: Date.UTC(2026, 4, 11),
+      seriesEnd: Date.UTC(2026, 4, 14), // 11, 12, 13 should emit; 14 should not
+    };
+    const out = generateAnchored(rule, undefined, Date.UTC(2026, 4, 11), Date.UTC(2026, 4, 30));
+    expect(out).toHaveLength(3);
+  });
+
+  test("throws on intervalMs <= 0 (no infinite loop)", () => {
+    const rule: AnchoredRule = {
+      kind: "anchored",
+      anchorDate: 0,
+      intervalMs: 0,
+      seriesStart: 0,
+      seriesEnd: null,
+    };
+    expect(() => generateAnchored(rule, undefined, 0, 1000)).toThrow(/intervalMs/);
+  });
+
+  test("throws on too many occurrences", () => {
+    const rule: AnchoredRule = {
+      kind: "anchored",
+      anchorDate: 0,
+      intervalMs: 1, // every ms
+      timeSpan: { type: "duration", ms: 1 }, // non-zero so half-open intersection emits
+      seriesStart: 0,
+      seriesEnd: null,
+    };
+    // Window is 100k ms, no count → would emit 100k events. Should throw.
+    expect(() => generateAnchored(rule, undefined, 0, 100_000)).toThrow(/more than/);
+  });
+});