@qwickapps/server 1.3.0 → 1.4.0

package/dist/plugins/preferences/stores/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Preferences Stores Index
+ *
+ * Re-exports all available preferences store implementations.
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+export { postgresPreferencesStore, deepMerge } from './postgres-store.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/preferences/stores/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/plugins/preferences/stores/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,wBAAwB,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/plugins/preferences/stores/index.js

@@ -0,0 +1,9 @@
+/**
+ * Preferences Stores Index
+ *
+ * Re-exports all available preferences store implementations.
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+export { postgresPreferencesStore, deepMerge } from './postgres-store.js';
+//# sourceMappingURL=index.js.map

package/dist/plugins/preferences/stores/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/plugins/preferences/stores/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,wBAAwB,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/plugins/preferences/stores/postgres-store.d.ts

@@ -0,0 +1,41 @@
+/**
+ * PostgreSQL Preferences Store
+ *
+ * Preferences storage implementation using PostgreSQL with Row-Level Security (RLS).
+ * Requires the 'pg' package and the Users plugin to be installed.
+ *
+ * RLS Context Pattern:
+ * Each operation uses an explicit transaction and sets `app.current_user_id`
+ * as a transaction-local configuration variable. The RLS policy checks this
+ * variable to enforce that users can only access their own preferences.
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+import type { PreferencesStore, PostgresPreferencesStoreConfig } from '../types.js';
+/**
+ * Deep merge two objects
+ * - Objects are recursively merged
+ * - Arrays are replaced (not merged)
+ * - Source values override target values
+ */
+export declare function deepMerge(target: Record<string, unknown>, source: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Create a PostgreSQL preferences store with RLS
+ *
+ * @param config Configuration including a pg Pool instance
+ * @returns PreferencesStore implementation
+ *
+ * @example
+ * ```ts
+ * import { Pool } from 'pg';
+ * import { postgresPreferencesStore } from '@qwickapps/server';
+ *
+ * const pool = new Pool({ connectionString: process.env.DATABASE_URL });
+ * const store = postgresPreferencesStore({ pool });
+ *
+ * // Or with lazy initialization:
+ * const store = postgresPreferencesStore({ pool: () => getPostgres().getPool() });
+ * ```
+ */
+export declare function postgresPreferencesStore(config: PostgresPreferencesStoreConfig): PreferencesStore;
+//# sourceMappingURL=postgres-store.d.ts.map

package/dist/plugins/preferences/stores/postgres-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-store.d.ts","sourceRoot":"","sources":["../../../../src/plugins/preferences/stores/postgres-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAChB,8BAA8B,EAC/B,MAAM,aAAa,CAAC;AAarB;;;;;GAKG;AACH,wBAAgB,SAAS,CACvB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAgCzB;AAsCD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,8BAA8B,GAAG,gBAAgB,CA4HjG"}

package/dist/plugins/preferences/stores/postgres-store.js

@@ -0,0 +1,181 @@
+/**
+ * PostgreSQL Preferences Store
+ *
+ * Preferences storage implementation using PostgreSQL with Row-Level Security (RLS).
+ * Requires the 'pg' package and the Users plugin to be installed.
+ *
+ * RLS Context Pattern:
+ * Each operation uses an explicit transaction and sets `app.current_user_id`
+ * as a transaction-local configuration variable. The RLS policy checks this
+ * variable to enforce that users can only access their own preferences.
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+/**
+ * Deep merge two objects
+ * - Objects are recursively merged
+ * - Arrays are replaced (not merged)
+ * - Source values override target values
+ */
+export function deepMerge(target, source) {
+    const output = { ...target };
+    for (const key of Object.keys(source)) {
+        const sourceValue = source[key];
+        const targetValue = target[key];
+        // Skip undefined values in source
+        if (sourceValue === undefined) {
+            continue;
+        }
+        // If both are plain objects, merge recursively
+        if (sourceValue !== null &&
+            typeof sourceValue === 'object' &&
+            !Array.isArray(sourceValue) &&
+            targetValue !== null &&
+            typeof targetValue === 'object' &&
+            !Array.isArray(targetValue)) {
+            output[key] = deepMerge(targetValue, sourceValue);
+        }
+        else {
+            // Otherwise, source overwrites target
+            output[key] = sourceValue;
+        }
+    }
+    return output;
+}
+/**
+ * Execute a function within an RLS-protected transaction
+ *
+ * This helper ensures that:
+ * 1. All queries run within the same transaction
+ * 2. The RLS context is set before any data access
+ * 3. The transaction is properly committed or rolled back
+ *
+ * @param pool PostgreSQL pool
+ * @param userId User ID to set as the RLS context
+ * @param callback Function to execute within the transaction
+ */
+async function withRLSContext(pool, userId, callback) {
+    const client = await pool.connect();
+    try {
+        await client.query('BEGIN');
+        // Set transaction-local user context for RLS
+        await client.query("SELECT set_config('app.current_user_id', $1, true)", [userId]);
+        const result = await callback(client);
+        await client.query('COMMIT');
+        return result;
+    }
+    catch (error) {
+        await client.query('ROLLBACK');
+        throw error;
+    }
+    finally {
+        client.release();
+    }
+}
+/**
+ * Create a PostgreSQL preferences store with RLS
+ *
+ * @param config Configuration including a pg Pool instance
+ * @returns PreferencesStore implementation
+ *
+ * @example
+ * ```ts
+ * import { Pool } from 'pg';
+ * import { postgresPreferencesStore } from '@qwickapps/server';
+ *
+ * const pool = new Pool({ connectionString: process.env.DATABASE_URL });
+ * const store = postgresPreferencesStore({ pool });
+ *
+ * // Or with lazy initialization:
+ * const store = postgresPreferencesStore({ pool: () => getPostgres().getPool() });
+ * ```
+ */
+export function postgresPreferencesStore(config) {
+    const { pool: poolOrFn, tableName = 'user_preferences', schema = 'public', autoCreateTables = true, enableRLS = true, } = config;
+    // Helper to get pool (supports lazy initialization via function)
+    const getPool = () => {
+        const pool = typeof poolOrFn === 'function' ? poolOrFn() : poolOrFn;
+        if (!pool || typeof pool.query !== 'function') {
+            throw new Error('Invalid pool: must have query method');
+        }
+        return pool;
+    };
+    const tableFullName = `"${schema}"."${tableName}"`;
+    return {
+        name: 'postgres',
+        async initialize() {
+            if (!autoCreateTables)
+                return;
+            const pool = getPool();
+            // Create table with foreign key to users
+            await pool.query(`
+        CREATE TABLE IF NOT EXISTS ${tableFullName} (
+          id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+          user_id UUID NOT NULL REFERENCES "public"."users"(id) ON DELETE CASCADE,
+          preferences JSONB NOT NULL DEFAULT '{}',
+          created_at TIMESTAMPTZ DEFAULT NOW(),
+          updated_at TIMESTAMPTZ DEFAULT NOW(),
+          UNIQUE(user_id)
+        );
+
+        CREATE INDEX IF NOT EXISTS idx_${tableName}_user_id ON ${tableFullName}(user_id);
+      `);
+            // Enable RLS if configured
+            if (enableRLS) {
+                await pool.query(`
+          ALTER TABLE ${tableFullName} ENABLE ROW LEVEL SECURITY;
+          ALTER TABLE ${tableFullName} FORCE ROW LEVEL SECURITY;
+        `);
+                // Create or replace the RLS policy
+                // Drop existing policy first to avoid errors on re-initialization
+                await pool.query(`
+          DROP POLICY IF EXISTS "${tableName}_owner" ON ${tableFullName};
+        `);
+                // RLS policy with both USING (for SELECT/UPDATE/DELETE reads)
+                // and WITH CHECK (for INSERT/UPDATE writes) clauses
+                await pool.query(`
+          CREATE POLICY "${tableName}_owner" ON ${tableFullName}
+            FOR ALL
+            USING (user_id::text = current_setting('app.current_user_id', true))
+            WITH CHECK (user_id::text = current_setting('app.current_user_id', true));
+        `);
+            }
+        },
+        async get(userId) {
+            return withRLSContext(getPool(), userId, async (client) => {
+                const result = await client.query(`SELECT preferences FROM ${tableFullName} WHERE user_id = $1`, [userId]);
+                if (result.rows.length === 0) {
+                    return null;
+                }
+                return result.rows[0].preferences;
+            });
+        },
+        async update(userId, preferences) {
+            return withRLSContext(getPool(), userId, async (client) => {
+                // Get existing preferences within the same transaction
+                const existingResult = await client.query(`SELECT preferences FROM ${tableFullName} WHERE user_id = $1`, [userId]);
+                const existing = existingResult.rows.length > 0
+                    ? existingResult.rows[0].preferences
+                    : null;
+                const merged = existing ? deepMerge(existing, preferences) : preferences;
+                // Upsert the merged preferences
+                await client.query(`INSERT INTO ${tableFullName} (user_id, preferences, updated_at)
+           VALUES ($1, $2, NOW())
+           ON CONFLICT (user_id) DO UPDATE SET
+             preferences = $2,
+             updated_at = NOW()`, [userId, JSON.stringify(merged)]);
+                return merged;
+            });
+        },
+        async delete(userId) {
+            return withRLSContext(getPool(), userId, async (client) => {
+                const result = await client.query(`DELETE FROM ${tableFullName} WHERE user_id = $1`, [userId]);
+                return (result.rowCount ?? 0) > 0;
+            });
+        },
+        async shutdown() {
+            // Pool is managed externally, nothing to do here
+        },
+    };
+}
+//# sourceMappingURL=postgres-store.js.map

package/dist/plugins/preferences/stores/postgres-store.js.map

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

package/dist/plugins/preferences/types.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Preferences Plugin Types
+ *
+ * Type definitions for user preferences management.
+ * Supports PostgreSQL with Row-Level Security (RLS) for data isolation.
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+/**
+ * User preferences record in the database
+ */
+export interface UserPreferences {
+    /** Primary key - UUID */
+    id: string;
+    /** User ID (foreign key to users table) */
+    user_id: string;
+    /** Preferences as JSON object */
+    preferences: Record<string, unknown>;
+    /** When the preferences were created */
+    created_at: Date;
+    /** When the preferences were last updated */
+    updated_at: Date;
+}
+/**
+ * Preferences store interface - all storage backends must implement this
+ */
+export interface PreferencesStore {
+    /** Store name (e.g., 'postgres', 'memory') */
+    name: string;
+    /**
+     * Initialize the store (create tables, RLS policies, etc.)
+     */
+    initialize(): Promise<void>;
+    /**
+     * Get preferences for a user
+     * Returns null if no preferences exist for the user
+     */
+    get(userId: string): Promise<Record<string, unknown> | null>;
+    /**
+     * Update preferences for a user (upsert with deep merge)
+     * Returns the merged preferences
+     */
+    update(userId: string, preferences: Record<string, unknown>): Promise<Record<string, unknown>>;
+    /**
+     * Delete preferences for a user
+     * Returns true if preferences were deleted, false if none existed
+     */
+    delete(userId: string): Promise<boolean>;
+    /**
+     * Shutdown the store
+     */
+    shutdown(): Promise<void>;
+}
+/**
+ * PostgreSQL preferences store configuration
+ */
+export interface PostgresPreferencesStoreConfig {
+    /** PostgreSQL pool instance or a function that returns one (for lazy initialization) */
+    pool: unknown | (() => unknown);
+    /** Table name (default: 'user_preferences') */
+    tableName?: string;
+    /** Schema name (default: 'public') */
+    schema?: string;
+    /** Auto-create tables on init (default: true) */
+    autoCreateTables?: boolean;
+    /** Enable RLS (default: true) */
+    enableRLS?: boolean;
+}
+/**
+ * Preferences API configuration
+ */
+export interface PreferencesApiConfig {
+    /** API route prefix (default: '/preferences') */
+    prefix?: string;
+    /** Enable API endpoints (default: true) */
+    enabled?: boolean;
+}
+/**
+ * Preferences plugin configuration
+ */
+export interface PreferencesPluginConfig {
+    /** Preferences storage backend */
+    store: PreferencesStore;
+    /** Default preferences to merge with stored preferences on read */
+    defaults?: Record<string, unknown>;
+    /** API configuration */
+    api?: PreferencesApiConfig;
+    /** Enable debug logging */
+    debug?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/plugins/preferences/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/plugins/preferences/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,yBAAyB;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,wCAAwC;IACxC,UAAU,EAAE,IAAI,CAAC;IACjB,6CAA6C;IAC7C,UAAU,EAAE,IAAI,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5B;;;OAGG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;IAE7D;;;OAGG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAE/F;;;OAGG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEzC;;OAEG;IACH,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC7C,wFAAwF;IACxF,IAAI,EAAE,OAAO,GAAG,CAAC,MAAM,OAAO,CAAC,CAAC;IAChC,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,iCAAiC;IACjC,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,kCAAkC;IAClC,KAAK,EAAE,gBAAgB,CAAC;IACxB,mEAAmE;IACnE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,wBAAwB;IACxB,GAAG,CAAC,EAAE,oBAAoB,CAAC;IAC3B,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB"}

package/dist/plugins/preferences/types.js

@@ -0,0 +1,10 @@
+/**
+ * Preferences Plugin Types
+ *
+ * Type definitions for user preferences management.
+ * Supports PostgreSQL with Row-Level Security (RLS) for data isolation.
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/plugins/preferences/types.js.map

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

package/dist/plugins/rate-limit/__tests__/rate-limit-plugin.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Rate Limit Plugin Tests
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+export {};
+//# sourceMappingURL=rate-limit-plugin.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit-plugin.test.d.ts","sourceRoot":"","sources":["../../../../src/plugins/rate-limit/__tests__/rate-limit-plugin.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

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":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAM,UAAU,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAEzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,2BAA2B,EAAE,MAAM,iCAAiC,CAAC;AAC9E,OAAO,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAC1E,OAAO,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAE1E,4BAA4B;AAC5B,SAAS,eAAe;IACtB,MAAM,OAAO,GAAG,IAAI,GAAG,EAAuB,CAAC;IAE/C,OAAO;QACL,IAAI,EAAE,MAAM;QAEZ,KAAK,CAAC,UAAU;YACd,QAAQ;QACV,CAAC;QAED,KAAK,CAAC,GAAG,CAAC,GAAW;YACnB,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC;QAClC,CAAC;QAED,KAAK,CAAC,SAAS,CAAC,GAAW,EAAE,OAAyB;YACpD,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;YAClC,MAAM,WAAW,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC;YACzE,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,GAAG,QAAQ,CAAC,CAAC;YAE7D,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAClC,IAAI,QAAQ,IAAI,QAAQ,CAAC,WAAW,CAAC,OAAO,EAAE,KAAK,WAAW,CAAC,OAAO,EAAE,EAAE,CAAC;gBACzE,QAAQ,CAAC,KAAK,IAAI,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC;gBACtC,QAAQ,CAAC,SAAS,GAAG,GAAG,CAAC;gBACzB,OAAO,QAAQ,CAAC;YAClB,CAAC;YAED,MAAM,SAAS,GAAgB;gBAC7B,EAAE,EAAE,QAAQ,IAAI,CAAC,GAAG,EAAE,EAAE;gBACxB,GAAG;gBACH,KAAK,EAAE,OAAO,CAAC,MAAM,IAAI,CAAC;gBAC1B,WAAW,EAAE,OAAO,CAAC,WAAW;gBAChC,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,WAAW;gBACX,SAAS;gBACT,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,SAAS,EAAE,GAAG;gBACd,SAAS,EAAE,GAAG;aACf,CAAC;YACF,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;YAC5B,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,KAAK,CAAC,KAAK,CAAC,GAAW;YACrB,OAAO,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7B,CAAC;QAED,KAAK,CAAC,OAAO;YACX,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACvB,IAAI,OAAO,GAAG,CAAC,CAAC;YAChB,KAAK,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;gBACpC,IAAI,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,GAAG,GAAG,EAAE,CAAC;oBACrC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;oBACpB,OAAO,EAAE,CAAC;gBACZ,CAAC;YACH,CAAC;YACD,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,KAAK,CAAC,QAAQ;YACZ,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,CAAC;KACF,CAAC;AACJ,CAAC;AAED,4BAA4B;AAC5B,SAAS,eAAe;IACtB,MAAM,KAAK,GAAG,IAAI,GAAG,EAAqD,CAAC;IAE3E,OAAO;QACL,IAAI,EAAE,MAAM;QAEZ,KAAK,CAAC,GAAG,CAAC,GAAW;YACnB,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAC7B,IAAI,CAAC,KAAK;gBAAE,OAAO,IAAI,CAAC;YACxB,IAAI,KAAK,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;gBAClC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAClB,OAAO,IAAI,CAAC;YACd,CAAC;YACD,OAAO,KAAK,CAAC,KAAK,CAAC;QACrB,CAAC;QAED,KAAK,CAAC,GAAG,CAAC,GAAW,EAAE,KAAkB,EAAE,KAAa;YACtD,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;QAC3D,CAAC;QAED,KAAK,CAAC,SAAS,CAAC,GAAW,EAAE,MAAM,GAAG,CAAC;YACrC,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAC7B,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE;gBAAE,OAAO,IAAI,CAAC;YACzD,KAAK,CAAC,KAAK,CAAC,KAAK,IAAI,MAAM,CAAC;YAC5B,OAAO,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC;QAC3B,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,GAAW;YACtB,OAAO,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC3B,CAAC;QAED,WAAW;YACT,OAAO,IAAI,CAAC;QACd,CAAC;QAED,KAAK,CAAC,QAAQ;YACZ,KAAK,CAAC,KAAK,EAAE,CAAC;QAChB,CAAC;KACF,CAAC;AACJ,CAAC;AAED,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,IAAI,KAAqB,CAAC;IAC1B,IAAI,KAAqB,CAAC;IAC1B,IAAI,OAAyB,CAAC;IAE9B,UAAU,CAAC,GAAG,EAAE;QACd,KAAK,GAAG,eAAe,EAAE,CAAC;QAC1B,KAAK,GAAG,eAAe,EAAE,CAAC;QAC1B,OAAO,GAAG,IAAI,gBAAgB,CAAC;YAC7B,KAAK;YACL,KAAK;YACL,QAAQ,EAAE;gBACR,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,GAAG;gBAChB,QAAQ,EAAE,gBAAgB;aAC3B;SACF,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,KAAK,IAAI,EAAE;QACnB,MAAM,KAAK,CAAC,QAAQ,EAAE,CAAC;QACvB,MAAM,KAAK,CAAC,QAAQ,EAAE,CAAC;IACzB,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;QAC1B,EAAE,CAAC,6CAA6C,EAAE,KAAK,IAAI,EAAE;YAC3D,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;YAE1E,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACnC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAC/B,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC/B,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,2CAA2C,EAAE,KAAK,IAAI,EAAE;YACzD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,UAAU,EAAE;gBAClD,WAAW,EAAE,EAAE;gBACf,QAAQ,EAAE,KAAK;gBACf,SAAS,EAAE,KAAK;aACjB,CAAC,CAAC;YAEH,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAChC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;QAC9B,EAAE,CAAC,8BAA8B,EAAE,KAAK,IAAI,EAAE;YAC5C,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;YACzD,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAChC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAEnC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;YACzD,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAChC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,wCAAwC,EAAE,KAAK,IAAI,EAAE;YACtD,4BAA4B;YAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC3B,MAAM,OAAO,CAAC,cAAc,CAAC,UAAU,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC,CAAC;YAC/D,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,cAAc,CAAC,UAAU,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC,CAAC;YAC5E,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAClC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;QACzB,EAAE,CAAC,sCAAsC,EAAE,KAAK,IAAI,EAAE;YACpD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;YACpD,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,iCAAiC,EAAE,KAAK,IAAI,EAAE;YAC/C,oBAAoB;YACpB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC3B,MAAM,OAAO,CAAC,cAAc,CAAC,UAAU,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC,CAAC;YAC/D,CAAC;YAED,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,UAAU,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC,CAAC;YACxE,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;QAC1B,EAAE,CAAC,wBAAwB,EAAE,KAAK,IAAI,EAAE;YACtC,qBAAqB;YACrB,MAAM,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;YACzC,MAAM,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;YAEzC,gBAAgB;YAChB,MAAM,YAAY,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;YAChF,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;YAEhD,QAAQ;YACR,MAAM,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;YAErC,iBAAiB;YACjB,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;YAC/E,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACtC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;IAC1B,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;QAC9B,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;YAClD,MAAM,QAAQ,GAAG,2BAA2B,EAAE,CAAC;YAC/C,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;QAC5B,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;YAClD,MAAM,QAAQ,GAAG,yBAAyB,EAAE,CAAC;YAC7C,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC7C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;QAC5B,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;YAClD,MAAM,QAAQ,GAAG,yBAAyB,EAAE,CAAC;YAC7C,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC7C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,OAAO,EAAE,GAAG,EAAE;IACrB,EAAE,CAAC,kCAAkC,EAAE,KAAK,IAAI,EAAE;QAChD,8DAA8D;QAC9D,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;QAC1C,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;IAC9B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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"}