@ddd-ts-kit/scheduling 0.0.0-stage → 0.1.0

package/dist/occurrence.d.ts

@@ -0,0 +1,6 @@
+/** One occurrence to run: due by time, or asked for with `runNow`. */
+export interface Occurrence {
+    readonly scheduledAt: Date;
+    readonly manual: boolean;
+}
+//# sourceMappingURL=occurrence.d.ts.map

package/dist/occurrence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"occurrence.d.ts","sourceRoot":"","sources":["../src/occurrence.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B"}

package/dist/occurrence.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=occurrence.js.map

package/dist/occurrence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"occurrence.js","sourceRoot":"","sources":["../src/occurrence.ts"],"names":[],"mappings":""}

package/dist/occurrences/instants-of-wall-time.d.ts

@@ -0,0 +1,7 @@
+/**
+ * The instants at which the clocks of the zone show a wall time, earliest first: none for a
+ * time skipped when clocks are set forward, two for a time repeated when they are set back. A
+ * wall time is written as the milliseconds it would be in UTC.
+ */
+export declare function instantsOfWallTime(timeZone: string, wallTime: number): number[];
+//# sourceMappingURL=instants-of-wall-time.d.ts.map

package/dist/occurrences/instants-of-wall-time.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instants-of-wall-time.d.ts","sourceRoot":"","sources":["../../src/occurrences/instants-of-wall-time.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAO/E"}

package/dist/occurrences/instants-of-wall-time.js

@@ -0,0 +1,15 @@
+import { offsetAt } from './offset-at.js';
+const DAY_MS = 86_400_000;
+/**
+ * The instants at which the clocks of the zone show a wall time, earliest first: none for a
+ * time skipped when clocks are set forward, two for a time repeated when they are set back. A
+ * wall time is written as the milliseconds it would be in UTC.
+ */
+export function instantsOfWallTime(timeZone, wallTime) {
+    const offsets = new Set([offsetAt(timeZone, wallTime - DAY_MS), offsetAt(timeZone, wallTime + DAY_MS)]);
+    return [...offsets]
+        .filter((offset) => offsetAt(timeZone, wallTime - offset) === offset)
+        .map((offset) => wallTime - offset)
+        .sort((left, right) => left - right);
+}
+//# sourceMappingURL=instants-of-wall-time.js.map

package/dist/occurrences/instants-of-wall-time.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instants-of-wall-time.js","sourceRoot":"","sources":["../../src/occurrences/instants-of-wall-time.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,MAAM,MAAM,GAAG,UAAU,CAAC;AAE1B;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAgB,EAAE,QAAgB;IACnE,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAAC,EAAE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IAExG,OAAO,CAAC,GAAG,OAAO,CAAC;SAChB,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAAC,KAAK,MAAM,CAAC;SACpE,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,QAAQ,GAAG,MAAM,CAAC;SAClC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC;AACzC,CAAC"}

package/dist/occurrences/latest-occurrence.d.ts

@@ -0,0 +1,10 @@
+import type { ParsedJobSchedule } from '@ddd-ts-kit/kernel';
+export interface OccurrenceRange {
+    /** Excluded. */
+    readonly after: Date;
+    /** Included. */
+    readonly notAfter: Date;
+}
+/** The last occurrence of the schedule in the range, `undefined` when it holds none. */
+export declare function latestOccurrence(schedule: ParsedJobSchedule, range: OccurrenceRange): Date | undefined;
+//# sourceMappingURL=latest-occurrence.d.ts.map

package/dist/occurrences/latest-occurrence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"latest-occurrence.d.ts","sourceRoot":"","sources":["../../src/occurrences/latest-occurrence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAc,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAIxE,MAAM,WAAW,eAAe;IAC9B,gBAAgB;IAChB,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC;IACrB,gBAAgB;IAChB,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC;CACzB;AAED,wFAAwF;AACxF,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,KAAK,EAAE,eAAe,GAAG,IAAI,GAAG,SAAS,CAUtG"}

package/dist/occurrences/latest-occurrence.js

@@ -0,0 +1,22 @@
+import { localDayOf } from './local-day-of.js';
+import { occurrencesOfDay } from './occurrences-of-day.js';
+/** The last occurrence of the schedule in the range, `undefined` when it holds none. */
+export function latestOccurrence(schedule, range) {
+    const from = range.after.getTime();
+    const until = range.notAfter.getTime();
+    const latest = schedule.kind === 'interval'
+        ? Math.floor(until / schedule.everyMs) * schedule.everyMs
+        : latestOfCron(schedule, until, from);
+    return latest === undefined || latest <= from ? undefined : new Date(latest);
+}
+function latestOfCron(cron, until, from) {
+    const lastDay = localDayOf(cron, from) - 1;
+    for (let day = localDayOf(cron, until) + 1; day >= lastDay; day -= 1) {
+        const found = occurrencesOfDay(cron, day).findLast((occurrence) => occurrence <= until);
+        if (found !== undefined) {
+            return found;
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=latest-occurrence.js.map

package/dist/occurrences/latest-occurrence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"latest-occurrence.js","sourceRoot":"","sources":["../../src/occurrences/latest-occurrence.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAS3D,wFAAwF;AACxF,MAAM,UAAU,gBAAgB,CAAC,QAA2B,EAAE,KAAsB;IAClF,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;IACnC,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;IAEvC,MAAM,MAAM,GACV,QAAQ,CAAC,IAAI,KAAK,UAAU;QAC1B,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,QAAQ,CAAC,OAAO;QACzD,CAAC,CAAC,YAAY,CAAC,QAAQ,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;IAE1C,OAAO,MAAM,KAAK,SAAS,IAAI,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC;AAC/E,CAAC;AAED,SAAS,YAAY,CAAC,IAAgB,EAAE,KAAa,EAAE,IAAY;IACjE,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;IAE3C,KAAK,IAAI,GAAG,GAAG,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,OAAO,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;QACrE,MAAM,KAAK,GAAG,gBAAgB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,IAAI,KAAK,CAAC,CAAC;QAExF,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/occurrences/local-day-of.d.ts

@@ -0,0 +1,4 @@
+import type { ParsedCron } from '@ddd-ts-kit/kernel';
+/** The day the clocks of the zone show at an instant, counted from the epoch. */
+export declare function localDayOf(cron: ParsedCron, instant: number): number;
+//# sourceMappingURL=local-day-of.d.ts.map

package/dist/occurrences/local-day-of.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-day-of.d.ts","sourceRoot":"","sources":["../../src/occurrences/local-day-of.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAKrD,iFAAiF;AACjF,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAEpE"}

package/dist/occurrences/local-day-of.js

@@ -0,0 +1,7 @@
+import { offsetAt } from './offset-at.js';
+const DAY_MS = 86_400_000;
+/** The day the clocks of the zone show at an instant, counted from the epoch. */
+export function localDayOf(cron, instant) {
+    return Math.floor((instant + offsetAt(cron.timeZone, instant)) / DAY_MS);
+}
+//# sourceMappingURL=local-day-of.js.map

package/dist/occurrences/local-day-of.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-day-of.js","sourceRoot":"","sources":["../../src/occurrences/local-day-of.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,MAAM,MAAM,GAAG,UAAU,CAAC;AAE1B,iFAAiF;AACjF,MAAM,UAAU,UAAU,CAAC,IAAgB,EAAE,OAAe;IAC1D,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC;AAC3E,CAAC"}

package/dist/occurrences/next-occurrence.d.ts

@@ -0,0 +1,4 @@
+import type { ParsedJobSchedule } from '@ddd-ts-kit/kernel';
+/** The first occurrence of the schedule strictly after an instant. */
+export declare function nextOccurrence(schedule: ParsedJobSchedule, after: Date): Date;
+//# sourceMappingURL=next-occurrence.d.ts.map

package/dist/occurrences/next-occurrence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"next-occurrence.d.ts","sourceRoot":"","sources":["../../src/occurrences/next-occurrence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAO5D,sEAAsE;AACtE,wBAAgB,cAAc,CAAC,QAAQ,EAAE,iBAAiB,EAAE,KAAK,EAAE,IAAI,GAAG,IAAI,CAoB7E"}

package/dist/occurrences/next-occurrence.js

@@ -0,0 +1,20 @@
+import { localDayOf } from './local-day-of.js';
+import { occurrencesOfDay } from './occurrences-of-day.js';
+/** Two 29ths of February are at most eight years apart. */
+const HORIZON_DAYS = 366 * 8 + 2;
+/** The first occurrence of the schedule strictly after an instant. */
+export function nextOccurrence(schedule, after) {
+    const instant = after.getTime();
+    if (schedule.kind === 'interval') {
+        return new Date((Math.floor(instant / schedule.everyMs) + 1) * schedule.everyMs);
+    }
+    const firstDay = localDayOf(schedule, instant) - 1;
+    for (let day = firstDay; day < firstDay + HORIZON_DAYS; day += 1) {
+        const found = occurrencesOfDay(schedule, day).find((occurrence) => occurrence > instant);
+        if (found !== undefined) {
+            return new Date(found);
+        }
+    }
+    throw new RangeError(`Cron "${schedule.expression}" has no occurrence in the eight years after ${after.toISOString()}.`);
+}
+//# sourceMappingURL=next-occurrence.js.map

package/dist/occurrences/next-occurrence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"next-occurrence.js","sourceRoot":"","sources":["../../src/occurrences/next-occurrence.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,2DAA2D;AAC3D,MAAM,YAAY,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;AAEjC,sEAAsE;AACtE,MAAM,UAAU,cAAc,CAAC,QAA2B,EAAE,KAAW;IACrE,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC;IAEhC,IAAI,QAAQ,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QACjC,OAAO,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;IACnF,CAAC;IAED,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;IAEnD,KAAK,IAAI,GAAG,GAAG,QAAQ,EAAE,GAAG,GAAG,QAAQ,GAAG,YAAY,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;QACjE,MAAM,KAAK,GAAG,gBAAgB,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,GAAG,OAAO,CAAC,CAAC;QAEzF,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAED,MAAM,IAAI,UAAU,CAClB,SAAS,QAAQ,CAAC,UAAU,gDAAgD,KAAK,CAAC,WAAW,EAAE,GAAG,CACnG,CAAC;AACJ,CAAC"}

package/dist/occurrences/occurrences-of-day.d.ts

@@ -0,0 +1,4 @@
+import type { ParsedCron } from '@ddd-ts-kit/kernel';
+/** The instants of one local day at which the expression fires, in order. Most days hold no change of offset. */
+export declare function occurrencesOfDay(cron: ParsedCron, day: number): number[];
+//# sourceMappingURL=occurrences-of-day.d.ts.map

package/dist/occurrences/occurrences-of-day.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"occurrences-of-day.d.ts","sourceRoot":"","sources":["../../src/occurrences/occurrences-of-day.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAQrD,iHAAiH;AACjH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAgBxE"}

package/dist/occurrences/occurrences-of-day.js

@@ -0,0 +1,35 @@
+import { instantsOfWallTime } from './instants-of-wall-time.js';
+import { offsetAt } from './offset-at.js';
+const MINUTE_MS = 60_000;
+const HOUR_MS = 3_600_000;
+const DAY_MS = 86_400_000;
+/** The instants of one local day at which the expression fires, in order. Most days hold no change of offset. */
+export function occurrencesOfDay(cron, day) {
+    if (!firesOn(cron, day)) {
+        return [];
+    }
+    const wallTimes = cron.hours.flatMap((hour) => cron.minutes.map((minute) => day * DAY_MS + hour * HOUR_MS + minute * MINUTE_MS));
+    const before = offsetAt(cron.timeZone, (day - 1) * DAY_MS);
+    if (before === offsetAt(cron.timeZone, (day + 2) * DAY_MS)) {
+        return wallTimes.map((wallTime) => wallTime - before);
+    }
+    return wallTimes.flatMap((wallTime) => occurrencesAt(cron, wallTime)).sort((left, right) => left - right);
+}
+/** The day-of-month and day-of-week fields are alternatives when both are restricted, as in every cron. */
+function firesOn(cron, day) {
+    const date = new Date(day * DAY_MS);
+    if (!cron.months.includes(date.getUTCMonth() + 1)) {
+        return false;
+    }
+    const onDayOfMonth = cron.daysOfMonth.includes(date.getUTCDate());
+    const onDayOfWeek = cron.daysOfWeek.includes(date.getUTCDay());
+    return cron.dayOfMonthRestricted && cron.dayOfWeekRestricted
+        ? onDayOfMonth || onDayOfWeek
+        : onDayOfMonth && onDayOfWeek;
+}
+/** A wall time that occurs twice runs once, unless the job follows elapsed time (`*` hours). */
+function occurrencesAt(cron, wallTime) {
+    const instants = instantsOfWallTime(cron.timeZone, wallTime);
+    return cron.everyHour ? instants : instants.slice(0, 1);
+}
+//# sourceMappingURL=occurrences-of-day.js.map

package/dist/occurrences/occurrences-of-day.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"occurrences-of-day.js","sourceRoot":"","sources":["../../src/occurrences/occurrences-of-day.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,MAAM,SAAS,GAAG,MAAM,CAAC;AACzB,MAAM,OAAO,GAAG,SAAS,CAAC;AAC1B,MAAM,MAAM,GAAG,UAAU,CAAC;AAE1B,iHAAiH;AACjH,MAAM,UAAU,gBAAgB,CAAC,IAAgB,EAAE,GAAW;IAC5D,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC;QACxB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAC5C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC,CACjF,CAAC;IAEF,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC;IAE3D,IAAI,MAAM,KAAK,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,EAAE,CAAC;QAC3D,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,GAAG,MAAM,CAAC,CAAC;IACxD,CAAC;IAED,OAAO,SAAS,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC;AAC5G,CAAC;AAED,2GAA2G;AAC3G,SAAS,OAAO,CAAC,IAAgB,EAAE,GAAW;IAC5C,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,GAAG,GAAG,MAAM,CAAC,CAAC;IAEpC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC;QAClD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,YAAY,GAAG,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;IAClE,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;IAE/D,OAAO,IAAI,CAAC,oBAAoB,IAAI,IAAI,CAAC,mBAAmB;QAC1D,CAAC,CAAC,YAAY,IAAI,WAAW;QAC7B,CAAC,CAAC,YAAY,IAAI,WAAW,CAAC;AAClC,CAAC;AAED,gGAAgG;AAChG,SAAS,aAAa,CAAC,IAAgB,EAAE,QAAgB;IACvD,MAAM,QAAQ,GAAG,kBAAkB,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAE7D,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAC1D,CAAC"}

package/dist/occurrences/offset-at.d.ts

@@ -0,0 +1,3 @@
+/** What the clocks of the zone show at an instant, minus the instant: positive east of Greenwich. */
+export declare function offsetAt(timeZone: string, instant: number): number;
+//# sourceMappingURL=offset-at.d.ts.map

package/dist/occurrences/offset-at.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"offset-at.d.ts","sourceRoot":"","sources":["../../src/occurrences/offset-at.ts"],"names":[],"mappings":"AAEA,qGAAqG;AACrG,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAuBlE"}

package/dist/occurrences/offset-at.js

@@ -0,0 +1,32 @@
+const formatters = new Map();
+/** What the clocks of the zone show at an instant, minus the instant: positive east of Greenwich. */
+export function offsetAt(timeZone, instant) {
+    if (timeZone === 'UTC') {
+        return 0;
+    }
+    const shown = new Map(formatterOf(timeZone)
+        .formatToParts(instant)
+        .map((part) => [part.type, Number(part.value)]));
+    const field = (type) => shown.get(type) ?? 0;
+    const wallTime = Date.UTC(field('year'), field('month') - 1, field('day'), field('hour'), field('minute'), field('second'));
+    return wallTime - Math.floor(instant / 1_000) * 1_000;
+}
+function formatterOf(timeZone) {
+    const known = formatters.get(timeZone);
+    if (known !== undefined) {
+        return known;
+    }
+    const formatter = new Intl.DateTimeFormat('en-US', {
+        timeZone,
+        hourCycle: 'h23',
+        year: 'numeric',
+        month: 'numeric',
+        day: 'numeric',
+        hour: 'numeric',
+        minute: 'numeric',
+        second: 'numeric',
+    });
+    formatters.set(timeZone, formatter);
+    return formatter;
+}
+//# sourceMappingURL=offset-at.js.map

package/dist/occurrences/offset-at.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"offset-at.js","sourceRoot":"","sources":["../../src/occurrences/offset-at.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,GAAG,IAAI,GAAG,EAA+B,CAAC;AAE1D,qGAAqG;AACrG,MAAM,UAAU,QAAQ,CAAC,QAAgB,EAAE,OAAe;IACxD,IAAI,QAAQ,KAAK,KAAK,EAAE,CAAC;QACvB,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,GAAG,CACnB,WAAW,CAAC,QAAQ,CAAC;SAClB,aAAa,CAAC,OAAO,CAAC;SACtB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAClD,CAAC;IAEF,MAAM,KAAK,GAAG,CAAC,IAAkC,EAAU,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEnF,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CACvB,KAAK,CAAC,MAAM,CAAC,EACb,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAClB,KAAK,CAAC,KAAK,CAAC,EACZ,KAAK,CAAC,MAAM,CAAC,EACb,KAAK,CAAC,QAAQ,CAAC,EACf,KAAK,CAAC,QAAQ,CAAC,CAChB,CAAC;IAEF,OAAO,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,GAAG,KAAK,CAAC;AACxD,CAAC;AAED,SAAS,WAAW,CAAC,QAAgB;IACnC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAEvC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE;QACjD,QAAQ;QACR,SAAS,EAAE,KAAK;QAChB,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,SAAS;QAChB,GAAG,EAAE,SAAS;QACd,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,SAAS;KAClB,CAAC,CAAC;IAEH,UAAU,CAAC,GAAG,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IAEpC,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/registered-job.d.ts

@@ -0,0 +1,21 @@
+import { type JobDefinition, type JobPolicy, type JobRun, type LockHandle, type ParsedJobSchedule } from '@ddd-ts-kit/kernel';
+/** A job and what this instance knows of it. Held by the scheduler alone. */
+export declare class RegisteredJob {
+    readonly definition: JobDefinition;
+    readonly name: string;
+    readonly policy: JobPolicy;
+    readonly schedule: ParsedJobSchedule;
+    readonly scheduleText: string;
+    /** The last occurrence handled, or the instant the scheduler started following the job. */
+    cursor: Date | undefined;
+    cancelSleep: (() => void) | undefined;
+    /** The run in progress, or the one waiting behind it. */
+    active: Promise<JobRun> | undefined;
+    waiting: boolean;
+    lastRun: JobRun | undefined;
+    /** The lock of the last occurrence run, kept until the next one so that no instance runs it again. */
+    held: LockHandle | undefined;
+    abort: ((reason: Error) => void) | undefined;
+    constructor(definition: JobDefinition);
+}
+//# sourceMappingURL=registered-job.d.ts.map

package/dist/registered-job.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registered-job.d.ts","sourceRoot":"","sources":["../src/registered-job.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,MAAM,EACX,KAAK,UAAU,EACf,KAAK,iBAAiB,EACvB,MAAM,oBAAoB,CAAC;AAE5B,6EAA6E;AAC7E,qBAAa,aAAa;IA0BZ,QAAQ,CAAC,UAAU,EAAE,aAAa;IAzB9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAE3B,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IAErC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAE9B,2FAA2F;IAC3F,MAAM,EAAE,IAAI,GAAG,SAAS,CAAC;IAEzB,WAAW,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC;IAEtC,yDAAyD;IACzD,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;IAEpC,OAAO,UAAS;IAEhB,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAE5B,sGAAsG;IACtG,IAAI,EAAE,UAAU,GAAG,SAAS,CAAC;IAE7B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,KAAK,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IAE7C,YAAqB,UAAU,EAAE,aAAa,EAK7C;CACF"}

package/dist/registered-job.js

@@ -0,0 +1,27 @@
+import { describeJobSchedule, jobPolicy, parseJobSchedule, } from '@ddd-ts-kit/kernel';
+/** A job and what this instance knows of it. Held by the scheduler alone. */
+export class RegisteredJob {
+    definition;
+    name;
+    policy;
+    schedule;
+    scheduleText;
+    /** The last occurrence handled, or the instant the scheduler started following the job. */
+    cursor;
+    cancelSleep;
+    /** The run in progress, or the one waiting behind it. */
+    active;
+    waiting = false;
+    lastRun;
+    /** The lock of the last occurrence run, kept until the next one so that no instance runs it again. */
+    held;
+    abort;
+    constructor(definition) {
+        this.definition = definition;
+        this.name = definition.name;
+        this.policy = jobPolicy(definition);
+        this.schedule = parseJobSchedule(definition.schedule);
+        this.scheduleText = describeJobSchedule(definition.schedule);
+    }
+}
+//# sourceMappingURL=registered-job.js.map

package/dist/registered-job.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registered-job.js","sourceRoot":"","sources":["../src/registered-job.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,SAAS,EACT,gBAAgB,GAMjB,MAAM,oBAAoB,CAAC;AAE5B,6EAA6E;AAC7E,MAAM,OAAO,aAAa;IA0BH,UAAU;IAzBtB,IAAI,CAAS;IAEb,MAAM,CAAY;IAElB,QAAQ,CAAoB;IAE5B,YAAY,CAAS;IAE9B,2FAA2F;IAC3F,MAAM,CAAmB;IAEzB,WAAW,CAA2B;IAEtC,yDAAyD;IACzD,MAAM,CAA8B;IAEpC,OAAO,GAAG,KAAK,CAAC;IAEhB,OAAO,CAAqB;IAE5B,sGAAsG;IACtG,IAAI,CAAyB;IAE7B,KAAK,CAAwC;IAE7C,YAAqB,UAAyB;0BAAzB,UAAU;QAC7B,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC;QAC5B,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC;QACpC,IAAI,CAAC,QAAQ,GAAG,gBAAgB,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QACtD,IAAI,CAAC,YAAY,GAAG,mBAAmB,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IAC/D,CAAC;CACF"}

package/dist/report-failed-runs.d.ts

@@ -0,0 +1,11 @@
+import { type ErrorReporter } from '@ddd-ts-kit/kernel';
+import type { JobRunObserver } from './job-run-observer.js';
+/**
+ * The observer that reports every run that failed with something else than a `DomainError`:
+ * a timeout, a lock that could not be asked, a fault of the job. A run that was skipped or
+ * missed is not a failure, and one whose command a bus middleware already reported is left alone.
+ *
+ *     new InProcessJobScheduler({ ..., onRun: reportFailedRuns(errors) });
+ */
+export declare function reportFailedRuns(reporter: ErrorReporter): JobRunObserver;
+//# sourceMappingURL=report-failed-runs.d.ts.map

package/dist/report-failed-runs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-failed-runs.d.ts","sourceRoot":"","sources":["../src/report-failed-runs.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6D,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,aAAa,GAAG,cAAc,CAkBxE"}

package/dist/report-failed-runs.js

@@ -0,0 +1,23 @@
+import { errorReportOf, isUnexpectedError, reportOnce, systemActor } from '@ddd-ts-kit/kernel';
+/**
+ * The observer that reports every run that failed with something else than a `DomainError`:
+ * a timeout, a lock that could not be asked, a fault of the job. A run that was skipped or
+ * missed is not a failure, and one whose command a bus middleware already reported is left alone.
+ *
+ *     new InProcessJobScheduler({ ..., onRun: reportFailedRuns(errors) });
+ */
+export function reportFailedRuns(reporter) {
+    return (run, error, detail) => {
+        if (run.outcome !== 'failed' || !isUnexpectedError(error)) {
+            return;
+        }
+        reportOnce(reporter, error, errorReportOf(error, {
+            origin: 'schedule',
+            operation: run.job,
+            context: run.job.split('.', 1).join(''),
+            actorId: systemActor(run.job).id,
+            ...(detail?.correlationId === undefined ? {} : { correlationId: detail.correlationId }),
+        }));
+    };
+}
+//# sourceMappingURL=report-failed-runs.js.map

package/dist/report-failed-runs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-failed-runs.js","sourceRoot":"","sources":["../src/report-failed-runs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,UAAU,EAAE,WAAW,EAAsB,MAAM,oBAAoB,CAAC;AAGnH;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAuB;IACtD,OAAO,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QAC5B,IAAI,GAAG,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1D,OAAO;QACT,CAAC;QAED,UAAU,CACR,QAAQ,EACR,KAAK,EACL,aAAa,CAAC,KAAK,EAAE;YACnB,MAAM,EAAE,UAAU;YAClB,SAAS,EAAE,GAAG,CAAC,GAAG;YAClB,OAAO,EAAE,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;YACvC,OAAO,EAAE,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE;YAChC,GAAG,CAAC,MAAM,EAAE,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,MAAM,CAAC,aAAa,EAAE,CAAC;SACxF,CAAC,CACH,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

package/dist/started-run.d.ts

@@ -0,0 +1,7 @@
+import type { Occurrence } from './occurrence.js';
+export interface StartedRun {
+    readonly occurrence: Occurrence;
+    readonly startedAt: Date;
+    readonly correlationId: string;
+}
+//# sourceMappingURL=started-run.d.ts.map

package/dist/started-run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"started-run.d.ts","sourceRoot":"","sources":["../src/started-run.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC"}

package/dist/started-run.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=started-run.js.map

package/dist/started-run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"started-run.js","sourceRoot":"","sources":["../src/started-run.ts"],"names":[],"mappings":""}

package/dist/system-job-timers.d.ts

@@ -0,0 +1,3 @@
+import type { JobTimers } from './job-timers.js';
+export declare const systemJobTimers: JobTimers;
+//# sourceMappingURL=system-job-timers.d.ts.map

package/dist/system-job-timers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-job-timers.d.ts","sourceRoot":"","sources":["../src/system-job-timers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,eAAO,MAAM,eAAe,EAAE,SAQ5B,CAAC"}

package/dist/system-job-timers.js

@@ -0,0 +1,9 @@
+export const systemJobTimers = Object.freeze({
+    schedule(delayMs, task) {
+        const timer = setTimeout(task, delayMs);
+        return () => {
+            clearTimeout(timer);
+        };
+    },
+});
+//# sourceMappingURL=system-job-timers.js.map

package/dist/system-job-timers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-job-timers.js","sourceRoot":"","sources":["../src/system-job-timers.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,eAAe,GAAc,MAAM,CAAC,MAAM,CAAC;IACtD,QAAQ,CAAC,OAAe,EAAE,IAAgB;QACxC,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAExC,OAAO,GAAG,EAAE;YACV,YAAY,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/testing/manual-job-scheduler.d.ts

@@ -0,0 +1,24 @@
+import type { FixedClock, JobRun } from '@ddd-ts-kit/kernel';
+import { InProcessJobScheduler, type InProcessJobSchedulerOptions } from '../in-process-job-scheduler.js';
+import { ManualJobTimers } from './manual-job-timers.js';
+export interface ManualJobSchedulerOptions extends Omit<InProcessJobSchedulerOptions, 'timers' | 'clock' | 'random'> {
+    /** The clock `advance` moves. */
+    readonly clock: FixedClock;
+}
+/**
+ * The in-process scheduler on manual timers, without jitter: a test registers jobs, starts it,
+ * advances time and reads `runs`, or runs one job with `runNow`.
+ */
+export declare class ManualJobScheduler extends InProcessJobScheduler {
+    /** Every occurrence handled, in order, whatever became of it. */
+    readonly runs: JobRun[];
+    /** What the failed runs threw, in order. */
+    readonly failures: unknown[];
+    readonly timers: ManualJobTimers;
+    constructor(options: ManualJobSchedulerOptions);
+    /** See `ManualJobTimers.advance`. */
+    advance(durationMs: number): Promise<void>;
+    /** The runs of one job, in order. */
+    runsOf(job: string): JobRun[];
+}
+//# sourceMappingURL=manual-job-scheduler.d.ts.map

package/dist/testing/manual-job-scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manual-job-scheduler.d.ts","sourceRoot":"","sources":["../../src/testing/manual-job-scheduler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,KAAK,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AAC1G,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,MAAM,WAAW,yBAA0B,SAAQ,IAAI,CAAC,4BAA4B,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;IAClH,iCAAiC;IACjC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;CAC5B;AAED;;;GAGG;AACH,qBAAa,kBAAmB,SAAQ,qBAAqB;IAC3D,iEAAiE;IACjE,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IAExB,4CAA4C;IAC5C,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAC;IAE7B,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IAEjC,YAAY,OAAO,EAAE,yBAAyB,EAuB7C;IAED,qCAAqC;IACrC,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEzC;IAED,qCAAqC;IACrC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAE5B;CACF"}

package/dist/testing/manual-job-scheduler.js

@@ -0,0 +1,42 @@
+import { InProcessJobScheduler } from '../in-process-job-scheduler.js';
+import { ManualJobTimers } from './manual-job-timers.js';
+/**
+ * The in-process scheduler on manual timers, without jitter: a test registers jobs, starts it,
+ * advances time and reads `runs`, or runs one job with `runNow`.
+ */
+export class ManualJobScheduler extends InProcessJobScheduler {
+    /** Every occurrence handled, in order, whatever became of it. */
+    runs;
+    /** What the failed runs threw, in order. */
+    failures;
+    timers;
+    constructor(options) {
+        const timers = new ManualJobTimers(options.clock);
+        const runs = [];
+        const failures = [];
+        super({
+            ...options,
+            timers,
+            random: () => 0,
+            onRun: (run, error, detail) => {
+                runs.push(run);
+                if (run.outcome === 'failed') {
+                    failures.push(error);
+                }
+                options.onRun?.(run, error, detail);
+            },
+        });
+        this.timers = timers;
+        this.runs = runs;
+        this.failures = failures;
+    }
+    /** See `ManualJobTimers.advance`. */
+    advance(durationMs) {
+        return this.timers.advance(durationMs);
+    }
+    /** The runs of one job, in order. */
+    runsOf(job) {
+        return this.runs.filter((run) => run.job === job);
+    }
+}
+//# sourceMappingURL=manual-job-scheduler.js.map

package/dist/testing/manual-job-scheduler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manual-job-scheduler.js","sourceRoot":"","sources":["../../src/testing/manual-job-scheduler.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAqC,MAAM,gCAAgC,CAAC;AAC1G,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAOzD;;;GAGG;AACH,MAAM,OAAO,kBAAmB,SAAQ,qBAAqB;IAC3D,iEAAiE;IACxD,IAAI,CAAW;IAExB,4CAA4C;IACnC,QAAQ,CAAY;IAEpB,MAAM,CAAkB;IAEjC,YAAY,OAAkC;QAC5C,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAClD,MAAM,IAAI,GAAa,EAAE,CAAC;QAC1B,MAAM,QAAQ,GAAc,EAAE,CAAC;QAE/B,KAAK,CAAC;YACJ,GAAG,OAAO;YACV,MAAM;YACN,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;YACf,KAAK,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;gBAC5B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAEf,IAAI,GAAG,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;oBAC7B,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBACvB,CAAC;gBAED,OAAO,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;YACtC,CAAC;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,qCAAqC;IACrC,OAAO,CAAC,UAAkB;QACxB,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACzC,CAAC;IAED,qCAAqC;IACrC,MAAM,CAAC,GAAW;QAChB,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC;IACpD,CAAC;CACF"}

package/dist/testing/manual-job-timers.d.ts

@@ -0,0 +1,23 @@
+import type { FixedClock } from '@ddd-ts-kit/kernel';
+import type { JobTimers } from '../job-timers.js';
+/**
+ * Timers that only move when a test says so, on the clock the scheduler reads: `advance(ms)`
+ * fires what becomes due, in order, each at its instant.
+ */
+export declare class ManualJobTimers implements JobTimers {
+    private readonly clock;
+    private sleeping;
+    constructor(clock: FixedClock);
+    /** Timers neither fired nor cancelled. */
+    get pending(): number;
+    schedule(delayMs: number, task: () => void): () => void;
+    /**
+     * Moves the clock forward, firing each timer at its instant and letting what it started go as
+     * far as promises alone take it: a job that waits on nothing else has ended when this resolves,
+     * a job blocked by the test is still running.
+     */
+    advance(durationMs: number): Promise<void>;
+    private nextDue;
+    private moveTo;
+}
+//# sourceMappingURL=manual-job-timers.d.ts.map

package/dist/testing/manual-job-timers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manual-job-timers.d.ts","sourceRoot":"","sources":["../../src/testing/manual-job-timers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAOlD;;;GAGG;AACH,qBAAa,eAAgB,YAAW,SAAS;IAGnC,OAAO,CAAC,QAAQ,CAAC,KAAK;IAFlC,OAAO,CAAC,QAAQ,CAAkB;IAElC,YAA6B,KAAK,EAAE,UAAU,EAAI;IAElD,0CAA0C;IAC1C,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAQtD;IAED;;;;OAIG;IACG,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAa/C;IAED,OAAO,CAAC,OAAO;IAQf,OAAO,CAAC,MAAM;CAGf"}

package/dist/testing/manual-job-timers.js

@@ -0,0 +1,54 @@
+/**
+ * Timers that only move when a test says so, on the clock the scheduler reads: `advance(ms)`
+ * fires what becomes due, in order, each at its instant.
+ */
+export class ManualJobTimers {
+    clock;
+    sleeping = [];
+    constructor(clock) {
+        this.clock = clock;
+    }
+    /** Timers neither fired nor cancelled. */
+    get pending() {
+        return this.sleeping.length;
+    }
+    schedule(delayMs, task) {
+        const sleeping = { dueAt: this.clock.now().getTime() + delayMs, task };
+        this.sleeping.push(sleeping);
+        return () => {
+            this.sleeping = this.sleeping.filter((other) => other !== sleeping);
+        };
+    }
+    /**
+     * Moves the clock forward, firing each timer at its instant and letting what it started go as
+     * far as promises alone take it: a job that waits on nothing else has ended when this resolves,
+     * a job blocked by the test is still running.
+     */
+    async advance(durationMs) {
+        const target = this.clock.now().getTime() + durationMs;
+        await settled();
+        for (let next = this.nextDue(target); next !== undefined; next = this.nextDue(target)) {
+            this.sleeping = this.sleeping.filter((other) => other !== next);
+            this.moveTo(next.dueAt);
+            next.task();
+            await settled();
+        }
+        this.moveTo(target);
+    }
+    nextDue(target) {
+        const [earliest] = this.sleeping
+            .filter(({ dueAt }) => dueAt <= target)
+            .sort((left, right) => left.dueAt - right.dueAt);
+        return earliest;
+    }
+    moveTo(instant) {
+        this.clock.advance(Math.max(0, instant - this.clock.now().getTime()));
+    }
+}
+/** One turn of the event loop: every promise that depends on promises alone has settled. Not a wait in time. */
+function settled() {
+    return new Promise((resolve) => {
+        setImmediate(resolve);
+    });
+}
+//# sourceMappingURL=manual-job-timers.js.map

package/dist/testing/manual-job-timers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manual-job-timers.js","sourceRoot":"","sources":["../../src/testing/manual-job-timers.ts"],"names":[],"mappings":"AAQA;;;GAGG;AACH,MAAM,OAAO,eAAe;IAGG,KAAK;IAF1B,QAAQ,GAAe,EAAE,CAAC;IAElC,YAA6B,KAAiB;qBAAjB,KAAK;IAAe,CAAC;IAElD,0CAA0C;IAC1C,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;IAC9B,CAAC;IAED,QAAQ,CAAC,OAAe,EAAE,IAAgB;QACxC,MAAM,QAAQ,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,CAAC;QAEvE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAE7B,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC;QACtE,CAAC,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,OAAO,CAAC,UAAkB;QAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,GAAG,UAAU,CAAC;QAEvD,MAAM,OAAO,EAAE,CAAC;QAEhB,KAAK,IAAI,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,KAAK,SAAS,EAAE,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACtF,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC;YAChE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACxB,IAAI,CAAC,IAAI,EAAE,CAAC;YACZ,MAAM,OAAO,EAAE,CAAC;QAClB,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACtB,CAAC;IAEO,OAAO,CAAC,MAAc;QAC5B,MAAM,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,QAAQ;aAC7B,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,KAAK,IAAI,MAAM,CAAC;aACtC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;QAEnD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAEO,MAAM,CAAC,OAAe;QAC5B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IACxE,CAAC;CACF;AAED,gHAAgH;AAChH,SAAS,OAAO;IACd,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,YAAY,CAAC,OAAO,CAAC,CAAC;IACxB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/testing.d.ts

@@ -0,0 +1,3 @@
+export { ManualJobScheduler, type ManualJobSchedulerOptions } from './testing/manual-job-scheduler.js';
+export { ManualJobTimers } from './testing/manual-job-timers.js';
+//# sourceMappingURL=testing.d.ts.map

package/dist/testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,KAAK,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AACvG,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/testing.js

@@ -0,0 +1,3 @@
+export { ManualJobScheduler } from './testing/manual-job-scheduler.js';
+export { ManualJobTimers } from './testing/manual-job-timers.js';
+//# sourceMappingURL=testing.js.map

package/dist/testing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.js","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAkC,MAAM,mCAAmC,CAAC;AACvG,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC"}