@ismael1361/router 1.1.1 → 1.1.3

package/dist/index.esm.js

@@ -1,2 +1,142 @@
-import{__rest as e}from"./node_modules/tslib/tslib.es6.esm.js";import{Router as r}from"./router.esm.js";import{Middleware as o}from"./middleware.esm.js";import{Handler as s}from"./handler.esm.js";import{joinObject as t}from"./utils.esm.js";export{getCorsHeaders,getCorsOptions}from"./utils.esm.js";export{HandleError}from"./HandleError.esm.js";import*as n from"./Middlewares.esm.js";export{n as Middlewares};function m(){return new r}function i(e,r){return new o(e,void 0,r)}function d(e,r){return new s(e,void 0,r)}function u(e){return new r(e)}function a(r,o={}){const{components:s={}}=r,n=e(r,["components"]);return Object.assign(Object.assign({},n),{components:t(s,o)})}var f={create:m,route:u,middleware:i,handler:d,doc:a};export{m as create,f as default,a as doc,d as handler,i as middleware,u as route};
+import { __rest } from './node_modules/tslib/tslib.es6.esm.js';
+import { Router } from './router.esm.js';
+import { Middleware } from './middleware.esm.js';
+import { Handler } from './handler.esm.js';
+import { joinObject } from './utils.esm.js';
+export { getCorsHeaders, getCorsOptions } from './utils.esm.js';
+export { HandleError } from './HandleError.esm.js';
+import * as Middlewares from './Middlewares.esm.js';
+export { Middlewares };
+
+/**
+ * Inicializa uma nova instância do Router. Este é o ponto de partida para construir sua aplicação.
+ *
+ * @template Req - Tipo de Request base para o roteador.
+ * @template Res - Tipo de Response base para o roteador.
+ * @returns {Router<Req, Res>} Uma nova instância do Router.
+ *
+ * @example
+ * import { create } from '@ismael1361/router';
+ *
+ * const router = create();
+ *
+ * router.get('/ping', { summary: 'Verifica a saúde da API' })
+ *   .handler((req, res) => {
+ *     res.send('pong');
+ *   });
+ *
+ * router.listen(3000, () => {
+ *   console.log('Servidor rodando na porta 3000');
+ * });
+ */
+function create() {
+    return new Router();
+}
+/**
+ * Cria um componente de middleware reutilizável e encadeável.
+ * Permite encapsular lógicas (como autenticação, logging) e sua documentação OpenAPI associada.
+ *
+ * @template Req - Tipo de Request que o middleware espera ou adiciona.
+ * @template Res - Tipo de Response que o middleware pode modificar.
+ * @param {MiddlewareCallback<Req, Res>} callback - A função de middleware.
+ * @param {MiddlewareFCDoc} [doc] - A documentação OpenAPI para este middleware.
+ * @returns {Middleware<Req, Res>} Uma instância de Middleware que pode ser usada em rotas.
+ *
+ * @example
+ * import { middleware } from '@ismael1361/router';
+ *
+ * // Middleware que adiciona um usuário à requisição
+ * const authMiddleware = middleware<{ user: { id: string } }>((req, res, next) => {
+ *   req.user = { id: 'user-123' };
+ *   next();
+ * }, {
+ *   security: [{ bearerAuth: [] }], // Documenta o requisito de segurança
+ *   responses: { '401': { description: 'Não autorizado' } }
+ * });
+ *
+ * // Em uma rota:
+ * // router.get('/profile').middleware(authMiddleware).handler(...)
+ */
+function middleware(callback, doc) {
+    return new Middleware(callback, undefined, doc);
+}
+/**
+ * Cria um componente de manipulador (handler/controller) reutilizável.
+ * Útil para definir a lógica final de uma rota em um local separado e importá-la onde for necessário.
+ *
+ * @template Req - Tipo de Request que o handler espera.
+ * @template Res - Tipo de Response que o handler pode modificar.
+ * @param {HandlerCallback<Req, Res>} callback - A função do manipulador.
+ * @param {MiddlewareFCDoc} [doc] - Documentação OpenAPI para este handler.
+ * @returns {Handler<Req, Res>} Uma instância de Handler.
+ *
+ * @example
+ * import { handler } from '@ismael1361/router';
+ *
+ * const getUserProfile = handler<{ user: { id: string } }>((req, res) => {
+ *   res.json({ profile: req.user });
+ * });
+ *
+ * // Em uma rota:
+ * // router.get('/profile').middleware(authMiddleware).handler(getUserProfile);
+ */
+function handler(callback, doc) {
+    return new Handler(callback, undefined, doc);
+}
+/**
+ * Cria uma nova instância do Router com um caminho de prefixo.
+ * Ideal para agrupar rotas relacionadas sob um namespace comum (ex: '/api/v1').
+ *
+ * @template Req - Tipo de Request base para o roteador.
+ * @template Res - Tipo de Response base para o roteador.
+ * @param {string} path - O caminho do prefixo para todas as rotas definidas neste roteador.
+ * @returns {Router<Req, Res>} Uma nova instância do Router com o prefixo definido.
+ *
+ * @example
+ * import { route, create } from '@ismael1361/router';
+ *
+ * const mainRouter = create();
+ * const usersRouter = route('/users'); // Todas as rotas aqui começarão com /users
+ *
+ * usersRouter.get('/:id').handler((req, res) => { ... }); // Acessível em GET /users/:id
+ *
+ * mainRouter.by(usersRouter); // Anexa o grupo de rotas ao roteador principal
+ */
+function route(path) {
+    return new Router(path);
+}
+/**
+ * Um helper para criar um objeto de documentação OpenAPI de forma limpa.
+ * Ele separa a operação principal dos componentes e os mescla em um único objeto.
+ *
+ * @param {MiddlewareFCDoc | swaggerJSDoc.Operation} operation - O objeto de operação OpenAPI (summary, tags, responses, etc.).
+ * @param {swaggerJSDoc.Components} [components={}] - Componentes OpenAPI (schemas, securitySchemes, etc.).
+ * @returns {MiddlewareFCDoc} Um objeto de documentação formatado.
+ *
+ * @example
+ * import { doc } from '@ismael1361/router';
+ *
+ * const userDoc = doc({
+ *   summary: 'Cria um usuário',
+ *   tags: ['Users'],
+ *   requestBody: { $ref: '#/components/requestBodies/UserBody' }
+ * }, {
+ *   requestBodies: { UserBody: { content: { 'application/json': { schema: { type: 'object' } } } } }
+ * });
+ *
+ * // router.post('/users', userDoc).handler(...)
+ */
+function doc(operation, components = {}) {
+    const { components: comp = {} } = operation, op = __rest(operation, ["components"]);
+    return Object.assign(Object.assign({}, op), { components: joinObject(comp, components) });
+}
+var index = {
+    create,
+    route,
+    middleware,
+    handler,
+    doc,
+};
+
+export { create, index as default, doc, handler, middleware, route };
 //# sourceMappingURL=index.esm.js.map

package/dist/index.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.esm.js","sources":["../src/index.ts"],"sourcesContent":[null],"names":["create","Router","middleware","callback","doc","Middleware","undefined","handler","Handler","route","path","operation","components","comp","op","__rest","Object","assign","joinObject","index"],"mappings":"iaAqCgBA,IACf,OAAO,IAAIC,CACZ,CA2BgB,SAAAC,EAA2EC,EAAwCC,GAClI,OAAO,IAAIC,EAAWF,OAAUG,EAAWF,EAC5C,CAsBgB,SAAAG,EAAwEJ,EAAqCC,GAC5H,OAAO,IAAII,EAAQL,OAAUG,EAAWF,EACzC,CAqBM,SAAUK,EAAsEC,GACrF,OAAO,IAAIT,EAAiBS,EAC7B,UAuBgBN,EAAIO,EAAqDC,EAAsC,IAC9G,MAAQA,WAAYC,EAAO,CAAA,GAAcF,EAAPG,EAAOC,EAAAJ,EAAnC,CAAA,eACN,OAAYK,OAAAC,OAAAD,OAAAC,OAAA,CAAA,EAAAH,GAAI,CAAAF,WAAYM,EAAWL,EAAMD,IAC9C,CAEA,IAAeO,EAAA,CACdnB,SACAS,QACAP,aACAK,UACAH"}
+{"version":3,"file":"index.esm.js","sources":["../src/index.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;;;;AAgBA;;;;;;;;;;;;;;;;;;;;AAoBG;SACa,MAAM,GAAA;IACrB,OAAO,IAAI,MAAM,EAAY,CAAC;AAC/B,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;AAwBG;AACa,SAAA,UAAU,CAAiE,QAAsC,EAAE,GAAqB,EAAA;IACvJ,OAAO,IAAI,UAAU,CAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC;AACjD,CAAC;AAED;;;;;;;;;;;;;;;;;;;AAmBG;AACa,SAAA,OAAO,CAAiE,QAAmC,EAAE,GAAqB,EAAA;IACjJ,OAAO,IAAI,OAAO,CAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC;AAC9C,CAAC;AAED;;;;;;;;;;;;;;;;;;AAkBG;AACG,SAAU,KAAK,CAAiE,IAAa,EAAA;AAClG,IAAA,OAAO,IAAI,MAAM,CAAW,IAAI,CAAC,CAAC;AACnC,CAAC;AAED;;;;;;;;;;;;;;;;;;;;AAoBG;SACa,GAAG,CAAC,SAAmD,EAAE,aAAsC,EAAE,EAAA;AAChH,IAAA,MAAM,EAAE,UAAU,EAAE,IAAI,GAAG,EAAE,EAAA,GAAY,SAAS,EAAhB,EAAE,GAAK,MAAA,CAAA,SAAS,EAA5C,CAAA,YAAA,CAAgC,CAAY,CAAC;IACnD,OAAY,MAAA,CAAA,MAAA,CAAA,MAAA,CAAA,MAAA,CAAA,EAAA,EAAA,EAAE,CAAE,EAAA,EAAA,UAAU,EAAE,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,EAAG,CAAA,CAAA;AAC5D,CAAC;AAED,YAAe;IACd,MAAM;IACN,KAAK;IACL,UAAU;IACV,OAAO;IACP,GAAG;CACH;;;;"}

package/dist/index.js

@@ -1,2 +1,153 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("./node_modules/tslib/tslib.es6.js"),r=require("./router.js"),t=require("./middleware.js"),o=require("./handler.js"),s=require("./utils.js"),n=require("./HandleError.js"),d=require("./Middlewares.js");function i(){return new r.Router}function u(e,r){return new t.Middleware(e,void 0,r)}function a(e,r){return new o.Handler(e,void 0,r)}function l(e){return new r.Router(e)}function c(r,t={}){const{components:o={}}=r,n=e.__rest(r,["components"]);return Object.assign(Object.assign({},n),{components:s.joinObject(o,t)})}var p={create:i,route:l,middleware:u,handler:a,doc:c};exports.getCorsHeaders=s.getCorsHeaders,exports.getCorsOptions=s.getCorsOptions,exports.HandleError=n.HandleError,exports.Middlewares=d,exports.create=i,exports.default=p,exports.doc=c,exports.handler=a,exports.middleware=u,exports.route=l;
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var tslib_es6 = require('./node_modules/tslib/tslib.es6.js');
+var router = require('./router.js');
+var middleware$1 = require('./middleware.js');
+var handler$1 = require('./handler.js');
+var utils = require('./utils.js');
+var HandleError = require('./HandleError.js');
+var Middlewares = require('./Middlewares.js');
+
+/**
+ * Inicializa uma nova instância do Router. Este é o ponto de partida para construir sua aplicação.
+ *
+ * @template Req - Tipo de Request base para o roteador.
+ * @template Res - Tipo de Response base para o roteador.
+ * @returns {Router<Req, Res>} Uma nova instância do Router.
+ *
+ * @example
+ * import { create } from '@ismael1361/router';
+ *
+ * const router = create();
+ *
+ * router.get('/ping', { summary: 'Verifica a saúde da API' })
+ *   .handler((req, res) => {
+ *     res.send('pong');
+ *   });
+ *
+ * router.listen(3000, () => {
+ *   console.log('Servidor rodando na porta 3000');
+ * });
+ */
+function create() {
+    return new router.Router();
+}
+/**
+ * Cria um componente de middleware reutilizável e encadeável.
+ * Permite encapsular lógicas (como autenticação, logging) e sua documentação OpenAPI associada.
+ *
+ * @template Req - Tipo de Request que o middleware espera ou adiciona.
+ * @template Res - Tipo de Response que o middleware pode modificar.
+ * @param {MiddlewareCallback<Req, Res>} callback - A função de middleware.
+ * @param {MiddlewareFCDoc} [doc] - A documentação OpenAPI para este middleware.
+ * @returns {Middleware<Req, Res>} Uma instância de Middleware que pode ser usada em rotas.
+ *
+ * @example
+ * import { middleware } from '@ismael1361/router';
+ *
+ * // Middleware que adiciona um usuário à requisição
+ * const authMiddleware = middleware<{ user: { id: string } }>((req, res, next) => {
+ *   req.user = { id: 'user-123' };
+ *   next();
+ * }, {
+ *   security: [{ bearerAuth: [] }], // Documenta o requisito de segurança
+ *   responses: { '401': { description: 'Não autorizado' } }
+ * });
+ *
+ * // Em uma rota:
+ * // router.get('/profile').middleware(authMiddleware).handler(...)
+ */
+function middleware(callback, doc) {
+    return new middleware$1.Middleware(callback, undefined, doc);
+}
+/**
+ * Cria um componente de manipulador (handler/controller) reutilizável.
+ * Útil para definir a lógica final de uma rota em um local separado e importá-la onde for necessário.
+ *
+ * @template Req - Tipo de Request que o handler espera.
+ * @template Res - Tipo de Response que o handler pode modificar.
+ * @param {HandlerCallback<Req, Res>} callback - A função do manipulador.
+ * @param {MiddlewareFCDoc} [doc] - Documentação OpenAPI para este handler.
+ * @returns {Handler<Req, Res>} Uma instância de Handler.
+ *
+ * @example
+ * import { handler } from '@ismael1361/router';
+ *
+ * const getUserProfile = handler<{ user: { id: string } }>((req, res) => {
+ *   res.json({ profile: req.user });
+ * });
+ *
+ * // Em uma rota:
+ * // router.get('/profile').middleware(authMiddleware).handler(getUserProfile);
+ */
+function handler(callback, doc) {
+    return new handler$1.Handler(callback, undefined, doc);
+}
+/**
+ * Cria uma nova instância do Router com um caminho de prefixo.
+ * Ideal para agrupar rotas relacionadas sob um namespace comum (ex: '/api/v1').
+ *
+ * @template Req - Tipo de Request base para o roteador.
+ * @template Res - Tipo de Response base para o roteador.
+ * @param {string} path - O caminho do prefixo para todas as rotas definidas neste roteador.
+ * @returns {Router<Req, Res>} Uma nova instância do Router com o prefixo definido.
+ *
+ * @example
+ * import { route, create } from '@ismael1361/router';
+ *
+ * const mainRouter = create();
+ * const usersRouter = route('/users'); // Todas as rotas aqui começarão com /users
+ *
+ * usersRouter.get('/:id').handler((req, res) => { ... }); // Acessível em GET /users/:id
+ *
+ * mainRouter.by(usersRouter); // Anexa o grupo de rotas ao roteador principal
+ */
+function route(path) {
+    return new router.Router(path);
+}
+/**
+ * Um helper para criar um objeto de documentação OpenAPI de forma limpa.
+ * Ele separa a operação principal dos componentes e os mescla em um único objeto.
+ *
+ * @param {MiddlewareFCDoc | swaggerJSDoc.Operation} operation - O objeto de operação OpenAPI (summary, tags, responses, etc.).
+ * @param {swaggerJSDoc.Components} [components={}] - Componentes OpenAPI (schemas, securitySchemes, etc.).
+ * @returns {MiddlewareFCDoc} Um objeto de documentação formatado.
+ *
+ * @example
+ * import { doc } from '@ismael1361/router';
+ *
+ * const userDoc = doc({
+ *   summary: 'Cria um usuário',
+ *   tags: ['Users'],
+ *   requestBody: { $ref: '#/components/requestBodies/UserBody' }
+ * }, {
+ *   requestBodies: { UserBody: { content: { 'application/json': { schema: { type: 'object' } } } } }
+ * });
+ *
+ * // router.post('/users', userDoc).handler(...)
+ */
+function doc(operation, components = {}) {
+    const { components: comp = {} } = operation, op = tslib_es6.__rest(operation, ["components"]);
+    return Object.assign(Object.assign({}, op), { components: utils.joinObject(comp, components) });
+}
+var index = {
+    create,
+    route,
+    middleware,
+    handler,
+    doc,
+};
+
+exports.getCorsHeaders = utils.getCorsHeaders;
+exports.getCorsOptions = utils.getCorsOptions;
+exports.HandleError = HandleError.HandleError;
+exports.Middlewares = Middlewares;
+exports.create = create;
+exports.default = index;
+exports.doc = doc;
+exports.handler = handler;
+exports.middleware = middleware;
+exports.route = route;
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../src/index.ts"],"sourcesContent":[null],"names":["create","Router","middleware","callback","doc","Middleware","undefined","handler","Handler","route","path","operation","components","comp","op","__rest","Object","assign","joinObject","index"],"mappings":"oSAqCgBA,IACf,OAAO,IAAIC,EAAMA,MAClB,CA2BgB,SAAAC,EAA2EC,EAAwCC,GAClI,OAAO,IAAIC,EAAAA,WAAWF,OAAUG,EAAWF,EAC5C,CAsBgB,SAAAG,EAAwEJ,EAAqCC,GAC5H,OAAO,IAAII,EAAAA,QAAQL,OAAUG,EAAWF,EACzC,CAqBM,SAAUK,EAAsEC,GACrF,OAAO,IAAIT,EAAAA,OAAiBS,EAC7B,UAuBgBN,EAAIO,EAAqDC,EAAsC,IAC9G,MAAQA,WAAYC,EAAO,CAAA,GAAcF,EAAPG,EAAOC,SAAAJ,EAAnC,CAAA,eACN,OAAYK,OAAAC,OAAAD,OAAAC,OAAA,CAAA,EAAAH,GAAI,CAAAF,WAAYM,EAAUA,WAACL,EAAMD,IAC9C,CAEA,IAAeO,EAAA,CACdnB,SACAS,QACAP,aACAK,UACAH"}
+{"version":3,"file":"index.js","sources":["../src/index.ts"],"sourcesContent":[null],"names":["Router","Middleware","Handler","__rest","joinObject"],"mappings":";;;;;;;;;;;;AAgBA;;;;;;;;;;;;;;;;;;;;AAoBG;SACa,MAAM,GAAA;IACrB,OAAO,IAAIA,aAAM,EAAY,CAAC;AAC/B,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;AAwBG;AACa,SAAA,UAAU,CAAiE,QAAsC,EAAE,GAAqB,EAAA;IACvJ,OAAO,IAAIC,uBAAU,CAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC;AACjD,CAAC;AAED;;;;;;;;;;;;;;;;;;;AAmBG;AACa,SAAA,OAAO,CAAiE,QAAmC,EAAE,GAAqB,EAAA;IACjJ,OAAO,IAAIC,iBAAO,CAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC;AAC9C,CAAC;AAED;;;;;;;;;;;;;;;;;;AAkBG;AACG,SAAU,KAAK,CAAiE,IAAa,EAAA;AAClG,IAAA,OAAO,IAAIF,aAAM,CAAW,IAAI,CAAC,CAAC;AACnC,CAAC;AAED;;;;;;;;;;;;;;;;;;;;AAoBG;SACa,GAAG,CAAC,SAAmD,EAAE,aAAsC,EAAE,EAAA;AAChH,IAAA,MAAM,EAAE,UAAU,EAAE,IAAI,GAAG,EAAE,EAAA,GAAY,SAAS,EAAhB,EAAE,GAAKG,gBAAA,CAAA,SAAS,EAA5C,CAAA,YAAA,CAAgC,CAAY,CAAC;IACnD,OAAY,MAAA,CAAA,MAAA,CAAA,MAAA,CAAA,MAAA,CAAA,EAAA,EAAA,EAAE,CAAE,EAAA,EAAA,UAAU,EAAEC,gBAAU,CAAC,IAAI,EAAE,UAAU,CAAC,EAAG,CAAA,CAAA;AAC5D,CAAC;AAED,YAAe;IACd,MAAM;IACN,KAAK;IACL,UAAU;IACV,OAAO;IACP,GAAG;CACH;;;;;;;;;;;;;"}

package/dist/middleware.esm.js

@@ -1,2 +1,152 @@
-import{Router as e}from"./router.esm.js";import{joinDocs as r,createDynamicMiddleware as t}from"./utils.esm.js";import{uuidv4 as s}from"@ismael1361/utils";import{Handler as o}from"./handler.esm.js";class i{constructor(o,u=new e,d){this.router=u,this.doc=d,o&&(o instanceof i?o.router.layers.forEach(e=>{this.router.layers.push(e)}):(o.id=o.id||s("-"),this.doc=o.doc=r((null==o?void 0:o.doc)||{},d||{}),this.router.middleware(t(o))))}middleware(e,r){return new i(e,this.router,r)}execute(e,r,t){return this.router.executeMiddlewares(e,r,t)}}class u extends i{middleware(e,r){return new u(e,this.router,r)}handler(e,r){return new o(e,this.router,r)}execute(e,r,t){return super.execute(e,r,t)}}export{u as Middleware,i as RequestMiddleware};
+import { Router } from './router.esm.js';
+import { joinDocs, createDynamicMiddleware } from './utils.esm.js';
+import { uuidv4 } from '@ismael1361/utils';
+import { Handler } from './handler.esm.js';
+
+/**
+ * @internal
+ * Uma classe base para a construção de componentes de middleware encadeáveis.
+ * Esta classe não deve ser instanciada diretamente pelo usuário final.
+ */
+class RequestMiddleware {
+    /** @internal */
+    constructor(callback, router = new Router(), doc) {
+        this.router = router;
+        this.doc = doc;
+        if (callback) {
+            if (callback instanceof RequestMiddleware) {
+                callback.router.layers.forEach((l) => {
+                    this.router.layers.push(l);
+                });
+            }
+            else {
+                callback.id = callback.id || uuidv4("-");
+                this.doc = callback.doc = joinDocs((callback === null || callback === void 0 ? void 0 : callback.doc) || {}, doc || {});
+                this.router.middleware(createDynamicMiddleware(callback));
+            }
+        }
+    }
+    /**
+     * Anexa um middleware adicional à cadeia.
+     *
+     * @template Req - Tipo de Request estendido pelo novo middleware.
+     * @template Res - Tipo de Response estendido pelo novo middleware.
+     * @param {MiddlewareCallback<Rq & Req, Rs & Res>} callback - A função de middleware a ser adicionada.
+     * @param {MiddlewareFCDoc} [doc] - Documentação OpenAPI opcional para o middleware.
+     * @returns {RequestMiddleware<Rq & Req, Rs & Res>} Uma nova instância de `RequestMiddleware` com o middleware adicionado.
+     */
+    middleware(callback, doc) {
+        return new RequestMiddleware(callback, this.router, doc);
+    }
+    /**
+     * Executa a cadeia de middlewares encapsulados por esta instância.
+     * Este método é projetado principalmente para testes, permitindo que você execute a lógica do middleware
+     * de forma isolada, sem a necessidade de um servidor HTTP real.
+     *
+     * @param {Rq} request - O objeto de requisição (ou um mock para testes).
+     * @param {Rs} response - O objeto de resposta (ou um mock para testes).
+     * @param {NextFunction} next - A função `next` a ser chamada ao final da cadeia de middlewares.
+     * @returns {Promise<void>} Uma promessa que resolve quando a execução da cadeia é concluída.
+     *
+     * @example
+     * import { middleware, Request, Response, NextFunction } from '@ismael1361/router';
+     *
+     * // 1. Crie um componente de middleware reutilizável
+     * const myMiddleware = middleware<{ user: { id: string } }>((req, res, next) => {
+     *   req.user = { id: 'test-user' };
+     *   next();
+     * });
+     *
+     * // 2. Crie mocks para os objetos de requisição, resposta e next (ex: com Jest)
+     * const mockRequest = {} as Request & { user: { id: string } };
+     * const mockResponse = {} as Response;
+     * const mockNext = () => {}; // ou jest.fn()
+     *
+     * // 3. Execute o middleware programaticamente e verifique o resultado
+     * await myMiddleware.execute(mockRequest, mockResponse, mockNext);
+     * console.log(mockRequest.user); // Output: { id: 'test-user' }
+     */
+    execute(request, response, next) {
+        return this.router.executeMiddlewares(request, response, next);
+    }
+}
+/**
+ * Representa um componente de middleware encadeável que pode ser finalizado com um manipulador (handler).
+ * Uma instância desta classe é retornada pela função `middleware()`. Permite criar componentes
+ * de lógica reutilizáveis que podem ser aplicados a múltiplas rotas.
+ *
+ * @example
+ * // middlewares/auth.ts
+ * import { middleware, Request } from '@ismael1361/router';
+ *
+ * // Define um tipo para a requisição após a autenticação
+ * interface AuthRequest extends Request {
+ *   user: { id: string; roles: string[] };
+ * }
+ *
+ * // Cria um componente de middleware reutilizável
+ * export const authMiddleware = middleware<AuthRequest>((req, res, next) => {
+ *   // Lógica de autenticação...
+ *   req.user = { id: 'user-123', roles: ['admin'] };
+ *   next();
+ * }, {
+ *   security: [{ bearerAuth: [] }], // Documentação OpenAPI
+ *   responses: { '401': { description: 'Não autorizado' } }
+ * });
+ *
+ * // routes/users.ts
+ * // router.get('/profile')
+ * //   .middleware(authMiddleware) // Aplica o middleware
+ * //   .handler((req, res) => {
+ * //     // req.user está disponível e tipado aqui
+ * //     res.json(req.user);
+ * //   });
+ */
+class Middleware extends RequestMiddleware {
+    /**
+     * Anexa um middleware adicional à cadeia.
+     *
+     * @returns {Middleware<Rq & Req, Rs & Res>} Uma nova instância de `Middleware` para continuar o encadeamento.
+     */
+    middleware(callback, doc) {
+        return new Middleware(callback, this.router, doc);
+    }
+    /**
+     * Finaliza a cadeia de middlewares e define um manipulador (handler) final.
+     * Isso transforma o componente de middleware em um componente de manipulador completo e reutilizável.
+     *
+     * @returns {Handler<Rq & Req, Rs & Res>} Uma instância de `Handler` que encapsula toda a cadeia.
+     */
+    handler(callback, doc) {
+        return new Handler(callback, this.router, doc);
+    }
+    /**
+     * Executa a cadeia de middlewares encapsulados por esta instância de `Middleware`.
+     * Este método é herdado e serve principalmente para fins de teste, permitindo invocar
+     * a lógica do middleware de forma isolada.
+     *
+     * @param {Rq} request - O objeto de requisição (ou um mock para testes).
+     * @param {Rs} response - O objeto de resposta (ou um mock para testes).
+     * @param {NextFunction} next - A função `next` a ser chamada ao final da cadeia.
+     * @returns {Promise<void>} Uma promessa que resolve quando a execução é concluída.
+     *
+     * @example
+     * import { middleware, Request, Response, NextFunction } from '@ismael1361/router';
+     *
+     * const addDataMiddleware = middleware<{ customData: string }>((req, res, next) => {
+     *   req.customData = 'Hello from middleware!';
+     *   next();
+     * });
+     *
+     * const mockRequest = {} as Request & { customData: string };
+     *
+     * await addDataMiddleware.execute(mockRequest, {} as Response, () => {});
+     * console.log(mockRequest.customData); // Output: 'Hello from middleware!'
+     */
+    execute(request, response, next) {
+        return super.execute(request, response, next);
+    }
+}
+
+export { Middleware, RequestMiddleware };
 //# sourceMappingURL=middleware.esm.js.map

package/dist/middleware.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"middleware.esm.js","sources":["../src/middleware.ts"],"sourcesContent":[null],"names":["RequestMiddleware","constructor","callback","router","Router","doc","this","layers","forEach","l","push","id","uuidv4","joinDocs","middleware","createDynamicMiddleware","execute","request","response","next","executeMiddlewares","Middleware","handler","Handler","super"],"mappings":"4MAWaA,EAEZ,WAAAC,CAAYC,EAA2DC,EAAiB,IAAIC,EAAiBC,GAAtCC,KAAMH,OAANA,EAAsCG,KAAGD,IAAHA,EACxGH,IACCA,aAAoBF,EACvBE,EAASC,OAAOI,OAAOC,QAASC,IAC/BH,KAAKH,OAAOI,OAAOG,KAAKD,MAGzBP,EAASS,GAAKT,EAASS,IAAMC,EAAO,KACpCN,KAAKD,IAAMH,EAASG,IAAMQ,GAASX,aAAA,EAAAA,EAAUG,MAAO,GAAIA,GAAO,CAAA,GAC/DC,KAAKH,OAAOW,WAAWC,EAAwBb,KAGjD,CAWD,UAAAY,CAA2EZ,EAAkDG,GAC5H,OAAO,IAAIL,EAAkBE,EAAUI,KAAKH,OAAQE,EACpD,CA8BD,OAAAW,CAAQC,EAAaC,EAAcC,GAClC,OAAOb,KAAKH,OAAOiB,mBAAmBH,EAASC,EAAUC,EACzD,EAmCI,MAAOE,UAAiFrB,EAM7F,UAAAc,CAA2EZ,EAAkDG,GAC5H,OAAO,IAAIgB,EAAWnB,EAAUI,KAAKH,OAAQE,EAC7C,CAQD,OAAAiB,CAAwEpB,EAA+CG,GACtH,OAAO,IAAIkB,EAAQrB,EAAUI,KAAKH,OAAQE,EAC1C,CAyBD,OAAAW,CAAQC,EAAaC,EAAcC,GAClC,OAAOK,MAAMR,QAAQC,EAASC,EAAUC,EACxC"}
+{"version":3,"file":"middleware.esm.js","sources":["../src/middleware.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;AAMA;;;;AAIG;MACU,iBAAiB,CAAA;;AAE7B,IAAA,WAAA,CAAY,QAAgD,EAAW,MAAA,GAAiB,IAAI,MAAM,EAAE,EAAS,GAAqB,EAAA;QAA3D,IAAM,CAAA,MAAA,GAAN,MAAM,CAAuB;QAAS,IAAG,CAAA,GAAA,GAAH,GAAG,CAAkB;QACjI,IAAI,QAAQ,EAAE;AACb,YAAA,IAAI,QAAQ,YAAY,iBAAiB,EAAE;gBAC1C,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,KAAI;oBACpC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAC5B,iBAAC,CAAC,CAAC;aACH;iBAAM;gBACN,QAAQ,CAAC,EAAE,GAAG,QAAQ,CAAC,EAAE,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC;gBACzC,IAAI,CAAC,GAAG,GAAG,QAAQ,CAAC,GAAG,GAAG,QAAQ,CAAC,CAAA,QAAQ,KAAA,IAAA,IAAR,QAAQ,KAAR,KAAA,CAAA,GAAA,KAAA,CAAA,GAAA,QAAQ,CAAE,GAAG,KAAI,EAAE,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;gBACnE,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,uBAAuB,CAAC,QAAQ,CAAC,CAAC,CAAC;aAC1D;SACD;KACD;AAED;;;;;;;;AAQG;IACH,UAAU,CAAiE,QAAgD,EAAE,GAAqB,EAAA;QACjJ,OAAO,IAAI,iBAAiB,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KACzD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BG;AACH,IAAA,OAAO,CAAC,OAAW,EAAE,QAAY,EAAE,IAAkB,EAAA;AACpD,QAAA,OAAO,IAAI,CAAC,MAAM,CAAC,kBAAkB,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;KAC/D;AACD,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+BG;AACG,MAAO,UAAyE,SAAQ,iBAAyB,CAAA;AACtH;;;;AAIG;IACH,UAAU,CAAiE,QAAgD,EAAE,GAAqB,EAAA;QACjJ,OAAO,IAAI,UAAU,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KAClD;AAED;;;;;AAKG;IACH,OAAO,CAAiE,QAA6C,EAAE,GAAqB,EAAA;QAC3I,OAAO,IAAI,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KAC/C;AAED;;;;;;;;;;;;;;;;;;;;;;AAsBG;AACH,IAAA,OAAO,CAAC,OAAW,EAAE,QAAY,EAAE,IAAkB,EAAA;QACpD,OAAO,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;KAC9C;AACD;;;;"}

package/dist/middleware.js

@@ -1,2 +1,155 @@
-"use strict";var e=require("./router.js"),r=require("./utils.js"),t=require("@ismael1361/utils"),s=require("./handler.js");class u{constructor(s,i=new e.Router,d){this.router=i,this.doc=d,s&&(s instanceof u?s.router.layers.forEach(e=>{this.router.layers.push(e)}):(s.id=s.id||t.uuidv4("-"),this.doc=s.doc=r.joinDocs((null==s?void 0:s.doc)||{},d||{}),this.router.middleware(r.createDynamicMiddleware(s))))}middleware(e,r){return new u(e,this.router,r)}execute(e,r,t){return this.router.executeMiddlewares(e,r,t)}}class i extends u{middleware(e,r){return new i(e,this.router,r)}handler(e,r){return new s.Handler(e,this.router,r)}execute(e,r,t){return super.execute(e,r,t)}}exports.Middleware=i,exports.RequestMiddleware=u;
+'use strict';
+
+var router = require('./router.js');
+var utils$1 = require('./utils.js');
+var utils = require('@ismael1361/utils');
+var handler = require('./handler.js');
+
+/**
+ * @internal
+ * Uma classe base para a construção de componentes de middleware encadeáveis.
+ * Esta classe não deve ser instanciada diretamente pelo usuário final.
+ */
+class RequestMiddleware {
+    /** @internal */
+    constructor(callback, router$1 = new router.Router(), doc) {
+        this.router = router$1;
+        this.doc = doc;
+        if (callback) {
+            if (callback instanceof RequestMiddleware) {
+                callback.router.layers.forEach((l) => {
+                    this.router.layers.push(l);
+                });
+            }
+            else {
+                callback.id = callback.id || utils.uuidv4("-");
+                this.doc = callback.doc = utils$1.joinDocs((callback === null || callback === void 0 ? void 0 : callback.doc) || {}, doc || {});
+                this.router.middleware(utils$1.createDynamicMiddleware(callback));
+            }
+        }
+    }
+    /**
+     * Anexa um middleware adicional à cadeia.
+     *
+     * @template Req - Tipo de Request estendido pelo novo middleware.
+     * @template Res - Tipo de Response estendido pelo novo middleware.
+     * @param {MiddlewareCallback<Rq & Req, Rs & Res>} callback - A função de middleware a ser adicionada.
+     * @param {MiddlewareFCDoc} [doc] - Documentação OpenAPI opcional para o middleware.
+     * @returns {RequestMiddleware<Rq & Req, Rs & Res>} Uma nova instância de `RequestMiddleware` com o middleware adicionado.
+     */
+    middleware(callback, doc) {
+        return new RequestMiddleware(callback, this.router, doc);
+    }
+    /**
+     * Executa a cadeia de middlewares encapsulados por esta instância.
+     * Este método é projetado principalmente para testes, permitindo que você execute a lógica do middleware
+     * de forma isolada, sem a necessidade de um servidor HTTP real.
+     *
+     * @param {Rq} request - O objeto de requisição (ou um mock para testes).
+     * @param {Rs} response - O objeto de resposta (ou um mock para testes).
+     * @param {NextFunction} next - A função `next` a ser chamada ao final da cadeia de middlewares.
+     * @returns {Promise<void>} Uma promessa que resolve quando a execução da cadeia é concluída.
+     *
+     * @example
+     * import { middleware, Request, Response, NextFunction } from '@ismael1361/router';
+     *
+     * // 1. Crie um componente de middleware reutilizável
+     * const myMiddleware = middleware<{ user: { id: string } }>((req, res, next) => {
+     *   req.user = { id: 'test-user' };
+     *   next();
+     * });
+     *
+     * // 2. Crie mocks para os objetos de requisição, resposta e next (ex: com Jest)
+     * const mockRequest = {} as Request & { user: { id: string } };
+     * const mockResponse = {} as Response;
+     * const mockNext = () => {}; // ou jest.fn()
+     *
+     * // 3. Execute o middleware programaticamente e verifique o resultado
+     * await myMiddleware.execute(mockRequest, mockResponse, mockNext);
+     * console.log(mockRequest.user); // Output: { id: 'test-user' }
+     */
+    execute(request, response, next) {
+        return this.router.executeMiddlewares(request, response, next);
+    }
+}
+/**
+ * Representa um componente de middleware encadeável que pode ser finalizado com um manipulador (handler).
+ * Uma instância desta classe é retornada pela função `middleware()`. Permite criar componentes
+ * de lógica reutilizáveis que podem ser aplicados a múltiplas rotas.
+ *
+ * @example
+ * // middlewares/auth.ts
+ * import { middleware, Request } from '@ismael1361/router';
+ *
+ * // Define um tipo para a requisição após a autenticação
+ * interface AuthRequest extends Request {
+ *   user: { id: string; roles: string[] };
+ * }
+ *
+ * // Cria um componente de middleware reutilizável
+ * export const authMiddleware = middleware<AuthRequest>((req, res, next) => {
+ *   // Lógica de autenticação...
+ *   req.user = { id: 'user-123', roles: ['admin'] };
+ *   next();
+ * }, {
+ *   security: [{ bearerAuth: [] }], // Documentação OpenAPI
+ *   responses: { '401': { description: 'Não autorizado' } }
+ * });
+ *
+ * // routes/users.ts
+ * // router.get('/profile')
+ * //   .middleware(authMiddleware) // Aplica o middleware
+ * //   .handler((req, res) => {
+ * //     // req.user está disponível e tipado aqui
+ * //     res.json(req.user);
+ * //   });
+ */
+class Middleware extends RequestMiddleware {
+    /**
+     * Anexa um middleware adicional à cadeia.
+     *
+     * @returns {Middleware<Rq & Req, Rs & Res>} Uma nova instância de `Middleware` para continuar o encadeamento.
+     */
+    middleware(callback, doc) {
+        return new Middleware(callback, this.router, doc);
+    }
+    /**
+     * Finaliza a cadeia de middlewares e define um manipulador (handler) final.
+     * Isso transforma o componente de middleware em um componente de manipulador completo e reutilizável.
+     *
+     * @returns {Handler<Rq & Req, Rs & Res>} Uma instância de `Handler` que encapsula toda a cadeia.
+     */
+    handler(callback, doc) {
+        return new handler.Handler(callback, this.router, doc);
+    }
+    /**
+     * Executa a cadeia de middlewares encapsulados por esta instância de `Middleware`.
+     * Este método é herdado e serve principalmente para fins de teste, permitindo invocar
+     * a lógica do middleware de forma isolada.
+     *
+     * @param {Rq} request - O objeto de requisição (ou um mock para testes).
+     * @param {Rs} response - O objeto de resposta (ou um mock para testes).
+     * @param {NextFunction} next - A função `next` a ser chamada ao final da cadeia.
+     * @returns {Promise<void>} Uma promessa que resolve quando a execução é concluída.
+     *
+     * @example
+     * import { middleware, Request, Response, NextFunction } from '@ismael1361/router';
+     *
+     * const addDataMiddleware = middleware<{ customData: string }>((req, res, next) => {
+     *   req.customData = 'Hello from middleware!';
+     *   next();
+     * });
+     *
+     * const mockRequest = {} as Request & { customData: string };
+     *
+     * await addDataMiddleware.execute(mockRequest, {} as Response, () => {});
+     * console.log(mockRequest.customData); // Output: 'Hello from middleware!'
+     */
+    execute(request, response, next) {
+        return super.execute(request, response, next);
+    }
+}
+
+exports.Middleware = Middleware;
+exports.RequestMiddleware = RequestMiddleware;
 //# sourceMappingURL=middleware.js.map

package/dist/middleware.js.map

@@ -1 +1 @@
-{"version":3,"file":"middleware.js","sources":["../src/middleware.ts"],"sourcesContent":[null],"names":["RequestMiddleware","constructor","callback","router","Router","doc","this","layers","forEach","l","push","id","uuidv4","joinDocs","middleware","createDynamicMiddleware","execute","request","response","next","executeMiddlewares","Middleware","handler","Handler","super"],"mappings":"iIAWaA,EAEZ,WAAAC,CAAYC,EAA2DC,EAAiB,IAAIC,EAAMA,OAAWC,GAAtCC,KAAMH,OAANA,EAAsCG,KAAGD,IAAHA,EACxGH,IACCA,aAAoBF,EACvBE,EAASC,OAAOI,OAAOC,QAASC,IAC/BH,KAAKH,OAAOI,OAAOG,KAAKD,MAGzBP,EAASS,GAAKT,EAASS,IAAMC,EAAMA,OAAC,KACpCN,KAAKD,IAAMH,EAASG,IAAMQ,EAAAA,UAASX,aAAA,EAAAA,EAAUG,MAAO,GAAIA,GAAO,CAAA,GAC/DC,KAAKH,OAAOW,WAAWC,EAAAA,wBAAwBb,KAGjD,CAWD,UAAAY,CAA2EZ,EAAkDG,GAC5H,OAAO,IAAIL,EAAkBE,EAAUI,KAAKH,OAAQE,EACpD,CA8BD,OAAAW,CAAQC,EAAaC,EAAcC,GAClC,OAAOb,KAAKH,OAAOiB,mBAAmBH,EAASC,EAAUC,EACzD,EAmCI,MAAOE,UAAiFrB,EAM7F,UAAAc,CAA2EZ,EAAkDG,GAC5H,OAAO,IAAIgB,EAAWnB,EAAUI,KAAKH,OAAQE,EAC7C,CAQD,OAAAiB,CAAwEpB,EAA+CG,GACtH,OAAO,IAAIkB,EAAOA,QAACrB,EAAUI,KAAKH,OAAQE,EAC1C,CAyBD,OAAAW,CAAQC,EAAaC,EAAcC,GAClC,OAAOK,MAAMR,QAAQC,EAASC,EAAUC,EACxC"}
+{"version":3,"file":"middleware.js","sources":["../src/middleware.ts"],"sourcesContent":[null],"names":["router","Router","uuidv4","joinDocs","createDynamicMiddleware","Handler"],"mappings":";;;;;;;AAMA;;;;AAIG;MACU,iBAAiB,CAAA;;AAE7B,IAAA,WAAA,CAAY,QAAgD,EAAWA,QAAA,GAAiB,IAAIC,aAAM,EAAE,EAAS,GAAqB,EAAA;QAA3D,IAAM,CAAA,MAAA,GAAND,QAAM,CAAuB;QAAS,IAAG,CAAA,GAAA,GAAH,GAAG,CAAkB;QACjI,IAAI,QAAQ,EAAE;AACb,YAAA,IAAI,QAAQ,YAAY,iBAAiB,EAAE;gBAC1C,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,KAAI;oBACpC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAC5B,iBAAC,CAAC,CAAC;aACH;iBAAM;gBACN,QAAQ,CAAC,EAAE,GAAG,QAAQ,CAAC,EAAE,IAAIE,YAAM,CAAC,GAAG,CAAC,CAAC;gBACzC,IAAI,CAAC,GAAG,GAAG,QAAQ,CAAC,GAAG,GAAGC,gBAAQ,CAAC,CAAA,QAAQ,KAAA,IAAA,IAAR,QAAQ,KAAR,KAAA,CAAA,GAAA,KAAA,CAAA,GAAA,QAAQ,CAAE,GAAG,KAAI,EAAE,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;gBACnE,IAAI,CAAC,MAAM,CAAC,UAAU,CAACC,+BAAuB,CAAC,QAAQ,CAAC,CAAC,CAAC;aAC1D;SACD;KACD;AAED;;;;;;;;AAQG;IACH,UAAU,CAAiE,QAAgD,EAAE,GAAqB,EAAA;QACjJ,OAAO,IAAI,iBAAiB,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KACzD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BG;AACH,IAAA,OAAO,CAAC,OAAW,EAAE,QAAY,EAAE,IAAkB,EAAA;AACpD,QAAA,OAAO,IAAI,CAAC,MAAM,CAAC,kBAAkB,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;KAC/D;AACD,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+BG;AACG,MAAO,UAAyE,SAAQ,iBAAyB,CAAA;AACtH;;;;AAIG;IACH,UAAU,CAAiE,QAAgD,EAAE,GAAqB,EAAA;QACjJ,OAAO,IAAI,UAAU,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KAClD;AAED;;;;;AAKG;IACH,OAAO,CAAiE,QAA6C,EAAE,GAAqB,EAAA;QAC3I,OAAO,IAAIC,eAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KAC/C;AAED;;;;;;;;;;;;;;;;;;;;;;AAsBG;AACH,IAAA,OAAO,CAAC,OAAW,EAAE,QAAY,EAAE,IAAkB,EAAA;QACpD,OAAO,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;KAC9C;AACD;;;;;"}