@n8n/scheduler 0.1.0 → 0.2.1

package/dist/core/enums.d.ts

@@ -0,0 +1 @@
+export { ScheduledJobKind, ScheduledJobKindList, ScheduledTaskStatus, ScheduledTaskStatusList, type TerminalTaskStatus, TerminalTaskStatusList, } from '@n8n/db';

package/dist/core/enums.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TerminalTaskStatusList = exports.ScheduledTaskStatusList = exports.ScheduledTaskStatus = exports.ScheduledJobKindList = exports.ScheduledJobKind = void 0;
+var db_1 = require("@n8n/db");
+Object.defineProperty(exports, "ScheduledJobKind", { enumerable: true, get: function () { return db_1.ScheduledJobKind; } });
+Object.defineProperty(exports, "ScheduledJobKindList", { enumerable: true, get: function () { return db_1.ScheduledJobKindList; } });
+Object.defineProperty(exports, "ScheduledTaskStatus", { enumerable: true, get: function () { return db_1.ScheduledTaskStatus; } });
+Object.defineProperty(exports, "ScheduledTaskStatusList", { enumerable: true, get: function () { return db_1.ScheduledTaskStatusList; } });
+Object.defineProperty(exports, "TerminalTaskStatusList", { enumerable: true, get: function () { return db_1.TerminalTaskStatusList; } });
+//# sourceMappingURL=enums.js.map

package/dist/core/enums.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enums.js","sourceRoot":"","sources":["../../src/core/enums.ts"],"names":[],"mappings":";;;AAIA,8BAOiB;AANhB,sGAAA,gBAAgB,OAAA;AAChB,0GAAA,oBAAoB,OAAA;AACpB,yGAAA,mBAAmB,OAAA;AACnB,6GAAA,uBAAuB,OAAA;AAEvB,4GAAA,sBAAsB,OAAA"}

package/dist/core/errors.d.ts

@@ -0,0 +1,9 @@
+export declare class InvalidScheduleError extends Error {
+    constructor(message: string);
+}
+export declare class InvalidRetentionOptionsError extends Error {
+    constructor(message: string);
+}
+export declare class CorruptStorageRowError extends Error {
+    constructor(message: string);
+}

package/dist/core/errors.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CorruptStorageRowError = exports.InvalidRetentionOptionsError = exports.InvalidScheduleError = void 0;
+class InvalidScheduleError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'InvalidScheduleError';
+    }
+}
+exports.InvalidScheduleError = InvalidScheduleError;
+class InvalidRetentionOptionsError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'InvalidRetentionOptionsError';
+    }
+}
+exports.InvalidRetentionOptionsError = InvalidRetentionOptionsError;
+class CorruptStorageRowError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'CorruptStorageRowError';
+    }
+}
+exports.CorruptStorageRowError = CorruptStorageRowError;
+//# sourceMappingURL=errors.js.map

package/dist/core/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":";;;AAQA,MAAa,oBAAqB,SAAQ,KAAK;IAC9C,YAAY,OAAe;QAC1B,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACpC,CAAC;CACD;AALD,oDAKC;AAMD,MAAa,4BAA6B,SAAQ,KAAK;IACtD,YAAY,OAAe;QAC1B,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,8BAA8B,CAAC;IAC5C,CAAC;CACD;AALD,oEAKC;AAOD,MAAa,sBAAuB,SAAQ,KAAK;IAChD,YAAY,OAAe;QAC1B,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACtC,CAAC;CACD;AALD,wDAKC"}

package/dist/core/index.d.ts

@@ -0,0 +1,10 @@
+export { ScheduledJobKind, ScheduledJobKindList, ScheduledTaskStatus, ScheduledTaskStatusList, type TerminalTaskStatus, TerminalTaskStatusList, } from './enums';
+export type { CronSchedule, IntervalSchedule, OneOffSchedule, Schedule, ScheduledJob, ScheduledTask, } from './types';
+export { InvalidScheduleError, InvalidRetentionOptionsError, CorruptStorageRowError, } from './errors';
+export { computeNextRunAt } from './recurrence/next-run';
+export { validateSchedule } from './recurrence/validate';
+export { materialize, DEFAULT_MATERIALIZER_OPTIONS } from './materializer';
+export type { MaterializerSummary, MaterializerOptions, OnJobPlanError, } from './materializer';
+export type { DueJobs, PlannedJob, RunInTransaction, MaterializerTransaction, } from './materializer';
+export { prune, DEFAULT_RETENTION_OPTIONS } from './retention';
+export type { RetentionSummary, RetentionOptions, RetentionBatch, RetentionStore, } from './retention';

package/dist/core/index.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_RETENTION_OPTIONS = exports.prune = exports.DEFAULT_MATERIALIZER_OPTIONS = exports.materialize = exports.validateSchedule = exports.computeNextRunAt = exports.CorruptStorageRowError = exports.InvalidRetentionOptionsError = exports.InvalidScheduleError = exports.TerminalTaskStatusList = exports.ScheduledTaskStatusList = exports.ScheduledTaskStatus = exports.ScheduledJobKindList = exports.ScheduledJobKind = void 0;
+var enums_1 = require("./enums");
+Object.defineProperty(exports, "ScheduledJobKind", { enumerable: true, get: function () { return enums_1.ScheduledJobKind; } });
+Object.defineProperty(exports, "ScheduledJobKindList", { enumerable: true, get: function () { return enums_1.ScheduledJobKindList; } });
+Object.defineProperty(exports, "ScheduledTaskStatus", { enumerable: true, get: function () { return enums_1.ScheduledTaskStatus; } });
+Object.defineProperty(exports, "ScheduledTaskStatusList", { enumerable: true, get: function () { return enums_1.ScheduledTaskStatusList; } });
+Object.defineProperty(exports, "TerminalTaskStatusList", { enumerable: true, get: function () { return enums_1.TerminalTaskStatusList; } });
+var errors_1 = require("./errors");
+Object.defineProperty(exports, "InvalidScheduleError", { enumerable: true, get: function () { return errors_1.InvalidScheduleError; } });
+Object.defineProperty(exports, "InvalidRetentionOptionsError", { enumerable: true, get: function () { return errors_1.InvalidRetentionOptionsError; } });
+Object.defineProperty(exports, "CorruptStorageRowError", { enumerable: true, get: function () { return errors_1.CorruptStorageRowError; } });
+var next_run_1 = require("./recurrence/next-run");
+Object.defineProperty(exports, "computeNextRunAt", { enumerable: true, get: function () { return next_run_1.computeNextRunAt; } });
+var validate_1 = require("./recurrence/validate");
+Object.defineProperty(exports, "validateSchedule", { enumerable: true, get: function () { return validate_1.validateSchedule; } });
+var materializer_1 = require("./materializer");
+Object.defineProperty(exports, "materialize", { enumerable: true, get: function () { return materializer_1.materialize; } });
+Object.defineProperty(exports, "DEFAULT_MATERIALIZER_OPTIONS", { enumerable: true, get: function () { return materializer_1.DEFAULT_MATERIALIZER_OPTIONS; } });
+var retention_1 = require("./retention");
+Object.defineProperty(exports, "prune", { enumerable: true, get: function () { return retention_1.prune; } });
+Object.defineProperty(exports, "DEFAULT_RETENTION_OPTIONS", { enumerable: true, get: function () { return retention_1.DEFAULT_RETENTION_OPTIONS; } });
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":";;;AAqBA,iCAOiB;AANhB,yGAAA,gBAAgB,OAAA;AAChB,6GAAA,oBAAoB,OAAA;AACpB,4GAAA,mBAAmB,OAAA;AACnB,gHAAA,uBAAuB,OAAA;AAEvB,+GAAA,sBAAsB,OAAA;AAYvB,mCAIkB;AAHjB,8GAAA,oBAAoB,OAAA;AACpB,sHAAA,4BAA4B,OAAA;AAC5B,gHAAA,sBAAsB,OAAA;AAGvB,kDAAyD;AAAhD,4GAAA,gBAAgB,OAAA;AACzB,kDAAyD;AAAhD,4GAAA,gBAAgB,OAAA;AAEzB,+CAA2E;AAAlE,2GAAA,WAAW,OAAA;AAAE,4HAAA,4BAA4B,OAAA;AAclD,yCAA+D;AAAtD,kGAAA,KAAK,OAAA;AAAE,sHAAA,yBAAyB,OAAA"}

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

@@ -0,0 +1,4 @@
+export { materialize, 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';

package/dist/core/materializer/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.planOccurrences = exports.DEFAULT_MATERIALIZER_OPTIONS = exports.materialize = void 0;
+var materialize_1 = require("./materialize");
+Object.defineProperty(exports, "materialize", { enumerable: true, get: function () { return materialize_1.materialize; } });
+var options_1 = require("./options");
+Object.defineProperty(exports, "DEFAULT_MATERIALIZER_OPTIONS", { enumerable: true, get: function () { return options_1.DEFAULT_MATERIALIZER_OPTIONS; } });
+var plan_1 = require("./plan");
+Object.defineProperty(exports, "planOccurrences", { enumerable: true, get: function () { return plan_1.planOccurrences; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,11 @@
+import type { ScheduledJob } from '../types';
+import { type MaterializerOptions } from './options';
+import type { RunInTransaction } from './transaction';
+export type { MaterializerOptions } from './options';
+export interface MaterializerSummary {
+    claimedJobs: number;
+    occurrences: number;
+    deferredJobs: number;
+}
+export type OnJobPlanError = (job: ScheduledJob, error: unknown) => void;
+export declare function materialize(runInTransaction: RunInTransaction, options?: MaterializerOptions, onPlanError?: OnJobPlanError): Promise<MaterializerSummary>;

package/dist/core/materializer/materialize.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+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) {
+    return await runInTransaction(async (tx) => {
+        const claimed = await tx.claimDueJobs(options.batchSize);
+        if (claimed === undefined) {
+            return { claimedJobs: 0, occurrences: 0, deferredJobs: 0 };
+        }
+        const { occurrencesPlanned, numberOfJobsDeferred } = planOrDeferJobs(claimed, options, onPlanError);
+        const occurrences = await tx.recordOccurrences(occurrencesPlanned);
+        await tx.advanceJobs(occurrencesPlanned);
+        return {
+            claimedJobs: claimed.jobs.length,
+            occurrences,
+            deferredJobs: numberOfJobsDeferred,
+        };
+    });
+}
+function planOrDeferJobs(dueJobs, options, onPlanError) {
+    const plans = dueJobs.jobs.map((job) => planOrDeferJob(job, dueJobs.now, options, onPlanError));
+    return {
+        occurrencesPlanned: plans.map(({ plannedJob }) => plannedJob),
+        numberOfJobsDeferred: plans.filter(({ deferred }) => deferred).length,
+    };
+}
+function planOrDeferJob(job, now, options, onPlanError) {
+    try {
+        return {
+            plannedJob: { job, plan: (0, plan_1.planOccurrences)(job, now, options) },
+            deferred: false,
+        };
+    }
+    catch (error) {
+        onPlanError?.(job, error);
+        const retryAt = new Date(now.getTime() + options.planRetrySeconds * constants_1.Time.seconds.toMilliseconds);
+        return {
+            plannedJob: {
+                job,
+                plan: { occurrences: [], nextRunAt: retryAt, lastFiredAt: job.lastFiredAt },
+            },
+            deferred: true,
+        };
+    }
+}
+//# sourceMappingURL=materialize.js.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,7 @@
+export interface MaterializerOptions {
+    windowSeconds: number;
+    maxPerJob: number;
+    batchSize: number;
+    planRetrySeconds: number;
+}
+export declare const DEFAULT_MATERIALIZER_OPTIONS: MaterializerOptions;

package/dist/core/materializer/options.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_MATERIALIZER_OPTIONS = void 0;
+const constants_1 = require("@n8n/constants");
+exports.DEFAULT_MATERIALIZER_OPTIONS = {
+    windowSeconds: 60,
+    batchSize: 100,
+    maxPerJob: 1000,
+    planRetrySeconds: constants_1.Time.hours.toSeconds,
+};
+//# sourceMappingURL=options.js.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,10 @@
+import type { ScheduledJob } from '../types';
+export interface OccurrencePlan {
+    occurrences: Date[];
+    nextRunAt: Date | null;
+    lastFiredAt: Date | null;
+}
+export declare function planOccurrences(job: ScheduledJob, now: Date, options: {
+    windowSeconds: number;
+    maxPerJob: number;
+}): OccurrencePlan;

package/dist/core/materializer/plan.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.planOccurrences = planOccurrences;
+const constants_1 = require("@n8n/constants");
+const next_run_1 = require("../recurrence/next-run");
+function planOccurrences(job, now, options) {
+    const windowEnd = now.getTime() + options.windowSeconds * constants_1.Time.seconds.toMilliseconds;
+    const occurrences = [];
+    let cursor = job.nextRunAt;
+    while (cursor !== null &&
+        cursor.getTime() <= windowEnd &&
+        occurrences.length < options.maxPerJob) {
+        occurrences.push(cursor);
+        cursor = (0, next_run_1.computeNextRunAt)(job.schedule, cursor);
+    }
+    return {
+        occurrences,
+        nextRunAt: cursor,
+        lastFiredAt: occurrences.at(-1) ?? job.lastFiredAt,
+    };
+}
+//# sourceMappingURL=plan.js.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,16 @@
+import type { OccurrencePlan } from './plan';
+import type { ScheduledJob } from '../types';
+export interface PlannedJob {
+    job: ScheduledJob;
+    plan: OccurrencePlan;
+}
+export interface DueJobs {
+    now: Date;
+    jobs: ScheduledJob[];
+}
+export interface MaterializerTransaction {
+    claimDueJobs(limit: number): Promise<DueJobs | undefined>;
+    recordOccurrences(planned: PlannedJob[]): Promise<number>;
+    advanceJobs(planned: PlannedJob[]): Promise<void>;
+}
+export type RunInTransaction = <T>(work: (tx: MaterializerTransaction) => Promise<T>) => Promise<T>;

package/dist/core/materializer/transaction.js

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

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

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

package/dist/core/recurrence/next-run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"next-run.js","sourceRoot":"","sources":["../../../src/core/recurrence/next-run.ts"],"names":[],"mappings":";;AAwDA,4CAsBC;AA9ED,6CAAmD;AAEnD,sCAAiD;AAEjD,yCAA8C;AAE9C,MAAM,aAAa,GAAG,IAAI,CAAC;AAU3B,SAAS,WAAW,CAAC,QAAsB,EAAE,KAAW,EAAE,QAAgB;IACzE,IAAI,CAAC;QACJ,MAAM,EAAE,GAAG,kCAAoB,CAAC,KAAK,CAAC,QAAQ,CAAC,cAAc,EAAE;YAC9D,WAAW,EAAE,KAAK;YAClB,EAAE,EAAE,QAAQ;SACZ,CAAC,CAAC;QACH,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,CAAC;IAC3B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,MAAM,IAAI,6BAAoB,CAC7B,sCAAsC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,cAAc,CAAC,gBAAgB,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAM,KAAe,CAAC,OAAO,EAAE,CACpJ,CAAC;IACH,CAAC;AACF,CAAC;AAOD,SAAS,eAAe,CAAC,QAA0B,EAAE,KAAW;IAC/D,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,QAAQ,CAAC,eAAe,GAAG,aAAa,CAAC,CAAC;AAC7E,CAAC;AAGD,SAAS,aAAa,CAAC,QAAwB,EAAE,KAAW;IAC3D,OAAO,KAAK,CAAC,OAAO,EAAE,GAAG,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;AAC7E,CAAC;AAcD,SAAgB,gBAAgB,CAAC,QAAkB,EAAE,KAAW;IAC/D,IAAA,2BAAgB,EAAC,QAAQ,CAAC,CAAC;IAE3B,QAAQ,QAAQ,CAAC,IAAI,EAAE,CAAC;QACvB,KAAK,MAAM;YACV,IAAI,QAAQ,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;gBAChC,MAAM,IAAI,6BAAoB,CAC7B,2FAA2F,CAC3F,CAAC;YACH,CAAC;YACD,OAAO,WAAW,CAAC,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACxD,KAAK,UAAU;YACd,OAAO,eAAe,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QACzC,KAAK,SAAS;YACb,OAAO,aAAa,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QACvC,OAAO,CAAC,CAAC,CAAC;YACT,MAAM,UAAU,GAAU,QAAQ,CAAC;YACnC,MAAM,IAAI,6BAAoB,CAC7B,0BAA0B,IAAI,CAAC,SAAS,CAAE,UAAuB,CAAC,IAAI,CAAC,EAAE,CACzE,CAAC;QACH,CAAC;IACF,CAAC;AACF,CAAC"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../../src/core/recurrence/validate.ts"],"names":[],"mappings":";;AA8DA,4CAeC;AA7ED,6CAAmD;AACnD,iCAAiC;AAEjC,sCAAiD;AAIjD,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAE3B,SAAS,YAAY,CAAC,QAAsB;IAG3C,MAAM,UAAU,GAAY,QAAQ,CAAC,cAAc,CAAC;IACpD,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;QACpC,MAAM,IAAI,6BAAoB,CAC7B,6CAA6C,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,CACzE,CAAC;IACH,CAAC;IAED,MAAM,UAAU,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC;IACzD,IAAI,UAAU,KAAK,gBAAgB,EAAE,CAAC;QACrC,MAAM,IAAI,6BAAoB,CAC7B,6BAA6B,gBAAgB,mCAAmC,UAAU,KAAK,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,CAC3H,CAAC;IACH,CAAC;IAGD,IAAI,QAAQ,CAAC,QAAQ,KAAK,IAAI,IAAI,CAAC,gBAAQ,CAAC,WAAW,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5E,MAAM,IAAI,6BAAoB,CAAC,0BAA0B,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC/F,CAAC;IAED,IAAI,CAAC;QACJ,kCAAoB,CAAC,KAAK,CAAC,UAAU,EAAE;YACtC,EAAE,EAAE,QAAQ,CAAC,QAAQ,IAAI,KAAK;SAC9B,CAAC,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,MAAM,IAAI,6BAAoB,CAC7B,2BAA2B,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,KAAM,KAAe,CAAC,OAAO,EAAE,CACpF,CAAC;IACH,CAAC;AACF,CAAC;AAED,SAAS,gBAAgB,CAAC,QAA0B;IACnD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,eAAe,CAAC,IAAI,QAAQ,CAAC,eAAe,IAAI,CAAC,EAAE,CAAC;QAClF,MAAM,IAAI,6BAAoB,CAC7B,4DAA4D,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,CACtG,CAAC;IACH,CAAC;AACF,CAAC;AAED,SAAS,cAAc,CAAC,QAAwB;IAC/C,MAAM,MAAM,GAAY,QAAQ,CAAC,MAAM,CAAC;IACxC,IAAI,CAAC,CAAC,MAAM,YAAY,IAAI,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;QACjE,MAAM,IAAI,6BAAoB,CAAC,qCAAqC,CAAC,CAAC;IACvE,CAAC;AACF,CAAC;AAOD,SAAgB,gBAAgB,CAAC,QAAkB;IAClD,QAAQ,QAAQ,CAAC,IAAI,EAAE,CAAC;QACvB,KAAK,MAAM;YACV,OAAO,YAAY,CAAC,QAAQ,CAAC,CAAC;QAC/B,KAAK,UAAU;YACd,OAAO,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QACnC,KAAK,SAAS;YACb,OAAO,cAAc,CAAC,QAAQ,CAAC,CAAC;QACjC,OAAO,CAAC,CAAC,CAAC;YACT,MAAM,UAAU,GAAU,QAAQ,CAAC;YACnC,MAAM,IAAI,6BAAoB,CAC7B,0BAA0B,IAAI,CAAC,SAAS,CAAE,UAAuB,CAAC,IAAI,CAAC,EAAE,CACzE,CAAC;QACH,CAAC;IACF,CAAC;AACF,CAAC"}

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

@@ -0,0 +1,3 @@
+export { prune, type RetentionSummary } from './prune';
+export { DEFAULT_RETENTION_OPTIONS, type RetentionOptions } from './options';
+export type { RetentionBatch, RetentionStore } from './store';

package/dist/core/retention/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_RETENTION_OPTIONS = exports.prune = void 0;
+var prune_1 = require("./prune");
+Object.defineProperty(exports, "prune", { enumerable: true, get: function () { return prune_1.prune; } });
+var options_1 = require("./options");
+Object.defineProperty(exports, "DEFAULT_RETENTION_OPTIONS", { enumerable: true, get: function () { return options_1.DEFAULT_RETENTION_OPTIONS; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/retention/index.ts"],"names":[],"mappings":";;;AAAA,iCAAuD;AAA9C,8FAAA,KAAK,OAAA;AACd,qCAA6E;AAApE,oHAAA,yBAAyB,OAAA"}

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

@@ -0,0 +1,7 @@
+export interface RetentionOptions {
+    retentionSeconds: number;
+    failedRetentionSeconds: number;
+    batchSize: number;
+    maxBatchesPerPass: number;
+}
+export declare const DEFAULT_RETENTION_OPTIONS: RetentionOptions;

package/dist/core/retention/options.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_RETENTION_OPTIONS = void 0;
+const constants_1 = require("@n8n/constants");
+exports.DEFAULT_RETENTION_OPTIONS = {
+    retentionSeconds: constants_1.Time.days.toSeconds,
+    failedRetentionSeconds: 7 * constants_1.Time.days.toSeconds,
+    batchSize: 1000,
+    maxBatchesPerPass: 1000,
+};
+//# sourceMappingURL=options.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../../src/core/retention/options.ts"],"names":[],"mappings":";;;AAAA,8CAAsC;AAgCzB,QAAA,yBAAyB,GAAqB;IAC1D,gBAAgB,EAAE,gBAAI,CAAC,IAAI,CAAC,SAAS;IACrC,sBAAsB,EAAE,CAAC,GAAG,gBAAI,CAAC,IAAI,CAAC,SAAS;IAC/C,SAAS,EAAE,IAAI;IACf,iBAAiB,EAAE,IAAI;CACvB,CAAC"}

package/dist/core/retention/prune.d.ts

@@ -0,0 +1,7 @@
+import { type RetentionOptions } from './options';
+import type { RetentionStore } from './store';
+export interface RetentionSummary {
+    deleted: number;
+    drained: boolean;
+}
+export declare function prune(store: RetentionStore, options?: RetentionOptions): Promise<RetentionSummary>;

package/dist/core/retention/prune.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.prune = prune;
+const constants_1 = require("@n8n/constants");
+const enums_1 = require("../enums");
+const errors_1 = require("../errors");
+const options_1 = require("./options");
+function retentionWindows(options) {
+    return [
+        {
+            statuses: [enums_1.ScheduledTaskStatus.Succeeded, enums_1.ScheduledTaskStatus.Cancelled],
+            olderThanSeconds: options.retentionSeconds,
+        },
+        {
+            statuses: [enums_1.ScheduledTaskStatus.Failed, enums_1.ScheduledTaskStatus.Missed],
+            olderThanSeconds: options.failedRetentionSeconds,
+        },
+    ];
+}
+async function prune(store, options = options_1.DEFAULT_RETENTION_OPTIONS) {
+    if (!Number.isInteger(options.batchSize) || options.batchSize <= 0) {
+        throw new errors_1.InvalidRetentionOptionsError(`batchSize must be a positive integer, got ${options.batchSize}`);
+    }
+    const { deleted, drained } = await pruneWindows(store, retentionWindows(options), options, {
+        deleted: 0,
+        budget: options.maxBatchesPerPass,
+        drained: true,
+    });
+    return { deleted, drained };
+}
+async function pruneWindows(store, windows, options, state) {
+    const [window, ...rest] = windows;
+    if (window === undefined) {
+        return state;
+    }
+    const windowBudget = state.budget <= 0 ? 0 : Math.max(state.budget - rest.length, 1);
+    const pruned = await pruneWindow(store, window, options.batchSize, windowBudget);
+    return await pruneWindows(store, rest, options, {
+        deleted: state.deleted + pruned.deleted,
+        budget: state.budget - pruned.batches,
+        drained: state.drained && pruned.drained,
+    });
+}
+async function pruneWindow(store, window, batchSize, budget) {
+    let deleted = 0;
+    let batches = 0;
+    while (batches < budget) {
+        const affected = await store.deleteFinishedOlderThan({
+            statuses: window.statuses,
+            olderThanMs: window.olderThanSeconds * constants_1.Time.seconds.toMilliseconds,
+            limit: batchSize,
+        });
+        batches += 1;
+        deleted += affected;
+        if (affected < batchSize) {
+            return { deleted, batches, drained: true };
+        }
+    }
+    return { deleted, batches, drained: false };
+}
+//# sourceMappingURL=prune.js.map

package/dist/core/retention/prune.js.map

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

package/dist/core/retention/store.d.ts

@@ -0,0 +1,9 @@
+import type { TerminalTaskStatus } from '../enums';
+export interface RetentionBatch {
+    statuses: TerminalTaskStatus[];
+    olderThanMs: number;
+    limit: number;
+}
+export interface RetentionStore {
+    deleteFinishedOlderThan(batch: RetentionBatch): Promise<number>;
+}

package/dist/{storage/storage.js → core/retention/store.js}

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

package/dist/core/retention/store.js.map

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

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

@@ -0,0 +1,2 @@
+export type * from './schedule';
+export type * from './task';

package/dist/core/types/index.js

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

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

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

package/dist/{types → core/types}/schedule.d.ts

@@ -1,6 +1,4 @@
 import type { CronExpression } from 'n8n-workflow';
-export declare const ScheduleKindList: readonly ["cron", "interval", "one_off"];
-export type ScheduleKind = (typeof ScheduleKindList)[number];
 export interface CronSchedule {
     kind: 'cron';
     cronExpression: CronExpression;
@@ -17,8 +15,11 @@ export interface OneOffSchedule {
 export type Schedule = CronSchedule | IntervalSchedule | OneOffSchedule;
 export interface ScheduledJob {
     id: string;
+    taskType: string;
+    payload: Record<string, unknown>;
     schedule: Schedule;
     enabled: boolean;
     nextRunAt: Date | null;
     lastFiredAt: Date | null;
+    maxAttempts: number;
 }

package/dist/core/types/schedule.js

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

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

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

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

@@ -0,0 +1,18 @@
+import type { ScheduledTaskStatus } from '../enums';
+export interface ScheduledTask {
+    id: string;
+    jobId: string;
+    taskType: string;
+    payload: Record<string, unknown>;
+    scheduledFor: Date;
+    runAt: Date;
+    status: ScheduledTaskStatus;
+    attempts: number;
+    maxAttempts: number;
+}
+export interface ClaimedTask extends ScheduledTask {
+    claimedBy: string;
+    leaseExpiresAt: Date;
+    leaseEpoch: number;
+    startedAt: Date | null;
+}

package/dist/core/types/task.js

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

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

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

package/dist/executor/backoff.d.ts

@@ -0,0 +1,6 @@
+export interface BackoffOptions {
+    baseMs?: number;
+    factor?: number;
+    maxMs?: number;
+}
+export declare function backoff(attempts: number, opts?: BackoffOptions): number;

package/dist/executor/backoff.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.backoff = backoff;
+const constants_1 = require("@n8n/constants");
+const DEFAULT_BASE_MS = 5 * constants_1.Time.seconds.toMilliseconds;
+const DEFAULT_FACTOR = 2;
+const DEFAULT_MAX_MS = 5 * constants_1.Time.minutes.toMilliseconds;
+function backoff(attempts, opts = {}) {
+    const { baseMs = DEFAULT_BASE_MS, factor = DEFAULT_FACTOR, maxMs = DEFAULT_MAX_MS } = opts;
+    if (attempts < 1)
+        return 0;
+    const raw = baseMs * factor ** (attempts - 1);
+    return Math.min(raw, maxMs);
+}
+//# sourceMappingURL=backoff.js.map

package/dist/executor/backoff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backoff.js","sourceRoot":"","sources":["../../src/executor/backoff.ts"],"names":[],"mappings":";;AAuBA,0BAKC;AA5BD,8CAAsC;AAmBtC,MAAM,eAAe,GAAG,CAAC,GAAG,gBAAI,CAAC,OAAO,CAAC,cAAc,CAAC;AACxD,MAAM,cAAc,GAAG,CAAC,CAAC;AACzB,MAAM,cAAc,GAAG,CAAC,GAAG,gBAAI,CAAC,OAAO,CAAC,cAAc,CAAC;AAEvD,SAAgB,OAAO,CAAC,QAAgB,EAAE,OAAuB,EAAE;IAClE,MAAM,EAAE,MAAM,GAAG,eAAe,EAAE,MAAM,GAAG,cAAc,EAAE,KAAK,GAAG,cAAc,EAAE,GAAG,IAAI,CAAC;IAC3F,IAAI,QAAQ,GAAG,CAAC;QAAE,OAAO,CAAC,CAAC;IAC3B,MAAM,GAAG,GAAG,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;IAC9C,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;AAC7B,CAAC"}

package/dist/executor/executor.d.ts

@@ -0,0 +1,23 @@
+import type { Logger } from '@n8n/backend-common';
+import type { SchedulerConfig } from '@n8n/config';
+import type { ScheduledTaskRepository } from '@n8n/db';
+import type { PrecisionTimer } from './precision-timer';
+import type { TaskHandlerRegistry } from './task-handler';
+import type { ClaimedTask } from '../core/types';
+export declare class Executor {
+    private readonly taskRepository;
+    private readonly registry;
+    private readonly timer;
+    private readonly leaseMs;
+    private readonly lookaheadMs;
+    private readonly batchSize;
+    private readonly logger;
+    private readonly claimedTaskById;
+    constructor(taskRepository: ScheduledTaskRepository, registry: TaskHandlerRegistry, timer: PrecisionTimer, logger: Logger, config: SchedulerConfig);
+    claimAndSchedule(host: string): Promise<ClaimedTask[]>;
+    private scheduleClaimed;
+    fire(host: string, task: ClaimedTask): Promise<void>;
+    private releaseUnmappableRow;
+    private releaseClaimBestEffort;
+    stop(): Promise<void>;
+}