@designofadecade/server 4.0.0

package/dist/docs/OpenApiGenerator.js

@@ -0,0 +1,165 @@
+/**
+ * OpenAPI/Swagger Documentation Generator
+ *
+ * This utility helps generate OpenAPI 3.0 documentation for your API routes.
+ *
+ * Installation:
+ * ```bash
+ * npm install --save-dev swagger-jsdoc swagger-ui-dist
+ * ```
+ *
+ * Usage:
+ * ```typescript
+ * import { OpenApiGenerator } from '@designofadecade/server';
+ *
+ * const generator = new OpenApiGenerator({
+ *   title: 'My API',
+ *   version: '1.0.0',
+ *   description: 'My API description'
+ * });
+ *
+ * // Add route documentation
+ * generator.addRoute({
+ *   path: '/api/users',
+ *   method: 'GET',
+ *   summary: 'Get all users',
+ *   responses: {
+ *     200: { description: 'Success', schema: { type: 'array' } }
+ *   }
+ * });
+ *
+ * // Generate OpenAPI spec
+ * const spec = generator.generate();
+ * ```
+ */
+export class OpenApiGenerator {
+    config;
+    routes = [];
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Add a route to the OpenAPI documentation
+     */
+    addRoute(route) {
+        this.routes.push(route);
+    }
+    /**
+     * Add multiple routes at once
+     */
+    addRoutes(routes) {
+        this.routes.push(...routes);
+    }
+    /**
+     * Generate the complete OpenAPI specification
+     */
+    generate() {
+        const paths = {};
+        // Group routes by path
+        for (const route of this.routes) {
+            if (!paths[route.path]) {
+                paths[route.path] = {};
+            }
+            const pathItem = paths[route.path];
+            const method = route.method.toLowerCase();
+            pathItem[method] = {
+                summary: route.summary,
+                description: route.description,
+                operationId: route.operationId,
+                tags: route.tags,
+                parameters: route.parameters,
+                requestBody: route.requestBody,
+                responses: route.responses,
+                security: route.security,
+            };
+        }
+        return {
+            openapi: '3.0.0',
+            info: this.config.info,
+            servers: this.config.servers || [],
+            tags: this.config.tags || [],
+            paths,
+            components: this.config.components || {},
+        };
+    }
+    /**
+     * Generate OpenAPI spec as JSON string
+     */
+    toJSON() {
+        return JSON.stringify(this.generate(), null, 2);
+    }
+    /**
+     * Generate OpenAPI spec as YAML string (basic implementation)
+     */
+    toYAML() {
+        const spec = this.generate();
+        // Basic YAML conversion - for production use a proper YAML library
+        return this.objectToYaml(spec, 0);
+    }
+    objectToYaml(obj, indent) {
+        const spaces = '  '.repeat(indent);
+        let yaml = '';
+        if (typeof obj === 'object' && obj !== null) {
+            if (Array.isArray(obj)) {
+                for (const item of obj) {
+                    yaml += `${spaces}- ${this.objectToYaml(item, indent + 1)}\n`;
+                }
+            }
+            else {
+                for (const [key, value] of Object.entries(obj)) {
+                    if (value === undefined)
+                        continue;
+                    if (typeof value === 'object' && value !== null) {
+                        yaml += `${spaces}${key}:\n`;
+                        yaml += this.objectToYaml(value, indent + 1);
+                    }
+                    else if (typeof value === 'string') {
+                        yaml += `${spaces}${key}: "${value}"\n`;
+                    }
+                    else {
+                        yaml += `${spaces}${key}: ${value}\n`;
+                    }
+                }
+            }
+        }
+        else {
+            yaml = String(obj);
+        }
+        return yaml;
+    }
+}
+/**
+ * Helper function to create Swagger UI HTML page
+ */
+export function generateSwaggerUI(specUrl) {
+    const specConfig = typeof specUrl === 'string' ? `url: "${specUrl}"` : `spec: ${JSON.stringify(specUrl)}`;
+    return `<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>API Documentation</title>
+    <link rel="stylesheet" href="https://unpkg.com/swagger-ui-dist@5.10.0/swagger-ui.css">
+</head>
+<body>
+    <div id="swagger-ui"></div>
+    <script src="https://unpkg.com/swagger-ui-dist@5.10.0/swagger-ui-bundle.js"></script>
+    <script src="https://unpkg.com/swagger-ui-dist@5.10.0/swagger-ui-standalone-preset.js"></script>
+    <script>
+        window.onload = function() {
+            SwaggerUIBundle({
+                ${specConfig},
+                dom_id: '#swagger-ui',
+                deepLinking: true,
+                presets: [
+                    SwaggerUIBundle.presets.apis,
+                    SwaggerUIStandalonePreset
+                ],
+                layout: "StandaloneLayout"
+            });
+        };
+    </script>
+</body>
+</html>`;
+}
+//# sourceMappingURL=OpenApiGenerator.js.map

package/dist/docs/OpenApiGenerator.js.map

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

package/dist/events/Events.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Event handler registration for EventsManager
+ *
+ * Abstract base class for organizing event handlers. Extend this class
+ * to group related WebSocket event handlers together and register them
+ * with the EventsManager.
+ *
+ * @class Events
+ * @example
+ * class ChatEvents extends Events {
+ *     constructor(manager: EventsManager) {
+ *         super(manager);
+ *
+ *         this.addListener('chat:message', async (msg) => {
+ *             console.log('Received message:', msg.payload);
+ *             manager.broadcast('chat:new', msg.payload);
+ *         });
+ *     }
+ * }
+ *
+ * // Register with EventsManager
+ * const eventsManager = new EventsManager({
+ *     registerWebSocketServer: wss,
+ *     initEvents: [ChatEvents]
+ * });
+ */
+interface EventRegistration {
+    type: string;
+    handler: (parsedMessage: any) => void | Promise<void>;
+}
+export default class Events {
+    #private;
+    /**
+     * Array of nested event classes to register
+     * @type {Array}
+     */
+    static register: (new (manager: any) => Events)[];
+    constructor(manager: any);
+    get managerEvents(): EventRegistration[];
+    /**
+     * Returns the events manager instance
+     */
+    get manager(): any;
+    /**
+     * Adds an event listener
+     * @param {string} type - Event type to listen for
+     * @param {Function} handler - Handler function to execute
+     */
+    addListener(type: string, handler: (parsedMessage: any) => void | Promise<void>): void;
+}
+export {};
+//# sourceMappingURL=Events.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Events.d.ts","sourceRoot":"","sources":["../../src/events/Events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,UAAU,iBAAiB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,CAAC,aAAa,EAAE,GAAG,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvD;AAED,MAAM,CAAC,OAAO,OAAO,MAAM;;IACzB;;;OAGG;IACH,MAAM,CAAC,QAAQ,EAAE,CAAC,KAAK,OAAO,EAAE,GAAG,KAAK,MAAM,CAAC,EAAE,CAAM;gBAK3C,OAAO,EAAE,GAAG;IAWxB,IAAI,aAAa,IAAI,iBAAiB,EAAE,CAEvC;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,GAAG,CAEjB;IAED;;;;OAIG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,aAAa,EAAE,GAAG,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;CAevF"}

package/dist/events/Events.js

@@ -0,0 +1,70 @@
+/**
+ * Event handler registration for EventsManager
+ *
+ * Abstract base class for organizing event handlers. Extend this class
+ * to group related WebSocket event handlers together and register them
+ * with the EventsManager.
+ *
+ * @class Events
+ * @example
+ * class ChatEvents extends Events {
+ *     constructor(manager: EventsManager) {
+ *         super(manager);
+ *
+ *         this.addListener('chat:message', async (msg) => {
+ *             console.log('Received message:', msg.payload);
+ *             manager.broadcast('chat:new', msg.payload);
+ *         });
+ *     }
+ * }
+ *
+ * // Register with EventsManager
+ * const eventsManager = new EventsManager({
+ *     registerWebSocketServer: wss,
+ *     initEvents: [ChatEvents]
+ * });
+ */
+export default class Events {
+    /**
+     * Array of nested event classes to register
+     * @type {Array}
+     */
+    static register = [];
+    #managerEvents = [];
+    #manager;
+    constructor(manager) {
+        this.#manager = manager;
+        this.constructor.register.forEach((EventsClass) => {
+            const events = new EventsClass(manager);
+            this.#managerEvents.push(...events.managerEvents);
+        });
+    }
+    get managerEvents() {
+        return this.#managerEvents;
+    }
+    /**
+     * Returns the events manager instance
+     */
+    get manager() {
+        return this.#manager;
+    }
+    /**
+     * Adds an event listener
+     * @param {string} type - Event type to listen for
+     * @param {Function} handler - Handler function to execute
+     */
+    addListener(type, handler) {
+        // Validate inputs
+        if (typeof type !== 'string' || !type.trim()) {
+            throw new Error('Event type must be a non-empty string');
+        }
+        if (typeof handler !== 'function') {
+            throw new Error('Handler must be a function');
+        }
+        this.#managerEvents.push({
+            type,
+            handler,
+        });
+    }
+}
+//# sourceMappingURL=Events.js.map

package/dist/events/Events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Events.js","sourceRoot":"","sources":["../../src/events/Events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAOH,MAAM,CAAC,OAAO,OAAO,MAAM;IACzB;;;OAGG;IACH,MAAM,CAAC,QAAQ,GAAqC,EAAE,CAAC;IAEvD,cAAc,GAAwB,EAAE,CAAC;IACzC,QAAQ,CAAM;IAEd,YAAY,OAAY;QACtB,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;QAEvB,IAAI,CAAC,WAA6B,CAAC,QAAQ,CAAC,OAAO,CAClD,CAAC,WAAyC,EAAE,EAAE;YAC5C,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,OAAO,CAAC,CAAC;YACxC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC;QACpD,CAAC,CACF,CAAC;IACJ,CAAC;IAED,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED;;;;OAIG;IACH,WAAW,CAAC,IAAY,EAAE,OAAqD;QAC7E,kBAAkB;QAClB,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;YAC7C,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;QAC3D,CAAC;QAED,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAChD,CAAC;QAED,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC;YACvB,IAAI;YACJ,OAAO;SACR,CAAC,CAAC;IACL,CAAC"}

package/dist/events/EventsManager.d.ts

@@ -0,0 +1,46 @@
+/**
+ * WebSocket event management system
+ *
+ * Manages WebSocket event handlers and message broadcasting.
+ * Integrates with WebSocketServer to handle incoming messages
+ * and provides organized event handling through Events classes.
+ *
+ * @class EventsManager
+ * @example
+ * const eventsManager = new EventsManager({
+ *     registerWebSocketServer: wss,
+ *     initEvents: [UserEvents, ChatEvents]
+ * });
+ *
+ * // Broadcast to all connected clients
+ * eventsManager.broadcast('notification', { message: 'Hello!' });
+ *
+ * @example
+ * // Register individual events
+ * eventsManager.registerEvents([
+ *     { type: 'ping', handler: async (msg) => console.log('Ping!') },
+ *     { type: 'update', handler: async (msg) => handleUpdate(msg) }
+ * ]);
+ */
+import type Events from './Events.js';
+interface ParsedMessage {
+    id?: string;
+    type: string;
+    payload: any;
+}
+interface EventsManagerOptions {
+    registerWebSocketServer?: any;
+    initEvents?: (new (manager: EventsManager) => Events)[];
+}
+export default class EventsManager {
+    #private;
+    constructor({ registerWebSocketServer, initEvents }?: EventsManagerOptions);
+    registerEvents(events: {
+        type: string;
+        handler: (parsedMessage: ParsedMessage) => void | Promise<void>;
+    }[]): void;
+    broadcast(type: string, message: any): void;
+    close(): void;
+}
+export {};
+//# sourceMappingURL=EventsManager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"EventsManager.d.ts","sourceRoot":"","sources":["../../src/events/EventsManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAIH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AAEtC,UAAU,aAAa;IACrB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,GAAG,CAAC;CACd;AAED,UAAU,oBAAoB;IAC5B,uBAAuB,CAAC,EAAE,GAAG,CAAC;IAC9B,UAAU,CAAC,EAAE,CAAC,KAAK,OAAO,EAAE,aAAa,KAAK,MAAM,CAAC,EAAE,CAAC;CACzD;AAED,MAAM,CAAC,OAAO,OAAO,aAAa;;gBAKpB,EAAE,uBAA8B,EAAE,UAAe,EAAE,GAAE,oBAAyB;IAS1F,cAAc,CACZ,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,CAAC,aAAa,EAAE,aAAa,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,EAAE,GAC1F,IAAI;IAwBP,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,IAAI;IA8E3C,KAAK,IAAI,IAAI;CAUd"}

package/dist/events/EventsManager.js

@@ -0,0 +1,137 @@
+/**
+ * WebSocket event management system
+ *
+ * Manages WebSocket event handlers and message broadcasting.
+ * Integrates with WebSocketServer to handle incoming messages
+ * and provides organized event handling through Events classes.
+ *
+ * @class EventsManager
+ * @example
+ * const eventsManager = new EventsManager({
+ *     registerWebSocketServer: wss,
+ *     initEvents: [UserEvents, ChatEvents]
+ * });
+ *
+ * // Broadcast to all connected clients
+ * eventsManager.broadcast('notification', { message: 'Hello!' });
+ *
+ * @example
+ * // Register individual events
+ * eventsManager.registerEvents([
+ *     { type: 'ping', handler: async (msg) => console.log('Ping!') },
+ *     { type: 'update', handler: async (msg) => handleUpdate(msg) }
+ * ]);
+ */
+import WebSocketMessageFormatter from '../websocket/WebSocketMessageFormatter.js';
+import { logger } from '../logger/Logger.js';
+export default class EventsManager {
+    #wss;
+    #events = new Map();
+    #messageListener = null;
+    constructor({ registerWebSocketServer = null, initEvents = [] } = {}) {
+        if (Array.isArray(initEvents) && initEvents.length > 0)
+            this.registerEvents(initEvents.map((EventClass) => new EventClass(this).managerEvents).flat());
+        if (registerWebSocketServer)
+            this.#registerWebSocketServer(registerWebSocketServer);
+    }
+    registerEvents(events) {
+        if (!Array.isArray(events)) {
+            throw new Error('Events must be an array');
+        }
+        events.forEach((event) => {
+            // Validate event structure
+            if (!event || !event.type || typeof event.handler !== 'function') {
+                logger.warn('Invalid event registration', {
+                    code: 'EVENT_INVALID_REGISTRATION',
+                    source: 'EventsManager.registerEvents',
+                    event,
+                });
+                return;
+            }
+            if (!this.#events.has(event.type)) {
+                this.#events.set(event.type, []);
+            }
+            this.#events.get(event.type).push(event.handler);
+        });
+    }
+    broadcast(type, message) {
+        if (!this.#wss) {
+            logger.warn('Cannot broadcast: WebSocket server not registered', {
+                code: 'EVENT_NO_WEBSOCKET',
+                source: 'EventsManager.broadcast',
+                messageType: type,
+            });
+            return;
+        }
+        if (typeof type !== 'string') {
+            throw new Error('Broadcast type must be a string');
+        }
+        try {
+            this.#wss.broadcast(WebSocketMessageFormatter.format(type, message));
+        }
+        catch (error) {
+            logger.error('Broadcast error', {
+                code: 'EVENT_BROADCAST_ERROR',
+                source: 'EventsManager.broadcast',
+                messageType: type,
+                error,
+            });
+        }
+    }
+    #registerWebSocketServer(wss) {
+        this.#wss = wss;
+        this.#messageListener = async (parsedMessage) => {
+            try {
+                // Message is already parsed from WebSocketServer
+                logger.debug('Received message', {
+                    source: 'EventsManager.onMessage',
+                    type: parsedMessage.type,
+                    id: parsedMessage.id,
+                });
+                if (this.#events.has(parsedMessage.type)) {
+                    const handlers = this.#events.get(parsedMessage.type);
+                    // Execute handlers with proper error handling
+                    await Promise.allSettled(handlers.map((handler) => handler(parsedMessage))).then((results) => {
+                        results.forEach((result, index) => {
+                            if (result.status === 'rejected') {
+                                logger.error('Event handler failed', {
+                                    code: 'EVENT_HANDLER_ERROR',
+                                    source: 'EventsManager.onMessage',
+                                    handlerIndex: index,
+                                    messageType: parsedMessage.type,
+                                    error: result.reason,
+                                });
+                            }
+                        });
+                    });
+                    return;
+                }
+                logger.warn('No handlers registered for event type', {
+                    code: 'EVENT_NO_HANDLERS',
+                    source: 'EventsManager.onMessage',
+                    eventType: parsedMessage.type,
+                });
+            }
+            catch (error) {
+                logger.error('Error processing WebSocket message', {
+                    code: 'EVENT_PROCESSING_ERROR',
+                    source: 'EventsManager.onMessage',
+                    messageType: parsedMessage.type,
+                    error,
+                });
+            }
+        };
+        wss.on('message', this.#messageListener);
+    }
+    close() {
+        // Cleanup
+        if (this.#wss && this.#messageListener) {
+            this.#wss.off('message', this.#messageListener);
+        }
+        this.#events.clear();
+        logger.info('Events manager closed', {
+            source: 'EventsManager.close',
+        });
+    }
+}
+//# sourceMappingURL=EventsManager.js.map

package/dist/events/EventsManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventsManager.js","sourceRoot":"","sources":["../../src/events/EventsManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,yBAAyB,MAAM,2CAA2C,CAAC;AAClF,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAc7C,MAAM,CAAC,OAAO,OAAO,aAAa;IAChC,IAAI,CAAM;IACV,OAAO,GAAG,IAAI,GAAG,EAAsE,CAAC;IACxF,gBAAgB,GAA6D,IAAI,CAAC;IAElF,YAAY,EAAE,uBAAuB,GAAG,IAAI,EAAE,UAAU,GAAG,EAAE,KAA2B,EAAE;QACxF,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC;YACpD,IAAI,CAAC,cAAc,CACjB,UAAU,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,aAAa,CAAC,CAAC,IAAI,EAAE,CAC1E,CAAC;QAEJ,IAAI,uBAAuB;YAAE,IAAI,CAAC,wBAAwB,CAAC,uBAAuB,CAAC,CAAC;IACtF,CAAC;IAED,cAAc,CACZ,MAA2F;QAE3F,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAC7C,CAAC;QAED,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;YACvB,2BAA2B;YAC3B,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;gBACjE,MAAM,CAAC,IAAI,CAAC,4BAA4B,EAAE;oBACxC,IAAI,EAAE,4BAA4B;oBAClC,MAAM,EAAE,8BAA8B;oBACtC,KAAK;iBACN,CAAC,CAAC;gBACH,OAAO;YACT,CAAC;YAED,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBAClC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACnC,CAAC;YAED,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAE,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACpD,CAAC,CAAC,CAAC;IACL,CAAC;IAED,SAAS,CAAC,IAAY,EAAE,OAAY;QAClC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CAAC,mDAAmD,EAAE;gBAC/D,IAAI,EAAE,oBAAoB;gBAC1B,MAAM,EAAE,yBAAyB;gBACjC,WAAW,EAAE,IAAI;aAClB,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QAED,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACrD,CAAC;QAED,IAAI,CAAC;YACH,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,yBAAyB,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;QACvE,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,MAAM,CAAC,KAAK,CAAC,iBAAiB,EAAE;gBAC9B,IAAI,EAAE,uBAAuB;gBAC7B,MAAM,EAAE,yBAAyB;gBACjC,WAAW,EAAE,IAAI;gBACjB,KAAK;aACN,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,wBAAwB,CAAC,GAAQ;QAC/B,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;QAEhB,IAAI,CAAC,gBAAgB,GAAG,KAAK,EAAE,aAA4B,EAAE,EAAE;YAC7D,IAAI,CAAC;gBACH,iDAAiD;gBACjD,MAAM,CAAC,KAAK,CAAC,kBAAkB,EAAE;oBAC/B,MAAM,EAAE,yBAAyB;oBACjC,IAAI,EAAE,aAAa,CAAC,IAAI;oBACxB,EAAE,EAAE,aAAa,CAAC,EAAE;iBACrB,CAAC,CAAC;gBAEH,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;oBACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,CAAE,CAAC;oBAEvD,8CAA8C;oBAC9C,MAAM,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,IAAI,CAC9E,CAAC,OAAO,EAAE,EAAE;wBACV,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;4BAChC,IAAI,MAAM,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;gCACjC,MAAM,CAAC,KAAK,CAAC,sBAAsB,EAAE;oCACnC,IAAI,EAAE,qBAAqB;oCAC3B,MAAM,EAAE,yBAAyB;oCACjC,YAAY,EAAE,KAAK;oCACnB,WAAW,EAAE,aAAa,CAAC,IAAI;oCAC/B,KAAK,EAAE,MAAM,CAAC,MAAM;iCACrB,CAAC,CAAC;4BACL,CAAC;wBACH,CAAC,CAAC,CAAC;oBACL,CAAC,CACF,CAAC;oBACF,OAAO;gBACT,CAAC;gBAED,MAAM,CAAC,IAAI,CAAC,uCAAuC,EAAE;oBACnD,IAAI,EAAE,mBAAmB;oBACzB,MAAM,EAAE,yBAAyB;oBACjC,SAAS,EAAE,aAAa,CAAC,IAAI;iBAC9B,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,KAAU,EAAE,CAAC;gBACpB,MAAM,CAAC,KAAK,CAAC,oCAAoC,EAAE;oBACjD,IAAI,EAAE,wBAAwB;oBAC9B,MAAM,EAAE,yBAAyB;oBACjC,WAAW,EAAE,aAAa,CAAC,IAAI;oBAC/B,KAAK;iBACN,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC;QAEF,GAAG,CAAC,EAAE,CAAC,SAAS,EAAE,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAC3C,CAAC;IAED,KAAK;QACH,UAAU;QACV,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACvC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAClD,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACrB,MAAM,CAAC,IAAI,CAAC,uBAAuB,EAAE;YACnC,MAAM,EAAE,qBAAqB;SAC9B,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,32 @@
+export { default as Server } from './server/Server.js';
+export { default as Router } from './router/Router.js';
+export { default as Routes } from './router/Routes.js';
+export { default as StaticFileHandler } from './router/StaticFileHandler.js';
+export { default as Context } from './context/Context.js';
+export type { RouterRequest, RouterResponse, RouterOptions, RouterMiddleware, } from './router/Router.js';
+export { default as WebSocketServer } from './websocket/WebSocketServer.js';
+export { default as WebSocketMessageFormatter } from './websocket/WebSocketMessageFormatter.js';
+export * from './middleware/RequestLogger.js';
+export { default as AppState } from './state/AppState.js';
+export { default as Events } from './events/Events.js';
+export { default as EventsManager } from './events/EventsManager.js';
+export { default as HtmlSanitizer } from './sanitizer/HtmlSanitizer.js';
+export { default as HtmlRenderer } from './utils/HtmlRenderer.js';
+export { default as Local } from './local/Local.js';
+export { logger } from './logger/Logger.js';
+export { default as ApiClient } from './client/ApiClient.js';
+export { default as RouteError } from './router/RouteError.js';
+export { OpenApiGenerator, generateSwaggerUI } from './docs/OpenApiGenerator.js';
+export type { OpenApiInfo, OpenApiServer, OpenApiParameter, OpenApiResponse, OpenApiRouteConfig, OpenApiConfig, } from './docs/OpenApiGenerator.js';
+import HtmlSanitizer from './sanitizer/HtmlSanitizer.js';
+import HtmlRenderer from './utils/HtmlRenderer.js';
+import Local from './local/Local.js';
+import ApiClient from './client/ApiClient.js';
+export declare const Utils: {
+    HtmlSanitizer: typeof HtmlSanitizer;
+    HtmlRenderer: typeof HtmlRenderer;
+    Local: typeof Local;
+    ApiClient: typeof ApiClient;
+};
+export { default as Slack } from './notifications/Slack.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAC7E,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAG1D,YAAY,EACV,aAAa,EACb,cAAc,EACd,aAAa,EACb,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAC5E,OAAO,EAAE,OAAO,IAAI,yBAAyB,EAAE,MAAM,0CAA0C,CAAC;AAGhG,cAAc,+BAA+B,CAAC;AAG9C,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAGrE,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAG/D,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACjF,YAAY,EACV,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EAClB,aAAa,GACd,MAAM,4BAA4B,CAAC;AAGpC,OAAO,aAAa,MAAM,8BAA8B,CAAC;AACzD,OAAO,YAAY,MAAM,yBAAyB,CAAC;AACnD,OAAO,KAAK,MAAM,kBAAkB,CAAC;AACrC,OAAO,SAAS,MAAM,uBAAuB,CAAC;AAE9C,eAAO,MAAM,KAAK;;;;;CAKjB,CAAC;AAGF,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/index.js

@@ -0,0 +1,38 @@
+// Server Core
+export { default as Server } from './server/Server.js';
+export { default as Router } from './router/Router.js';
+export { default as Routes } from './router/Routes.js';
+export { default as StaticFileHandler } from './router/StaticFileHandler.js';
+export { default as Context } from './context/Context.js';
+// WebSocket
+export { default as WebSocketServer } from './websocket/WebSocketServer.js';
+export { default as WebSocketMessageFormatter } from './websocket/WebSocketMessageFormatter.js';
+// Middleware
+export * from './middleware/RequestLogger.js';
+// State & Events
+export { default as AppState } from './state/AppState.js';
+export { default as Events } from './events/Events.js';
+export { default as EventsManager } from './events/EventsManager.js';
+// Utilities (individual exports)
+export { default as HtmlSanitizer } from './sanitizer/HtmlSanitizer.js';
+export { default as HtmlRenderer } from './utils/HtmlRenderer.js';
+export { default as Local } from './local/Local.js';
+export { logger } from './logger/Logger.js';
+export { default as ApiClient } from './client/ApiClient.js';
+export { default as RouteError } from './router/RouteError.js';
+// Documentation
+export { OpenApiGenerator, generateSwaggerUI } from './docs/OpenApiGenerator.js';
+// Utilities (grouped namespace - classes only)
+import HtmlSanitizer from './sanitizer/HtmlSanitizer.js';
+import HtmlRenderer from './utils/HtmlRenderer.js';
+import Local from './local/Local.js';
+import ApiClient from './client/ApiClient.js';
+export const Utils = {
+    HtmlSanitizer,
+    HtmlRenderer,
+    Local,
+    ApiClient,
+};
+// Integrations
+export { default as Slack } from './notifications/Slack.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc;AACd,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAC7E,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAU1D,YAAY;AACZ,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAC5E,OAAO,EAAE,OAAO,IAAI,yBAAyB,EAAE,MAAM,0CAA0C,CAAC;AAEhG,aAAa;AACb,cAAc,+BAA+B,CAAC;AAE9C,iBAAiB;AACjB,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAErE,iCAAiC;AACjC,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAE/D,gBAAgB;AAChB,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAUjF,+CAA+C;AAC/C,OAAO,aAAa,MAAM,8BAA8B,CAAC;AACzD,OAAO,YAAY,MAAM,yBAAyB,CAAC;AACnD,OAAO,KAAK,MAAM,kBAAkB,CAAC;AACrC,OAAO,SAAS,MAAM,uBAAuB,CAAC;AAE9C,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,aAAa;IACb,YAAY;IACZ,KAAK;IACL,SAAS;CACV,CAAC;AAEF,eAAe;AACf,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/local/Local.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Local development utilities for Lambda handlers
+ *
+ * Provides utilities to run AWS Lambda handlers locally using a Node.js server.
+ * Converts HTTP requests to Lambda event format and responses back to HTTP.
+ *
+ * @class Local
+ * @example
+ * // Wrap your Lambda handler for local development
+ * import { handler } from './lambda/handler.js';
+ * import Local from '@designofadecade/local';
+ *
+ * const localHandler = Local.LambdaProxyRouter(handler, {
+ *     requestContext: { stage: 'dev' }
+ * });
+ *
+ * // Use with Node.js http server
+ * http.createServer((req, res) => {
+ *     localHandler.request(req, res);
+ * }).listen(3000);
+ */
+import type { IncomingMessage, ServerResponse } from 'http';
+interface LambdaProxyRouterOptions {
+    requestContext?: Record<string, unknown>;
+    event?: Record<string, unknown>;
+}
+interface LambdaEvent {
+    rawPath: string;
+    headers: Record<string, string | string[] | undefined>;
+    queryStringParameters: Record<string, string>;
+    cookies: Record<string, string>;
+    requestContext: {
+        http: {
+            method: string;
+            path: string;
+        };
+        authorizer: unknown;
+        [key: string]: unknown;
+    };
+    body: string | null;
+    [key: string]: unknown;
+}
+interface LambdaResponse {
+    statusCode: number;
+    headers?: Record<string, string>;
+    cookies?: string[];
+    body?: string;
+    isBase64Encoded?: boolean;
+}
+export default class Local {
+    /**
+     * Lambda proxy router for local development
+     *
+     * Creates a router that wraps AWS Lambda handlers and allows them to be
+     * run locally with a Node.js HTTP server. Automatically converts between
+     * HTTP requests and Lambda event format.
+     *
+     * @param {Function} LambdaHandler - AWS Lambda handler function
+     * @param {Object} options - Configuration options
+     * @param {Object} options.requestContext - Additional requestContext fields for Lambda event
+     * @param {Object} options.event - Additional event fields for Lambda event
+     * @returns {Object} Object with request method for handling HTTP requests
+     *
+     * @example
+     * const handler = Local.LambdaProxyRouter(
+     *     async (event) => {
+     *         return {
+     *             statusCode: 200,
+     *             body: JSON.stringify({ message: 'Hello!' })
+     *         };
+     *     },
+     *     { requestContext: { stage: 'local' } }
+     * );
+     */
+    static LambdaProxyRouter(LambdaHandler: (event: LambdaEvent) => Promise<LambdaResponse>, options?: LambdaProxyRouterOptions): {
+        request: (req: IncomingMessage, res: ServerResponse, requestOptions?: {
+            requestContext?: Record<string, unknown>;
+            event?: Record<string, unknown>;
+        }) => Promise<void>;
+    };
+}
+export {};
+//# sourceMappingURL=Local.d.ts.map