@workglow/storage 0.2.27 → 0.2.28

package/dist/queue/PostgresQueueStorage.d.ts

@@ -1,154 +0,0 @@
-/**
- * @license
- * Copyright 2025 Steven Roussey <sroussey@gmail.com>
- * SPDX-License-Identifier: Apache-2.0
- */
-import type { Pool } from "@workglow/storage/postgres";
-import { IQueueStorage, JobStatus, JobStorageFormat, PrefixColumn, QueueChangePayload, QueueStorageOptions, QueueSubscribeOptions } from "./IQueueStorage";
-export declare const POSTGRES_QUEUE_STORAGE: import("@workglow/util").ServiceToken<IQueueStorage<any, any>>;
-/**
- * PostgreSQL implementation of a job queue.
- * Provides storage and retrieval for job execution states using PostgreSQL.
- */
-export declare class PostgresQueueStorage<Input, Output> implements IQueueStorage<Input, Output> {
-    protected readonly db: Pool;
-    protected readonly queueName: string;
-    readonly scope: "cluster";
-    /** The prefix column definitions */
-    protected readonly prefixes: readonly PrefixColumn[];
-    /** The prefix values for filtering */
-    protected readonly prefixValues: Readonly<Record<string, string | number>>;
-    /** The table name for the job queue */
-    protected readonly tableName: string;
-    constructor(db: Pool, queueName: string, options?: QueueStorageOptions);
-    /**
-     * Gets the SQL column type for a prefix column
-     */
-    private getPrefixColumnType;
-    /**
-     * Builds the prefix columns SQL for CREATE TABLE
-     */
-    private buildPrefixColumnsSql;
-    /**
-     * Builds prefix column names for use in queries
-     */
-    private getPrefixColumnNames;
-    /**
-     * Builds WHERE clause conditions for prefix filtering
-     * @param startParam - The starting parameter number for parameterized queries
-     * @returns Object with conditions string and parameter values
-     */
-    private buildPrefixWhereClause;
-    /**
-     * Gets prefix values as an array in column order
-     */
-    private getPrefixParamValues;
-    setupDatabase(): Promise<void>;
-    /**
-     * Channel name for this storage's LISTEN/NOTIFY. Mirrors the trigger's
-     * computation so subscriber and notifier agree.
-     */
-    private notifyChannelName;
-    /**
-     * Adds a new job to the queue.
-     * @param job - The job to add
-     * @returns The ID of the added job
-     */
-    add(job: JobStorageFormat<Input, Output>): Promise<unknown>;
-    /**
-     * Retrieves a job by its ID.
-     * @param id - The ID of the job to retrieve
-     * @returns The job if found, undefined otherwise
-     */
-    get(id: unknown): Promise<JobStorageFormat<Input, Output> | undefined>;
-    /**
-     * Retrieves a slice of jobs from the queue.
-     * @param num - Maximum number of jobs to return
-     * @returns An array of jobs
-     */
-    peek(status?: JobStatus, num?: number): Promise<Array<JobStorageFormat<Input, Output>>>;
-    /**
-     * Retrieves the next available job that is ready to be processed.
-     * @param workerId - Worker ID to associate with the job (required)
-     * @returns The next job or undefined if no job is available
-     */
-    next(workerId: string): Promise<JobStorageFormat<Input, Output> | undefined>;
-    /**
-     * Retrieves the number of jobs in the queue with a specific status.
-     * @param status - The status of the jobs to count
-     * @returns The count of jobs with the specified status
-     */
-    size(status?: "PENDING"): Promise<number>;
-    /**
-     * Marks a job as complete with its output or error.
-     * Enhanced error handling:
-     * - For a retryable error, increments run_attempts and updates run_after.
-     * - Marks a job as FAILED immediately for permanent or generic errors.
-     */
-    complete(jobDetails: JobStorageFormat<Input, Output>): Promise<void>;
-    /**
-     * Clears all jobs from the queue.
-     */
-    deleteAll(): Promise<void>;
-    /**
-     * Looks up cached output for a given input
-     * Uses input fingerprinting for efficient matching
-     * @returns The cached output or null if not found
-     */
-    outputForInput(input: Input): Promise<Output | null>;
-    /**
-     * Aborts a job by setting its status to "ABORTING".
-     * This method will signal the corresponding AbortController so that
-     * the job's execute() method (if it supports an AbortSignal parameter)
-     * can clean up and exit.
-     */
-    abort(jobId: unknown): Promise<void>;
-    /**
-     * Releases a claimed job back to PENDING without incrementing run_attempts.
-     * @param jobId - The id of the claimed job to release.
-     */
-    release(jobId: unknown): Promise<void>;
-    /**
-     * Retrieves all jobs for a given job run ID.
-     * @param job_run_id - The ID of the job run to retrieve
-     * @returns An array of jobs
-     */
-    getByRunId(job_run_id: string): Promise<Array<JobStorageFormat<Input, Output>>>;
-    /**
-     * Implements the abstract saveProgress method from JobQueue
-     */
-    saveProgress(jobId: unknown, progress: number, message: string, details: Record<string, any>): Promise<void>;
-    /**
-     * Deletes a job by its ID
-     */
-    delete(jobId: unknown): Promise<void>;
-    /**
-     * Delete jobs with a specific status older than a cutoff date
-     * @param status - Status of jobs to delete
-     * @param olderThanMs - Delete jobs completed more than this many milliseconds ago
-     */
-    deleteJobsByStatusAndAge(status: JobStatus, olderThanMs: number): Promise<void>;
-    /**
-     * Subscribe to INSERT/UPDATE notifications via PostgreSQL LISTEN/NOTIFY.
-     * Replaces 100ms-poll fallback for cluster Postgres deployments — workers
-     * wake within network-latency of an actual change rather than on a timer.
-     *
-     * Acquires a dedicated client from the pool (LISTEN occupies a connection
-     * for its lifetime). On unsubscribe, runs UNLISTEN and releases the client.
-     * On connection loss, attempts to reconnect with bounded backoff and
-     * re-LISTEN. After every successful (re)connect — including the initial
-     * one — emits a synthetic `{ type: "RESYNC" }` event so subscribers can
-     * re-poll state and pick up any rows inserted during the disconnect window
-     * (or between subscribe and the first NOTIFY landing).
-     *
-     * Throws synchronously when the underlying pool lacks `connect()`
-     * (single-connection wrappers like PGLite) so the caller's try/catch can
-     * fall back to polling. JobQueueServer.start does this and logs at debug.
-     *
-     * `options.prefixFilter` follows {@link QueueSubscribeOptions.prefixFilter}:
-     * `undefined` means "use the storage instance's configured prefixValues",
-     * `{}` means "receive all changes regardless of prefix".
-     */
-    subscribeToChanges(callback: (change: QueueChangePayload<Input, Output>) => void, options?: QueueSubscribeOptions): () => void;
-}
-//# sourceMappingURL=PostgresQueueStorage.d.ts.map

package/dist/queue/PostgresQueueStorage.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"PostgresQueueStorage.d.ts","sourceRoot":"","sources":["../../src/queue/PostgresQueueStorage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AAEvD,OAAO,EACL,aAAa,EACb,SAAS,EACT,gBAAgB,EAChB,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,iBAAiB,CAAC;AAEzB,eAAO,MAAM,sBAAsB,gEAElC,CAAC;AAgBF;;;GAGG;AACH,qBAAa,oBAAoB,CAAC,KAAK,EAAE,MAAM,CAAE,YAAW,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC;IAUpF,SAAS,CAAC,QAAQ,CAAC,EAAE,EAAE,IAAI;IAC3B,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM;IAVtC,SAAgB,KAAK,EAAG,SAAS,CAAU;IAC3C,oCAAoC;IACpC,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,CAAC;IACrD,sCAAsC;IACtC,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC;IAC3E,uCAAuC;IACvC,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAErC,YACqB,EAAE,EAAE,IAAI,EACR,SAAS,EAAE,MAAM,EACpC,OAAO,CAAC,EAAE,mBAAmB,EAqB9B;IAED;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAI3B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAS7B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAI5B;;;;OAIG;IACH,OAAO,CAAC,sBAAsB;IAY9B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAIf,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAwG1C;IAED;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAQzB;;;;OAIG;IACU,GAAG,CAAC,GAAG,EAAE,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CA0DvE;IAED;;;;OAIG;IACU,GAAG,CAAC,EAAE,EAAE,OAAO,GAAG,OAAO,CAAC,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC,CAalF;IAED;;;;OAIG;IACU,IAAI,CACf,MAAM,GAAE,SAA6B,EACrC,GAAG,GAAE,MAAY,GAChB,OAAO,CAAC,KAAK,CAAC,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAmBjD;IAED;;;;OAIG;IACU,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC,CA0BxF;IAED;;;;OAIG;IACU,IAAI,CAAC,MAAM,YAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,CAY7D;IAED;;;;;OAKG;IACU,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAqEhF;IAED;;OAEG;IACU,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAQtC;IAED;;;;OAIG;IACU,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAYhE;IAED;;;;;OAKG;IACU,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAShD;IAED;;;OAGG;IACU,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAalD;IAED;;;;OAIG;IACU,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAS3F;IAED;;OAEG;IACU,YAAY,CACvB,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC3B,OAAO,CAAC,IAAI,CAAC,CAkBf;IAED;;OAEG;IACU,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAMjD;IAED;;;;OAIG;IACU,wBAAwB,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAW3F;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACI,kBAAkB,CACvB,QAAQ,EAAE,CAAC,MAAM,EAAE,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,EAC7D,OAAO,CAAC,EAAE,qBAAqB,GAC9B,MAAM,IAAI,CAiKZ;CACF"}

package/dist/queue/SqliteQueueStorage.d.ts

@@ -1,149 +0,0 @@
-/**
- * @license
- * Copyright 2025 Steven Roussey <sroussey@gmail.com>
- * SPDX-License-Identifier: Apache-2.0
- */
-import type { Sqlite } from "@workglow/storage/sqlite";
-import { IQueueStorage, JobStatus, JobStorageFormat, PrefixColumn, QueueChangePayload, QueueStorageOptions, QueueSubscribeOptions } from "./IQueueStorage";
-export declare const SQLITE_QUEUE_STORAGE: import("@workglow/util").ServiceToken<IQueueStorage<any, any>>;
-/**
- * Extended options for SQLite queue storage including prefix support
- */
-export interface SqliteQueueStorageOptions extends QueueStorageOptions {
-    readonly deleteAfterCompletionMs?: number;
-    readonly deleteAfterFailureMs?: number;
-}
-/**
- * SQLite implementation of a job queue.
- * Provides storage and retrieval for job execution states using SQLite.
- */
-export declare class SqliteQueueStorage<Input, Output> implements IQueueStorage<Input, Output> {
-    protected db: Sqlite.Database;
-    protected queueName: string;
-    protected options?: SqliteQueueStorageOptions | undefined;
-    /**
-     * SQLite is in-process only at the application layer (no LISTEN/NOTIFY,
-     * no shared client across processes). Even if the underlying file is
-     * shared via NFS, the queue contract requires cross-process change
-     * notification we don't provide here, so callers must treat it as
-     * `"process"` scope.
-     */
-    readonly scope: "process";
-    /** The prefix column definitions */
-    protected readonly prefixes: readonly PrefixColumn[];
-    /** The prefix values for filtering */
-    protected readonly prefixValues: Readonly<Record<string, string | number>>;
-    /** The table name for the job queue */
-    protected readonly tableName: string;
-    constructor(db: Sqlite.Database, queueName: string, options?: SqliteQueueStorageOptions | undefined);
-    /**
-     * Gets the SQL column type for a prefix column (SQLite uses TEXT for uuid)
-     */
-    private getPrefixColumnType;
-    /**
-     * Builds the prefix columns SQL for CREATE TABLE
-     */
-    private buildPrefixColumnsSql;
-    /**
-     * Builds prefix column names for use in queries
-     */
-    private getPrefixColumnNames;
-    /**
-     * Builds WHERE clause conditions for prefix filtering
-     * @returns The conditions string with placeholders
-     */
-    private buildPrefixWhereClause;
-    /**
-     * Gets prefix values as an array in column order
-     */
-    private getPrefixParamValues;
-    setupDatabase(): Promise<void>;
-    /**
-     * Adds a new job to the queue.
-     * @param job - The job to add
-     * @returns The ID of the added job
-     */
-    add(job: JobStorageFormat<Input, Output>): Promise<unknown>;
-    /**
-     * Retrieves a job by its ID.
-     * @param id - The ID of the job to retrieve
-     * @returns The job if found, undefined otherwise
-     */
-    get(id: unknown): Promise<JobStorageFormat<Input, Output> | undefined>;
-    /**
-     * Retrieves a slice of jobs from the queue.
-     * @param num - Maximum number of jobs to return
-     * @returns An array of jobs
-     */
-    peek(status?: JobStatus, num?: number): Promise<Array<JobStorageFormat<Input, Output>>>;
-    /**
-     * Aborts a job by setting its status to "ABORTING".
-     * This method will signal the corresponding AbortController so that
-     * the job's execute() method (if it supports an AbortSignal parameter)
-     * can clean up and exit.
-     */
-    abort(jobId: unknown): Promise<void>;
-    /**
-     * Releases a claimed job back to PENDING without incrementing run_attempts.
-     * @param jobId - The id of the claimed job to release.
-     */
-    release(jobId: unknown): Promise<void>;
-    /**
-     * Retrieves all jobs for a given job run ID.
-     * @param job_run_id - The ID of the job run to retrieve
-     * @returns An array of jobs
-     */
-    getByRunId(job_run_id: string): Promise<Array<JobStorageFormat<Input, Output>>>;
-    /**
-     * Retrieves the next available job that is ready to be processed,
-     * and updates its status to PROCESSING.
-     *
-     * @param workerId - Worker ID to associate with the job
-     * @returns The next job or undefined if no job is available
-     */
-    next(workerId: string): Promise<JobStorageFormat<Input, Output> | undefined>;
-    /**
-     * Retrieves the number of jobs in the queue with a specific status.
-     * @param status - The status of the jobs to count
-     * @returns The count of jobs with the specified status
-     */
-    size(status?: "PENDING"): Promise<number>;
-    /**
-     * Marks a job as complete with its output or error.
-     * Enhanced error handling:
-     * - Increments the retry count.
-     * - For a retryable error, updates run_after with the retry date.
-     * - Marks the job as FAILED for permanent or generic errors.
-     * - Marks the job as DISABLED for disabled jobs.
-     */
-    complete(job: JobStorageFormat<Input, Output>): Promise<void>;
-    deleteAll(): Promise<void>;
-    /**
-     * Looks up cached output for a given input
-     * Uses input fingerprinting for efficient matching
-     * @returns The cached output or null if not found
-     */
-    outputForInput(input: Input): Promise<Output | null>;
-    /**
-     * Implements the abstract saveProgress method from JobQueue
-     */
-    saveProgress(jobId: unknown, progress: number, message: string, details: Record<string, any>): Promise<void>;
-    /**
-     * Deletes a job by its ID
-     */
-    delete(jobId: unknown): Promise<void>;
-    /**
-     * Delete jobs with a specific status older than a cutoff date
-     * @param status - Status of jobs to delete
-     * @param olderThanMs - Delete jobs completed more than this many milliseconds ago
-     */
-    deleteJobsByStatusAndAge(status: JobStatus, olderThanMs: number): Promise<void>;
-    /**
-     * Subscribes to changes in the queue.
-     * NOT IMPLEMENTED for SQLite storage.
-     *
-     * @throws Error always - subscribeToChanges is not supported for SQLite storage
-     */
-    subscribeToChanges(callback: (change: QueueChangePayload<Input, Output>) => void, options?: QueueSubscribeOptions): () => void;
-}
-//# sourceMappingURL=SqliteQueueStorage.d.ts.map

package/dist/queue/SqliteQueueStorage.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"SqliteQueueStorage.d.ts","sourceRoot":"","sources":["../../src/queue/SqliteQueueStorage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAEvD,OAAO,EACL,aAAa,EACb,SAAS,EACT,gBAAgB,EAChB,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,iBAAiB,CAAC;AAEzB,eAAO,MAAM,oBAAoB,gEACuC,CAAC;AAQzE;;GAEG;AACH,MAAM,WAAW,yBAA0B,SAAQ,mBAAmB;IACpE,QAAQ,CAAC,uBAAuB,CAAC,EAAE,MAAM,CAAC;IAC1C,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;CACxC;AAED;;;GAGG;AACH,qBAAa,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAE,YAAW,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC;IAiBlF,SAAS,CAAC,EAAE,EAAE,MAAM,CAAC,QAAQ;IAC7B,SAAS,CAAC,SAAS,EAAE,MAAM;IAC3B,SAAS,CAAC,OAAO,CAAC,EAAE,yBAAyB;IAlB/C;;;;;;OAMG;IACH,SAAgB,KAAK,EAAG,SAAS,CAAU;IAC3C,oCAAoC;IACpC,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,CAAC;IACrD,sCAAsC;IACtC,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC;IAC3E,uCAAuC;IACvC,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAErC,YACY,EAAE,EAAE,MAAM,CAAC,QAAQ,EACnB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,yBAAyB,YAAA,EAW9C;IAED;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAI3B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAS7B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAI5B;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IAQ9B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAIf,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAoC1C;IAED;;;;OAIG;IACU,GAAG,CAAC,GAAG,EAAE,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAuDvE;IAED;;;;OAIG;IACU,GAAG,CAAC,EAAE,EAAE,OAAO,GAAG,OAAO,CAAC,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC,CAyBlF;IAED;;;;OAIG;IACU,IAAI,CACf,MAAM,GAAE,SAA6B,EACrC,GAAG,GAAE,MAAY,GAChB,OAAO,CAAC,KAAK,CAAC,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CA6BjD;IAED;;;;;OAKG;IACU,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAUhD;IAED;;;OAGG;IACU,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAclD;IAED;;;;OAIG;IACU,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAyB3F;IAED;;;;;;OAMG;IACU,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC,CA6CxF;IAED;;;;OAIG;IACU,IAAI,CAAC,MAAM,YAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,CAY7D;IAED;;;;;;;OAOG;IACU,QAAQ,CAAC,GAAG,EAAE,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CA+CzE;IAEY,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAStC;IAED;;;;OAIG;IACU,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAYhE;IAED;;OAEG;IACU,YAAY,CACvB,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC3B,OAAO,CAAC,IAAI,CAAC,CAoBf;IAED;;OAEG;IACU,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CASjD;IAED;;;;OAIG;IACU,wBAAwB,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAa3F;IAED;;;;;OAKG;IACI,kBAAkB,CACvB,QAAQ,EAAE,CAAC,MAAM,EAAE,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,EAC7D,OAAO,CAAC,EAAE,qBAAqB,GAC9B,MAAM,IAAI,CAEZ;CACF"}

package/dist/queue/SupabaseQueueStorage.d.ts

@@ -1,195 +0,0 @@
-/**
- * @license
- * Copyright 2025 Steven Roussey <sroussey@gmail.com>
- * SPDX-License-Identifier: Apache-2.0
- */
-import type { SupabaseClient } from "@supabase/supabase-js";
-import { IQueueStorage, JobStatus, JobStorageFormat, PrefixColumn, QueueChangePayload, QueueStorageOptions, QueueSubscribeOptions } from "./IQueueStorage";
-export declare const SUPABASE_QUEUE_STORAGE: import("@workglow/util").ServiceToken<IQueueStorage<any, any>>;
-/**
- * Supabase implementation of a job queue.
- * Provides storage and retrieval for job execution states using Supabase.
- */
-export declare class SupabaseQueueStorage<Input, Output> implements IQueueStorage<Input, Output> {
-    protected readonly queueName: string;
-    readonly scope: "cluster";
-    protected readonly client: SupabaseClient;
-    protected readonly prefixes: readonly PrefixColumn[];
-    protected readonly prefixValues: Readonly<Record<string, string | number>>;
-    protected readonly tableName: string;
-    private realtimeChannel;
-    private pollingManager;
-    constructor(client: SupabaseClient, queueName: string, options?: QueueStorageOptions);
-    /**
-     * Gets the SQL column type for a prefix column (Supabase supports UUID natively)
-     */
-    private getPrefixColumnType;
-    /**
-     * Builds the prefix columns SQL for CREATE TABLE
-     */
-    private buildPrefixColumnsSql;
-    /**
-     * Builds prefix column names for use in queries
-     */
-    private getPrefixColumnNames;
-    /**
-     * Applies prefix filters to a Supabase query builder
-     */
-    private applyPrefixFilters;
-    /**
-     * Gets prefix values as an object for inserts
-     */
-    private getPrefixInsertValues;
-    /**
-     * Builds WHERE clause conditions for prefix filtering with inline values (for raw SQL)
-     * @returns SQL conditions string with values inlined
-     */
-    private buildPrefixWhereSql;
-    /**
-     * Regex for validating SQL literal-safe strings.
-     * Used for quoted values (e.g. queue names/IDs) and only allows alphanumeric
-     * characters, underscores, hyphens, colons, and periods.
-     */
-    private static readonly SAFE_SQL_VALUE_RE;
-    /**
-     * Validates that a string value is safe for use as a quoted SQL literal.
-     * Throws an error if the value contains characters outside SAFE_SQL_VALUE_RE.
-     */
-    private validateSqlValue;
-    /**
-     * Escapes a string value for use in SQL
-     */
-    private escapeSqlString;
-    setupDatabase(): Promise<void>;
-    /**
-     * Adds a new job to the queue.
-     * @param job - The job to add
-     * @returns The ID of the added job
-     */
-    add(job: JobStorageFormat<Input, Output>): Promise<unknown>;
-    /**
-     * Retrieves a job by its ID.
-     * @param id - The ID of the job to retrieve
-     * @returns The job if found, undefined otherwise
-     */
-    get(id: unknown): Promise<JobStorageFormat<Input, Output> | undefined>;
-    /**
-     * Retrieves a slice of jobs from the queue.
-     * @param status - The status to filter by
-     * @param num - Maximum number of jobs to return
-     * @returns An array of jobs
-     */
-    peek(status?: JobStatus, num?: number): Promise<JobStorageFormat<Input, Output>[]>;
-    /**
-     * Retrieves the next available job that is ready to be processed.
-     * Uses atomic UPDATE with subquery SELECT FOR UPDATE SKIP LOCKED to prevent race conditions.
-     * @param workerId - Worker ID to associate with the job (required)
-     * @returns The next job or undefined if no job is available
-     */
-    next(workerId: string): Promise<JobStorageFormat<Input, Output> | undefined>;
-    /**
-     * Retrieves the number of jobs in the queue with a specific status.
-     * @param status - The status of the jobs to count
-     * @returns The count of jobs with the specified status
-     */
-    size(status?: "PENDING"): Promise<number>;
-    private getAllJobs;
-    /**
-     * Marks a job as complete with its output or error.
-     * Enhanced error handling:
-     * - For a retryable error, increments run_attempts and updates run_after.
-     * - Marks a job as FAILED immediately for permanent or generic errors.
-     */
-    complete(jobDetails: JobStorageFormat<Input, Output>): Promise<void>;
-    /**
-     * Releases a claimed job without consuming a retry attempt.
-     */
-    release(jobId: unknown): Promise<void>;
-    /**
-     * Clears all jobs from the queue.
-     */
-    deleteAll(): Promise<void>;
-    /**
-     * Looks up cached output for a given input
-     * Uses input fingerprinting for efficient matching
-     * @returns The cached output or null if not found
-     */
-    outputForInput(input: Input): Promise<Output | null>;
-    /**
-     * Aborts a job by setting its status to "ABORTING".
-     * This method will signal the corresponding AbortController so that
-     * the job's execute() method (if it supports an AbortSignal parameter)
-     * can clean up and exit.
-     */
-    abort(jobId: unknown): Promise<void>;
-    /**
-     * Retrieves all jobs for a given job run ID.
-     * @param job_run_id - The ID of the job run to retrieve
-     * @returns An array of jobs
-     */
-    getByRunId(job_run_id: string): Promise<Array<JobStorageFormat<Input, Output>>>;
-    /**
-     * Implements the saveProgress method
-     */
-    saveProgress(jobId: unknown, progress: number, message: string, details: Record<string, any>): Promise<void>;
-    /**
-     * Deletes a job by its ID
-     */
-    delete(jobId: unknown): Promise<void>;
-    /**
-     * Delete jobs with a specific status older than a cutoff date
-     * @param status - Status of jobs to delete
-     * @param olderThanMs - Delete jobs completed more than this many milliseconds ago
-     */
-    deleteJobsByStatusAndAge(status: JobStatus, olderThanMs: number): Promise<void>;
-    /**
-     * Checks if a job from a realtime payload matches the specified prefix filter
-     * @param job - The job record from the realtime payload
-     * @param prefixFilter - The prefix filter to match against (undefined = use instance prefixes, {} = no filter)
-     */
-    private matchesPrefixFilter;
-    /**
-     * Checks if a prefix filter is custom (different from instance's prefixes).
-     */
-    private isCustomPrefixFilter;
-    private getAllJobsWithFilter;
-    /**
-     * Subscribes to changes in the queue.
-     * Uses Supabase realtime by default.
-     *
-     * @param callback - Function called when a change occurs
-     * @param options - Subscription options including prefix filter
-     * @returns Unsubscribe function
-     */
-    subscribeToChanges(callback: (change: QueueChangePayload<Input, Output>) => void, options?: QueueSubscribeOptions): () => void;
-    /**
-     * Subscribe using Supabase realtime (protected).
-     *
-     * @param callback - Function called when a change occurs
-     * @param prefixFilter - Optional prefix filter (undefined = use instance prefixes, {} = no filter)
-     * @returns Unsubscribe function
-     */
-    protected subscribeToChangesWithRealtime(callback: (change: QueueChangePayload<Input, Output>) => void, prefixFilter?: Readonly<Record<string, string | number>>): () => void;
-    /**
-     * Gets or creates the shared polling subscription manager for normal subscriptions (fallback).
-     * This ensures all normal subscriptions share a single polling loop per interval.
-     */
-    private getPollingManager;
-    /**
-     * Creates a dedicated polling subscription for custom prefix filters (fallback).
-     * This runs separately from the normal polling manager with DB-level filtering.
-     */
-    private subscribeWithCustomPrefixFilterPolling;
-    /**
-     * Subscribe using polling (protected, available as fallback).
-     *
-     * Normal subscriptions (no custom prefix filter) share a single polling loop for efficiency.
-     * Custom prefix filter subscriptions get their own dedicated polling loop with DB-level filtering.
-     *
-     * @param callback - Function called when a change occurs
-     * @param options - Subscription options including interval and prefix filter
-     * @returns Unsubscribe function
-     */
-    protected subscribeToChangesWithPolling(callback: (change: QueueChangePayload<Input, Output>) => void, options?: QueueSubscribeOptions): () => void;
-}
-//# sourceMappingURL=SupabaseQueueStorage.d.ts.map

package/dist/queue/SupabaseQueueStorage.d.ts.map

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

package/dist/queue/TelemetryQueueStorage.d.ts

@@ -1,33 +0,0 @@
-/**
- * @license
- * Copyright 2025 Steven Roussey <sroussey@gmail.com>
- * SPDX-License-Identifier: Apache-2.0
- */
-import type { IQueueStorage, JobStatus, JobStorageFormat, QueueChangePayload, QueueStorageScope, QueueSubscribeOptions } from "./IQueueStorage";
-/**
- * Telemetry wrapper for any IQueueStorage implementation.
- * Creates spans for all queue storage operations.
- */
-export declare class TelemetryQueueStorage<Input, Output> implements IQueueStorage<Input, Output> {
-    private readonly storageName;
-    private readonly inner;
-    constructor(storageName: string, inner: IQueueStorage<Input, Output>);
-    get scope(): QueueStorageScope;
-    add(job: JobStorageFormat<Input, Output>): Promise<unknown>;
-    get(id: unknown): Promise<JobStorageFormat<Input, Output> | undefined>;
-    next(workerId: string): Promise<JobStorageFormat<Input, Output> | undefined>;
-    peek(status?: JobStatus, num?: number): Promise<Array<JobStorageFormat<Input, Output>>>;
-    size(status?: JobStatus): Promise<number>;
-    complete(job: JobStorageFormat<Input, Output>): Promise<void>;
-    release(id: unknown): Promise<void>;
-    deleteAll(): Promise<void>;
-    outputForInput(input: Input): Promise<Output | null>;
-    abort(id: unknown): Promise<void>;
-    getByRunId(runId: string): Promise<Array<JobStorageFormat<Input, Output>>>;
-    saveProgress(id: unknown, progress: number, message: string, details: Record<string, any> | null): Promise<void>;
-    delete(id: unknown): Promise<void>;
-    deleteJobsByStatusAndAge(status: JobStatus, olderThanMs: number): Promise<void>;
-    setupDatabase(): Promise<void>;
-    subscribeToChanges(callback: (change: QueueChangePayload<Input, Output>) => void, options?: QueueSubscribeOptions): () => void;
-}
-//# sourceMappingURL=TelemetryQueueStorage.d.ts.map

package/dist/queue/TelemetryQueueStorage.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"TelemetryQueueStorage.d.ts","sourceRoot":"","sources":["../../src/queue/TelemetryQueueStorage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EACV,aAAa,EACb,SAAS,EACT,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,EACtB,MAAM,iBAAiB,CAAC;AAEzB;;;GAGG;AACH,qBAAa,qBAAqB,CAAC,KAAK,EAAE,MAAM,CAAE,YAAW,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC;IAErF,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,KAAK;IAFxB,YACmB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,EAClD;IAEJ,IAAW,KAAK,IAAI,iBAAiB,CAEpC;IAED,GAAG,CAAC,GAAG,EAAE,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAE1D;IACD,GAAG,CAAC,EAAE,EAAE,OAAO,GAAG,OAAO,CAAC,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC,CAErE;IACD,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC,CAE3E;IACD,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAItF;IACD,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAExC;IACD,QAAQ,CAAC,GAAG,EAAE,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAI5D;IACD,OAAO,CAAC,EAAE,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAElC;IACD,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAIzB;IACD,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAInD;IACD,KAAK,CAAC,EAAE,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAEhC;IACD,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAIzE;IACD,YAAY,CACV,EAAE,EAAE,OAAO,EACX,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,GAClC,OAAO,CAAC,IAAI,CAAC,CAIf;IACD,MAAM,CAAC,EAAE,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAEjC;IACD,wBAAwB,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAI9E;IACD,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAE7B;IACD,kBAAkB,CAChB,QAAQ,EAAE,CAAC,MAAM,EAAE,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,EAC7D,OAAO,CAAC,EAAE,qBAAqB,GAC9B,MAAM,IAAI,CAEZ;CACF"}