@workglow/job-queue 0.0.52

package/dist/job/JobQueue.d.ts

@@ -0,0 +1,272 @@
+/**
+ * @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 { IJobQueue, JobQueueOptions, JobStatus, QueueMode } from "./IJobQueue";
+import { Job, JobConstructorParam } from "./Job";
+import { JobError } from "./JobError";
+import { JobProgressListener, JobQueueEventListener, JobQueueEventListeners, JobQueueEventParameters, JobQueueEvents } from "./JobQueueEventListeners";
+/**
+ * Statistics tracked for the job queue
+ */
+export interface JobQueueStats {
+    totalJobs: number;
+    completedJobs: number;
+    failedJobs: number;
+    abortedJobs: number;
+    retriedJobs: number;
+    disabledJobs: number;
+    averageProcessingTime?: number;
+    lastUpdateTime: Date;
+}
+type JobClass<Input, Output> = new (param: JobConstructorParam<Input, Output>) => Job<Input, Output>;
+/**
+ * Base class for implementing job queues with different storage backends.
+ */
+export declare class JobQueue<Input, Output, QueueJob extends Job<Input, Output> = Job<Input, Output>> implements IJobQueue<Input, Output> {
+    /**
+     * The name of the queue
+     */
+    readonly queueName: string;
+    /**
+     * The class of the job to be used in the queue
+     */
+    readonly jobClass: JobClass<Input, Output>;
+    /**
+     * The options for the queue
+     */
+    protected options: JobQueueOptions<Input, Output>;
+    constructor(queueName: string, jobClass: JobClass<Input, Output>, options: JobQueueOptions<Input, Output>);
+    /**
+     * Gets a job from the queue
+     * @param id The ID of the job to get
+     */
+    get(id: unknown): Promise<Job<Input, Output> | undefined>;
+    /**
+     * Adds a job to the queue
+     * @param job The job to add
+     */
+    add(job: QueueJob): Promise<unknown>;
+    /**
+     * Gets the next job from the queue
+     */
+    next(): Promise<Job<Input, Output> | undefined>;
+    /**
+     * Peek into the queue
+     * @param status The status of the job to peek at
+     * @param num The number of jobs to peek at
+     */
+    peek(status?: JobStatus, num?: number): Promise<Job<Input, Output>[]>;
+    /**
+     * Gets the size of the queue
+     * @param status The status of the jobs to get the size of
+     */
+    size(status?: JobStatus): Promise<number>;
+    /**
+     * Deletes a job from the queue
+     * @param id The ID of the job to delete
+     */
+    delete(id: unknown): Promise<void>;
+    disable(id: unknown): Promise<void>;
+    /**
+     * Returns current queue statistics
+     */
+    getStats(): JobQueueStats;
+    /**
+     * Gets the output for an input
+     * @param input The input to get the output for
+     */
+    outputForInput(input: Input): Promise<Output | null>;
+    /**
+     * Executes a job with the provided abort signal.
+     * Can be overridden by implementations to add custom execution logic.
+     */
+    executeJob(job: Job<Input, Output>, signal: AbortSignal): Promise<Output>;
+    /**
+     * Returns a promise that resolves when the job completes
+     */
+    waitFor(jobId: unknown): Promise<Output | undefined>;
+    /**
+     * Reconstructs an error instance from a stored failed job
+     */
+    protected buildErrorFromJob(job: Job<Input, Output>): JobError;
+    /**
+     * Updates the progress of a job
+     * @param jobId - The ID of the job to update
+     * @param progress - Progress value between 0 and 100
+     * @param message - Optional message describing the current progress state
+     * @param details - Optional structured data about the progress
+     * @returns A promise that resolves when the progress is updated
+     * @note If the job is completed, failed, or aborted, the progress will not be updated
+     */
+    updateProgress(jobId: unknown, progress: number, message?: string, details?: Record<string, any> | null): Promise<void>;
+    /**
+     * Adds a progress listener for a specific job
+     * @param jobId - The ID of the job to listen to
+     * @param listener - The callback function to be called when progress updates occur
+     * @returns A cleanup function to remove the listener
+     */
+    onJobProgress(jobId: unknown, listener: JobProgressListener): () => void;
+    /**
+     * Starts the job queue based on its operating mode
+     */
+    start(mode?: QueueMode): Promise<this>;
+    /**
+     * Stops the job queue and aborts all active jobs
+     */
+    stop(): Promise<this>;
+    /**
+     * Clears all jobs and resets queue state
+     */
+    clear(): Promise<this>;
+    /**
+     * Restarts the job queue
+     */
+    restart(): Promise<this>;
+    /**
+     * Aborts all jobs in a job run
+     */
+    abortJobRun(jobRunId: string): Promise<void>;
+    /**
+     * Gets jobs by run ID
+     * @param runId The ID of the run to get jobs for
+     */
+    getJobsByRunId(runId: string): Promise<Job<Input, Output>[]>;
+    /**
+     * Registers an event listener for job queue events
+     */
+    on<Event extends JobQueueEvents>(event: Event, listener: JobQueueEventListener<Event>): void;
+    /**
+     * Removes an event listener for job queue events
+     */
+    off<Event extends JobQueueEvents>(event: Event, listener: JobQueueEventListener<Event>): void;
+    /**
+     * Adds an event listener for job queue events that will be called only once
+     */
+    once<Event extends JobQueueEvents>(event: Event, listener: JobQueueEventListener<Event>): void;
+    /**
+     * Returns a promise that resolves when the event is emitted
+     */
+    waitOn<Event extends JobQueueEvents>(event: Event): Promise<JobQueueEventParameters<Event, Input, Output>>;
+    /**
+     * The limiter for the queue
+     */
+    protected readonly limiter: ILimiter;
+    /**
+     * The storage for the queue
+     */
+    protected readonly storage: IQueueStorage<Input, Output>;
+    /**
+     * Whether the queue is running
+     */
+    protected running: boolean;
+    /**
+     * The stats for the queue
+     */
+    protected stats: JobQueueStats;
+    /**
+     * The event emitter for the queue
+     */
+    protected events: EventEmitter<JobQueueEventListeners<Input, Output>>;
+    /**
+     * The map of jobs to their promises for this worker instance
+     */
+    protected activeJobAbortControllers: Map<unknown, AbortController>;
+    /**
+     * Map of jobs to their promises for this worker instance
+     * If this is both a server and client we can short-circuit
+     * job aborting, wait on job completion, etc.
+     */
+    protected activeJobPromises: Map<unknown, Array<{
+        resolve: (value?: any) => void;
+        reject: (err: JobError) => void;
+    }>>;
+    protected processingTimes: Map<unknown, number>;
+    protected mode: QueueMode;
+    protected jobProgressListeners: Map<unknown, Set<JobProgressListener>>;
+    protected lastKnownProgress: Map<unknown, {
+        progress: number;
+        message: string;
+        details: Record<string, any> | null;
+    }>;
+    /**
+     * Saves the progress for a job
+     * @param id The ID of the job to save progress for
+     * @param progress The progress of the job
+     * @param message The message of the job
+     * @param details The details of the job
+     */
+    private saveProgress;
+    /**
+     * Creates an abort controller for a job and adds it to the activeJobSignals map
+     */
+    protected createAbortController(jobId: unknown): AbortController;
+    /**
+     * Validates the state of a job before processing
+     */
+    protected validateJobState(job: Job<Input, Output>): Promise<void>;
+    /**
+     * Normalizes different types of errors into JobError instances
+     */
+    protected normalizeError(err: any): JobError;
+    /**
+     * Updates average processing time statistics
+     */
+    protected updateAverageProcessingTime(): void;
+    /**
+     * Emits updated statistics
+     */
+    protected emitStatsUpdate(): void;
+    protected announceProgress(jobId: unknown, progress: number, message: string, details: Record<string, any> | null): void;
+    /**
+     * Creates a new job instance from the provided database results.
+     * @param details - The job data from the database
+     * @returns A new Job instance with populated properties
+     */
+    protected storageToClass(details: JobStorageFormat<Input, Output>): Job<Input, Output>;
+    /**
+     * Converts a Job instance to a JobDetails object
+     * @param job - The Job instance to convert
+     * @returns A JobDetails object with the same properties as the Job instance
+     */
+    classToStorage(job: Job<Input, Output>): JobStorageFormat<Input, Output>;
+    protected rescheduleJob(job: Job<Input, Output>, retryDate?: Date): Promise<void>;
+    protected disableJob(job: Job<Input, Output>): Promise<void>;
+    protected failJob(job: Job<Input, Output>, error: JobError): Promise<void>;
+    protected completeJob(job: Job<Input, Output>, output?: Output): Promise<void>;
+    /**
+     * Signals the abort of a job
+     * @param jobId The ID of the job to abort
+     */
+    abort(jobId: unknown): Promise<void>;
+    /**
+     * Handles the abort of a job
+     * @param jobId The ID of the job to abort
+     */
+    protected handleAbort(jobId: unknown): Promise<void>;
+    /**
+     * Processes a job and handles its lifecycle including runAttempts and error handling
+     */
+    protected processSingleJob(job: Job<Input, Output>): Promise<void>;
+    /**
+     * Main job processing loop
+     */
+    protected processJobs(): Promise<void>;
+    protected cleanUpJobs(): Promise<void>;
+    /**
+     * Monitors jobs that have progress listeners attached
+     * Polls for updates to jobs being processed elsewhere
+     * Only emits events when progress state has changed
+     */
+    protected monitorJobs(): Promise<void>;
+    /**
+     * Fixes stuck jobs when the server restarts
+     */
+    protected fixupJobs(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=JobQueue.d.ts.map

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

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

package/dist/job/JobQueueEventListeners.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { EventParameters } from "@workglow/util";
+import { JobQueueStats } from "./JobQueue";
+/**
+ * Events that can be emitted by the JobQueue
+ */
+export type JobQueueEventListeners<Input, Output> = {
+    queue_start: (queueName: string) => void;
+    queue_stop: (queueName: string) => void;
+    job_start: (queueName: string, jobId: unknown) => void;
+    job_aborting: (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;
+    queue_stats_update: (queueName: string, stats: JobQueueStats) => void;
+    job_progress: (queueName: string, jobId: unknown, progress: number, message: string, details: Record<string, any> | null) => void;
+};
+export type JobQueueEvents = keyof JobQueueEventListeners<any, any>;
+export type JobQueueEventListener<Event extends JobQueueEvents> = JobQueueEventListeners<any, any>[Event];
+export type JobQueueEventParameters<Event extends JobQueueEvents, Input, Output> = EventParameters<JobQueueEventListeners<Input, Output>, Event>;
+/**
+ * Type for progress event listener callback
+ */
+export type JobProgressListener = (progress: number, message: string, details: Record<string, any> | null) => void;
+//# sourceMappingURL=JobQueueEventListeners.d.ts.map

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

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

package/dist/limiter/CompositeLimiter.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { ILimiter } from "./ILimiter";
+export declare class CompositeLimiter implements ILimiter {
+    private limiters;
+    constructor(limiters?: ILimiter[]);
+    addLimiter(limiter: ILimiter): void;
+    canProceed(): Promise<boolean>;
+    recordJobStart(): Promise<void>;
+    recordJobCompletion(): Promise<void>;
+    getNextAvailableTime(): Promise<Date>;
+    setNextAvailableTime(date: Date): Promise<void>;
+    clear(): Promise<void>;
+}
+//# sourceMappingURL=CompositeLimiter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CompositeLimiter.d.ts","sourceRoot":"","sources":["../../src/limiter/CompositeLimiter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,qBAAa,gBAAiB,YAAW,QAAQ;IAC/C,OAAO,CAAC,QAAQ,CAAkB;gBAEtB,QAAQ,GAAE,QAAQ,EAAO;IAIrC,UAAU,CAAC,OAAO,EAAE,QAAQ,GAAG,IAAI;IAI7B,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC;IAS9B,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAI/B,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAIpC,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;IAWrC,oBAAoB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAM/C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}

package/dist/limiter/ConcurrencyLimiter.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { ILimiter } from "./ILimiter";
+export declare const CONCURRENT_JOB_LIMITER: import("@workglow/util").ServiceToken<ILimiter>;
+/**
+ * Concurrency limiter that limits the number of concurrent jobs.
+ */
+export declare class ConcurrencyLimiter implements ILimiter {
+    private currentRunningJobs;
+    private readonly maxConcurrentJobs;
+    private readonly timeSliceInMilliseconds;
+    private nextAllowedStartTime;
+    constructor(maxConcurrentJobs: number, timeSliceInMilliseconds?: number);
+    canProceed(): Promise<boolean>;
+    recordJobStart(): Promise<void>;
+    recordJobCompletion(): Promise<void>;
+    getNextAvailableTime(): Promise<Date>;
+    setNextAvailableTime(date: Date): Promise<void>;
+    clear(): Promise<void>;
+}
+//# sourceMappingURL=ConcurrencyLimiter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ConcurrencyLimiter.d.ts","sourceRoot":"","sources":["../../src/limiter/ConcurrencyLimiter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,eAAO,MAAM,sBAAsB,iDAA8D,CAAC;AAElG;;GAEG;AACH,qBAAa,kBAAmB,YAAW,QAAQ;IACjD,OAAO,CAAC,kBAAkB,CAAa;IACvC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAS;IACjD,OAAO,CAAC,oBAAoB,CAAoB;gBAEpC,iBAAiB,EAAE,MAAM,EAAE,uBAAuB,GAAE,MAAa;IAKvE,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC;IAO9B,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAO/B,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAIpC,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;IAMrC,oBAAoB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAM/C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAI7B"}

package/dist/limiter/DelayLimiter.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { ILimiter } from "./ILimiter";
+export declare class DelayLimiter implements ILimiter {
+    private delayInMilliseconds;
+    private nextAvailableTime;
+    constructor(delayInMilliseconds?: number);
+    canProceed(): Promise<boolean>;
+    recordJobStart(): Promise<void>;
+    recordJobCompletion(): Promise<void>;
+    getNextAvailableTime(): Promise<Date>;
+    setNextAvailableTime(date: Date): Promise<void>;
+    clear(): Promise<void>;
+}
+//# sourceMappingURL=DelayLimiter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DelayLimiter.d.ts","sourceRoot":"","sources":["../../src/limiter/DelayLimiter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,qBAAa,YAAa,YAAW,QAAQ;IAE/B,OAAO,CAAC,mBAAmB;IADvC,OAAO,CAAC,iBAAiB,CAAoB;gBACzB,mBAAmB,GAAE,MAAW;IAE9C,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC;IAI9B,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAI/B,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAIpC,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrC,oBAAoB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAK/C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}

package/dist/limiter/EvenlySpacedRateLimiter.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { ILimiter, RateLimiterOptions } from "./ILimiter";
+export declare const EVENLY_SPACED_JOB_RATE_LIMITER: import("@workglow/util").ServiceToken<ILimiter>;
+/**
+ * Rate limiter that spreads requests evenly across a time window.
+ * Instead of allowing all requests up to the limit and then waiting,
+ * this limiter spaces out the requests evenly across the window.
+ */
+export declare class EvenlySpacedRateLimiter implements ILimiter {
+    private readonly maxExecutions;
+    private readonly windowSizeMs;
+    private readonly idealInterval;
+    private nextAvailableTime;
+    private lastStartTime;
+    private durations;
+    constructor({ maxExecutions, windowSizeInSeconds }: RateLimiterOptions);
+    /** Can we start a new job right now? */
+    canProceed(): Promise<boolean>;
+    /** Record that a job is starting now. */
+    recordJobStart(): Promise<void>;
+    /**
+     * Call this when a job finishes.
+     * We measure its duration, update our running-average,
+     * and then compute how long to wait before the next job start.
+     */
+    recordJobCompletion(): Promise<void>;
+    getNextAvailableTime(): Promise<Date>;
+    setNextAvailableTime(date: Date): Promise<void>;
+    clear(): Promise<void>;
+}
+//# sourceMappingURL=EvenlySpacedRateLimiter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"EvenlySpacedRateLimiter.d.ts","sourceRoot":"","sources":["../../src/limiter/EvenlySpacedRateLimiter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAE1D,eAAO,MAAM,8BAA8B,iDAE1C,CAAC;AAEF;;;;GAIG;AACH,qBAAa,uBAAwB,YAAW,QAAQ;IACtD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,iBAAiB,CAAsB;IAC/C,OAAO,CAAC,aAAa,CAAa;IAClC,OAAO,CAAC,SAAS,CAAgB;gBAErB,EAAE,aAAa,EAAE,mBAAmB,EAAE,EAAE,kBAAkB;IAatE,wCAAwC;IAClC,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC;IAKpC,yCAAyC;IACnC,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBrC;;;;OAIG;IACG,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IASpC,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrC,oBAAoB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAO/C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAK7B"}

package/dist/limiter/ILimiter.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export declare const JOB_LIMITER: import("@workglow/util").ServiceToken<ILimiter>;
+/**
+ * Interface for a job limiter.
+ */
+export interface ILimiter {
+    canProceed(): Promise<boolean>;
+    recordJobStart(): Promise<void>;
+    recordJobCompletion(): Promise<void>;
+    getNextAvailableTime(): Promise<Date>;
+    setNextAvailableTime(date: Date): Promise<void>;
+    clear(): Promise<void>;
+}
+export interface RateLimiterOptions {
+    readonly maxExecutions: number;
+    readonly windowSizeInSeconds: number;
+}
+export interface RateLimiterWithBackoffOptions extends RateLimiterOptions {
+    readonly initialBackoffDelay?: number;
+    readonly backoffMultiplier?: number;
+    readonly maxBackoffDelay?: number;
+}
+//# sourceMappingURL=ILimiter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ILimiter.d.ts","sourceRoot":"","sources":["../../src/limiter/ILimiter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,eAAO,MAAM,WAAW,iDAAmD,CAAC;AAE5E;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/B,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,oBAAoB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;CACtC;AAED,MAAM,WAAW,6BAA8B,SAAQ,kBAAkB;IACvE,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;CACnC"}

package/dist/limiter/InMemoryRateLimiter.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { ILimiter, RateLimiterWithBackoffOptions } from "./ILimiter";
+export declare const MEMORY_JOB_RATE_LIMITER: import("@workglow/util").ServiceToken<ILimiter>;
+/**
+ * In-memory implementation of a rate limiter.
+ * Manages request counts and delays to control job execution.
+ */
+export declare class InMemoryRateLimiter implements ILimiter {
+    private requests;
+    private nextAvailableTime;
+    private currentBackoffDelay;
+    private readonly maxExecutions;
+    private readonly windowSizeInMilliseconds;
+    private readonly initialBackoffDelay;
+    private readonly backoffMultiplier;
+    private readonly maxBackoffDelay;
+    constructor({ maxExecutions, windowSizeInSeconds, initialBackoffDelay, backoffMultiplier, maxBackoffDelay, }: RateLimiterWithBackoffOptions);
+    private removeOldRequests;
+    private increaseBackoff;
+    private addJitter;
+    canProceed(): Promise<boolean>;
+    recordJobStart(): Promise<void>;
+    recordJobCompletion(): Promise<void>;
+    getNextAvailableTime(): Promise<Date>;
+    setNextAvailableTime(date: Date): Promise<void>;
+    clear(): Promise<void>;
+}
+//# sourceMappingURL=InMemoryRateLimiter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"InMemoryRateLimiter.d.ts","sourceRoot":"","sources":["../../src/limiter/InMemoryRateLimiter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,QAAQ,EAAE,6BAA6B,EAAE,MAAM,YAAY,CAAC;AAErE,eAAO,MAAM,uBAAuB,iDAA+D,CAAC;AAEpG;;;GAGG;AACH,qBAAa,mBAAoB,YAAW,QAAQ;IAClD,OAAO,CAAC,QAAQ,CAAc;IAC9B,OAAO,CAAC,iBAAiB,CAAc;IACvC,OAAO,CAAC,mBAAmB,CAAS;IAEpC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAAS;IAClD,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAS;IAC7C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;gBAE7B,EACV,aAAa,EACb,mBAAmB,EACnB,mBAA2B,EAC3B,iBAAqB,EACrB,eAAyB,GAC1B,EAAE,6BAA6B;IAyBhC,OAAO,CAAC,iBAAiB;IAWzB,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,SAAS;IAKX,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC;IAiB9B,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAW/B,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAIpC,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;IAKrC,oBAAoB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAM/C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAK7B"}

package/dist/limiter/NullLimiter.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { ILimiter } from "./ILimiter";
+export declare const NULL_JOB_LIMITER: import("@workglow/util").ServiceToken<ILimiter>;
+/**
+ * Null limiter that does nothing.
+ */
+export declare class NullLimiter implements ILimiter {
+    canProceed(): Promise<boolean>;
+    recordJobStart(): Promise<void>;
+    recordJobCompletion(): Promise<void>;
+    getNextAvailableTime(): Promise<Date>;
+    setNextAvailableTime(date: Date): Promise<void>;
+    clear(): Promise<void>;
+}
+//# sourceMappingURL=NullLimiter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"NullLimiter.d.ts","sourceRoot":"","sources":["../../src/limiter/NullLimiter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,eAAO,MAAM,gBAAgB,iDAAwD,CAAC;AAEtF;;GAEG;AACH,qBAAa,WAAY,YAAW,QAAQ;IACpC,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC;IAI9B,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAI/B,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAIpC,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrC,oBAAoB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}

package/dist/limiter/PostgresRateLimiter.d.ts

@@ -0,0 +1,53 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { ILimiter, RateLimiterWithBackoffOptions } from "@workglow/job-queue";
+import { Pool } from "pg";
+export declare const POSTGRES_JOB_RATE_LIMITER: import("@workglow/util").ServiceToken<ILimiter>;
+/**
+ * PostgreSQL implementation of a rate limiter.
+ * Manages request counts and delays to control job execution.
+ */
+export declare class PostgresRateLimiter implements ILimiter {
+    protected readonly db: Pool;
+    private readonly queueName;
+    private readonly windowSizeInMilliseconds;
+    private currentBackoffDelay;
+    constructor(db: Pool, queueName: string, { maxExecutions, windowSizeInSeconds, initialBackoffDelay, backoffMultiplier, maxBackoffDelay, }: RateLimiterWithBackoffOptions);
+    private readonly maxExecutions;
+    private readonly initialBackoffDelay;
+    private readonly backoffMultiplier;
+    private readonly maxBackoffDelay;
+    private dbPromise;
+    private addJitter;
+    private increaseBackoff;
+    ensureTableExists(): Promise<void>;
+    /**
+     * Clears all rate limit entries for this queue.
+     */
+    clear(): Promise<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.
+     * @returns The ID of the added job
+     */
+    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>;
+}
+//# sourceMappingURL=PostgresRateLimiter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PostgresRateLimiter.d.ts","sourceRoot":"","sources":["../../src/limiter/PostgresRateLimiter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,6BAA6B,EAAE,MAAM,qBAAqB,CAAC;AAE9E,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAE1B,eAAO,MAAM,yBAAyB,iDAErC,CAAC;AAEF;;;GAGG;AACH,qBAAa,mBAAoB,YAAW,QAAQ;IAKhD,SAAS,CAAC,QAAQ,CAAC,EAAE,EAAE,IAAI;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAL5B,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAAS;IAClD,OAAO,CAAC,mBAAmB,CAAS;gBAGf,EAAE,EAAE,IAAI,EACV,SAAS,EAAE,MAAM,EAClC,EACE,aAAa,EACb,mBAAmB,EACnB,mBAA2B,EAC3B,iBAAqB,EACrB,eAAyB,GAC1B,EAAE,6BAA6B;IA2BlC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAS;IAC7C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,SAAS,CAAgB;IAEjC,OAAO,CAAC,SAAS;IAKjB,OAAO,CAAC,eAAe;IAOV,iBAAiB;IAgB9B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAU5B;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC;IA0CpC;;;OAGG;IACG,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IA0B/B,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAI1C;;;OAGG;IACG,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;IAyC3C;;;OAGG;IACG,oBAAoB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;CAatD"}

package/dist/limiter/SqliteRateLimiter.d.ts

@@ -0,0 +1,44 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { ILimiter, RateLimiterWithBackoffOptions } from "@workglow/job-queue";
+import type { Sqlite } from "@workglow/sqlite";
+export declare const SQLITE_JOB_RATE_LIMITER: import("@workglow/util").ServiceToken<ILimiter>;
+/**
+ * SQLite implementation of a rate limiter.
+ * Manages request counts and delays to control job execution.
+ */
+export declare class SqliteRateLimiter implements ILimiter {
+    private readonly db;
+    private readonly queueName;
+    private readonly windowSizeInMilliseconds;
+    private currentBackoffDelay;
+    constructor(db: Sqlite.Database, queueName: string, { maxExecutions, windowSizeInSeconds, initialBackoffDelay, backoffMultiplier, maxBackoffDelay, }: RateLimiterWithBackoffOptions);
+    private readonly maxExecutions;
+    private readonly initialBackoffDelay;
+    private readonly backoffMultiplier;
+    private readonly maxBackoffDelay;
+    private addJitter;
+    private increaseBackoff;
+    ensureTableExists(): this;
+    /**
+     * Clears all rate limit entries for this queue.
+     */
+    clear(): Promise<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.
+     * @returns The ID of the added job
+     */
+    recordJobStart(): Promise<void>;
+    recordJobCompletion(): Promise<void>;
+    getNextAvailableTime(): Promise<Date>;
+    setNextAvailableTime(date: Date): Promise<void>;
+}
+//# sourceMappingURL=SqliteRateLimiter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SqliteRateLimiter.d.ts","sourceRoot":"","sources":["../../src/limiter/SqliteRateLimiter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,6BAA6B,EAAE,MAAM,qBAAqB,CAAC;AAC9E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAG/C,eAAO,MAAM,uBAAuB,iDAA+D,CAAC;AAEpG;;;GAGG;AACH,qBAAa,iBAAkB,YAAW,QAAQ;IAChD,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAkB;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAAS;IAClD,OAAO,CAAC,mBAAmB,CAAS;gBAGlC,EAAE,EAAE,MAAM,CAAC,QAAQ,EACnB,SAAS,EAAE,MAAM,EACjB,EACE,aAAa,EACb,mBAAmB,EACnB,mBAA2B,EAC3B,iBAAqB,EACrB,eAAyB,GAC1B,EAAE,6BAA6B;IA6BlC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAS;IAC7C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IAEzC,OAAO,CAAC,SAAS;IAKjB,OAAO,CAAC,eAAe;IAOhB,iBAAiB;IAiBxB;;OAEG;IACG,KAAK;IASX;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC;IAqCpC;;;OAGG;IACG,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAuB/B,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAIpC,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;IAuCrC,oBAAoB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;CAWtD"}