@qwickapps/server 1.3.1 → 1.5.0

package/dist/plugins/rate-limit/__tests__/rate-limit-plugin.test.js

@@ -0,0 +1,220 @@
+/**
+ * Rate Limit Plugin Tests
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { RateLimitService } from '../rate-limit-service.js';
+import { createSlidingWindowStrategy } from '../strategies/sliding-window.js';
+import { createFixedWindowStrategy } from '../strategies/fixed-window.js';
+import { createTokenBucketStrategy } from '../strategies/token-bucket.js';
+// Mock store implementation
+function createMockStore() {
+    const records = new Map();
+    return {
+        name: 'mock',
+        async initialize() {
+            // No-op
+        },
+        async get(key) {
+            return records.get(key) || null;
+        },
+        async increment(key, options) {
+            const now = new Date();
+            const windowMs = options.windowMs;
+            const windowStart = new Date(now.getTime() - (now.getTime() % windowMs));
+            const windowEnd = new Date(windowStart.getTime() + windowMs);
+            const existing = records.get(key);
+            if (existing && existing.windowStart.getTime() === windowStart.getTime()) {
+                existing.count += options.amount || 1;
+                existing.updatedAt = now;
+                return existing;
+            }
+            const newRecord = {
+                id: `mock-${Date.now()}`,
+                key,
+                count: options.amount || 1,
+                maxRequests: options.maxRequests,
+                windowMs: options.windowMs,
+                windowStart,
+                windowEnd,
+                strategy: options.strategy,
+                userId: options.userId,
+                tenantId: options.tenantId,
+                ipAddress: options.ipAddress,
+                createdAt: now,
+                updatedAt: now,
+            };
+            records.set(key, newRecord);
+            return newRecord;
+        },
+        async clear(key) {
+            return records.delete(key);
+        },
+        async cleanup() {
+            const now = Date.now();
+            let deleted = 0;
+            for (const [key, record] of records) {
+                if (record.windowEnd.getTime() < now) {
+                    records.delete(key);
+                    deleted++;
+                }
+            }
+            return deleted;
+        },
+        async shutdown() {
+            records.clear();
+        },
+    };
+}
+// Mock cache implementation
+function createMockCache() {
+    const cache = new Map();
+    return {
+        name: 'mock',
+        async get(key) {
+            const entry = cache.get(key);
+            if (!entry)
+                return null;
+            if (entry.expiresAt <= Date.now()) {
+                cache.delete(key);
+                return null;
+            }
+            return entry.value;
+        },
+        async set(key, value, ttlMs) {
+            cache.set(key, { value, expiresAt: Date.now() + ttlMs });
+        },
+        async increment(key, amount = 1) {
+            const entry = cache.get(key);
+            if (!entry || entry.expiresAt <= Date.now())
+                return null;
+            entry.value.count += amount;
+            return entry.value.count;
+        },
+        async delete(key) {
+            return cache.delete(key);
+        },
+        isAvailable() {
+            return true;
+        },
+        async shutdown() {
+            cache.clear();
+        },
+    };
+}
+describe('RateLimitService', () => {
+    let store;
+    let cache;
+    let service;
+    beforeEach(() => {
+        store = createMockStore();
+        cache = createMockCache();
+        service = new RateLimitService({
+            store,
+            cache,
+            defaults: {
+                windowMs: 60000,
+                maxRequests: 100,
+                strategy: 'sliding-window',
+            },
+        });
+    });
+    afterEach(async () => {
+        await store.shutdown();
+        await cache.shutdown();
+    });
+    describe('checkLimit', () => {
+        it('should return not limited for first request', async () => {
+            const status = await service.checkLimit('test:key', { increment: false });
+            expect(status.limited).toBe(false);
+            expect(status.current).toBe(0);
+            expect(status.limit).toBe(100);
+            expect(status.remaining).toBe(100);
+        });
+        it('should use provided options over defaults', async () => {
+            const status = await service.checkLimit('test:key', {
+                maxRequests: 50,
+                windowMs: 30000,
+                increment: false,
+            });
+            expect(status.limit).toBe(50);
+        });
+    });
+    describe('incrementLimit', () => {
+        it('should increment the counter', async () => {
+            const status1 = await service.incrementLimit('test:key');
+            expect(status1.current).toBe(1);
+            expect(status1.remaining).toBe(99);
+            const status2 = await service.incrementLimit('test:key');
+            expect(status2.current).toBe(2);
+            expect(status2.remaining).toBe(98);
+        });
+        it('should return limited when max reached', async () => {
+            // Set low limit for testing
+            for (let i = 0; i < 5; i++) {
+                await service.incrementLimit('test:key', { maxRequests: 5 });
+            }
+            const status = await service.incrementLimit('test:key', { maxRequests: 5 });
+            expect(status.limited).toBe(true);
+            expect(status.remaining).toBe(0);
+        });
+    });
+    describe('isLimited', () => {
+        it('should return false when not limited', async () => {
+            const limited = await service.isLimited('test:key');
+            expect(limited).toBe(false);
+        });
+        it('should return true when limited', async () => {
+            // Exhaust the limit
+            for (let i = 0; i < 5; i++) {
+                await service.incrementLimit('test:key', { maxRequests: 5 });
+            }
+            const limited = await service.isLimited('test:key', { maxRequests: 5 });
+            expect(limited).toBe(true);
+        });
+    });
+    describe('clearLimit', () => {
+        it('should clear the limit', async () => {
+            // Create some limits
+            await service.incrementLimit('test:key');
+            await service.incrementLimit('test:key');
+            // Verify exists
+            const beforeStatus = await service.checkLimit('test:key', { increment: false });
+            expect(beforeStatus.current).toBeGreaterThan(0);
+            // Clear
+            await service.clearLimit('test:key');
+            // Verify cleared
+            const afterStatus = await service.checkLimit('test:key', { increment: false });
+            expect(afterStatus.current).toBe(0);
+        });
+    });
+});
+describe('Strategies', () => {
+    describe('Sliding Window', () => {
+        it('should create strategy with correct name', () => {
+            const strategy = createSlidingWindowStrategy();
+            expect(strategy.name).toBe('sliding-window');
+        });
+    });
+    describe('Fixed Window', () => {
+        it('should create strategy with correct name', () => {
+            const strategy = createFixedWindowStrategy();
+            expect(strategy.name).toBe('fixed-window');
+        });
+    });
+    describe('Token Bucket', () => {
+        it('should create strategy with correct name', () => {
+            const strategy = createTokenBucketStrategy();
+            expect(strategy.name).toBe('token-bucket');
+        });
+    });
+});
+describe('Types', () => {
+    it('should export all required types', async () => {
+        // This test verifies that the types module compiles correctly
+        const types = await import('../types.js');
+        expect(types).toBeDefined();
+    });
+});
+//# sourceMappingURL=rate-limit-plugin.test.js.map

package/dist/plugins/rate-limit/__tests__/rate-limit-plugin.test.js.map

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

package/dist/plugins/rate-limit/cleanup.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Rate Limit Cleanup Job
+ *
+ * Periodically removes expired rate limit records from the database.
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+import type { RateLimitStore } from './types.js';
+/**
+ * Cleanup job configuration
+ */
+export interface CleanupJobConfig {
+    /** Store to clean up */
+    store: RateLimitStore;
+    /** Cleanup interval in milliseconds (default: 300000 = 5 min) */
+    intervalMs?: number;
+    /** Enable debug logging */
+    debug?: boolean;
+}
+/**
+ * Cleanup job state
+ */
+export interface CleanupJob {
+    /** Start the cleanup job */
+    start(): void;
+    /** Stop the cleanup job */
+    stop(): void;
+    /** Run cleanup immediately */
+    runNow(): Promise<number>;
+    /** Check if job is running */
+    isRunning(): boolean;
+}
+/**
+ * Create a cleanup job
+ *
+ * @param config Cleanup configuration
+ * @returns CleanupJob instance
+ */
+export declare function createCleanupJob(config: CleanupJobConfig): CleanupJob;
+//# sourceMappingURL=cleanup.d.ts.map

package/dist/plugins/rate-limit/cleanup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanup.d.ts","sourceRoot":"","sources":["../../../src/plugins/rate-limit/cleanup.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,wBAAwB;IACxB,KAAK,EAAE,cAAc,CAAC;IAEtB,iEAAiE;IACjE,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,4BAA4B;IAC5B,KAAK,IAAI,IAAI,CAAC;IAEd,2BAA2B;IAC3B,IAAI,IAAI,IAAI,CAAC;IAEb,8BAA8B;IAC9B,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAE1B,8BAA8B;IAC9B,SAAS,IAAI,OAAO,CAAC;CACtB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,UAAU,CAqErE"}

package/dist/plugins/rate-limit/cleanup.js

@@ -0,0 +1,72 @@
+/**
+ * Rate Limit Cleanup Job
+ *
+ * Periodically removes expired rate limit records from the database.
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+/**
+ * Create a cleanup job
+ *
+ * @param config Cleanup configuration
+ * @returns CleanupJob instance
+ */
+export function createCleanupJob(config) {
+    const { store, intervalMs = 300000, // 5 minutes default
+    debug = false, } = config;
+    let intervalId = null;
+    let isRunningCleanup = false;
+    function log(message, data) {
+        if (debug) {
+            console.log(`[RateLimitCleanup] ${message}`, data || '');
+        }
+    }
+    async function runCleanup() {
+        if (isRunningCleanup) {
+            log('Cleanup already in progress, skipping');
+            return 0;
+        }
+        isRunningCleanup = true;
+        try {
+            log('Starting cleanup');
+            const startTime = Date.now();
+            const deletedCount = await store.cleanup();
+            const duration = Date.now() - startTime;
+            log('Cleanup complete', { deletedCount, durationMs: duration });
+            return deletedCount;
+        }
+        catch (error) {
+            console.error('[RateLimitCleanup] Error during cleanup:', error);
+            return 0;
+        }
+        finally {
+            isRunningCleanup = false;
+        }
+    }
+    return {
+        start() {
+            if (intervalId) {
+                log('Cleanup job already running');
+                return;
+            }
+            log('Starting cleanup job', { intervalMs });
+            intervalId = setInterval(runCleanup, intervalMs);
+            // Run initial cleanup after a short delay
+            setTimeout(runCleanup, 10000);
+        },
+        stop() {
+            if (intervalId) {
+                log('Stopping cleanup job');
+                clearInterval(intervalId);
+                intervalId = null;
+            }
+        },
+        async runNow() {
+            return runCleanup();
+        },
+        isRunning() {
+            return intervalId !== null;
+        },
+    };
+}
+//# sourceMappingURL=cleanup.js.map

package/dist/plugins/rate-limit/cleanup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanup.js","sourceRoot":"","sources":["../../../src/plugins/rate-limit/cleanup.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAmCH;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAwB;IACvD,MAAM,EACJ,KAAK,EACL,UAAU,GAAG,MAAM,EAAE,oBAAoB;IACzC,KAAK,GAAG,KAAK,GACd,GAAG,MAAM,CAAC;IAEX,IAAI,UAAU,GAA0C,IAAI,CAAC;IAC7D,IAAI,gBAAgB,GAAG,KAAK,CAAC;IAE7B,SAAS,GAAG,CAAC,OAAe,EAAE,IAA8B;QAC1D,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,CAAC,GAAG,CAAC,sBAAsB,OAAO,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;IAED,KAAK,UAAU,UAAU;QACvB,IAAI,gBAAgB,EAAE,CAAC;YACrB,GAAG,CAAC,uCAAuC,CAAC,CAAC;YAC7C,OAAO,CAAC,CAAC;QACX,CAAC;QAED,gBAAgB,GAAG,IAAI,CAAC;QACxB,IAAI,CAAC;YACH,GAAG,CAAC,kBAAkB,CAAC,CAAC;YACxB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC7B,MAAM,YAAY,GAAG,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC;YAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;YAExC,GAAG,CAAC,kBAAkB,EAAE,EAAE,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAC;YAChE,OAAO,YAAY,CAAC;QACtB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,0CAA0C,EAAE,KAAK,CAAC,CAAC;YACjE,OAAO,CAAC,CAAC;QACX,CAAC;gBAAS,CAAC;YACT,gBAAgB,GAAG,KAAK,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,OAAO;QACL,KAAK;YACH,IAAI,UAAU,EAAE,CAAC;gBACf,GAAG,CAAC,6BAA6B,CAAC,CAAC;gBACnC,OAAO;YACT,CAAC;YAED,GAAG,CAAC,sBAAsB,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;YAC5C,UAAU,GAAG,WAAW,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;YAEjD,0CAA0C;YAC1C,UAAU,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QAChC,CAAC;QAED,IAAI;YACF,IAAI,UAAU,EAAE,CAAC;gBACf,GAAG,CAAC,sBAAsB,CAAC,CAAC;gBAC5B,aAAa,CAAC,UAAU,CAAC,CAAC;gBAC1B,UAAU,GAAG,IAAI,CAAC;YACpB,CAAC;QACH,CAAC;QAED,KAAK,CAAC,MAAM;YACV,OAAO,UAAU,EAAE,CAAC;QACtB,CAAC;QAED,SAAS;YACP,OAAO,UAAU,KAAK,IAAI,CAAC;QAC7B,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/plugins/rate-limit/env-config.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Rate Limit Plugin Environment Configuration
+ *
+ * Factory function for configuring rate limiting via environment variables.
+ *
+ * Environment Variables:
+ * - RATE_LIMIT_ENABLED: Enable rate limiting (default: true)
+ * - RATE_LIMIT_STRATEGY: Strategy to use: sliding-window, fixed-window, token-bucket (default: sliding-window)
+ * - RATE_LIMIT_WINDOW_MS: Window size in milliseconds (default: 60000 = 1 minute)
+ * - RATE_LIMIT_MAX_REQUESTS: Maximum requests per window (default: 100)
+ * - RATE_LIMIT_CACHE_TYPE: Cache type: redis, memory, auto (default: auto)
+ * - RATE_LIMIT_CLEANUP_ENABLED: Enable cleanup job (default: true)
+ * - RATE_LIMIT_CLEANUP_INTERVAL_MS: Cleanup interval in ms (default: 300000 = 5 minutes)
+ * - RATE_LIMIT_API_ENABLED: Enable status API endpoints (default: true)
+ * - RATE_LIMIT_API_PREFIX: API route prefix (default: /rate-limit)
+ * - RATE_LIMIT_DEBUG: Enable debug logging (default: false)
+ *
+ * PostgreSQL Store (via postgres-plugin):
+ * - RATE_LIMIT_TABLE_NAME: Table name (default: rate_limits)
+ * - RATE_LIMIT_ENABLE_RLS: Enable Row-Level Security (default: true)
+ * - RATE_LIMIT_AUTO_CREATE_TABLES: Auto-create tables (default: true)
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+import type { Plugin } from '../../core/plugin-registry.js';
+import type { RateLimitPluginConfig, RateLimitStrategy } from './types.js';
+interface RateLimitConfigStatus {
+    state: 'disabled' | 'enabled' | 'error';
+    strategy: RateLimitStrategy | null;
+    error?: string;
+    config?: Record<string, string | number | boolean>;
+}
+/**
+ * Get an environment variable, treating empty strings as undefined
+ */
+declare function getEnv(key: string): string | undefined;
+/**
+ * Parse a boolean environment variable
+ */
+declare function getEnvBool(key: string, defaultValue: boolean): boolean;
+/**
+ * Parse an integer environment variable
+ */
+declare function getEnvInt(key: string, defaultValue: number): number;
+export interface RateLimitEnvPluginOptions {
+    /**
+     * Override the default store. If not provided, uses postgres-plugin.
+     */
+    store?: RateLimitPluginConfig['store'];
+    /**
+     * Debug mode override
+     */
+    debug?: boolean;
+}
+/**
+ * Create a rate limit plugin configured from environment variables.
+ *
+ * The plugin state depends on environment configuration:
+ * - **disabled**: RATE_LIMIT_ENABLED=false - no rate limiting is applied
+ * - **enabled**: Valid configuration - rate limiting is active
+ * - **error**: Invalid configuration or missing postgres - plugin is disabled with error details
+ *
+ * @example
+ * ```typescript
+ * // Zero-config setup - reads everything from env vars
+ * // Requires postgres-plugin to be registered first
+ * const rateLimitPlugin = createRateLimitPluginFromEnv();
+ *
+ * // With custom store
+ * const rateLimitPlugin = createRateLimitPluginFromEnv({
+ *   store: myCustomStore,
+ * });
+ * ```
+ *
+ * @param options - Optional overrides
+ * @returns A Plugin instance
+ */
+export declare function createRateLimitPluginFromEnv(options?: RateLimitEnvPluginOptions): Plugin;
+/**
+ * Get current rate limit plugin status
+ */
+export declare function getRateLimitConfigStatus(): RateLimitConfigStatus;
+export declare const __testing: {
+    getEnv: typeof getEnv;
+    getEnvBool: typeof getEnvBool;
+    getEnvInt: typeof getEnvInt;
+    VALID_STRATEGIES: RateLimitStrategy[];
+    VALID_CACHE_TYPES: ("redis" | "memory" | "auto" | undefined)[];
+};
+export {};
+//# sourceMappingURL=env-config.d.ts.map

package/dist/plugins/rate-limit/env-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-config.d.ts","sourceRoot":"","sources":["../../../src/plugins/rate-limit/env-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAgC,MAAM,+BAA+B,CAAC;AAC1F,OAAO,KAAK,EAAE,qBAAqB,EAAE,iBAAiB,EAAwB,MAAM,YAAY,CAAC;AASjG,UAAU,qBAAqB;IAC7B,KAAK,EAAE,UAAU,GAAG,SAAS,GAAG,OAAO,CAAC;IACxC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;CACpD;AAWD;;GAEG;AACH,iBAAS,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAM/C;AAED;;GAEG;AACH,iBAAS,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,GAAG,OAAO,CAa/D;AAED;;GAEG;AACH,iBAAS,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAO5D;AAMD,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,KAAK,CAAC,EAAE,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAEvC;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AASD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,CAAC,EAAE,yBAAyB,GAAG,MAAM,CAkGxF;AAMD;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,qBAAqB,CAEhE;AAiJD,eAAO,MAAM,SAAS;;;;;;CAMrB,CAAC"}