@n8n/scheduler 0.2.2 → 0.3.0

package/dist/core/errors.d.ts

@@ -4,6 +4,12 @@ export declare class InvalidScheduleError extends Error {
 export declare class InvalidRetentionOptionsError extends Error {
     constructor(message: string);
 }
+export declare class InvalidLifecycleOptionsError extends Error {
+    constructor(message: string);
+}
+export declare class DuplicateTaskHandlerError extends Error {
+    constructor(taskType: string);
+}
 export declare class CorruptStorageRowError extends Error {
     constructor(message: string);
 }

package/dist/core/errors.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CorruptStorageRowError = exports.InvalidRetentionOptionsError = exports.InvalidScheduleError = void 0;
+exports.CorruptStorageRowError = exports.DuplicateTaskHandlerError = exports.InvalidLifecycleOptionsError = exports.InvalidRetentionOptionsError = exports.InvalidScheduleError = void 0;
 class InvalidScheduleError extends Error {
     constructor(message) {
         super(message);
@@ -15,6 +15,20 @@ class InvalidRetentionOptionsError extends Error {
     }
 }
 exports.InvalidRetentionOptionsError = InvalidRetentionOptionsError;
+class InvalidLifecycleOptionsError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'InvalidLifecycleOptionsError';
+    }
+}
+exports.InvalidLifecycleOptionsError = InvalidLifecycleOptionsError;
+class DuplicateTaskHandlerError extends Error {
+    constructor(taskType) {
+        super(`A handler for task type '${taskType}' is already registered`);
+        this.name = 'DuplicateTaskHandlerError';
+    }
+}
+exports.DuplicateTaskHandlerError = DuplicateTaskHandlerError;
 class CorruptStorageRowError extends Error {
     constructor(message) {
         super(message);

package/dist/core/errors.js.map

@@ -1 +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"}
+{"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;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,yBAA0B,SAAQ,KAAK;IACnD,YAAY,QAAgB;QAC3B,KAAK,CAAC,4BAA4B,QAAQ,yBAAyB,CAAC,CAAC;QACrE,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;IACzC,CAAC;CACD;AALD,8DAKC;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/executor/backoff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backoff.js","sourceRoot":"","sources":["../../../src/core/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/core/executor/executor.d.ts

@@ -0,0 +1,38 @@
+import { type ExecutorOptions } from './options';
+import type { PrecisionTimer } from './precision-timer';
+import type { ExecutorTaskStore } from './store';
+import type { TaskHandlerRegistry } from './task-handler';
+import type { ExecutorTracing, FireResult } from './tracing';
+import type { ClaimedTask } from '../types';
+export interface ExecutorHooks {
+    onLeaseShorterThanLookahead?: (context: {
+        lookaheadMs: number;
+        leaseMs: number;
+    }) => void;
+    onMissingHandler?: (task: ClaimedTask) => void;
+    onFireError?: (task: ClaimedTask, error: unknown) => void;
+    onReleaseError?: (taskId: string, error: unknown) => void;
+    onDispatch?: (taskType: string, lagSeconds: number) => void;
+    onFire?: (taskType: string, result: 'success' | 'failure') => void;
+    onRetry?: (taskType: string) => void;
+}
+export declare class Executor {
+    private readonly store;
+    private readonly registry;
+    private readonly timer;
+    private readonly options;
+    private readonly hooks;
+    private readonly tracing;
+    private readonly leaseMs;
+    private readonly lookaheadMs;
+    private readonly claimedTaskById;
+    private stopping;
+    constructor(store: ExecutorTaskStore, registry: TaskHandlerRegistry, timer: PrecisionTimer, options?: ExecutorOptions, hooks?: ExecutorHooks, tracing?: ExecutorTracing);
+    claimAndSchedule(host: string, signal?: AbortSignal): Promise<ClaimedTask[]>;
+    private handBackClaims;
+    private scheduleClaimed;
+    fire(host: string, task: ClaimedTask): Promise<FireResult>;
+    private runFire;
+    private releaseClaimBestEffort;
+    stop(): Promise<void>;
+}

package/dist/core/executor/executor.js

@@ -0,0 +1,137 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Executor = void 0;
+const constants_1 = require("@n8n/constants");
+const ensure_error_1 = require("@n8n/utils/errors/ensure-error");
+const backoff_1 = require("./backoff");
+const options_1 = require("./options");
+const tracing_1 = require("./tracing");
+class Executor {
+    constructor(store, registry, timer, options = options_1.DEFAULT_EXECUTOR_OPTIONS, hooks = {}, tracing = tracing_1.noopExecutorTracing) {
+        this.store = store;
+        this.registry = registry;
+        this.timer = timer;
+        this.options = options;
+        this.hooks = hooks;
+        this.tracing = tracing;
+        this.claimedTaskById = new Map();
+        this.stopping = false;
+        this.leaseMs = options.leaseSeconds * constants_1.Time.seconds.toMilliseconds;
+        this.lookaheadMs = options.lookaheadSeconds * constants_1.Time.seconds.toMilliseconds;
+        if (this.lookaheadMs >= this.leaseMs) {
+            this.hooks.onLeaseShorterThanLookahead?.({
+                lookaheadMs: this.lookaheadMs,
+                leaseMs: this.leaseMs,
+            });
+        }
+    }
+    async claimAndSchedule(host, signal) {
+        const taskTypes = this.registry.registeredTypes();
+        if (taskTypes.length === 0)
+            return [];
+        const batch = {
+            host,
+            taskTypes,
+            lookaheadMs: this.lookaheadMs,
+            leaseMs: this.leaseMs,
+            batchSize: this.options.batchSize,
+        };
+        const tasks = await this.store.claimDueTasks(batch);
+        if (this.stopping || signal?.aborted === true) {
+            await this.handBackClaims(host, tasks);
+            return [];
+        }
+        for (const task of tasks) {
+            this.scheduleClaimed(host, task);
+        }
+        return tasks;
+    }
+    async handBackClaims(host, tasks) {
+        await Promise.all(tasks.map(async (task) => await this.releaseClaimBestEffort({
+            host,
+            id: task.id,
+            claimedEpoch: task.leaseEpoch,
+        })));
+    }
+    scheduleClaimed(host, task) {
+        this.claimedTaskById.set(task.id, { host, task });
+        this.timer.schedule(task.runAt, () => {
+            this.claimedTaskById.delete(task.id);
+            this.fire(host, task).catch((error) => {
+                this.hooks.onFireError?.(task, error);
+            });
+        });
+    }
+    async fire(host, task) {
+        return await this.tracing.fire(host, task, async () => await this.runFire(host, task));
+    }
+    async runFire(host, task) {
+        const claim = { host, id: task.id, claimedEpoch: task.leaseEpoch };
+        const handler = this.registry.resolve(task.taskType);
+        if (handler === undefined) {
+            this.hooks.onMissingHandler?.(task);
+            await this.releaseClaimBestEffort(claim);
+            return { outcome: 'skipped-no-handler' };
+        }
+        const started = await this.store.markStarted(claim);
+        if (started === 0) {
+            return { outcome: 'skipped-not-owned' };
+        }
+        const lagMs = this.timer.now() - task.runAt.getTime();
+        const lagSeconds = Math.max(0, lagMs) / constants_1.Time.seconds.toMilliseconds;
+        this.hooks.onDispatch?.(task.taskType, lagSeconds);
+        try {
+            await handler.execute(task);
+        }
+        catch (error) {
+            const errorMessage = (0, ensure_error_1.ensureError)(error).message;
+            const nextAttempts = task.attempts + 1;
+            if (nextAttempts >= task.maxAttempts) {
+                const rowsAffected = await this.store.failTaskTerminal(claim, errorMessage);
+                if (rowsAffected > 0) {
+                    this.hooks.onFire?.(task.taskType, 'failure');
+                    return { outcome: 'dead-lettered', errorMessage };
+                }
+                return { outcome: 'skipped-not-owned', errorMessage };
+            }
+            const rowsAffected = await this.store.rescheduleTask(claim, (0, backoff_1.backoff)(nextAttempts), errorMessage);
+            if (rowsAffected > 0) {
+                this.hooks.onRetry?.(task.taskType);
+                return { outcome: 'rescheduled', errorMessage };
+            }
+            return { outcome: 'skipped-not-owned', errorMessage };
+        }
+        const rowsAffected = await this.store.completeTask(claim);
+        if (rowsAffected > 0) {
+            this.hooks.onFire?.(task.taskType, 'success');
+            return { outcome: 'completed' };
+        }
+        return { outcome: 'skipped-not-owned' };
+    }
+    async releaseClaimBestEffort(claim) {
+        try {
+            await this.store.releaseClaim(claim);
+        }
+        catch (error) {
+            this.hooks.onReleaseError?.(claim.id, error);
+        }
+    }
+    async stop() {
+        this.stopping = true;
+        this.timer.cancelAll();
+        const entries = [...this.claimedTaskById.values()];
+        const results = await Promise.allSettled(entries.map(async ({ host, task }) => await this.store.releaseClaim({
+            host,
+            id: task.id,
+            claimedEpoch: task.leaseEpoch,
+        })));
+        results.forEach((result, index) => {
+            if (result.status === 'rejected') {
+                this.hooks.onReleaseError?.(entries[index].task.id, result.reason);
+            }
+        });
+        this.claimedTaskById.clear();
+    }
+}
+exports.Executor = Executor;
+//# sourceMappingURL=executor.js.map

package/dist/core/executor/executor.js.map

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

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

@@ -0,0 +1,8 @@
+export { Executor, type ExecutorHooks } from './executor';
+export { noopExecutorTracing } from './tracing';
+export type { ExecutorTracing, FireResult } from './tracing';
+export { DEFAULT_EXECUTOR_OPTIONS, type ExecutorOptions } from './options';
+export type { ClaimedTaskRef, ClaimDueTasksBatch, ExecutorTaskStore } from './store';
+export { TaskHandlerRegistry, type TaskHandler } from './task-handler';
+export { PrecisionTimer, type TimerBackend } from './precision-timer';
+export { backoff, type BackoffOptions } from './backoff';

package/dist/core/executor/index.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.backoff = exports.PrecisionTimer = exports.TaskHandlerRegistry = exports.DEFAULT_EXECUTOR_OPTIONS = exports.noopExecutorTracing = exports.Executor = void 0;
+var executor_1 = require("./executor");
+Object.defineProperty(exports, "Executor", { enumerable: true, get: function () { return executor_1.Executor; } });
+var tracing_1 = require("./tracing");
+Object.defineProperty(exports, "noopExecutorTracing", { enumerable: true, get: function () { return tracing_1.noopExecutorTracing; } });
+var options_1 = require("./options");
+Object.defineProperty(exports, "DEFAULT_EXECUTOR_OPTIONS", { enumerable: true, get: function () { return options_1.DEFAULT_EXECUTOR_OPTIONS; } });
+var task_handler_1 = require("./task-handler");
+Object.defineProperty(exports, "TaskHandlerRegistry", { enumerable: true, get: function () { return task_handler_1.TaskHandlerRegistry; } });
+var precision_timer_1 = require("./precision-timer");
+Object.defineProperty(exports, "PrecisionTimer", { enumerable: true, get: function () { return precision_timer_1.PrecisionTimer; } });
+var backoff_1 = require("./backoff");
+Object.defineProperty(exports, "backoff", { enumerable: true, get: function () { return backoff_1.backoff; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/executor/index.ts"],"names":[],"mappings":";;;AAAA,uCAA0D;AAAjD,oGAAA,QAAQ,OAAA;AACjB,qCAAgD;AAAvC,8GAAA,mBAAmB,OAAA;AAE5B,qCAA2E;AAAlE,mHAAA,wBAAwB,OAAA;AAEjC,+CAAuE;AAA9D,mHAAA,mBAAmB,OAAA;AAC5B,qDAAsE;AAA7D,iHAAA,cAAc,OAAA;AACvB,qCAAyD;AAAhD,kGAAA,OAAO,OAAA"}

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

@@ -0,0 +1,6 @@
+export interface ExecutorOptions {
+    leaseSeconds: number;
+    lookaheadSeconds: number;
+    batchSize: number;
+}
+export declare const DEFAULT_EXECUTOR_OPTIONS: ExecutorOptions;

package/dist/core/executor/options.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_EXECUTOR_OPTIONS = void 0;
+const constants_1 = require("@n8n/constants");
+exports.DEFAULT_EXECUTOR_OPTIONS = {
+    leaseSeconds: constants_1.Time.minutes.toSeconds,
+    lookaheadSeconds: 5,
+    batchSize: 100,
+};
+//# sourceMappingURL=options.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../../src/core/executor/options.ts"],"names":[],"mappings":";;;AAAA,8CAAsC;AA2BzB,QAAA,wBAAwB,GAAoB;IACxD,YAAY,EAAE,gBAAI,CAAC,OAAO,CAAC,SAAS;IACpC,gBAAgB,EAAE,CAAC;IACnB,SAAS,EAAE,GAAG;CACd,CAAC"}

package/dist/{executor → core/executor}/precision-timer.d.ts

@@ -7,6 +7,7 @@ export declare class PrecisionTimer {
     private readonly backend;
     private readonly pending;
     constructor(backend?: TimerBackend);
+    now(): number;
     schedule(runAt: Date, fn: () => void): void;
     cancelAll(): void;
     get pendingCount(): number;

package/dist/{executor → core/executor}/precision-timer.js

@@ -13,6 +13,9 @@ class PrecisionTimer {
         this.backend = backend;
         this.pending = new Set();
     }
+    now() {
+        return this.backend.now();
+    }
     schedule(runAt, fn) {
         const delay = Math.min(Math.max(0, runAt.getTime() - this.backend.now()), MAX_DELAY_MS);
         const handle = this.backend.setTimer(() => {

package/dist/core/executor/precision-timer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"precision-timer.js","sourceRoot":"","sources":["../../../src/core/executor/precision-timer.ts"],"names":[],"mappings":";;;AAAA,8CAA2D;AAY3D,MAAM,cAAc,GAAiB;IACpC,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;IACrB,QAAQ,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,EAAE,EAAE,OAAO,CAAC;IAClD,UAAU,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC;CAC5C,CAAC;AAGF,MAAM,YAAY,GAAG,qCAAyB,CAAC;AAY/C,MAAa,cAAc;IAG1B,YAA6B,UAAwB,cAAc;QAAtC,YAAO,GAAP,OAAO,CAA+B;QAFlD,YAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IAEiB,CAAC;IAGvE,GAAG;QACF,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;IAC3B,CAAC;IAGD,QAAQ,CAAC,KAAW,EAAE,EAAc;QAInC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,EAAE,YAAY,CAAC,CAAC;QAGxF,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,EAAE;YACzC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAC5B,EAAE,EAAE,CAAC;QACN,CAAC,EAAE,KAAK,CAAC,CAAC;QACV,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC1B,CAAC;IAGD,SAAS;QAGR,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;QAClC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACrB,KAAK,MAAM,MAAM,IAAI,OAAO;YAAE,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IAC/D,CAAC;IAED,IAAI,YAAY;QACf,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;IAC1B,CAAC;CACD;AArCD,wCAqCC"}

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

@@ -0,0 +1,21 @@
+import type { ClaimedTask } from '../types';
+export interface ClaimedTaskRef {
+    host: string;
+    id: string;
+    claimedEpoch: number;
+}
+export interface ClaimDueTasksBatch {
+    host: string;
+    taskTypes: string[];
+    lookaheadMs: number;
+    leaseMs: number;
+    batchSize: number;
+}
+export interface ExecutorTaskStore {
+    claimDueTasks(batch: ClaimDueTasksBatch): Promise<ClaimedTask[]>;
+    markStarted(claim: ClaimedTaskRef): Promise<number>;
+    completeTask(claim: ClaimedTaskRef): Promise<number>;
+    failTaskTerminal(claim: ClaimedTaskRef, errorMessage: string): Promise<number>;
+    rescheduleTask(claim: ClaimedTaskRef, backoffMs: number, errorMessage: string): Promise<number>;
+    releaseClaim(claim: ClaimedTaskRef): Promise<number>;
+}

package/dist/core/executor/store.js

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

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

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

package/dist/{executor → core/executor}/task-handler.d.ts

@@ -1,4 +1,4 @@
-import type { ClaimedTask } from '../core/types';
+import type { ClaimedTask } from '../types';
 export interface TaskHandler {
     execute(task: ClaimedTask): Promise<void>;
 }

package/dist/{executor → core/executor}/task-handler.js

@@ -1,14 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TaskHandlerRegistry = void 0;
-const n8n_workflow_1 = require("n8n-workflow");
+const errors_1 = require("../errors");
 class TaskHandlerRegistry {
     constructor() {
         this.handlers = new Map();
     }
     register(taskType, handler) {
         if (this.handlers.has(taskType)) {
-            throw new n8n_workflow_1.UnexpectedError(`A handler for task type '${taskType}' is already registered`);
+            throw new errors_1.DuplicateTaskHandlerError(taskType);
         }
         this.handlers.set(taskType, handler);
     }

package/dist/core/executor/task-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-handler.js","sourceRoot":"","sources":["../../../src/core/executor/task-handler.ts"],"names":[],"mappings":";;;AAAA,sCAAsD;AAiBtD,MAAa,mBAAmB;IAAhC;QACkB,aAAQ,GAAG,IAAI,GAAG,EAAuB,CAAC;IAkB5D,CAAC;IAfA,QAAQ,CAAC,QAAgB,EAAE,OAAoB;QAC9C,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,kCAAyB,CAAC,QAAQ,CAAC,CAAC;QAC/C,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;IAED,OAAO,CAAC,QAAgB;QACvB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC;IAGD,eAAe;QACd,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IAClC,CAAC;CACD;AAnBD,kDAmBC"}

package/dist/core/executor/tracing.d.ts

@@ -0,0 +1,11 @@
+import type { ClaimedTask } from '../types';
+export type FireResult = {
+    outcome: 'completed' | 'skipped-no-handler' | 'skipped-not-owned';
+} | {
+    outcome: 'rescheduled' | 'dead-lettered' | 'skipped-not-owned';
+    errorMessage: string;
+};
+export interface ExecutorTracing {
+    fire(host: string, task: ClaimedTask, run: () => Promise<FireResult>): Promise<FireResult>;
+}
+export declare const noopExecutorTracing: ExecutorTracing;

package/dist/core/executor/tracing.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.noopExecutorTracing = void 0;
+exports.noopExecutorTracing = {
+    fire: async (_host, _task, run) => await run(),
+};
+//# sourceMappingURL=tracing.js.map

package/dist/core/executor/tracing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracing.js","sourceRoot":"","sources":["../../../src/core/executor/tracing.ts"],"names":[],"mappings":";;;AA0Ca,QAAA,mBAAmB,GAAoB;IACnD,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,MAAM,GAAG,EAAE;CAC9C,CAAC"}

package/dist/core/factory.d.ts

@@ -0,0 +1,29 @@
+import type { ExecutorOptions, ExecutorTaskStore } from './executor';
+import type { LifecycleOptions } from './lifecycle';
+import type { MaterializerOptions, RunInTransaction } from './materializer';
+import type { ReaperOptions, ReaperTaskStore } from './reaper';
+import type { RetentionOptions, RetentionStore } from './retention';
+import type { Scheduler, SchedulerPasses } from './scheduler';
+import { type SchedulerMetrics } from '../observability/metrics';
+import { type Tracer } from '../observability/tracer';
+export type SchedulerEventLevel = 'debug' | 'info' | 'warn' | 'error';
+export interface SchedulerEvent {
+    level: SchedulerEventLevel;
+    message: string;
+    context: Record<string, unknown>;
+}
+export type SchedulerTaskStore = ExecutorTaskStore & ReaperTaskStore & RetentionStore;
+export interface SchedulerDeps {
+    hostId: string;
+    materializerTransaction: RunInTransaction;
+    taskStore: SchedulerTaskStore;
+    materializer?: Partial<MaterializerOptions>;
+    executor?: Partial<ExecutorOptions>;
+    reaper?: Partial<ReaperOptions>;
+    retention?: Partial<RetentionOptions>;
+    lifecycle?: Partial<LifecycleOptions>;
+    onEvent?: (event: SchedulerEvent) => void;
+    tracer?: Tracer;
+    metrics?: SchedulerMetrics;
+}
+export declare function createScheduler(deps: SchedulerDeps): Scheduler & SchedulerPasses;