@workglow/job-queue 0.0.57 → 0.0.58

package/dist/job/Job.d.ts

@@ -3,9 +3,9 @@
  * Copyright 2025 Steven Roussey <sroussey@gmail.com>
  * SPDX-License-Identifier: Apache-2.0
  */
-import { JobStatus } from "./IJobQueue";
-import type { JobQueue } from "./JobQueue";
+import { JobStatus } from "@workglow/storage";
 import type { JobProgressListener } from "./JobQueueEventListeners";
+export { JobStatus };
 /**
  * Context for job execution
  */
@@ -63,12 +63,11 @@ export declare class Job<Input, Output> {
     progress: number;
     progressMessage: string;
     progressDetails: Record<string, any> | null;
-    queue: JobQueue<Input, Output> | undefined;
     constructor({ queueName, input, jobRunId, id, error, errorCode, fingerprint, output, maxRetries, createdAt, completedAt, status, deadlineAt, runAttempts, lastRanAt, runAfter, progress, progressMessage, progressDetails, }: JobConstructorParam<Input, Output>);
     execute(input: Input, context: IJobExecuteContext): Promise<Output>;
     private progressListeners;
     /**
-     * Update the job's progress
+     * Update the job's progress (for direct execution without a worker)
      * @param progress - Progress value between 0 and 100
      * @param message - Optional progress message
      * @param details - Optional progress details

package/dist/job/Job.d.ts.map

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

package/dist/job/JobQueueClient.d.ts

@@ -0,0 +1,171 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { IQueueStorage, JobStatus, JobStorageFormat } from "@workglow/storage";
+import { EventEmitter } from "@workglow/util";
+import { Job } from "./Job";
+import { JobError } from "./JobError";
+import { JobProgressListener, JobQueueEventListener, JobQueueEventListeners, JobQueueEventParameters, JobQueueEvents } from "./JobQueueEventListeners";
+import type { JobQueueServer } from "./JobQueueServer";
+/**
+ * Handle returned when submitting a job, providing methods to interact with the job
+ */
+export interface JobHandle<Output> {
+    readonly id: unknown;
+    waitFor(): Promise<Output>;
+    abort(): Promise<void>;
+    onProgress(callback: JobProgressListener): () => void;
+}
+/**
+ * Options for creating a JobQueueClient
+ */
+export interface JobQueueClientOptions<Input, Output> {
+    readonly storage: IQueueStorage<Input, Output>;
+    readonly queueName: string;
+}
+/**
+ * Client for submitting jobs and monitoring their progress.
+ * Connect to a JobQueueServer for same-process optimization,
+ * or use storage subscriptions for cross-process communication.
+ */
+export declare class JobQueueClient<Input, Output> {
+    readonly queueName: string;
+    protected readonly storage: IQueueStorage<Input, Output>;
+    protected readonly events: EventEmitter<JobQueueEventListeners<Input, Output>>;
+    protected server: JobQueueServer<Input, Output> | null;
+    protected storageUnsubscribe: (() => void) | null;
+    /**
+     * Map of job IDs to their pending promise resolvers
+     */
+    protected readonly activeJobPromises: Map<unknown, Array<{
+        resolve: (value: Output) => void;
+        reject: (err: JobError) => void;
+    }>>;
+    /**
+     * Map of job IDs to their progress listeners
+     */
+    protected readonly jobProgressListeners: Map<unknown, Set<JobProgressListener>>;
+    /**
+     * Last known progress state for each job
+     */
+    protected readonly lastKnownProgress: Map<unknown, {
+        readonly progress: number;
+        readonly message: string;
+        readonly details: Record<string, unknown> | null;
+    }>;
+    constructor(options: JobQueueClientOptions<Input, Output>);
+    /**
+     * Attach to a local JobQueueServer for same-process event optimization.
+     * When attached, events flow directly from server without storage polling.
+     */
+    attach(server: JobQueueServer<Input, Output>): void;
+    /**
+     * Detach from the current server
+     */
+    detach(): void;
+    /**
+     * Connect to storage for cross-process communication (when no local server).
+     * Uses storage subscriptions to receive job updates.
+     */
+    connect(): void;
+    /**
+     * Disconnect from storage subscriptions
+     */
+    disconnect(): void;
+    /**
+     * Submit a job to the queue
+     */
+    submit(input: Input, options?: {
+        readonly jobRunId?: string;
+        readonly fingerprint?: string;
+        readonly maxRetries?: number;
+        readonly runAfter?: Date;
+        readonly deadlineAt?: Date;
+    }): Promise<JobHandle<Output>>;
+    /**
+     * Submit multiple jobs to the queue
+     */
+    submitBatch(inputs: readonly Input[], options?: {
+        readonly jobRunId?: string;
+        readonly maxRetries?: number;
+    }): Promise<readonly JobHandle<Output>[]>;
+    /**
+     * Get a job by ID
+     */
+    getJob(id: unknown): Promise<Job<Input, Output> | undefined>;
+    /**
+     * Get jobs by run ID
+     */
+    getJobsByRunId(runId: string): Promise<readonly Job<Input, Output>[]>;
+    /**
+     * Peek at jobs in the queue
+     */
+    peek(status?: JobStatus, num?: number): Promise<readonly Job<Input, Output>[]>;
+    /**
+     * Get the size of the queue
+     */
+    size(status?: JobStatus): Promise<number>;
+    /**
+     * Get the output for an input (if job completed)
+     */
+    outputForInput(input: Input): Promise<Output | null>;
+    /**
+     * Wait for a job to complete
+     */
+    waitFor(jobId: unknown): Promise<Output>;
+    /**
+     * Abort a job
+     */
+    abort(jobId: unknown): Promise<void>;
+    /**
+     * Abort all jobs in a job run
+     */
+    abortJobRun(jobRunId: string): Promise<void>;
+    /**
+     * Subscribe to progress updates for a specific job
+     */
+    onJobProgress(jobId: unknown, listener: JobProgressListener): () => void;
+    on<Event extends JobQueueEvents>(event: Event, listener: JobQueueEventListener<Event>): void;
+    off<Event extends JobQueueEvents>(event: Event, listener: JobQueueEventListener<Event>): void;
+    once<Event extends JobQueueEvents>(event: Event, listener: JobQueueEventListener<Event>): void;
+    waitOn<Event extends JobQueueEvents>(event: Event): Promise<JobQueueEventParameters<Event, Input, Output>>;
+    /**
+     * Called by server when a job starts processing
+     * @internal
+     */
+    handleJobStart(jobId: unknown): void;
+    /**
+     * Called by server when a job completes
+     * @internal
+     */
+    handleJobComplete(jobId: unknown, output: Output): void;
+    /**
+     * Called by server when a job fails
+     * @internal
+     */
+    handleJobError(jobId: unknown, error: string, errorCode?: string): void;
+    /**
+     * Called by server when a job is disabled
+     * @internal
+     */
+    handleJobDisabled(jobId: unknown): void;
+    /**
+     * Called by server when a job is retried
+     * @internal
+     */
+    handleJobRetry(jobId: unknown, runAfter: Date): void;
+    /**
+     * Called by server when job progress updates
+     * @internal
+     */
+    handleJobProgress(jobId: unknown, progress: number, message: string, details: Record<string, unknown> | null): void;
+    private createJobHandle;
+    private cleanupJob;
+    private handleStorageChange;
+    protected storageToClass(details: JobStorageFormat<Input, Output>): Job<Input, Output>;
+    protected buildErrorFromJob(job: Job<Input, Output>): JobError;
+    protected buildErrorFromCode(message: string, errorCode?: string): JobError;
+}
+//# sourceMappingURL=JobQueueClient.d.ts.map

package/dist/job/JobQueueClient.d.ts.map

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

package/dist/job/JobQueueEventListeners.d.ts

@@ -4,7 +4,7 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import { EventParameters } from "@workglow/util";
-import { JobQueueStats } from "./JobQueue";
+import { JobQueueStats } from "./JobQueueServer";
 /**
  * Events that can be emitted by the JobQueue
  */

package/dist/job/JobQueueEventListeners.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"JobQueueEventListeners.d.ts","sourceRoot":"","sources":["../../src/job/JobQueueEventListeners.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C;;GAEG;AACH,MAAM,MAAM,sBAAsB,CAAC,KAAK,EAAE,MAAM,IAAI;IAClD,WAAW,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,UAAU,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,SAAS,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACvD,YAAY,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAC1D,YAAY,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1E,SAAS,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACtE,YAAY,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAC1D,SAAS,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,KAAK,IAAI,CAAC;IACvE,kBAAkB,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IACtE,YAAY,EAAE,CACZ,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,KAChC,IAAI,CAAC;CACX,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,MAAM,sBAAsB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AAEpE,MAAM,MAAM,qBAAqB,CAAC,KAAK,SAAS,cAAc,IAAI,sBAAsB,CACtF,GAAG,EACH,GAAG,CACJ,CAAC,KAAK,CAAC,CAAC;AAET,MAAM,MAAM,uBAAuB,CAAC,KAAK,SAAS,cAAc,EAAE,KAAK,EAAE,MAAM,IAAI,eAAe,CAChG,sBAAsB,CAAC,KAAK,EAAE,MAAM,CAAC,EACrC,KAAK,CACN,CAAC;AACF;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAChC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,KAChC,IAAI,CAAC"}
+{"version":3,"file":"JobQueueEventListeners.d.ts","sourceRoot":"","sources":["../../src/job/JobQueueEventListeners.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD;;GAEG;AACH,MAAM,MAAM,sBAAsB,CAAC,KAAK,EAAE,MAAM,IAAI;IAClD,WAAW,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,UAAU,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,SAAS,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACvD,YAAY,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAC1D,YAAY,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1E,SAAS,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACtE,YAAY,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAC1D,SAAS,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,KAAK,IAAI,CAAC;IACvE,kBAAkB,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IACtE,YAAY,EAAE,CACZ,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,KAChC,IAAI,CAAC;CACX,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,MAAM,sBAAsB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AAEpE,MAAM,MAAM,qBAAqB,CAAC,KAAK,SAAS,cAAc,IAAI,sBAAsB,CACtF,GAAG,EACH,GAAG,CACJ,CAAC,KAAK,CAAC,CAAC;AAET,MAAM,MAAM,uBAAuB,CAAC,KAAK,SAAS,cAAc,EAAE,KAAK,EAAE,MAAM,IAAI,eAAe,CAChG,sBAAsB,CAAC,KAAK,EAAE,MAAM,CAAC,EACrC,KAAK,CACN,CAAC;AACF;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAChC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,KAChC,IAAI,CAAC"}

package/dist/job/JobQueueServer.d.ts

@@ -0,0 +1,160 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { IQueueStorage, JobStorageFormat } from "@workglow/storage";
+import { EventEmitter } from "@workglow/util";
+import { ILimiter } from "../limiter/ILimiter";
+import { Job, JobConstructorParam } from "./Job";
+import { JobQueueClient } from "./JobQueueClient";
+import { JobQueueWorker } from "./JobQueueWorker";
+/**
+ * Statistics tracked for the job queue
+ */
+export interface JobQueueStats {
+    readonly totalJobs: number;
+    readonly completedJobs: number;
+    readonly failedJobs: number;
+    readonly abortedJobs: number;
+    readonly retriedJobs: number;
+    readonly disabledJobs: number;
+    readonly averageProcessingTime?: number;
+    readonly lastUpdateTime: Date;
+}
+/**
+ * Events emitted by JobQueueServer
+ */
+export type JobQueueServerEventListeners<Input, Output> = {
+    server_start: (queueName: string) => void;
+    server_stop: (queueName: string) => void;
+    stats_update: (queueName: string, stats: JobQueueStats) => void;
+    job_start: (queueName: string, jobId: unknown) => void;
+    job_complete: (queueName: string, jobId: unknown, output: Output) => void;
+    job_error: (queueName: string, jobId: unknown, error: string) => void;
+    job_disabled: (queueName: string, jobId: unknown) => void;
+    job_retry: (queueName: string, jobId: unknown, runAfter: Date) => void;
+    job_progress: (queueName: string, jobId: unknown, progress: number, message: string, details: Record<string, unknown> | null) => void;
+};
+export type JobQueueServerEvents = keyof JobQueueServerEventListeners<unknown, unknown>;
+/**
+ * Options for creating a JobQueueServer
+ */
+export interface JobQueueServerOptions<Input, Output> {
+    readonly storage: IQueueStorage<Input, Output>;
+    readonly queueName: string;
+    readonly limiter?: ILimiter;
+    readonly workerCount?: number;
+    readonly pollIntervalMs?: number;
+    readonly deleteAfterCompletionMs?: number;
+    readonly deleteAfterFailureMs?: number;
+    readonly deleteAfterDisabledMs?: number;
+    readonly cleanupIntervalMs?: number;
+}
+type JobClass<Input, Output> = new (param: JobConstructorParam<Input, Output>) => Job<Input, Output>;
+/**
+ * Server that coordinates multiple workers and manages the job queue lifecycle.
+ * Handles stuck job recovery, cleanup, and aggregates statistics.
+ */
+export declare class JobQueueServer<Input, Output, QueueJob extends Job<Input, Output> = Job<Input, Output>> {
+    readonly queueName: string;
+    protected readonly storage: IQueueStorage<Input, Output>;
+    protected readonly jobClass: JobClass<Input, Output>;
+    protected readonly limiter: ILimiter;
+    protected readonly workerCount: number;
+    protected readonly pollIntervalMs: number;
+    protected readonly deleteAfterCompletionMs?: number;
+    protected readonly deleteAfterFailureMs?: number;
+    protected readonly deleteAfterDisabledMs?: number;
+    protected readonly cleanupIntervalMs: number;
+    protected readonly events: EventEmitter<JobQueueServerEventListeners<Input, Output>>;
+    protected readonly workers: JobQueueWorker<Input, Output, QueueJob>[];
+    protected readonly clients: Set<JobQueueClient<Input, Output>>;
+    protected running: boolean;
+    protected cleanupTimer: ReturnType<typeof setTimeout> | null;
+    protected stats: JobQueueStats;
+    constructor(jobClass: JobClass<Input, Output>, options: JobQueueServerOptions<Input, Output>);
+    /**
+     * Start the server and all workers
+     */
+    start(): Promise<this>;
+    /**
+     * Stop the server and all workers
+     */
+    stop(): Promise<this>;
+    /**
+     * Get the current queue statistics
+     */
+    getStats(): JobQueueStats;
+    /**
+     * Get the storage instance (for client connection)
+     */
+    getStorage(): IQueueStorage<Input, Output>;
+    /**
+     * Scale the number of workers
+     */
+    scaleWorkers(count: number): Promise<void>;
+    /**
+     * Check if the server is running
+     */
+    isRunning(): boolean;
+    /**
+     * Get the number of workers
+     */
+    getWorkerCount(): number;
+    /**
+     * Add a client for same-process event forwarding
+     * @internal
+     */
+    addClient(client: JobQueueClient<Input, Output>): void;
+    /**
+     * Remove a client
+     * @internal
+     */
+    removeClient(client: JobQueueClient<Input, Output>): void;
+    on<Event extends JobQueueServerEvents>(event: Event, listener: JobQueueServerEventListeners<Input, Output>[Event]): void;
+    off<Event extends JobQueueServerEvents>(event: Event, listener: JobQueueServerEventListeners<Input, Output>[Event]): void;
+    /**
+     * Initialize workers
+     */
+    protected initializeWorkers(): void;
+    /**
+     * Create a new worker and wire up event forwarding
+     */
+    protected createWorker(): JobQueueWorker<Input, Output, QueueJob>;
+    /**
+     * Forward events to all attached clients
+     */
+    protected forwardToClients(method: "handleJobStart", jobId: unknown): void;
+    protected forwardToClients(method: "handleJobComplete", jobId: unknown, output: Output): void;
+    protected forwardToClients(method: "handleJobError", jobId: unknown, error: string, errorCode?: string): void;
+    protected forwardToClients(method: "handleJobDisabled", jobId: unknown): void;
+    protected forwardToClients(method: "handleJobRetry", jobId: unknown, runAfter: Date): void;
+    protected forwardToClients(method: "handleJobProgress", jobId: unknown, progress: number, message: string, details: Record<string, unknown> | null): void;
+    /**
+     * Update average processing time from all workers
+     */
+    protected updateAverageProcessingTime(): void;
+    /**
+     * Start the cleanup loop
+     */
+    protected startCleanupLoop(): void;
+    /**
+     * Clean up completed/failed jobs based on TTL settings
+     */
+    protected cleanupJobs(): Promise<void>;
+    /**
+     * Fix stuck jobs from previous server runs
+     */
+    protected fixupJobs(): Promise<void>;
+    /**
+     * Convert storage format to Job class
+     */
+    protected storageToClass(details: JobStorageFormat<Input, Output>): Job<Input, Output>;
+    /**
+     * Convert Job class to storage format
+     */
+    protected classToStorage(job: Job<Input, Output>): JobStorageFormat<Input, Output>;
+}
+export {};
+//# sourceMappingURL=JobQueueServer.d.ts.map

package/dist/job/JobQueueServer.d.ts.map

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

package/dist/job/JobQueueWorker.d.ts

@@ -0,0 +1,157 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { IQueueStorage, JobStorageFormat } from "@workglow/storage";
+import { EventEmitter } from "@workglow/util";
+import { ILimiter } from "../limiter/ILimiter";
+import { Job, JobConstructorParam } from "./Job";
+import { JobError } from "./JobError";
+/**
+ * Events emitted by JobQueueWorker
+ */
+export type JobQueueWorkerEventListeners<Input, Output> = {
+    job_start: (jobId: unknown) => void;
+    job_complete: (jobId: unknown, output: Output) => void;
+    job_error: (jobId: unknown, error: string, errorCode?: string) => void;
+    job_disabled: (jobId: unknown) => void;
+    job_retry: (jobId: unknown, runAfter: Date) => void;
+    job_progress: (jobId: unknown, progress: number, message: string, details: Record<string, unknown> | null) => void;
+    worker_start: () => void;
+    worker_stop: () => void;
+};
+export type JobQueueWorkerEvents = keyof JobQueueWorkerEventListeners<unknown, unknown>;
+/**
+ * Options for creating a JobQueueWorker
+ */
+export interface JobQueueWorkerOptions<Input, Output> {
+    readonly storage: IQueueStorage<Input, Output>;
+    readonly queueName: string;
+    readonly limiter?: ILimiter;
+    readonly pollIntervalMs?: number;
+}
+type JobClass<Input, Output> = new (param: JobConstructorParam<Input, Output>) => Job<Input, Output>;
+/**
+ * Worker that processes jobs from the queue.
+ * Reports progress and completion back to storage.
+ */
+export declare class JobQueueWorker<Input, Output, QueueJob extends Job<Input, Output> = Job<Input, Output>> {
+    readonly queueName: string;
+    readonly workerId: string;
+    protected readonly storage: IQueueStorage<Input, Output>;
+    protected readonly jobClass: JobClass<Input, Output>;
+    protected readonly limiter: ILimiter;
+    protected readonly pollIntervalMs: number;
+    protected readonly events: EventEmitter<JobQueueWorkerEventListeners<Input, Output>>;
+    protected running: boolean;
+    /**
+     * Abort controllers for active jobs
+     */
+    protected readonly activeJobAbortControllers: Map<unknown, AbortController>;
+    /**
+     * Processing times for statistics
+     */
+    protected readonly processingTimes: Map<unknown, number>;
+    constructor(jobClass: JobClass<Input, Output>, options: JobQueueWorkerOptions<Input, Output>);
+    /**
+     * Start the worker processing loop
+     */
+    start(): Promise<this>;
+    /**
+     * Stop the worker and abort any active jobs
+     */
+    stop(): Promise<this>;
+    /**
+     * Process a single job manually (useful for testing or manual control)
+     */
+    processNext(): Promise<boolean>;
+    /**
+     * Check if the worker is currently running
+     */
+    isRunning(): boolean;
+    /**
+     * Get the number of active jobs being processed
+     */
+    getActiveJobCount(): number;
+    /**
+     * Get average processing time
+     */
+    getAverageProcessingTime(): number | undefined;
+    on<Event extends JobQueueWorkerEvents>(event: Event, listener: JobQueueWorkerEventListeners<Input, Output>[Event]): void;
+    off<Event extends JobQueueWorkerEvents>(event: Event, listener: JobQueueWorkerEventListeners<Input, Output>[Event]): void;
+    /**
+     * Get the next job from the queue
+     */
+    protected next(): Promise<QueueJob | undefined>;
+    /**
+     * Main job processing loop
+     */
+    protected processJobs(): Promise<void>;
+    /**
+     * Check for jobs that have been marked for abort and trigger their abort controllers
+     */
+    protected checkForAbortingJobs(): Promise<void>;
+    /**
+     * Process a single job
+     */
+    protected processSingleJob(job: Job<Input, Output>): Promise<void>;
+    /**
+     * Execute a job with the provided abort signal
+     */
+    protected executeJob(job: Job<Input, Output>, signal: AbortSignal): Promise<Output>;
+    /**
+     * Update progress for a job
+     */
+    protected updateProgress(jobId: unknown, progress: number, message?: string, details?: Record<string, unknown> | null): Promise<void>;
+    /**
+     * Mark a job as completed
+     */
+    protected completeJob(job: Job<Input, Output>, output?: Output): Promise<void>;
+    /**
+     * Mark a job as failed
+     */
+    protected failJob(job: Job<Input, Output>, error: JobError): Promise<void>;
+    /**
+     * Mark a job as disabled
+     */
+    protected disableJob(job: Job<Input, Output>): Promise<void>;
+    /**
+     * Reschedule a job for retry
+     */
+    protected rescheduleJob(job: Job<Input, Output>, retryDate?: Date): Promise<void>;
+    /**
+     * Create an abort controller for a job
+     */
+    protected createAbortController(jobId: unknown): AbortController;
+    /**
+     * Handle job abort
+     */
+    protected handleAbort(jobId: unknown): Promise<void>;
+    /**
+     * Get a job by ID
+     */
+    protected getJob(id: unknown): Promise<Job<Input, Output> | undefined>;
+    /**
+     * Validate job state before processing
+     */
+    protected validateJobState(job: Job<Input, Output>): Promise<void>;
+    /**
+     * Normalize errors into JobError instances
+     */
+    protected normalizeError(err: unknown): JobError;
+    /**
+     * Clean up job state after completion/failure
+     */
+    protected cleanupJob(jobId: unknown): void;
+    /**
+     * Convert storage format to Job class
+     */
+    protected storageToClass(details: JobStorageFormat<Input, Output>): Job<Input, Output>;
+    /**
+     * Convert Job class to storage format
+     */
+    protected classToStorage(job: Job<Input, Output>): JobStorageFormat<Input, Output>;
+}
+export {};
+//# sourceMappingURL=JobQueueWorker.d.ts.map

package/dist/job/JobQueueWorker.d.ts.map

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

package/dist/limiter/RateLimiter.d.ts

@@ -0,0 +1,49 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { IRateLimiterStorage } from "@workglow/storage";
+import { ILimiter, RateLimiterWithBackoffOptions } from "./ILimiter";
+/**
+ * Base rate limiter implementation that uses a storage backend.
+ * Manages request counts and delays to control job execution.
+ */
+export declare class RateLimiter implements ILimiter {
+    protected readonly storage: IRateLimiterStorage;
+    protected readonly queueName: string;
+    protected readonly windowSizeInMilliseconds: number;
+    protected currentBackoffDelay: number;
+    protected readonly maxExecutions: number;
+    protected readonly initialBackoffDelay: number;
+    protected readonly backoffMultiplier: number;
+    protected readonly maxBackoffDelay: number;
+    constructor(storage: IRateLimiterStorage, queueName: string, { maxExecutions, windowSizeInSeconds, initialBackoffDelay, backoffMultiplier, maxBackoffDelay, }: RateLimiterWithBackoffOptions);
+    protected addJitter(base: number): number;
+    protected increaseBackoff(): void;
+    /**
+     * Checks if a job can proceed based on rate limiting rules.
+     * @returns True if the job can proceed, false otherwise
+     */
+    canProceed(): Promise<boolean>;
+    /**
+     * Records a new job attempt.
+     */
+    recordJobStart(): Promise<void>;
+    recordJobCompletion(): Promise<void>;
+    /**
+     * Retrieves the next available time for the specific queue.
+     * @returns The next available time
+     */
+    getNextAvailableTime(): Promise<Date>;
+    /**
+     * Sets the next available time for the specific queue.
+     * @param date - The new next available time
+     */
+    setNextAvailableTime(date: Date): Promise<void>;
+    /**
+     * Clears all rate limit entries for this queue.
+     */
+    clear(): Promise<void>;
+}
+//# sourceMappingURL=RateLimiter.d.ts.map

package/dist/limiter/RateLimiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RateLimiter.d.ts","sourceRoot":"","sources":["../../src/limiter/RateLimiter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,6BAA6B,EAAE,MAAM,YAAY,CAAC;AAErE;;;GAGG;AACH,qBAAa,WAAY,YAAW,QAAQ;IASxC,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,mBAAmB;IAC/C,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM;IATtC,SAAS,CAAC,QAAQ,CAAC,wBAAwB,EAAE,MAAM,CAAC;IACpD,SAAS,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACtC,SAAS,CAAC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IACzC,SAAS,CAAC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IAC/C,SAAS,CAAC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IAC7C,SAAS,CAAC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;gBAGtB,OAAO,EAAE,mBAAmB,EAC5B,SAAS,EAAE,MAAM,EACpC,EACE,aAAa,EACb,mBAAmB,EACnB,mBAA2B,EAC3B,iBAAqB,EACrB,eAAyB,GAC1B,EAAE,6BAA6B;IA0BlC,SAAS,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAKzC,SAAS,CAAC,eAAe,IAAI,IAAI;IAOjC;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC;IA+BpC;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAqB/B,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAI1C;;;OAGG;IACG,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;IA0B3C;;;OAGG;IACG,oBAAoB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrD;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAI7B"}