@n8n/scheduler 0.2.3 → 0.3.1

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

@@ -1,3 +1,4 @@
+import type { ScheduledJobKind, RecurringCronUnit } from '@n8n/constants';
 import type { CronExpression } from 'n8n-workflow';
 export interface CronSchedule {
     kind: 'cron';
@@ -12,13 +13,25 @@ export interface OneOffSchedule {
     kind: 'one_off';
     fireAt: Date;
 }
-export type Schedule = CronSchedule | IntervalSchedule | OneOffSchedule;
+export interface RecurringCronSchedule {
+    kind: 'recurring_cron';
+    cronExpression: CronExpression;
+    timezone: string | null;
+    recurrenceUnit: RecurringCronUnit;
+    recurrenceSize: number;
+}
+export type Schedule = CronSchedule | IntervalSchedule | OneOffSchedule | RecurringCronSchedule;
 export interface ScheduledJob {
-    id: string;
+    id: number;
     taskType: string;
     payload: Record<string, unknown>;
-    schedule: Schedule;
-    enabled: boolean;
+    kind: ScheduledJobKind;
+    cronExpression: string | null;
+    timezone: string | null;
+    intervalSeconds: number | null;
+    fireAt: Date | null;
+    recurrenceUnit: RecurringCronUnit | null;
+    recurrenceSize: number | null;
     nextRunAt: Date | null;
     lastFiredAt: Date | null;
     maxAttempts: number;

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

@@ -1,7 +1,7 @@
-import type { ScheduledTaskStatus } from '../enums';
+import type { ScheduledTaskStatus } from '@n8n/constants';
 export interface ScheduledTask {
     id: string;
-    jobId: string;
+    jobId: number;
     taskType: string;
     payload: Record<string, unknown>;
     scheduledFor: Date;
@@ -11,8 +11,5 @@ export interface ScheduledTask {
     maxAttempts: number;
 }
 export interface ClaimedTask extends ScheduledTask {
-    claimedBy: string;
-    leaseExpiresAt: Date;
     leaseEpoch: number;
-    startedAt: Date | null;
 }

package/dist/observability/attributes.d.ts

@@ -0,0 +1,41 @@
+import type { ClaimedTask } from '../core/types';
+export declare const SCHEDULER_ATTRIBUTES: {
+    readonly taskId: "n8n.scheduler.task_id";
+    readonly jobId: "n8n.scheduler.job_id";
+    readonly taskType: "n8n.scheduler.task_type";
+    readonly host: "n8n.scheduler.host";
+    readonly leaseEpoch: "n8n.scheduler.lease_epoch";
+    readonly scheduledFor: "n8n.scheduler.scheduled_for";
+    readonly runAt: "n8n.scheduler.run_at";
+    readonly attempts: "n8n.scheduler.attempts";
+    readonly maxAttempts: "n8n.scheduler.max_attempts";
+    readonly outcome: "n8n.scheduler.outcome";
+    readonly claimedCount: "n8n.scheduler.claimed_count";
+    readonly reclaimed: "n8n.scheduler.reclaimed";
+    readonly deadLettered: "n8n.scheduler.dead_lettered";
+    readonly claimedJobs: "n8n.scheduler.claimed_jobs";
+    readonly occurrences: "n8n.scheduler.occurrences";
+    readonly deferredJobs: "n8n.scheduler.deferred_jobs";
+    readonly retentionDeleted: "n8n.scheduler.retention_deleted";
+    readonly retentionDrained: "n8n.scheduler.retention_drained";
+    readonly provisionInserted: "n8n.scheduler.provision_inserted";
+    readonly provisionRedefined: "n8n.scheduler.provision_redefined";
+    readonly provisionUnchanged: "n8n.scheduler.provision_unchanged";
+    readonly provisionRemoved: "n8n.scheduler.provision_removed";
+    readonly deprovisionRemoved: "n8n.scheduler.deprovision_removed";
+    readonly jobName: "n8n.scheduler.job_name";
+    readonly jobAction: "n8n.scheduler.job_action";
+};
+export declare const SCHEDULER_PROVISION_ACTION: {
+    readonly inserted: "inserted";
+    readonly redefined: "redefined";
+    readonly removed: "removed";
+};
+export declare const SCHEDULER_FIRE_OUTCOME: {
+    readonly completed: "completed";
+    readonly rescheduled: "rescheduled";
+    readonly deadLettered: "dead_lettered";
+    readonly skippedNoHandler: "skipped_no_handler";
+    readonly skippedNotOwned: "skipped_not_owned";
+};
+export declare function pickSchedulerTaskAttributes(task: ClaimedTask): Record<string, string | number>;

package/dist/observability/attributes.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SCHEDULER_FIRE_OUTCOME = exports.SCHEDULER_PROVISION_ACTION = exports.SCHEDULER_ATTRIBUTES = void 0;
+exports.pickSchedulerTaskAttributes = pickSchedulerTaskAttributes;
+exports.SCHEDULER_ATTRIBUTES = {
+    taskId: 'n8n.scheduler.task_id',
+    jobId: 'n8n.scheduler.job_id',
+    taskType: 'n8n.scheduler.task_type',
+    host: 'n8n.scheduler.host',
+    leaseEpoch: 'n8n.scheduler.lease_epoch',
+    scheduledFor: 'n8n.scheduler.scheduled_for',
+    runAt: 'n8n.scheduler.run_at',
+    attempts: 'n8n.scheduler.attempts',
+    maxAttempts: 'n8n.scheduler.max_attempts',
+    outcome: 'n8n.scheduler.outcome',
+    claimedCount: 'n8n.scheduler.claimed_count',
+    reclaimed: 'n8n.scheduler.reclaimed',
+    deadLettered: 'n8n.scheduler.dead_lettered',
+    claimedJobs: 'n8n.scheduler.claimed_jobs',
+    occurrences: 'n8n.scheduler.occurrences',
+    deferredJobs: 'n8n.scheduler.deferred_jobs',
+    retentionDeleted: 'n8n.scheduler.retention_deleted',
+    retentionDrained: 'n8n.scheduler.retention_drained',
+    provisionInserted: 'n8n.scheduler.provision_inserted',
+    provisionRedefined: 'n8n.scheduler.provision_redefined',
+    provisionUnchanged: 'n8n.scheduler.provision_unchanged',
+    provisionRemoved: 'n8n.scheduler.provision_removed',
+    deprovisionRemoved: 'n8n.scheduler.deprovision_removed',
+    jobName: 'n8n.scheduler.job_name',
+    jobAction: 'n8n.scheduler.job_action',
+};
+exports.SCHEDULER_PROVISION_ACTION = {
+    inserted: 'inserted',
+    redefined: 'redefined',
+    removed: 'removed',
+};
+exports.SCHEDULER_FIRE_OUTCOME = {
+    completed: 'completed',
+    rescheduled: 'rescheduled',
+    deadLettered: 'dead_lettered',
+    skippedNoHandler: 'skipped_no_handler',
+    skippedNotOwned: 'skipped_not_owned',
+};
+function pickSchedulerTaskAttributes(task) {
+    return {
+        [exports.SCHEDULER_ATTRIBUTES.taskId]: task.id,
+        [exports.SCHEDULER_ATTRIBUTES.jobId]: task.jobId,
+        [exports.SCHEDULER_ATTRIBUTES.taskType]: task.taskType,
+        [exports.SCHEDULER_ATTRIBUTES.leaseEpoch]: task.leaseEpoch,
+        [exports.SCHEDULER_ATTRIBUTES.attempts]: task.attempts,
+        [exports.SCHEDULER_ATTRIBUTES.maxAttempts]: task.maxAttempts,
+        [exports.SCHEDULER_ATTRIBUTES.scheduledFor]: task.scheduledFor.toISOString(),
+        [exports.SCHEDULER_ATTRIBUTES.runAt]: task.runAt.toISOString(),
+    };
+}
+//# sourceMappingURL=attributes.js.map

package/dist/observability/attributes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attributes.js","sourceRoot":"","sources":["../../src/observability/attributes.ts"],"names":[],"mappings":";;;AAsEA,kEAWC;AA3EY,QAAA,oBAAoB,GAAG;IACnC,MAAM,EAAE,uBAAuB;IAC/B,KAAK,EAAE,sBAAsB;IAC7B,QAAQ,EAAE,yBAAyB;IACnC,IAAI,EAAE,oBAAoB;IAC1B,UAAU,EAAE,2BAA2B;IACvC,YAAY,EAAE,6BAA6B;IAC3C,KAAK,EAAE,sBAAsB;IAC7B,QAAQ,EAAE,wBAAwB;IAClC,WAAW,EAAE,4BAA4B;IACzC,OAAO,EAAE,uBAAuB;IAChC,YAAY,EAAE,6BAA6B;IAC3C,SAAS,EAAE,yBAAyB;IACpC,YAAY,EAAE,6BAA6B;IAC3C,WAAW,EAAE,4BAA4B;IACzC,WAAW,EAAE,2BAA2B;IACxC,YAAY,EAAE,6BAA6B;IAC3C,gBAAgB,EAAE,iCAAiC;IACnD,gBAAgB,EAAE,iCAAiC;IACnD,iBAAiB,EAAE,kCAAkC;IACrD,kBAAkB,EAAE,mCAAmC;IACvD,kBAAkB,EAAE,mCAAmC;IACvD,gBAAgB,EAAE,iCAAiC;IACnD,kBAAkB,EAAE,mCAAmC;IACvD,OAAO,EAAE,wBAAwB;IACjC,SAAS,EAAE,0BAA0B;CAC5B,CAAC;AAOE,QAAA,0BAA0B,GAAG;IAEzC,QAAQ,EAAE,UAAU;IAEpB,SAAS,EAAE,WAAW;IAEtB,OAAO,EAAE,SAAS;CACT,CAAC;AAOE,QAAA,sBAAsB,GAAG;IAErC,SAAS,EAAE,WAAW;IAEtB,WAAW,EAAE,aAAa;IAE1B,YAAY,EAAE,eAAe;IAE7B,gBAAgB,EAAE,oBAAoB;IAEtC,eAAe,EAAE,mBAAmB;CAC3B,CAAC;AAMX,SAAgB,2BAA2B,CAAC,IAAiB;IAC5D,OAAO;QACN,CAAC,4BAAoB,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,EAAE;QACtC,CAAC,4BAAoB,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,KAAK;QACxC,CAAC,4BAAoB,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,QAAQ;QAC9C,CAAC,4BAAoB,CAAC,UAAU,CAAC,EAAE,IAAI,CAAC,UAAU;QAClD,CAAC,4BAAoB,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,QAAQ;QAC9C,CAAC,4BAAoB,CAAC,WAAW,CAAC,EAAE,IAAI,CAAC,WAAW;QACpD,CAAC,4BAAoB,CAAC,YAAY,CAAC,EAAE,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE;QACpE,CAAC,4BAAoB,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE;KACtD,CAAC;AACH,CAAC"}

package/dist/observability/executor-tracing.d.ts

@@ -0,0 +1,4 @@
+import { type Tracer } from './tracer';
+import type { ExecutorTracing, TaskHandler } from '../core/executor';
+export declare function createExecutorTracing(tracer: Tracer): ExecutorTracing;
+export declare function withHandoffTracing(tracer: Tracer, handler: TaskHandler): TaskHandler;

package/dist/observability/executor-tracing.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createExecutorTracing = createExecutorTracing;
+exports.withHandoffTracing = withHandoffTracing;
+const attributes_1 = require("./attributes");
+const tracer_1 = require("./tracer");
+function createExecutorTracing(tracer) {
+    return {
+        async fire(host, task, run) {
+            return await tracer.startSpan({
+                name: 'Scheduler fire',
+                op: 'scheduler.fire',
+                attributes: { ...(0, attributes_1.pickSchedulerTaskAttributes)(task), [attributes_1.SCHEDULER_ATTRIBUTES.host]: host },
+                newTrace: true,
+            }, async (span) => {
+                const result = await run();
+                span.setAttribute(attributes_1.SCHEDULER_ATTRIBUTES.outcome, fireOutcomeAttribute(result.outcome));
+                if ('errorMessage' in result) {
+                    span.setStatus({ code: tracer_1.SpanStatus.error, message: result.errorMessage });
+                }
+                else {
+                    span.setStatus({ code: tracer_1.SpanStatus.ok });
+                }
+                return result;
+            });
+        },
+    };
+}
+function withHandoffTracing(tracer, handler) {
+    return {
+        async execute(task) {
+            await tracer.startSpan({
+                name: 'Scheduler handoff',
+                op: 'scheduler.handoff',
+                attributes: {
+                    [attributes_1.SCHEDULER_ATTRIBUTES.taskId]: task.id,
+                    [attributes_1.SCHEDULER_ATTRIBUTES.jobId]: task.jobId,
+                    [attributes_1.SCHEDULER_ATTRIBUTES.taskType]: task.taskType,
+                },
+            }, async (span) => {
+                await handler.execute(task);
+                span.setStatus({ code: tracer_1.SpanStatus.ok });
+            });
+        },
+    };
+}
+function fireOutcomeAttribute(outcome) {
+    switch (outcome) {
+        case 'completed':
+            return attributes_1.SCHEDULER_FIRE_OUTCOME.completed;
+        case 'rescheduled':
+            return attributes_1.SCHEDULER_FIRE_OUTCOME.rescheduled;
+        case 'dead-lettered':
+            return attributes_1.SCHEDULER_FIRE_OUTCOME.deadLettered;
+        case 'skipped-no-handler':
+            return attributes_1.SCHEDULER_FIRE_OUTCOME.skippedNoHandler;
+        case 'skipped-not-owned':
+            return attributes_1.SCHEDULER_FIRE_OUTCOME.skippedNotOwned;
+    }
+}
+//# sourceMappingURL=executor-tracing.js.map

package/dist/observability/executor-tracing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor-tracing.js","sourceRoot":"","sources":["../../src/observability/executor-tracing.ts"],"names":[],"mappings":";;AAoBA,sDA6BC;AAgBD,gDAoBC;AArFD,6CAIsB;AACtB,qCAAmD;AAenD,SAAgB,qBAAqB,CAAC,MAAc;IACnD,OAAO;QACN,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG;YACzB,OAAO,MAAM,MAAM,CAAC,SAAS,CAC5B;gBACC,IAAI,EAAE,gBAAgB;gBACtB,EAAE,EAAE,gBAAgB;gBACpB,UAAU,EAAE,EAAE,GAAG,IAAA,wCAA2B,EAAC,IAAI,CAAC,EAAE,CAAC,iCAAoB,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE;gBAKvF,QAAQ,EAAE,IAAI;aACd,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;gBAGd,MAAM,MAAM,GAAG,MAAM,GAAG,EAAE,CAAC;gBAC3B,IAAI,CAAC,YAAY,CAAC,iCAAoB,CAAC,OAAO,EAAE,oBAAoB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;gBACtF,IAAI,cAAc,IAAI,MAAM,EAAE,CAAC;oBAC9B,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,mBAAU,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC;gBAC1E,CAAC;qBAAM,CAAC;oBACP,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,mBAAU,CAAC,EAAE,EAAE,CAAC,CAAC;gBACzC,CAAC;gBACD,OAAO,MAAM,CAAC;YACf,CAAC,CACD,CAAC;QACH,CAAC;KACD,CAAC;AACH,CAAC;AAgBD,SAAgB,kBAAkB,CAAC,MAAc,EAAE,OAAoB;IACtE,OAAO;QACN,KAAK,CAAC,OAAO,CAAC,IAAI;YACjB,MAAM,MAAM,CAAC,SAAS,CACrB;gBACC,IAAI,EAAE,mBAAmB;gBACzB,EAAE,EAAE,mBAAmB;gBACvB,UAAU,EAAE;oBACX,CAAC,iCAAoB,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,EAAE;oBACtC,CAAC,iCAAoB,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,KAAK;oBACxC,CAAC,iCAAoB,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,QAAQ;iBAC9C;aACD,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;gBACd,MAAM,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;gBAC5B,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,mBAAU,CAAC,EAAE,EAAE,CAAC,CAAC;YACzC,CAAC,CACD,CAAC;QACH,CAAC;KACD,CAAC;AACH,CAAC;AAKD,SAAS,oBAAoB,CAAC,OAA8B;IAC3D,QAAQ,OAAO,EAAE,CAAC;QACjB,KAAK,WAAW;YACf,OAAO,mCAAsB,CAAC,SAAS,CAAC;QACzC,KAAK,aAAa;YACjB,OAAO,mCAAsB,CAAC,WAAW,CAAC;QAC3C,KAAK,eAAe;YACnB,OAAO,mCAAsB,CAAC,YAAY,CAAC;QAC5C,KAAK,oBAAoB;YACxB,OAAO,mCAAsB,CAAC,gBAAgB,CAAC;QAChD,KAAK,mBAAmB;YACvB,OAAO,mCAAsB,CAAC,eAAe,CAAC;IAChD,CAAC;AACF,CAAC"}

package/dist/observability/materializer-tracing.d.ts

@@ -0,0 +1,3 @@
+import { type Tracer } from './tracer';
+import type { RecordedOccurrence } from '../core/materializer';
+export declare function traceCreatedTasks(tracer: Tracer, created: RecordedOccurrence[]): Promise<void>;

package/dist/observability/materializer-tracing.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.traceCreatedTasks = traceCreatedTasks;
+const attributes_1 = require("./attributes");
+const tracer_1 = require("./tracer");
+async function traceCreatedTasks(tracer, created) {
+    for (const task of created) {
+        await tracer.startSpan({
+            name: 'Scheduler task created',
+            op: 'scheduler.task.create',
+            attributes: {
+                [attributes_1.SCHEDULER_ATTRIBUTES.taskId]: task.id,
+                [attributes_1.SCHEDULER_ATTRIBUTES.jobId]: task.jobId,
+                [attributes_1.SCHEDULER_ATTRIBUTES.taskType]: task.taskType,
+            },
+        }, async (span) => {
+            span.setStatus({ code: tracer_1.SpanStatus.ok });
+            await Promise.resolve();
+        });
+    }
+}
+//# sourceMappingURL=materializer-tracing.js.map

package/dist/observability/materializer-tracing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"materializer-tracing.js","sourceRoot":"","sources":["../../src/observability/materializer-tracing.ts"],"names":[],"mappings":";;AAgBA,8CAqBC;AArCD,6CAAoD;AACpD,qCAAmD;AAe5C,KAAK,UAAU,iBAAiB,CACtC,MAAc,EACd,OAA6B;IAE7B,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,MAAM,CAAC,SAAS,CACrB;YACC,IAAI,EAAE,wBAAwB;YAC9B,EAAE,EAAE,uBAAuB;YAC3B,UAAU,EAAE;gBACX,CAAC,iCAAoB,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,EAAE;gBACtC,CAAC,iCAAoB,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,KAAK;gBACxC,CAAC,iCAAoB,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,QAAQ;aAC9C;SACD,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;YACd,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,mBAAU,CAAC,EAAE,EAAE,CAAC,CAAC;YACxC,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;QACzB,CAAC,CACD,CAAC;IACH,CAAC;AACF,CAAC"}

package/dist/observability/metrics.d.ts

@@ -0,0 +1,11 @@
+export interface SchedulerMetrics {
+    recordDispatch(taskType: string): void;
+    recordFireOutcome(taskType: string, result: 'success' | 'failure'): void;
+    recordRetry(taskType: string): void;
+    observeDispatchLagSeconds(taskType: string, seconds: number): void;
+    recordMaterialized(occurrences: number, deferredJobs: number): void;
+    recordReaped(reclaimed: number, deadLettered: number): void;
+    recordDeadLettered(): void;
+    recordPruned(deleted: number): void;
+}
+export declare const noopMetrics: SchedulerMetrics;

package/dist/observability/metrics.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.noopMetrics = void 0;
+exports.noopMetrics = {
+    recordDispatch() { },
+    recordFireOutcome() { },
+    recordRetry() { },
+    observeDispatchLagSeconds() { },
+    recordMaterialized() { },
+    recordReaped() { },
+    recordDeadLettered() { },
+    recordPruned() { },
+};
+//# sourceMappingURL=metrics.js.map

package/dist/observability/metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../../src/observability/metrics.ts"],"names":[],"mappings":";;;AA+Ba,QAAA,WAAW,GAAqB;IAC5C,cAAc,KAAI,CAAC;IACnB,iBAAiB,KAAI,CAAC;IACtB,WAAW,KAAI,CAAC;IAChB,yBAAyB,KAAI,CAAC;IAC9B,kBAAkB,KAAI,CAAC;IACvB,YAAY,KAAI,CAAC;IACjB,kBAAkB,KAAI,CAAC;IACvB,YAAY,KAAI,CAAC;CACjB,CAAC"}

package/dist/observability/pass-tracing.d.ts

@@ -0,0 +1,2 @@
+import { type SpanOptions, type Tracer } from './tracer';
+export declare function tracePass<T>(tracer: Tracer, options: SpanOptions, run: (signal?: AbortSignal) => Promise<T>, attributesFrom: (result: T) => Record<string, string | number | boolean>): (signal?: AbortSignal) => Promise<T>;

package/dist/observability/pass-tracing.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tracePass = tracePass;
+const tracer_1 = require("./tracer");
+const lifecycle_1 = require("../core/lifecycle");
+function tracePass(tracer, options, run, attributesFrom) {
+    return async (signal) => await tracer.startSpan(options, async (span) => {
+        const result = await run(signal);
+        for (const [key, value] of Object.entries(attributesFrom(result))) {
+            span.setAttribute(key, value);
+        }
+        settlePassSpan(span, signal);
+        return result;
+    });
+}
+function settlePassSpan(span, signal) {
+    if (signal?.aborted === true && signal.reason === lifecycle_1.PASS_TIMED_OUT) {
+        span.setStatus({ code: tracer_1.SpanStatus.error, message: 'Scheduler pass timed out' });
+    }
+    else {
+        span.setStatus({ code: tracer_1.SpanStatus.ok });
+    }
+}
+//# sourceMappingURL=pass-tracing.js.map

package/dist/observability/pass-tracing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pass-tracing.js","sourceRoot":"","sources":["../../src/observability/pass-tracing.ts"],"names":[],"mappings":";;AAgBA,8BAeC;AA/BD,qCAAgF;AAChF,iDAAmD;AAenD,SAAgB,SAAS,CACxB,MAAc,EACd,OAAoB,EACpB,GAAyC,EACzC,cAAwE;IAExE,OAAO,KAAK,EAAE,MAAoB,EAAE,EAAE,CACrC,MAAM,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QAC9C,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,CAAC;QACjC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;YACnE,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC/B,CAAC;QACD,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC7B,OAAO,MAAM,CAAC;IACf,CAAC,CAAC,CAAC;AACL,CAAC;AAUD,SAAS,cAAc,CAAC,IAAU,EAAE,MAAoB;IACvD,IAAI,MAAM,EAAE,OAAO,KAAK,IAAI,IAAI,MAAM,CAAC,MAAM,KAAK,0BAAc,EAAE,CAAC;QAClE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,mBAAU,CAAC,KAAK,EAAE,OAAO,EAAE,0BAA0B,EAAE,CAAC,CAAC;IACjF,CAAC;SAAM,CAAC;QACP,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,mBAAU,CAAC,EAAE,EAAE,CAAC,CAAC;IACzC,CAAC;AACF,CAAC"}

package/dist/observability/provisioner-tracing.d.ts

@@ -0,0 +1,11 @@
+import { type Tracer } from './tracer';
+import type { ProvisionSummary } from '../core/provisioning/types';
+export interface ProvisionerTracing {
+    provision(run: () => Promise<ProvisionSummary>): Promise<ProvisionSummary>;
+    deprovision(run: () => Promise<{
+        removed: number;
+    }>): Promise<{
+        removed: number;
+    }>;
+}
+export declare function createProvisionerTracing(tracer: Tracer): ProvisionerTracing;

package/dist/observability/provisioner-tracing.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createProvisionerTracing = createProvisionerTracing;
+const attributes_1 = require("./attributes");
+const tracer_1 = require("./tracer");
+function createProvisionerTracing(tracer) {
+    return {
+        async provision(run) {
+            return await tracer.startSpan({ name: 'Scheduler provision', op: 'scheduler.provision' }, async (span) => {
+                const summary = await run();
+                span.setAttribute(attributes_1.SCHEDULER_ATTRIBUTES.provisionInserted, summary.inserted.length);
+                span.setAttribute(attributes_1.SCHEDULER_ATTRIBUTES.provisionRedefined, summary.redefined.length);
+                span.setAttribute(attributes_1.SCHEDULER_ATTRIBUTES.provisionUnchanged, summary.unchanged.length);
+                span.setAttribute(attributes_1.SCHEDULER_ATTRIBUTES.provisionRemoved, summary.removed.length);
+                span.setStatus({ code: tracer_1.SpanStatus.ok });
+                await traceProvisionedJobs(tracer, summary);
+                return summary;
+            });
+        },
+        async deprovision(run) {
+            return await tracer.startSpan({ name: 'Scheduler deprovision', op: 'scheduler.deprovision' }, async (span) => {
+                const result = await run();
+                span.setAttribute(attributes_1.SCHEDULER_ATTRIBUTES.deprovisionRemoved, result.removed);
+                span.setStatus({ code: tracer_1.SpanStatus.ok });
+                return result;
+            });
+        },
+    };
+}
+async function traceProvisionedJobs(tracer, summary) {
+    const touched = [
+        ...summary.inserted.map((job) => [job, attributes_1.SCHEDULER_PROVISION_ACTION.inserted]),
+        ...summary.redefined.map((job) => [job, attributes_1.SCHEDULER_PROVISION_ACTION.redefined]),
+        ...summary.removed.map((job) => [job, attributes_1.SCHEDULER_PROVISION_ACTION.removed]),
+    ];
+    for (const [job, action] of touched) {
+        await tracer.startSpan({
+            name: 'Scheduler job provisioned',
+            op: 'scheduler.job.provision',
+            attributes: {
+                [attributes_1.SCHEDULER_ATTRIBUTES.jobId]: job.id,
+                [attributes_1.SCHEDULER_ATTRIBUTES.jobName]: job.name,
+                [attributes_1.SCHEDULER_ATTRIBUTES.jobAction]: action,
+            },
+        }, async (span) => {
+            span.setStatus({ code: tracer_1.SpanStatus.ok });
+            await Promise.resolve();
+        });
+    }
+}
+//# sourceMappingURL=provisioner-tracing.js.map

package/dist/observability/provisioner-tracing.js.map

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

package/dist/observability/tracer.d.ts

@@ -0,0 +1,21 @@
+export declare const SpanStatus: {
+    readonly ok: 1;
+    readonly error: 2;
+};
+export interface SpanOptions {
+    name: string;
+    op?: string;
+    attributes?: Record<string, string | number | boolean | undefined>;
+    newTrace?: boolean;
+}
+export interface Span {
+    setAttribute(key: string, value: string | number | boolean): void;
+    setStatus(status: {
+        code: number;
+        message?: string;
+    }): void;
+}
+export interface Tracer {
+    startSpan<T>(options: SpanOptions, run: (span: Span) => Promise<T>): Promise<T>;
+}
+export declare const noopTracer: Tracer;

package/dist/observability/tracer.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.noopTracer = exports.SpanStatus = void 0;
+exports.SpanStatus = { ok: 1, error: 2 };
+exports.noopTracer = {
+    async startSpan(_options, run) {
+        return await run({ setAttribute() { }, setStatus() { } });
+    },
+};
+//# sourceMappingURL=tracer.js.map

package/dist/observability/tracer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracer.js","sourceRoot":"","sources":["../../src/observability/tracer.ts"],"names":[],"mappings":";;;AAMa,QAAA,UAAU,GAAG,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAW,CAAC;AAqC1C,QAAA,UAAU,GAAW;IACjC,KAAK,CAAC,SAAS,CAAC,QAAQ,EAAE,GAAG;QAC5B,OAAO,MAAM,GAAG,CAAC,EAAE,YAAY,KAAI,CAAC,EAAE,SAAS,KAAI,CAAC,EAAE,CAAC,CAAC;IACzD,CAAC;CACD,CAAC"}

package/package.json

@@ -1,50 +1,38 @@
 {
   "name": "@n8n/scheduler",
-  "version": "0.2.3",
+  "version": "0.3.1",
   "main": "dist/index.js",
   "module": "src/index.ts",
   "types": "dist/index.d.ts",
   "files": [
     "dist/**/*",
-    "LICENSE_EE.md",
-    "LICENSE.md"
+    "LICENSE.md",
+    "LICENSE_EE.md"
   ],
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
-    },
-    "./storage": {
-      "types": "./dist/storage/index.d.ts",
-      "default": "./dist/storage/index.js"
-    }
-  },
-  "typesVersions": {
-    "*": {
-      "storage": [
-        "dist/storage/index.d.ts"
-      ]
     }
   },
   "dependencies": {
     "cron-parser": "5.6.1",
     "luxon": "3.7.2",
-    "@n8n/constants": "0.30.0",
-    "@n8n/backend-common": "1.30.3",
-    "@n8n/config": "2.28.0",
-    "@n8n/db": "1.30.3",
-    "@n8n/utils": "1.38.1",
-    "@n8n/di": "0.14.0",
-    "@n8n/typeorm": "0.4.0",
-    "n8n-workflow": "2.30.2"
+    "@n8n/utils": "1.39.0",
+    "n8n-workflow": "2.31.1",
+    "@n8n/constants": "0.31.0"
   },
   "devDependencies": {
+    "@stryker-mutator/core": "9.6.1",
+    "@stryker-mutator/vitest-runner": "9.6.1",
     "@types/luxon": "3.2.0",
     "@vitest/coverage-v8": "4.1.9",
+    "fast-check": "^3.23.2",
+    "typescript": "6.0.2",
     "vitest": "^4.1.9",
     "vitest-mock-extended": "^3.1.0",
-    "@n8n/vitest-config": "1.17.0",
-    "@n8n/typescript-config": "1.8.0"
+    "@n8n/typescript-config": "1.9.0",
+    "@n8n/vitest-config": "1.18.0"
   },
   "license": "SEE LICENSE IN LICENSE.md",
   "homepage": "https://n8n.io",
@@ -66,6 +54,7 @@
     "format:check": "biome ci .",
     "lint": "eslint . --quiet",
     "lint:fix": "eslint . --fix",
+    "mutate": "node ../../../scripts/mutation-health/mutate.mjs --package-dir packages/@n8n/scheduler",
     "watch": "tsc -p tsconfig.build.json --watch",
     "test": "vitest run --passWithNoTests",
     "test:unit": "vitest run --passWithNoTests",

package/dist/core/enums.d.ts

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

package/dist/core/enums.js

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

@@ -1 +0,0 @@
-{"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/executor/backoff.js.map

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

@@ -1,23 +0,0 @@
-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>;
-}