@aiconnect/confidant 1.0.0

package/dist/rate-limiter.test.js

@@ -0,0 +1,130 @@
+/**
+ * Tests for rate limiter
+ */
+import { describe, it, expect, beforeEach } from 'vitest';
+import { RateLimiter } from './rate-limiter.js';
+describe('RateLimiter', () => {
+    let rateLimiter;
+    beforeEach(() => {
+        rateLimiter = new RateLimiter({
+            maxRequests: 5,
+            windowMs: 1000
+        });
+    });
+    describe('check', () => {
+        it('should allow requests within the limit', () => {
+            const result1 = rateLimiter.check('127.0.0.1');
+            const result2 = rateLimiter.check('127.0.0.1');
+            const result3 = rateLimiter.check('127.0.0.1');
+            expect(result1.allowed).toBe(true);
+            expect(result1.remaining).toBe(4);
+            expect(result2.allowed).toBe(true);
+            expect(result2.remaining).toBe(3);
+            expect(result3.allowed).toBe(true);
+            expect(result3.remaining).toBe(2);
+        });
+        it('should block requests exceeding the limit', () => {
+            // Make 5 requests (within limit)
+            for (let i = 0; i < 5; i++) {
+                const result = rateLimiter.check('127.0.0.1');
+                expect(result.allowed).toBe(true);
+            }
+            // 6th request should be blocked
+            const result = rateLimiter.check('127.0.0.1');
+            expect(result.allowed).toBe(false);
+            expect(result.remaining).toBe(0);
+        });
+        it('should track requests separately for different IPs', () => {
+            // Make 5 requests from IP1
+            for (let i = 0; i < 5; i++) {
+                rateLimiter.check('127.0.0.1');
+            }
+            // IP1 should be blocked
+            const result1 = rateLimiter.check('127.0.0.1');
+            expect(result1.allowed).toBe(false);
+            // IP2 should still be allowed
+            const result2 = rateLimiter.check('192.168.1.1');
+            expect(result2.allowed).toBe(true);
+        });
+        it('should reset the window after it expires', async () => {
+            // Make 5 requests (within limit)
+            for (let i = 0; i < 5; i++) {
+                rateLimiter.check('127.0.0.1');
+            }
+            // 6th request should be blocked
+            let result = rateLimiter.check('127.0.0.1');
+            expect(result.allowed).toBe(false);
+            // Wait for window to expire
+            await new Promise(resolve => setTimeout(resolve, 1100));
+            // Should be allowed again
+            result = rateLimiter.check('127.0.0.1');
+            expect(result.allowed).toBe(true);
+            expect(result.remaining).toBe(4);
+        });
+        it('should provide correct reset time', () => {
+            const result = rateLimiter.check('127.0.0.1');
+            const now = Date.now();
+            expect(result.resetTime).toBeGreaterThan(now);
+            expect(result.resetTime).toBeLessThanOrEqual(now + 1000);
+        });
+    });
+    describe('reset', () => {
+        it('should reset the rate limit for a specific IP', () => {
+            // Make 5 requests (within limit)
+            for (let i = 0; i < 5; i++) {
+                rateLimiter.check('127.0.0.1');
+            }
+            // 6th request should be blocked
+            let result = rateLimiter.check('127.0.0.1');
+            expect(result.allowed).toBe(false);
+            // Reset the IP
+            rateLimiter.reset('127.0.0.1');
+            // Should be allowed again
+            result = rateLimiter.check('127.0.0.1');
+            expect(result.allowed).toBe(true);
+        });
+    });
+    describe('cleanup', () => {
+        it('should remove old records', async () => {
+            // Make requests from two IPs
+            rateLimiter.check('127.0.0.1');
+            rateLimiter.check('192.168.1.1');
+            // Wait for records to become old
+            await new Promise(resolve => setTimeout(resolve, 100));
+            // Cleanup with max age of 50ms
+            rateLimiter.cleanup(50);
+            // Both records should be removed (old enough)
+            const status1 = rateLimiter.getStatus('127.0.0.1');
+            const status2 = rateLimiter.getStatus('192.168.1.1');
+            expect(status1.remaining).toBe(5); // Reset to full limit
+            expect(status2.remaining).toBe(5); // Reset to full limit
+        });
+    });
+    describe('getStatus', () => {
+        it('should return status without incrementing count', () => {
+            const status1 = rateLimiter.getStatus('127.0.0.1');
+            expect(status1.allowed).toBe(true);
+            expect(status1.remaining).toBe(5);
+            const status2 = rateLimiter.getStatus('127.0.0.1');
+            expect(status2.allowed).toBe(true);
+            expect(status2.remaining).toBe(5); // Still 5, not decremented
+        });
+        it('should return correct status for IPs that have made requests', () => {
+            rateLimiter.check('127.0.0.1');
+            rateLimiter.check('127.0.0.1');
+            const status = rateLimiter.getStatus('127.0.0.1');
+            expect(status.allowed).toBe(true);
+            expect(status.remaining).toBe(3);
+        });
+        it('should return not allowed for IPs that have exceeded the limit', () => {
+            // Make 5 requests (within limit)
+            for (let i = 0; i < 5; i++) {
+                rateLimiter.check('127.0.0.1');
+            }
+            const status = rateLimiter.getStatus('127.0.0.1');
+            expect(status.allowed).toBe(false);
+            expect(status.remaining).toBe(0);
+        });
+    });
+});
+//# sourceMappingURL=rate-limiter.test.js.map

package/dist/rate-limiter.test.js.map

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

package/dist/registry.d.ts

@@ -0,0 +1,136 @@
+/**
+ * Modular Registry System
+ *
+ * A generic, type-safe registry system for managing components/modules.
+ * Enables dynamic registration, retrieval, and lifecycle management of modules.
+ */
+/**
+ * Base Module interface with optional lifecycle hooks
+ * All modules must implement this interface to be registered in a registry.
+ */
+export interface Module {
+    /** Unique identifier for the module */
+    name: string;
+    /** Optional initialization hook called when module is registered */
+    init?(): Promise<void> | void;
+    /** Optional cleanup hook called when module is unregistered */
+    destroy?(): Promise<void> | void;
+}
+/**
+ * Generic Registry class for managing modules
+ * @template T - The module type (must extend Module)
+ */
+export declare class Registry<T extends Module> {
+    private modules;
+    /**
+     * Registers a module with the given name
+     * @param name - Unique identifier for the module
+     * @param module - Module instance to register
+     * @throws Error if a module with the same name is already registered
+     */
+    register(name: string, module: T): Promise<void>;
+    /**
+     * Unregisters a module by name
+     * @param name - Name of the module to unregister
+     * @throws Error if module is not found
+     */
+    unregister(name: string): Promise<void>;
+    /**
+     * Retrieves a registered module by name
+     * @param name - Name of the module to retrieve
+     * @returns Module instance if found, undefined otherwise
+     */
+    get(name: string): T | undefined;
+    /**
+     * Checks if a module is registered
+     * @param name - Name of the module to check
+     * @returns true if module is registered, false otherwise
+     */
+    has(name: string): boolean;
+    /**
+     * Returns list of all registered module names
+     * @returns Array of module names
+     */
+    list(): string[];
+    /**
+     * Clears all registered modules
+     * Calls destroy hook on all modules if present
+     */
+    clear(): Promise<void>;
+}
+/**
+ * Storage Module interface for storage backends
+ */
+export interface StorageModule extends Module {
+    /** Retrieve a value by key */
+    get(key: string): Promise<any>;
+    /** Set a value with optional TTL */
+    set(key: string, value: any, ttl?: number): Promise<void>;
+    /** Delete a value by key */
+    delete(key: string): Promise<void>;
+}
+/**
+ * Validator Module interface for data validation
+ */
+export interface ValidatorModule extends Module {
+    /** Validate data and return true if valid */
+    validate(data: any): boolean | Promise<boolean>;
+    /** Get validation errors */
+    getErrors(): string[];
+}
+/**
+ * Transformer Module interface for data transformation
+ */
+export interface TransformerModule extends Module {
+    /** Transform data and return the result */
+    transform(data: any): any | Promise<any>;
+}
+/**
+ * Singleton registry instances for different module types
+ */
+/**
+ * Registry for storage modules
+ */
+export declare const storageRegistry: Registry<StorageModule>;
+/**
+ * Registry for validator modules
+ */
+export declare const validatorRegistry: Registry<ValidatorModule>;
+/**
+ * Registry for transformer modules
+ */
+export declare const transformerRegistry: Registry<TransformerModule>;
+/**
+ * Example: Memory Storage Module
+ * Simple in-memory storage implementation for demonstration
+ */
+declare class MemoryStorageModuleImpl implements StorageModule {
+    name: string;
+    private storage;
+    init(): Promise<void>;
+    destroy(): Promise<void>;
+    get(key: string): Promise<any>;
+    set(key: string, value: any, ttl?: number): Promise<void>;
+    delete(key: string): Promise<void>;
+}
+export declare const MemoryStorageModule: MemoryStorageModuleImpl;
+/**
+ * Example: Basic Validator Module
+ * Simple validator that checks if data is not empty
+ */
+declare class BasicValidatorModuleImpl implements ValidatorModule {
+    name: string;
+    private errors;
+    init(): Promise<void>;
+    destroy(): Promise<void>;
+    validate(data: any): boolean;
+    getErrors(): string[];
+}
+export declare const BasicValidatorModule: BasicValidatorModuleImpl;
+/**
+ * Example: Uppercase Transformer Module
+ * Transforms strings to uppercase
+ */
+export declare const UppercaseTransformerModule: TransformerModule;
+export {};
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

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

package/dist/registry.js

@@ -0,0 +1,182 @@
+/**
+ * Modular Registry System
+ *
+ * A generic, type-safe registry system for managing components/modules.
+ * Enables dynamic registration, retrieval, and lifecycle management of modules.
+ */
+/**
+ * Generic Registry class for managing modules
+ * @template T - The module type (must extend Module)
+ */
+export class Registry {
+    modules = new Map();
+    /**
+     * Registers a module with the given name
+     * @param name - Unique identifier for the module
+     * @param module - Module instance to register
+     * @throws Error if a module with the same name is already registered
+     */
+    async register(name, module) {
+        if (this.modules.has(name)) {
+            throw new Error(`Module with name '${name}' is already registered`);
+        }
+        // Call init hook if present
+        if (module.init) {
+            await module.init();
+        }
+        this.modules.set(name, module);
+    }
+    /**
+     * Unregisters a module by name
+     * @param name - Name of the module to unregister
+     * @throws Error if module is not found
+     */
+    async unregister(name) {
+        const module = this.modules.get(name);
+        if (!module) {
+            throw new Error(`Module '${name}' not found`);
+        }
+        // Call destroy hook if present
+        if (module.destroy) {
+            await module.destroy();
+        }
+        this.modules.delete(name);
+    }
+    /**
+     * Retrieves a registered module by name
+     * @param name - Name of the module to retrieve
+     * @returns Module instance if found, undefined otherwise
+     */
+    get(name) {
+        return this.modules.get(name);
+    }
+    /**
+     * Checks if a module is registered
+     * @param name - Name of the module to check
+     * @returns true if module is registered, false otherwise
+     */
+    has(name) {
+        return this.modules.has(name);
+    }
+    /**
+     * Returns list of all registered module names
+     * @returns Array of module names
+     */
+    list() {
+        return Array.from(this.modules.keys());
+    }
+    /**
+     * Clears all registered modules
+     * Calls destroy hook on all modules if present
+     */
+    async clear() {
+        const promises = Array.from(this.modules.values()).map(async (module) => {
+            if (module.destroy) {
+                await module.destroy();
+            }
+        });
+        await Promise.all(promises);
+        this.modules.clear();
+    }
+}
+/**
+ * Singleton registry instances for different module types
+ */
+/**
+ * Registry for storage modules
+ */
+export const storageRegistry = new Registry();
+/**
+ * Registry for validator modules
+ */
+export const validatorRegistry = new Registry();
+/**
+ * Registry for transformer modules
+ */
+export const transformerRegistry = new Registry();
+/**
+ * Example: Memory Storage Module
+ * Simple in-memory storage implementation for demonstration
+ */
+class MemoryStorageModuleImpl {
+    name = 'memory-storage';
+    storage = new Map();
+    async init() {
+        console.log('MemoryStorageModule initialized');
+    }
+    async destroy() {
+        this.storage.clear();
+        console.log('MemoryStorageModule destroyed');
+    }
+    async get(key) {
+        const entry = this.storage.get(key);
+        if (!entry) {
+            return undefined;
+        }
+        // Check if expired
+        if (entry.expiresAt && Date.now() > entry.expiresAt) {
+            this.storage.delete(key);
+            return undefined;
+        }
+        return entry.value;
+    }
+    async set(key, value, ttl) {
+        const expiresAt = ttl ? Date.now() + ttl : undefined;
+        this.storage.set(key, { value, expiresAt });
+    }
+    async delete(key) {
+        this.storage.delete(key);
+    }
+}
+export const MemoryStorageModule = new MemoryStorageModuleImpl();
+/**
+ * Example: Basic Validator Module
+ * Simple validator that checks if data is not empty
+ */
+class BasicValidatorModuleImpl {
+    name = 'basic-validator';
+    errors = [];
+    async init() {
+        console.log('BasicValidatorModule initialized');
+    }
+    async destroy() {
+        this.errors = [];
+        console.log('BasicValidatorModule destroyed');
+    }
+    validate(data) {
+        this.errors = [];
+        if (data === null || data === undefined) {
+            this.errors.push('Data cannot be null or undefined');
+            return false;
+        }
+        if (typeof data === 'string' && data.trim() === '') {
+            this.errors.push('String cannot be empty');
+            return false;
+        }
+        return true;
+    }
+    getErrors() {
+        return [...this.errors];
+    }
+}
+export const BasicValidatorModule = new BasicValidatorModuleImpl();
+/**
+ * Example: Uppercase Transformer Module
+ * Transforms strings to uppercase
+ */
+export const UppercaseTransformerModule = {
+    name: 'uppercase-transformer',
+    async init() {
+        console.log('UppercaseTransformerModule initialized');
+    },
+    async destroy() {
+        console.log('UppercaseTransformerModule destroyed');
+    },
+    transform(data) {
+        if (typeof data === 'string') {
+            return data.toUpperCase();
+        }
+        return data;
+    }
+};
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

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

package/dist/registry.test.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Registry System Tests
+ *
+ * Tests for the generic registry system including:
+ * - Basic registry operations
+ * - Register/unregister functionality
+ * - Get/has/list methods
+ * - Lifecycle hooks (init/destroy)
+ * - Error handling
+ * - Typed registry instances
+ */
+export {};
+//# sourceMappingURL=registry.test.d.ts.map

package/dist/registry.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.test.d.ts","sourceRoot":"","sources":["../src/registry.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}