@neofinancial/chrono 0.4.1-next.0 → 0.5.0

package/build/chrono.js

@@ -1,71 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Chrono = void 0;
-const node_stream_1 = require("node:stream");
-const events_1 = require("./events");
-const processors_1 = require("./processors");
-const promise_utils_1 = require("./utils/promise-utils");
-/**
- * This is a type that represents the mapping of task kinds to their respective data types.
- *
- * Eg. shape of the TaskMapping type:
- *
- * type TaskMapping = {
- *   "async-messaging": { someField: number };
- *   "send-email": { url: string };
- * };
- *
- */
-class Chrono extends node_stream_1.EventEmitter {
-    datastore;
-    processors = new Map();
-    exitTimeoutMs = 60_000;
-    constructor(datastore) {
-        super();
-        this.datastore = datastore;
-    }
-    async start() {
-        for (const processor of this.processors.values()) {
-            await processor.start();
-        }
-        this.emit(events_1.ChronoEvents.STARTED, { startedAt: new Date() });
-    }
-    async stop() {
-        const stopPromises = Array.from(this.processors.values()).map((processor) => processor.stop());
-        try {
-            await (0, promise_utils_1.promiseWithTimeout)(Promise.all(stopPromises), this.exitTimeoutMs);
-        }
-        catch (error) {
-            this.emit(events_1.ChronoEvents.STOP_ABORTED, { error, timestamp: new Date() });
-        }
-    }
-    async scheduleTask(input) {
-        const task = await this.datastore.schedule({
-            when: input.when,
-            kind: input.kind,
-            data: input.data,
-            datastoreOptions: input.datastoreOptions,
-        });
-        return task;
-    }
-    async deleteTask(taskId) {
-        const task = await this.datastore.delete(taskId);
-        return task;
-    }
-    registerTaskHandler(input) {
-        if (this.processors.has(input.kind)) {
-            throw new Error('Handler for task kind already exists');
-        }
-        const processor = (0, processors_1.createProcessor)({
-            kind: input.kind,
-            datastore: this.datastore,
-            handler: input.handler,
-            backoffStrategyOptions: input.backoffStrategyOptions,
-            configuration: input.processorConfiguration,
-        });
-        this.processors.set(input.kind, processor);
-        return processor;
-    }
-}
-exports.Chrono = Chrono;
-//# sourceMappingURL=chrono.js.map

package/build/chrono.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"chrono.js","sourceRoot":"","sources":["../src/chrono.ts"],"names":[],"mappings":";;;AAAA,6CAA2C;AAI3C,qCAA8D;AAC9D,6CAA+D;AAG/D,yDAA2D;AAsB3D;;;;;;;;;;GAUG;AAEH,MAAa,MAA8D,SAAQ,0BAA6B;IAC7F,SAAS,CAA2C;IACpD,UAAU,GAAsE,IAAI,GAAG,EAAE,CAAC;IAElG,aAAa,GAAG,MAAM,CAAC;IAEhC,YAAY,SAAmD;QAC7D,KAAK,EAAE,CAAC;QAER,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;IAEM,KAAK,CAAC,KAAK;QAChB,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC;YACjD,MAAM,SAAS,CAAC,KAAK,EAAE,CAAC;QAC1B,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,qBAAY,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,EAAE,CAAC,CAAC;IAC7D,CAAC;IAEM,KAAK,CAAC,IAAI;QACf,MAAM,YAAY,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;QAE/F,IAAI,CAAC;YACH,MAAM,IAAA,kCAAkB,EAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;QAC1E,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,IAAI,CAAC,qBAAY,CAAC,YAAY,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,EAAE,CAAC,CAAC;QACzE,CAAC;IACH,CAAC;IAEM,KAAK,CAAC,YAAY,CACvB,KAA2E;QAE3E,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC;YACzC,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;SACzC,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,KAAK,CAAC,UAAU,CACrB,MAAc;QAEd,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,MAAM,CAAW,MAAM,CAAC,CAAC;QAE3D,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,mBAAmB,CACxB,KAAgE;QAEhE,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,CAAC;QAED,MAAM,SAAS,GAAG,IAAA,4BAAe,EAAC;YAChC,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,sBAAsB,EAAE,KAAK,CAAC,sBAAsB;YACpD,aAAa,EAAE,KAAK,CAAC,sBAAsB;SAC5C,CAAC,CAAC;QAEH,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAE3C,OAAO,SAAS,CAAC;IACnB,CAAC;CACF;AAtED,wBAsEC"}

package/build/datastore.d.ts

@@ -1,63 +0,0 @@
-import type { TaskMappingBase } from './chrono';
-export declare const TaskStatus: {
-    readonly PENDING: "PENDING";
-    readonly CLAIMED: "CLAIMED";
-    readonly COMPLETED: "COMPLETED";
-    readonly FAILED: "FAILED";
-};
-export type TaskStatus = (typeof TaskStatus)[keyof typeof TaskStatus];
-export type Task<TaskKind, TaskData> = {
-    /** A unique identifier for the task */
-    id: string;
-    /** A human-readable name or type for the task */
-    kind: TaskKind;
-    /** The current status of the task */
-    status: TaskStatus;
-    /** The payload or data associated with the task */
-    data: TaskData;
-    /** The priority level of the task (lower numbers can indicate higher priority) */
-    priority?: number;
-    /** A key used for idempotency to prevent duplicate processing */
-    idempotencyKey?: string;
-    /** The original scheduled date when the task was first intended to run */
-    originalScheduleDate: Date;
-    /** The current scheduled execution date, which may change if rescheduled */
-    scheduledAt: Date;
-    /** The date the task is mark 'claimed */
-    claimedAt?: Date;
-    /** The date the task is mark 'completed' */
-    completedAt?: Date;
-    /** The date when the task was last executed (if any) */
-    lastExecutedAt?: Date;
-    /** A counter to track the number of times the task has been retried */
-    retryCount: number;
-};
-export type ScheduleInput<TaskKind, TaskData, DatastoreOptions> = {
-    when: Date;
-    kind: TaskKind;
-    data: TaskData;
-    priority?: number;
-    idempotencyKey?: string;
-    datastoreOptions?: DatastoreOptions;
-};
-export type ClaimTaskInput<TaskKind> = {
-    kind: TaskKind;
-    claimStaleTimeoutMs: number;
-};
-export type DeleteByIdempotencyKeyInput<TaskKind> = {
-    kind: TaskKind;
-    idempotencyKey: string;
-};
-export type DeleteOptions = {
-    force?: boolean;
-};
-export type DeleteInput<TaskKind> = DeleteByIdempotencyKeyInput<TaskKind> | string;
-export interface Datastore<TaskMapping extends TaskMappingBase, DatastoreOptions> {
-    schedule<TaskKind extends keyof TaskMapping>(input: ScheduleInput<TaskKind, TaskMapping[TaskKind], DatastoreOptions>): Promise<Task<TaskKind, TaskMapping[TaskKind]>>;
-    delete<TaskKind extends keyof TaskMapping>(taskId: string, options?: DeleteOptions): Promise<Task<TaskKind, TaskMapping[TaskKind]> | undefined>;
-    delete<TaskKind extends keyof TaskMapping>(key: DeleteByIdempotencyKeyInput<TaskKind>, options?: DeleteOptions): Promise<Task<TaskKind, TaskMapping[TaskKind]> | undefined>;
-    claim<TaskKind extends Extract<keyof TaskMapping, string>>(input: ClaimTaskInput<TaskKind>): Promise<Task<TaskKind, TaskMapping[TaskKind]> | undefined>;
-    retry<TaskKind extends keyof TaskMapping>(taskId: string, retryAt: Date): Promise<Task<TaskKind, TaskMapping[TaskKind]>>;
-    complete<TaskKind extends keyof TaskMapping>(taskId: string): Promise<Task<TaskKind, TaskMapping[TaskKind]>>;
-    fail<TaskKind extends keyof TaskMapping>(taskId: string): Promise<Task<TaskKind, TaskMapping[TaskKind]>>;
-}

package/build/datastore.js

@@ -1,10 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.TaskStatus = void 0;
-exports.TaskStatus = {
-    PENDING: 'PENDING',
-    CLAIMED: 'CLAIMED',
-    COMPLETED: 'COMPLETED',
-    FAILED: 'FAILED',
-};
-//# sourceMappingURL=datastore.js.map

package/build/datastore.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"datastore.js","sourceRoot":"","sources":["../src/datastore.ts"],"names":[],"mappings":";;;AAEa,QAAA,UAAU,GAAG;IACxB,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,WAAW;IACtB,MAAM,EAAE,QAAQ;CACR,CAAC"}

package/build/events.d.ts

@@ -1,16 +0,0 @@
-export declare const ChronoEvents: {
-    /** Chrono instance has started processors and begun polling tasks */
-    readonly STARTED: "started";
-    /** Chrono instance has failed to gracefully stop so shutdown has been aborted */
-    readonly STOP_ABORTED: "stopAborted";
-};
-export type ChronoEvents = (typeof ChronoEvents)[keyof typeof ChronoEvents];
-export type ChronoEventsMap = {
-    [ChronoEvents.STARTED]: [{
-        startedAt: Date;
-    }];
-    [ChronoEvents.STOP_ABORTED]: [{
-        timestamp: Date;
-        error: unknown;
-    }];
-};

package/build/events.js

@@ -1,10 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ChronoEvents = void 0;
-exports.ChronoEvents = {
-    /** Chrono instance has started processors and begun polling tasks */
-    STARTED: 'started',
-    /** Chrono instance has failed to gracefully stop so shutdown has been aborted */
-    STOP_ABORTED: 'stopAborted',
-};
-//# sourceMappingURL=events.js.map

package/build/events.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":";;;AAAa,QAAA,YAAY,GAAG;IAC1B,qEAAqE;IACrE,OAAO,EAAE,SAAS;IAClB,iFAAiF;IACjF,YAAY,EAAE,aAAa;CACnB,CAAC"}

package/build/processors/create-processor.d.ts

@@ -1,31 +0,0 @@
-import type { Datastore, Task } from 'datastore';
-import type { TaskMappingBase } from '..';
-import { type BackoffStrategyOptions } from '../backoff-strategy';
-import type { Processor } from './processor';
-/**
- * Configuration for the processor.
- */
-export type ProcessorConfiguration = {
-    /** The maximum number of concurrent tasks that the processor will use when processing. @default 1 */
-    maxConcurrency?: number;
-    /** The interval at which the processor will wait before next poll when the previous poll returned a task @default 50ms */
-    claimIntervalMs?: number;
-    /** The interval at which the processor will wait before next poll when no tasks are available for processing @default 5000ms */
-    idleIntervalMs?: number;
-    /** The maximum time a task can be claimed for processing before it will be considered stale and claimed again @default 10000ms */
-    claimStaleTimeoutMs?: number;
-    /** The maximum time a task handler can take to complete before it will be considered timed out @default 5000ms */
-    taskHandlerTimeoutMs?: number;
-    /** The maximum number of retries for a task handler, before task is marked as failed. @default 5 */
-    taskHandlerMaxRetries?: number;
-    /** The interval at which the processor will wait before next poll when an unexpected error occurs @default 20000ms */
-    processLoopRetryIntervalMs?: number;
-};
-export type CreateProcessorInput<TaskKind extends keyof TaskMapping, TaskMapping extends TaskMappingBase, DatastoreOptions> = {
-    kind: TaskKind;
-    datastore: Datastore<TaskMapping, DatastoreOptions>;
-    handler: (task: Task<TaskKind, TaskMapping[TaskKind]>) => Promise<void>;
-    configuration?: ProcessorConfiguration;
-    backoffStrategyOptions?: BackoffStrategyOptions;
-};
-export declare function createProcessor<TaskKind extends Extract<keyof TaskMapping, string>, TaskMapping extends TaskMappingBase, DatastoreOptions>(input: CreateProcessorInput<TaskKind, TaskMapping, DatastoreOptions>): Processor<TaskKind, TaskMapping>;

package/build/processors/create-processor.js

@@ -1,11 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createProcessor = createProcessor;
-const backoff_strategy_1 = require("../backoff-strategy");
-const simple_processor_1 = require("./simple-processor");
-function createProcessor(input) {
-    const backoffStrategy = (0, backoff_strategy_1.backoffStrategyFactory)(input.backoffStrategyOptions);
-    // add more processors here
-    return new simple_processor_1.SimpleProcessor(input.datastore, input.kind, input.handler, backoffStrategy, input.configuration);
-}
-//# sourceMappingURL=create-processor.js.map

package/build/processors/create-processor.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"create-processor.js","sourceRoot":"","sources":["../../src/processors/create-processor.ts"],"names":[],"mappings":";;AAsCA,0CAcC;AAlDD,0DAA0F;AAE1F,yDAAqD;AAkCrD,SAAgB,eAAe,CAI7B,KAAoE;IACpE,MAAM,eAAe,GAAG,IAAA,yCAAsB,EAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAC7E,2BAA2B;IAC3B,OAAO,IAAI,kCAAe,CACxB,KAAK,CAAC,SAAS,EACf,KAAK,CAAC,IAAI,EACV,KAAK,CAAC,OAAO,EACb,eAAe,EACf,KAAK,CAAC,aAAa,CACpB,CAAC;AACJ,CAAC"}

package/build/processors/events.d.ts

@@ -1,50 +0,0 @@
-import type { Task, TaskMappingBase } from '..';
-export declare const ProcessorEvents: {
-    /** A task has been claimed by the running processor for handling */
-    readonly TASK_CLAIMED: "taskClaimed";
-    /** A task has completed processing and successfully marked as completed */
-    readonly TASK_COMPLETED: "taskCompleted";
-    /** A task has failed during processing and being scheduled for retry */
-    readonly TASK_RETRY_SCHEDULED: "taskRetryScheduled";
-    /** A task has been marked as FAILED due to process failures exceeding max retries */
-    readonly TASK_FAILED: "taskFailed";
-    /** A task has been successfully processed but underlying data store failed to mark task as completed. Duplicate processing expected */
-    readonly TASK_COMPLETION_FAILURE: "taskCompletionFailure";
-    /** An unknown and uncaught exception occurred in processor. Processing paused for processLoopRetryIntervalMs before continuing */
-    readonly UNKNOWN_PROCESSING_ERROR: "unknownProcessingError";
-};
-export type ProcessorEvents = (typeof ProcessorEvents)[keyof typeof ProcessorEvents];
-export type ProcessorEventsMap<TaskKind extends keyof TaskMapping, TaskMapping extends TaskMappingBase> = {
-    [ProcessorEvents.TASK_CLAIMED]: [{
-        task: Task<TaskKind, TaskMapping[TaskKind]>;
-        claimedAt: Date;
-    }];
-    [ProcessorEvents.TASK_COMPLETED]: [{
-        task: Task<TaskKind, TaskMapping[TaskKind]>;
-        completedAt: Date;
-    }];
-    [ProcessorEvents.TASK_RETRY_SCHEDULED]: [
-        {
-            task: Task<TaskKind, TaskMapping[TaskKind]>;
-            error: unknown;
-            retryScheduledAt: Date;
-            errorAt: Date;
-        }
-    ];
-    [ProcessorEvents.TASK_FAILED]: [{
-        task: Task<TaskKind, TaskMapping[TaskKind]>;
-        error: unknown;
-        failedAt: Date;
-    }];
-    [ProcessorEvents.TASK_COMPLETION_FAILURE]: [
-        {
-            task: Task<TaskKind, TaskMapping[TaskKind]>;
-            error: unknown;
-            failedAt: Date;
-        }
-    ];
-    [ProcessorEvents.UNKNOWN_PROCESSING_ERROR]: [{
-        error: unknown;
-        timestamp: Date;
-    }];
-};

package/build/processors/events.js

@@ -1,19 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ProcessorEvents = void 0;
-exports.ProcessorEvents = {
-    /** A task has been claimed by the running processor for handling */
-    TASK_CLAIMED: 'taskClaimed',
-    /** A task has completed processing and successfully marked as completed */
-    TASK_COMPLETED: 'taskCompleted',
-    /** A task has failed during processing and being scheduled for retry */
-    TASK_RETRY_SCHEDULED: 'taskRetryScheduled',
-    /** A task has been marked as FAILED due to process failures exceeding max retries */
-    TASK_FAILED: 'taskFailed',
-    /** A task has been successfully processed but underlying data store failed to mark task as completed. Duplicate processing expected */
-    TASK_COMPLETION_FAILURE: 'taskCompletionFailure',
-    /** An unknown and uncaught exception occurred in processor. Processing paused for processLoopRetryIntervalMs before continuing */
-    UNKNOWN_PROCESSING_ERROR: 'unknownProcessingError',
-};
-exports.ProcessorEvents.TASK_CLAIMED;
-//# sourceMappingURL=events.js.map

package/build/processors/events.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/processors/events.ts"],"names":[],"mappings":";;;AAEa,QAAA,eAAe,GAAG;IAC7B,oEAAoE;IACpE,YAAY,EAAE,aAAa;IAC3B,2EAA2E;IAC3E,cAAc,EAAE,eAAe;IAC/B,wEAAwE;IACxE,oBAAoB,EAAE,oBAAoB;IAC1C,qFAAqF;IACrF,WAAW,EAAE,YAAY;IACzB,uIAAuI;IACvI,uBAAuB,EAAE,uBAAuB;IAChD,kIAAkI;IAClI,wBAAwB,EAAE,wBAAwB;CAC1C,CAAC;AAiBX,uBAAe,CAAC,YAAY,CAAC"}

package/build/processors/index.d.ts

@@ -1,3 +0,0 @@
-export { createProcessor } from './create-processor';
-export type { Processor } from './processor';
-export { ProcessorEvents, type ProcessorEventsMap } from './events';

package/build/processors/index.js

@@ -1,8 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ProcessorEvents = exports.createProcessor = void 0;
-var create_processor_1 = require("./create-processor");
-Object.defineProperty(exports, "createProcessor", { enumerable: true, get: function () { return create_processor_1.createProcessor; } });
-var events_1 = require("./events");
-Object.defineProperty(exports, "ProcessorEvents", { enumerable: true, get: function () { return events_1.ProcessorEvents; } });
-//# sourceMappingURL=index.js.map

package/build/processors/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/processors/index.ts"],"names":[],"mappings":";;;AAAA,uDAAqD;AAA5C,mHAAA,eAAe,OAAA;AAExB,mCAAoE;AAA3D,yGAAA,eAAe,OAAA"}

package/build/processors/processor.d.ts

@@ -1,7 +0,0 @@
-import type { EventEmitter } from 'node:stream';
-import type { TaskMappingBase } from '..';
-import type { ProcessorEventsMap } from './events';
-export interface Processor<TaskKind extends keyof TaskMapping, TaskMapping extends TaskMappingBase> extends EventEmitter<ProcessorEventsMap<TaskKind, TaskMapping>> {
-    start(): Promise<void>;
-    stop(): Promise<void>;
-}

package/build/processors/processor.js

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

package/build/processors/processor.js.map

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

package/build/processors/simple-processor.d.ts

@@ -1,63 +0,0 @@
-import { EventEmitter } from 'node:stream';
-import type { BackoffStrategy } from '../backoff-strategy';
-import type { TaskMappingBase } from '../chrono';
-import type { Datastore, Task } from '../datastore';
-import { type ProcessorEventsMap } from './events';
-import type { Processor } from './processor';
-type SimpleProcessorConfig = {
-    maxConcurrency: number;
-    claimIntervalMs: number;
-    claimStaleTimeoutMs: number;
-    idleIntervalMs: number;
-    taskHandlerTimeoutMs: number;
-    taskHandlerMaxRetries: number;
-    processLoopRetryIntervalMs: number;
-};
-export declare class SimpleProcessor<TaskKind extends Extract<keyof TaskMapping, string>, TaskMapping extends TaskMappingBase, DatastoreOptions> extends EventEmitter<ProcessorEventsMap<TaskKind, TaskMapping>> implements Processor<TaskKind, TaskMapping> {
-    private datastore;
-    private taskKind;
-    private handler;
-    private backOffStrategy;
-    private config;
-    private exitChannels;
-    private stopRequested;
-    constructor(datastore: Datastore<TaskMapping, DatastoreOptions>, taskKind: TaskKind, handler: (task: Task<TaskKind, TaskMapping[TaskKind]>) => Promise<void>, backOffStrategy: BackoffStrategy, config?: Partial<SimpleProcessorConfig>);
-    /**
-     * Validates that the task handler timeout is less than the claim stale timeout.
-     * Throws an error if the validation fails.
-     * This ensures that the task handler has enough time to complete before the task is considered stale.
-     * This is important to prevent tasks from being claimed again while they are still being processed.
-     *
-     * @throws {Error} If the task handler timeout is greater than or equal to the claim stale timeout.
-     */
-    private validatedHandlerTimeout;
-    /**
-     * Starts multiple concurrent process loops that claim and process tasks.
-     * Max concurrent processes is defined by the `maxConcurrency` property set in the constructor.
-     */
-    start(): Promise<void>;
-    /**
-     * Stops the processor by signaling all process loops to exit,
-     * then waits for all process loops to finish before resolving.
-     */
-    stop(): Promise<void>;
-    /**
-     * The main loop that processes tasks.
-     *
-     * @param exitChannel The channel to signal when the loop exits.
-     */
-    private runProcessLoop;
-    /**
-     * Handles a task by calling the handler and marking it as complete or failed.
-     *
-     * Emits:
-     * - `task.completed` when the task is successfully completed.
-     * - `task.failed` when the task fails.
-     * - `task.complete.failed` when the task fails to mark as completed.
-     *
-     * @param task The task to handle.
-     */
-    private handleTask;
-    private handleTaskError;
-}
-export {};

package/build/processors/simple-processor.js

@@ -1,161 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SimpleProcessor = void 0;
-const node_stream_1 = require("node:stream");
-const promises_1 = require("node:timers/promises");
-const promise_utils_1 = require("../utils/promise-utils");
-const events_1 = require("./events");
-const DEFAULT_CONFIG = {
-    maxConcurrency: 1,
-    claimIntervalMs: 50,
-    idleIntervalMs: 5_000,
-    claimStaleTimeoutMs: 10_000,
-    taskHandlerTimeoutMs: 5_000,
-    taskHandlerMaxRetries: 5,
-    processLoopRetryIntervalMs: 20_000,
-};
-const InternalProcessorEvents = { PROCESSOR_LOOP_EXIT: 'processorLoopExit' };
-class SimpleProcessor extends node_stream_1.EventEmitter {
-    datastore;
-    taskKind;
-    handler;
-    backOffStrategy;
-    config;
-    exitChannels = [];
-    stopRequested = false;
-    constructor(datastore, taskKind, handler, backOffStrategy, config) {
-        super();
-        this.datastore = datastore;
-        this.taskKind = taskKind;
-        this.handler = handler;
-        this.backOffStrategy = backOffStrategy;
-        this.config = {
-            ...DEFAULT_CONFIG,
-            ...config,
-        };
-        this.validatedHandlerTimeout();
-    }
-    /**
-     * Validates that the task handler timeout is less than the claim stale timeout.
-     * Throws an error if the validation fails.
-     * This ensures that the task handler has enough time to complete before the task is considered stale.
-     * This is important to prevent tasks from being claimed again while they are still being processed.
-     *
-     * @throws {Error} If the task handler timeout is greater than or equal to the claim stale timeout.
-     */
-    validatedHandlerTimeout() {
-        if (this.config.taskHandlerTimeoutMs >= this.config.claimStaleTimeoutMs) {
-            throw new Error(`Task handler timeout (${this.config.taskHandlerTimeoutMs}ms) must be less than the claim stale timeout (${this.config.claimStaleTimeoutMs}ms)`);
-        }
-    }
-    /**
-     * Starts multiple concurrent process loops that claim and process tasks.
-     * Max concurrent processes is defined by the `maxConcurrency` property set in the constructor.
-     */
-    async start() {
-        if (this.stopRequested || this.exitChannels.length > 0) {
-            return;
-        }
-        for (let i = 0; i < this.config.maxConcurrency; i++) {
-            const exitChannel = new node_stream_1.EventEmitter();
-            this.exitChannels.push(exitChannel);
-            this.runProcessLoop(exitChannel);
-        }
-    }
-    /**
-     * Stops the processor by signaling all process loops to exit,
-     * then waits for all process loops to finish before resolving.
-     */
-    async stop() {
-        const exitPromises = this.exitChannels.map((channel) => new Promise((resolve) => channel.once(InternalProcessorEvents.PROCESSOR_LOOP_EXIT, () => resolve(null))));
-        this.stopRequested = true;
-        await Promise.all(exitPromises);
-    }
-    /**
-     * The main loop that processes tasks.
-     *
-     * @param exitChannel The channel to signal when the loop exits.
-     */
-    async runProcessLoop(exitChannel) {
-        while (!this.stopRequested) {
-            try {
-                const task = await this.datastore.claim({
-                    kind: this.taskKind,
-                    claimStaleTimeoutMs: this.config.claimStaleTimeoutMs,
-                });
-                // If no tasks are available, wait before trying again
-                if (!task) {
-                    await (0, promises_1.setTimeout)(this.config.idleIntervalMs);
-                    continue;
-                }
-                this.emit(events_1.ProcessorEvents.TASK_CLAIMED, { task, claimedAt: task.claimedAt || new Date() });
-                // Process the task using the handler
-                await this.handleTask(task);
-                // Wait a bit before claiming the next task
-                await (0, promises_1.setTimeout)(this.config.claimIntervalMs);
-            }
-            catch (error) {
-                this.emit(events_1.ProcessorEvents.UNKNOWN_PROCESSING_ERROR, { error, timestamp: new Date() });
-                await (0, promises_1.setTimeout)(this.config.processLoopRetryIntervalMs);
-            }
-        }
-        exitChannel.emit(InternalProcessorEvents.PROCESSOR_LOOP_EXIT);
-    }
-    /**
-     * Handles a task by calling the handler and marking it as complete or failed.
-     *
-     * Emits:
-     * - `task.completed` when the task is successfully completed.
-     * - `task.failed` when the task fails.
-     * - `task.complete.failed` when the task fails to mark as completed.
-     *
-     * @param task The task to handle.
-     */
-    async handleTask(task) {
-        try {
-            await (0, promise_utils_1.promiseWithTimeout)(this.handler(task), this.config.taskHandlerTimeoutMs);
-        }
-        catch (error) {
-            await this.handleTaskError(task, error);
-            return;
-        }
-        try {
-            const completedTask = await this.datastore.complete(task.id);
-            this.emit(events_1.ProcessorEvents.TASK_COMPLETED, {
-                task: completedTask,
-                completedAt: completedTask.completedAt || new Date(),
-            });
-        }
-        catch (error) {
-            this.emit(events_1.ProcessorEvents.TASK_COMPLETION_FAILURE, {
-                error: error,
-                failedAt: new Date(),
-                task,
-            });
-        }
-    }
-    async handleTaskError(task, error) {
-        const failedAt = new Date();
-        if (task.retryCount >= this.config.taskHandlerMaxRetries) {
-            // Mark the task as failed
-            await this.datastore.fail(task.id);
-            this.emit(events_1.ProcessorEvents.TASK_FAILED, {
-                task,
-                error,
-                failedAt,
-            });
-            return;
-        }
-        const delay = this.backOffStrategy({ retryAttempt: task.retryCount });
-        const retryAt = new Date(Date.now() + delay);
-        await this.datastore.retry(task.id, retryAt);
-        this.emit(events_1.ProcessorEvents.TASK_RETRY_SCHEDULED, {
-            task,
-            error,
-            errorAt: failedAt,
-            retryScheduledAt: retryAt,
-        });
-    }
-}
-exports.SimpleProcessor = SimpleProcessor;
-//# sourceMappingURL=simple-processor.js.map

package/build/processors/simple-processor.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"simple-processor.js","sourceRoot":"","sources":["../../src/processors/simple-processor.ts"],"names":[],"mappings":";;;AAAA,6CAA2C;AAC3C,mDAAkD;AAKlD,0DAA4D;AAC5D,qCAAoE;AAGpE,MAAM,cAAc,GAA0B;IAC5C,cAAc,EAAE,CAAC;IACjB,eAAe,EAAE,EAAE;IACnB,cAAc,EAAE,KAAK;IACrB,mBAAmB,EAAE,MAAM;IAC3B,oBAAoB,EAAE,KAAK;IAC3B,qBAAqB,EAAE,CAAC;IACxB,0BAA0B,EAAE,MAAM;CACnC,CAAC;AAYF,MAAM,uBAAuB,GAAG,EAAE,mBAAmB,EAAE,mBAAmB,EAAW,CAAC;AAOtF,MAAa,eAKX,SAAQ,0BAAuD;IASrD;IACA;IACA;IACA;IATF,MAAM,CAAwB;IAE9B,YAAY,GAA+C,EAAE,CAAC;IAC9D,aAAa,GAAG,KAAK,CAAC;IAE9B,YACU,SAAmD,EACnD,QAAkB,EAClB,OAAuE,EACvE,eAAgC,EACxC,MAAuC;QAEvC,KAAK,EAAE,CAAC;QANA,cAAS,GAAT,SAAS,CAA0C;QACnD,aAAQ,GAAR,QAAQ,CAAU;QAClB,YAAO,GAAP,OAAO,CAAgE;QACvE,oBAAe,GAAf,eAAe,CAAiB;QAKxC,IAAI,CAAC,MAAM,GAAG;YACZ,GAAG,cAAc;YACjB,GAAG,MAAM;SACV,CAAC;QAEF,IAAI,CAAC,uBAAuB,EAAE,CAAC;IACjC,CAAC;IAED;;;;;;;OAOG;IACK,uBAAuB;QAC7B,IAAI,IAAI,CAAC,MAAM,CAAC,oBAAoB,IAAI,IAAI,CAAC,MAAM,CAAC,mBAAmB,EAAE,CAAC;YACxE,MAAM,IAAI,KAAK,CACb,yBAAyB,IAAI,CAAC,MAAM,CAAC,oBAAoB,kDAAkD,IAAI,CAAC,MAAM,CAAC,mBAAmB,KAAK,CAChJ,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvD,OAAO;QACT,CAAC;QAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC,EAAE,EAAE,CAAC;YACpD,MAAM,WAAW,GAAG,IAAI,0BAAY,EAA8B,CAAC;YAEnE,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YACpC,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,IAAI;QACR,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CACxC,CAAC,OAAO,EAAE,EAAE,CACV,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,uBAAuB,CAAC,mBAAmB,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAC3G,CAAC;QAEF,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;QAE1B,MAAM,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAClC,CAAC;IAED;;;;OAIG;IACK,KAAK,CAAC,cAAc,CAAC,WAAqD;QAChF,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YAC3B,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;oBACtC,IAAI,EAAE,IAAI,CAAC,QAAQ;oBACnB,mBAAmB,EAAE,IAAI,CAAC,MAAM,CAAC,mBAAmB;iBACrD,CAAC,CAAC;gBAEH,sDAAsD;gBACtD,IAAI,CAAC,IAAI,EAAE,CAAC;oBACV,MAAM,IAAA,qBAAU,EAAC,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;oBAE7C,SAAS;gBACX,CAAC;gBAED,IAAI,CAAC,IAAI,CAAC,wBAAe,CAAC,YAAY,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,IAAI,IAAI,EAAE,EAAE,CAAC,CAAC;gBAE3F,qCAAqC;gBACrC,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;gBAE5B,2CAA2C;gBAC3C,MAAM,IAAA,qBAAU,EAAC,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;YAChD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,IAAI,CAAC,wBAAe,CAAC,wBAAwB,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,EAAE,CAAC,CAAC;gBAEtF,MAAM,IAAA,qBAAU,EAAC,IAAI,CAAC,MAAM,CAAC,0BAA0B,CAAC,CAAC;YAC3D,CAAC;QACH,CAAC;QAED,WAAW,CAAC,IAAI,CAAC,uBAAuB,CAAC,mBAAmB,CAAC,CAAC;IAChE,CAAC;IAED;;;;;;;;;OASG;IACK,KAAK,CAAC,UAAU,CAAC,IAA2C;QAClE,IAAI,CAAC;YACH,MAAM,IAAA,kCAAkB,EAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;QACjF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,CAAC,eAAe,CAAC,IAAI,EAAE,KAAc,CAAC,CAAC;YAEjD,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAW,IAAI,CAAC,EAAE,CAAC,CAAC;YAEvE,IAAI,CAAC,IAAI,CAAC,wBAAe,CAAC,cAAc,EAAE;gBACxC,IAAI,EAAE,aAAa;gBACnB,WAAW,EAAE,aAAa,CAAC,WAAW,IAAI,IAAI,IAAI,EAAE;aACrD,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,IAAI,CAAC,wBAAe,CAAC,uBAAuB,EAAE;gBACjD,KAAK,EAAE,KAAK;gBACZ,QAAQ,EAAE,IAAI,IAAI,EAAE;gBACpB,IAAI;aACL,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,eAAe,CAAC,IAA2C,EAAE,KAAY;QACrF,MAAM,QAAQ,GAAG,IAAI,IAAI,EAAE,CAAC;QAC5B,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,MAAM,CAAC,qBAAqB,EAAE,CAAC;YACzD,0BAA0B;YAC1B,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACnC,IAAI,CAAC,IAAI,CAAC,wBAAe,CAAC,WAAW,EAAE;gBACrC,IAAI;gBACJ,KAAK;gBACL,QAAQ;aACT,CAAC,CAAC;YAEH,OAAO;QACT,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,eAAe,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;QACtE,MAAM,OAAO,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,CAAC;QAE7C,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QAC7C,IAAI,CAAC,IAAI,CAAC,wBAAe,CAAC,oBAAoB,EAAE;YAC9C,IAAI;YACJ,KAAK;YACL,OAAO,EAAE,QAAQ;YACjB,gBAAgB,EAAE,OAAO;SAC1B,CAAC,CAAC;IACL,CAAC;CACF;AA/KD,0CA+KC"}

package/build/scheduler.d.ts

@@ -1,9 +0,0 @@
-export interface Task<T> {
-    run(): Promise<T>;
-}
-export declare class Scheduler<T> {
-    #private;
-    constructor();
-    schedule(task: Task<T>): Promise<boolean>;
-    run(): Promise<boolean>;
-}

package/build/scheduler.js

@@ -1,21 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Scheduler = void 0;
-class Scheduler {
-    #tasks = [];
-    constructor() {
-        this.#tasks = [];
-    }
-    async schedule(task) {
-        this.#tasks.push(task);
-        return true;
-    }
-    async run() {
-        for (const task of this.#tasks) {
-            task.run();
-        }
-        return true;
-    }
-}
-exports.Scheduler = Scheduler;
-//# sourceMappingURL=scheduler.js.map

package/build/scheduler.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"scheduler.js","sourceRoot":"","sources":["../src/scheduler.ts"],"names":[],"mappings":";;;AAIA,MAAa,SAAS;IACpB,MAAM,GAAc,EAAE,CAAC;IAEvB;QACE,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;IACnB,CAAC;IAEM,KAAK,CAAC,QAAQ,CAAC,IAAa;QACjC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEvB,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,KAAK,CAAC,GAAG;QACd,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAC/B,IAAI,CAAC,GAAG,EAAE,CAAC;QACb,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AApBD,8BAoBC"}

package/build/task.d.ts

@@ -1,33 +0,0 @@
-export declare const TaskStatus: {
-    readonly PENDING: "PENDING";
-    readonly CLAIMED: "CLAIMED";
-    readonly COMPLETED: "COMPLETED";
-    readonly FAILED: "FAILED";
-};
-export type TaskStatus = (typeof TaskStatus)[keyof typeof TaskStatus];
-export type Task<TaskKind, TaskData> = {
-    /** A unique identifier for the task */
-    id: string;
-    /** A human-readable name or type for the task */
-    kind: TaskKind;
-    /** The current status of the task */
-    status: TaskStatus;
-    /** The payload or data associated with the task */
-    data: TaskData;
-    /** The priority level of the task (lower numbers can indicate higher priority) */
-    priority?: number;
-    /** A key used for idempotency to prevent duplicate processing */
-    idempotencyKey?: string;
-    /** The original scheduled date when the task was first intended to run */
-    originalScheduleDate: Date;
-    /** The current scheduled execution date, which may change if rescheduled */
-    scheduledAt: Date;
-    /** The date the task is mark 'claimed */
-    claimedAt?: Date;
-    /** The date the task is mark 'completed' */
-    completedAt?: Date;
-    /** The date when the task was last executed (if any) */
-    lastExecutedAt?: Date;
-    /** A counter to track the number of times the task has been retried */
-    retryCount: number;
-};