nest-ratelimit-pro 1.0.0

package/dist/interfaces/rate-limit-options.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit-options.interface.js","sourceRoot":"","sources":["../../src/interfaces/rate-limit-options.interface.ts"],"names":[],"mappings":";;;AAMA,IAAY,kBAoBX;AApBD,WAAY,kBAAkB;IAI5B,mDAA6B,CAAA;IAK7B,mDAA6B,CAAA;IAK7B,uDAAiC,CAAA;IAKjC,uEAAiD,CAAA;AACnD,CAAC,EApBW,kBAAkB,kCAAlB,kBAAkB,QAoB7B;AAKD,IAAY,oBAyBX;AAzBD,WAAY,oBAAoB;IAI9B,iCAAS,CAAA;IAKT,2CAAmB,CAAA;IAKnB,2CAAmB,CAAA;IAKnB,yCAAiB,CAAA;IAKjB,6CAAqB,CAAA;AACvB,CAAC,EAzBW,oBAAoB,oCAApB,oBAAoB,QAyB/B"}

package/dist/interfaces/rate-limit.interface.d.ts

@@ -0,0 +1,20 @@
+export interface RateLimitResult {
+    allowed: boolean;
+    limit: number;
+    remaining: number;
+    resetAt: number;
+    retryAfter?: number;
+    cost?: number;
+}
+export interface RateLimitInfo {
+    key: string;
+    consumed: number;
+    limit: number;
+    windowStart: number;
+    windowDuration: number;
+}
+export interface RateLimitCheckOptions {
+    keySuffix?: string;
+    cost?: number;
+    skip?: boolean;
+}

package/dist/interfaces/rate-limit.interface.js

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

package/dist/interfaces/rate-limit.interface.js.map

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

package/dist/interfaces/storage.interface.d.ts

@@ -0,0 +1,12 @@
+import { RateLimitInfo } from './rate-limit.interface';
+export interface RateLimitStorage {
+    increment(key: string, amount: number, ttl: number): Promise<number>;
+    get(key: string): Promise<number>;
+    getInfo(key: string): Promise<RateLimitInfo | null>;
+    reset(key: string): Promise<void>;
+    set(key: string, value: any, ttl: number): Promise<void>;
+    delete(key: string): Promise<void>;
+    exists(key: string): Promise<boolean>;
+    ttl(key: string): Promise<number>;
+    cleanup?(): Promise<void>;
+}

package/dist/interfaces/storage.interface.js

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

package/dist/interfaces/storage.interface.js.map

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

package/dist/rate-limit.module.d.ts

@@ -0,0 +1,8 @@
+import { DynamicModule } from '@nestjs/common';
+import { RateLimitModuleOptions, RateLimitModuleAsyncOptions } from './interfaces/rate-limit-options.interface';
+export declare class RateLimitModule {
+    static forRoot(options: RateLimitModuleOptions): DynamicModule;
+    static forRootAsync(options: RateLimitModuleAsyncOptions): DynamicModule;
+    private static createProviders;
+    private static createAsyncProviders;
+}

package/dist/rate-limit.module.js

@@ -0,0 +1,76 @@
+"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 RateLimitModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RateLimitModule = void 0;
+const common_1 = require("@nestjs/common");
+const rate_limit_service_1 = require("./services/rate-limit.service");
+const rate_limit_guard_1 = require("./guards/rate-limit.guard");
+const memory_storage_1 = require("./storage/memory.storage");
+const constants_1 = require("./constants");
+let RateLimitModule = RateLimitModule_1 = class RateLimitModule {
+    static forRoot(options) {
+        const providers = this.createProviders(options);
+        return {
+            module: RateLimitModule_1,
+            providers,
+            exports: [rate_limit_service_1.RateLimitService, rate_limit_guard_1.RateLimitGuard],
+            global: true,
+        };
+    }
+    static forRootAsync(options) {
+        const providers = this.createAsyncProviders(options);
+        return {
+            module: RateLimitModule_1,
+            imports: options.imports || [],
+            providers,
+            exports: [rate_limit_service_1.RateLimitService, rate_limit_guard_1.RateLimitGuard],
+            global: true,
+        };
+    }
+    static createProviders(options) {
+        return [
+            {
+                provide: constants_1.RATE_LIMIT_OPTIONS,
+                useValue: options,
+            },
+            {
+                provide: constants_1.RATE_LIMIT_STORAGE,
+                useClass: options.storage || memory_storage_1.MemoryRateLimitStorage,
+            },
+            rate_limit_service_1.RateLimitService,
+            rate_limit_guard_1.RateLimitGuard,
+        ];
+    }
+    static createAsyncProviders(options) {
+        const optionsProvider = {
+            provide: constants_1.RATE_LIMIT_OPTIONS,
+            useFactory: options.useFactory,
+            inject: options.inject || [],
+        };
+        return [
+            optionsProvider,
+            {
+                provide: constants_1.RATE_LIMIT_STORAGE,
+                useFactory: (opts) => {
+                    const StorageClass = opts.storage || memory_storage_1.MemoryRateLimitStorage;
+                    return new StorageClass();
+                },
+                inject: [constants_1.RATE_LIMIT_OPTIONS],
+            },
+            rate_limit_service_1.RateLimitService,
+            rate_limit_guard_1.RateLimitGuard,
+        ];
+    }
+};
+exports.RateLimitModule = RateLimitModule;
+exports.RateLimitModule = RateLimitModule = RateLimitModule_1 = __decorate([
+    (0, common_1.Global)(),
+    (0, common_1.Module)({})
+], RateLimitModule);
+//# sourceMappingURL=rate-limit.module.js.map

package/dist/rate-limit.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit.module.js","sourceRoot":"","sources":["../src/rate-limit.module.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,2CAAyE;AAKzE,sEAAiE;AACjE,gEAA2D;AAC3D,6DAAkE;AAClE,2CAAqE;AAI9D,IAAM,eAAe,uBAArB,MAAM,eAAe;IAI1B,MAAM,CAAC,OAAO,CAAC,OAA+B;QAC5C,MAAM,SAAS,GAAG,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QAEhD,OAAO;YACL,MAAM,EAAE,iBAAe;YACvB,SAAS;YACT,OAAO,EAAE,CAAC,qCAAgB,EAAE,iCAAc,CAAC;YAC3C,MAAM,EAAE,IAAI;SACb,CAAC;IACJ,CAAC;IAKD,MAAM,CAAC,YAAY,CAAC,OAAoC;QACtD,MAAM,SAAS,GAAG,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC;QAErD,OAAO;YACL,MAAM,EAAE,iBAAe;YACvB,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE;YAC9B,SAAS;YACT,OAAO,EAAE,CAAC,qCAAgB,EAAE,iCAAc,CAAC;YAC3C,MAAM,EAAE,IAAI;SACb,CAAC;IACJ,CAAC;IAKO,MAAM,CAAC,eAAe,CAAC,OAA+B;QAC5D,OAAO;YACL;gBACE,OAAO,EAAE,8BAAkB;gBAC3B,QAAQ,EAAE,OAAO;aAClB;YACD;gBACE,OAAO,EAAE,8BAAkB;gBAC3B,QAAQ,EAAE,OAAO,CAAC,OAAO,IAAI,uCAAsB;aACpD;YACD,qCAAgB;YAChB,iCAAc;SACf,CAAC;IACJ,CAAC;IAKO,MAAM,CAAC,oBAAoB,CAAC,OAAoC;QACtE,MAAM,eAAe,GAAa;YAChC,OAAO,EAAE,8BAAkB;YAC3B,UAAU,EAAE,OAAO,CAAC,UAAW;YAC/B,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,EAAE;SAC7B,CAAC;QAEF,OAAO;YACL,eAAe;YACf;gBACE,OAAO,EAAE,8BAAkB;gBAC3B,UAAU,EAAE,CAAC,IAA4B,EAAE,EAAE;oBAC3C,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,IAAI,uCAAsB,CAAC;oBAC5D,OAAO,IAAI,YAAY,EAAE,CAAC;gBAC5B,CAAC;gBACD,MAAM,EAAE,CAAC,8BAAkB,CAAC;aAC7B;YACD,qCAAgB;YAChB,iCAAc;SACf,CAAC;IACJ,CAAC;CACF,CAAA;AAxEY,0CAAe;0BAAf,eAAe;IAF3B,IAAA,eAAM,GAAE;IACR,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,eAAe,CAwE3B"}

package/dist/services/rate-limit.service.d.ts

@@ -0,0 +1,18 @@
+import { Request } from 'express';
+import { RateLimitStorage } from '../interfaces/storage.interface';
+import { RateLimitModuleOptions } from '../interfaces/rate-limit-options.interface';
+import { RateLimitResult, RateLimitCheckOptions } from '../interfaces/rate-limit.interface';
+export declare class RateLimitService {
+    private readonly options;
+    private readonly storage;
+    private readonly windowDurationMs;
+    private readonly windowDurationSec;
+    constructor(options: RateLimitModuleOptions, storage: RateLimitStorage);
+    check(request: Request, checkOptions?: RateLimitCheckOptions): Promise<RateLimitResult>;
+    private checkFixedWindow;
+    private checkSlidingWindow;
+    private checkTokenBucket;
+    private generateKey;
+    private createAllowedResult;
+    reset(identifier: string): Promise<void>;
+}

package/dist/services/rate-limit.service.js

@@ -0,0 +1,164 @@
+"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);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RateLimitService = void 0;
+const common_1 = require("@nestjs/common");
+const rate_limit_options_interface_1 = require("../interfaces/rate-limit-options.interface");
+const constants_1 = require("../constants");
+const time_utils_1 = require("../utils/time-utils");
+const key_utils_1 = require("../utils/key.utils");
+let RateLimitService = class RateLimitService {
+    constructor(options, storage) {
+        this.options = options;
+        this.storage = storage;
+        this.windowDurationMs = (0, time_utils_1.parseDuration)(options.duration);
+        this.windowDurationSec = (0, time_utils_1.msToSeconds)(this.windowDurationMs);
+    }
+    async check(request, checkOptions) {
+        if (this.options.enabled === false) {
+            return this.createAllowedResult(this.options.limit);
+        }
+        if (checkOptions?.skip) {
+            return this.createAllowedResult(this.options.limit);
+        }
+        if (this.options.skipIf && (await this.options.skipIf(request))) {
+            return this.createAllowedResult(this.options.limit);
+        }
+        const key = await this.generateKey(request, checkOptions?.keySuffix);
+        const cost = checkOptions?.cost || 1;
+        switch (this.options.algorithm) {
+            case rate_limit_options_interface_1.RateLimitAlgorithm.SLIDING_WINDOW:
+                return this.checkSlidingWindow(key, cost);
+            case rate_limit_options_interface_1.RateLimitAlgorithm.TOKEN_BUCKET:
+                return this.checkTokenBucket(key, cost);
+            default:
+                return this.checkFixedWindow(key, cost);
+        }
+    }
+    async checkFixedWindow(key, cost) {
+        const count = await this.storage.increment(key, cost, this.windowDurationSec);
+        const allowed = count <= this.options.limit;
+        const remaining = Math.max(0, this.options.limit - count);
+        const resetAt = (0, time_utils_1.calculateResetTime)(this.windowDurationMs);
+        return {
+            allowed,
+            limit: this.options.limit,
+            remaining,
+            resetAt,
+            retryAfter: allowed ? undefined : this.windowDurationSec,
+            cost,
+        };
+    }
+    async checkSlidingWindow(key, cost) {
+        const now = Date.now();
+        const windowStart = now - this.windowDurationMs;
+        const currentKey = `${key}:${Math.floor(now / this.windowDurationMs)}`;
+        const previousKey = `${key}:${Math.floor(windowStart / this.windowDurationMs)}`;
+        const currentCount = await this.storage.get(currentKey);
+        const previousCount = await this.storage.get(previousKey);
+        const previousWeight = (this.windowDurationMs - (now % this.windowDurationMs)) / this.windowDurationMs;
+        const weightedCount = previousCount * previousWeight + currentCount;
+        if (weightedCount + cost <= this.options.limit) {
+            await this.storage.increment(currentKey, cost, this.windowDurationSec);
+            return {
+                allowed: true,
+                limit: this.options.limit,
+                remaining: Math.max(0, this.options.limit - weightedCount - cost),
+                resetAt: (0, time_utils_1.calculateResetTime)(this.windowDurationMs),
+                cost,
+            };
+        }
+        return {
+            allowed: false,
+            limit: this.options.limit,
+            remaining: 0,
+            resetAt: (0, time_utils_1.calculateResetTime)(this.windowDurationMs),
+            retryAfter: this.windowDurationSec,
+            cost,
+        };
+    }
+    async checkTokenBucket(key, cost) {
+        const tokenKey = `${key}:tokens`;
+        const lastUpdateKey = `${key}:lastUpdate`;
+        const now = Date.now();
+        const tokens = (await this.storage.get(tokenKey)) || this.options.limit;
+        const lastUpdate = (await this.storage.get(lastUpdateKey)) || now;
+        const timePassed = now - lastUpdate;
+        const tokensToAdd = (timePassed / this.windowDurationMs) * this.options.limit;
+        const currentTokens = Math.min(this.options.limit, tokens + tokensToAdd);
+        if (currentTokens >= cost) {
+            const newTokens = currentTokens - cost;
+            await this.storage.set(tokenKey, newTokens, this.windowDurationSec);
+            await this.storage.set(lastUpdateKey, now, this.windowDurationSec);
+            return {
+                allowed: true,
+                limit: this.options.limit,
+                remaining: Math.floor(newTokens),
+                resetAt: (0, time_utils_1.calculateResetTime)(this.windowDurationMs),
+                cost,
+            };
+        }
+        return {
+            allowed: false,
+            limit: this.options.limit,
+            remaining: 0,
+            resetAt: (0, time_utils_1.calculateResetTime)(this.windowDurationMs),
+            retryAfter: Math.ceil((cost - currentTokens) / this.options.limit * this.windowDurationSec),
+            cost,
+        };
+    }
+    async generateKey(request, suffix) {
+        const prefix = this.options.keyPrefix || constants_1.DEFAULT_KEY_PREFIX;
+        let identifier;
+        if (this.options.keyExtractor) {
+            identifier = await this.options.keyExtractor(request);
+        }
+        else {
+            switch (this.options.keyStrategy) {
+                case rate_limit_options_interface_1.RateLimitKeyStrategy.USER_ID:
+                    identifier = (0, key_utils_1.extractUserId)(request);
+                    break;
+                case rate_limit_options_interface_1.RateLimitKeyStrategy.API_KEY:
+                    identifier = (0, key_utils_1.extractApiKey)(request, this.options.apiKeyHeader);
+                    break;
+                case rate_limit_options_interface_1.RateLimitKeyStrategy.IP:
+                default:
+                    identifier = (0, key_utils_1.extractIpAddress)(request);
+                    break;
+            }
+        }
+        return (0, key_utils_1.buildRateLimitKey)(prefix, identifier, suffix);
+    }
+    createAllowedResult(limit) {
+        return {
+            allowed: true,
+            limit,
+            remaining: limit,
+            resetAt: (0, time_utils_1.getCurrentTimestamp)() + this.windowDurationSec,
+        };
+    }
+    async reset(identifier) {
+        const prefix = this.options.keyPrefix || constants_1.DEFAULT_KEY_PREFIX;
+        const key = (0, key_utils_1.buildRateLimitKey)(prefix, identifier);
+        await this.storage.reset(key);
+    }
+};
+exports.RateLimitService = RateLimitService;
+exports.RateLimitService = RateLimitService = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(constants_1.RATE_LIMIT_OPTIONS)),
+    __param(1, (0, common_1.Inject)(constants_1.RATE_LIMIT_STORAGE)),
+    __metadata("design:paramtypes", [Object, Object])
+], RateLimitService);
+//# sourceMappingURL=rate-limit.service.js.map

package/dist/services/rate-limit.service.js.map

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

package/dist/storage/memory.storage.d.ts

@@ -0,0 +1,19 @@
+import { RateLimitStorage } from '../interfaces/storage.interface';
+import { RateLimitInfo } from '../interfaces/rate-limit.interface';
+export declare class MemoryRateLimitStorage implements RateLimitStorage {
+    private storage;
+    private cleanupInterval;
+    constructor();
+    increment(key: string, amount: number | undefined, ttl: number): Promise<number>;
+    get(key: string): Promise<number>;
+    getInfo(key: string): Promise<RateLimitInfo | null>;
+    reset(key: string): Promise<void>;
+    set(key: string, value: any, ttl: number): Promise<void>;
+    delete(key: string): Promise<void>;
+    exists(key: string): Promise<boolean>;
+    ttl(key: string): Promise<number>;
+    cleanup(): Promise<void>;
+    clear(): void;
+    size(): number;
+    onModuleDestroy(): void;
+}

package/dist/storage/memory.storage.js

@@ -0,0 +1,124 @@
+"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.MemoryRateLimitStorage = void 0;
+const common_1 = require("@nestjs/common");
+let MemoryRateLimitStorage = class MemoryRateLimitStorage {
+    constructor() {
+        this.storage = new Map();
+        this.cleanupInterval = setInterval(() => {
+            this.cleanup();
+        }, 60000);
+    }
+    async increment(key, amount = 1, ttl) {
+        const now = Date.now();
+        const expiresAt = now + ttl * 1000;
+        const entry = this.storage.get(key);
+        if (!entry || entry.expiresAt < now) {
+            this.storage.set(key, {
+                value: amount,
+                expiresAt,
+            });
+            return amount;
+        }
+        entry.value += amount;
+        entry.expiresAt = expiresAt;
+        return entry.value;
+    }
+    async get(key) {
+        const entry = this.storage.get(key);
+        if (!entry) {
+            return 0;
+        }
+        if (entry.expiresAt < Date.now()) {
+            this.storage.delete(key);
+            return 0;
+        }
+        return entry.value;
+    }
+    async getInfo(key) {
+        const entry = this.storage.get(key);
+        if (!entry || entry.expiresAt < Date.now()) {
+            return null;
+        }
+        return {
+            key,
+            consumed: entry.value,
+            limit: 0,
+            windowStart: Date.now(),
+            windowDuration: entry.expiresAt - Date.now(),
+        };
+    }
+    async reset(key) {
+        this.storage.delete(key);
+    }
+    async set(key, value, ttl) {
+        this.storage.set(key, {
+            value,
+            expiresAt: Date.now() + ttl * 1000,
+        });
+    }
+    async delete(key) {
+        this.storage.delete(key);
+    }
+    async exists(key) {
+        const entry = this.storage.get(key);
+        if (!entry) {
+            return false;
+        }
+        if (entry.expiresAt < Date.now()) {
+            this.storage.delete(key);
+            return false;
+        }
+        return true;
+    }
+    async ttl(key) {
+        const entry = this.storage.get(key);
+        if (!entry) {
+            return -2;
+        }
+        const remaining = Math.floor((entry.expiresAt - Date.now()) / 1000);
+        if (remaining <= 0) {
+            this.storage.delete(key);
+            return -2;
+        }
+        return remaining;
+    }
+    async cleanup() {
+        const now = Date.now();
+        const expiredKeys = [];
+        for (const [key, entry] of this.storage.entries()) {
+            if (entry.expiresAt < now) {
+                expiredKeys.push(key);
+            }
+        }
+        for (const key of expiredKeys) {
+            this.storage.delete(key);
+        }
+    }
+    clear() {
+        this.storage.clear();
+    }
+    size() {
+        return this.storage.size;
+    }
+    onModuleDestroy() {
+        if (this.cleanupInterval) {
+            clearInterval(this.cleanupInterval);
+        }
+    }
+};
+exports.MemoryRateLimitStorage = MemoryRateLimitStorage;
+exports.MemoryRateLimitStorage = MemoryRateLimitStorage = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [])
+], MemoryRateLimitStorage);
+//# sourceMappingURL=memory.storage.js.map

package/dist/storage/memory.storage.js.map

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

package/dist/utils/key.utils.d.ts

@@ -0,0 +1,5 @@
+import { Request } from 'express';
+export declare function extractIpAddress(request: Request): string;
+export declare function extractUserId(request: any): string;
+export declare function extractApiKey(request: Request, headerName?: string): string;
+export declare function buildRateLimitKey(prefix: string, identifier: string, suffix?: string): string;

package/dist/utils/key.utils.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractIpAddress = extractIpAddress;
+exports.extractUserId = extractUserId;
+exports.extractApiKey = extractApiKey;
+exports.buildRateLimitKey = buildRateLimitKey;
+function extractIpAddress(request) {
+    const forwardedFor = request.headers['x-forwarded-for'];
+    if (forwardedFor) {
+        const ips = typeof forwardedFor === 'string'
+            ? forwardedFor.split(',')
+            : forwardedFor;
+        return ips[0].trim();
+    }
+    const realIp = request.headers['x-real-ip'];
+    if (realIp) {
+        return typeof realIp === 'string' ? realIp : realIp[0];
+    }
+    return request.ip || request.socket?.remoteAddress || 'unknown';
+}
+function extractUserId(request) {
+    if (request.user?.id) {
+        return String(request.user.id);
+    }
+    if (request.user?.sub) {
+        return String(request.user.sub);
+    }
+    if (request.userId) {
+        return String(request.userId);
+    }
+    return 'anonymous';
+}
+function extractApiKey(request, headerName = 'X-API-Key') {
+    const apiKey = request.headers[headerName.toLowerCase()];
+    if (apiKey) {
+        return typeof apiKey === 'string' ? apiKey : apiKey[0];
+    }
+    return 'unknown';
+}
+function buildRateLimitKey(prefix, identifier, suffix) {
+    const parts = [prefix, identifier];
+    if (suffix) {
+        parts.push(suffix);
+    }
+    return parts.join(':');
+}
+//# sourceMappingURL=key.utils.js.map

package/dist/utils/key.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"key.utils.js","sourceRoot":"","sources":["../../src/utils/key.utils.ts"],"names":[],"mappings":";;AAOA,4CAmBC;AAOD,sCAeC;AAQD,sCAQC;AASD,8CAQC;AA1ED,SAAgB,gBAAgB,CAAC,OAAgB;IAE/C,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAExD,IAAI,YAAY,EAAE,CAAC;QACjB,MAAM,GAAG,GAAG,OAAO,YAAY,KAAK,QAAQ;YAC1C,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC;YACzB,CAAC,CAAC,YAAY,CAAC;QACjB,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACvB,CAAC;IAGD,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC5C,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACzD,CAAC;IAGD,OAAO,OAAO,CAAC,EAAE,IAAI,OAAO,CAAC,MAAM,EAAE,aAAa,IAAI,SAAS,CAAC;AAClE,CAAC;AAOD,SAAgB,aAAa,CAAC,OAAY;IAExC,IAAI,OAAO,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC;QACrB,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjC,CAAC;IAED,IAAI,OAAO,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC;QACtB,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAClC,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC;AAQD,SAAgB,aAAa,CAAC,OAAgB,EAAE,aAAqB,WAAW;IAC9E,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC;IAEzD,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACzD,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AASD,SAAgB,iBAAiB,CAAC,MAAc,EAAE,UAAkB,EAAE,MAAe;IACnF,MAAM,KAAK,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAEnC,IAAI,MAAM,EAAE,CAAC;QACX,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACrB,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC"}

package/dist/utils/time-utils.d.ts

@@ -0,0 +1,4 @@
+export declare function parseDuration(duration: string | number): number;
+export declare function msToSeconds(milliseconds: number): number;
+export declare function getCurrentTimestamp(): number;
+export declare function calculateResetTime(windowDuration: number): number;

package/dist/utils/time-utils.js

@@ -0,0 +1,30 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseDuration = parseDuration;
+exports.msToSeconds = msToSeconds;
+exports.getCurrentTimestamp = getCurrentTimestamp;
+exports.calculateResetTime = calculateResetTime;
+const ms_1 = __importDefault(require("ms"));
+function parseDuration(duration) {
+    if (typeof duration === 'number') {
+        return duration;
+    }
+    const milliseconds = (0, ms_1.default)(duration);
+    if (milliseconds === undefined) {
+        throw new Error(`Invalid duration format: ${duration}`);
+    }
+    return milliseconds;
+}
+function msToSeconds(milliseconds) {
+    return Math.floor(milliseconds / 1000);
+}
+function getCurrentTimestamp() {
+    return Math.floor(Date.now() / 1000);
+}
+function calculateResetTime(windowDuration) {
+    return getCurrentTimestamp() + msToSeconds(windowDuration);
+}
+//# sourceMappingURL=time-utils.js.map

package/dist/utils/time-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"time-utils.js","sourceRoot":"","sources":["../../src/utils/time-utils.ts"],"names":[],"mappings":";;;;;AAOA,sCAYC;AAOD,kCAEC;AAMD,kDAEC;AAOD,gDAEC;AA7CD,4CAAoB;AAOpB,SAAgB,aAAa,CAAC,QAAyB;IACrD,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACjC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM,YAAY,GAAG,IAAA,YAAE,EAAC,QAAQ,CAAC,CAAC;IAElC,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,4BAA4B,QAAQ,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,OAAO,YAAY,CAAC;AACtB,CAAC;AAOD,SAAgB,WAAW,CAAC,YAAoB;IAC9C,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;AACzC,CAAC;AAMD,SAAgB,mBAAmB;IACjC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;AACvC,CAAC;AAOD,SAAgB,kBAAkB,CAAC,cAAsB;IACvD,OAAO,mBAAmB,EAAE,GAAG,WAAW,CAAC,cAAc,CAAC,CAAC;AAC7D,CAAC"}