ratelimit-flex 1.0.0

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

@@ -0,0 +1,452 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RedisStore = void 0;
+exports.adaptIoRedisClient = adaptIoRedisClient;
+exports.adaptNodeRedisClient = adaptNodeRedisClient;
+const index_js_1 = require("../types/index.js");
+const DEFAULT_PREFIX = 'rlf:';
+/** Sliding window: ZSET prune + ZADD + ZCARD. KEYS[1]=zset, ARGV: now, windowMs, maxRequests, member */
+const LUA_SLIDING_INCR = `
+local zkey = KEYS[1]
+local now = tonumber(ARGV[1])
+local window_ms = tonumber(ARGV[2])
+local max_requests = tonumber(ARGV[3])
+local member = ARGV[4]
+
+redis.call('ZREMRANGEBYSCORE', zkey, '-inf', now - window_ms)
+redis.call('ZADD', zkey, now, member)
+local count = tonumber(redis.call('ZCARD', zkey))
+redis.call('PEXPIRE', zkey, window_ms)
+
+local blocked = 0
+if count > max_requests then blocked = 1 end
+
+local oldest_score = now
+if count > 0 then
+  local r = redis.call('ZRANGE', zkey, 0, 0, 'WITHSCORES')
+  if r[2] ~= nil then
+    oldest_score = tonumber(r[2])
+  end
+end
+local reset_at = oldest_score + window_ms
+
+return { count, blocked, reset_at }
+`;
+const LUA_SLIDING_DECR = `
+redis.call('ZPOPMAX', KEYS[1])
+return 1
+`;
+/** Fixed window: atomic INCR + PEXPIRE on first hit. KEYS[1]=counter, ARGV: windowMs, maxRequests, now */
+const LUA_FIXED_INCR = `
+local k = KEYS[1]
+local window_ms = tonumber(ARGV[1])
+local max_requests = tonumber(ARGV[2])
+local now = tonumber(ARGV[3])
+
+local current = tonumber(redis.call('INCR', k))
+if current == 1 then
+  redis.call('PEXPIRE', k, window_ms)
+end
+
+local pttl = tonumber(redis.call('PTTL', k))
+if pttl < 0 then pttl = window_ms end
+local reset_at = now + pttl
+
+local blocked = 0
+if current > max_requests then blocked = 1 end
+
+return { current, blocked, reset_at }
+`;
+const LUA_FIXED_DECR = `
+local k = KEYS[1]
+local v = tonumber(redis.call('GET', k) or '0')
+if v > 0 then
+  redis.call('DECR', k)
+end
+return v
+`;
+/** Token bucket: HSET tokens + last_refill. KEYS[1]=hash, ARGV: now, tpi, interval_ms, bucket_size */
+const LUA_BUCKET_INCR = `
+local key = KEYS[1]
+local now = tonumber(ARGV[1])
+local tokens_per_interval = tonumber(ARGV[2])
+local interval_ms = tonumber(ARGV[3])
+local bucket_size = tonumber(ARGV[4])
+
+local tokens_s = redis.call('HGET', key, 'tokens')
+local last_s = redis.call('HGET', key, 'last_refill')
+
+local tokens
+local last_refill
+
+if tokens_s == false then
+  tokens = bucket_size
+  last_refill = now
+else
+  tokens = tonumber(tokens_s)
+  last_refill = tonumber(last_s)
+end
+
+local elapsed = now - last_refill
+local intervals = math.floor(elapsed / interval_ms)
+if intervals > 0 then
+  tokens = math.min(bucket_size, tokens + intervals * tokens_per_interval)
+  last_refill = last_refill + intervals * interval_ms
+end
+
+if tokens >= 1 then
+  tokens = tokens - 1
+  redis.call('HSET', key, 'tokens', tostring(tokens), 'last_refill', tostring(last_refill))
+  redis.call('PEXPIRE', key, interval_ms * 10)
+  local remaining = tokens
+  local total_hits = bucket_size - remaining
+  local next_tick = last_refill + interval_ms
+  return { 1, remaining, total_hits, 0, next_tick }
+end
+
+redis.call('HSET', key, 'tokens', tostring(tokens), 'last_refill', tostring(last_refill))
+redis.call('PEXPIRE', key, interval_ms * 10)
+local next_refill = last_refill + interval_ms
+return { 0, tokens, bucket_size, 1, next_refill }
+`;
+const LUA_BUCKET_DECR = `
+local key = KEYS[1]
+local bucket_size = tonumber(ARGV[1])
+local tokens_s = redis.call('HGET', key, 'tokens')
+local tokens
+if tokens_s == false then
+  return 0
+end
+tokens = tonumber(tokens_s)
+tokens = math.min(bucket_size, tokens + 1)
+redis.call('HSET', key, 'tokens', tostring(tokens))
+return 1
+`;
+const LUA_DEL = `
+return redis.call('DEL', unpack(KEYS))
+`;
+/**
+ * Wrap an **ioredis** client instance to satisfy {@link RedisLikeClient} without adding a compile-time dependency.
+ */
+function adaptIoRedisClient(client) {
+    return {
+        get: (k) => client.get(k),
+        set: (k, v, ...rest) => client.set(k, v, ...rest),
+        eval: (script, numKeys, ...rest) => client.eval(script, numKeys, ...rest.map((a) => String(a))),
+        del: client.del?.bind(client),
+        quit: client.quit?.bind(client),
+        disconnect: client.disconnect ? async () => await client.disconnect() : undefined,
+    };
+}
+/**
+ * Wrap **node-redis** v4+ clients (`eval(script, { keys, arguments })`).
+ * Does not add a `redis` package dependency — pass your connected client instance.
+ */
+function adaptNodeRedisClient(client) {
+    return {
+        get: async (k) => (await client.get(k)) ?? null,
+        set: (k, v, ...rest) => client.set(k, v, ...rest),
+        eval: (script, numKeys, ...rest) => {
+            const keys = rest.slice(0, numKeys);
+            const args = rest.slice(numKeys);
+            return client.eval(script, { keys, arguments: args });
+        },
+        del: client.del?.bind(client),
+        quit: client.quit?.bind(client),
+        disconnect: client.disconnect ? async () => await client.disconnect() : undefined,
+    };
+}
+/**
+ * Redis-backed {@link RateLimitStore} using Lua for atomicity.
+ *
+ * Pass either `client` (recommended) or `url` (loads optional peer `ioredis` at runtime).
+ */
+class RedisStore {
+    constructor(options) {
+        this.client = null;
+        /** Connection created from `url` — closed on {@link RedisStore.shutdown}. */
+        this.ownedRedis = null;
+        if (options.url && options.client) {
+            throw new Error('RedisStore: pass either "url" or "client", not both');
+        }
+        if (!options.url && !options.client) {
+            throw new Error('RedisStore: pass "url" or "client"');
+        }
+        this.strategy = options.strategy;
+        this.keyPrefix = options.keyPrefix ?? DEFAULT_PREFIX;
+        this.onWarn =
+            options.onWarn ?? ((msg, err) => console.warn(`[ratelimit-flex] ${msg}`, err ?? ''));
+        if (options.strategy === index_js_1.RateLimitStrategy.TOKEN_BUCKET) {
+            this.windowMs = 0;
+            this.maxRequests = 0;
+            this.tokensPerInterval = options.tokensPerInterval;
+            this.refillIntervalMs = options.interval;
+            this.bucketSize = options.bucketSize;
+        }
+        else {
+            this.windowMs = options.windowMs;
+            this.maxRequests = options.maxRequests;
+            this.tokensPerInterval = 0;
+            this.refillIntervalMs = 0;
+            this.bucketSize = 0;
+        }
+        if (options.client) {
+            this.clientPromise = Promise.resolve(options.client);
+        }
+        else {
+            this.clientPromise = this.connectFromUrl(options.url);
+        }
+    }
+    async connectFromUrl(url) {
+        try {
+            // @ts-expect-error - ioredis is an optional peer dependency
+            const mod = (await Promise.resolve().then(() => __importStar(require('ioredis'))));
+            const Redis = mod.default;
+            const raw = new Redis(url);
+            this.ownedRedis = raw;
+            return adaptIoRedisClient(raw);
+        }
+        catch (err) {
+            this.onWarn('Failed to load optional peer "ioredis". Install it or pass a pre-configured "client".', err);
+            throw err;
+        }
+    }
+    warn(message, error) {
+        this.onWarn(message, error);
+    }
+    async getClient() {
+        if (this.client) {
+            return this.client;
+        }
+        const c = await this.clientPromise;
+        this.client = c;
+        return c;
+    }
+    redisKey(kind, key) {
+        return `${this.keyPrefix}${kind}:${key}`;
+    }
+    async evalScript(script, keys, args) {
+        try {
+            const r = await this.getClient();
+            const flat = [...keys.map(String), ...args.map(String)];
+            return await r.eval(script, keys.length, ...flat);
+        }
+        catch (err) {
+            this.warn('Redis EVAL failed', err);
+            return null;
+        }
+    }
+    async delKeys(...keys) {
+        if (keys.length === 0) {
+            return;
+        }
+        try {
+            const r = await this.getClient();
+            if (r.del) {
+                await r.del(...keys);
+                return;
+            }
+            await r.eval(LUA_DEL, keys.length, ...keys.map(String));
+        }
+        catch (err) {
+            this.warn('Redis DEL failed', err);
+        }
+    }
+    failOpenResult() {
+        const now = Date.now();
+        if (this.strategy === index_js_1.RateLimitStrategy.TOKEN_BUCKET) {
+            return {
+                totalHits: 0,
+                remaining: this.bucketSize,
+                resetTime: new Date(now + this.refillIntervalMs),
+                isBlocked: false,
+            };
+        }
+        return {
+            totalHits: 0,
+            remaining: this.maxRequests,
+            resetTime: new Date(now + this.windowMs),
+            isBlocked: false,
+        };
+    }
+    /** @inheritdoc */
+    async increment(key) {
+        switch (this.strategy) {
+            case index_js_1.RateLimitStrategy.SLIDING_WINDOW:
+                return this.incrSliding(key);
+            case index_js_1.RateLimitStrategy.FIXED_WINDOW:
+                return this.incrFixed(key);
+            case index_js_1.RateLimitStrategy.TOKEN_BUCKET:
+                return this.incrBucket(key);
+            default: {
+                const _ = this.strategy;
+                return Promise.reject(new Error(`Unsupported strategy: ${String(_)}`));
+            }
+        }
+    }
+    async incrSliding(key) {
+        const now = Date.now();
+        const member = `${now}:${Math.random().toString(36).slice(2)}`;
+        const rk = this.redisKey('sw', key);
+        const raw = await this.evalScript(LUA_SLIDING_INCR, [rk], [now, this.windowMs, this.maxRequests, member]);
+        if (raw === null || !Array.isArray(raw) || raw.length < 3) {
+            return this.failOpenResult();
+        }
+        const count = Number(raw[0]);
+        const blocked = Number(raw[1]) === 1;
+        const resetMs = Number(raw[2]);
+        if (Number.isNaN(count) || Number.isNaN(resetMs)) {
+            return this.failOpenResult();
+        }
+        const remaining = blocked ? 0 : Math.max(0, this.maxRequests - count);
+        return {
+            totalHits: count,
+            remaining,
+            resetTime: new Date(resetMs),
+            isBlocked: blocked,
+        };
+    }
+    async incrFixed(key) {
+        const now = Date.now();
+        const rk = this.redisKey('fw', key);
+        const raw = await this.evalScript(LUA_FIXED_INCR, [rk], [this.windowMs, this.maxRequests, now]);
+        if (raw === null || !Array.isArray(raw) || raw.length < 3) {
+            return this.failOpenResult();
+        }
+        const current = Number(raw[0]);
+        const blocked = Number(raw[1]) === 1;
+        const resetMs = Number(raw[2]);
+        if (Number.isNaN(current) || Number.isNaN(resetMs)) {
+            return this.failOpenResult();
+        }
+        const remaining = blocked ? 0 : Math.max(0, this.maxRequests - current);
+        return {
+            totalHits: current,
+            remaining,
+            resetTime: new Date(resetMs),
+            isBlocked: blocked,
+        };
+    }
+    async incrBucket(key) {
+        const now = Date.now();
+        const rk = this.redisKey('tb', key);
+        const raw = await this.evalScript(LUA_BUCKET_INCR, [rk], [now, this.tokensPerInterval, this.refillIntervalMs, this.bucketSize]);
+        if (raw === null || !Array.isArray(raw) || raw.length < 5) {
+            return this.failOpenResult();
+        }
+        const remaining = Number(raw[1]);
+        const totalHits = Number(raw[2]);
+        const blocked = Number(raw[3]) === 1;
+        const nextMs = Number(raw[4]);
+        if (Number.isNaN(remaining) || Number.isNaN(totalHits) || Number.isNaN(nextMs)) {
+            return this.failOpenResult();
+        }
+        return {
+            totalHits,
+            remaining,
+            resetTime: new Date(nextMs),
+            isBlocked: blocked,
+        };
+    }
+    /** @inheritdoc */
+    async decrement(key) {
+        try {
+            switch (this.strategy) {
+                case index_js_1.RateLimitStrategy.SLIDING_WINDOW: {
+                    const rk = this.redisKey('sw', key);
+                    await this.evalScript(LUA_SLIDING_DECR, [rk], []);
+                    break;
+                }
+                case index_js_1.RateLimitStrategy.FIXED_WINDOW: {
+                    const rk = this.redisKey('fw', key);
+                    await this.evalScript(LUA_FIXED_DECR, [rk], []);
+                    break;
+                }
+                case index_js_1.RateLimitStrategy.TOKEN_BUCKET: {
+                    const rk = this.redisKey('tb', key);
+                    await this.evalScript(LUA_BUCKET_DECR, [rk], [this.bucketSize]);
+                    break;
+                }
+                default:
+                    break;
+            }
+        }
+        catch (err) {
+            this.warn('Redis decrement failed', err);
+        }
+    }
+    /** @inheritdoc */
+    async reset(key) {
+        const keys = [];
+        switch (this.strategy) {
+            case index_js_1.RateLimitStrategy.SLIDING_WINDOW:
+                keys.push(this.redisKey('sw', key));
+                break;
+            case index_js_1.RateLimitStrategy.FIXED_WINDOW:
+                keys.push(this.redisKey('fw', key));
+                break;
+            case index_js_1.RateLimitStrategy.TOKEN_BUCKET:
+                keys.push(this.redisKey('tb', key));
+                break;
+            default:
+                break;
+        }
+        await this.delKeys(...keys);
+    }
+    /** @inheritdoc */
+    async shutdown() {
+        this.client = null;
+        const owned = this.ownedRedis;
+        this.ownedRedis = null;
+        if (!owned) {
+            return Promise.resolve();
+        }
+        try {
+            if (typeof owned.quit === 'function') {
+                await owned.quit();
+            }
+            else if (typeof owned.disconnect === 'function') {
+                await owned.disconnect();
+            }
+        }
+        catch (err) {
+            this.warn('Redis shutdown (quit/disconnect) failed', err);
+        }
+        return Promise.resolve();
+    }
+}
+exports.RedisStore = RedisStore;
+//# sourceMappingURL=redis-store.js.map

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

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

package/dist/cjs/strategies/defaults.d.ts

@@ -0,0 +1,28 @@
+import { RateLimitStrategy } from '../types/index.js';
+/**
+ * Sensible defaults for sliding-window rate limiting (no {@link RateLimitOptionsBase.store} — pass a store or use {@link createRateLimiter}).
+ */
+export declare const slidingWindowDefaults: {
+    readonly strategy: RateLimitStrategy.SLIDING_WINDOW;
+    readonly windowMs: 60000;
+    readonly maxRequests: 100;
+};
+/**
+ * Sensible defaults for fixed-window rate limiting.
+ */
+export declare const fixedWindowDefaults: {
+    readonly strategy: RateLimitStrategy.FIXED_WINDOW;
+    readonly windowMs: 60000;
+    readonly maxRequests: 100;
+};
+/**
+ * Sensible defaults for token-bucket rate limiting.
+ * Use {@link TokenBucketRateLimitOptions.bucketSize} for burst capacity (not `maxRequests`).
+ */
+export declare const tokenBucketDefaults: {
+    readonly strategy: RateLimitStrategy.TOKEN_BUCKET;
+    readonly tokensPerInterval: 10;
+    readonly interval: 60000;
+    readonly bucketSize: 100;
+};
+//# sourceMappingURL=defaults.d.ts.map

package/dist/cjs/strategies/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../../src/strategies/defaults.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtD;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;CAIxB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;CAItB,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;;;CAKtB,CAAC"}

package/dist/cjs/strategies/defaults.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tokenBucketDefaults = exports.fixedWindowDefaults = exports.slidingWindowDefaults = void 0;
+const index_js_1 = require("../types/index.js");
+/**
+ * Sensible defaults for sliding-window rate limiting (no {@link RateLimitOptionsBase.store} — pass a store or use {@link createRateLimiter}).
+ */
+exports.slidingWindowDefaults = {
+    strategy: index_js_1.RateLimitStrategy.SLIDING_WINDOW,
+    windowMs: 60000,
+    maxRequests: 100,
+};
+/**
+ * Sensible defaults for fixed-window rate limiting.
+ */
+exports.fixedWindowDefaults = {
+    strategy: index_js_1.RateLimitStrategy.FIXED_WINDOW,
+    windowMs: 60000,
+    maxRequests: 100,
+};
+/**
+ * Sensible defaults for token-bucket rate limiting.
+ * Use {@link TokenBucketRateLimitOptions.bucketSize} for burst capacity (not `maxRequests`).
+ */
+exports.tokenBucketDefaults = {
+    strategy: index_js_1.RateLimitStrategy.TOKEN_BUCKET,
+    tokensPerInterval: 10,
+    interval: 60000,
+    bucketSize: 100,
+};
+//# sourceMappingURL=defaults.js.map

package/dist/cjs/strategies/defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../../src/strategies/defaults.ts"],"names":[],"mappings":";;;AAAA,gDAAsD;AAEtD;;GAEG;AACU,QAAA,qBAAqB,GAAG;IACnC,QAAQ,EAAE,4BAAiB,CAAC,cAAc;IAC1C,QAAQ,EAAE,KAAM;IAChB,WAAW,EAAE,GAAG;CACR,CAAC;AAEX;;GAEG;AACU,QAAA,mBAAmB,GAAG;IACjC,QAAQ,EAAE,4BAAiB,CAAC,YAAY;IACxC,QAAQ,EAAE,KAAM;IAChB,WAAW,EAAE,GAAG;CACR,CAAC;AAEX;;;GAGG;AACU,QAAA,mBAAmB,GAAG;IACjC,QAAQ,EAAE,4BAAiB,CAAC,YAAY;IACxC,iBAAiB,EAAE,EAAE;IACrB,QAAQ,EAAE,KAAM;IAChB,UAAU,EAAE,GAAG;CACP,CAAC"}

package/dist/cjs/strategies/index.d.ts

@@ -0,0 +1,4 @@
+/** Rate limiting strategies (sliding window, token bucket, etc.) */
+export { RateLimitEngine, createRateLimiter, defaultKeyGenerator, type RateLimitConsumeResult, type RateLimiterConfigInput, } from './rate-limit-engine.js';
+export { fixedWindowDefaults, slidingWindowDefaults, tokenBucketDefaults } from './defaults.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/strategies/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/strategies/index.ts"],"names":[],"mappings":"AAAA,oEAAoE;AAEpE,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,GAC5B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC"}

package/dist/cjs/strategies/index.js

@@ -0,0 +1,13 @@
+"use strict";
+/** Rate limiting strategies (sliding window, token bucket, etc.) */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tokenBucketDefaults = exports.slidingWindowDefaults = exports.fixedWindowDefaults = exports.defaultKeyGenerator = exports.createRateLimiter = exports.RateLimitEngine = void 0;
+var rate_limit_engine_js_1 = require("./rate-limit-engine.js");
+Object.defineProperty(exports, "RateLimitEngine", { enumerable: true, get: function () { return rate_limit_engine_js_1.RateLimitEngine; } });
+Object.defineProperty(exports, "createRateLimiter", { enumerable: true, get: function () { return rate_limit_engine_js_1.createRateLimiter; } });
+Object.defineProperty(exports, "defaultKeyGenerator", { enumerable: true, get: function () { return rate_limit_engine_js_1.defaultKeyGenerator; } });
+var defaults_js_1 = require("./defaults.js");
+Object.defineProperty(exports, "fixedWindowDefaults", { enumerable: true, get: function () { return defaults_js_1.fixedWindowDefaults; } });
+Object.defineProperty(exports, "slidingWindowDefaults", { enumerable: true, get: function () { return defaults_js_1.slidingWindowDefaults; } });
+Object.defineProperty(exports, "tokenBucketDefaults", { enumerable: true, get: function () { return defaults_js_1.tokenBucketDefaults; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/strategies/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/strategies/index.ts"],"names":[],"mappings":";AAAA,oEAAoE;;;AAEpE,+DAMgC;AAL9B,uHAAA,eAAe,OAAA;AACf,yHAAA,iBAAiB,OAAA;AACjB,2HAAA,mBAAmB,OAAA;AAIrB,6CAAgG;AAAvF,kHAAA,mBAAmB,OAAA;AAAE,oHAAA,qBAAqB,OAAA;AAAE,kHAAA,mBAAmB,OAAA"}

package/dist/cjs/strategies/rate-limit-engine.d.ts

@@ -0,0 +1,42 @@
+import type { RateLimitOptions, RateLimitResult, RateLimitStore, TokenBucketRateLimitOptions, WindowRateLimitOptions } from '../types/index.js';
+/** Result of {@link RateLimitEngine.consume} including standard rate-limit headers. */
+export interface RateLimitConsumeResult extends RateLimitResult {
+    headers: Record<string, string>;
+}
+/** Options for {@link createRateLimiter}: `store` is optional — a {@link MemoryStore} is created when omitted. */
+export type RateLimiterConfigInput = (Omit<WindowRateLimitOptions, 'store'> & {
+    store?: RateLimitStore;
+}) | (Omit<TokenBucketRateLimitOptions, 'store'> & {
+    store?: RateLimitStore;
+});
+/**
+ * Default key extractor: uses `req.ip`, then `socket.remoteAddress`, else `"unknown"`.
+ * Strings are returned as-is so you can pass a precomputed key.
+ */
+export declare function defaultKeyGenerator(req: unknown): string;
+/**
+ * Build a {@link RateLimitEngine} with optional in-memory store when `store` is omitted.
+ */
+export declare function createRateLimiter(options: RateLimiterConfigInput): RateLimitEngine;
+/**
+ * Orchestrates key extraction, store increments, header generation, and limit callbacks.
+ */
+export declare class RateLimitEngine {
+    private readonly options;
+    constructor(options: RateLimitOptions);
+    /**
+     * Applies rate limiting for an incoming request-like value.
+     * Uses {@link RateLimitOptionsBase.keyGenerator} (or {@link defaultKeyGenerator}) to derive the storage key.
+     */
+    consume(req: unknown): Promise<RateLimitConsumeResult>;
+    /**
+     * Rate limit using a precomputed storage key (skips `keyGenerator`).
+     * Pass the same `req` for `onLimitReached` / `skip` callbacks when applicable.
+     */
+    consumeWithKey(key: string, req?: unknown): Promise<RateLimitConsumeResult>;
+    private getLimit;
+    private buildPassthroughResult;
+    private buildHeaders;
+    private composeHeaders;
+}
+//# sourceMappingURL=rate-limit-engine.d.ts.map

package/dist/cjs/strategies/rate-limit-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit-engine.d.ts","sourceRoot":"","sources":["../../../src/strategies/rate-limit-engine.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,2BAA2B,EAC3B,sBAAsB,EACvB,MAAM,mBAAmB,CAAC;AAG3B,uFAAuF;AACvF,MAAM,WAAW,sBAAuB,SAAQ,eAAe;IAC7D,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED,kHAAkH;AAClH,MAAM,MAAM,sBAAsB,GAC9B,CAAC,IAAI,CAAC,sBAAsB,EAAE,OAAO,CAAC,GAAG;IAAE,KAAK,CAAC,EAAE,cAAc,CAAA;CAAE,CAAC,GACpE,CAAC,IAAI,CAAC,2BAA2B,EAAE,OAAO,CAAC,GAAG;IAAE,KAAK,CAAC,EAAE,cAAc,CAAA;CAAE,CAAC,CAAC;AAE9E;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAkBxD;AAuBD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,sBAAsB,GAAG,eAAe,CAElF;AAED;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmB;gBAE/B,OAAO,EAAE,gBAAgB;IAIrC;;;OAGG;IACG,OAAO,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAK5D;;;OAGG;IACG,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,GAAE,OAAa,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAetF,OAAO,CAAC,QAAQ;IAOhB,OAAO,CAAC,sBAAsB;IAe9B,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,cAAc;CAuBvB"}