raffel 0.1.2

package/dist/http/events.d.ts

@@ -0,0 +1,251 @@
+/**
+ * API Event Emitter
+ *
+ * Extended EventEmitter with wildcard pattern support and convenience methods
+ * for common API events (requests, auth, errors, etc.)
+ *
+ * @example
+ * import { ApiEventEmitter } from 'raffel/http'
+ *
+ * const events = new ApiEventEmitter()
+ *
+ * // Listen to specific events
+ * events.on('request:start', (data) => console.log('Request started:', data))
+ *
+ * // Listen to wildcard patterns
+ * events.on('request:*', (data) => console.log('Any request event:', data))
+ * events.on('*:error', (data) => console.log('Any error event:', data))
+ *
+ * // Emit events
+ * events.emitRequest('start', { method: 'GET', path: '/api/users' })
+ * events.emitAuth('success', { userId: '123' })
+ */
+import { EventEmitter } from 'events';
+/**
+ * Event listener function
+ */
+export type EventListener<T = unknown> = (data: T) => void | Promise<void>;
+/**
+ * Request event data
+ */
+export interface RequestEventData {
+    requestId?: string;
+    method: string;
+    path: string;
+    query?: Record<string, string>;
+    headers?: Record<string, string>;
+    body?: unknown;
+    ip?: string;
+    userAgent?: string;
+    timestamp?: number;
+    duration?: number;
+    statusCode?: number;
+    error?: Error;
+    [key: string]: unknown;
+}
+/**
+ * Auth event data
+ */
+export interface AuthEventData {
+    userId?: string | number;
+    username?: string;
+    email?: string;
+    role?: string;
+    method?: string;
+    success?: boolean;
+    error?: string;
+    ip?: string;
+    timestamp?: number;
+    [key: string]: unknown;
+}
+/**
+ * Error event data
+ */
+export interface ErrorEventData {
+    error: Error;
+    code?: string;
+    statusCode?: number;
+    requestId?: string;
+    path?: string;
+    method?: string;
+    stack?: string;
+    timestamp?: number;
+    [key: string]: unknown;
+}
+/**
+ * Rate limit event data
+ */
+export interface RateLimitEventData {
+    ip: string;
+    path?: string;
+    limit: number;
+    current: number;
+    resetAt: number;
+    blocked: boolean;
+    [key: string]: unknown;
+}
+/**
+ * Event emitter options
+ */
+export interface ApiEventEmitterOptions {
+    /**
+     * Maximum number of listeners per event
+     * @default 100
+     */
+    maxListeners?: number;
+    /**
+     * Enable wildcard pattern matching
+     * @default true
+     */
+    wildcards?: boolean;
+    /**
+     * Separator for event namespaces
+     * @default ':'
+     */
+    separator?: string;
+}
+/**
+ * Event statistics
+ */
+export interface EventStats {
+    totalEvents: number;
+    totalListeners: number;
+    eventCounts: Record<string, number>;
+    listenerCounts: Record<string, number>;
+}
+/**
+ * Extended EventEmitter with wildcard support and API-specific helpers
+ */
+export declare class ApiEventEmitter extends EventEmitter {
+    private wildcardListeners;
+    private eventCounts;
+    private readonly separator;
+    private readonly wildcardsEnabled;
+    constructor(options?: ApiEventEmitterOptions);
+    /**
+     * Register an event listener with wildcard support
+     *
+     * @param event - Event name (supports wildcards like 'request:*' or '*:error')
+     * @param listener - Event listener function
+     * @returns this
+     *
+     * @example
+     * events.on('request:*', (data) => console.log('Any request event'))
+     * events.on('*:error', (data) => console.log('Any error event'))
+     * events.on('**', (data) => console.log('All events'))
+     */
+    on(event: string | symbol, listener: EventListener): this;
+    /**
+     * Remove an event listener
+     */
+    off(event: string | symbol, listener: EventListener): this;
+    /**
+     * Register a one-time event listener
+     */
+    once(event: string | symbol, listener: EventListener): this;
+    /**
+     * Emit an event with wildcard matching
+     */
+    emit(event: string | symbol, ...args: unknown[]): boolean;
+    /**
+     * Check if a pattern matches an event name
+     */
+    private matchPattern;
+    /**
+     * Emit a request event
+     *
+     * @param type - Event type (start, end, error)
+     * @param data - Request event data
+     *
+     * @example
+     * events.emitRequest('start', { method: 'GET', path: '/api/users' })
+     * events.emitRequest('end', { method: 'GET', path: '/api/users', duration: 50 })
+     * events.emitRequest('error', { method: 'GET', path: '/api/users', error })
+     */
+    emitRequest(type: 'start' | 'end' | 'error', data: RequestEventData): boolean;
+    /**
+     * Emit an auth event
+     *
+     * @param type - Event type (attempt, success, failure, logout)
+     * @param data - Auth event data
+     *
+     * @example
+     * events.emitAuth('success', { userId: '123', method: 'bearer' })
+     * events.emitAuth('failure', { username: 'admin', error: 'Invalid password' })
+     */
+    emitAuth(type: 'attempt' | 'success' | 'failure' | 'logout' | 'refresh', data: AuthEventData): boolean;
+    /**
+     * Emit an error event
+     *
+     * @param type - Error type (validation, internal, notFound, etc.)
+     * @param data - Error event data
+     *
+     * @example
+     * events.emitError('validation', { error, statusCode: 422 })
+     * events.emitError('internal', { error, requestId: '...' })
+     */
+    emitError(type: 'validation' | 'internal' | 'notFound' | 'unauthorized' | 'forbidden' | 'timeout', data: ErrorEventData): boolean;
+    /**
+     * Emit a rate limit event
+     *
+     * @param type - Event type (warning, blocked)
+     * @param data - Rate limit event data
+     */
+    emitRateLimit(type: 'warning' | 'blocked', data: RateLimitEventData): boolean;
+    /**
+     * Emit a lifecycle event
+     *
+     * @param type - Event type (start, ready, shutdown, error)
+     * @param data - Optional data
+     */
+    emitLifecycle(type: 'start' | 'ready' | 'shutdown' | 'error', data?: Record<string, unknown>): boolean;
+    /**
+     * Emit a custom event with namespace
+     *
+     * @param namespace - Event namespace
+     * @param type - Event type
+     * @param data - Event data
+     */
+    emitCustom(namespace: string, type: string, data: unknown): boolean;
+    /**
+     * Listen to request events
+     */
+    onRequest(type: 'start' | 'end' | 'error' | '*', listener: EventListener<RequestEventData>): this;
+    /**
+     * Listen to auth events
+     */
+    onAuth(type: 'attempt' | 'success' | 'failure' | 'logout' | 'refresh' | '*', listener: EventListener<AuthEventData>): this;
+    /**
+     * Listen to error events
+     */
+    onError(type: 'validation' | 'internal' | 'notFound' | 'unauthorized' | 'forbidden' | 'timeout' | '*', listener: EventListener<ErrorEventData>): this;
+    /**
+     * Listen to rate limit events
+     */
+    onRateLimit(type: 'warning' | 'blocked' | '*', listener: EventListener<RateLimitEventData>): this;
+    /**
+     * Listen to lifecycle events
+     */
+    onLifecycle(type: 'start' | 'ready' | 'shutdown' | 'error' | '*', listener: EventListener<Record<string, unknown>>): this;
+    /**
+     * Get event statistics
+     */
+    getStats(): EventStats;
+    /**
+     * Reset event counters
+     */
+    resetStats(): void;
+    /**
+     * Remove all listeners including wildcard listeners
+     */
+    removeAllListeners(event?: string | symbol): this;
+}
+/**
+ * Create a new API event emitter instance
+ *
+ * @param options - Event emitter options
+ * @returns New ApiEventEmitter instance
+ */
+export declare function createEventEmitter(options?: ApiEventEmitterOptions): ApiEventEmitter;
+export default ApiEventEmitter;
+//# sourceMappingURL=events.d.ts.map

package/dist/http/events.d.ts.map

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

package/dist/http/events.js

@@ -0,0 +1,321 @@
+/**
+ * API Event Emitter
+ *
+ * Extended EventEmitter with wildcard pattern support and convenience methods
+ * for common API events (requests, auth, errors, etc.)
+ *
+ * @example
+ * import { ApiEventEmitter } from 'raffel/http'
+ *
+ * const events = new ApiEventEmitter()
+ *
+ * // Listen to specific events
+ * events.on('request:start', (data) => console.log('Request started:', data))
+ *
+ * // Listen to wildcard patterns
+ * events.on('request:*', (data) => console.log('Any request event:', data))
+ * events.on('*:error', (data) => console.log('Any error event:', data))
+ *
+ * // Emit events
+ * events.emitRequest('start', { method: 'GET', path: '/api/users' })
+ * events.emitAuth('success', { userId: '123' })
+ */
+import { EventEmitter } from 'events';
+// ─────────────────────────────────────────────────────────────────────────────
+// API Event Emitter Class
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Extended EventEmitter with wildcard support and API-specific helpers
+ */
+export class ApiEventEmitter extends EventEmitter {
+    wildcardListeners = new Map();
+    eventCounts = new Map();
+    separator;
+    wildcardsEnabled;
+    constructor(options = {}) {
+        super();
+        const { maxListeners = 100, wildcards = true, separator = ':' } = options;
+        this.setMaxListeners(maxListeners);
+        this.wildcardsEnabled = wildcards;
+        this.separator = separator;
+    }
+    // ───────────────────────────────────────────────────────────────────────────
+    // Wildcard Support
+    // ───────────────────────────────────────────────────────────────────────────
+    /**
+     * Register an event listener with wildcard support
+     *
+     * @param event - Event name (supports wildcards like 'request:*' or '*:error')
+     * @param listener - Event listener function
+     * @returns this
+     *
+     * @example
+     * events.on('request:*', (data) => console.log('Any request event'))
+     * events.on('*:error', (data) => console.log('Any error event'))
+     * events.on('**', (data) => console.log('All events'))
+     */
+    on(event, listener) {
+        if (typeof event === 'string' && this.wildcardsEnabled && event.includes('*')) {
+            const pattern = event;
+            if (!this.wildcardListeners.has(pattern)) {
+                this.wildcardListeners.set(pattern, new Set());
+            }
+            this.wildcardListeners.get(pattern).add(listener);
+            return this;
+        }
+        return super.on(event, listener);
+    }
+    /**
+     * Remove an event listener
+     */
+    off(event, listener) {
+        if (typeof event === 'string' && this.wildcardsEnabled && event.includes('*')) {
+            const pattern = event;
+            const listeners = this.wildcardListeners.get(pattern);
+            if (listeners) {
+                listeners.delete(listener);
+                if (listeners.size === 0) {
+                    this.wildcardListeners.delete(pattern);
+                }
+            }
+            return this;
+        }
+        return super.off(event, listener);
+    }
+    /**
+     * Register a one-time event listener
+     */
+    once(event, listener) {
+        if (typeof event === 'string' && this.wildcardsEnabled && event.includes('*')) {
+            const onceWrapper = (data) => {
+                this.off(event, onceWrapper);
+                listener(data);
+            };
+            return this.on(event, onceWrapper);
+        }
+        return super.once(event, listener);
+    }
+    /**
+     * Emit an event with wildcard matching
+     */
+    emit(event, ...args) {
+        const eventName = String(event);
+        // Track event count
+        const count = this.eventCounts.get(eventName) || 0;
+        this.eventCounts.set(eventName, count + 1);
+        // Emit to exact listeners
+        const hasListeners = super.emit(event, ...args);
+        // Emit to wildcard listeners
+        if (this.wildcardsEnabled) {
+            for (const [pattern, listeners] of this.wildcardListeners) {
+                if (this.matchPattern(eventName, pattern)) {
+                    for (const listener of listeners) {
+                        try {
+                            listener(args[0]);
+                        }
+                        catch (err) {
+                            // Emit error event if listener throws
+                            if (event !== 'error') {
+                                this.emit('error', err);
+                            }
+                        }
+                    }
+                }
+            }
+        }
+        return hasListeners || this.wildcardListeners.size > 0;
+    }
+    /**
+     * Check if a pattern matches an event name
+     */
+    matchPattern(eventName, pattern) {
+        // ** matches everything
+        if (pattern === '**')
+            return true;
+        const eventParts = eventName.split(this.separator);
+        const patternParts = pattern.split(this.separator);
+        if (eventParts.length !== patternParts.length)
+            return false;
+        for (let i = 0; i < patternParts.length; i++) {
+            if (patternParts[i] !== '*' && patternParts[i] !== eventParts[i]) {
+                return false;
+            }
+        }
+        return true;
+    }
+    // ───────────────────────────────────────────────────────────────────────────
+    // Convenience Emit Methods
+    // ───────────────────────────────────────────────────────────────────────────
+    /**
+     * Emit a request event
+     *
+     * @param type - Event type (start, end, error)
+     * @param data - Request event data
+     *
+     * @example
+     * events.emitRequest('start', { method: 'GET', path: '/api/users' })
+     * events.emitRequest('end', { method: 'GET', path: '/api/users', duration: 50 })
+     * events.emitRequest('error', { method: 'GET', path: '/api/users', error })
+     */
+    emitRequest(type, data) {
+        return this.emit(`request:${type}`, {
+            ...data,
+            timestamp: data.timestamp || Date.now(),
+        });
+    }
+    /**
+     * Emit an auth event
+     *
+     * @param type - Event type (attempt, success, failure, logout)
+     * @param data - Auth event data
+     *
+     * @example
+     * events.emitAuth('success', { userId: '123', method: 'bearer' })
+     * events.emitAuth('failure', { username: 'admin', error: 'Invalid password' })
+     */
+    emitAuth(type, data) {
+        return this.emit(`auth:${type}`, {
+            ...data,
+            timestamp: data.timestamp || Date.now(),
+        });
+    }
+    /**
+     * Emit an error event
+     *
+     * @param type - Error type (validation, internal, notFound, etc.)
+     * @param data - Error event data
+     *
+     * @example
+     * events.emitError('validation', { error, statusCode: 422 })
+     * events.emitError('internal', { error, requestId: '...' })
+     */
+    emitError(type, data) {
+        return this.emit(`error:${type}`, {
+            ...data,
+            stack: data.error.stack,
+            timestamp: data.timestamp || Date.now(),
+        });
+    }
+    /**
+     * Emit a rate limit event
+     *
+     * @param type - Event type (warning, blocked)
+     * @param data - Rate limit event data
+     */
+    emitRateLimit(type, data) {
+        return this.emit(`rateLimit:${type}`, data);
+    }
+    /**
+     * Emit a lifecycle event
+     *
+     * @param type - Event type (start, ready, shutdown, error)
+     * @param data - Optional data
+     */
+    emitLifecycle(type, data) {
+        return this.emit(`lifecycle:${type}`, {
+            ...data,
+            timestamp: Date.now(),
+        });
+    }
+    /**
+     * Emit a custom event with namespace
+     *
+     * @param namespace - Event namespace
+     * @param type - Event type
+     * @param data - Event data
+     */
+    emitCustom(namespace, type, data) {
+        return this.emit(`${namespace}:${type}`, data);
+    }
+    // ───────────────────────────────────────────────────────────────────────────
+    // Convenience On Methods
+    // ───────────────────────────────────────────────────────────────────────────
+    /**
+     * Listen to request events
+     */
+    onRequest(type, listener) {
+        return this.on(`request:${type}`, listener);
+    }
+    /**
+     * Listen to auth events
+     */
+    onAuth(type, listener) {
+        return this.on(`auth:${type}`, listener);
+    }
+    /**
+     * Listen to error events
+     */
+    onError(type, listener) {
+        return this.on(`error:${type}`, listener);
+    }
+    /**
+     * Listen to rate limit events
+     */
+    onRateLimit(type, listener) {
+        return this.on(`rateLimit:${type}`, listener);
+    }
+    /**
+     * Listen to lifecycle events
+     */
+    onLifecycle(type, listener) {
+        return this.on(`lifecycle:${type}`, listener);
+    }
+    // ───────────────────────────────────────────────────────────────────────────
+    // Statistics
+    // ───────────────────────────────────────────────────────────────────────────
+    /**
+     * Get event statistics
+     */
+    getStats() {
+        const listenerCounts = {};
+        // Count regular listeners
+        for (const eventName of this.eventNames()) {
+            listenerCounts[String(eventName)] = this.listenerCount(eventName);
+        }
+        // Count wildcard listeners
+        for (const [pattern, listeners] of this.wildcardListeners) {
+            listenerCounts[pattern] = listeners.size;
+        }
+        return {
+            totalEvents: Array.from(this.eventCounts.values()).reduce((a, b) => a + b, 0),
+            totalListeners: Object.values(listenerCounts).reduce((a, b) => a + b, 0),
+            eventCounts: Object.fromEntries(this.eventCounts),
+            listenerCounts,
+        };
+    }
+    /**
+     * Reset event counters
+     */
+    resetStats() {
+        this.eventCounts.clear();
+    }
+    /**
+     * Remove all listeners including wildcard listeners
+     */
+    removeAllListeners(event) {
+        if (event === undefined) {
+            this.wildcardListeners.clear();
+        }
+        else if (typeof event === 'string' && event.includes('*')) {
+            this.wildcardListeners.delete(event);
+        }
+        return super.removeAllListeners(event);
+    }
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Factory Function
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Create a new API event emitter instance
+ *
+ * @param options - Event emitter options
+ * @returns New ApiEventEmitter instance
+ */
+export function createEventEmitter(options) {
+    return new ApiEventEmitter(options);
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Exports
+// ─────────────────────────────────────────────────────────────────────────────
+export default ApiEventEmitter;
+//# sourceMappingURL=events.js.map

package/dist/http/events.js.map

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