@commandkit/ratelimit 0.0.0-dev.20260317060555

package/dist/providers/fallback.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Provider re-export for fallback storage.
+ *
+ * Exposes the wrapper and its options for consumers.
+ */
+export { FallbackRateLimitStorage } from '../storage/fallback';
+export type { FallbackRateLimitStorageOptions } from '../storage/fallback';

package/dist/providers/fallback.js

@@ -0,0 +1,11 @@
+"use strict";
+/**
+ * Provider re-export for fallback storage.
+ *
+ * Exposes the wrapper and its options for consumers.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FallbackRateLimitStorage = void 0;
+var fallback_1 = require("../storage/fallback");
+Object.defineProperty(exports, "FallbackRateLimitStorage", { enumerable: true, get: function () { return fallback_1.FallbackRateLimitStorage; } });
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZmFsbGJhY2suanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvcHJvdmlkZXJzL2ZhbGxiYWNrLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7QUFBQTs7OztHQUlHOzs7QUFFSCxnREFBK0Q7QUFBdEQsb0hBQUEsd0JBQXdCLE9BQUEifQ==

package/dist/providers/memory.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Provider re-export for memory storage.
+ *
+ * Keeps public imports stable across plugin packages.
+ */
+export { MemoryRateLimitStorage } from '../storage/memory';

package/dist/providers/memory.js

@@ -0,0 +1,11 @@
+"use strict";
+/**
+ * Provider re-export for memory storage.
+ *
+ * Keeps public imports stable across plugin packages.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemoryRateLimitStorage = void 0;
+var memory_1 = require("../storage/memory");
+Object.defineProperty(exports, "MemoryRateLimitStorage", { enumerable: true, get: function () { return memory_1.MemoryRateLimitStorage; } });
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibWVtb3J5LmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL3Byb3ZpZGVycy9tZW1vcnkudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IjtBQUFBOzs7O0dBSUc7OztBQUVILDRDQUEyRDtBQUFsRCxnSEFBQSxzQkFBc0IsT0FBQSJ9

package/dist/providers/redis.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Provider re-export for Redis storage.
+ *
+ * Exposes the storage class and RedisOptions type for consumers.
+ */
+export { RedisRateLimitStorage } from '../storage/redis';
+export type { RedisOptions } from 'ioredis';

package/dist/providers/redis.js

@@ -0,0 +1,11 @@
+"use strict";
+/**
+ * Provider re-export for Redis storage.
+ *
+ * Exposes the storage class and RedisOptions type for consumers.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RedisRateLimitStorage = void 0;
+var redis_1 = require("../storage/redis");
+Object.defineProperty(exports, "RedisRateLimitStorage", { enumerable: true, get: function () { return redis_1.RedisRateLimitStorage; } });
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicmVkaXMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvcHJvdmlkZXJzL3JlZGlzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7QUFBQTs7OztHQUlHOzs7QUFFSCwwQ0FBeUQ7QUFBaEQsOEdBQUEscUJBQXFCLE9BQUEifQ==

package/dist/runtime.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Runtime globals for rate limiting.
+ *
+ * Stores the active storage and plugin context for directives and helpers.
+ */
+import type { RateLimitRuntimeContext, RateLimitStorage } from './types';
+/**
+ * Set the default rate limit storage instance for the process.
+ *
+ * @param storage - Storage driver to use for rate-limit state.
+ * @returns Nothing; updates the process-wide default storage.
+ */
+export declare function setRateLimitStorage(storage: RateLimitStorage): void;
+/**
+ * Get the default rate limit storage instance for the process.
+ *
+ * @returns Default storage instance or null if unset.
+ */
+export declare function getRateLimitStorage(): RateLimitStorage | null;
+/**
+ * Alias for setRateLimitStorage to match other packages (tasks/queue).
+ *
+ * @param storage - Storage driver to use for rate-limit state.
+ * @returns Nothing; updates the process-wide default storage.
+ */
+export declare function setDriver(storage: RateLimitStorage): void;
+/**
+ * Alias for getRateLimitStorage to match other packages (tasks/queue).
+ *
+ * @returns Default storage instance or null if unset.
+ */
+export declare function getDriver(): RateLimitStorage | null;
+/**
+ * Set the active runtime context used by directives and APIs.
+ *
+ * @param runtime - Active runtime context or null to clear.
+ * @returns Nothing; updates the active runtime context.
+ */
+export declare function setRateLimitRuntime(runtime: RateLimitRuntimeContext | null): void;
+/**
+ * Get the active runtime context for directives and APIs.
+ *
+ * @returns Active runtime context or null if not initialized.
+ */
+export declare function getRateLimitRuntime(): RateLimitRuntimeContext | null;

package/dist/runtime.js

@@ -0,0 +1,67 @@
+"use strict";
+/**
+ * Runtime globals for rate limiting.
+ *
+ * Stores the active storage and plugin context for directives and helpers.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setRateLimitStorage = setRateLimitStorage;
+exports.getRateLimitStorage = getRateLimitStorage;
+exports.setDriver = setDriver;
+exports.getDriver = getDriver;
+exports.setRateLimitRuntime = setRateLimitRuntime;
+exports.getRateLimitRuntime = getRateLimitRuntime;
+let defaultStorage = null;
+let activeRuntime = null;
+/**
+ * Set the default rate limit storage instance for the process.
+ *
+ * @param storage - Storage driver to use for rate-limit state.
+ * @returns Nothing; updates the process-wide default storage.
+ */
+function setRateLimitStorage(storage) {
+    defaultStorage = storage;
+}
+/**
+ * Get the default rate limit storage instance for the process.
+ *
+ * @returns Default storage instance or null if unset.
+ */
+function getRateLimitStorage() {
+    return defaultStorage;
+}
+/**
+ * Alias for setRateLimitStorage to match other packages (tasks/queue).
+ *
+ * @param storage - Storage driver to use for rate-limit state.
+ * @returns Nothing; updates the process-wide default storage.
+ */
+function setDriver(storage) {
+    setRateLimitStorage(storage);
+}
+/**
+ * Alias for getRateLimitStorage to match other packages (tasks/queue).
+ *
+ * @returns Default storage instance or null if unset.
+ */
+function getDriver() {
+    return getRateLimitStorage();
+}
+/**
+ * Set the active runtime context used by directives and APIs.
+ *
+ * @param runtime - Active runtime context or null to clear.
+ * @returns Nothing; updates the active runtime context.
+ */
+function setRateLimitRuntime(runtime) {
+    activeRuntime = runtime;
+}
+/**
+ * Get the active runtime context for directives and APIs.
+ *
+ * @returns Active runtime context or null if not initialized.
+ */
+function getRateLimitRuntime() {
+    return activeRuntime;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicnVudGltZS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NyYy9ydW50aW1lLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7QUFBQTs7OztHQUlHOztBQWFILGtEQUVDO0FBT0Qsa0RBRUM7QUFRRCw4QkFFQztBQU9ELDhCQUVDO0FBUUQsa0RBSUM7QUFPRCxrREFFQztBQTVERCxJQUFJLGNBQWMsR0FBNEIsSUFBSSxDQUFDO0FBQ25ELElBQUksYUFBYSxHQUFtQyxJQUFJLENBQUM7QUFFekQ7Ozs7O0dBS0c7QUFDSCxTQUFnQixtQkFBbUIsQ0FBQyxPQUF5QjtJQUMzRCxjQUFjLEdBQUcsT0FBTyxDQUFDO0FBQzNCLENBQUM7QUFFRDs7OztHQUlHO0FBQ0gsU0FBZ0IsbUJBQW1CO0lBQ2pDLE9BQU8sY0FBYyxDQUFDO0FBQ3hCLENBQUM7QUFFRDs7Ozs7R0FLRztBQUNILFNBQWdCLFNBQVMsQ0FBQyxPQUF5QjtJQUNqRCxtQkFBbUIsQ0FBQyxPQUFPLENBQUMsQ0FBQztBQUMvQixDQUFDO0FBRUQ7Ozs7R0FJRztBQUNILFNBQWdCLFNBQVM7SUFDdkIsT0FBTyxtQkFBbUIsRUFBRSxDQUFDO0FBQy9CLENBQUM7QUFFRDs7Ozs7R0FLRztBQUNILFNBQWdCLG1CQUFtQixDQUNqQyxPQUF1QztJQUV2QyxhQUFhLEdBQUcsT0FBTyxDQUFDO0FBQzFCLENBQUM7QUFFRDs7OztHQUlHO0FBQ0gsU0FBZ0IsbUJBQW1CO0lBQ2pDLE9BQU8sYUFBYSxDQUFDO0FBQ3ZCLENBQUMifQ==

package/dist/storage/fallback.d.ts

@@ -0,0 +1,180 @@
+/**
+ * Fallback storage wrapper.
+ *
+ * Routes storage calls to a secondary backend when the primary fails.
+ */
+import type { RateLimitStorage } from '../types';
+/**
+ * Options that control fallback logging/cooldown behavior.
+ */
+export interface FallbackRateLimitStorageOptions {
+    /**
+     * Minimum time between fallback log entries (to avoid log spam).
+     *
+     * @default 30000
+     */
+    cooldownMs?: number;
+}
+/**
+ * Storage wrapper that falls back to a secondary implementation on failure.
+ *
+ * @implements RateLimitStorage
+ */
+export declare class FallbackRateLimitStorage implements RateLimitStorage {
+    private readonly primary;
+    private readonly secondary;
+    private readonly options;
+    private lastErrorAt;
+    /**
+     * Create a fallback wrapper with primary/secondary storages.
+     *
+     * @param primary - Primary storage backend.
+     * @param secondary - Secondary storage backend used on failure.
+     * @param options - Fallback logging and cooldown options.
+     */
+    constructor(primary: RateLimitStorage, secondary: RateLimitStorage, options?: FallbackRateLimitStorageOptions);
+    /**
+     * Check whether a fallback error should be logged.
+     *
+     * @returns True when the log cooldown has elapsed.
+     */
+    private shouldLog;
+    /**
+     * Execute a storage operation with a fallback on failure.
+     *
+     * @param op - Primary operation.
+     * @param fallback - Secondary operation when primary fails.
+     * @returns Result from the primary or fallback operation.
+     */
+    private withFallback;
+    /**
+     * Read a value using primary storage with fallback.
+     *
+     * @param key - Storage key to read.
+     * @returns Stored value or null when absent.
+     */
+    get<T = unknown>(key: string): Promise<T | null>;
+    /**
+     * Store a value using primary storage with fallback.
+     *
+     * @param key - Storage key to write.
+     * @param value - Value to store.
+     * @param ttlMs - Optional TTL in milliseconds.
+     * @returns Resolves when the value is stored.
+     */
+    set<T = unknown>(key: string, value: T, ttlMs?: number): Promise<void>;
+    /**
+     * Delete a key using primary storage with fallback.
+     *
+     * @param key - Storage key to delete.
+     * @returns Resolves when the key is removed.
+     */
+    delete(key: string): Promise<void>;
+    /**
+     * Increment a fixed-window counter using primary storage with fallback.
+     *
+     * @param key - Storage key to increment.
+     * @param ttlMs - TTL window in milliseconds.
+     * @returns Fixed-window consume result.
+     * @throws Error when either storage lacks incr support.
+     */
+    incr(key: string, ttlMs: number): Promise<import("../types").FixedWindowConsumeResult>;
+    /**
+     * Read TTL using primary storage with fallback.
+     *
+     * @param key - Storage key to inspect.
+     * @returns Remaining TTL in ms or null when no TTL is set.
+     * @throws Error when either storage lacks ttl support.
+     */
+    ttl(key: string): Promise<number | null>;
+    /**
+     * Update TTL using primary storage with fallback.
+     *
+     * @param key - Storage key to update.
+     * @param ttlMs - TTL in milliseconds.
+     * @returns Resolves after the TTL is updated.
+     * @throws Error when either storage lacks expire support.
+     */
+    expire(key: string, ttlMs: number): Promise<void>;
+    /**
+     * Add a member to a sorted set using primary storage with fallback.
+     *
+     * @param key - Sorted-set key.
+     * @param score - Score to associate with the member.
+     * @param member - Member identifier.
+     * @returns Resolves when the member is added.
+     */
+    zAdd(key: string, score: number, member: string): Promise<void>;
+    /**
+     * Remove sorted-set members in a score range with fallback.
+     *
+     * @param key - Sorted-set key.
+     * @param min - Minimum score (inclusive).
+     * @param max - Maximum score (inclusive).
+     * @returns Resolves when the range is removed.
+     */
+    zRemRangeByScore(key: string, min: number, max: number): Promise<void>;
+    /**
+     * Count sorted-set members with fallback.
+     *
+     * @param key - Sorted-set key.
+     * @returns Number of members in the set.
+     */
+    zCard(key: string): Promise<number>;
+    /**
+     * Read sorted-set members in a score range with fallback.
+     *
+     * @param key - Sorted-set key.
+     * @param min - Minimum score (inclusive).
+     * @param max - Maximum score (inclusive).
+     * @returns Ordered members in the score range.
+     */
+    zRangeByScore(key: string, min: number, max: number): Promise<string[]>;
+    /**
+     * Atomically consume a fixed-window counter with fallback.
+     *
+     * @param key - Storage key to consume.
+     * @param limit - Request limit for the window.
+     * @param windowMs - Window size in milliseconds.
+     * @param nowMs - Current timestamp in milliseconds.
+     * @returns Fixed-window consume result.
+     * @throws Error when either storage lacks consumeFixedWindow support.
+     */
+    consumeFixedWindow(key: string, limit: number, windowMs: number, nowMs: number): Promise<import("../types").FixedWindowConsumeResult>;
+    /**
+     * Atomically consume a sliding-window log with fallback.
+     *
+     * @param key - Storage key to consume.
+     * @param limit - Request limit for the window.
+     * @param windowMs - Window size in milliseconds.
+     * @param nowMs - Current timestamp in milliseconds.
+     * @param member - Member identifier for this request.
+     * @returns Sliding-window consume result.
+     * @throws Error when either storage lacks consumeSlidingWindowLog support.
+     */
+    consumeSlidingWindowLog(key: string, limit: number, windowMs: number, nowMs: number, member: string): Promise<import("../types").SlidingWindowConsumeResult>;
+    /**
+     * Delete keys with a prefix using primary storage with fallback.
+     *
+     * @param prefix - Prefix to match.
+     * @returns Resolves after matching keys are deleted.
+     * @throws Error when either storage lacks deleteByPrefix support.
+     */
+    deleteByPrefix(prefix: string): Promise<void>;
+    /**
+     * Delete keys matching a pattern using primary storage with fallback.
+     *
+     * @param pattern - Glob pattern to match.
+     * @returns Resolves after matching keys are deleted.
+     * @throws Error when either storage lacks deleteByPattern support.
+     */
+    deleteByPattern(pattern: string): Promise<void>;
+    /**
+     * List keys matching a prefix using primary storage with fallback.
+     *
+     * @param prefix - Prefix to match.
+     * @returns Matching keys.
+     * @throws Error when either storage lacks keysByPrefix support.
+     */
+    keysByPrefix(prefix: string): Promise<string[]>;
+}

package/dist/storage/fallback.js

@@ -0,0 +1,261 @@
+"use strict";
+/**
+ * Fallback storage wrapper.
+ *
+ * Routes storage calls to a secondary backend when the primary fails.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FallbackRateLimitStorage = void 0;
+const commandkit_1 = require("commandkit");
+/**
+ * Storage wrapper that falls back to a secondary implementation on failure.
+ *
+ * @implements RateLimitStorage
+ */
+class FallbackRateLimitStorage {
+    /**
+     * Create a fallback wrapper with primary/secondary storages.
+     *
+     * @param primary - Primary storage backend.
+     * @param secondary - Secondary storage backend used on failure.
+     * @param options - Fallback logging and cooldown options.
+     */
+    constructor(primary, secondary, options = {}) {
+        this.primary = primary;
+        this.secondary = secondary;
+        this.options = options;
+        this.lastErrorAt = 0;
+    }
+    /**
+     * Check whether a fallback error should be logged.
+     *
+     * @returns True when the log cooldown has elapsed.
+     */
+    shouldLog() {
+        const now = Date.now();
+        const cooldown = this.options.cooldownMs ?? 30000;
+        if (now - this.lastErrorAt > cooldown) {
+            this.lastErrorAt = now;
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Execute a storage operation with a fallback on failure.
+     *
+     * @param op - Primary operation.
+     * @param fallback - Secondary operation when primary fails.
+     * @returns Result from the primary or fallback operation.
+     */
+    async withFallback(op, fallback) {
+        try {
+            return await op();
+        }
+        catch (error) {
+            if (this.shouldLog()) {
+                commandkit_1.Logger.error `[ratelimit] Storage error, falling back to secondary: ${error}`;
+            }
+            return fallback();
+        }
+    }
+    /**
+     * Read a value using primary storage with fallback.
+     *
+     * @param key - Storage key to read.
+     * @returns Stored value or null when absent.
+     */
+    async get(key) {
+        return this.withFallback(() => this.primary.get(key), () => this.secondary.get(key));
+    }
+    /**
+     * Store a value using primary storage with fallback.
+     *
+     * @param key - Storage key to write.
+     * @param value - Value to store.
+     * @param ttlMs - Optional TTL in milliseconds.
+     * @returns Resolves when the value is stored.
+     */
+    async set(key, value, ttlMs) {
+        return this.withFallback(() => this.primary.set(key, value, ttlMs), () => this.secondary.set(key, value, ttlMs));
+    }
+    /**
+     * Delete a key using primary storage with fallback.
+     *
+     * @param key - Storage key to delete.
+     * @returns Resolves when the key is removed.
+     */
+    async delete(key) {
+        return this.withFallback(() => this.primary.delete(key), () => this.secondary.delete(key));
+    }
+    /**
+     * Increment a fixed-window counter using primary storage with fallback.
+     *
+     * @param key - Storage key to increment.
+     * @param ttlMs - TTL window in milliseconds.
+     * @returns Fixed-window consume result.
+     * @throws Error when either storage lacks incr support.
+     */
+    async incr(key, ttlMs) {
+        if (!this.primary.incr || !this.secondary.incr) {
+            throw new Error('incr not supported by both storages');
+        }
+        return this.withFallback(() => this.primary.incr(key, ttlMs), () => this.secondary.incr(key, ttlMs));
+    }
+    /**
+     * Read TTL using primary storage with fallback.
+     *
+     * @param key - Storage key to inspect.
+     * @returns Remaining TTL in ms or null when no TTL is set.
+     * @throws Error when either storage lacks ttl support.
+     */
+    async ttl(key) {
+        if (!this.primary.ttl || !this.secondary.ttl) {
+            throw new Error('ttl not supported by both storages');
+        }
+        return this.withFallback(() => this.primary.ttl(key), () => this.secondary.ttl(key));
+    }
+    /**
+     * Update TTL using primary storage with fallback.
+     *
+     * @param key - Storage key to update.
+     * @param ttlMs - TTL in milliseconds.
+     * @returns Resolves after the TTL is updated.
+     * @throws Error when either storage lacks expire support.
+     */
+    async expire(key, ttlMs) {
+        if (!this.primary.expire || !this.secondary.expire) {
+            throw new Error('expire not supported by both storages');
+        }
+        return this.withFallback(() => this.primary.expire(key, ttlMs), () => this.secondary.expire(key, ttlMs));
+    }
+    /**
+     * Add a member to a sorted set using primary storage with fallback.
+     *
+     * @param key - Sorted-set key.
+     * @param score - Score to associate with the member.
+     * @param member - Member identifier.
+     * @returns Resolves when the member is added.
+     */
+    async zAdd(key, score, member) {
+        if (!this.primary.zAdd || !this.secondary.zAdd) {
+            throw new Error('zAdd not supported by both storages');
+        }
+        return this.withFallback(() => this.primary.zAdd(key, score, member), () => this.secondary.zAdd(key, score, member));
+    }
+    /**
+     * Remove sorted-set members in a score range with fallback.
+     *
+     * @param key - Sorted-set key.
+     * @param min - Minimum score (inclusive).
+     * @param max - Maximum score (inclusive).
+     * @returns Resolves when the range is removed.
+     */
+    async zRemRangeByScore(key, min, max) {
+        if (!this.primary.zRemRangeByScore || !this.secondary.zRemRangeByScore) {
+            throw new Error('zRemRangeByScore not supported by both storages');
+        }
+        return this.withFallback(() => this.primary.zRemRangeByScore(key, min, max), () => this.secondary.zRemRangeByScore(key, min, max));
+    }
+    /**
+     * Count sorted-set members with fallback.
+     *
+     * @param key - Sorted-set key.
+     * @returns Number of members in the set.
+     */
+    async zCard(key) {
+        if (!this.primary.zCard || !this.secondary.zCard) {
+            throw new Error('zCard not supported by both storages');
+        }
+        return this.withFallback(() => this.primary.zCard(key), () => this.secondary.zCard(key));
+    }
+    /**
+     * Read sorted-set members in a score range with fallback.
+     *
+     * @param key - Sorted-set key.
+     * @param min - Minimum score (inclusive).
+     * @param max - Maximum score (inclusive).
+     * @returns Ordered members in the score range.
+     */
+    async zRangeByScore(key, min, max) {
+        if (!this.primary.zRangeByScore || !this.secondary.zRangeByScore) {
+            throw new Error('zRangeByScore not supported by both storages');
+        }
+        return this.withFallback(() => this.primary.zRangeByScore(key, min, max), () => this.secondary.zRangeByScore(key, min, max));
+    }
+    /**
+     * Atomically consume a fixed-window counter with fallback.
+     *
+     * @param key - Storage key to consume.
+     * @param limit - Request limit for the window.
+     * @param windowMs - Window size in milliseconds.
+     * @param nowMs - Current timestamp in milliseconds.
+     * @returns Fixed-window consume result.
+     * @throws Error when either storage lacks consumeFixedWindow support.
+     */
+    async consumeFixedWindow(key, limit, windowMs, nowMs) {
+        if (!this.primary.consumeFixedWindow ||
+            !this.secondary.consumeFixedWindow) {
+            throw new Error('consumeFixedWindow not supported by both storages');
+        }
+        return this.withFallback(() => this.primary.consumeFixedWindow(key, limit, windowMs, nowMs), () => this.secondary.consumeFixedWindow(key, limit, windowMs, nowMs));
+    }
+    /**
+     * Atomically consume a sliding-window log with fallback.
+     *
+     * @param key - Storage key to consume.
+     * @param limit - Request limit for the window.
+     * @param windowMs - Window size in milliseconds.
+     * @param nowMs - Current timestamp in milliseconds.
+     * @param member - Member identifier for this request.
+     * @returns Sliding-window consume result.
+     * @throws Error when either storage lacks consumeSlidingWindowLog support.
+     */
+    async consumeSlidingWindowLog(key, limit, windowMs, nowMs, member) {
+        if (!this.primary.consumeSlidingWindowLog ||
+            !this.secondary.consumeSlidingWindowLog) {
+            throw new Error('consumeSlidingWindowLog not supported by both storages');
+        }
+        return this.withFallback(() => this.primary.consumeSlidingWindowLog(key, limit, windowMs, nowMs, member), () => this.secondary.consumeSlidingWindowLog(key, limit, windowMs, nowMs, member));
+    }
+    /**
+     * Delete keys with a prefix using primary storage with fallback.
+     *
+     * @param prefix - Prefix to match.
+     * @returns Resolves after matching keys are deleted.
+     * @throws Error when either storage lacks deleteByPrefix support.
+     */
+    async deleteByPrefix(prefix) {
+        if (!this.primary.deleteByPrefix || !this.secondary.deleteByPrefix) {
+            throw new Error('deleteByPrefix not supported by both storages');
+        }
+        return this.withFallback(() => this.primary.deleteByPrefix(prefix), () => this.secondary.deleteByPrefix(prefix));
+    }
+    /**
+     * Delete keys matching a pattern using primary storage with fallback.
+     *
+     * @param pattern - Glob pattern to match.
+     * @returns Resolves after matching keys are deleted.
+     * @throws Error when either storage lacks deleteByPattern support.
+     */
+    async deleteByPattern(pattern) {
+        if (!this.primary.deleteByPattern || !this.secondary.deleteByPattern) {
+            throw new Error('deleteByPattern not supported by both storages');
+        }
+        return this.withFallback(() => this.primary.deleteByPattern(pattern), () => this.secondary.deleteByPattern(pattern));
+    }
+    /**
+     * List keys matching a prefix using primary storage with fallback.
+     *
+     * @param prefix - Prefix to match.
+     * @returns Matching keys.
+     * @throws Error when either storage lacks keysByPrefix support.
+     */
+    async keysByPrefix(prefix) {
+        if (!this.primary.keysByPrefix || !this.secondary.keysByPrefix) {
+            throw new Error('keysByPrefix not supported by both storages');
+        }
+        return this.withFallback(() => this.primary.keysByPrefix(prefix), () => this.secondary.keysByPrefix(prefix));
+    }
+}
+exports.FallbackRateLimitStorage = FallbackRateLimitStorage;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZmFsbGJhY2suanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvc3RvcmFnZS9mYWxsYmFjay50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiO0FBQUE7Ozs7R0FJRzs7O0FBRUgsMkNBQW9DO0FBZXBDOzs7O0dBSUc7QUFDSCxNQUFhLHdCQUF3QjtJQUduQzs7Ozs7O09BTUc7SUFDSCxZQUNtQixPQUF5QixFQUN6QixTQUEyQixFQUMzQixVQUEyQyxFQUFFO1FBRjdDLFlBQU8sR0FBUCxPQUFPLENBQWtCO1FBQ3pCLGNBQVMsR0FBVCxTQUFTLENBQWtCO1FBQzNCLFlBQU8sR0FBUCxPQUFPLENBQXNDO1FBWnhELGdCQUFXLEdBQUcsQ0FBQyxDQUFDO0lBYXJCLENBQUM7SUFFSjs7OztPQUlHO0lBQ0ssU0FBUztRQUNmLE1BQU0sR0FBRyxHQUFHLElBQUksQ0FBQyxHQUFHLEVBQUUsQ0FBQztRQUN2QixNQUFNLFFBQVEsR0FBRyxJQUFJLENBQUMsT0FBTyxDQUFDLFVBQVUsSUFBSSxLQUFNLENBQUM7UUFDbkQsSUFBSSxHQUFHLEdBQUcsSUFBSSxDQUFDLFdBQVcsR0FBRyxRQUFRLEVBQUUsQ0FBQztZQUN0QyxJQUFJLENBQUMsV0FBVyxHQUFHLEdBQUcsQ0FBQztZQUN2QixPQUFPLElBQUksQ0FBQztRQUNkLENBQUM7UUFDRCxPQUFPLEtBQUssQ0FBQztJQUNmLENBQUM7SUFFRDs7Ozs7O09BTUc7SUFDSyxLQUFLLENBQUMsWUFBWSxDQUN4QixFQUFvQixFQUNwQixRQUEwQjtRQUUxQixJQUFJLENBQUM7WUFDSCxPQUFPLE1BQU0sRUFBRSxFQUFFLENBQUM7UUFDcEIsQ0FBQztRQUFDLE9BQU8sS0FBSyxFQUFFLENBQUM7WUFDZixJQUFJLElBQUksQ0FBQyxTQUFTLEVBQUUsRUFBRSxDQUFDO2dCQUNyQixtQkFBTSxDQUFDLEtBQUssQ0FBQSx5REFBeUQsS0FBSyxFQUFFLENBQUM7WUFDL0UsQ0FBQztZQUNELE9BQU8sUUFBUSxFQUFF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