limitly 1.0.1 → 2.0.0

package/dist/middleware/nest.js

@@ -0,0 +1,102 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LimitlyModule = exports.RateLimit = exports.RATE_LIMIT_KEY = void 0;
+exports.createNestGuard = createNestGuard;
+exports.limitlyNestModule = limitlyNestModule;
+const common_1 = require("@nestjs/common");
+const core_1 = require("@nestjs/core");
+const headers_1 = require("../utils/headers");
+const metrics_1 = require("../utils/metrics");
+const DEFAULT_KEY = (req) => req.ip ?? "unknown";
+exports.RATE_LIMIT_KEY = "limitly:rate-limit";
+const RateLimit = (options) => (0, common_1.SetMetadata)(exports.RATE_LIMIT_KEY, options);
+exports.RateLimit = RateLimit;
+function createNestGuard(limiter) {
+    return function guard(defaultOptions) {
+        let NestGuard = class NestGuard {
+            constructor(reflector) {
+                this.reflector = reflector;
+            }
+            async canActivate(context) {
+                const metadata = this.reflector.getAllAndOverride(exports.RATE_LIMIT_KEY, [context.getHandler(), context.getClass()]);
+                const shouldApply = metadata !== undefined ||
+                    defaultOptions !== undefined ||
+                    Object.keys(limiter.getDefaultOptions()).length > 0;
+                if (!shouldApply) {
+                    return true;
+                }
+                const options = limiter.resolveOptions({
+                    ...defaultOptions,
+                    ...metadata,
+                });
+                const strategy = limiter.createStrategy(options);
+                const http = context.switchToHttp();
+                const request = http.getRequest();
+                const response = http.getResponse();
+                const keyExtractor = (options.key ?? DEFAULT_KEY);
+                const key = keyExtractor(request) ?? "unknown";
+                const sendHeaders = options.headers !== false;
+                const failOpen = options.failOpen ?? true;
+                const outcome = await (0, metrics_1.consumeRateLimit)({
+                    strategy,
+                    key,
+                    options,
+                    failOpen,
+                    storeType: limiter.getStoreType(),
+                    context: context,
+                });
+                if (outcome.status === "error") {
+                    if (failOpen) {
+                        return true;
+                    }
+                    throw new common_1.ServiceUnavailableException({
+                        error: "Service Unavailable",
+                    });
+                }
+                const result = outcome.result;
+                if (sendHeaders) {
+                    (0, headers_1.setHeaders)(response, (0, headers_1.buildRateLimitHeaders)(result));
+                }
+                if (result.allowed) {
+                    return true;
+                }
+                if (options.onLimitReached) {
+                    await options.onLimitReached(request, response);
+                    return false;
+                }
+                throw new common_1.HttpException({ error: "Too Many Requests" }, common_1.HttpStatus.TOO_MANY_REQUESTS);
+            }
+        };
+        NestGuard = __decorate([
+            (0, common_1.Injectable)(),
+            __metadata("design:paramtypes", [core_1.Reflector])
+        ], NestGuard);
+        return NestGuard;
+    };
+}
+let LimitlyModule = class LimitlyModule {
+};
+exports.LimitlyModule = LimitlyModule;
+exports.LimitlyModule = LimitlyModule = __decorate([
+    (0, common_1.Module)({})
+], LimitlyModule);
+function limitlyNestModule(options) {
+    const { limiter, global, ...middlewareOptions } = options;
+    const Guard = createNestGuard(limiter)(middlewareOptions);
+    return {
+        module: LimitlyModule,
+        providers: [Guard],
+        exports: [Guard],
+        global: global ?? false,
+    };
+}
+//# sourceMappingURL=nest.js.map

package/dist/middleware/nest.js.map

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

package/dist/stores/factory.d.ts

@@ -0,0 +1,5 @@
+import type { RedisLimitOptions } from "../types";
+import type { RateLimitStore, StoreType } from "./types";
+export declare function resolveStoreType(options: RedisLimitOptions): StoreType;
+export declare function createStore(options: RedisLimitOptions): RateLimitStore;
+//# sourceMappingURL=factory.d.ts.map

package/dist/stores/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/stores/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAKlD,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAIzD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,SAAS,CAQtE;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,iBAAiB,GAAG,cAAc,CA2BtE"}

package/dist/stores/factory.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveStoreType = resolveStoreType;
+exports.createStore = createStore;
+const memcached_1 = require("../utils/memcached");
+const redis_1 = require("../utils/redis");
+const memcached_store_1 = require("./memcached-store");
+const redis_store_1 = require("./redis-store");
+const REDIS_COMPATIBLE_STORES = ["redis", "valkey", "dragonfly"];
+function resolveStoreType(options) {
+    if (options.store) {
+        return options.store;
+    }
+    if (options.memcached) {
+        return "memcached";
+    }
+    return "redis";
+}
+function createStore(options) {
+    const storeType = resolveStoreType(options);
+    const keyPrefix = options.keyPrefix ?? redis_1.DEFAULT_KEY_PREFIX;
+    if (storeType === "memcached") {
+        if (!options.memcached) {
+            throw new Error('Memcached configuration is required when store is "memcached"');
+        }
+        return new memcached_store_1.MemcachedStore((0, memcached_1.createMemcachedClient)(options.memcached), keyPrefix);
+    }
+    if (!options.redis) {
+        throw new Error(`Redis configuration is required when store is "${storeType}"`);
+    }
+    if (!REDIS_COMPATIBLE_STORES.includes(storeType)) {
+        throw new Error(`Unsupported store type: ${storeType}`);
+    }
+    return new redis_store_1.RedisStore((0, redis_1.createRedisClient)(options.redis), keyPrefix, storeType);
+}
+//# sourceMappingURL=factory.js.map

package/dist/stores/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../src/stores/factory.ts"],"names":[],"mappings":";;AASA,4CAQC;AAED,kCA2BC;AA7CD,kDAA2D;AAC3D,0CAAuE;AACvE,uDAAmD;AACnD,+CAA2C;AAG3C,MAAM,uBAAuB,GAAgB,CAAC,OAAO,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;AAE9E,SAAgB,gBAAgB,CAAC,OAA0B;IACzD,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,OAAO,OAAO,CAAC,KAAK,CAAC;IACvB,CAAC;IACD,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACtB,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAgB,WAAW,CAAC,OAA0B;IACpD,MAAM,SAAS,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAC5C,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,0BAAkB,CAAC;IAE1D,IAAI,SAAS,KAAK,WAAW,EAAE,CAAC;QAC9B,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CACb,+DAA+D,CAChE,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,gCAAc,CACvB,IAAA,iCAAqB,EAAC,OAAO,CAAC,SAAS,CAAC,EACxC,SAAS,CACV,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CACb,kDAAkD,SAAS,GAAG,CAC/D,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,uBAAuB,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,KAAK,CAAC,2BAA2B,SAAS,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,OAAO,IAAI,wBAAU,CAAC,IAAA,yBAAiB,EAAC,OAAO,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;AAChF,CAAC"}

package/dist/stores/memcached-store.d.ts

@@ -0,0 +1,13 @@
+import type { RateLimitResult } from "../types";
+import type { MemcachedClient } from "../types";
+import type { RateLimitStore } from "./types";
+export declare class MemcachedStore implements RateLimitStore {
+    readonly type: "memcached";
+    private readonly client;
+    private readonly keyPrefix;
+    constructor(client: MemcachedClient, keyPrefix: string);
+    getClient(): MemcachedClient;
+    slidingWindow(key: string, limit: number, window: number): Promise<RateLimitResult>;
+    tokenBucket(key: string, capacity: number, refillRate: number): Promise<RateLimitResult>;
+}
+//# sourceMappingURL=memcached-store.d.ts.map

package/dist/stores/memcached-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memcached-store.d.ts","sourceRoot":"","sources":["../../src/stores/memcached-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAShD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAI9C,qBAAa,cAAe,YAAW,cAAc;IACnD,QAAQ,CAAC,IAAI,EAAG,WAAW,CAAU;IACrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,MAAM,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM;IAKtD,SAAS,IAAI,eAAe;IAItB,aAAa,CACjB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,eAAe,CAAC;IA4CrB,WAAW,CACf,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,eAAe,CAAC;CAkG5B"}

package/dist/stores/memcached-store.js

@@ -0,0 +1,117 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemcachedStore = void 0;
+const redis_1 = require("../utils/redis");
+const memcached_1 = require("../utils/memcached");
+const CAS_RETRIES = 5;
+class MemcachedStore {
+    constructor(client, keyPrefix) {
+        this.type = "memcached";
+        this.client = client;
+        this.keyPrefix = keyPrefix;
+    }
+    getClient() {
+        return this.client;
+    }
+    async slidingWindow(key, limit, window) {
+        const baseKey = (0, redis_1.buildKey)(this.keyPrefix, `sw:${key}`);
+        const now = Date.now();
+        const windowMs = window * 1000;
+        const currentWindow = Math.floor(now / windowMs);
+        const previousWindow = currentWindow - 1;
+        const elapsedRatio = (now % windowMs) / windowMs;
+        const currentKey = `${baseKey}:${currentWindow}`;
+        const previousKey = `${baseKey}:${previousWindow}`;
+        await (0, memcached_1.memcachedAdd)(this.client, currentKey, "0", window * 2);
+        const currentCount = await (0, memcached_1.memcachedIncr)(this.client, currentKey, 1);
+        const previousRaw = await (0, memcached_1.memcachedGet)(this.client, previousKey);
+        const previousCount = previousRaw ? Number(previousRaw) : 0;
+        const weightedCount = previousCount * (1 - elapsedRatio) + currentCount;
+        const reset = Math.ceil((now + windowMs) / 1000);
+        if (weightedCount <= limit) {
+            return {
+                allowed: true,
+                limit,
+                remaining: Math.max(0, Math.floor(limit - weightedCount)),
+                reset,
+            };
+        }
+        const retryAfter = Math.max(1, Math.ceil((1 - elapsedRatio) * window));
+        return {
+            allowed: false,
+            limit,
+            remaining: 0,
+            reset,
+            retryAfter,
+        };
+    }
+    async tokenBucket(key, capacity, refillRate) {
+        const cacheKey = (0, redis_1.buildKey)(this.keyPrefix, `tb:${key}`);
+        const now = Date.now();
+        const ttl = Math.ceil(capacity / refillRate) + 1;
+        for (let attempt = 0; attempt < CAS_RETRIES; attempt++) {
+            const existing = await (0, memcached_1.memcachedGets)(this.client, cacheKey);
+            let tokens;
+            let lastRefill;
+            if (!existing) {
+                tokens = capacity;
+                lastRefill = now;
+            }
+            else {
+                const parsed = JSON.parse(existing.value);
+                tokens = parsed.tokens;
+                lastRefill = parsed.lastRefill;
+            }
+            const elapsed = (now - lastRefill) / 1000;
+            tokens = Math.min(capacity, tokens + elapsed * refillRate);
+            lastRefill = now;
+            if (tokens < 1) {
+                const retryAfter = Math.max(1, Math.ceil((1 - tokens) / refillRate));
+                const reset = Math.ceil(now / 1000) + retryAfter;
+                if (!existing) {
+                    await (0, memcached_1.memcachedAdd)(this.client, cacheKey, JSON.stringify({ tokens, lastRefill }), ttl);
+                }
+                else {
+                    await (0, memcached_1.memcachedCas)(this.client, cacheKey, JSON.stringify({ tokens, lastRefill }), existing.cas, ttl);
+                }
+                return {
+                    allowed: false,
+                    limit: capacity,
+                    remaining: 0,
+                    reset,
+                    retryAfter,
+                };
+            }
+            tokens -= 1;
+            const payload = JSON.stringify({ tokens, lastRefill });
+            if (!existing) {
+                try {
+                    await (0, memcached_1.memcachedAdd)(this.client, cacheKey, payload, ttl);
+                    return {
+                        allowed: true,
+                        limit: capacity,
+                        remaining: Math.floor(tokens),
+                        reset: Math.ceil(now / 1000) +
+                            Math.ceil((capacity - tokens) / refillRate),
+                    };
+                }
+                catch {
+                    continue;
+                }
+            }
+            const updated = await (0, memcached_1.memcachedCas)(this.client, cacheKey, payload, existing.cas, ttl);
+            if (updated) {
+                return {
+                    allowed: true,
+                    limit: capacity,
+                    remaining: Math.floor(tokens),
+                    reset: Math.ceil(now / 1000) +
+                        Math.ceil((capacity - tokens) / refillRate),
+                };
+            }
+        }
+        throw new Error("Token bucket CAS retries exhausted");
+    }
+}
+exports.MemcachedStore = MemcachedStore;
+//# sourceMappingURL=memcached-store.js.map

package/dist/stores/memcached-store.js.map

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

package/dist/stores/redis-store.d.ts

@@ -0,0 +1,12 @@
+import type { RedisClient } from "../types";
+import type { RateLimitStore, StoreType } from "./types";
+export declare class RedisStore implements RateLimitStore {
+    readonly type: StoreType;
+    private readonly client;
+    private readonly keyPrefix;
+    constructor(client: RedisClient, keyPrefix: string, type?: StoreType);
+    getClient(): RedisClient;
+    slidingWindow(key: string, limit: number, window: number): Promise<import("../types").RateLimitResult>;
+    tokenBucket(key: string, capacity: number, refillRate: number): Promise<import("../types").RateLimitResult>;
+}
+//# sourceMappingURL=redis-store.d.ts.map

package/dist/stores/redis-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-store.d.ts","sourceRoot":"","sources":["../../src/stores/redis-store.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAG5C,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzD,qBAAa,UAAW,YAAW,cAAc;IAC/C,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAGjC,MAAM,EAAE,WAAW,EACnB,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE,SAAmB;IAO3B,SAAS,IAAI,WAAW;IAIlB,aAAa,CACjB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,OAAO,UAAU,EAAE,eAAe,CAAC;IAuBxC,WAAW,CACf,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,OAAO,UAAU,EAAE,eAAe,CAAC;CAoB/C"}

package/dist/stores/redis-store.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RedisStore = void 0;
+const crypto_1 = require("crypto");
+const redis_1 = require("../utils/redis");
+const scripts_1 = require("../utils/scripts");
+class RedisStore {
+    constructor(client, keyPrefix, type = "redis") {
+        this.client = client;
+        this.keyPrefix = keyPrefix;
+        this.type = type;
+    }
+    getClient() {
+        return this.client;
+    }
+    async slidingWindow(key, limit, window) {
+        const redisKey = (0, redis_1.buildKey)(this.keyPrefix, `sw:${key}`);
+        const now = Date.now();
+        const requestId = (0, crypto_1.randomUUID)();
+        const result = await (0, scripts_1.evalScript)(this.client, "sliding", [redisKey], [
+            limit,
+            window,
+            now,
+            requestId,
+        ]);
+        const parsed = (0, scripts_1.parseScriptResult)(result);
+        return {
+            allowed: parsed.allowed,
+            limit: parsed.limit,
+            remaining: parsed.remaining,
+            reset: parsed.reset,
+            retryAfter: parsed.retryAfter || undefined,
+        };
+    }
+    async tokenBucket(key, capacity, refillRate) {
+        const redisKey = (0, redis_1.buildKey)(this.keyPrefix, `tb:${key}`);
+        const now = Date.now();
+        const result = await (0, scripts_1.evalScript)(this.client, "token", [redisKey], [
+            capacity,
+            refillRate,
+            now,
+        ]);
+        const parsed = (0, scripts_1.parseScriptResult)(result);
+        return {
+            allowed: parsed.allowed,
+            limit: parsed.limit,
+            remaining: parsed.remaining,
+            reset: parsed.reset,
+            retryAfter: parsed.retryAfter || undefined,
+        };
+    }
+}
+exports.RedisStore = RedisStore;
+//# sourceMappingURL=redis-store.js.map

package/dist/stores/redis-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-store.js","sourceRoot":"","sources":["../../src/stores/redis-store.ts"],"names":[],"mappings":";;;AAAA,mCAAoC;AAEpC,0CAA0C;AAC1C,8CAAiE;AAGjE,MAAa,UAAU;IAKrB,YACE,MAAmB,EACnB,SAAiB,EACjB,OAAkB,OAAO;QAEzB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,aAAa,CACjB,GAAW,EACX,KAAa,EACb,MAAc;QAEd,MAAM,QAAQ,GAAG,IAAA,gBAAQ,EAAC,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,EAAE,CAAC,CAAC;QACvD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,SAAS,GAAG,IAAA,mBAAU,GAAE,CAAC;QAE/B,MAAM,MAAM,GAAG,MAAM,IAAA,oBAAU,EAAC,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,QAAQ,CAAC,EAAE;YAClE,KAAK;YACL,MAAM;YACN,GAAG;YACH,SAAS;SACV,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,IAAA,2BAAiB,EAAC,MAAM,CAAC,CAAC;QAEzC,OAAO;YACL,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,SAAS;SAC3C,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,WAAW,CACf,GAAW,EACX,QAAgB,EAChB,UAAkB;QAElB,MAAM,QAAQ,GAAG,IAAA,gBAAQ,EAAC,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,EAAE,CAAC,CAAC;QACvD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAEvB,MAAM,MAAM,GAAG,MAAM,IAAA,oBAAU,EAAC,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,QAAQ,CAAC,EAAE;YAChE,QAAQ;YACR,UAAU;YACV,GAAG;SACJ,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,IAAA,2BAAiB,EAAC,MAAM,CAAC,CAAC;QAEzC,OAAO;YACL,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,SAAS;SAC3C,CAAC;IACJ,CAAC;CACF;AAtED,gCAsEC"}

package/dist/stores/types.d.ts

@@ -0,0 +1,8 @@
+import type { RateLimitResult } from "../types";
+export type StoreType = "redis" | "valkey" | "dragonfly" | "memcached";
+export interface RateLimitStore {
+    readonly type: StoreType;
+    slidingWindow(key: string, limit: number, window: number): Promise<RateLimitResult>;
+    tokenBucket(key: string, capacity: number, refillRate: number): Promise<RateLimitResult>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/stores/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/stores/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEhD,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,WAAW,GAAG,WAAW,CAAC;AAEvE,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,aAAa,CACX,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,eAAe,CAAC,CAAC;IAC5B,WAAW,CACT,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,eAAe,CAAC,CAAC;CAC7B"}

package/dist/stores/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/stores/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/stores/types.ts"],"names":[],"mappings":""}

package/dist/types/index.d.ts

@@ -1,4 +1,7 @@
 import type { Cluster, Redis, RedisOptions } from "ioredis";
+import type Memcached from "memcached";
+import type { StoreType } from "../stores/types";
+export type { StoreType };
 export type RedisClient = Redis | Cluster;
 export type RedisConfig = RedisClient | string | RedisOptions | {
     nodes: {
@@ -7,10 +10,26 @@ export type RedisConfig = RedisClient | string | RedisOptions | {
     }[];
     options?: RedisOptions;
 };
+export type MemcachedClient = Memcached;
+export type MemcachedOptions = Memcached.options;
+export type MemcachedConfig = MemcachedClient | string | string[] | {
+    servers: string | string[];
+    options?: MemcachedOptions;
+};
 export interface RedisLimitOptions {
-    redis: RedisConfig;
+    /** Storage backend. Defaults to "redis", or "memcached" when memcached config is provided. */
+    store?: StoreType;
+    /** Redis-compatible connection (Redis, Valkey, DragonflyDB) */
+    redis?: RedisConfig;
+    /** Memcached server(s) */
+    memcached?: MemcachedConfig;
     failOpen?: boolean;
+    /** Storage key prefix. Defaults to "limitly". Keys are stored as `{prefix}:sw:{id}` or `{prefix}:tb:{id}`. */
     keyPrefix?: string;
+    /** Default rate limit config applied when middleware options omit algorithm settings. */
+    default?: MiddlewareOptionsInput;
+    /** Global metrics hook applied to all rate limit checks. */
+    onMetrics?: RateLimitMetricsHook | RateLimitMetricsHook[];
 }
 export interface RateLimitResult {
     allowed: boolean;
@@ -33,13 +52,55 @@ export interface TokenBucketConfig {
     refillRate: number;
 }
 export type AlgorithmConfig = SlidingWindowConfig | TokenBucketConfig;
+export type RateLimitMetricsEvent = {
+    type: "allowed";
+    key: string;
+    algorithm: AlgorithmConfig["algorithm"];
+    result: RateLimitResult;
+    durationMs: number;
+    store?: StoreType;
+    context?: unknown;
+} | {
+    type: "blocked";
+    key: string;
+    algorithm: AlgorithmConfig["algorithm"];
+    result: RateLimitResult;
+    durationMs: number;
+    store?: StoreType;
+    context?: unknown;
+} | {
+    type: "error";
+    key: string;
+    algorithm: AlgorithmConfig["algorithm"];
+    error: unknown;
+    durationMs: number;
+    failOpen: boolean;
+    store?: StoreType;
+    context?: unknown;
+} | {
+    type: "fail_open";
+    key: string;
+    algorithm: AlgorithmConfig["algorithm"];
+    durationMs: number;
+    store?: StoreType;
+    context?: unknown;
+};
+export type RateLimitMetricsHook = (event: RateLimitMetricsEvent) => void | Promise<void>;
 export interface BaseMiddlewareOptions {
     key?: (req: unknown) => string | undefined;
     headers?: boolean;
     onLimitReached?: (req: unknown, res: unknown) => void | Promise<void>;
+    onMetrics?: RateLimitMetricsHook | RateLimitMetricsHook[];
     failOpen?: boolean;
 }
 export type MiddlewareOptions = BaseMiddlewareOptions & AlgorithmConfig;
+export type MiddlewareOptionsInput = BaseMiddlewareOptions & {
+    algorithm?: "sliding-window" | "token-bucket";
+    limit?: number;
+    window?: number;
+    capacity?: number;
+    refillRate?: number;
+};
 export interface RateLimitHeaders {
     "X-RateLimit-Limit": string;
     "X-RateLimit-Remaining": string;

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5D,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,OAAO,CAAC;AAE1C,MAAM,MAAM,WAAW,GACnB,WAAW,GACX,MAAM,GACN,YAAY,GACZ;IAAE,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAAC,OAAO,CAAC,EAAE,YAAY,CAAA;CAAE,CAAC;AAExE,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CAChD;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,gBAAgB,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,cAAc,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,eAAe,GAAG,mBAAmB,GAAG,iBAAiB,CAAC;AAEtE,MAAM,WAAW,qBAAqB;IACpC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,MAAM,GAAG,SAAS,CAAC;IAC3C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,cAAc,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,MAAM,iBAAiB,GAAG,qBAAqB,GAAG,eAAe,CAAC;AAExE,MAAM,WAAW,gBAAgB;IAC/B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,uBAAuB,EAAE,MAAM,CAAC;IAChC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"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"}

package/dist/utils/defaults.d.ts

@@ -0,0 +1,6 @@
+import type { AlgorithmConfig, MiddlewareOptions, MiddlewareOptionsInput, SlidingWindowConfig, TokenBucketConfig } from "../types";
+export declare const DEFAULT_SLIDING_WINDOW: SlidingWindowConfig;
+export declare const DEFAULT_TOKEN_BUCKET: TokenBucketConfig;
+export declare function resolveMiddlewareOptions(options?: MiddlewareOptionsInput, defaults?: MiddlewareOptionsInput): MiddlewareOptions;
+export declare function resolveAlgorithmConfig(options?: MiddlewareOptionsInput, defaults?: MiddlewareOptionsInput): AlgorithmConfig;
+//# sourceMappingURL=defaults.d.ts.map

package/dist/utils/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/utils/defaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EAEf,iBAAiB,EACjB,sBAAsB,EACtB,mBAAmB,EACnB,iBAAiB,EAClB,MAAM,UAAU,CAAC;AAElB,eAAO,MAAM,sBAAsB,EAAE,mBAIpC,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,iBAIlC,CAAC;AAcF,wBAAgB,wBAAwB,CACtC,OAAO,GAAE,sBAA2B,EACpC,QAAQ,GAAE,sBAA2B,GACpC,iBAAiB,CAoBnB;AAED,wBAAgB,sBAAsB,CACpC,OAAO,GAAE,sBAA2B,EACpC,QAAQ,GAAE,sBAA2B,GACpC,eAAe,CAejB"}

package/dist/utils/defaults.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_TOKEN_BUCKET = exports.DEFAULT_SLIDING_WINDOW = void 0;
+exports.resolveMiddlewareOptions = resolveMiddlewareOptions;
+exports.resolveAlgorithmConfig = resolveAlgorithmConfig;
+exports.DEFAULT_SLIDING_WINDOW = {
+    algorithm: "sliding-window",
+    limit: 100,
+    window: 60,
+};
+exports.DEFAULT_TOKEN_BUCKET = {
+    algorithm: "token-bucket",
+    capacity: 100,
+    refillRate: 10,
+};
+function pickBaseOptions(options) {
+    return {
+        key: options.key,
+        headers: options.headers,
+        onLimitReached: options.onLimitReached,
+        onMetrics: options.onMetrics,
+        failOpen: options.failOpen,
+    };
+}
+function resolveMiddlewareOptions(options = {}, defaults = {}) {
+    const merged = { ...defaults, ...options };
+    const base = pickBaseOptions(merged);
+    const algorithm = merged.algorithm ?? exports.DEFAULT_SLIDING_WINDOW.algorithm;
+    if (algorithm === "token-bucket") {
+        return {
+            ...base,
+            algorithm: "token-bucket",
+            capacity: merged.capacity ?? exports.DEFAULT_TOKEN_BUCKET.capacity,
+            refillRate: merged.refillRate ?? exports.DEFAULT_TOKEN_BUCKET.refillRate,
+        };
+    }
+    return {
+        ...base,
+        algorithm: "sliding-window",
+        limit: merged.limit ?? exports.DEFAULT_SLIDING_WINDOW.limit,
+        window: merged.window ?? exports.DEFAULT_SLIDING_WINDOW.window,
+    };
+}
+function resolveAlgorithmConfig(options = {}, defaults = {}) {
+    const resolved = resolveMiddlewareOptions(options, defaults);
+    if (resolved.algorithm === "token-bucket") {
+        return {
+            algorithm: "token-bucket",
+            capacity: resolved.capacity,
+            refillRate: resolved.refillRate,
+        };
+    }
+    return {
+        algorithm: "sliding-window",
+        limit: resolved.limit,
+        window: resolved.window,
+    };
+}
+//# sourceMappingURL=defaults.js.map

package/dist/utils/defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../src/utils/defaults.ts"],"names":[],"mappings":";;;AAiCA,4DAuBC;AAED,wDAkBC;AAnEY,QAAA,sBAAsB,GAAwB;IACzD,SAAS,EAAE,gBAAgB;IAC3B,KAAK,EAAE,GAAG;IACV,MAAM,EAAE,EAAE;CACX,CAAC;AAEW,QAAA,oBAAoB,GAAsB;IACrD,SAAS,EAAE,cAAc;IACzB,QAAQ,EAAE,GAAG;IACb,UAAU,EAAE,EAAE;CACf,CAAC;AAEF,SAAS,eAAe,CACtB,OAA+B;IAE/B,OAAO;QACL,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,cAAc,EAAE,OAAO,CAAC,cAAc;QACtC,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,QAAQ,EAAE,OAAO,CAAC,QAAQ;KAC3B,CAAC;AACJ,CAAC;AAED,SAAgB,wBAAwB,CACtC,UAAkC,EAAE,EACpC,WAAmC,EAAE;IAErC,MAAM,MAAM,GAA2B,EAAE,GAAG,QAAQ,EAAE,GAAG,OAAO,EAAE,CAAC;IACnE,MAAM,IAAI,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IACrC,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,8BAAsB,CAAC,SAAS,CAAC;IAEvE,IAAI,SAAS,KAAK,cAAc,EAAE,CAAC;QACjC,OAAO;YACL,GAAG,IAAI;YACP,SAAS,EAAE,cAAc;YACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,4BAAoB,CAAC,QAAQ;YAC1D,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,4BAAoB,CAAC,UAAU;SACjE,CAAC;IACJ,CAAC;IAED,OAAO;QACL,GAAG,IAAI;QACP,SAAS,EAAE,gBAAgB;QAC3B,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,8BAAsB,CAAC,KAAK;QACnD,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,8BAAsB,CAAC,MAAM;KACvD,CAAC;AACJ,CAAC;AAED,SAAgB,sBAAsB,CACpC,UAAkC,EAAE,EACpC,WAAmC,EAAE;IAErC,MAAM,QAAQ,GAAG,wBAAwB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC7D,IAAI,QAAQ,CAAC,SAAS,KAAK,cAAc,EAAE,CAAC;QAC1C,OAAO;YACL,SAAS,EAAE,cAAc;YACzB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,UAAU,EAAE,QAAQ,CAAC,UAAU;SAChC,CAAC;IACJ,CAAC;IAED,OAAO;QACL,SAAS,EAAE,gBAAgB;QAC3B,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,MAAM,EAAE,QAAQ,CAAC,MAAM;KACxB,CAAC;AACJ,CAAC"}

package/dist/utils/memcached.d.ts

@@ -0,0 +1,11 @@
+import type { MemcachedConfig, MemcachedClient } from "../types";
+export declare function createMemcachedClient(config: MemcachedConfig): MemcachedClient;
+export declare function memcachedGet(client: MemcachedClient, key: string): Promise<string | undefined>;
+export declare function memcachedGets(client: MemcachedClient, key: string): Promise<{
+    value: string;
+    cas: string;
+} | undefined>;
+export declare function memcachedIncr(client: MemcachedClient, key: string, amount?: number): Promise<number>;
+export declare function memcachedAdd(client: MemcachedClient, key: string, value: string, ttl: number): Promise<void>;
+export declare function memcachedCas(client: MemcachedClient, key: string, value: string, cas: string, ttl: number): Promise<boolean>;
+//# sourceMappingURL=memcached.d.ts.map

package/dist/utils/memcached.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memcached.d.ts","sourceRoot":"","sources":["../../src/utils/memcached.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEjE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,eAAe,GAAG,eAAe,CAU9E;AAWD,wBAAgB,YAAY,CAC1B,MAAM,EAAE,eAAe,EACvB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAU7B;AAED,wBAAgB,aAAa,CAC3B,MAAM,EAAE,eAAe,EACvB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAAC,CAcrD;AAED,wBAAgB,aAAa,CAC3B,MAAM,EAAE,eAAe,EACvB,GAAG,EAAE,MAAM,EACX,MAAM,SAAI,GACT,OAAO,CAAC,MAAM,CAAC,CAUjB;AAED,wBAAgB,YAAY,CAC1B,MAAM,EAAE,eAAe,EACvB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,IAAI,CAAC,CAUf;AAED,wBAAgB,YAAY,CAC1B,MAAM,EAAE,eAAe,EACvB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,OAAO,CAAC,CAclB"}