@workglow/storage 0.2.26 → 0.2.28

package/dist/queue/IQueueStorage.d.ts

@@ -1,206 +0,0 @@
-/**
- * @license
- * Copyright 2025 Steven Roussey <sroussey@gmail.com>
- * 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 type JobStatus = "PENDING" | "PROCESSING" | "COMPLETED" | "ABORTING" | "FAILED" | "DISABLED";
-export declare const JobStatus: {
-    readonly PENDING: "PENDING";
-    readonly PROCESSING: "PROCESSING";
-    readonly COMPLETED: "COMPLETED";
-    readonly ABORTING: "ABORTING";
-    readonly FAILED: "FAILED";
-    readonly 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.
- */
-export type JobStorageFormat<Input, Output> = {
-    id?: unknown;
-    job_run_id?: string;
-    queue?: string;
-    input: Input;
-    output?: Output | null;
-    error?: string | null;
-    error_code?: string | null;
-    fingerprint?: string;
-    max_retries?: number;
-    status?: JobStatus;
-    created_at?: string;
-    deadline_at?: string | null;
-    last_ran_at?: string | null;
-    run_after: string | null;
-    completed_at: string | null;
-    run_attempts?: number;
-    progress?: number;
-    progress_message?: string;
-    progress_details?: Record<string, any> | null;
-    worker_id?: string | null;
-};
-/**
- * Interface defining the storage operations for a job queue
- */
-export interface IQueueStorage<Input, Output> {
-    /**
-     * Adds a job to the queue storage
-     * @param job - The job to add to the queue storage
-     * @returns The ID of the job
-     */
-    add(job: JobStorageFormat<Input, Output>): Promise<unknown>;
-    /**
-     * Gets a job from the queue storage by ID
-     * @param id - The ID of the job to get
-     * @returns The job with the given ID
-     */
-    get(id: unknown): Promise<JobStorageFormat<Input, Output> | undefined>;
-    /**
-     * Gets the next job from the queue storage
-     * @param workerId - Worker ID to associate with the job (required)
-     * @returns The next job from the queue storage
-     */
-    next(workerId: string): Promise<JobStorageFormat<Input, Output> | undefined>;
-    /**
-     * Releases a job that was just claimed by {@link next} but won't be
-     * processed (e.g. the worker was stopped mid-claim). Resets status to
-     * PENDING and clears worker_id WITHOUT incrementing run_attempts —
-     * the worker never actually attempted execution, so the retry budget
-     * must be preserved.
-     * @param id - The id of the claimed job to release.
-     */
-    release(id: unknown): Promise<void>;
-    /**
-     * Peeks at the next job(s) from the queue storage without removing them
-     * @param status - The status of the jobs to peek at
-     * @param num - The number of jobs to peek at
-     * @returns The jobs with the given status
-     */
-    peek(status?: JobStatus, num?: number): Promise<Array<JobStorageFormat<Input, Output>>>;
-    /**
-     * Gets the size of the queue storage
-     * @param status - The status of the jobs to get the size for
-     * @returns The size of the queue storage
-     */
-    size(status?: JobStatus): Promise<number>;
-    /**
-     * Completes a job in the queue storage
-     * @param job - The job to complete
-     */
-    complete(job: JobStorageFormat<Input, Output>): Promise<void>;
-    /**
-     * Deletes all jobs from the queue storage
-     */
-    deleteAll(): Promise<void>;
-    /**
-     * Gets the output for a given input from the queue storage
-     * @param input - The input to get the output for
-     * @returns The output of the job
-     */
-    outputForInput(input: Input): Promise<Output | null>;
-    /**
-     * Aborts a job in the queue storage
-     * @param id - The ID of the job to abort
-     */
-    abort(id: unknown): Promise<void>;
-    /**
-     * Gets the jobs by job run ID from the queue storage
-     * @param runId - The job run ID of the jobs to get
-     * @returns The jobs with the given job run ID
-     */
-    getByRunId(runId: string): Promise<Array<JobStorageFormat<Input, Output>>>;
-    /**
-     * Saves progress updates for a job in the queue storage
-     * @param id - The ID of the job to save the progress for
-     * @param progress - The progress of the job
-     * @param message - The message of the job
-     * @param details - The details of the job
-     */
-    saveProgress(id: unknown, progress: number, message: string, details: Record<string, any> | null): Promise<void>;
-    /**
-     * Deletes a job by its ID from the queue storage
-     * @param id - The ID of the job to delete
-     */
-    delete(id: unknown): Promise<void>;
-    /**
-     * Deletes jobs from the queue storage that are of a specific status and older than the specified time
-     * @param status - The status of the jobs to delete
-     * @param olderThanMs - The time in milliseconds that the jobs must be older than to be deleted
-     */
-    deleteJobsByStatusAndAge(status: JobStatus, olderThanMs: number): Promise<void>;
-    /**
-     * Sets up the database schema and tables.
-     * This method should be called before using the storage in tests.
-     * 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 +0,0 @@
-{"version":3,"file":"IQueueStorage.d.ts","sourceRoot":"","sources":["../../src/queue/IQueueStorage.ts"],"names":[],"mappings":"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"}

package/dist/queue/InMemoryQueueStorage.d.ts

@@ -1,148 +0,0 @@
-/**
- * @license
- * Copyright 2025 Steven Roussey <sroussey@gmail.com>
- * SPDX-License-Identifier: Apache-2.0
- */
-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, 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 queueName - Name of the queue
-     * @param options - Optional configuration including prefix filters
-     */
-    constructor(queueName: string, options?: QueueStorageOptions);
-    /** Internal array storing all jobs */
-    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
-     */
-    private pendingQueue;
-    /**
-     * Adds a new job to the queue
-     * Generates an ID and fingerprint if not provided
-     */
-    add(job: JobStorageFormat<Input, Output>): Promise<unknown>;
-    /**
-     * Retrieves a job from the queue by its id.
-     * @param id - The id of the job to retrieve.
-     * @returns A promise that resolves to the job or undefined if the job is not found.
-     */
-    get(id: unknown): Promise<JobStorageFormat<Input, Output> | undefined>;
-    /**
-     * 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<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 - 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 size of the queue for a given status
-     * @param status - The status of the jobs to retrieve.
-     * @returns A promise that resolves to the number of jobs.
-     */
-    size(status?: "PENDING"): Promise<number>;
-    /**
-     * Saves the progress of a job
-     * @param jobId - The id of the job to save the progress for.
-     * @param progress - The progress of the job.
-     * @param message - The message of the job.
-     * @param details - The details of the job.
-     */
-    saveProgress(id: unknown, progress: number, message: string, details: Record<string, any> | null): Promise<void>;
-    /**
-     * Marks a job as complete with its output or error
-     * Handles run_attempts for failed jobs and triggers completion callbacks
-     * @param id - ID of the job to complete
-     * @param output - Result of the job execution
-     * @param error - Optional error message if job failed
-     */
-    complete(job: JobStorageFormat<Input, Output>): Promise<void>;
-    /**
-     * Releases a claimed job back to PENDING without incrementing run_attempts.
-     * @param id - The id of the claimed job to release.
-     */
-    release(id: unknown): Promise<void>;
-    /**
-     * Aborts a job
-     * @param id - The id of the job to abort.
-     */
-    abort(id: unknown): Promise<void>;
-    /**
-     * Retrieves all jobs by their job_run_id.
-     * @param job_run_id - The job_run_id of the jobs to retrieve.
-     * @returns A promise that resolves to an array of jobs.
-     */
-    getByRunId(runId: string): Promise<Array<JobStorageFormat<Input, Output>>>;
-    /**
-     * Deletes all jobs from the queue that match the current prefix values.
-     */
-    deleteAll(): Promise<void>;
-    /**
-     * 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<Output | null>;
-    /**
-     * Deletes a job by its ID
-     */
-    delete(id: 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>;
-    /**
-     * Sets up the database schema and tables.
-     * 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 +0,0 @@
-{"version":3,"file":"InMemoryQueueStorage.d.ts","sourceRoot":"","sources":["../../src/queue/InMemoryQueueStorage.ts"],"names":[],"mappings":"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"}

package/dist/queue/IndexedDbQueueStorage.d.ts

@@ -1,165 +0,0 @@
-/**
- * @license
- * Copyright 2025 Steven Roussey <sroussey@gmail.com>
- * SPDX-License-Identifier: Apache-2.0
- */
-import { MigrationOptions } from "../util/IndexedDbTable";
-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 {
-    /** Enable BroadcastChannel notifications (default: true) */
-    readonly useBroadcastChannel?: boolean;
-    /** Backup polling interval in ms (default: 5000, 0 to disable) */
-    readonly backupPollingIntervalMs?: number;
-}
-/**
- * IndexedDB implementation of a job queue storage.
- * Provides storage and retrieval for job execution states using IndexedDB.
- */
-export declare class IndexedDbQueueStorage<Input, Output> implements IQueueStorage<Input, Output> {
-    readonly queueName: string;
-    private db;
-    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 hybrid subscription manager */
-    private hybridManager;
-    /** Hybrid subscription options */
-    private readonly hybridOptions;
-    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.
-     * Must be called before using any other methods.
-     */
-    setupDatabase(): Promise<void>;
-    /**
-     * Adds a job to the queue.
-     * @param job - The job to add to the queue.
-     * @returns A promise that resolves to the job id.
-     */
-    add(job: JobStorageFormat<Input, Output>): Promise<unknown>;
-    /**
-     * Retrieves a job from the queue by its id.
-     * @param id - The id of the job to retrieve.
-     * @returns A promise that resolves to the job or undefined if the job is not found.
-     */
-    get(id: unknown): Promise<JobStorageFormat<Input, Output> | undefined>;
-    /**
-     * 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>[]>;
-    /**
-     * Retrieves the next job from the queue using optimistic locking. In case multiple workers
-     * claim the same job, the first worker to claim it will process it and the other workers will return undefined.
-     * This ONLY happens if workers are running in multiple tabs.
-     *
-     * IndexedDB uses snapshot isolation, so concurrent transactions can both see the same
-     * PENDING job. To prevent processing the same job multiple times, this method:
-     * 1. Claims a job by setting it to PROCESSING with a unique claim token
-     * 2. After the transaction completes, re-reads the job to verify the claim succeeded
-     * 3. If another worker claimed it first (different claim token), returns undefined
-     *
-     * @param workerId - Worker ID to associate with the job (required)
-     * @returns A promise that resolves to the next job or undefined if the queue is empty.
-     */
-    next(workerId: string): Promise<JobStorageFormat<Input, Output> | undefined>;
-    /**
-     * Retrieves the number of jobs in the queue.
-     * Returns the count of jobs in the queue.
-     */
-    size(status?: "PENDING"): Promise<number>;
-    /**
-     * Marks a job as complete with its output or error.
-     */
-    complete(job: JobStorageFormat<Input, Output>): Promise<void>;
-    /**
-     * Releases a claimed job without consuming a retry attempt.
-     */
-    release(id: unknown): Promise<void>;
-    /**
-     * Aborts a job in the queue.
-     */
-    abort(id: unknown): Promise<void>;
-    /**
-     * Gets jobs by their run ID.
-     */
-    getByRunId(job_run_id: string): Promise<JobStorageFormat<Input, Output>[]>;
-    /**
-     * Deletes all jobs from the queue.
-     */
-    deleteAll(): Promise<void>;
-    /**
-     * Gets the output for a given input.
-     */
-    outputForInput(input: Input): Promise<Output | null>;
-    /**
-     * Saves progress updates for a job.
-     */
-    saveProgress(id: unknown, progress: number, message: string, details: Record<string, any> | null): Promise<void>;
-    private put;
-    /**
-     * Deletes a job by its ID.
-     */
-    delete(id: 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>;
-    private getAllJobs;
-    private getAllJobsWithFilter;
-    /**
-     * Checks if a prefix filter is custom (different from instance's prefixes).
-     */
-    private isCustomPrefixFilter;
-    /**
-     * Gets or creates the shared hybrid subscription manager for normal subscriptions.
-     * This ensures all normal subscriptions share a single manager.
-     */
-    private getHybridManager;
-    /**
-     * 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;
-    /**
-     * Cleanup method to destroy the hybrid manager
-     */
-    destroy(): void;
-}
-//# sourceMappingURL=IndexedDbQueueStorage.d.ts.map

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

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

package/dist/queue/PostgresQueueStorage.d.ts

@@ -1,133 +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;
-    /** 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>;
-    /**
-     * 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>;
-    /**
-     * Subscribes to changes in the queue.
-     * NOT IMPLEMENTED for PostgreSQL storage.
-     *
-     * @throws Error always - subscribeToChanges is not supported for PostgreSQL storage
-     */
-    subscribeToChanges(callback: (change: QueueChangePayload<Input, Output>) => void, options?: QueueSubscribeOptions): () => void;
-}
-//# sourceMappingURL=PostgresQueueStorage.d.ts.map