@workglow/storage 0.0.57 → 0.0.59

package/dist/common-server.d.ts

@@ -16,8 +16,12 @@ export * from "./kv/SupabaseKvRepository";
 export * from "./queue/PostgresQueueStorage";
 export * from "./queue/SqliteQueueStorage";
 export * from "./queue/SupabaseQueueStorage";
+export * from "./limiter/PostgresRateLimiterStorage";
+export * from "./limiter/SqliteRateLimiterStorage";
+export * from "./limiter/SupabaseRateLimiterStorage";
 export * from "./kv/IndexedDbKvRepository";
 export * from "./queue/IndexedDbQueueStorage";
 export * from "./tabular/IndexedDbTabularRepository";
+export * from "./limiter/IndexedDbRateLimiterStorage";
 export * from "./util/IndexedDbTable";
 //# sourceMappingURL=common-server.d.ts.map

package/dist/common-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"common-server.d.ts","sourceRoot":"","sources":["../src/common-server.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,UAAU,CAAC;AAEzB,cAAc,qCAAqC,CAAC;AACpD,cAAc,qCAAqC,CAAC;AACpD,cAAc,mCAAmC,CAAC;AAClD,cAAc,qCAAqC,CAAC;AAEpD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAE1C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAG7C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,sCAAsC,CAAC;AACrD,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"common-server.d.ts","sourceRoot":"","sources":["../src/common-server.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,UAAU,CAAC;AAEzB,cAAc,qCAAqC,CAAC;AACpD,cAAc,qCAAqC,CAAC;AACpD,cAAc,mCAAmC,CAAC;AAClD,cAAc,qCAAqC,CAAC;AAEpD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAE1C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAE7C,cAAc,sCAAsC,CAAC;AACrD,cAAc,oCAAoC,CAAC;AACnD,cAAc,sCAAsC,CAAC;AAGrD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,sCAAsC,CAAC;AACrD,cAAc,uCAAuC,CAAC;AACtD,cAAc,uBAAuB,CAAC"}

package/dist/common.d.ts

@@ -13,4 +13,6 @@ export * from "./kv/KvRepository";
 export * from "./kv/KvViaTabularRepository";
 export * from "./queue/InMemoryQueueStorage";
 export * from "./queue/IQueueStorage";
+export * from "./limiter/IRateLimiterStorage";
+export * from "./limiter/InMemoryRateLimiterStorage";
 //# sourceMappingURL=common.d.ts.map

package/dist/common.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../src/common.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,mCAAmC,CAAC;AAClD,cAAc,qCAAqC,CAAC;AACpD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,6BAA6B,CAAC;AAE5C,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,6BAA6B,CAAC;AAE5C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../src/common.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,mCAAmC,CAAC;AAClD,cAAc,qCAAqC,CAAC;AACpD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,6BAA6B,CAAC;AAE5C,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,6BAA6B,CAAC;AAE5C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uBAAuB,CAAC;AAEtC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,sCAAsC,CAAC"}

package/dist/limiter/IRateLimiterStorage.d.ts

@@ -0,0 +1,81 @@
+/**
+ * @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>;
+/**
+ * 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 {
+    /**
+     * 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>;
+    /**
+     * 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/limiter/IRateLimiterStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IRateLimiterStorage.d.ts","sourceRoot":"","sources":["../../src/limiter/IRateLimiterStorage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE3D,eAAO,MAAM,oBAAoB,4DAAiE,CAAC;AAEnG;;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,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/B;;;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/limiter/InMemoryRateLimiterStorage.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { IRateLimiterStorage, RateLimiterStorageOptions } 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 {
+    /** 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;
+    constructor(options?: RateLimiterStorageOptions);
+    /**
+     * Creates a storage key from the queue name and prefix values.
+     */
+    private makeKey;
+    setupDatabase(): 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/limiter/InMemoryRateLimiterStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InMemoryRateLimiterStorage.d.ts","sourceRoot":"","sources":["../../src/limiter/InMemoryRateLimiterStorage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAEvF,eAAO,MAAM,8BAA8B,4DAE1C,CAAC;AAUF;;;GAGG;AACH,qBAAa,0BAA2B,YAAW,mBAAmB;IACpE,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;gBAEvD,OAAO,CAAC,EAAE,yBAAyB;IAI/C;;OAEG;IACH,OAAO,CAAC,OAAO;IAQF,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAI9B,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWjD,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAQ9E,0BAA0B,CACrC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IASjB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAOpE,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM/E,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAMrD"}

package/dist/limiter/IndexedDbRateLimiterStorage.d.ts

@@ -0,0 +1,52 @@
+/**
+ * @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 } 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.
+ */
+export declare class IndexedDbRateLimiterStorage implements IRateLimiterStorage {
+    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>;
+    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/limiter/IndexedDbRateLimiterStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IndexedDbRateLimiterStorage.d.ts","sourceRoot":"","sources":["../../src/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,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAEvF,eAAO,MAAM,+BAA+B,4DAE3C,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,kCACf,SAAQ,yBAAyB,EAAE,gBAAgB;CAAG;AAqBxD;;;GAGG;AACH,qBAAa,2BAA4B,YAAW,mBAAmB;IACrE,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;gBAE/D,OAAO,GAAE,kCAAuC;IAgB5D;;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;IAyC9B,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAwBjD,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAkC9E,0BAA0B,CACrC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAoCjB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAsBpE,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA8B/E,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CA4CrD"}

package/dist/limiter/PostgresRateLimiterStorage.d.ts

@@ -0,0 +1,54 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Pool } from "pg";
+import type { PrefixColumn } from "../queue/IQueueStorage";
+import { IRateLimiterStorage, RateLimiterStorageOptions } 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;
+    /** 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>;
+    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/limiter/PostgresRateLimiterStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PostgresRateLimiterStorage.d.ts","sourceRoot":"","sources":["../../src/limiter/PostgresRateLimiterStorage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC1B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAEvF,eAAO,MAAM,6BAA6B,4DAEzC,CAAC;AAEF;;;GAGG;AACH,qBAAa,0BAA2B,YAAW,mBAAmB;IAWlE,SAAS,CAAC,QAAQ,CAAC,EAAE,EAAE,IAAI;IAV7B,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;gBAG7B,EAAE,EAAE,IAAI,EAC3B,OAAO,CAAC,EAAE,yBAAyB;IAgBrC;;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;IAiC9B,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBjD,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAe9E,0BAA0B,CACrC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAmBjB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAiBpE,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA0B/E,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAYrD"}

package/dist/limiter/SqliteRateLimiterStorage.d.ts

@@ -0,0 +1,53 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Sqlite } from "@workglow/sqlite";
+import type { PrefixColumn } from "../queue/IQueueStorage";
+import { IRateLimiterStorage, RateLimiterStorageOptions } 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;
+    /** 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>;
+    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/limiter/SqliteRateLimiterStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SqliteRateLimiterStorage.d.ts","sourceRoot":"","sources":["../../src/limiter/SqliteRateLimiterStorage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAEvF,eAAO,MAAM,2BAA2B,4DAEvC,CAAC;AAEF;;;GAGG;AACH,qBAAa,wBAAyB,YAAW,mBAAmB;IAWhE,SAAS,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC,QAAQ;IAVxC,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;gBAG7B,EAAE,EAAE,MAAM,CAAC,QAAQ,EACtC,OAAO,CAAC,EAAE,yBAAyB;IAgBrC;;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;IA2B9B,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAejD,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAc9E,0BAA0B,CACrC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAiBjB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAepE,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB/E,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAWrD"}

package/dist/limiter/SupabaseRateLimiterStorage.d.ts

@@ -0,0 +1,53 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { SupabaseClient } from "@supabase/supabase-js";
+import type { PrefixColumn } from "../queue/IQueueStorage";
+import { IRateLimiterStorage, RateLimiterStorageOptions } 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 {
+    protected readonly client: SupabaseClient;
+    /** 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(client: SupabaseClient, 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>;
+    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/limiter/SupabaseRateLimiterStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SupabaseRateLimiterStorage.d.ts","sourceRoot":"","sources":["../../src/limiter/SupabaseRateLimiterStorage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAEvF,eAAO,MAAM,6BAA6B,4DAEzC,CAAC;AAEF;;;GAGG;AACH,qBAAa,0BAA2B,YAAW,mBAAmB;IAWlE,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,cAAc;IAV3C,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;gBAG7B,MAAM,EAAE,cAAc,EACzC,OAAO,CAAC,EAAE,yBAAyB;IAgBrC;;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;IAmD9B,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWjD,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAe9E,0BAA0B,CACrC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAiBjB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAmBpE,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB/E,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAcrD"}