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

package/dist/in-process-job-scheduler.js

@@ -0,0 +1,189 @@
+import { DuplicateJobError, NoopLogger, NoopMetrics, UnknownJobError, } from '@ddd-ts-kit/kernel';
+import { JobAbortedError } from './errors/job-aborted-error.js';
+import { JobRecorder } from './job-recorder.js';
+import { JobRunner } from './job-runner.js';
+import { latestOccurrence } from './occurrences/latest-occurrence.js';
+import { nextOccurrence } from './occurrences/next-occurrence.js';
+import { RegisteredJob } from './registered-job.js';
+import { systemJobTimers } from './system-job-timers.js';
+/*
+ * A sleep never lasts longer: the wall clock and the timers of the runtime drift apart, and a
+ * timer of the runtime cannot wait more than 24 days. A timer that fires early finds nothing
+ * due and sleeps again.
+ */
+const LONGEST_SLEEP_MS = 3_600_000;
+/**
+ * The scheduler inside one process. Instants come from the `Clock`, sleeps go through the
+ * timers, and nothing is remembered across a restart unless `checkpoints` is given. Several
+ * instances of an application each run one: the `Lock` decides which of them runs an occurrence.
+ */
+export class InProcessJobScheduler {
+    jobs = new Map();
+    ticks = new Set();
+    runsInProgress = new Set();
+    settings;
+    recorder;
+    runner;
+    started = false;
+    stopping = false;
+    constructor(options) {
+        const { clock, logger = new NoopLogger(), metrics = new NoopMetrics(), timers = systemJobTimers } = options;
+        const { lateAfterMs = 60_000, graceMs = 30_000, lockTtlMs = 900_000, random = Math.random, checkpoints, onRun, } = options;
+        const { lock, scope, ids } = options;
+        this.settings = {
+            clock,
+            logger,
+            metrics,
+            timers,
+            lateAfterMs,
+            graceMs,
+            lockTtlMs,
+            random,
+            ...(checkpoints === undefined ? {} : { checkpoints }),
+        };
+        this.recorder = new JobRecorder({ clock, logger, metrics, ...(onRun === undefined ? {} : { onRun }) });
+        this.runner = new JobRunner({ clock, lock, scope, ids, timers, lockTtlMs, lateAfterMs }, this.recorder);
+    }
+    register(definition) {
+        if (this.jobs.has(definition.name)) {
+            throw new DuplicateJobError(definition.name);
+        }
+        const job = new RegisteredJob(definition);
+        this.jobs.set(job.name, job);
+        if (this.started) {
+            void this.follow(job, this.begin(job));
+        }
+    }
+    async start() {
+        if (this.started) {
+            return;
+        }
+        this.started = true;
+        await Promise.all([...this.jobs.values()].map((job) => this.follow(job, this.begin(job))));
+    }
+    async stop() {
+        this.started = false;
+        this.stopping = true;
+        for (const job of this.jobs.values()) {
+            job.cancelSleep?.();
+        }
+        await Promise.all(this.ticks);
+        const cancelAbort = this.settings.timers.schedule(this.settings.graceMs, () => {
+            for (const job of this.jobs.values()) {
+                job.abort?.(new JobAbortedError(job.name));
+            }
+        });
+        await Promise.all(this.runsInProgress);
+        cancelAbort();
+        this.stopping = false;
+    }
+    async runNow(name) {
+        const job = this.jobs.get(name);
+        if (job === undefined) {
+            throw new UnknownJobError(name);
+        }
+        return this.trigger(job, { scheduledAt: this.settings.clock.now(), manual: true });
+    }
+    describe() {
+        return [...this.jobs.values()].map((job) => ({
+            name: job.name,
+            schedule: job.scheduleText,
+            enabled: job.policy.enabled,
+            running: job.active !== undefined,
+            ...(this.started && job.cursor !== undefined ? { nextRunAt: nextOccurrence(job.schedule, job.cursor) } : {}),
+            ...(job.lastRun === undefined ? {} : { lastRun: job.lastRun }),
+        }));
+    }
+    /** A tick never rejects: what goes wrong while following a job is logged, and the others go on. */
+    follow(job, tick) {
+        const followed = tick.catch((error) => {
+            this.recorder.fault(job, error);
+        });
+        this.ticks.add(followed);
+        return followed.finally(() => this.ticks.delete(followed));
+    }
+    async begin(job) {
+        if (!job.policy.enabled) {
+            return;
+        }
+        job.cursor = (await this.remembered(job)) ?? this.settings.clock.now();
+        await this.tick(job);
+    }
+    /** A checkpoint that cannot be read is no reason to leave the job asleep: it starts from now. */
+    async remembered(job) {
+        try {
+            return await this.settings.checkpoints?.read(job.name);
+        }
+        catch (error) {
+            this.recorder.fault(job, error);
+            return undefined;
+        }
+    }
+    async tick(job) {
+        try {
+            await this.handleDue(job);
+        }
+        finally {
+            this.sleep(job);
+        }
+    }
+    /** Of the occurrences that became due, the latest is run when it is on time or owed; the others are missed. */
+    async handleDue(job) {
+        const now = this.settings.clock.now();
+        const after = job.cursor ?? now;
+        const due = latestOccurrence(job.schedule, { after, notAfter: now });
+        if (due === undefined) {
+            return;
+        }
+        job.cursor = due;
+        const earliest = nextOccurrence(job.schedule, after);
+        const late = now.getTime() - due.getTime() > this.settings.lateAfterMs + job.policy.jitterMs;
+        const runs = !late || job.policy.missed === 'run-once';
+        if (!runs || earliest.getTime() < due.getTime()) {
+            this.recorder.notRun(job, { scheduledAt: earliest, manual: false }, 'missed');
+        }
+        if (runs) {
+            void this.trigger(job, { scheduledAt: due, manual: false });
+        }
+        await this.settings.checkpoints?.write(job.name, due);
+    }
+    sleep(job) {
+        if (!this.started || job.cursor === undefined) {
+            return;
+        }
+        const { clock, timers, random } = this.settings;
+        const untilNext = nextOccurrence(job.schedule, job.cursor).getTime() - clock.now().getTime();
+        const jitter = Math.floor(random() * (job.policy.jitterMs + 1));
+        job.cancelSleep = timers.schedule(Math.min(Math.max(0, untilNext), LONGEST_SLEEP_MS) + jitter, () => {
+            void this.follow(job, this.tick(job));
+        });
+    }
+    trigger(job, occurrence) {
+        const previous = job.active;
+        if (previous === undefined) {
+            return this.occupy(job, this.runner.run(job, occurrence));
+        }
+        if (job.policy.overlap === 'skip' || job.waiting) {
+            return Promise.resolve(this.recorder.notRun(job, occurrence, 'skipped-overlap'));
+        }
+        job.waiting = true;
+        return this.occupy(job, previous.then(() => this.afterPrevious(job, occurrence)));
+    }
+    occupy(job, run) {
+        const active = run.finally(() => {
+            this.runsInProgress.delete(active);
+            if (job.active === active) {
+                job.active = undefined;
+            }
+        });
+        job.active = active;
+        this.runsInProgress.add(active);
+        return active;
+    }
+    /** A run that waited behind another is dropped when the scheduler is stopping. */
+    afterPrevious(job, occurrence) {
+        job.waiting = false;
+        return this.stopping ? this.recorder.notRun(job, occurrence, 'missed') : this.runner.run(job, occurrence);
+    }
+}
+//# sourceMappingURL=in-process-job-scheduler.js.map

package/dist/in-process-job-scheduler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-process-job-scheduler.js","sourceRoot":"","sources":["../src/in-process-job-scheduler.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+export { InProcessJobScheduler, type InProcessJobSchedulerOptions } from './in-process-job-scheduler.js';
+export { JobCheckpoints } from './job-checkpoints.js';
+export { latestOccurrence, type OccurrenceRange } from './occurrences/latest-occurrence.js';
+export { nextOccurrence } from './occurrences/next-occurrence.js';
+export { JobTimers } from './job-timers.js';
+export { systemJobTimers } from './system-job-timers.js';
+export { JobAbortedError } from './errors/job-aborted-error.js';
+export { JobLockUnavailableError } from './errors/job-lock-unavailable-error.js';
+export { JobTimeoutError } from './errors/job-timeout-error.js';
+export { UNEXPECTED_ERROR } from './errors/error-code-of.js';
+export { DURATION_HISTOGRAM, RUNS_COUNTER } from './metric-names.js';
+export type { JobRunDetail, JobRunObserver } from './job-run-observer.js';
+export { reportFailedRuns } from './report-failed-runs.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,KAAK,4BAA4B,EAAE,MAAM,+BAA+B,CAAC;AACzG,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,KAAK,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC5F,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACrE,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+export { InProcessJobScheduler } from './in-process-job-scheduler.js';
+export { JobCheckpoints } from './job-checkpoints.js';
+export { latestOccurrence } from './occurrences/latest-occurrence.js';
+export { nextOccurrence } from './occurrences/next-occurrence.js';
+export { JobTimers } from './job-timers.js';
+export { systemJobTimers } from './system-job-timers.js';
+export { JobAbortedError } from './errors/job-aborted-error.js';
+export { JobLockUnavailableError } from './errors/job-lock-unavailable-error.js';
+export { JobTimeoutError } from './errors/job-timeout-error.js';
+export { UNEXPECTED_ERROR } from './errors/error-code-of.js';
+export { DURATION_HISTOGRAM, RUNS_COUNTER } from './metric-names.js';
+export { reportFailedRuns } from './report-failed-runs.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAqC,MAAM,+BAA+B,CAAC;AACzG,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAwB,MAAM,oCAAoC,CAAC;AAC5F,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAErE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/job-checkpoints.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Where a scheduler remembers the last occurrence it handled for each job, so that a restart
+ * knows what passed while the process was down. Shared by the instances of an application: a
+ * table, a key of a store.
+ */
+export declare abstract class JobCheckpoints {
+    static readonly tokenKey = "scheduling.JobCheckpoints";
+    abstract read(job: string): Promise<Date | undefined>;
+    abstract write(job: string, handled: Date): Promise<void>;
+}
+//# sourceMappingURL=job-checkpoints.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"job-checkpoints.d.ts","sourceRoot":"","sources":["../src/job-checkpoints.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,8BAAsB,cAAc;IAClC,MAAM,CAAC,QAAQ,CAAC,QAAQ,+BAA+B;IAEvD,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG,SAAS,CAAC,CAAC;IAEtD,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3D"}

package/dist/job-checkpoints.js

@@ -0,0 +1,9 @@
+/**
+ * Where a scheduler remembers the last occurrence it handled for each job, so that a restart
+ * knows what passed while the process was down. Shared by the instances of an application: a
+ * table, a key of a store.
+ */
+export class JobCheckpoints {
+    static tokenKey = 'scheduling.JobCheckpoints';
+}
+//# sourceMappingURL=job-checkpoints.js.map

package/dist/job-checkpoints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-checkpoints.js","sourceRoot":"","sources":["../src/job-checkpoints.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,OAAgB,cAAc;IAClC,MAAM,CAAU,QAAQ,GAAG,2BAA2B,CAAC;CAKxD"}

package/dist/job-recorder.d.ts

@@ -0,0 +1,28 @@
+import type { Clock, JobOutcome, JobRun, Logger, Metrics } from '@ddd-ts-kit/kernel';
+import type { JobRunObserver } from './job-run-observer.js';
+import type { Occurrence } from './occurrence.js';
+import type { RegisteredJob } from './registered-job.js';
+import type { StartedRun } from './started-run.js';
+export interface RecorderOptions {
+    readonly clock: Clock;
+    readonly logger: Logger;
+    readonly metrics: Metrics;
+    readonly onRun?: JobRunObserver;
+}
+/** Says what became of each occurrence, to the log, the metrics and the observer. Never the message of an error. */
+export declare class JobRecorder {
+    private readonly options;
+    constructor(options: RecorderOptions);
+    succeeded(job: RegisteredJob, started: StartedRun): JobRun;
+    failed(job: RegisteredJob, started: StartedRun, error: unknown): JobRun;
+    /** The occurrence could not even be started. */
+    refused(job: RegisteredJob, occurrence: Occurrence, error: unknown): JobRun;
+    notRun(job: RegisteredJob, occurrence: Occurrence, outcome: Exclude<JobOutcome, 'succeeded' | 'failed'>): JobRun;
+    /** The scheduler itself stumbled while following a job: it goes on with the next occurrence. */
+    fault(job: RegisteredJob, error: unknown): void;
+    private ran;
+    private record;
+    private measure;
+    private log;
+}
+//# sourceMappingURL=job-recorder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"job-recorder.d.ts","sourceRoot":"","sources":["../src/job-recorder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAuB,MAAM,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE1G,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,cAAc,CAAC;CACjC;AAOD,oHAAoH;AACpH,qBAAa,WAAW;IACV,OAAO,CAAC,QAAQ,CAAC,OAAO;IAApC,YAA6B,OAAO,EAAE,eAAe,EAAI;IAEzD,SAAS,CAAC,GAAG,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,GAAG,MAAM,CAEzD;IAED,MAAM,CAAC,GAAG,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAItE;IAED,gDAAgD;IAChD,OAAO,CAAC,GAAG,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAS1E;IAED,MAAM,CAAC,GAAG,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,UAAU,EAAE,WAAW,GAAG,QAAQ,CAAC,GAAG,MAAM,CAE/G;IAED,gGAAgG;IAChG,KAAK,CAAC,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAW9C;IAED,OAAO,CAAC,GAAG;IAOX,OAAO,CAAC,MAAM;IAoBd,OAAO,CAAC,OAAO;IAUf,OAAO,CAAC,GAAG;CAoBZ"}

package/dist/job-recorder.js

@@ -0,0 +1,114 @@
+import { errorCodeOf } from './errors/error-code-of.js';
+import { DURATION_HISTOGRAM, RUNS_COUNTER } from './metric-names.js';
+/** Says what became of each occurrence, to the log, the metrics and the observer. Never the message of an error. */
+export class JobRecorder {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    succeeded(job, started) {
+        return this.record(job, this.ran(job, started, 'succeeded'), { correlationId: started.correlationId });
+    }
+    failed(job, started, error) {
+        const run = { ...this.ran(job, started, 'failed'), errorCode: errorCodeOf(error) };
+        return this.record(job, run, { correlationId: started.correlationId, failure: { error } });
+    }
+    /** The occurrence could not even be started. */
+    refused(job, occurrence, error) {
+        const run = {
+            job: job.name,
+            outcome: 'failed',
+            scheduledAt: occurrence.scheduledAt,
+            errorCode: errorCodeOf(error),
+        };
+        return this.record(job, run, { failure: { error } });
+    }
+    notRun(job, occurrence, outcome) {
+        return this.record(job, { job: job.name, outcome, scheduledAt: occurrence.scheduledAt }, {});
+    }
+    /** The scheduler itself stumbled while following a job: it goes on with the next occurrence. */
+    fault(job, error) {
+        const fields = {
+            job: job.name,
+            context: contextOf(job.name),
+            errorType: typeOf(error),
+            errorCode: errorCodeOf(error),
+        };
+        quietly(() => {
+            this.options.logger.error('Scheduled job could not be followed', fields);
+        });
+    }
+    ran(job, started, outcome) {
+        const { occurrence, startedAt } = started;
+        const durationMs = this.options.clock.now().getTime() - startedAt.getTime();
+        return { job: job.name, outcome, scheduledAt: occurrence.scheduledAt, startedAt, durationMs };
+    }
+    record(job, run, detail) {
+        const { correlationId } = detail;
+        job.lastRun = run;
+        quietly(() => {
+            this.measure(run);
+        });
+        quietly(() => {
+            this.log(run, detail);
+        });
+        quietly(() => {
+            this.options.onRun?.(run, detail.failure?.error, correlationId === undefined ? {} : { correlationId });
+        });
+        return run;
+    }
+    measure(run) {
+        const labels = { job: run.job, context: contextOf(run.job), status: run.outcome, error_code: run.errorCode };
+        this.options.metrics.counter(RUNS_COUNTER).increment(labels);
+        if (run.durationMs !== undefined) {
+            this.options.metrics.histogram(DURATION_HISTOGRAM).record(run.durationMs, labels);
+        }
+    }
+    log(run, { correlationId, failure }) {
+        const level = LEVELS[run.outcome];
+        if (!this.options.logger.isLevelEnabled(level)) {
+            return;
+        }
+        const fields = {
+            job: run.job,
+            context: contextOf(run.job),
+            outcome: run.outcome,
+            scheduledAt: run.scheduledAt,
+            ...(run.durationMs === undefined ? {} : { durationMs: run.durationMs }),
+            ...(correlationId === undefined ? {} : { correlationId }),
+            ...(run.errorCode === undefined ? {} : { errorCode: run.errorCode }),
+            ...(failure === undefined ? {} : { errorType: typeOf(failure.error) }),
+        };
+        this.options.logger[level](`Scheduled job ${WORDS[run.outcome]}`, fields);
+    }
+}
+function contextOf(job) {
+    return job.split('.', 1).join('');
+}
+function typeOf(error) {
+    return error instanceof Error ? error.constructor.name : typeof error;
+}
+/** What records a run must not break it: a logger, a meter or an observer that throws is left alone. */
+function quietly(tell) {
+    try {
+        tell();
+    }
+    catch {
+        return;
+    }
+}
+const LEVELS = {
+    succeeded: 'info',
+    failed: 'error',
+    'skipped-overlap': 'warn',
+    'skipped-locked': 'debug',
+    missed: 'warn',
+};
+const WORDS = {
+    succeeded: 'succeeded',
+    failed: 'failed',
+    'skipped-overlap': 'skipped: the previous run is still in progress',
+    'skipped-locked': 'skipped: another instance runs this occurrence',
+    missed: 'missed',
+};
+//# sourceMappingURL=job-recorder.js.map

package/dist/job-recorder.js.map

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

package/dist/job-run-observer.d.ts

@@ -0,0 +1,9 @@
+import type { JobRun } from '@ddd-ts-kit/kernel';
+/** What the run carried that its `JobRun` does not say. */
+export interface JobRunDetail {
+    /** The correlation id of the execution context the job ran in. Absent when it never started. */
+    readonly correlationId?: string;
+}
+/** Told of every occurrence handled, with what the job threw when it failed: for an error tracker, or a test. */
+export type JobRunObserver = (run: JobRun, error?: unknown, detail?: JobRunDetail) => void;
+//# sourceMappingURL=job-run-observer.d.ts.map

package/dist/job-run-observer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-run-observer.d.ts","sourceRoot":"","sources":["../src/job-run-observer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAEjD,2DAA2D;AAC3D,MAAM,WAAW,YAAY;IAC3B,gGAAgG;IAChG,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,iHAAiH;AACjH,MAAM,MAAM,cAAc,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,YAAY,KAAK,IAAI,CAAC"}

package/dist/job-run-observer.js

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

package/dist/job-run-observer.js.map

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

package/dist/job-runner.d.ts

@@ -0,0 +1,29 @@
+import { type Clock, type ExecutionScope, type IdGenerator, type JobRun, type Lock } from '@ddd-ts-kit/kernel';
+import type { JobRecorder } from './job-recorder.js';
+import type { JobTimers } from './job-timers.js';
+import type { Occurrence } from './occurrence.js';
+import type { RegisteredJob } from './registered-job.js';
+export interface RunnerOptions {
+    readonly clock: Clock;
+    readonly lock: Lock;
+    readonly scope: ExecutionScope;
+    readonly ids: IdGenerator;
+    readonly timers: JobTimers;
+    /** How long the lock of an occurrence is kept for a job without timeout. */
+    readonly lockTtlMs: number;
+    /** How long after its instant another instance may still try an occurrence. */
+    readonly lateAfterMs: number;
+}
+/** Runs one occurrence: the lock of the occurrence, the execution scope, the timeout. */
+export declare class JobRunner {
+    private readonly options;
+    private readonly recorder;
+    constructor(options: RunnerOptions, recorder: JobRecorder);
+    /** Answers what became of the occurrence. Never rejects. */
+    run(job: RegisteredJob, occurrence: Occurrence): Promise<JobRun>;
+    private holds;
+    private execute;
+    private armTimeout;
+    private inScope;
+}
+//# sourceMappingURL=job-runner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"job-runner.d.ts","sourceRoot":"","sources":["../src/job-runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,KAAK,EACV,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,MAAM,EACX,KAAK,IAAI,EACV,MAAM,oBAAoB,CAAC;AAG5B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGzD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,4EAA4E;IAC5E,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,+EAA+E;IAC/E,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,yFAAyF;AACzF,qBAAa,SAAS;IAElB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAF3B,YACmB,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,WAAW,EACpC;IAEJ,4DAA4D;IACtD,GAAG,CAAC,GAAG,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAQrE;YAOa,KAAK;YAkBL,OAAO;IAsBrB,OAAO,CAAC,UAAU;IAYlB,OAAO,CAAC,OAAO;CAehB"}

package/dist/job-runner.js

@@ -0,0 +1,96 @@
+import { executionContextOfJob, } from '@ddd-ts-kit/kernel';
+import { JobLockUnavailableError } from './errors/job-lock-unavailable-error.js';
+import { JobTimeoutError } from './errors/job-timeout-error.js';
+/** Runs one occurrence: the lock of the occurrence, the execution scope, the timeout. */
+export class JobRunner {
+    options;
+    recorder;
+    constructor(options, recorder) {
+        this.options = options;
+        this.recorder = recorder;
+    }
+    /** Answers what became of the occurrence. Never rejects. */
+    async run(job, occurrence) {
+        try {
+            const held = await this.holds(job, occurrence);
+            return held ? await this.execute(job, occurrence) : this.recorder.notRun(job, occurrence, 'skipped-locked');
+        }
+        catch (error) {
+            return this.recorder.refused(job, occurrence, error);
+        }
+    }
+    /*
+     * The lock is not released when the run ends: an instance whose timer fires a little later
+     * would take it and run the occurrence again. It is kept until this instance handles the next
+     * occurrence of the job, or until its time to live has passed.
+     */
+    async holds(job, { scheduledAt, manual }) {
+        if (!job.policy.singleInstance || manual) {
+            return true;
+        }
+        const { timeoutMs, jitterMs } = job.policy;
+        const ttlMs = (timeoutMs ?? this.options.lockTtlMs) + jitterMs + this.options.lateAfterMs;
+        try {
+            await job.held?.release();
+            job.held = await this.options.lock.acquire(`job:${job.name}:${scheduledAt.toISOString()}`, { ttlMs });
+        }
+        catch (error) {
+            throw new JobLockUnavailableError(job.name, { cause: error });
+        }
+        return job.held !== undefined;
+    }
+    async execute(job, occurrence) {
+        const started = { occurrence, startedAt: this.options.clock.now(), correlationId: this.options.ids.next() };
+        const controller = new AbortController();
+        job.abort = (reason) => {
+            controller.abort(reason);
+        };
+        const disarm = this.armTimeout(job, controller);
+        try {
+            await unlessAborted(controller.signal, this.inScope(job, started, controller.signal));
+            return this.recorder.succeeded(job, started);
+        }
+        catch (error) {
+            return this.recorder.failed(job, started, error);
+        }
+        finally {
+            disarm();
+            job.abort = undefined;
+        }
+    }
+    armTimeout(job, controller) {
+        const { timeoutMs } = job.policy;
+        if (timeoutMs === undefined) {
+            return () => undefined;
+        }
+        return this.options.timers.schedule(timeoutMs, () => {
+            controller.abort(new JobTimeoutError(job.name, timeoutMs));
+        });
+    }
+    inScope(job, started, signal) {
+        const { occurrence, startedAt, correlationId } = started;
+        const { scheduledAt } = occurrence;
+        const { timeoutMs } = job.policy;
+        const context = executionContextOfJob(job.name, {
+            correlationId,
+            scheduledAt,
+            ...(timeoutMs === undefined ? {} : { deadline: new Date(startedAt.getTime() + timeoutMs) }),
+        });
+        const execution = { scheduledAt, startedAt, attempt: 1, signal };
+        return this.options.scope.run(context, async () => job.definition.run(execution));
+    }
+}
+/** A job that ignores its signal is left behind: the run ends when the signal is aborted. */
+function unlessAborted(signal, work) {
+    return new Promise((resolve, reject) => {
+        signal.addEventListener('abort', () => {
+            reject(reasonOf(signal));
+        }, { once: true });
+        work.then(resolve, reject);
+    });
+}
+function reasonOf(signal) {
+    const reason = signal.reason;
+    return reason instanceof Error ? reason : new Error('The run was aborted.');
+}
+//# sourceMappingURL=job-runner.js.map

package/dist/job-runner.js.map

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

package/dist/job-timers.d.ts

@@ -0,0 +1,7 @@
+/** How the in-process scheduler sleeps. Injected so that a test moves time instead of waiting for it. */
+export declare abstract class JobTimers {
+    static readonly tokenKey = "scheduling.JobTimers";
+    /** Calls `task` once `delayMs` have passed. The answer cancels it. */
+    abstract schedule(delayMs: number, task: () => void): () => void;
+}
+//# sourceMappingURL=job-timers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"job-timers.d.ts","sourceRoot":"","sources":["../src/job-timers.ts"],"names":[],"mappings":"AAAA,yGAAyG;AACzG,8BAAsB,SAAS;IAC7B,MAAM,CAAC,QAAQ,CAAC,QAAQ,0BAA0B;IAElD,sEAAsE;IACtE,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;CAClE"}

package/dist/job-timers.js

@@ -0,0 +1,5 @@
+/** How the in-process scheduler sleeps. Injected so that a test moves time instead of waiting for it. */
+export class JobTimers {
+    static tokenKey = 'scheduling.JobTimers';
+}
+//# sourceMappingURL=job-timers.js.map

package/dist/job-timers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-timers.js","sourceRoot":"","sources":["../src/job-timers.ts"],"names":[],"mappings":"AAAA,yGAAyG;AACzG,MAAM,OAAgB,SAAS;IAC7B,MAAM,CAAU,QAAQ,GAAG,sBAAsB,CAAC;CAInD"}

package/dist/metric-names.d.ts

@@ -0,0 +1,3 @@
+export declare const RUNS_COUNTER = "scheduled_job_runs_total";
+export declare const DURATION_HISTOGRAM = "scheduled_job_duration_ms";
+//# sourceMappingURL=metric-names.d.ts.map

package/dist/metric-names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metric-names.d.ts","sourceRoot":"","sources":["../src/metric-names.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY,6BAA6B,CAAC;AAEvD,eAAO,MAAM,kBAAkB,8BAA8B,CAAC"}

package/dist/metric-names.js

@@ -0,0 +1,3 @@
+export const RUNS_COUNTER = 'scheduled_job_runs_total';
+export const DURATION_HISTOGRAM = 'scheduled_job_duration_ms';
+//# sourceMappingURL=metric-names.js.map

package/dist/metric-names.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metric-names.js","sourceRoot":"","sources":["../src/metric-names.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,YAAY,GAAG,0BAA0B,CAAC;AAEvD,MAAM,CAAC,MAAM,kBAAkB,GAAG,2BAA2B,CAAC"}