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

package/dist/application/scheduling/duplicate-job-error.d.ts

@@ -0,0 +1,6 @@
+export declare class DuplicateJobError extends Error {
+    readonly job: string;
+    readonly code = "DUPLICATE_JOB";
+    constructor(job: string);
+}
+//# sourceMappingURL=duplicate-job-error.d.ts.map

package/dist/application/scheduling/duplicate-job-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duplicate-job-error.d.ts","sourceRoot":"","sources":["../../../src/application/scheduling/duplicate-job-error.ts"],"names":[],"mappings":"AAAA,qBAAa,iBAAkB,SAAQ,KAAK;IAG9B,QAAQ,CAAC,GAAG,EAAE,MAAM;IAFhC,QAAQ,CAAC,IAAI,mBAAmB;IAEhC,YAAqB,GAAG,EAAE,MAAM,EAG/B;CACF"}

package/dist/application/scheduling/duplicate-job-error.js

@@ -0,0 +1,10 @@
+export class DuplicateJobError extends Error {
+    job;
+    code = 'DUPLICATE_JOB';
+    constructor(job) {
+        super(`A job named "${job}" is already registered: a job name is unique in an application.`);
+        this.job = job;
+        this.name = 'DuplicateJobError';
+    }
+}
+//# sourceMappingURL=duplicate-job-error.js.map

package/dist/application/scheduling/duplicate-job-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"duplicate-job-error.js","sourceRoot":"","sources":["../../../src/application/scheduling/duplicate-job-error.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAGrB,GAAG;IAFf,IAAI,GAAG,eAAe,CAAC;IAEhC,YAAqB,GAAW;QAC9B,KAAK,CAAC,gBAAgB,GAAG,kEAAkE,CAAC,CAAC;mBAD1E,GAAG;QAEtB,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF"}

package/dist/application/scheduling/duration-text.d.ts

@@ -0,0 +1,3 @@
+/** A whole number followed by a unit: `'500ms'`, `'30s'`, `'15m'`, `'2h'`, `'1d'`. */
+export type DurationText = `${number}${'ms' | 's' | 'm' | 'h' | 'd'}`;
+//# sourceMappingURL=duration-text.d.ts.map

package/dist/application/scheduling/duration-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duration-text.d.ts","sourceRoot":"","sources":["../../../src/application/scheduling/duration-text.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,MAAM,MAAM,YAAY,GAAG,GAAG,MAAM,GAAG,IAAI,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,EAAE,CAAC"}

package/dist/application/scheduling/duration-text.js

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

package/dist/application/scheduling/duration-text.js.map

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

package/dist/application/scheduling/execution-context-of-job.d.ts

@@ -0,0 +1,13 @@
+import { type ExecutionContext } from '../execution/execution-context.js';
+export interface JobExecutionStart {
+    readonly correlationId: string;
+    readonly scheduledAt: Date;
+    /** The instant the timeout of the job ends the run, when it has one. */
+    readonly deadline?: Date;
+}
+/**
+ * The execution context of one run: origin `schedule`, the system actor named after the job, a
+ * correlation of its own and the instant the run was due.
+ */
+export declare function executionContextOfJob(job: string, start: JobExecutionStart): ExecutionContext;
+//# sourceMappingURL=execution-context-of-job.d.ts.map

package/dist/application/scheduling/execution-context-of-job.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-context-of-job.d.ts","sourceRoot":"","sources":["../../../src/application/scheduling/execution-context-of-job.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,gBAAgB,EAAoB,MAAM,mCAAmC,CAAC;AAE5F,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC;IAC3B,wEAAwE;IACxE,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,GAAG,gBAAgB,CAE7F"}

package/dist/application/scheduling/execution-context-of-job.js

@@ -0,0 +1,10 @@
+import { systemActor } from '../actor/system-actor.js';
+import { executionContext } from '../execution/execution-context.js';
+/**
+ * The execution context of one run: origin `schedule`, the system actor named after the job, a
+ * correlation of its own and the instant the run was due.
+ */
+export function executionContextOfJob(job, start) {
+    return executionContext({ ...start, actor: systemActor(job), origin: 'schedule' });
+}
+//# sourceMappingURL=execution-context-of-job.js.map

package/dist/application/scheduling/execution-context-of-job.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-context-of-job.js","sourceRoot":"","sources":["../../../src/application/scheduling/execution-context-of-job.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAyB,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAS5F;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,GAAW,EAAE,KAAwB;IACzE,OAAO,gBAAgB,CAAC,EAAE,GAAG,KAAK,EAAE,KAAK,EAAE,WAAW,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;AACrF,CAAC"}

package/dist/application/scheduling/invalid-job-schedule-error.d.ts

@@ -0,0 +1,6 @@
+/** A schedule that cannot be read or would never fire. Raised where the schedule is written. */
+export declare class InvalidJobScheduleError extends Error {
+    readonly code = "INVALID_JOB_SCHEDULE";
+    constructor(message: string);
+}
+//# sourceMappingURL=invalid-job-schedule-error.d.ts.map

package/dist/application/scheduling/invalid-job-schedule-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invalid-job-schedule-error.d.ts","sourceRoot":"","sources":["../../../src/application/scheduling/invalid-job-schedule-error.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,QAAQ,CAAC,IAAI,0BAA0B;IAEvC,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF"}

package/dist/application/scheduling/invalid-job-schedule-error.js

@@ -0,0 +1,9 @@
+/** A schedule that cannot be read or would never fire. Raised where the schedule is written. */
+export class InvalidJobScheduleError extends Error {
+    code = 'INVALID_JOB_SCHEDULE';
+    constructor(message) {
+        super(message);
+        this.name = 'InvalidJobScheduleError';
+    }
+}
+//# sourceMappingURL=invalid-job-schedule-error.js.map

package/dist/application/scheduling/invalid-job-schedule-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invalid-job-schedule-error.js","sourceRoot":"","sources":["../../../src/application/scheduling/invalid-job-schedule-error.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IACvC,IAAI,GAAG,sBAAsB,CAAC;IAEvC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF"}

package/dist/application/scheduling/is-job-name.d.ts

@@ -0,0 +1,3 @@
+/** A job name is `<context>.<job-name>`, in lower case, words separated by dashes. */
+export declare function isJobName(name: string): boolean;
+//# sourceMappingURL=is-job-name.d.ts.map

package/dist/application/scheduling/is-job-name.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-job-name.d.ts","sourceRoot":"","sources":["../../../src/application/scheduling/is-job-name.ts"],"names":[],"mappings":"AAEA,sFAAsF;AACtF,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE/C"}

package/dist/application/scheduling/is-job-name.js

@@ -0,0 +1,6 @@
+const JOB_NAME = /^[a-z][a-z0-9]*(?:-[a-z0-9]+)*(?:\.[a-z][a-z0-9]*(?:-[a-z0-9]+)*)+$/;
+/** A job name is `<context>.<job-name>`, in lower case, words separated by dashes. */
+export function isJobName(name) {
+    return JOB_NAME.test(name);
+}
+//# sourceMappingURL=is-job-name.js.map

package/dist/application/scheduling/is-job-name.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-job-name.js","sourceRoot":"","sources":["../../../src/application/scheduling/is-job-name.ts"],"names":[],"mappings":"AAAA,MAAM,QAAQ,GAAG,qEAAqE,CAAC;AAEvF,sFAAsF;AACtF,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC"}

package/dist/application/scheduling/job-definition.d.ts

@@ -0,0 +1,11 @@
+import type { JobExecution } from './job-execution.js';
+import type { JobOptions } from './job-options.js';
+import type { JobSchedule } from './job-schedule.js';
+/** A job as a scheduler receives it. */
+export interface JobDefinition extends JobOptions {
+    /** `<context>.<job-name>`, unique in the application. */
+    readonly name: string;
+    readonly schedule: JobSchedule;
+    readonly run: (execution: JobExecution) => Promise<void>;
+}
+//# sourceMappingURL=job-definition.d.ts.map

package/dist/application/scheduling/job-definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-definition.d.ts","sourceRoot":"","sources":["../../../src/application/scheduling/job-definition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,wCAAwC;AACxC,MAAM,WAAW,aAAc,SAAQ,UAAU;IAC/C,yDAAyD;IACzD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,GAAG,EAAE,CAAC,SAAS,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1D"}

package/dist/application/scheduling/job-definition.js

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

package/dist/application/scheduling/job-definition.js.map

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

package/dist/application/scheduling/job-description.d.ts

@@ -0,0 +1,13 @@
+import type { JobRun } from './job-run.js';
+export interface JobDescription {
+    readonly name: string;
+    /** `every 15m`, `cron 0 7 * * 1-5 (Europe/Paris)`. */
+    readonly schedule: string;
+    readonly enabled: boolean;
+    readonly running: boolean;
+    /** Absent for a disabled job and for a scheduler that is not started. */
+    readonly nextRunAt?: Date;
+    /** The last occurrence this instance handled, whatever became of it. */
+    readonly lastRun?: JobRun;
+}
+//# sourceMappingURL=job-description.d.ts.map

package/dist/application/scheduling/job-description.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-description.d.ts","sourceRoot":"","sources":["../../../src/application/scheduling/job-description.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,sDAAsD;IACtD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,yEAAyE;IACzE,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC;IAC1B,wEAAwE;IACxE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B"}

package/dist/application/scheduling/job-description.js

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

package/dist/application/scheduling/job-description.js.map

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

package/dist/application/scheduling/job-execution.d.ts

@@ -0,0 +1,12 @@
+/** What a run is told about itself. */
+export interface JobExecution {
+    /** The instant the run was due. For `runNow`, the instant it was asked. */
+    readonly scheduledAt: Date;
+    /** The instant the run really started: later than `scheduledAt` by the jitter, a queue or a catch-up. */
+    readonly startedAt: Date;
+    /** 1 for a scheduler that never retries, as the in-process one; a scheduler that redelivers counts. */
+    readonly attempt: number;
+    /** Aborted when the run exceeds its timeout or the scheduler stops: a long job checks it. */
+    readonly signal: AbortSignal;
+}
+//# sourceMappingURL=job-execution.d.ts.map

package/dist/application/scheduling/job-execution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-execution.d.ts","sourceRoot":"","sources":["../../../src/application/scheduling/job-execution.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,MAAM,WAAW,YAAY;IAC3B,2EAA2E;IAC3E,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC;IAC3B,yGAAyG;IACzG,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IACzB,uGAAuG;IACvG,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,6FAA6F;IAC7F,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;CAC9B"}

package/dist/application/scheduling/job-execution.js

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

package/dist/application/scheduling/job-execution.js.map

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

package/dist/application/scheduling/job-options.d.ts

@@ -0,0 +1,25 @@
+export interface JobOptions {
+    /**
+     * An occurrence that comes while the previous run is still in progress: `skip` (default) does
+     * not start it, `queue` starts it when the run ends, one occurrence waiting at most.
+     */
+    readonly overlap?: 'skip' | 'queue';
+    /**
+     * Occurrences that passed without the scheduler reaching them in time (the process was down,
+     * asleep or blocked): `skip` (default) waits for the next one, `run-once` runs the latest of
+     * them, once, however many passed.
+     */
+    readonly missed?: 'skip' | 'run-once';
+    /** Aborts a run that lasts longer, through its signal. Default: no limit. */
+    readonly timeoutMs?: number;
+    /** A random delay up to this many milliseconds before each run, so jobs do not all start on the minute. Default 0. */
+    readonly jitterMs?: number;
+    /** `false` never starts the job by time. Default `true`. Meant to be overridden from configuration. */
+    readonly enabled?: boolean;
+    /**
+     * `true` (default): the scheduler takes the `Lock` of the occurrence, so that one instance of
+     * an application running several runs it. Best effort: see the scheduler.
+     */
+    readonly singleInstance?: boolean;
+}
+//# sourceMappingURL=job-options.d.ts.map

package/dist/application/scheduling/job-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-options.d.ts","sourceRoot":"","sources":["../../../src/application/scheduling/job-options.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACpC;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;IACtC,6EAA6E;IAC7E,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,sHAAsH;IACtH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,uGAAuG;IACvG,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B;;;OAGG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;CACnC"}

package/dist/application/scheduling/job-options.js

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

package/dist/application/scheduling/job-options.js.map

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

package/dist/application/scheduling/job-outcome.d.ts

@@ -0,0 +1,8 @@
+/**
+ * - `succeeded`, `failed`: the job ran.
+ * - `skipped-overlap`: the previous run was still in progress.
+ * - `skipped-locked`: another instance holds the occurrence.
+ * - `missed`: the occurrence passed and was not run.
+ */
+export type JobOutcome = 'succeeded' | 'failed' | 'skipped-overlap' | 'skipped-locked' | 'missed';
+//# sourceMappingURL=job-outcome.d.ts.map

package/dist/application/scheduling/job-outcome.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-outcome.d.ts","sourceRoot":"","sources":["../../../src/application/scheduling/job-outcome.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG,WAAW,GAAG,QAAQ,GAAG,iBAAiB,GAAG,gBAAgB,GAAG,QAAQ,CAAC"}

package/dist/application/scheduling/job-outcome.js

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

package/dist/application/scheduling/job-outcome.js.map

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

package/dist/application/scheduling/job-policy.d.ts

@@ -0,0 +1,6 @@
+import type { JobOptions } from './job-options.js';
+/** The options with their defaults filled in. */
+export type JobPolicy = Required<Omit<JobOptions, 'timeoutMs'>> & Pick<JobOptions, 'timeoutMs'>;
+/** Validates the options and fills in the defaults. Throws `InvalidJobScheduleError`. */
+export declare function jobPolicy(options: JobOptions): JobPolicy;
+//# sourceMappingURL=job-policy.d.ts.map

package/dist/application/scheduling/job-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-policy.d.ts","sourceRoot":"","sources":["../../../src/application/scheduling/job-policy.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAGnD,iDAAiD;AACjD,MAAM,MAAM,SAAS,GAAG,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC,GAAG,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;AAEhG,yFAAyF;AACzF,wBAAgB,SAAS,CAAC,OAAO,EAAE,UAAU,GAAG,SAAS,CAiBxD"}

package/dist/application/scheduling/job-policy.js

@@ -0,0 +1,22 @@
+import { InvalidJobScheduleError } from './invalid-job-schedule-error.js';
+import { parseDuration } from './parse-duration.js';
+/** Validates the options and fills in the defaults. Throws `InvalidJobScheduleError`. */
+export function jobPolicy(options) {
+    const { overlap = 'skip', missed = 'skip', timeoutMs, jitterMs = 0, enabled = true, singleInstance = true } = options;
+    assertOneOf('overlap', overlap, ['skip', 'queue']);
+    assertOneOf('missed', missed, ['skip', 'run-once']);
+    if (!Number.isSafeInteger(jitterMs) || jitterMs < 0) {
+        throw new InvalidJobScheduleError(`jitterMs is ${jitterMs}: a whole number of milliseconds, zero or more, is expected.`);
+    }
+    if (timeoutMs === undefined) {
+        return { overlap, missed, jitterMs, enabled, singleInstance };
+    }
+    return { overlap, missed, jitterMs, enabled, singleInstance, timeoutMs: parseDuration(timeoutMs) };
+}
+function assertOneOf(option, value, allowed) {
+    if (allowed.includes(value)) {
+        return;
+    }
+    throw new InvalidJobScheduleError(`${option} is "${value}": one of ${allowed.join(', ')} is expected.`);
+}
+//# sourceMappingURL=job-policy.js.map

package/dist/application/scheduling/job-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-policy.js","sourceRoot":"","sources":["../../../src/application/scheduling/job-policy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAE1E,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAKpD,yFAAyF;AACzF,MAAM,UAAU,SAAS,CAAC,OAAmB;IAC3C,MAAM,EAAE,OAAO,GAAG,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,SAAS,EAAE,QAAQ,GAAG,CAAC,EAAE,OAAO,GAAG,IAAI,EAAE,cAAc,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;IAEtH,WAAW,CAAC,SAAS,EAAE,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACnD,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;IAEpD,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;QACpD,MAAM,IAAI,uBAAuB,CAC/B,eAAe,QAAQ,8DAA8D,CACtF,CAAC;IACJ,CAAC;IAED,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC;IAChE,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,aAAa,CAAC,SAAS,CAAC,EAAE,CAAC;AACrG,CAAC;AAED,SAAS,WAAW,CAAC,MAAc,EAAE,KAAa,EAAE,OAA0B;IAC5E,IAAI,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO;IACT,CAAC;IAED,MAAM,IAAI,uBAAuB,CAAC,GAAG,MAAM,QAAQ,KAAK,aAAa,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;AAC1G,CAAC"}

package/dist/application/scheduling/job-run.d.ts

@@ -0,0 +1,13 @@
+import type { JobOutcome } from './job-outcome.js';
+/** One occurrence and what became of it, as data. Never the message of an error: it quotes data. */
+export interface JobRun {
+    readonly job: string;
+    readonly outcome: JobOutcome;
+    readonly scheduledAt: Date;
+    /** Present when the job ran. */
+    readonly startedAt?: Date;
+    readonly durationMs?: number;
+    /** The `code` of what the job threw, or `UNEXPECTED_ERROR`. */
+    readonly errorCode?: string;
+}
+//# sourceMappingURL=job-run.d.ts.map

package/dist/application/scheduling/job-run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-run.d.ts","sourceRoot":"","sources":["../../../src/application/scheduling/job-run.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,oGAAoG;AACpG,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC;IAC3B,gCAAgC;IAChC,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC;IAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,+DAA+D;IAC/D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B"}

package/dist/application/scheduling/job-run.js

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

package/dist/application/scheduling/job-run.js.map

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

package/dist/application/scheduling/job-schedule-of.d.ts

@@ -0,0 +1,11 @@
+import type { DurationText } from './duration-text.js';
+import type { JobSchedule } from './job-schedule.js';
+/** The keys of a schedule as they are written next to other options, before they are known to be one schedule. */
+export interface WrittenSchedule {
+    readonly every?: number | DurationText;
+    readonly cron?: string;
+    readonly timeZone?: string;
+}
+/** The schedule among the written keys, validated: an interval or a cron, never both, never neither. */
+export declare function jobScheduleOf({ every, cron, timeZone }: WrittenSchedule): JobSchedule;
+//# sourceMappingURL=job-schedule-of.d.ts.map

package/dist/application/scheduling/job-schedule-of.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-schedule-of.d.ts","sourceRoot":"","sources":["../../../src/application/scheduling/job-schedule-of.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,kHAAkH;AAClH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,YAAY,CAAC;IACvC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,wGAAwG;AACxG,wBAAgB,aAAa,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,eAAe,GAAG,WAAW,CAmBrF"}

package/dist/application/scheduling/job-schedule-of.js

@@ -0,0 +1,18 @@
+import { InvalidJobScheduleError } from './invalid-job-schedule-error.js';
+import { parseJobSchedule } from './parse-job-schedule.js';
+/** The schedule among the written keys, validated: an interval or a cron, never both, never neither. */
+export function jobScheduleOf({ every, cron, timeZone }) {
+    const schedule = cron === undefined
+        ? every === undefined
+            ? undefined
+            : { every }
+        : { cron, ...(timeZone === undefined ? {} : { timeZone }) };
+    if (schedule === undefined ||
+        (cron !== undefined && every !== undefined) ||
+        (cron === undefined && timeZone !== undefined)) {
+        throw new InvalidJobScheduleError('A schedule is either { every } or { cron, timeZone? }.');
+    }
+    parseJobSchedule(schedule);
+    return schedule;
+}
+//# sourceMappingURL=job-schedule-of.js.map

package/dist/application/scheduling/job-schedule-of.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-schedule-of.js","sourceRoot":"","sources":["../../../src/application/scheduling/job-schedule-of.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAE1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAS3D,wGAAwG;AACxG,MAAM,UAAU,aAAa,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAmB;IACtE,MAAM,QAAQ,GACZ,IAAI,KAAK,SAAS;QAChB,CAAC,CAAC,KAAK,KAAK,SAAS;YACnB,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,EAAE,KAAK,EAAE;QACb,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IAEhE,IACE,QAAQ,KAAK,SAAS;QACtB,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,KAAK,SAAS,CAAC;QAC3C,CAAC,IAAI,KAAK,SAAS,IAAI,QAAQ,KAAK,SAAS,CAAC,EAC9C,CAAC;QACD,MAAM,IAAI,uBAAuB,CAAC,wDAAwD,CAAC,CAAC;IAC9F,CAAC;IAED,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAE3B,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/application/scheduling/job-schedule.d.ts

@@ -0,0 +1,22 @@
+import type { DurationText } from './duration-text.js';
+/**
+ * Every so often, as milliseconds or a duration text. Occurrences are aligned on the Unix epoch
+ * (`'15m'` falls at :00, :15, :30 and :45 UTC), so that every instance of an application names
+ * the same instants and a restart does not shift them.
+ */
+export interface IntervalSchedule {
+    readonly every: number | DurationText;
+    readonly cron?: never;
+    readonly timeZone?: never;
+}
+/**
+ * The five standard fields (minute, hour, day of month, month, day of week), read on the
+ * clocks of an IANA time zone. Default zone: `UTC`.
+ */
+export interface CronSchedule {
+    readonly cron: string;
+    readonly timeZone?: string;
+    readonly every?: never;
+}
+export type JobSchedule = IntervalSchedule | CronSchedule;
+//# sourceMappingURL=job-schedule.d.ts.map

package/dist/application/scheduling/job-schedule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-schedule.d.ts","sourceRoot":"","sources":["../../../src/application/scheduling/job-schedule.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,CAAC;IACtC,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC;CAC3B;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;CACxB;AAED,MAAM,MAAM,WAAW,GAAG,gBAAgB,GAAG,YAAY,CAAC"}

package/dist/application/scheduling/job-schedule.js

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

package/dist/application/scheduling/job-schedule.js.map

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

package/dist/application/scheduling/job-settings.d.ts

@@ -0,0 +1,7 @@
+import type { JobOptions } from './job-options.js';
+import type { JobSchedule } from './job-schedule.js';
+/** What a configuration may change of a declared job, without a code change. */
+export interface JobSettings extends JobOptions {
+    readonly schedule?: JobSchedule;
+}
+//# sourceMappingURL=job-settings.d.ts.map

package/dist/application/scheduling/job-settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-settings.d.ts","sourceRoot":"","sources":["../../../src/application/scheduling/job-settings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,gFAAgF;AAChF,MAAM,WAAW,WAAY,SAAQ,UAAU;IAC7C,QAAQ,CAAC,QAAQ,CAAC,EAAE,WAAW,CAAC;CACjC"}

package/dist/application/scheduling/job-settings.js

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

package/dist/application/scheduling/job-settings.js.map

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

package/dist/application/scheduling/parse-cron.d.ts

@@ -0,0 +1,3 @@
+import type { ParsedCron } from './parsed-job-schedule.js';
+export declare function parseCron(expression: string, timeZone: string): ParsedCron;
+//# sourceMappingURL=parse-cron.d.ts.map

package/dist/application/scheduling/parse-cron.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-cron.d.ts","sourceRoot":"","sources":["../../../src/application/scheduling/parse-cron.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAuB3D,wBAAgB,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU,CAgC1E"}

package/dist/application/scheduling/parse-cron.js

@@ -0,0 +1,102 @@
+import { InvalidJobScheduleError } from './invalid-job-schedule-error.js';
+const MONTH_NAMES = ['jan', 'feb', 'mar', 'apr', 'may', 'jun', 'jul', 'aug', 'sep', 'oct', 'nov', 'dec'];
+const DAY_NAMES = ['sun', 'mon', 'tue', 'wed', 'thu', 'fri', 'sat'];
+const MINUTE = { label: 'minute', min: 0, max: 59, names: [] };
+const HOUR = { label: 'hour', min: 0, max: 23, names: [] };
+const DAY_OF_MONTH = { label: 'day of month', min: 1, max: 31, names: [] };
+const MONTH = { label: 'month', min: 1, max: 12, names: MONTH_NAMES };
+const DAY_OF_WEEK = { label: 'day of week', min: 0, max: 7, names: DAY_NAMES };
+export function parseCron(expression, timeZone) {
+    const fields = expression.trim().split(/\s+/);
+    const [minute, hour, dayOfMonth, month, dayOfWeek] = fields;
+    if (fields.length !== 5 ||
+        minute === undefined ||
+        hour === undefined ||
+        dayOfMonth === undefined ||
+        month === undefined ||
+        dayOfWeek === undefined) {
+        throw new InvalidJobScheduleError(`Cron "${expression}" has ${fields.length} field(s): five are expected (minute, hour, day of month, month, day of week).`);
+    }
+    assertTimeZone(timeZone);
+    return firing({
+        kind: 'cron',
+        expression: fields.join(' '),
+        timeZone,
+        minutes: valuesOf(minute, MINUTE),
+        hours: valuesOf(hour, HOUR),
+        daysOfMonth: valuesOf(dayOfMonth, DAY_OF_MONTH),
+        months: valuesOf(month, MONTH),
+        daysOfWeek: unique(valuesOf(dayOfWeek, DAY_OF_WEEK).map((day) => day % 7)),
+        dayOfMonthRestricted: !dayOfMonth.startsWith('*'),
+        dayOfWeekRestricted: !dayOfWeek.startsWith('*'),
+        everyHour: hour.startsWith('*'),
+    });
+}
+function assertTimeZone(timeZone) {
+    try {
+        new Intl.DateTimeFormat('en-US', { timeZone });
+    }
+    catch {
+        throw new InvalidJobScheduleError(`"${timeZone}" is not a time zone this runtime knows: write an IANA name such as 'Europe/Paris'.`);
+    }
+}
+const LONGEST_MONTH = [31, 29, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31];
+/** Refuses the expression no date satisfies, such as the 31st of February. */
+function firing(cron) {
+    if (!cron.dayOfMonthRestricted || cron.dayOfWeekRestricted) {
+        return cron;
+    }
+    const earliestDay = cron.daysOfMonth[0] ?? 1;
+    if (cron.months.some((month) => earliestDay <= (LONGEST_MONTH[month - 1] ?? 0))) {
+        return cron;
+    }
+    throw new InvalidJobScheduleError(`Cron "${cron.expression}" never fires: none of its months has such a day.`);
+}
+function valuesOf(text, field) {
+    return unique(text.split(',').flatMap((part) => partValues(part, field)));
+}
+function unique(values) {
+    return [...new Set(values)].sort((left, right) => left - right);
+}
+const EVERY_VALUE = /^\*(?:\/(\d+))?$/;
+const VALUE_OR_RANGE = /^([a-z0-9]+)(?:-([a-z0-9]+)(?:\/(\d+))?)?$/;
+/** One element of a list: `*`, a value or a range, `*` and a range taking a step. */
+function partValues(part, field) {
+    const text = part.toLowerCase();
+    const values = everyValue(text, field) ?? valueOrRange(text, field);
+    if (values === undefined) {
+        throw unreadable(part, field);
+    }
+    return values;
+}
+function everyValue(text, field) {
+    const every = EVERY_VALUE.exec(text);
+    return every === null ? undefined : stepping(field.min, field.max, every[1]);
+}
+function valueOrRange(text, field) {
+    const [, start, end, step] = VALUE_OR_RANGE.exec(text) ?? [];
+    if (start === undefined) {
+        return undefined;
+    }
+    return stepping(valueOf(start, field), valueOf(end ?? start, field), step);
+}
+function stepping(from, to, step) {
+    const stride = Number(step ?? 1);
+    if (from > to || stride < 1) {
+        return undefined;
+    }
+    return Array.from({ length: Math.floor((to - from) / stride) + 1 }, (_, index) => from + index * stride);
+}
+function valueOf(text, field) {
+    const named = field.names.indexOf(text);
+    const value = named === -1 ? Number(/^\d+$/.test(text) ? text : Number.NaN) : named + (field.label === 'month' ? 1 : 0);
+    if (Number.isNaN(value) || value < field.min || value > field.max) {
+        throw unreadable(text, field);
+    }
+    return value;
+}
+function unreadable(text, field) {
+    const names = field.names.length === 0 ? '' : ` or a name (${field.names.join(', ')})`;
+    return new InvalidJobScheduleError(`"${text}" is not a ${field.label} of a cron expression: write *, a value from ${field.min} to ${field.max}${names}, a range a-b, a step */n or a-b/n, or a list of those.`);
+}
+//# sourceMappingURL=parse-cron.js.map

package/dist/application/scheduling/parse-cron.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-cron.js","sourceRoot":"","sources":["../../../src/application/scheduling/parse-cron.ts"],"names":[],"mappings":"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"}

package/dist/application/scheduling/parse-duration.d.ts

@@ -0,0 +1,3 @@
+/** Milliseconds of a duration, refusing zero, a fraction and an unknown unit. */
+export declare function parseDuration(duration: number | string): number;
+//# sourceMappingURL=parse-duration.d.ts.map

package/dist/application/scheduling/parse-duration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-duration.d.ts","sourceRoot":"","sources":["../../../src/application/scheduling/parse-duration.ts"],"names":[],"mappings":"AAMA,iFAAiF;AACjF,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAU/D"}

package/dist/application/scheduling/parse-duration.js

@@ -0,0 +1,16 @@
+import { InvalidJobScheduleError } from './invalid-job-schedule-error.js';
+const UNIT_MS = { ms: 1, s: 1_000, m: 60_000, h: 3_600_000, d: 86_400_000 };
+const DURATION = /^(\d+)(ms|s|m|h|d)$/;
+/** Milliseconds of a duration, refusing zero, a fraction and an unknown unit. */
+export function parseDuration(duration) {
+    const ms = typeof duration === 'number' ? duration : durationTextMs(duration);
+    if (!Number.isSafeInteger(ms) || ms <= 0) {
+        throw new InvalidJobScheduleError(`"${duration}" is not a duration: write a positive whole number of milliseconds, or a text such as '30s', '15m', '2h', '1d'.`);
+    }
+    return ms;
+}
+function durationTextMs(text) {
+    const [, amount, unit] = DURATION.exec(text.trim()) ?? [];
+    return Number(amount ?? Number.NaN) * (UNIT_MS[unit ?? ''] ?? Number.NaN);
+}
+//# sourceMappingURL=parse-duration.js.map

package/dist/application/scheduling/parse-duration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-duration.js","sourceRoot":"","sources":["../../../src/application/scheduling/parse-duration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAE1E,MAAM,OAAO,GAAqC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC;AAE9G,MAAM,QAAQ,GAAG,qBAAqB,CAAC;AAEvC,iFAAiF;AACjF,MAAM,UAAU,aAAa,CAAC,QAAyB;IACrD,MAAM,EAAE,GAAG,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;IAE9E,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,uBAAuB,CAC/B,IAAI,QAAQ,iHAAiH,CAC9H,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,cAAc,CAAC,IAAY;IAClC,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;IAE1D,OAAO,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC;AAC5E,CAAC"}

package/dist/application/scheduling/parse-job-schedule.d.ts

@@ -0,0 +1,5 @@
+import type { JobSchedule } from './job-schedule.js';
+import type { ParsedJobSchedule } from './parsed-job-schedule.js';
+/** Validates a schedule and answers it in the form occurrences are computed from. */
+export declare function parseJobSchedule(schedule: JobSchedule): ParsedJobSchedule;
+//# sourceMappingURL=parse-job-schedule.d.ts.map

package/dist/application/scheduling/parse-job-schedule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-job-schedule.d.ts","sourceRoot":"","sources":["../../../src/application/scheduling/parse-job-schedule.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAElE,qFAAqF;AACrF,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,WAAW,GAAG,iBAAiB,CAMzE"}