@morojs/moro 1.6.1 → 1.6.3

package/dist/core/middleware/built-in/sse/core.js

@@ -0,0 +1,117 @@
+// ===== Core Logic =====
+/**
+ * Format SSE event data
+ */
+export function formatSSEEvent(data, event, id) {
+    let message = '';
+    if (id) {
+        message += `id: ${id}\n`;
+    }
+    if (event) {
+        message += `event: ${event}\n`;
+    }
+    const dataStr = typeof data === 'string' ? data : JSON.stringify(data);
+    message += `data: ${dataStr}\n\n`;
+    return message;
+}
+/**
+ * Format SSE comment
+ */
+export function formatSSEComment(comment) {
+    return `: ${comment}\n\n`;
+}
+/**
+ * Format SSE retry directive
+ */
+export function formatSSERetry(ms) {
+    return `retry: ${ms}\n\n`;
+}
+/**
+ * SSECore - Core Server-Sent Events management logic
+ * Used directly by the router for route-based SSE
+ */
+export class SSECore {
+    options;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    /**
+     * Check if request accepts SSE
+     */
+    isSSERequest(acceptHeader) {
+        if (!acceptHeader) {
+            return false;
+        }
+        return acceptHeader.includes('text/event-stream');
+    }
+    /**
+     * Initialize SSE headers on response
+     */
+    initializeSSE(res) {
+        const headers = {
+            'Content-Type': 'text/event-stream',
+            'Cache-Control': 'no-cache',
+            Connection: 'keep-alive',
+        };
+        if (this.options.cors) {
+            headers['Access-Control-Allow-Origin'] = '*';
+            headers['Access-Control-Allow-Headers'] = 'Cache-Control';
+        }
+        res.writeHead(200, headers);
+    }
+    /**
+     * Create SSE connection with helper methods
+     */
+    createConnection(res, onClose) {
+        const resAny = res;
+        let heartbeatInterval = null;
+        let closed = false;
+        // Send initial retry if configured
+        if (this.options.retry) {
+            resAny.write(formatSSERetry(this.options.retry));
+        }
+        // Set up heartbeat if configured
+        if (this.options.heartbeat) {
+            heartbeatInterval = setInterval(() => {
+                if (!closed) {
+                    resAny.write(formatSSEComment('heartbeat'));
+                }
+            }, this.options.heartbeat);
+        }
+        const connection = {
+            sendEvent: (data, event, id) => {
+                if (!closed) {
+                    resAny.write(formatSSEEvent(data, event, id));
+                }
+            },
+            sendComment: (comment) => {
+                if (!closed) {
+                    resAny.write(formatSSEComment(comment));
+                }
+            },
+            sendRetry: (ms) => {
+                if (!closed) {
+                    resAny.write(formatSSERetry(ms));
+                }
+            },
+            close: () => {
+                if (closed) {
+                    return;
+                }
+                closed = true;
+                if (heartbeatInterval) {
+                    clearInterval(heartbeatInterval);
+                    heartbeatInterval = null;
+                }
+                if (onClose) {
+                    onClose();
+                }
+                if (resAny.end && !resAny.writableEnded) {
+                    resAny.end();
+                }
+            },
+        };
+        return connection;
+    }
+}
+//# sourceMappingURL=core.js.map

package/dist/core/middleware/built-in/sse/core.js.map

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

package/dist/core/middleware/built-in/sse/hook.d.ts

@@ -0,0 +1,18 @@
+import { MiddlewareInterface } from '../../../../types/hooks.js';
+import { type SSEOptions } from './core.js';
+/**
+ * SSE hook for global usage
+ * Registers with the hooks system for application-wide Server-Sent Events support
+ *
+ * @example
+ * ```ts
+ * import { sse } from '@/middleware/built-in/sse';
+ *
+ * app.use(sse({
+ *   heartbeat: 30000,
+ *   retry: 3000,
+ *   cors: true
+ * }));
+ * ```
+ */
+export declare const sse: (options?: SSEOptions) => MiddlewareInterface;

package/dist/core/middleware/built-in/sse/hook.js

@@ -0,0 +1,60 @@
+import { createFrameworkLogger } from '../../../logger/index.js';
+import { SSECore } from './core.js';
+const logger = createFrameworkLogger('SSEMiddleware');
+/**
+ * SSE hook for global usage
+ * Registers with the hooks system for application-wide Server-Sent Events support
+ *
+ * @example
+ * ```ts
+ * import { sse } from '@/middleware/built-in/sse';
+ *
+ * app.use(sse({
+ *   heartbeat: 30000,
+ *   retry: 3000,
+ *   cors: true
+ * }));
+ * ```
+ */
+export const sse = (options = {}) => ({
+    name: 'sse',
+    version: '1.0.0',
+    metadata: {
+        name: 'sse',
+        version: '1.0.0',
+        description: 'Server-Sent Events middleware with heartbeat and retry support',
+        author: 'MoroJS Team',
+    },
+    install: async (hooks, middlewareOptions = {}) => {
+        logger.debug('Installing SSE middleware', 'Installation', { options: middlewareOptions });
+        const config = { ...options, ...middlewareOptions };
+        const sseCore = new SSECore(config);
+        hooks.before('request', async (context) => {
+            const req = context.request;
+            const res = context.response;
+            // Only handle SSE requests
+            if (!sseCore.isSSERequest(req.headers.accept)) {
+                return;
+            }
+            logger.debug('Setting up SSE connection', 'SSESetup');
+            // Initialize SSE connection
+            if (!res.headersSent) {
+                sseCore.initializeSSE(res);
+            }
+            // Create connection and attach methods to response
+            const connection = sseCore.createConnection(res, () => {
+                logger.debug('SSE connection closed', 'SSECleanup');
+            });
+            res.sendEvent = connection.sendEvent;
+            res.sendComment = connection.sendComment;
+            res.sendRetry = connection.sendRetry;
+            // Clean up on close
+            req.on('close', () => {
+                connection.close();
+            });
+            // Mark that this middleware handled the request
+            context.handled = true;
+        });
+    },
+});
+//# sourceMappingURL=hook.js.map

package/dist/core/middleware/built-in/sse/hook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook.js","sourceRoot":"","sources":["../../../../../src/core/middleware/built-in/sse/hook.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,OAAO,EAAmB,MAAM,WAAW,CAAC;AAErD,MAAM,MAAM,GAAG,qBAAqB,CAAC,eAAe,CAAC,CAAC;AAEtD;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,UAAsB,EAAE,EAAuB,EAAE,CAAC,CAAC;IACrE,IAAI,EAAE,KAAK;IACX,OAAO,EAAE,OAAO;IAChB,QAAQ,EAAE;QACR,IAAI,EAAE,KAAK;QACX,OAAO,EAAE,OAAO;QAChB,WAAW,EAAE,gEAAgE;QAC7E,MAAM,EAAE,aAAa;KACtB;IAED,OAAO,EAAE,KAAK,EAAE,KAAU,EAAE,oBAAyB,EAAE,EAAE,EAAE;QACzD,MAAM,CAAC,KAAK,CAAC,2BAA2B,EAAE,cAAc,EAAE,EAAE,OAAO,EAAE,iBAAiB,EAAE,CAAC,CAAC;QAE1F,MAAM,MAAM,GAAG,EAAE,GAAG,OAAO,EAAE,GAAG,iBAAiB,EAAE,CAAC;QACpD,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;QAEpC,KAAK,CAAC,MAAM,CAAC,SAAS,EAAE,KAAK,EAAE,OAAoB,EAAE,EAAE;YACrD,MAAM,GAAG,GAAG,OAAO,CAAC,OAAc,CAAC;YACnC,MAAM,GAAG,GAAG,OAAO,CAAC,QAAe,CAAC;YAEpC,2BAA2B;YAC3B,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC9C,OAAO;YACT,CAAC;YAED,MAAM,CAAC,KAAK,CAAC,2BAA2B,EAAE,UAAU,CAAC,CAAC;YAEtD,4BAA4B;YAC5B,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;gBACrB,OAAO,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;YAC7B,CAAC;YAED,mDAAmD;YACnD,MAAM,UAAU,GAAG,OAAO,CAAC,gBAAgB,CAAC,GAAG,EAAE,GAAG,EAAE;gBACpD,MAAM,CAAC,KAAK,CAAC,uBAAuB,EAAE,YAAY,CAAC,CAAC;YACtD,CAAC,CAAC,CAAC;YAEH,GAAG,CAAC,SAAS,GAAG,UAAU,CAAC,SAAS,CAAC;YACrC,GAAG,CAAC,WAAW,GAAG,UAAU,CAAC,WAAW,CAAC;YACzC,GAAG,CAAC,SAAS,GAAG,UAAU,CAAC,SAAS,CAAC;YAErC,oBAAoB;YACpB,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;gBACnB,UAAU,CAAC,KAAK,EAAE,CAAC;YACrB,CAAC,CAAC,CAAC;YAEH,gDAAgD;YAC/C,OAAe,CAAC,OAAO,GAAG,IAAI,CAAC;QAClC,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAC,CAAC"}

package/dist/core/middleware/built-in/sse/index.d.ts

@@ -0,0 +1,3 @@
+export { SSECore, formatSSEEvent, formatSSEComment, formatSSERetry, type SSEOptions, type SSEConnection, } from './core.js';
+export { createSSEMiddleware } from './middleware.js';
+export { sse } from './hook.js';

package/dist/core/middleware/built-in/sse/index.js

@@ -0,0 +1,9 @@
+// SSE - Main entry point
+// Re-exports all public APIs for the SSE built-in
+// Core (for direct use by router and custom implementations)
+export { SSECore, formatSSEEvent, formatSSEComment, formatSSERetry, } from './core.js';
+// Middleware (for middleware chains)
+export { createSSEMiddleware } from './middleware.js';
+// Hook (for global registration)
+export { sse } from './hook.js';
+//# sourceMappingURL=index.js.map

package/dist/core/middleware/built-in/sse/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/core/middleware/built-in/sse/index.ts"],"names":[],"mappings":"AAAA,yBAAyB;AACzB,kDAAkD;AAElD,6DAA6D;AAC7D,OAAO,EACL,OAAO,EACP,cAAc,EACd,gBAAgB,EAChB,cAAc,GAGf,MAAM,WAAW,CAAC;AAEnB,qCAAqC;AACrC,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEtD,iCAAiC;AACjC,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC"}

package/dist/core/middleware/built-in/sse/middleware.d.ts

@@ -0,0 +1,18 @@
+import { StandardMiddleware } from '../../../../types/hooks.js';
+import { type SSEOptions } from './core.js';
+/**
+ * Create SSE middleware for use in middleware chains
+ * Only activates for requests with 'text/event-stream' Accept header
+ *
+ * @example
+ * ```ts
+ * const sseMw = createSSEMiddleware({
+ *   heartbeat: 30000,
+ *   retry: 3000,
+ *   cors: true
+ * });
+ *
+ * app.use(sseMw);
+ * ```
+ */
+export declare function createSSEMiddleware(options?: SSEOptions): StandardMiddleware;

package/dist/core/middleware/built-in/sse/middleware.js

@@ -0,0 +1,43 @@
+import { SSECore } from './core.js';
+/**
+ * Create SSE middleware for use in middleware chains
+ * Only activates for requests with 'text/event-stream' Accept header
+ *
+ * @example
+ * ```ts
+ * const sseMw = createSSEMiddleware({
+ *   heartbeat: 30000,
+ *   retry: 3000,
+ *   cors: true
+ * });
+ *
+ * app.use(sseMw);
+ * ```
+ */
+export function createSSEMiddleware(options = {}) {
+    const sseCore = new SSECore(options);
+    return async (req, res, next) => {
+        // Only handle SSE requests
+        if (!sseCore.isSSERequest(req.headers.accept)) {
+            await next();
+            return;
+        }
+        // Initialize SSE connection
+        const resAny = res;
+        if (!resAny.headersSent) {
+            sseCore.initializeSSE(res);
+        }
+        // Create connection and attach methods to response
+        const reqAny = req;
+        const connection = sseCore.createConnection(res);
+        resAny.sendEvent = connection.sendEvent;
+        resAny.sendComment = connection.sendComment;
+        resAny.sendRetry = connection.sendRetry;
+        // Clean up on close
+        reqAny.on('close', () => {
+            connection.close();
+        });
+        await next();
+    };
+}
+//# sourceMappingURL=middleware.js.map

package/dist/core/middleware/built-in/sse/middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.js","sourceRoot":"","sources":["../../../../../src/core/middleware/built-in/sse/middleware.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAmB,MAAM,WAAW,CAAC;AAErD;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,mBAAmB,CAAC,UAAsB,EAAE;IAC1D,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAErC,OAAO,KAAK,EAAE,GAAgB,EAAE,GAAiB,EAAE,IAAyB,EAAE,EAAE;QAC9E,2BAA2B;QAC3B,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC9C,MAAM,IAAI,EAAE,CAAC;YACb,OAAO;QACT,CAAC;QAED,4BAA4B;QAC5B,MAAM,MAAM,GAAG,GAAU,CAAC;QAC1B,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;YACxB,OAAO,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;QAC7B,CAAC;QAED,mDAAmD;QACnD,MAAM,MAAM,GAAG,GAAU,CAAC;QAC1B,MAAM,UAAU,GAAG,OAAO,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;QAEjD,MAAM,CAAC,SAAS,GAAG,UAAU,CAAC,SAAS,CAAC;QACxC,MAAM,CAAC,WAAW,GAAG,UAAU,CAAC,WAAW,CAAC;QAC5C,MAAM,CAAC,SAAS,GAAG,UAAU,CAAC,SAAS,CAAC;QAExC,oBAAoB;QACpB,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACtB,UAAU,CAAC,KAAK,EAAE,CAAC;QACrB,CAAC,CAAC,CAAC;QAEH,MAAM,IAAI,EAAE,CAAC;IACf,CAAC,CAAC;AACJ,CAAC"}

package/dist/core/middleware/built-in/validation/core.d.ts

@@ -0,0 +1,23 @@
+import { HttpRequest, HttpResponse } from '../../../../types/http.js';
+import { ValidationSchema } from '../../../validation/schema-interface.js';
+export interface ValidationConfig {
+    body?: ValidationSchema;
+    query?: ValidationSchema;
+    params?: ValidationSchema;
+    headers?: ValidationSchema;
+}
+export interface ValidationErrorDetail {
+    field: string;
+    message: string;
+    code: string;
+}
+/**
+ * ValidationCore - Core validation logic
+ * Used directly by the router for route-based validation
+ * Can be instantiated for use in middleware or hooks
+ */
+export declare class ValidationCore {
+    validate(req: HttpRequest, res: HttpResponse, config: ValidationConfig): Promise<boolean>;
+    private handleValidationError;
+}
+export declare const sharedValidationCore: ValidationCore;

package/dist/core/middleware/built-in/validation/core.js

@@ -0,0 +1,93 @@
+// Validation Core - Reusable validation logic
+import { createFrameworkLogger } from '../../../logger/index.js';
+import { normalizeValidationError, } from '../../../validation/schema-interface.js';
+const logger = createFrameworkLogger('ValidationCore');
+// ===== Core Logic =====
+/**
+ * ValidationCore - Core validation logic
+ * Used directly by the router for route-based validation
+ * Can be instantiated for use in middleware or hooks
+ */
+export class ValidationCore {
+    async validate(req, res, config) {
+        // Don't validate if headers already sent
+        if (res.headersSent) {
+            return false;
+        }
+        try {
+            if (config.body && req.body !== undefined) {
+                try {
+                    req.validatedBody = await config.body.parseAsync(req.body);
+                    req.body = req.validatedBody;
+                }
+                catch (error) {
+                    this.handleValidationError(error, 'body', req, res);
+                    return false;
+                }
+            }
+            if (config.query && req.query !== undefined) {
+                try {
+                    req.validatedQuery = await config.query.parseAsync(req.query);
+                    req.query = req.validatedQuery;
+                }
+                catch (error) {
+                    this.handleValidationError(error, 'query', req, res);
+                    return false;
+                }
+            }
+            if (config.params && req.params !== undefined) {
+                try {
+                    req.validatedParams = await config.params.parseAsync(req.params);
+                    req.params = req.validatedParams;
+                }
+                catch (error) {
+                    this.handleValidationError(error, 'params', req, res);
+                    return false;
+                }
+            }
+            if (config.headers && req.headers !== undefined) {
+                try {
+                    req.validatedHeaders = await config.headers.parseAsync(req.headers);
+                }
+                catch (error) {
+                    this.handleValidationError(error, 'headers', req, res);
+                    return false;
+                }
+            }
+            return true;
+        }
+        catch (error) {
+            logger.error('Unexpected validation error', 'Validation', {
+                error: error.message,
+            });
+            if (!res.headersSent) {
+                res.status(500).json({
+                    success: false,
+                    error: 'Internal server error',
+                    requestId: req.requestId,
+                });
+            }
+            return false;
+        }
+    }
+    handleValidationError(error, field, req, res) {
+        // Don't send error if headers already sent
+        if (res.headersSent) {
+            return;
+        }
+        const normalizedError = normalizeValidationError(error);
+        res.status(400).json({
+            success: false,
+            error: `Validation failed for ${field}`,
+            details: normalizedError.issues.map((issue) => ({
+                field: issue.path.length > 0 ? issue.path.join('.') : field,
+                message: issue.message,
+                code: issue.code,
+            })),
+            requestId: req.requestId,
+        });
+    }
+}
+// Shared instance for route-based validation
+export const sharedValidationCore = new ValidationCore();
+//# sourceMappingURL=core.js.map

package/dist/core/middleware/built-in/validation/core.js.map

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

package/dist/core/middleware/built-in/validation/hook.d.ts

@@ -0,0 +1,13 @@
+import { MiddlewareInterface } from '../../../../types/hooks.js';
+/**
+ * Basic validation hook for global usage
+ * Registers with the hooks system for content-type checking
+ *
+ * @example
+ * ```ts
+ * import { validation } from '@/middleware/built-in/validation';
+ *
+ * app.use(validation());
+ * ```
+ */
+export declare const validation: () => MiddlewareInterface;

package/dist/core/middleware/built-in/{validation.js → validation/hook.js}

@@ -1,9 +1,17 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.validation = void 0;
-const logger_1 = require("../../logger");
-const logger = (0, logger_1.createFrameworkLogger)('ValidationMiddleware');
-const validation = () => ({
+import { createFrameworkLogger } from '../../../logger/index.js';
+const logger = createFrameworkLogger('ValidationMiddleware');
+/**
+ * Basic validation hook for global usage
+ * Registers with the hooks system for content-type checking
+ *
+ * @example
+ * ```ts
+ * import { validation } from '@/middleware/built-in/validation';
+ *
+ * app.use(validation());
+ * ```
+ */
+export const validation = () => ({
     name: 'validation',
     version: '1.0.0',
     metadata: {
@@ -12,7 +20,7 @@ const validation = () => ({
         description: 'Request validation middleware with content type checking',
         author: 'MoroJS Team',
     },
-    install: async (hooks, options = {}) => {
+    install: async (hooks, _middlewareOptions = {}) => {
         logger.debug('Installing validation middleware', 'Installation');
         hooks.before('request', async (context) => {
             const request = context.request;
@@ -27,5 +35,4 @@ const validation = () => ({
         });
     },
 });
-exports.validation = validation;
-//# sourceMappingURL=validation.js.map
+//# sourceMappingURL=hook.js.map

package/dist/core/middleware/built-in/validation/hook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook.js","sourceRoot":"","sources":["../../../../../src/core/middleware/built-in/validation/hook.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAEjE,MAAM,MAAM,GAAG,qBAAqB,CAAC,sBAAsB,CAAC,CAAC;AAE7D;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,GAAwB,EAAE,CAAC,CAAC;IACpD,IAAI,EAAE,YAAY;IAClB,OAAO,EAAE,OAAO;IAChB,QAAQ,EAAE;QACR,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,OAAO;QAChB,WAAW,EAAE,0DAA0D;QACvE,MAAM,EAAE,aAAa;KACtB;IAED,OAAO,EAAE,KAAK,EAAE,KAAU,EAAE,qBAA0B,EAAE,EAAE,EAAE;QAC1D,MAAM,CAAC,KAAK,CAAC,kCAAkC,EAAE,cAAc,CAAC,CAAC;QAEjE,KAAK,CAAC,MAAM,CAAC,SAAS,EAAE,KAAK,EAAE,OAAoB,EAAE,EAAE;YACrD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAc,CAAC;YAEvC,gCAAgC;YAChC,IAAI,OAAO,CAAC,MAAM,KAAK,MAAM,IAAI,OAAO,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;gBAC1D,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;gBACpD,IAAI,WAAW,IAAI,WAAW,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;oBAC5D,MAAM,CAAC,KAAK,CAAC,wCAAwC,EAAE,aAAa,CAAC,CAAC;oBACtE,4CAA4C;gBAC9C,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAC,CAAC"}

package/dist/core/middleware/built-in/validation/index.d.ts

@@ -0,0 +1,3 @@
+export { ValidationCore, sharedValidationCore, type ValidationConfig, type ValidationErrorDetail, } from './core.js';
+export { createValidationMiddleware } from './middleware.js';
+export { validation } from './hook.js';

package/dist/core/middleware/built-in/validation/index.js

@@ -0,0 +1,9 @@
+// Validation - Main entry point
+// Re-exports all public APIs for the validation built-in
+// Core (for direct use by router and custom implementations)
+export { ValidationCore, sharedValidationCore, } from './core.js';
+// Middleware (for middleware chains)
+export { createValidationMiddleware } from './middleware.js';
+// Hook (for global registration)
+export { validation } from './hook.js';
+//# sourceMappingURL=index.js.map

package/dist/core/middleware/built-in/validation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/core/middleware/built-in/validation/index.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,yDAAyD;AAEzD,6DAA6D;AAC7D,OAAO,EACL,cAAc,EACd,oBAAoB,GAGrB,MAAM,WAAW,CAAC;AAEnB,qCAAqC;AACrC,OAAO,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAE7D,iCAAiC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC"}

package/dist/core/middleware/built-in/validation/middleware.d.ts

@@ -0,0 +1,16 @@
+import { StandardMiddleware } from '../../../../types/hooks.js';
+import { type ValidationConfig } from './core.js';
+/**
+ * Create validation middleware for use in middleware chains
+ *
+ * @example
+ * ```ts
+ * const validateMw = createValidationMiddleware({
+ *   body: myBodySchema,
+ *   query: myQuerySchema
+ * });
+ *
+ * app.use(validateMw);
+ * ```
+ */
+export declare function createValidationMiddleware(config: ValidationConfig): StandardMiddleware;

package/dist/core/middleware/built-in/validation/middleware.js

@@ -0,0 +1,27 @@
+import { sharedValidationCore } from './core.js';
+/**
+ * Create validation middleware for use in middleware chains
+ *
+ * @example
+ * ```ts
+ * const validateMw = createValidationMiddleware({
+ *   body: myBodySchema,
+ *   query: myQuerySchema
+ * });
+ *
+ * app.use(validateMw);
+ * ```
+ */
+export function createValidationMiddleware(config) {
+    if (!config || Object.keys(config).length === 0) {
+        return (_req, _res, next) => next();
+    }
+    return async (req, res, next) => {
+        const success = await sharedValidationCore.validate(req, res, config);
+        if (success) {
+            next();
+        }
+        // If validation failed, response is already sent
+    };
+}
+//# sourceMappingURL=middleware.js.map

package/dist/core/middleware/built-in/validation/middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.js","sourceRoot":"","sources":["../../../../../src/core/middleware/built-in/validation/middleware.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAyB,MAAM,WAAW,CAAC;AAExE;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,0BAA0B,CAAC,MAAwB;IACjE,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChD,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC;IACtC,CAAC;IAED,OAAO,KAAK,EAAE,GAAQ,EAAE,GAAQ,EAAE,IAAgB,EAAE,EAAE;QACpD,MAAM,OAAO,GAAG,MAAM,oBAAoB,CAAC,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;QACtE,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,EAAE,CAAC;QACT,CAAC;QACD,iDAAiD;IACnD,CAAC,CAAC;AACJ,CAAC"}

package/dist/core/middleware/index.d.ts

@@ -1,6 +1,6 @@
 import { EventEmitter } from 'events';
-import { MiddlewareInterface, SimpleMiddlewareFunction } from '../../types/hooks';
-export type { MiddlewareInterface, MoroMiddleware } from '../../types/hooks';
+import { MiddlewareInterface, SimpleMiddlewareFunction } from '../../types/hooks.js';
+export type { MiddlewareInterface, MoroMiddleware } from '../../types/hooks.js';
 export declare class MiddlewareManager extends EventEmitter {
     private middleware;
     private simpleMiddleware;
@@ -17,5 +17,5 @@ export declare class MiddlewareManager extends EventEmitter {
     installWithDependencies(middleware: MiddlewareInterface[], options?: Record<string, any>): Promise<void>;
     private topologicalSort;
 }
-export { builtInMiddleware, simpleMiddleware } from './built-in';
-export * from './built-in';
+export { builtInMiddleware, simpleMiddleware } from './built-in/index.js';
+export * from './built-in/index.js';

package/dist/core/middleware/index.js

@@ -1,32 +1,21 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.simpleMiddleware = exports.builtInMiddleware = exports.MiddlewareManager = void 0;
 // Middleware System for Moro
-const events_1 = require("events");
-const utilities_1 = require("../utilities");
-const logger_1 = require("../logger");
-class MiddlewareManager extends events_1.EventEmitter {
+/*
+  All middleware in Moro should follow or adopt all of the following patterns:
+  Core - Core.method(req, res, config) - Direct logic, no next, used by router directly
+  Middleware - (req, res, next) => { ... next() } - For middleware chains, calls next
+  Hooks - MiddlewareInterface with before/after hooks
+*/
+import { EventEmitter } from 'events';
+import { HookManager } from '../utilities/index.js';
+import { createFrameworkLogger } from '../logger/index.js';
+export class MiddlewareManager extends EventEmitter {
     middleware = new Map();
     simpleMiddleware = new Map();
     hooks;
-    logger = (0, logger_1.createFrameworkLogger)('Middleware');
+    logger = createFrameworkLogger('Middleware');
     constructor() {
         super();
-        this.hooks = new utilities_1.HookManager();
+        this.hooks = new HookManager();
     }
     // Register middleware without installing
     register(name, middleware) {
@@ -144,10 +133,7 @@ class MiddlewareManager extends events_1.EventEmitter {
         return result;
     }
 }
-exports.MiddlewareManager = MiddlewareManager;
 // Built-in middleware exports
-var built_in_1 = require("./built-in");
-Object.defineProperty(exports, "builtInMiddleware", { enumerable: true, get: function () { return built_in_1.builtInMiddleware; } });
-Object.defineProperty(exports, "simpleMiddleware", { enumerable: true, get: function () { return built_in_1.simpleMiddleware; } });
-__exportStar(require("./built-in"), exports);
+export { builtInMiddleware, simpleMiddleware } from './built-in/index.js';
+export * from './built-in/index.js';
 //# sourceMappingURL=index.js.map