@workglow/storage 0.0.57 → 0.0.59

package/dist/queue/IQueueStorage.d.ts

@@ -4,6 +4,28 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 export declare const QUEUE_STORAGE: import("@workglow/util").ServiceToken<IQueueStorage<any, any>>;
+/**
+ * The type of a prefix column.
+ * - "uuid" maps to UUID in PostgreSQL/Supabase, TEXT in SQLite/IndexedDB/InMemory
+ * - "number" maps to INTEGER in PostgreSQL/Supabase/SQLite, number in IndexedDB/InMemory
+ */
+export type PrefixColumnType = "uuid" | "number";
+/**
+ * Defines a prefix column for queue storage filtering.
+ */
+export interface PrefixColumn {
+    readonly name: string;
+    readonly type: PrefixColumnType;
+}
+/**
+ * Options for configuring queue storage with prefix filters.
+ */
+export interface QueueStorageOptions {
+    /** The prefix column definitions for this storage */
+    readonly prefixes?: readonly PrefixColumn[];
+    /** The values for each prefix column */
+    readonly prefixValues?: Readonly<Record<string, string | number>>;
+}
 export declare enum JobStatus {
     PENDING = "PENDING",
     PROCESSING = "PROCESSING",
@@ -12,6 +34,46 @@ export declare enum JobStatus {
     FAILED = "FAILED",
     DISABLED = "DISABLED"
 }
+/**
+ * Type of change that occurred in the queue
+ */
+export type QueueChangeType = "INSERT" | "UPDATE" | "DELETE";
+/**
+ * Payload describing a change to a job
+ */
+export interface QueueChangePayload<Input, Output> {
+    readonly type: QueueChangeType;
+    readonly old?: JobStorageFormat<Input, Output>;
+    readonly new?: JobStorageFormat<Input, Output>;
+}
+/**
+ * Options for subscribing to queue changes
+ */
+export interface QueueSubscribeOptions {
+    /** Polling interval in milliseconds (used by implementations that rely on polling) */
+    readonly pollingIntervalMs?: number;
+    /**
+     * Custom prefix filter for this subscription.
+     *
+     * - If not provided (undefined): Uses the storage instance's configured prefixValues
+     * - If empty object ({}): Receives ALL changes across all prefix combinations
+     * - If partial object: Receives changes matching the specified subset of prefixes
+     *
+     * @example
+     * // Storage configured with prefixes: [{name: "user_id"}, {name: "project_id"}]
+     * // and prefixValues: {user_id: "abc", project_id: "123"}
+     *
+     * // Subscribe to only this user+project (default behavior)
+     * storage.subscribeToChanges(callback);
+     *
+     * // Subscribe to all projects for this user
+     * storage.subscribeToChanges(callback, { prefixFilter: { user_id: "abc" } });
+     *
+     * // Subscribe to ALL jobs in this queue (admin/supervisor view)
+     * storage.subscribeToChanges(callback, { prefixFilter: {} });
+     */
+    readonly prefixFilter?: Readonly<Record<string, string | number>>;
+}
 /**
  * Details about a job that reflect the structure in the database.
  */
@@ -35,6 +97,7 @@ export type JobStorageFormat<Input, Output> = {
     progress?: number;
     progress_message?: string;
     progress_details?: Record<string, any> | null;
+    worker_id?: string | null;
 };
 /**
  * Interface defining the storage operations for a job queue
@@ -54,9 +117,10 @@ export interface IQueueStorage<Input, Output> {
     get(id: unknown): Promise<JobStorageFormat<Input, Output> | undefined>;
     /**
      * Gets the next job from the queue storage
+     * @param workerId - Optional worker ID to associate with the job
      * @returns The next job from the queue storage
      */
-    next(): Promise<JobStorageFormat<Input, Output> | undefined>;
+    next(workerId?: string): Promise<JobStorageFormat<Input, Output> | undefined>;
     /**
      * Peeks at the next job(s) from the queue storage without removing them
      * @param status - The status of the jobs to peek at
@@ -121,5 +185,12 @@ export interface IQueueStorage<Input, Output> {
      * For production use, database setup should be done via migrations.
      */
     setupDatabase(): Promise<void>;
+    /**
+     * Subscribes to changes in the queue (including remote changes).
+     * @param callback - Function called when a change occurs
+     * @param options - Optional subscription options (e.g., polling interval)
+     * @returns Unsubscribe function
+     */
+    subscribeToChanges(callback: (change: QueueChangePayload<Input, Output>) => void, options?: QueueSubscribeOptions): () => void;
 }
 //# sourceMappingURL=IQueueStorage.d.ts.map

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

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

package/dist/queue/InMemoryQueueStorage.d.ts

@@ -3,21 +3,37 @@
  * Copyright 2025 Steven Roussey <sroussey@gmail.com>
  * SPDX-License-Identifier: Apache-2.0
  */
-import { IQueueStorage, JobStatus, JobStorageFormat } from "./IQueueStorage";
+import { EventEmitter } from "@workglow/util";
+import { IQueueStorage, JobStatus, JobStorageFormat, QueueChangePayload, QueueStorageOptions, QueueSubscribeOptions } from "./IQueueStorage";
+/**
+ * Event listeners for queue storage events
+ */
+type QueueEventListeners<Input, Output> = {
+    change: (payload: QueueChangePayload<Input, Output>) => void;
+};
 export declare const IN_MEMORY_QUEUE_STORAGE: import("@workglow/util").ServiceToken<IQueueStorage<any, any>>;
 /**
  * In-memory implementation of a job queue that manages asynchronous tasks.
- * Supports job scheduling, status tracking, and result caching.
+ * Supports job scheduling, status tracking, result caching, and prefix-based filtering.
  */
 export declare class InMemoryQueueStorage<Input, Output> implements IQueueStorage<Input, Output> {
     readonly queueName: string;
+    /** The prefix values for filtering jobs */
+    protected readonly prefixValues: Readonly<Record<string, string | number>>;
+    /** Event emitter for change notifications */
+    protected readonly events: EventEmitter<QueueEventListeners<Input, Output>>;
     /**
      * Creates a new in-memory job queue
-     * @param queue - Name of the queue
+     * @param queueName - Name of the queue
+     * @param options - Optional configuration including prefix filters
      */
-    constructor(queueName: string);
+    constructor(queueName: string, options?: QueueStorageOptions);
     /** Internal array storing all jobs */
-    jobQueue: JobStorageFormat<Input, Output>[];
+    jobQueue: Array<JobStorageFormat<Input, Output> & Record<string, unknown>>;
+    /**
+     * Checks if a job matches the current prefix values
+     */
+    private matchesPrefixes;
     /**
      * Returns a filtered and sorted list of pending jobs that are ready to run
      * Sorts by creation time to maintain FIFO order
@@ -35,17 +51,18 @@ export declare class InMemoryQueueStorage<Input, Output> implements IQueueStorag
      */
     get(id: unknown): Promise<JobStorageFormat<Input, Output> | undefined>;
     /**
-     * Retrieves a slice of jobs from anywherethe queue.
+     * Retrieves a slice of jobs from the queue.
      * @param status - The status of the jobs to retrieve.
      * @param num - The number of jobs to retrieve.
      * @returns A promise that resolves to an array of jobs.
      */
-    peek(status?: JobStatus, num?: number): Promise<JobStorageFormat<Input, Output>[]>;
+    peek(status?: JobStatus, num?: number): Promise<Array<JobStorageFormat<Input, Output>>>;
     /**
      * Retrieves the next available job that is ready to be processed
      * Updates the job status to PROCESSING before returning
+     * @param workerId - Optional worker ID to associate with the job
      */
-    next(): Promise<JobStorageFormat<Input, Output> | undefined>;
+    next(workerId?: string): Promise<(JobStorageFormat<Input, Output> & Record<string, unknown>) | undefined>;
     /**
      * Retrieves the size of the queue for a given status
      * @param status - The status of the jobs to retrieve.
@@ -80,16 +97,16 @@ export declare class InMemoryQueueStorage<Input, Output> implements IQueueStorag
      */
     getByRunId(runId: string): Promise<Array<JobStorageFormat<Input, Output>>>;
     /**
-     * Deletes all jobs from the queue.
+     * Deletes all jobs from the queue that match the current prefix values.
      */
     deleteAll(): Promise<void>;
     /**
-     * Looks up cached output for a given and input
+     * Looks up cached output for a given input
      * Uses input fingerprinting for efficient matching
      * @param input - The input to look up the cached output for.
      * @returns The cached output or null if not found
      */
-    outputForInput(input: Input): Promise<NonNullable<Output> | null>;
+    outputForInput(input: Input): Promise<Output | null>;
     /**
      * Deletes a job by its ID
      */
@@ -105,5 +122,21 @@ export declare class InMemoryQueueStorage<Input, Output> implements IQueueStorag
      * No-op for in-memory storage as it doesn't require database setup.
      */
     setupDatabase(): Promise<void>;
+    /**
+     * Checks if a job matches the specified prefix filter
+     * @param job - The job to check
+     * @param prefixFilter - The prefix filter (undefined = use instance prefixes, {} = no filter)
+     */
+    private matchesPrefixFilter;
+    /**
+     * Subscribes to changes in the queue.
+     * Since InMemory is both client and server, changes are detected via local events.
+     *
+     * @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;
 }
+export {};
 //# sourceMappingURL=InMemoryQueueStorage.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"InMemoryQueueStorage.d.ts","sourceRoot":"","sources":["../../src/queue/InMemoryQueueStorage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAE7E,eAAO,MAAM,uBAAuB,gEAEnC,CAAC;AAEF;;;GAGG;AACH,qBAAa,oBAAoB,CAAC,KAAK,EAAE,MAAM,CAAE,YAAW,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC;aAK1D,SAAS,EAAE,MAAM;IAJ7C;;;OAGG;gBACyB,SAAS,EAAE,MAAM;IAI7C,sCAAsC;IAC/B,QAAQ,EAAE,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC;IAEnD;;;OAGG;IACH,OAAO,CAAC,YAAY;IAQpB;;;OAGG;IACU,GAAG,CAAC,GAAG,EAAE,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC;IAkBrD;;;;OAIG;IACU,GAAG,CAAC,EAAE,EAAE,OAAO;IAK5B;;;;;OAKG;IACU,IAAI,CAAC,MAAM,GAAE,SAA6B,EAAE,GAAG,GAAE,MAAY;IAS1E;;;OAGG;IACU,IAAI;IAYjB;;;;OAIG;IACU,IAAI,CAAC,MAAM,YAAoB,GAAG,OAAO,CAAC,MAAM,CAAC;IAK9D;;;;;;OAMG;IACU,YAAY,CACvB,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;IAYhB;;;;;;OAMG;IACU,QAAQ,CAAC,GAAG,EAAE,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC;IAW1D;;;OAGG;IACU,KAAK,CAAC,EAAE,EAAE,OAAO;IAQ9B;;;;OAIG;IACU,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;IAKvF;;OAEG;IACU,SAAS;IAKtB;;;;;OAKG;IACU,cAAc,CAAC,KAAK,EAAE,KAAK;IASxC;;OAEG;IACU,MAAM,CAAC,EAAE,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAK/C;;;;OAIG;IACU,wBAAwB,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ5F;;;OAGG;IACU,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;CAG5C"}
+{"version":3,"file":"InMemoryQueueStorage.d.ts","sourceRoot":"","sources":["../../src/queue/InMemoryQueueStorage.ts"],"names":[],"mappings":"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"}

package/dist/queue/IndexedDbQueueStorage.d.ts

@@ -4,8 +4,13 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import { MigrationOptions } from "../util/IndexedDbTable";
-import { IQueueStorage, JobStatus, JobStorageFormat } from "./IQueueStorage";
+import { IQueueStorage, JobStatus, JobStorageFormat, PrefixColumn, QueueChangePayload, QueueStorageOptions, QueueSubscribeOptions } from "./IQueueStorage";
 export declare const INDEXED_DB_QUEUE_STORAGE: import("@workglow/util").ServiceToken<IQueueStorage<any, any>>;
+/**
+ * Extended options for IndexedDB queue storage including prefix support
+ */
+export interface IndexedDbQueueStorageOptions extends QueueStorageOptions, MigrationOptions {
+}
 /**
  * IndexedDB implementation of a job queue storage.
  * Provides storage and retrieval for job execution states using IndexedDB.
@@ -13,9 +18,27 @@ export declare const INDEXED_DB_QUEUE_STORAGE: import("@workglow/util").ServiceT
 export declare class IndexedDbQueueStorage<Input, Output> implements IQueueStorage<Input, Output> {
     readonly queueName: string;
     private db;
-    private tableName;
-    private migrationOptions;
-    constructor(queueName: string, migrationOptions?: MigrationOptions);
+    private readonly tableName;
+    private readonly migrationOptions;
+    /** The prefix column definitions */
+    protected readonly prefixes: readonly PrefixColumn[];
+    /** The prefix values for filtering */
+    protected readonly prefixValues: Readonly<Record<string, string | number>>;
+    /** Shared polling subscription manager */
+    private pollingManager;
+    constructor(queueName: string, options?: IndexedDbQueueStorageOptions);
+    /**
+     * Gets prefix column names for use in indexes
+     */
+    private getPrefixColumnNames;
+    /**
+     * Checks if a job matches the current prefix values
+     */
+    private matchesPrefixes;
+    /**
+     * Gets prefix values as an array in column order for index key construction
+     */
+    private getPrefixKeyValues;
     private getDb;
     /**
      * Sets up the IndexedDB database table with the required schema and indexes.
@@ -43,9 +66,10 @@ export declare class IndexedDbQueueStorage<Input, Output> implements IQueueStora
     peek(status?: JobStatus, num?: number): Promise<JobStorageFormat<Input, Output>[]>;
     /**
      * Retrieves the next job from the queue.
+     * @param workerId - Optional worker ID to associate with the job
      * @returns A promise that resolves to the next job or undefined if the queue is empty.
      */
-    next(): Promise<JobStorageFormat<Input, Output> | undefined>;
+    next(workerId?: string): Promise<JobStorageFormat<Input, Output> | undefined>;
     /**
      * Retrieves the number of jobs in the queue.
      * Returns the count of jobs in the queue.
@@ -85,5 +109,46 @@ export declare class IndexedDbQueueStorage<Input, Output> implements IQueueStora
      * @param olderThanMs - Delete jobs completed more than this many milliseconds ago
      */
     deleteJobsByStatusAndAge(status: JobStatus, olderThanMs: number): Promise<void>;
+    /**
+     * Gets all jobs from the queue that match the current prefix values.
+     * Used internally for normal polling-based subscriptions (efficient - filters at DB level).
+     *
+     * @returns A promise that resolves to an array of jobs
+     */
+    private getAllJobs;
+    /**
+     * Gets all jobs from the queue with a custom prefix filter.
+     * Used for subscriptions with custom prefix filters (filters at DB level where possible).
+     *
+     * @param prefixFilter - The prefix values to filter by (empty object = all jobs)
+     * @returns A promise that resolves to an array of jobs
+     */
+    private getAllJobsWithFilter;
+    /**
+     * Checks if a prefix filter is custom (different from instance's prefixes).
+     */
+    private isCustomPrefixFilter;
+    /**
+     * Gets or creates the shared polling subscription manager for normal subscriptions.
+     * This ensures all normal subscriptions share a single polling loop per interval.
+     */
+    private getPollingManager;
+    /**
+     * Creates a dedicated polling subscription for custom prefix filters.
+     * This runs separately from the normal polling manager.
+     */
+    private subscribeWithCustomPrefixFilter;
+    /**
+     * Subscribes to changes in the queue.
+     * Uses polling since IndexedDB has no native cross-tab change notifications.
+     *
+     * 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 polling interval and prefix filter
+     * @returns Unsubscribe function
+     */
+    subscribeToChanges(callback: (change: QueueChangePayload<Input, Output>) => void, options?: QueueSubscribeOptions): () => void;
 }
 //# sourceMappingURL=IndexedDbQueueStorage.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"IndexedDbQueueStorage.d.ts","sourceRoot":"","sources":["../../src/queue/IndexedDbQueueStorage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAGH,gBAAgB,EACnB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAE7E,eAAO,MAAM,wBAAwB,gEAEpC,CAAC;AAEF;;;GAGG;AACH,qBAAa,qBAAqB,CAAC,KAAK,EAAE,MAAM,CAAE,YAAW,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC;aAMrE,SAAS,EAAE,MAAM;IALnC,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,gBAAgB,CAAmB;gBAGzB,SAAS,EAAE,MAAM,EACjC,gBAAgB,GAAE,gBAAqB;YAM3B,KAAK;IAMnB;;;OAGG;IACU,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAiC3C;;;;OAIG;IACU,GAAG,CAAC,GAAG,EAAE,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IA2BxE;;;;OAIG;IACG,GAAG,CAAC,EAAE,EAAE,OAAO,GAAG,OAAO,CAAC,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IAY5E;;;;;OAKG;IACU,IAAI,CACf,MAAM,GAAE,SAA6B,EACrC,GAAG,GAAE,MAAY,GAChB,OAAO,CAAC,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC;IA6B7C;;;OAGG;IACU,IAAI,IAAI,OAAO,CAAC,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IA6DzE;;;OAGG;IACU,IAAI,CAAC,MAAM,YAAoB,GAAG,OAAO,CAAC,MAAM,CAAC;IAc9D;;OAEG;IACU,QAAQ,CAAC,GAAG,EAAE,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAuB1E;;OAEG;IACU,KAAK,CAAC,EAAE,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ9C;;OAEG;IACU,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC;IAcvF;;OAEG;IACU,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAavC;;OAEG;IACU,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAejE;;OAEG;IACU,YAAY,CACvB,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;IAWhB;;OAEG;IACU,MAAM,CAAC,EAAE,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAa/C;;;;OAIG;IACU,wBAAwB,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CA0B7F"}
+{"version":3,"file":"IndexedDbQueueStorage.d.ts","sourceRoot":"","sources":["../../src/queue/IndexedDbQueueStorage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAGL,gBAAgB,EACjB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,aAAa,EACb,SAAS,EACT,gBAAgB,EAChB,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,iBAAiB,CAAC;AAEzB,eAAO,MAAM,wBAAwB,gEAEpC,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,4BAA6B,SAAQ,mBAAmB,EAAE,gBAAgB;CAAG;AAE9F;;;GAGG;AACH,qBAAa,qBAAqB,CAAC,KAAK,EAAE,MAAM,CAAE,YAAW,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC;aAgBrE,SAAS,EAAE,MAAM;IAfnC,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAmB;IACpD,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,0CAA0C;IAC1C,OAAO,CAAC,cAAc,CAIN;gBAGE,SAAS,EAAE,MAAM,EACjC,OAAO,GAAE,4BAAiC;IAc5C;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAI5B;;OAEG;IACH,OAAO,CAAC,eAAe;IASvB;;OAEG;IACH,OAAO,CAAC,kBAAkB;YAIZ,KAAK;IAMnB;;;OAGG;IACU,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAwC3C;;;;OAIG;IACU,GAAG,CAAC,GAAG,EAAE,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAiCxE;;;;OAIG;IACG,GAAG,CAAC,EAAE,EAAE,OAAO,GAAG,OAAO,CAAC,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IAsB5E;;;;;OAKG;IACU,IAAI,CACf,MAAM,GAAE,SAA6B,EACrC,GAAG,GAAE,MAAY,GAChB,OAAO,CAAC,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC;IAoC7C;;;;OAIG;IACU,IAAI,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IAwE1F;;;OAGG;IACU,IAAI,CAAC,MAAM,YAAoB,GAAG,OAAO,CAAC,MAAM,CAAC;IAgB9D;;OAEG;IACU,QAAQ,CAAC,GAAG,EAAE,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAyC1E;;OAEG;IACU,KAAK,CAAC,EAAE,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ9C;;OAEG;IACU,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC;IAuBvF;;OAEG;IACU,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAyCvC;;OAEG;IACU,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IA8BjE;;OAEG;IACU,YAAY,CACvB,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;IAWhB;;OAEG;IACU,MAAM,CAAC,EAAE,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB/C;;;;OAIG;IACU,wBAAwB,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoC5F;;;;;OAKG;YACW,UAAU;IAiCxB;;;;;;OAMG;YACW,oBAAoB;IA8ClC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAuB5B;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IA2BzB;;;OAGG;IACH,OAAO,CAAC,+BAA+B;IA8CvC;;;;;;;;;;OAUG;IACI,kBAAkB,CACvB,QAAQ,EAAE,CAAC,MAAM,EAAE,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,EAC7D,OAAO,CAAC,EAAE,qBAAqB,GAC9B,MAAM,IAAI;CAad"}

package/dist/queue/PostgresQueueStorage.d.ts

@@ -4,7 +4,7 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import { Pool } from "pg";
-import { IQueueStorage, JobStatus, JobStorageFormat } from "./IQueueStorage";
+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.
@@ -13,7 +13,37 @@ export declare const POSTGRES_QUEUE_STORAGE: import("@workglow/util").ServiceTok
 export declare class PostgresQueueStorage<Input, Output> implements IQueueStorage<Input, Output> {
     protected readonly db: Pool;
     protected readonly queueName: string;
-    constructor(db: Pool, queueName: string);
+    /** 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;
+    /** Shared polling subscription manager */
+    private pollingManager;
+    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>;
     /**
      * Adds a new job to the queue.
@@ -26,18 +56,19 @@ export declare class PostgresQueueStorage<Input, Output> implements IQueueStorag
      * @param id - The ID of the job to retrieve
      * @returns The job if found, undefined otherwise
      */
-    get(id: number): Promise<any>;
+    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<JobStorageFormat<Input, Output>[]>;
+    peek(status?: JobStatus, num?: number): Promise<Array<JobStorageFormat<Input, Output>>>;
     /**
      * Retrieves the next available job that is ready to be processed.
+     * @param workerId - Optional worker ID to associate with the job
      * @returns The next job or undefined if no job is available
      */
-    next(): Promise<JobStorageFormat<Input, Output>>;
+    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
@@ -60,20 +91,20 @@ export declare class PostgresQueueStorage<Input, Output> implements IQueueStorag
      * Uses input fingerprinting for efficient matching
      * @returns The cached output or null if not found
      */
-    outputForInput(input: Input): Promise<any>;
+    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: number): Promise<void>;
+    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<any[]>;
+    getByRunId(job_run_id: string): Promise<Array<JobStorageFormat<Input, Output>>>;
     /**
      * Implements the abstract saveProgress method from JobQueue
      */
@@ -88,5 +119,46 @@ export declare class PostgresQueueStorage<Input, Output> implements IQueueStorag
      * @param olderThanMs - Delete jobs completed more than this many milliseconds ago
      */
     deleteJobsByStatusAndAge(status: JobStatus, olderThanMs: number): Promise<void>;
+    /**
+     * Gets all jobs from the queue that match the current prefix values.
+     * Used internally for normal polling-based subscriptions (efficient - filters at DB level).
+     *
+     * @returns A promise that resolves to an array of jobs
+     */
+    private getAllJobs;
+    /**
+     * Gets all jobs from the queue with a custom prefix filter.
+     * Used for subscriptions with custom prefix filters (filters at DB level).
+     *
+     * @param prefixFilter - The prefix values to filter by (empty object = all jobs)
+     * @returns A promise that resolves to an array of jobs
+     */
+    private getAllJobsWithFilter;
+    /**
+     * Checks if a prefix filter is custom (different from instance's prefixes).
+     */
+    private isCustomPrefixFilter;
+    /**
+     * Gets or creates the shared polling subscription manager for normal subscriptions.
+     * This ensures all normal subscriptions share a single polling loop per interval.
+     */
+    private getPollingManager;
+    /**
+     * Creates a dedicated polling subscription for custom prefix filters.
+     * This runs separately from the normal polling manager with DB-level filtering.
+     */
+    private subscribeWithCustomPrefixFilter;
+    /**
+     * Subscribes to changes in the queue.
+     * Uses polling since this PostgreSQL implementation doesn't use LISTEN/NOTIFY.
+     *
+     * 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 polling interval and prefix filter
+     * @returns Unsubscribe function
+     */
+    subscribeToChanges(callback: (change: QueueChangePayload<Input, Output>) => void, options?: QueueSubscribeOptions): () => void;
 }
 //# sourceMappingURL=PostgresQueueStorage.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"PostgresQueueStorage.d.ts","sourceRoot":"","sources":["../../src/queue/PostgresQueueStorage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC1B,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAE7E,eAAO,MAAM,sBAAsB,gEAElC,CAAC;AAIF;;;GAGG;AACH,qBAAa,oBAAoB,CAAC,KAAK,EAAE,MAAM,CAAE,YAAW,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC;IAEpF,SAAS,CAAC,QAAQ,CAAC,EAAE,EAAE,IAAI;IAC3B,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM;gBADjB,EAAE,EAAE,IAAI,EACR,SAAS,EAAE,MAAM;IAGzB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAqD3C;;;;OAIG;IACU,GAAG,CAAC,GAAG,EAAE,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC;IAiDrD;;;;OAIG;IACU,GAAG,CAAC,EAAE,EAAE,MAAM;IAc3B;;;;OAIG;IACU,IAAI,CAAC,MAAM,GAAE,SAA6B,EAAE,GAAG,GAAE,MAAY;IAoB1E;;;OAGG;IACU,IAAI;IAyBjB;;;;OAIG;IACU,IAAI,CAAC,MAAM,YAAoB;IAa5C;;;;;OAKG;IACU,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAgEjF;;OAEG;IACU,SAAS;IAStB;;;;OAIG;IACU,cAAc,CAAC,KAAK,EAAE,KAAK;IAaxC;;;;;OAKG;IACU,KAAK,CAAC,KAAK,EAAE,MAAM;IAUhC;;;;OAIG;IACU,UAAU,CAAC,UAAU,EAAE,MAAM;IAU1C;;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;IAYhB;;OAEG;IACU,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAOlD;;;;OAIG;IACU,wBAAwB,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAW7F"}
+{"version":3,"file":"PostgresQueueStorage.d.ts","sourceRoot":"","sources":["../../src/queue/PostgresQueueStorage.ts"],"names":[],"mappings":"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"}