@n8n/scheduler 0.2.2 → 0.3.0

package/dist/core/lifecycle/timeline.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Timeline = void 0;
+class Timeline {
+    constructor(intervalMs, jitterRatio, random, startAt) {
+        this.intervalMs = intervalMs;
+        this.jitterRatio = jitterRatio;
+        this.random = random;
+        this.slotAt = startAt + intervalMs * random();
+    }
+    get firstTickAt() {
+        return this.slotAt;
+    }
+    nextTickAt(now) {
+        const missedSlots = Math.floor(Math.max(0, now - this.slotAt) / this.intervalMs);
+        this.slotAt += (missedSlots + 1) * this.intervalMs;
+        const jitterMs = this.intervalMs * this.jitterRatio * (2 * this.random() - 1);
+        return this.slotAt + jitterMs;
+    }
+}
+exports.Timeline = Timeline;
+//# sourceMappingURL=timeline.js.map

package/dist/core/lifecycle/timeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline.js","sourceRoot":"","sources":["../../../src/core/lifecycle/timeline.ts"],"names":[],"mappings":";;;AAWA,MAAa,QAAQ;IAIpB,YACkB,UAAkB,EAClB,WAAmB,EACnB,MAAoB,EACrC,OAAe;QAHE,eAAU,GAAV,UAAU,CAAQ;QAClB,gBAAW,GAAX,WAAW,CAAQ;QACnB,WAAM,GAAN,MAAM,CAAc;QAGrC,IAAI,CAAC,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,MAAM,EAAE,CAAC;IAC/C,CAAC;IAGD,IAAI,WAAW;QACd,OAAO,IAAI,CAAC,MAAM,CAAC;IACpB,CAAC;IAMD,UAAU,CAAC,GAAW;QACrB,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC;QACjF,IAAI,CAAC,MAAM,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC;QACnD,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;QAC9E,OAAO,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC;IAC/B,CAAC;CACD;AA5BD,4BA4BC"}

package/dist/core/materializer/index.d.ts

@@ -1,4 +1,4 @@
-export { materialize, type MaterializerSummary, type MaterializerOptions, type OnJobPlanError, } from './materialize';
+export { materialize, type MaterializerHooks, type MaterializerSummary, type MaterializerOptions, type OnJobPlanError, } from './materialize';
 export { DEFAULT_MATERIALIZER_OPTIONS } from './options';
 export { planOccurrences, type OccurrencePlan } from './plan';
-export type { DueJobs, PlannedJob, RunInTransaction, MaterializerTransaction } from './transaction';
+export type { DueJobs, NewOccurrence, PlannedJob, RecordedOccurrence, RecordOccurrencesResult, RunInTransaction, MaterializerTransaction, } from './transaction';

package/dist/core/materializer/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/materializer/index.ts"],"names":[],"mappings":";;;AAAA,6CAKuB;AAJtB,0GAAA,WAAW,OAAA;AAKZ,qCAAyD;AAAhD,uHAAA,4BAA4B,OAAA;AACrC,+BAA8D;AAArD,uGAAA,eAAe,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/materializer/index.ts"],"names":[],"mappings":";;;AAAA,6CAMuB;AALtB,0GAAA,WAAW,OAAA;AAMZ,qCAAyD;AAAhD,uHAAA,4BAA4B,OAAA;AACrC,+BAA8D;AAArD,uGAAA,eAAe,OAAA"}

package/dist/core/materializer/materialize.d.ts

@@ -1,11 +1,19 @@
 import type { ScheduledJob } from '../types';
 import { type MaterializerOptions } from './options';
-import type { RunInTransaction } from './transaction';
+import type { RecordedOccurrence, RunInTransaction } from './transaction';
 export type { MaterializerOptions } from './options';
 export interface MaterializerSummary {
     claimedJobs: number;
     occurrences: number;
+    created: RecordedOccurrence[];
     deferredJobs: number;
 }
 export type OnJobPlanError = (job: ScheduledJob, error: unknown) => void;
-export declare function materialize(runInTransaction: RunInTransaction, options?: MaterializerOptions, onPlanError?: OnJobPlanError): Promise<MaterializerSummary>;
+export interface MaterializerHooks {
+    onPlanError?: OnJobPlanError;
+    onSkippedDuplicates?: (context: {
+        planned: number;
+        recorded: number;
+    }) => void;
+}
+export declare function materialize(runInTransaction: RunInTransaction, options?: MaterializerOptions, hooks?: MaterializerHooks, signal?: AbortSignal): Promise<MaterializerSummary>;

package/dist/core/materializer/materialize.js

@@ -4,22 +4,44 @@ exports.materialize = materialize;
 const constants_1 = require("@n8n/constants");
 const options_1 = require("./options");
 const plan_1 = require("./plan");
-async function materialize(runInTransaction, options = options_1.DEFAULT_MATERIALIZER_OPTIONS, onPlanError) {
+async function materialize(runInTransaction, options = options_1.DEFAULT_MATERIALIZER_OPTIONS, hooks = {}, signal) {
+    signal?.throwIfAborted();
     return await runInTransaction(async (tx) => {
         const claimed = await tx.claimDueJobs(options.batchSize);
+        signal?.throwIfAborted();
         if (claimed === undefined) {
-            return { claimedJobs: 0, occurrences: 0, deferredJobs: 0 };
+            return { claimedJobs: 0, occurrences: 0, created: [], deferredJobs: 0 };
+        }
+        const { occurrencesPlanned, numberOfJobsDeferred } = planOrDeferJobs(claimed, options, hooks.onPlanError);
+        const rows = toNewOccurrences(occurrencesPlanned);
+        const { recorded, created } = await tx.recordOccurrences(rows);
+        signal?.throwIfAborted();
+        if (recorded < rows.length) {
+            try {
+                hooks.onSkippedDuplicates?.({ planned: rows.length, recorded });
+            }
+            catch {
+            }
         }
-        const { occurrencesPlanned, numberOfJobsDeferred } = planOrDeferJobs(claimed, options, onPlanError);
-        const occurrences = await tx.recordOccurrences(occurrencesPlanned);
         await tx.advanceJobs(occurrencesPlanned);
         return {
             claimedJobs: claimed.jobs.length,
-            occurrences,
+            occurrences: recorded,
+            created,
             deferredJobs: numberOfJobsDeferred,
         };
     });
 }
+function toNewOccurrences(planned) {
+    return planned.flatMap(({ job, plan }) => plan.occurrences.map((when) => ({
+        jobId: job.id,
+        taskType: job.taskType,
+        payload: job.payload,
+        scheduledFor: when,
+        runAt: when,
+        maxAttempts: job.maxAttempts,
+    })));
+}
 function planOrDeferJobs(dueJobs, options, onPlanError) {
     const plans = dueJobs.jobs.map((job) => planOrDeferJob(job, dueJobs.now, options, onPlanError));
     return {
@@ -35,7 +57,11 @@ function planOrDeferJob(job, now, options, onPlanError) {
         };
     }
     catch (error) {
-        onPlanError?.(job, error);
+        try {
+            onPlanError?.(job, error);
+        }
+        catch {
+        }
         const retryAt = new Date(now.getTime() + options.planRetrySeconds * constants_1.Time.seconds.toMilliseconds);
         return {
             plannedJob: {

package/dist/core/materializer/materialize.js.map

@@ -1 +1 @@
-{"version":3,"file":"materialize.js","sourceRoot":"","sources":["../../../src/core/materializer/materialize.ts"],"names":[],"mappings":";;AAqDA,kCAwBC;AA7ED,8CAAsC;AAGtC,uCAAmF;AACnF,iCAAyC;AAiDlC,KAAK,UAAU,WAAW,CAChC,gBAAkC,EAClC,UAA+B,sCAA4B,EAC3D,WAA4B;IAE5B,OAAO,MAAM,gBAAgB,CAAsB,KAAK,EAAE,EAAE,EAAE,EAAE;QAC/D,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACzD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC3B,OAAO,EAAE,WAAW,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC;QAC5D,CAAC;QACD,MAAM,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,GAAG,eAAe,CACnE,OAAO,EACP,OAAO,EACP,WAAW,CACX,CAAC;QACF,MAAM,WAAW,GAAG,MAAM,EAAE,CAAC,iBAAiB,CAAC,kBAAkB,CAAC,CAAC;QACnE,MAAM,EAAE,CAAC,WAAW,CAAC,kBAAkB,CAAC,CAAC;QAEzC,OAAO;YACN,WAAW,EAAE,OAAO,CAAC,IAAI,CAAC,MAAM;YAChC,WAAW;YACX,YAAY,EAAE,oBAAoB;SAClC,CAAC;IACH,CAAC,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CACvB,OAAgB,EAChB,OAA4B,EAC5B,WAA4B;IAK5B,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,cAAc,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC;IAChG,OAAO;QACN,kBAAkB,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,UAAU,CAAC;QAC7D,oBAAoB,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,MAAM;KACrE,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CACtB,GAAiB,EACjB,GAAS,EACT,OAA4B,EAC5B,WAA4B;IAK5B,IAAI,CAAC;QACJ,OAAO;YACN,UAAU,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,IAAA,sBAAe,EAAC,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE;YAC7D,QAAQ,EAAE,KAAK;SACf,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,WAAW,EAAE,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAO1B,MAAM,OAAO,GAAG,IAAI,IAAI,CACvB,GAAG,CAAC,OAAO,EAAE,GAAG,OAAO,CAAC,gBAAgB,GAAG,gBAAI,CAAC,OAAO,CAAC,cAAc,CACtE,CAAC;QACF,OAAO;YACN,UAAU,EAAE;gBACX,GAAG;gBACH,IAAI,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,CAAC,WAAW,EAAE;aAC3E;YACD,QAAQ,EAAE,IAAI;SACd,CAAC;IACH,CAAC;AACF,CAAC"}
+{"version":3,"file":"materialize.js","sourceRoot":"","sources":["../../../src/core/materializer/materialize.ts"],"names":[],"mappings":"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"}

package/dist/core/materializer/options.d.ts

@@ -3,5 +3,6 @@ export interface MaterializerOptions {
     maxPerJob: number;
     batchSize: number;
     planRetrySeconds: number;
+    defaultTimezone: string;
 }
 export declare const DEFAULT_MATERIALIZER_OPTIONS: MaterializerOptions;

package/dist/core/materializer/options.js

@@ -7,5 +7,6 @@ exports.DEFAULT_MATERIALIZER_OPTIONS = {
     batchSize: 100,
     maxPerJob: 1000,
     planRetrySeconds: constants_1.Time.hours.toSeconds,
+    defaultTimezone: 'UTC',
 };
 //# sourceMappingURL=options.js.map

package/dist/core/materializer/options.js.map

@@ -1 +1 @@
-{"version":3,"file":"options.js","sourceRoot":"","sources":["../../../src/core/materializer/options.ts"],"names":[],"mappings":";;;AAAA,8CAAsC;AA+BzB,QAAA,4BAA4B,GAAwB;IAChE,aAAa,EAAE,EAAE;IACjB,SAAS,EAAE,GAAG;IACd,SAAS,EAAE,IAAI;IACf,gBAAgB,EAAE,gBAAI,CAAC,KAAK,CAAC,SAAS;CACtC,CAAC"}
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../../src/core/materializer/options.ts"],"names":[],"mappings":";;;AAAA,8CAAsC;AAqCzB,QAAA,4BAA4B,GAAwB;IAChE,aAAa,EAAE,EAAE;IACjB,SAAS,EAAE,GAAG;IACd,SAAS,EAAE,IAAI;IACf,gBAAgB,EAAE,gBAAI,CAAC,KAAK,CAAC,SAAS;IACtC,eAAe,EAAE,KAAK;CACtB,CAAC"}

package/dist/core/materializer/plan.d.ts

@@ -7,4 +7,5 @@ export interface OccurrencePlan {
 export declare function planOccurrences(job: ScheduledJob, now: Date, options: {
     windowSeconds: number;
     maxPerJob: number;
+    defaultTimezone: string;
 }): OccurrencePlan;

package/dist/core/materializer/plan.js

@@ -3,19 +3,25 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.planOccurrences = planOccurrences;
 const constants_1 = require("@n8n/constants");
 const next_run_1 = require("../recurrence/next-run");
+const resolve_1 = require("../recurrence/resolve");
 function planOccurrences(job, now, options) {
+    const schedule = (0, resolve_1.resolveSchedule)(job, options.defaultTimezone);
     const windowEnd = now.getTime() + options.windowSeconds * constants_1.Time.seconds.toMilliseconds;
+    if (job.nextRunAt === null) {
+        return { occurrences: [], nextRunAt: null, lastFiredAt: job.lastFiredAt };
+    }
     const occurrences = [];
-    let cursor = job.nextRunAt;
-    while (cursor !== null &&
-        cursor.getTime() <= windowEnd &&
+    const fires = (0, next_run_1.occurrencesFrom)(schedule, job.nextRunAt);
+    let fire = fires.next();
+    while (!fire.done &&
+        fire.value.getTime() <= windowEnd &&
         occurrences.length < options.maxPerJob) {
-        occurrences.push(cursor);
-        cursor = (0, next_run_1.computeNextRunAt)(job.schedule, cursor);
+        occurrences.push(fire.value);
+        fire = fires.next();
     }
     return {
         occurrences,
-        nextRunAt: cursor,
+        nextRunAt: fire.done ? null : fire.value,
         lastFiredAt: occurrences.at(-1) ?? job.lastFiredAt,
     };
 }

package/dist/core/materializer/plan.js.map

@@ -1 +1 @@
-{"version":3,"file":"plan.js","sourceRoot":"","sources":["../../../src/core/materializer/plan.ts"],"names":[],"mappings":";;AA+BA,0CAuBC;AAtDD,8CAAsC;AAEtC,qDAA0D;AA6B1D,SAAgB,eAAe,CAC9B,GAAiB,EACjB,GAAS,EACT,OAAqD;IAErD,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,EAAE,GAAG,OAAO,CAAC,aAAa,GAAG,gBAAI,CAAC,OAAO,CAAC,cAAc,CAAC;IAEtF,MAAM,WAAW,GAAW,EAAE,CAAC;IAC/B,IAAI,MAAM,GAAG,GAAG,CAAC,SAAS,CAAC;IAC3B,OACC,MAAM,KAAK,IAAI;QACf,MAAM,CAAC,OAAO,EAAE,IAAI,SAAS;QAC7B,WAAW,CAAC,MAAM,GAAG,OAAO,CAAC,SAAS,EACrC,CAAC;QACF,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACzB,MAAM,GAAG,IAAA,2BAAgB,EAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACjD,CAAC;IAED,OAAO;QACN,WAAW;QACX,SAAS,EAAE,MAAM;QACjB,WAAW,EAAE,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,WAAW;KAClD,CAAC;AACH,CAAC"}
+{"version":3,"file":"plan.js","sourceRoot":"","sources":["../../../src/core/materializer/plan.ts"],"names":[],"mappings":";;AAgCA,0CA+BC;AA/DD,8CAAsC;AAEtC,qDAAyD;AACzD,mDAAwD;AA6BxD,SAAgB,eAAe,CAC9B,GAAiB,EACjB,GAAS,EACT,OAA8E;IAI9E,MAAM,QAAQ,GAAG,IAAA,yBAAe,EAAC,GAAG,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IAC/D,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,EAAE,GAAG,OAAO,CAAC,aAAa,GAAG,gBAAI,CAAC,OAAO,CAAC,cAAc,CAAC;IAEtF,IAAI,GAAG,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;QAC5B,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,CAAC,WAAW,EAAE,CAAC;IAC3E,CAAC;IAED,MAAM,WAAW,GAAW,EAAE,CAAC;IAC/B,MAAM,KAAK,GAAG,IAAA,0BAAe,EAAC,QAAQ,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC;IACvD,IAAI,IAAI,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IACxB,OACC,CAAC,IAAI,CAAC,IAAI;QACV,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,SAAS;QACjC,WAAW,CAAC,MAAM,GAAG,OAAO,CAAC,SAAS,EACrC,CAAC;QACF,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7B,IAAI,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IACrB,CAAC;IAED,OAAO;QACN,WAAW;QACX,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK;QACxC,WAAW,EAAE,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,WAAW;KAClD,CAAC;AACH,CAAC"}

package/dist/core/materializer/transaction.d.ts

@@ -4,13 +4,30 @@ export interface PlannedJob {
     job: ScheduledJob;
     plan: OccurrencePlan;
 }
+export interface NewOccurrence {
+    jobId: number;
+    taskType: string;
+    payload: Record<string, unknown>;
+    scheduledFor: Date;
+    runAt: Date;
+    maxAttempts: number;
+}
+export interface RecordedOccurrence {
+    id: string;
+    jobId: number;
+    taskType: string;
+}
+export interface RecordOccurrencesResult {
+    recorded: number;
+    created: RecordedOccurrence[];
+}
 export interface DueJobs {
     now: Date;
     jobs: ScheduledJob[];
 }
 export interface MaterializerTransaction {
     claimDueJobs(limit: number): Promise<DueJobs | undefined>;
-    recordOccurrences(planned: PlannedJob[]): Promise<number>;
+    recordOccurrences(occurrences: NewOccurrence[]): Promise<RecordOccurrencesResult>;
     advanceJobs(planned: PlannedJob[]): Promise<void>;
 }
 export type RunInTransaction = <T>(work: (tx: MaterializerTransaction) => Promise<T>) => Promise<T>;

package/dist/core/provisioning/index.d.ts

@@ -0,0 +1,5 @@
+export { provision, deprovision } from './provision';
+export { createJobProvisioner } from './provisioner';
+export type { JobProvisioner, JobProvisionerDeps } from './provisioner';
+export type { ProvisionTransaction, RunInProvisionTransaction, DeprovisionTransaction, RunInDeprovisionTransaction, } from './transaction';
+export type { ScheduleDefinition, CronDefinition, RecurringCronDefinition, IntervalDefinition, OneOffDefinition, DesiredJob, ExistingJob, ProvisionedJob, ProvisionSummary, } from './types';

package/dist/core/provisioning/index.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createJobProvisioner = exports.deprovision = exports.provision = void 0;
+var provision_1 = require("./provision");
+Object.defineProperty(exports, "provision", { enumerable: true, get: function () { return provision_1.provision; } });
+Object.defineProperty(exports, "deprovision", { enumerable: true, get: function () { return provision_1.deprovision; } });
+var provisioner_1 = require("./provisioner");
+Object.defineProperty(exports, "createJobProvisioner", { enumerable: true, get: function () { return provisioner_1.createJobProvisioner; } });
+//# sourceMappingURL=index.js.map

package/dist/core/provisioning/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/provisioning/index.ts"],"names":[],"mappings":";;;AAAA,yCAAqD;AAA5C,sGAAA,SAAS,OAAA;AAAE,wGAAA,WAAW,OAAA;AAC/B,6CAAqD;AAA5C,mHAAA,oBAAoB,OAAA"}

package/dist/core/provisioning/provision.d.ts

@@ -0,0 +1,6 @@
+import type { RunInProvisionTransaction, RunInDeprovisionTransaction } from './transaction';
+import type { DesiredJob, ProvisionSummary } from './types';
+export declare function provision(runInTransaction: RunInProvisionTransaction, desired: DesiredJob[]): Promise<ProvisionSummary>;
+export declare function deprovision(runInTransaction: RunInDeprovisionTransaction): Promise<{
+    removed: number;
+}>;

package/dist/core/provisioning/provision.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.provision = provision;
+exports.deprovision = deprovision;
+const errors_1 = require("../errors");
+async function provision(runInTransaction, desired) {
+    return await runInTransaction(async (tx) => {
+        const existing = await tx.findExisting();
+        const existingByName = new Map(existing.map((job) => [job.name, job]));
+        const desiredNames = new Set(desired.map((job) => job.name));
+        const inserts = [];
+        const redefined = [];
+        const unchanged = [];
+        for (const job of desired) {
+            const current = existingByName.get(job.name);
+            if (current === undefined) {
+                inserts.push(job);
+            }
+            else if (holdsDefinition(current, job)) {
+                unchanged.push({ id: current.id, name: current.name });
+            }
+            else {
+                redefined.push({ id: current.id, name: current.name });
+                await tx.redefine(current.id, job.schedule, job.firstRunAt);
+            }
+        }
+        const removed = existing
+            .filter((job) => !desiredNames.has(job.name))
+            .map((job) => ({ id: job.id, name: job.name }));
+        await tx.withdrawPendingTasks(redefined.map((job) => job.id));
+        await tx.deleteJobs(removed.map((job) => job.id));
+        const insertedIds = await tx.insert(inserts);
+        const inserted = inserts.map((job, index) => ({ id: insertedIds[index], name: job.name }));
+        return { inserted, redefined, unchanged, removed };
+    });
+}
+async function deprovision(runInTransaction) {
+    return await runInTransaction(async (tx) => ({ removed: await tx.deleteAll() }));
+}
+function holdsDefinition(current, desired) {
+    return (sameSchedule(current.schedule, desired.schedule) &&
+        current.hasClock === (desired.firstRunAt !== null));
+}
+function sameSchedule(a, b) {
+    switch (a.kind) {
+        case 'cron':
+            return (b.kind === 'cron' && a.cronExpression === b.cronExpression && a.timezone === b.timezone);
+        case 'recurring_cron':
+            return (b.kind === 'recurring_cron' &&
+                a.cronExpression === b.cronExpression &&
+                a.timezone === b.timezone &&
+                a.recurrenceUnit === b.recurrenceUnit &&
+                a.recurrenceSize === b.recurrenceSize);
+        case 'interval':
+            return b.kind === 'interval' && a.intervalSeconds === b.intervalSeconds;
+        case 'one_off':
+            return b.kind === 'one_off' && a.fireAt.getTime() === b.fireAt.getTime();
+        default: {
+            const exhaustive = a;
+            throw new errors_1.InvalidScheduleError(`Unexpected schedule kind: ${JSON.stringify(exhaustive)}`);
+        }
+    }
+}
+//# sourceMappingURL=provision.js.map

package/dist/core/provisioning/provision.js.map

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

package/dist/core/provisioning/provisioner.d.ts

@@ -0,0 +1,15 @@
+import type { RunInDeprovisionTransaction, RunInProvisionTransaction } from './transaction';
+import type { DesiredJob, ProvisionSummary } from './types';
+import { type Tracer } from '../../observability/tracer';
+export interface JobProvisioner<PScope, DScope = PScope> {
+    provision(scope: PScope, desired: DesiredJob[]): Promise<ProvisionSummary>;
+    deprovision(scope: DScope): Promise<{
+        removed: number;
+    }>;
+}
+export interface JobProvisionerDeps<PScope, DScope = PScope> {
+    provisionTransaction: (scope: PScope) => RunInProvisionTransaction;
+    deprovisionTransaction: (scope: DScope) => RunInDeprovisionTransaction;
+    tracer?: Tracer;
+}
+export declare function createJobProvisioner<PScope, DScope = PScope>(deps: JobProvisionerDeps<PScope, DScope>): JobProvisioner<PScope, DScope>;

package/dist/core/provisioning/provisioner.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createJobProvisioner = createJobProvisioner;
+const provision_1 = require("./provision");
+const provisioner_tracing_1 = require("../../observability/provisioner-tracing");
+const tracer_1 = require("../../observability/tracer");
+function createJobProvisioner(deps) {
+    const tracing = (0, provisioner_tracing_1.createProvisionerTracing)(deps.tracer ?? tracer_1.noopTracer);
+    return {
+        async provision(scope, desired) {
+            return await tracing.provision(async () => await (0, provision_1.provision)(deps.provisionTransaction(scope), desired));
+        },
+        async deprovision(scope) {
+            return await tracing.deprovision(async () => await (0, provision_1.deprovision)(deps.deprovisionTransaction(scope)));
+        },
+    };
+}
+//# sourceMappingURL=provisioner.js.map

package/dist/core/provisioning/provisioner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provisioner.js","sourceRoot":"","sources":["../../../src/core/provisioning/provisioner.ts"],"names":[],"mappings":";;AAsCA,oDAgBC;AAtDD,2CAAqD;AAGrD,iFAAmF;AACnF,uDAAqE;AAkCrE,SAAgB,oBAAoB,CACnC,IAAwC;IAExC,MAAM,OAAO,GAAG,IAAA,8CAAwB,EAAC,IAAI,CAAC,MAAM,IAAI,mBAAU,CAAC,CAAC;IACpE,OAAO;QACN,KAAK,CAAC,SAAS,CAAC,KAAK,EAAE,OAAO;YAC7B,OAAO,MAAM,OAAO,CAAC,SAAS,CAC7B,KAAK,IAAI,EAAE,CAAC,MAAM,IAAA,qBAAS,EAAC,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,CACtE,CAAC;QACH,CAAC;QACD,KAAK,CAAC,WAAW,CAAC,KAAK;YACtB,OAAO,MAAM,OAAO,CAAC,WAAW,CAC/B,KAAK,IAAI,EAAE,CAAC,MAAM,IAAA,uBAAW,EAAC,IAAI,CAAC,sBAAsB,CAAC,KAAK,CAAC,CAAC,CACjE,CAAC;QACH,CAAC;KACD,CAAC;AACH,CAAC"}

package/dist/core/provisioning/transaction.d.ts

@@ -0,0 +1,13 @@
+import type { DesiredJob, ExistingJob, ScheduleDefinition } from './types';
+export interface ProvisionTransaction {
+    findExisting(): Promise<ExistingJob[]>;
+    insert(jobs: DesiredJob[]): Promise<number[]>;
+    redefine(jobId: number, schedule: ScheduleDefinition, nextRunAt: Date | null): Promise<void>;
+    withdrawPendingTasks(jobIds: number[]): Promise<void>;
+    deleteJobs(jobIds: number[]): Promise<void>;
+}
+export type RunInProvisionTransaction = <T>(work: (tx: ProvisionTransaction) => Promise<T>) => Promise<T>;
+export interface DeprovisionTransaction {
+    deleteAll(): Promise<number>;
+}
+export type RunInDeprovisionTransaction = <T>(work: (tx: DeprovisionTransaction) => Promise<T>) => Promise<T>;

package/dist/core/provisioning/transaction.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=transaction.js.map

package/dist/core/provisioning/transaction.js.map

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

package/dist/core/provisioning/types.d.ts

@@ -0,0 +1,43 @@
+import type { RecurringCronUnit } from '@n8n/constants';
+export type ScheduleDefinition = CronDefinition | RecurringCronDefinition | IntervalDefinition | OneOffDefinition;
+export interface CronDefinition {
+    kind: 'cron';
+    cronExpression: string;
+    timezone: string | null;
+}
+export interface RecurringCronDefinition {
+    kind: 'recurring_cron';
+    cronExpression: string;
+    timezone: string | null;
+    recurrenceUnit: RecurringCronUnit;
+    recurrenceSize: number;
+}
+export interface IntervalDefinition {
+    kind: 'interval';
+    intervalSeconds: number;
+}
+export interface OneOffDefinition {
+    kind: 'one_off';
+    fireAt: Date;
+}
+export interface DesiredJob {
+    name: string;
+    schedule: ScheduleDefinition;
+    firstRunAt: Date | null;
+}
+export interface ExistingJob {
+    id: number;
+    name: string;
+    schedule: ScheduleDefinition;
+    hasClock: boolean;
+}
+export interface ProvisionedJob {
+    id: number;
+    name: string;
+}
+export interface ProvisionSummary {
+    inserted: ProvisionedJob[];
+    redefined: ProvisionedJob[];
+    unchanged: ProvisionedJob[];
+    removed: ProvisionedJob[];
+}

package/dist/core/provisioning/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/core/provisioning/types.js.map

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

package/dist/core/reaper/index.d.ts

@@ -0,0 +1 @@
+export { reap, DEFAULT_REAPER_OPTIONS, type ReapResult, type ReaperOptions, type ReaperTaskStore, type ExpiredLeaseRef, type ExpiredLeaseRow, type ReaperHooks, } from './reap';

package/dist/core/reaper/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_REAPER_OPTIONS = exports.reap = void 0;
+var reap_1 = require("./reap");
+Object.defineProperty(exports, "reap", { enumerable: true, get: function () { return reap_1.reap; } });
+Object.defineProperty(exports, "DEFAULT_REAPER_OPTIONS", { enumerable: true, get: function () { return reap_1.DEFAULT_REAPER_OPTIONS; } });
+//# sourceMappingURL=index.js.map

package/dist/core/reaper/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/reaper/index.ts"],"names":[],"mappings":";;;AAAA,+BASgB;AARf,4FAAA,IAAI,OAAA;AACJ,8GAAA,sBAAsB,OAAA"}

package/dist/{reaper/reaper.d.ts → core/reaper/reap.d.ts}

@@ -1,13 +1,12 @@
-import type { Logger } from '@n8n/backend-common';
 export interface ReapResult {
     reclaimed: number;
     deadLettered: number;
 }
-interface ExpiredLeaseRef {
+export interface ExpiredLeaseRef {
     id: string;
     claimedEpoch: number;
 }
-interface ExpiredLeaseRow {
+export interface ExpiredLeaseRow {
     id: string;
     attempts: number;
     maxAttempts: number;
@@ -18,10 +17,16 @@ export interface ReaperTaskStore {
     reclaimExpired(ref: ExpiredLeaseRef, backoffMs: number, errorMessage: string): Promise<number>;
     deadLetterExpired(ref: ExpiredLeaseRef, errorMessage: string): Promise<number>;
 }
-export interface ReapDeps {
-    store: ReaperTaskStore;
-    logger: Logger;
+export interface ReaperOptions {
     batchSize: number;
 }
-export declare function reap({ store, logger, batchSize }: ReapDeps): Promise<ReapResult>;
-export {};
+export declare const DEFAULT_REAPER_OPTIONS: ReaperOptions;
+export interface ReaperHooks {
+    onRowError?: (taskId: string, error: unknown) => void;
+    onDeadLetter?: (task: {
+        taskId: string;
+        attempts: number;
+        maxAttempts: number;
+    }) => void;
+}
+export declare function reap(store: ReaperTaskStore, options?: ReaperOptions, hooks?: ReaperHooks, signal?: AbortSignal): Promise<ReapResult>;

package/dist/core/reaper/reap.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_REAPER_OPTIONS = void 0;
+exports.reap = reap;
+const backoff_1 = require("../executor/backoff");
+const LEASE_EXPIRED_MESSAGE = 'Lease expired before completion';
+exports.DEFAULT_REAPER_OPTIONS = {
+    batchSize: 100,
+};
+async function reap(store, options = exports.DEFAULT_REAPER_OPTIONS, hooks = {}, signal) {
+    const expired = await store.findExpiredLeases(options.batchSize);
+    if (expired.length === 0)
+        return { reclaimed: 0, deadLettered: 0 };
+    let reclaimed = 0;
+    let deadLettered = 0;
+    for (const task of expired) {
+        if (signal?.aborted === true) {
+            break;
+        }
+        try {
+            const nextAttempts = task.attempts + 1;
+            if (nextAttempts >= task.maxAttempts) {
+                const affected = await store.deadLetterExpired({ id: task.id, claimedEpoch: task.leaseEpoch }, LEASE_EXPIRED_MESSAGE);
+                deadLettered += affected;
+                if (affected > 0) {
+                    try {
+                        hooks.onDeadLetter?.({
+                            taskId: task.id,
+                            attempts: nextAttempts,
+                            maxAttempts: task.maxAttempts,
+                        });
+                    }
+                    catch {
+                    }
+                }
+            }
+            else {
+                reclaimed += await store.reclaimExpired({ id: task.id, claimedEpoch: task.leaseEpoch }, (0, backoff_1.backoff)(nextAttempts), LEASE_EXPIRED_MESSAGE);
+            }
+        }
+        catch (error) {
+            try {
+                hooks.onRowError?.(task.id, error);
+            }
+            catch {
+            }
+        }
+    }
+    return { reclaimed, deadLettered };
+}
+//# sourceMappingURL=reap.js.map

package/dist/core/reaper/reap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reap.js","sourceRoot":"","sources":["../../../src/core/reaper/reap.ts"],"names":[],"mappings":";;;AAoFA,oBA+DC;AAnJD,iDAA8C;AAG9C,MAAM,qBAAqB,GAAG,iCAAiC,CAAC;AA4CnD,QAAA,sBAAsB,GAAkB;IACpD,SAAS,EAAE,GAAG;CACd,CAAC;AAmCK,KAAK,UAAU,IAAI,CACzB,KAAsB,EACtB,UAAyB,8BAAsB,EAC/C,QAAqB,EAAE,EACvB,MAAoB;IAEpB,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,iBAAiB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAGjE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,SAAS,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC;IAEnE,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,MAAM,EAAE,OAAO,KAAK,IAAI,EAAE,CAAC;YAC9B,MAAM;QACP,CAAC;QAGD,IAAI,CAAC;YAGJ,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC;YACvC,IAAI,YAAY,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;gBACtC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,iBAAiB,CAC7C,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC,UAAU,EAAE,EAC9C,qBAAqB,CACrB,CAAC;gBACF,YAAY,IAAI,QAAQ,CAAC;gBAGzB,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;oBAClB,IAAI,CAAC;wBAGJ,KAAK,CAAC,YAAY,EAAE,CAAC;4BACpB,MAAM,EAAE,IAAI,CAAC,EAAE;4BACf,QAAQ,EAAE,YAAY;4BACtB,WAAW,EAAE,IAAI,CAAC,WAAW;yBAC7B,CAAC,CAAC;oBACJ,CAAC;oBAAC,MAAM,CAAC;oBAET,CAAC;gBACF,CAAC;YACF,CAAC;iBAAM,CAAC;gBACP,SAAS,IAAI,MAAM,KAAK,CAAC,cAAc,CACtC,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC,UAAU,EAAE,EAC9C,IAAA,iBAAO,EAAC,YAAY,CAAC,EACrB,qBAAqB,CACrB,CAAC;YACH,CAAC;QACF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,IAAI,CAAC;gBAGJ,KAAK,CAAC,UAAU,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;YACpC,CAAC;YAAC,MAAM,CAAC;YAET,CAAC;QACF,CAAC;IACF,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC;AACpC,CAAC"}

package/dist/core/recurrence/field.d.ts

@@ -0,0 +1,2 @@
+import type { ScheduledJob } from '../types';
+export declare function required<K extends keyof ScheduledJob>(job: ScheduledJob, key: K): NonNullable<ScheduledJob[K]>;

package/dist/core/recurrence/field.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.required = required;
+const errors_1 = require("../errors");
+function required(job, key) {
+    const value = job[key];
+    if (value === null || value === undefined) {
+        throw new errors_1.CorruptStorageRowError(`scheduled_job ${job.id} of kind '${job.kind}' is missing '${String(key)}'`);
+    }
+    return value;
+}
+//# sourceMappingURL=field.js.map

package/dist/core/recurrence/field.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field.js","sourceRoot":"","sources":["../../../src/core/recurrence/field.ts"],"names":[],"mappings":";;AAaA,4BAWC;AAxBD,sCAAmD;AAanD,SAAgB,QAAQ,CACvB,GAAiB,EACjB,GAAM;IAEN,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;IACvB,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAC3C,MAAM,IAAI,+BAAsB,CAC/B,iBAAiB,GAAG,CAAC,EAAE,aAAa,GAAG,CAAC,IAAI,iBAAiB,MAAM,CAAC,GAAG,CAAC,GAAG,CAC3E,CAAC;IACH,CAAC;IACD,OAAO,KAAqC,CAAC;AAC9C,CAAC"}

package/dist/core/recurrence/kinds/cron.d.ts

@@ -0,0 +1,10 @@
+import { CronExpressionParser } from 'cron-parser';
+import type { CronExpression } from 'n8n-workflow';
+import type { CronSchedule, RecurringCronSchedule, ScheduledJob } from '../../types';
+export type CronCursor = ReturnType<typeof CronExpressionParser.parse>;
+export declare function validateCron(schedule: CronSchedule | RecurringCronSchedule): void;
+export declare function resolvedTimezone(schedule: CronSchedule | RecurringCronSchedule): string;
+export declare function parseCron(cronExpression: CronExpression, after: Date, timezone: string): CronCursor;
+export declare function cronNextRun(schedule: CronSchedule | RecurringCronSchedule, after: Date): Date;
+export declare function cronOccurrences(schedule: CronSchedule, first: Date): Generator<Date>;
+export declare function resolveCron(job: ScheduledJob, defaultTimezone: string): CronSchedule;