@workglow/storage 0.2.27 → 0.2.29

package/dist/queue-limiter/IRateLimiterStorage.d.ts

@@ -1,127 +0,0 @@
-/**
- * @license
- * Copyright 2025 Steven Roussey <sroussey@gmail.com>
- * SPDX-License-Identifier: Apache-2.0
- */
-import type { PrefixColumn } from "../queue/IQueueStorage";
-export declare const RATE_LIMITER_STORAGE: import("@workglow/util").ServiceToken<IRateLimiterStorage>;
-/**
- * Whether a rate-limiter storage's state is shared across processes.
- *
- * - `"process"` — in-memory / per-process state. Multiple workers in the same
- *   process share it, but separate processes do not.
- * - `"cluster"` — state lives in shared external storage (Postgres, Supabase,
- *   etc.) visible to every process.
- */
-export type RateLimiterStorageScope = "process" | "cluster";
-/**
- * Options for configuring rate limiter storage with prefix filters.
- */
-export interface RateLimiterStorageOptions {
-    /** The prefix column definitions for this storage */
-    readonly prefixes?: readonly PrefixColumn[];
-    /** The values for each prefix column */
-    readonly prefixValues?: Readonly<Record<string, string | number>>;
-}
-/**
- * Record of a job execution for rate limiting tracking.
- */
-export interface ExecutionRecord {
-    readonly id?: unknown;
-    readonly queue_name: string;
-    readonly executed_at: string;
-}
-/**
- * Record of the next available time for a queue.
- */
-export interface NextAvailableRecord {
-    readonly queue_name: string;
-    readonly next_available_at: string;
-}
-/**
- * Interface defining the storage operations for a rate limiter.
- * This separates the storage concerns from the rate limiting logic.
- */
-export interface IRateLimiterStorage {
-    /**
-     * Whether this storage is shared across processes. In-memory backends MUST
-     * report `"process"`. Shared databases (Postgres, Supabase) report
-     * `"cluster"`.
-     */
-    readonly scope: RateLimiterStorageScope;
-    /**
-     * Sets up the database schema and tables.
-     * This method should be called before using the storage.
-     * For production use, database setup should be done via migrations.
-     */
-    setupDatabase(): Promise<void>;
-    /**
-     * Atomic check-and-record. Inserts an execution row and returns the
-     * inserted row's id iff BOTH (a) fewer than `maxExecutions` rows have
-     * `executed_at > (now - windowMs)` AND (b) any persisted `nextAvailableAt`
-     * is in the past or absent. Returns `null` without writing anything
-     * otherwise.
-     *
-     * The returned id MUST be passed to {@link releaseExecution} to free the
-     * slot — otherwise concurrent acquirers would race to delete the wrong
-     * worker's row when one of them rolls back.
-     *
-     * Implementations MUST serialize concurrent callers (advisory locks,
-     * `BEGIN IMMEDIATE`, per-key mutex, etc.) so the count-then-insert window
-     * is uninterruptible.
-     *
-     * @param queueName - The name of the queue
-     * @param maxExecutions - Max allowed executions in the window
-     * @param windowMs - Window size in milliseconds
-     * @returns the inserted row's id on success, or `null` on failure
-     */
-    tryReserveExecution(queueName: string, maxExecutions: number, windowMs: number): Promise<unknown | null>;
-    /**
-     * Release the execution row identified by `token` (the value previously
-     * returned from {@link tryReserveExecution}). No-op if the row no longer
-     * exists.
-     *
-     * Critical: implementations MUST delete by id, NOT by recency or position.
-     * Two concurrent workers can hold tokens for different rows; deleting the
-     * "most recent" row would release another worker's reservation.
-     */
-    releaseExecution(queueName: string, token: unknown): Promise<void>;
-    /**
-     * Records a job execution for rate limiting tracking.
-     * @param queueName - The name of the queue
-     */
-    recordExecution(queueName: string): Promise<void>;
-    /**
-     * Gets the count of executions within a time window.
-     * @param queueName - The name of the queue
-     * @param windowStartTime - The start of the time window (ISO string)
-     * @returns The count of executions within the window
-     */
-    getExecutionCount(queueName: string, windowStartTime: string): Promise<number>;
-    /**
-     * Gets the oldest execution time within the window, offset by a count.
-     * Used to calculate when the rate limit will allow the next execution.
-     * @param queueName - The name of the queue
-     * @param offset - The offset (typically maxExecutions - 1)
-     * @returns The execution time or undefined if not enough executions
-     */
-    getOldestExecutionAtOffset(queueName: string, offset: number): Promise<string | undefined>;
-    /**
-     * Gets the next available time for a queue.
-     * @param queueName - The name of the queue
-     * @returns The next available time or undefined if not set
-     */
-    getNextAvailableTime(queueName: string): Promise<string | undefined>;
-    /**
-     * Sets the next available time for a queue.
-     * @param queueName - The name of the queue
-     * @param nextAvailableAt - The next available time (ISO string)
-     */
-    setNextAvailableTime(queueName: string, nextAvailableAt: string): Promise<void>;
-    /**
-     * Clears all rate limit entries for a queue.
-     * @param queueName - The name of the queue
-     */
-    clear(queueName: string): Promise<void>;
-}
-//# sourceMappingURL=IRateLimiterStorage.d.ts.map

package/dist/queue-limiter/IRateLimiterStorage.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"IRateLimiterStorage.d.ts","sourceRoot":"","sources":["../../src/queue-limiter/IRateLimiterStorage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE3D,eAAO,MAAM,oBAAoB,4DAAiE,CAAC;AAEnG;;;;;;;GAOG;AACH,MAAM,MAAM,uBAAuB,GAAG,SAAS,GAAG,SAAS,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,qDAAqD;IACrD,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;IAC5C,wCAAwC;IACxC,QAAQ,CAAC,YAAY,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC;CACnE;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;CACpC;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,uBAAuB,CAAC;IAExC;;;;OAIG;IACH,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/B;;;;;;;;;;;;;;;;;;;OAmBG;IACH,mBAAmB,CACjB,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAE3B;;;;;;;;OAQG;IACH,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnE;;;OAGG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElD;;;;;OAKG;IACH,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE/E;;;;;;OAMG;IACH,0BAA0B,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAE3F;;;;OAIG;IACH,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAErE;;;;OAIG;IACH,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhF;;;OAGG;IACH,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC"}

package/dist/queue-limiter/InMemoryRateLimiterStorage.d.ts

@@ -1,43 +0,0 @@
-/**
- * @license
- * Copyright 2025 Steven Roussey <sroussey@gmail.com>
- * SPDX-License-Identifier: Apache-2.0
- */
-import { IRateLimiterStorage, RateLimiterStorageOptions, RateLimiterStorageScope } from "./IRateLimiterStorage";
-export declare const IN_MEMORY_RATE_LIMITER_STORAGE: import("@workglow/util").ServiceToken<IRateLimiterStorage>;
-/**
- * In-memory implementation of rate limiter storage.
- * Manages execution records and next available times for rate limiting.
- */
-export declare class InMemoryRateLimiterStorage implements IRateLimiterStorage {
-    readonly scope: RateLimiterStorageScope;
-    /** The prefix values for filtering */
-    protected readonly prefixValues: Readonly<Record<string, string | number>>;
-    /** Execution records keyed by a composite of prefix values and queue name */
-    private readonly executions;
-    /** Next available times keyed by a composite of prefix values and queue name */
-    private readonly nextAvailableTimes;
-    /**
-     * Per-key promise chain used to serialize {@link tryReserveExecution} so
-     * concurrent callers cannot both observe `count < max` before either
-     * inserts. Each key's chain is replaced with the next pending operation
-     * before the current one returns, giving FIFO mutex semantics.
-     */
-    private readonly reserveChains;
-    constructor(options?: RateLimiterStorageOptions);
-    /**
-     * Creates a storage key from the queue name and prefix values.
-     */
-    private makeKey;
-    setupDatabase(): Promise<void>;
-    private withKeyLock;
-    tryReserveExecution(queueName: string, maxExecutions: number, windowMs: number): Promise<unknown | null>;
-    releaseExecution(queueName: string, token: unknown): Promise<void>;
-    recordExecution(queueName: string): Promise<void>;
-    getExecutionCount(queueName: string, windowStartTime: string): Promise<number>;
-    getOldestExecutionAtOffset(queueName: string, offset: number): Promise<string | undefined>;
-    getNextAvailableTime(queueName: string): Promise<string | undefined>;
-    setNextAvailableTime(queueName: string, nextAvailableAt: string): Promise<void>;
-    clear(queueName: string): Promise<void>;
-}
-//# sourceMappingURL=InMemoryRateLimiterStorage.d.ts.map

package/dist/queue-limiter/InMemoryRateLimiterStorage.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"InMemoryRateLimiterStorage.d.ts","sourceRoot":"","sources":["../../src/queue-limiter/InMemoryRateLimiterStorage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,uBAAuB,EACxB,MAAM,uBAAuB,CAAC;AAE/B,eAAO,MAAM,8BAA8B,4DAE1C,CAAC;AAYF;;;GAGG;AACH,qBAAa,0BAA2B,YAAW,mBAAmB;IACpE,SAAgB,KAAK,EAAE,uBAAuB,CAAa;IAE3D,sCAAsC;IACtC,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC;IAE3E,6EAA6E;IAC7E,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA4C;IAEvE,gFAAgF;IAChF,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAgC;IAEnE;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA4C;IAE1E,YAAY,OAAO,CAAC,EAAE,yBAAyB,EAE9C;IAED;;OAEG;IACH,OAAO,CAAC,OAAO;IAQF,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAE1C;YAOa,WAAW;IAkBZ,mBAAmB,CAC9B,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAuBzB;IAEY,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAc9E;IAEY,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAU7D;IAEY,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAM1F;IAEY,0BAA0B,CACrC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAO7B;IAEY,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAKhF;IAEY,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAI3F;IAEY,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKnD;CACF"}

package/dist/queue-limiter/IndexedDbRateLimiterStorage.d.ts

@@ -1,79 +0,0 @@
-/**
- * @license
- * Copyright 2025 Steven Roussey <sroussey@gmail.com>
- * SPDX-License-Identifier: Apache-2.0
- */
-import { MigrationOptions } from "../util/IndexedDbTable";
-import type { PrefixColumn } from "../queue/IQueueStorage";
-import { IRateLimiterStorage, RateLimiterStorageOptions, RateLimiterStorageScope } from "./IRateLimiterStorage";
-export declare const INDEXED_DB_RATE_LIMITER_STORAGE: import("@workglow/util").ServiceToken<IRateLimiterStorage>;
-/**
- * Extended options for IndexedDB rate limiter storage including prefix support.
- */
-export interface IndexedDbRateLimiterStorageOptions extends RateLimiterStorageOptions, MigrationOptions {
-}
-/**
- * IndexedDB implementation of rate limiter storage.
- * Manages execution records and next available times for rate limiting.
- *
- * Atomicity is `"process"`-scoped (browser tab) and the `next_available_at`
- * pre-check inside {@link tryReserveExecution} runs in a separate IDB
- * transaction from the count-and-insert. See {@link tryReserveExecution} for
- * the full caveat — do not assume cross-store atomicity.
- */
-export declare class IndexedDbRateLimiterStorage implements IRateLimiterStorage {
-    /**
-     * `"process"` — IndexedDB is per-origin and shared across tabs but not across
-     * processes (different machines, server processes). Within a single tab the
-     * `readwrite` transaction below provides atomicity.
-     */
-    readonly scope: RateLimiterStorageScope;
-    private executionDb;
-    private nextAvailableDb;
-    private readonly executionTableName;
-    private readonly nextAvailableTableName;
-    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>>;
-    constructor(options?: IndexedDbRateLimiterStorageOptions);
-    /**
-     * Gets prefix column names for use in indexes.
-     */
-    private getPrefixColumnNames;
-    /**
-     * Checks if a record matches the current prefix values.
-     */
-    private matchesPrefixes;
-    /**
-     * Gets prefix values as an array in column order for index key construction.
-     */
-    private getPrefixKeyValues;
-    private getExecutionDb;
-    private getNextAvailableDb;
-    setupDatabase(): Promise<void>;
-    /**
-     * Atomically reserves an execution slot in IndexedDB.
-     *
-     * Atomicity caveat: this implementation only serializes the `count + insert`
-     * pair (under a single `readwrite` IDB transaction over the executions
-     * store). The `next_available_at` lookup is a soft pre-check performed
-     * BEFORE the tx, because the executions and next-available object stores
-     * live in separate `IDBDatabase` instances by design (one
-     * `ensureIndexedDbTable` call each) and IDB transaction scope cannot cross
-     * databases. This is acceptable for IndexedDB's `"process"` scope: rate-
-     * limit overshoot from a stale next-available read is bounded by single-
-     * tab serial execution, and the stricter count check is what protects the
-     * primary maxExecutions invariant.
-     */
-    tryReserveExecution(queueName: string, maxExecutions: number, windowMs: number): Promise<unknown | null>;
-    releaseExecution(queueName: string, token: unknown): Promise<void>;
-    recordExecution(queueName: string): Promise<void>;
-    getExecutionCount(queueName: string, windowStartTime: string): Promise<number>;
-    getOldestExecutionAtOffset(queueName: string, offset: number): Promise<string | undefined>;
-    getNextAvailableTime(queueName: string): Promise<string | undefined>;
-    setNextAvailableTime(queueName: string, nextAvailableAt: string): Promise<void>;
-    clear(queueName: string): Promise<void>;
-}
-//# sourceMappingURL=IndexedDbRateLimiterStorage.d.ts.map

package/dist/queue-limiter/IndexedDbRateLimiterStorage.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"IndexedDbRateLimiterStorage.d.ts","sourceRoot":"","sources":["../../src/queue-limiter/IndexedDbRateLimiterStorage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAGL,gBAAgB,EACjB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,uBAAuB,EACxB,MAAM,uBAAuB,CAAC;AAE/B,eAAO,MAAM,+BAA+B,4DAE3C,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,kCACf,SAAQ,yBAAyB,EAAE,gBAAgB;CAAG;AAqBxD;;;;;;;;GAQG;AACH,qBAAa,2BAA4B,YAAW,mBAAmB;IACrE;;;;OAIG;IACH,SAAgB,KAAK,EAAE,uBAAuB,CAAa;IAC3D,OAAO,CAAC,WAAW,CAA0B;IAC7C,OAAO,CAAC,eAAe,CAA0B;IACjD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAS;IAC5C,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAS;IAChD,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;IAE3E,YAAY,OAAO,GAAE,kCAAuC,EAc3D;IAED;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAI5B;;OAEG;IACH,OAAO,CAAC,eAAe;IASvB;;OAEG;IACH,OAAO,CAAC,kBAAkB;YAIZ,cAAc;YAMd,kBAAkB;IAMnB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAqC1C;IAED;;;;;;;;;;;;;OAaG;IACU,mBAAmB,CAC9B,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAqEzB;IAEY,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAc9E;IAEY,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAsB7D;IAEY,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAgC1F;IAEY,0BAA0B,CACrC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAkC7B;IAEY,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAoBhF;IAEY,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA4B3F;IAEY,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA2CnD;CACF"}

package/dist/queue-limiter/PostgresRateLimiterStorage.d.ts

@@ -1,57 +0,0 @@
-/**
- * @license
- * Copyright 2025 Steven Roussey <sroussey@gmail.com>
- * SPDX-License-Identifier: Apache-2.0
- */
-import type { Pool } from "@workglow/storage/postgres";
-import type { PrefixColumn } from "../queue/IQueueStorage";
-import { IRateLimiterStorage, RateLimiterStorageOptions, RateLimiterStorageScope } from "./IRateLimiterStorage";
-export declare const POSTGRES_RATE_LIMITER_STORAGE: import("@workglow/util").ServiceToken<IRateLimiterStorage>;
-/**
- * PostgreSQL implementation of rate limiter storage.
- * Manages execution records and next available times for rate limiting.
- */
-export declare class PostgresRateLimiterStorage implements IRateLimiterStorage {
-    protected readonly db: Pool;
-    readonly scope: RateLimiterStorageScope;
-    /** 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 execution tracking */
-    protected readonly executionTableName: string;
-    /** The table name for next available times */
-    protected readonly nextAvailableTableName: string;
-    constructor(db: Pool, options?: RateLimiterStorageOptions);
-    /**
-     * 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
-     */
-    private buildPrefixWhereClause;
-    /**
-     * Gets prefix values as an array in column order.
-     */
-    private getPrefixParamValues;
-    setupDatabase(): Promise<void>;
-    tryReserveExecution(queueName: string, maxExecutions: number, windowMs: number): Promise<unknown | null>;
-    releaseExecution(queueName: string, token: unknown): Promise<void>;
-    recordExecution(queueName: string): Promise<void>;
-    getExecutionCount(queueName: string, windowStartTime: string): Promise<number>;
-    getOldestExecutionAtOffset(queueName: string, offset: number): Promise<string | undefined>;
-    getNextAvailableTime(queueName: string): Promise<string | undefined>;
-    setNextAvailableTime(queueName: string, nextAvailableAt: string): Promise<void>;
-    clear(queueName: string): Promise<void>;
-}
-//# sourceMappingURL=PostgresRateLimiterStorage.d.ts.map

package/dist/queue-limiter/PostgresRateLimiterStorage.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"PostgresRateLimiterStorage.d.ts","sourceRoot":"","sources":["../../src/queue-limiter/PostgresRateLimiterStorage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,uBAAuB,EACxB,MAAM,uBAAuB,CAAC;AAE/B,eAAO,MAAM,6BAA6B,4DAEzC,CAAC;AAEF;;;GAGG;AACH,qBAAa,0BAA2B,YAAW,mBAAmB;IAYlE,SAAS,CAAC,QAAQ,CAAC,EAAE,EAAE,IAAI;IAX7B,SAAgB,KAAK,EAAE,uBAAuB,CAAa;IAC3D,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,4CAA4C;IAC5C,SAAS,CAAC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IAC9C,8CAA8C;IAC9C,SAAS,CAAC,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;IAElD,YACqB,EAAE,EAAE,IAAI,EAC3B,OAAO,CAAC,EAAE,yBAAyB,EAcpC;IAED;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAI3B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAS7B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAI5B;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IAY9B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAIf,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CA+B1C;IAEY,mBAAmB,CAC9B,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAsIzB;IAEY,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAU9E;IAEY,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAkB7D;IAEY,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAa1F;IAEY,0BAA0B,CACrC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAiB7B;IAEY,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAehF;IAEY,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAwB3F;IAEY,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAWnD;CACF"}

package/dist/queue-limiter/SqliteRateLimiterStorage.d.ts

@@ -1,62 +0,0 @@
-/**
- * @license
- * Copyright 2025 Steven Roussey <sroussey@gmail.com>
- * SPDX-License-Identifier: Apache-2.0
- */
-import type { Sqlite } from "@workglow/storage/sqlite";
-import type { PrefixColumn } from "../queue/IQueueStorage";
-import { IRateLimiterStorage, RateLimiterStorageOptions, RateLimiterStorageScope } from "./IRateLimiterStorage";
-export declare const SQLITE_RATE_LIMITER_STORAGE: import("@workglow/util").ServiceToken<IRateLimiterStorage>;
-/**
- * SQLite implementation of rate limiter storage.
- * Manages execution records and next available times for rate limiting.
- */
-export declare class SqliteRateLimiterStorage implements IRateLimiterStorage {
-    protected readonly db: Sqlite.Database;
-    /**
-     * `"process"` because a typical SQLite deployment uses a single-process
-     * file. Multi-process SQLite (multiple worker processes opening the same
-     * file) is not safe for rate limiting even with WAL — separate processes
-     * can interleave between BEGIN IMMEDIATE acquisition retries.
-     */
-    readonly scope: RateLimiterStorageScope;
-    /** 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 execution tracking */
-    protected readonly executionTableName: string;
-    /** The table name for next available times */
-    protected readonly nextAvailableTableName: string;
-    constructor(db: Sqlite.Database, options?: RateLimiterStorageOptions);
-    /**
-     * 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.
-     */
-    private buildPrefixWhereClause;
-    /**
-     * Gets prefix values as an array in column order.
-     */
-    private getPrefixParamValues;
-    setupDatabase(): Promise<void>;
-    tryReserveExecution(queueName: string, maxExecutions: number, windowMs: number): Promise<unknown | null>;
-    releaseExecution(queueName: string, token: unknown): Promise<void>;
-    recordExecution(queueName: string): Promise<void>;
-    getExecutionCount(queueName: string, windowStartTime: string): Promise<number>;
-    getOldestExecutionAtOffset(queueName: string, offset: number): Promise<string | undefined>;
-    getNextAvailableTime(queueName: string): Promise<string | undefined>;
-    setNextAvailableTime(queueName: string, nextAvailableAt: string): Promise<void>;
-    clear(queueName: string): Promise<void>;
-}
-//# sourceMappingURL=SqliteRateLimiterStorage.d.ts.map

package/dist/queue-limiter/SqliteRateLimiterStorage.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"SqliteRateLimiterStorage.d.ts","sourceRoot":"","sources":["../../src/queue-limiter/SqliteRateLimiterStorage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAEvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,uBAAuB,EACxB,MAAM,uBAAuB,CAAC;AAE/B,eAAO,MAAM,2BAA2B,4DAEvC,CAAC;AAEF;;;GAGG;AACH,qBAAa,wBAAyB,YAAW,mBAAmB;IAkBhE,SAAS,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC,QAAQ;IAjBxC;;;;;OAKG;IACH,SAAgB,KAAK,EAAE,uBAAuB,CAAa;IAC3D,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,4CAA4C;IAC5C,SAAS,CAAC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IAC9C,8CAA8C;IAC9C,SAAS,CAAC,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;IAElD,YACqB,EAAE,EAAE,MAAM,CAAC,QAAQ,EACtC,OAAO,CAAC,EAAE,yBAAyB,EAcpC;IAED;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAI3B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAS7B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAI5B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAQ9B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAIf,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAyB1C;IAEY,mBAAmB,CAC9B,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAoDzB;IAEY,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAY9E;IAEY,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAa7D;IAEY,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAY1F;IAEY,0BAA0B,CACrC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAe7B;IAEY,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAahF;IAEY,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAc3F;IAEY,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAUnD;CACF"}

package/dist/queue-limiter/SupabaseRateLimiterStorage.d.ts

@@ -1,54 +0,0 @@
-/**
- * @license
- * Copyright 2025 Steven Roussey <sroussey@gmail.com>
- * SPDX-License-Identifier: Apache-2.0
- */
-import { SupabaseClient } from "@supabase/supabase-js";
-import type { PrefixColumn } from "../queue/IQueueStorage";
-import { IRateLimiterStorage, RateLimiterStorageOptions, RateLimiterStorageScope } from "./IRateLimiterStorage";
-export declare const SUPABASE_RATE_LIMITER_STORAGE: import("@workglow/util").ServiceToken<IRateLimiterStorage>;
-/**
- * Supabase implementation of rate limiter storage.
- * Manages execution records and next available times for rate limiting.
- */
-export declare class SupabaseRateLimiterStorage implements IRateLimiterStorage {
-    readonly scope: RateLimiterStorageScope;
-    protected readonly client: SupabaseClient;
-    protected readonly prefixes: readonly PrefixColumn[];
-    protected readonly prefixValues: Readonly<Record<string, string | number>>;
-    protected readonly executionTableName: string;
-    protected readonly nextAvailableTableName: string;
-    constructor(client: unknown, options?: RateLimiterStorageOptions);
-    /**
-     * 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;
-    setupDatabase(): Promise<void>;
-    /** Stable function name derived from table name (Postgres identifiers ≤63 chars). */
-    private atomicReserveFunctionName;
-    tryReserveExecution(queueName: string, maxExecutions: number, windowMs: number): Promise<unknown | null>;
-    releaseExecution(queueName: string, token: unknown): Promise<void>;
-    recordExecution(queueName: string): Promise<void>;
-    getExecutionCount(queueName: string, windowStartTime: string): Promise<number>;
-    getOldestExecutionAtOffset(queueName: string, offset: number): Promise<string | undefined>;
-    getNextAvailableTime(queueName: string): Promise<string | undefined>;
-    setNextAvailableTime(queueName: string, nextAvailableAt: string): Promise<void>;
-    clear(queueName: string): Promise<void>;
-}
-//# sourceMappingURL=SupabaseRateLimiterStorage.d.ts.map

package/dist/queue-limiter/SupabaseRateLimiterStorage.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"SupabaseRateLimiterStorage.d.ts","sourceRoot":"","sources":["../../src/queue-limiter/SupabaseRateLimiterStorage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,uBAAuB,EACxB,MAAM,uBAAuB,CAAC;AAE/B,eAAO,MAAM,6BAA6B,4DAEzC,CAAC;AAEF;;;GAGG;AACH,qBAAa,0BAA2B,YAAW,mBAAmB;IACpE,SAAgB,KAAK,EAAE,uBAAuB,CAAa;IAC3D,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAC1C,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,CAAC;IACrD,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC;IAC3E,SAAS,CAAC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IAC9C,SAAS,CAAC,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;IAElD,YAAY,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,yBAAyB,EAc/D;IAED;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAI3B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAS7B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAI5B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAQ1B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAQhB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAiG1C;IAED,qFAAqF;IACrF,OAAO,CAAC,yBAAyB;IAIpB,mBAAmB,CAC9B,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CA0BzB;IAEY,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAa9E;IAEY,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAS7D;IAEY,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAa1F;IAEY,0BAA0B,CACrC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAe7B;IAEY,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAiBhF;IAEY,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAkB3F;IAEY,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAanD;CACF"}

package/dist/sqlite/browser.d.ts

@@ -1,37 +0,0 @@
-/**
- * @license
- * Copyright 2025 Steven Roussey <sroussey@gmail.com>
- * SPDX-License-Identifier: Apache-2.0
- */
-import type { SqliteApi } from "./canonical-api";
-export type { SqliteApi };
-/**
- * Loads and initializes the SQLite WASM module. Idempotent; call once (and await) before
- * `new Sqlite.Database()` (same contract as Node and Bun).
- */
-declare function initSqlite(): Promise<void>;
-/**
- * better-sqlite3 / {@link Sqlite.Database}–shaped wrapper around sqlite-wasm {@link WasmDatabase}.
- */
-export declare class BrowserDatabase implements SqliteApi.Database {
-    private readonly inner;
-    constructor(filename?: string);
-    exec(sql: string): void;
-    prepare<BindParameters extends unknown[] | Record<string, unknown> = unknown[], Result = unknown>(sql: string): SqliteApi.Statement<BindParameters, Result>;
-    /**
-     * Same contract as better-sqlite3 / Bun: returns a function that runs `fn` inside a single
-     * SQL transaction (BEGIN → COMMIT or ROLLBACK).
-     */
-    transaction<T extends unknown[]>(fn: (...args: T) => void): (...args: T) => void;
-    close(): void;
-    loadExtension(_path: string, _entryPoint?: string): void;
-}
-export declare const Sqlite: {
-    readonly init: typeof initSqlite;
-    readonly Database: typeof BrowserDatabase;
-};
-/** Merged with {@link Sqlite} so `Sqlite.Database` works in type positions (not only as a value). */
-export declare namespace Sqlite {
-    type Database = InstanceType<typeof BrowserDatabase>;
-}
-//# sourceMappingURL=browser.d.ts.map

package/dist/sqlite/browser.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../src/sqlite/browser.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,YAAY,EAAE,SAAS,EAAE,CAAC;AAmB1B;;;GAGG;AACH,iBAAS,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAcnC;AA0DD;;GAEG;AACH,qBAAa,eAAgB,YAAW,SAAS,CAAC,QAAQ;IACxD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IAErC,YAAY,QAAQ,GAAE,MAAmB,EAGxC;IAED,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAEtB;IAED,OAAO,CAAC,cAAc,SAAS,OAAO,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,EAAE,EAAE,MAAM,GAAG,OAAO,EAC9F,GAAG,EAAE,MAAM,GACV,SAAS,CAAC,SAAS,CAAC,cAAc,EAAE,MAAM,CAAC,CAO7C;IAED;;;OAGG;IACH,WAAW,CAAC,CAAC,SAAS,OAAO,EAAE,EAAE,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,IAAI,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,IAAI,CAe/E;IAED,KAAK,IAAI,IAAI,CAEZ;IAED,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAEvD;CACF;AAED,eAAO,MAAM,MAAM;aACjB,IAAI;aACJ,QAAQ;CACA,CAAC;AAEX,qGAAqG;AACrG,yBAAiB,MAAM,CAAC,CAAC;IACvB,KAAY,QAAQ,GAAG,YAAY,CAAC,OAAO,eAAe,CAAC,CAAC;CAC7D"}

package/dist/sqlite/browser.js

@@ -1,125 +0,0 @@
-var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
-  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
-}) : x)(function(x) {
-  if (typeof require !== "undefined")
-    return require.apply(this, arguments);
-  throw Error('Dynamic require of "' + x + '" is not supported');
-});
-
-// src/sqlite/browser.ts
-var wasmModule;
-var initPromise;
-function assertWasmLoaded() {
-  if (!wasmModule) {
-    throw new Error("SQLite is not ready. Await Sqlite.init() before using new Sqlite.Database().");
-  }
-  return wasmModule;
-}
-function initSqlite() {
-  return initPromise ??= (async () => {
-    if (wasmModule) {
-      return;
-    }
-    try {
-      const { default: sqlite3InitModule } = await import("@sqlite.org/sqlite-wasm");
-      wasmModule = await sqlite3InitModule();
-    } catch {
-      throw new Error("@sqlite.org/sqlite-wasm is required for @workglow/storage/sqlite in the browser. Install: bun add @sqlite.org/sqlite-wasm");
-    }
-  })();
-}
-
-class BrowserStatement {
-  stmt;
-  db;
-  capi;
-  constructor(stmt, db, capi) {
-    this.stmt = stmt;
-    this.db = db;
-    this.capi = capi;
-  }
-  run(...params) {
-    this.stmt.reset(true);
-    if (params.length > 0) {
-      this.stmt.bind(params);
-    }
-    while (this.stmt.step()) {}
-    const changes = Number(this.db.changes(false, true));
-    const lastInsertRowid = this.capi.sqlite3_last_insert_rowid(this.db);
-    this.stmt.reset(true);
-    return { changes, lastInsertRowid };
-  }
-  get(...params) {
-    this.stmt.reset(true);
-    if (params.length > 0) {
-      this.stmt.bind(params);
-    }
-    if (!this.stmt.step()) {
-      this.stmt.reset(true);
-      return;
-    }
-    const row = this.stmt.get({});
-    this.stmt.reset(true);
-    return row;
-  }
-  all(...params) {
-    this.stmt.reset(true);
-    if (params.length > 0) {
-      this.stmt.bind(params);
-    }
-    const rows = [];
-    while (this.stmt.step()) {
-      rows.push(this.stmt.get({}));
-    }
-    this.stmt.reset(true);
-    return rows;
-  }
-  finalize() {
-    this.stmt.finalize();
-  }
-}
-
-class BrowserDatabase {
-  inner;
-  constructor(filename = ":memory:") {
-    const sqlite = assertWasmLoaded();
-    this.inner = new sqlite.oo1.DB(filename);
-  }
-  exec(sql) {
-    this.inner.exec(sql);
-  }
-  prepare(sql) {
-    const sqlite = assertWasmLoaded();
-    return new BrowserStatement(this.inner.prepare(sql), this.inner, sqlite.capi);
-  }
-  transaction(fn) {
-    return (...args) => {
-      this.exec("BEGIN");
-      try {
-        fn(...args);
-        this.exec("COMMIT");
-      } catch (err) {
-        try {
-          this.exec("ROLLBACK");
-        } catch {}
-        throw err;
-      }
-    };
-  }
-  close() {
-    this.inner.close();
-  }
-  loadExtension(_path, _entryPoint) {
-    throw new Error("SQLite loadExtension is not supported in the browser WASM build.");
-  }
-}
-var Sqlite = {
-  init: initSqlite,
-  Database: BrowserDatabase
-};
-export {
-  Sqlite,
-  BrowserDatabase
-};
-
-//# debugId=76CD359554DB6B6164756E2164756E21

package/dist/sqlite/browser.js.map

@@ -1,10 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../src/sqlite/browser.ts"],
-  "sourcesContent": [
-    "/**\n * @license\n * Copyright 2025 Steven Roussey <sroussey@gmail.com>\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport type * as SqliteWasmPkg from \"@sqlite.org/sqlite-wasm\";\n\nimport type { SqliteApi } from \"./canonical-api\";\n\nexport type { SqliteApi };\n\ntype WasmInit = typeof SqliteWasmPkg.default;\ntype WasmSqliteModule = Awaited<ReturnType<WasmInit>>;\n\ntype WasmDatabaseCtor = WasmSqliteModule[\"oo1\"][\"DB\"];\ntype WasmDatabase = InstanceType<WasmDatabaseCtor>;\ntype WasmStatement = ReturnType<WasmDatabase[\"prepare\"]>;\n\nlet wasmModule: WasmSqliteModule | undefined;\nlet initPromise: Promise<void> | undefined;\n\nfunction assertWasmLoaded(): WasmSqliteModule {\n  if (!wasmModule) {\n    throw new Error(\"SQLite is not ready. Await Sqlite.init() before using new Sqlite.Database().\");\n  }\n  return wasmModule;\n}\n\n/**\n * Loads and initializes the SQLite WASM module. Idempotent; call once (and await) before\n * `new Sqlite.Database()` (same contract as Node and Bun).\n */\nfunction initSqlite(): Promise<void> {\n  return (initPromise ??= (async () => {\n    if (wasmModule) {\n      return;\n    }\n    try {\n      const { default: sqlite3InitModule } = await import(\"@sqlite.org/sqlite-wasm\");\n      wasmModule = await sqlite3InitModule();\n    } catch {\n      throw new Error(\n        \"@sqlite.org/sqlite-wasm is required for @workglow/storage/sqlite in the browser. Install: bun add @sqlite.org/sqlite-wasm\"\n      );\n    }\n  })());\n}\n\nclass BrowserStatement<\n  BindParameters extends unknown[] | Record<string, unknown> = unknown[],\n  Result = unknown,\n> implements SqliteApi.Statement<BindParameters, Result> {\n  constructor(\n    private readonly stmt: WasmStatement,\n    private readonly db: WasmDatabase,\n    private readonly capi: WasmSqliteModule[\"capi\"]\n  ) {}\n\n  run(...params: unknown[]): SqliteApi.RunResult {\n    this.stmt.reset(true);\n    if (params.length > 0) {\n      this.stmt.bind(params as never);\n    }\n    while (this.stmt.step()) {\n      // drain result rows for statements that return data\n    }\n    const changes = Number(this.db.changes(false, true));\n    const lastInsertRowid = this.capi.sqlite3_last_insert_rowid(this.db);\n    this.stmt.reset(true);\n    return { changes, lastInsertRowid };\n  }\n\n  get(...params: unknown[]): Result | undefined {\n    this.stmt.reset(true);\n    if (params.length > 0) {\n      this.stmt.bind(params as never);\n    }\n    if (!this.stmt.step()) {\n      this.stmt.reset(true);\n      return undefined;\n    }\n    const row = this.stmt.get({});\n    this.stmt.reset(true);\n    return row as Result;\n  }\n\n  all(...params: unknown[]): Result[] {\n    this.stmt.reset(true);\n    if (params.length > 0) {\n      this.stmt.bind(params as never);\n    }\n    const rows: Result[] = [];\n    while (this.stmt.step()) {\n      rows.push(this.stmt.get({}) as Result);\n    }\n    this.stmt.reset(true);\n    return rows;\n  }\n\n  finalize(): void {\n    this.stmt.finalize();\n  }\n}\n\n/**\n * better-sqlite3 / {@link Sqlite.Database}–shaped wrapper around sqlite-wasm {@link WasmDatabase}.\n */\nexport class BrowserDatabase implements SqliteApi.Database {\n  private readonly inner: WasmDatabase;\n\n  constructor(filename: string = \":memory:\") {\n    const sqlite = assertWasmLoaded();\n    this.inner = new sqlite.oo1.DB(filename);\n  }\n\n  exec(sql: string): void {\n    this.inner.exec(sql);\n  }\n\n  prepare<BindParameters extends unknown[] | Record<string, unknown> = unknown[], Result = unknown>(\n    sql: string\n  ): SqliteApi.Statement<BindParameters, Result> {\n    const sqlite = assertWasmLoaded();\n    return new BrowserStatement<BindParameters, Result>(\n      this.inner.prepare(sql),\n      this.inner,\n      sqlite.capi\n    );\n  }\n\n  /**\n   * Same contract as better-sqlite3 / Bun: returns a function that runs `fn` inside a single\n   * SQL transaction (BEGIN → COMMIT or ROLLBACK).\n   */\n  transaction<T extends unknown[]>(fn: (...args: T) => void): (...args: T) => void {\n    return (...args: T) => {\n      this.exec(\"BEGIN\");\n      try {\n        fn(...args);\n        this.exec(\"COMMIT\");\n      } catch (err) {\n        try {\n          this.exec(\"ROLLBACK\");\n        } catch {\n          // prefer the original error if rollback fails\n        }\n        throw err;\n      }\n    };\n  }\n\n  close(): void {\n    this.inner.close();\n  }\n\n  loadExtension(_path: string, _entryPoint?: string): void {\n    throw new Error(\"SQLite loadExtension is not supported in the browser WASM build.\");\n  }\n}\n\nexport const Sqlite = {\n  init: initSqlite,\n  Database: BrowserDatabase,\n} as const;\n\n/** Merged with {@link Sqlite} so `Sqlite.Database` works in type positions (not only as a value). */\nexport namespace Sqlite {\n  export type Database = InstanceType<typeof BrowserDatabase>;\n}\n"
-  ],
-  "mappings": "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",
-  "debugId": "76CD359554DB6B6164756E2164756E21",
-  "names": []
-}