@ismael1361/router 1.1.1 → 1.1.2

package/dist/Middlewares.js

@@ -1,2 +1,195 @@
-"use strict";var e=require("./node_modules/tslib/tslib.es6.js"),t=require("stream"),r=require("./HandleError.js"),n=require("body-parser");exports.cors=(e="*")=>(t,r,n)=>{const o=t.headers.origin;if(r.setHeader("Access-Control-Allow-Origin","*"===e?"*":o||"*"),r.setHeader("Access-Control-Allow-Methods","GET,PUT,POST,DELETE,OPTIONS"),r.setHeader("Access-Control-Allow-Headers","Content-Type, Authorization, Content-Length, Accept, Origin, X-Requested-With"),r.setHeader("Access-Control-Allow-Credentials","true"),r.setHeader("Access-Control-Expose-Headers","Content-Length, Content-Range"),"OPTIONS"===t.method)return r.status(200).end();n()},exports.files=(...n)=>(o,s,i)=>e.__awaiter(void 0,void 0,void 0,function*(){n=n.map(e=>e.trim().toLowerCase());const e=yield new Promise((e,t)=>{const r=[];o.on("data",e=>r.push(Buffer.from(e))),o.on("end",()=>e(Buffer.concat(r))),o.on("error",t)});if(!o.headers["content-type"]||!o.headers["content-type"].startsWith("multipart/form-data"))throw new r.HandleError("Invalid content type","BAD_REQUEST",400);const s=o.headers["content-type"].split("boundary=")[1],a=e.toString("binary").split(`--${s}`),l=[];for(const e of a)if(e.includes('filename="')){const[r,...o]=e.split("\r\n\r\n"),s=o.join("\r\n\r\n").trim(),i=Buffer.from(s,"binary"),a=r.match(/name="([^"]+)"/),d=r.match(/filename="([^"]+)"/),c=r.match(/Content-Type: ([^\r\n]+)/);if(a&&d&&c){const e=a[1],r=d[1],o=c[1].trim().toLowerCase();if(n.length>0&&!n.includes(o))continue;l.push({fieldname:e,originalname:r,encoding:"",mimetype:o,size:s.length,stream:new t.Readable,destination:"",filename:r,path:"",buffer:i.slice(0,-2)})}}if(!l.length)throw new r.HandleError("No files were uploaded","BAD_REQUEST",400);o.file=l[0],o.files=l,i()}),exports.json=e=>n.json(e),exports.raw=e=>n.raw(e),exports.text=e=>n.text(e),exports.urlencoded=e=>n.urlencoded(e);
+'use strict';
+
+var tslib_es6 = require('./node_modules/tslib/tslib.es6.js');
+var stream = require('stream');
+var HandleError = require('./HandleError.js');
+var BodyParser = require('body-parser');
+
+/**
+ * Retorna um middleware que analisa corpos de requisição JSON.
+ * Este middleware é um wrapper em torno do `body-parser.json()`.
+ *
+ * @param {OptionsJson} [options] - Opções de configuração para o `body-parser`.
+ * @returns {MiddlewareFC<Request, Response>} Uma função de middleware do Express.
+ *
+ * @example
+ * import { create, Middlewares } from '@ismael1361/router';
+ *
+ * const app = create();
+ *
+ * // Aplica o middleware para analisar JSON em todas as rotas
+ * app.middleware(Middlewares.json());
+ *
+ * app.post('/data').handler((req, res) => {
+ *   // req.body agora contém o objeto JSON enviado
+ *   res.json({ received: req.body });
+ * });
+ */
+const json = (options) => {
+    return BodyParser.json(options);
+};
+/**
+ * Retorna um middleware que analisa corpos de requisição como um Buffer.
+ * Este middleware é um wrapper em torno do `body-parser.raw()`.
+ *
+ * @param {Options} [options] - Opções de configuração para o `body-parser`.
+ * @returns {MiddlewareFC<Request, Response>} Uma função de middleware do Express.
+ *
+ * @example
+ * import { create, Middlewares } from '@ismael1361/router';
+ *
+ * const app = create();
+ *
+ * // Analisa corpos do tipo 'application/octet-stream' como Buffer
+ * app.middleware(Middlewares.raw({ type: 'application/octet-stream', limit: '10mb' }));
+ *
+ * app.post('/upload-raw').handler((req, res) => {
+ *   // req.body é um Buffer com os dados brutos
+ *   console.log('Buffer recebido:', req.body.length, 'bytes');
+ *   res.send('Raw data received');
+ * });
+ */
+const raw = (options) => {
+    return BodyParser.raw(options);
+};
+/**
+ * Retorna um middleware que analisa corpos de requisição como texto.
+ * Este middleware é um wrapper em torno do `body-parser.text()`.
+ *
+ * @param {OptionsText} [options] - Opções de configuração para o `body-parser`.
+ * @returns {MiddlewareFC<Request, Response>} Uma função de middleware do Express.
+ *
+ * @example
+ * import { create, Middlewares } from '@ismael1361/router';
+ *
+ * const app = create();
+ *
+ * // Analisa corpos do tipo 'text/plain' como string
+ * app.middleware(Middlewares.text({ type: 'text/plain' }));
+ *
+ * app.post('/log').handler((req, res) => {
+ *   // req.body é uma string com o conteúdo do corpo
+ *   console.log('Log recebido:', req.body);
+ *   res.send('Log received');
+ * });
+ */
+const text = (options) => {
+    return BodyParser.text(options);
+};
+/**
+ * Retorna um middleware que analisa corpos de requisição com o formato `application/x-www-form-urlencoded`.
+ * Este middleware é um wrapper em torno do `body-parser.urlencoded()`.
+ *
+ * @param {OptionsUrlencoded} [options] - Opções de configuração para o `body-parser`.
+ * @returns {MiddlewareFC<Request, Response>} Uma função de middleware do Express.
+ *
+ * @example
+ * import { create, Middlewares } from '@ismael1361/router';
+ *
+ * const app = create();
+ *
+ * // Aplica o middleware para analisar dados de formulário
+ * app.middleware(Middlewares.urlencoded({ extended: true }));
+ *
+ * app.post('/submit-form').handler((req, res) => {
+ *   // req.body contém os dados do formulário
+ *   res.json({ form_data: req.body });
+ * });
+ */
+const urlencoded = (options) => {
+    return BodyParser.urlencoded(options);
+};
+const cors = (allowOrigin = "*") => {
+    return (req, res, next) => {
+        // Configuração mais robusta de CORS
+        const origin = req.headers.origin;
+        // Definir headers CORS
+        res.setHeader("Access-Control-Allow-Origin", allowOrigin === "*" ? "*" : origin || "*");
+        res.setHeader("Access-Control-Allow-Methods", "GET,PUT,POST,DELETE,OPTIONS");
+        res.setHeader("Access-Control-Allow-Headers", "Content-Type, Authorization, Content-Length, Accept, Origin, X-Requested-With");
+        res.setHeader("Access-Control-Allow-Credentials", "true");
+        res.setHeader("Access-Control-Expose-Headers", "Content-Length, Content-Range");
+        // Responder a requisições OPTIONS
+        if (req.method === "OPTIONS") {
+            return res.status(200).end();
+        }
+        next();
+    };
+};
+/**
+ * Middleware para analisar arquivos de uma solicitação.
+ * Os arquivos com suas informações são armazenados no objeto `req.files`, sua tipagem: `FileInfo[]`.
+ * Ao usar esse middleware, é necessário que o corpo da requisição seja um objeto `FormData`.
+ * Se caso o middleware não encontrar nenhum arquivo, ele irá lançar um erro.
+ *
+ * @example
+ * ```ts
+ * Router.middleware(Middleware.files()).handler(async (req, res) => {
+ * });
+ *
+ * Router.middleware(Middleware.files(Middleware.files('image/jpeg', 'image/png', 'application/pdf')).handler(async (req, res) => {
+ * });
+ * ```
+ */
+const files = (...allowedMimes) => {
+    return (req, res, next) => tslib_es6.__awaiter(void 0, void 0, void 0, function* () {
+        allowedMimes = allowedMimes.map((mime) => mime.trim().toLowerCase());
+        const rawBody = yield new Promise((resolve, reject) => {
+            const chunks = [];
+            req.on("data", (chunk) => chunks.push(Buffer.from(chunk)));
+            req.on("end", () => resolve(Buffer.concat(chunks)));
+            req.on("error", reject);
+        });
+        if (!req.headers["content-type"] || !req.headers["content-type"].startsWith("multipart/form-data")) {
+            throw new HandleError.HandleError("Invalid content type", "BAD_REQUEST", 400);
+        }
+        const boundary = req.headers["content-type"].split("boundary=")[1];
+        const parts = rawBody.toString("binary").split(`--${boundary}`);
+        const files = [];
+        for (const part of parts) {
+            if (part.includes('filename="')) {
+                const [header, ...body] = part.split("\r\n\r\n");
+                const content = body.join("\r\n\r\n").trim();
+                const buffer = Buffer.from(content, "binary");
+                // Extrair nome do campo e nome do arquivo
+                const fieldnameMatch = header.match(/name="([^"]+)"/);
+                const filenameMatch = header.match(/filename="([^"]+)"/);
+                const mimetypeMatch = header.match(/Content-Type: ([^\r\n]+)/);
+                if (fieldnameMatch && filenameMatch && mimetypeMatch) {
+                    const fieldname = fieldnameMatch[1];
+                    const filename = filenameMatch[1];
+                    const contentType = mimetypeMatch[1].trim().toLowerCase();
+                    if (allowedMimes.length > 0 && !allowedMimes.includes(contentType)) {
+                        continue;
+                    }
+                    files.push({
+                        fieldname: fieldname,
+                        originalname: filename,
+                        encoding: "",
+                        mimetype: contentType,
+                        size: content.length,
+                        stream: new stream.Readable(),
+                        destination: "",
+                        filename: filename,
+                        path: "",
+                        buffer: buffer.slice(0, -2),
+                    });
+                }
+            }
+        }
+        if (!files.length) {
+            throw new HandleError.HandleError("No files were uploaded", "BAD_REQUEST", 400);
+        }
+        req.file = files[0];
+        req.files = files;
+        next();
+    });
+};
+
+exports.cors = cors;
+exports.files = files;
+exports.json = json;
+exports.raw = raw;
+exports.text = text;
+exports.urlencoded = urlencoded;
 //# sourceMappingURL=Middlewares.js.map

package/dist/Middlewares.js.map

@@ -1 +1 @@
-{"version":3,"file":"Middlewares.js","sources":["../src/Middlewares.ts"],"sourcesContent":[null],"names":["allowOrigin","req","res","next","origin","headers","setHeader","method","status","end","allowedMimes","__awaiter","map","mime","trim","toLowerCase","rawBody","Promise","resolve","reject","chunks","on","chunk","push","Buffer","from","concat","startsWith","HandleError","boundary","split","parts","toString","files","part","includes","header","body","content","join","buffer","fieldnameMatch","match","filenameMatch","mimetypeMatch","fieldname","filename","contentType","length","originalname","encoding","mimetype","size","stream","Readable","destination","path","slice","file","options","BodyParser","json","raw","text","urlencoded"],"mappings":"wJAuGoB,CAACA,EAAsB,MACnC,CAACC,EAAKC,EAAKC,KAEjB,MAAMC,EAASH,EAAII,QAAQD,OAU3B,GAPAF,EAAII,UAAU,8BAA+C,MAAhBN,EAAsB,IAAMI,GAAU,KACnFF,EAAII,UAAU,+BAAgC,+BAC9CJ,EAAII,UAAU,+BAAgC,iFAC9CJ,EAAII,UAAU,mCAAoC,QAClDJ,EAAII,UAAU,gCAAiC,iCAG5B,YAAfL,EAAIM,OACP,OAAOL,EAAIM,OAAO,KAAKC,MAGxBN,mBAmBmB,IAAIO,IACjB,CAAOT,EAAKC,EAAKC,IAAQQ,EAAAA,eAAA,OAAA,OAAA,EAAA,YAC/BD,EAAeA,EAAaE,IAAKC,GAASA,EAAKC,OAAOC,eAEtD,MAAMC,QAAgB,IAAIC,QAAgB,CAACC,EAASC,KACnD,MAAMC,EAAmB,GACzBnB,EAAIoB,GAAG,OAASC,GAAUF,EAAOG,KAAKC,OAAOC,KAAKH,KAClDrB,EAAIoB,GAAG,MAAO,IAAMH,EAAQM,OAAOE,OAAON,KAC1CnB,EAAIoB,GAAG,QAASF,KAGjB,IAAKlB,EAAII,QAAQ,kBAAoBJ,EAAII,QAAQ,gBAAgBsB,WAAW,uBAC3E,MAAM,IAAIC,EAAAA,YAAY,uBAAwB,cAAe,KAG9D,MAAMC,EAAW5B,EAAII,QAAQ,gBAAgByB,MAAM,aAAa,GAC1DC,EAAQf,EAAQgB,SAAS,UAAUF,MAAM,KAAKD,KAC9CI,EAAoB,GAE1B,IAAK,MAAMC,KAAQH,EAClB,GAAIG,EAAKC,SAAS,cAAe,CAChC,MAAOC,KAAWC,GAAQH,EAAKJ,MAAM,YAC/BQ,EAAUD,EAAKE,KAAK,YAAYzB,OAChC0B,EAAShB,OAAOC,KAAKa,EAAS,UAG9BG,EAAiBL,EAAOM,MAAM,kBAC9BC,EAAgBP,EAAOM,MAAM,sBAC7BE,EAAgBR,EAAOM,MAAM,4BAEnC,GAAID,GAAkBE,GAAiBC,EAAe,CACrD,MAAMC,EAAYJ,EAAe,GAC3BK,EAAWH,EAAc,GACzBI,EAAcH,EAAc,GAAG9B,OAAOC,cAC5C,GAAIL,EAAasC,OAAS,IAAMtC,EAAayB,SAASY,GACrD,SAEDd,EAAMV,KAAK,CACVsB,UAAWA,EACXI,aAAcH,EACdI,SAAU,GACVC,SAAUJ,EACVK,KAAMd,EAAQU,OACdK,OAAQ,IAAIC,EAAAA,SACZC,YAAa,GACbT,SAAUA,EACVU,KAAM,GACNhB,OAAQA,EAAOiB,MAAM,GAAI,IAE1B,CACD,CAGF,IAAKxB,EAAMe,OACV,MAAM,IAAIpB,EAAAA,YAAY,yBAA0B,cAAe,KAGhE3B,EAAIyD,KAAOzB,EAAM,GACjBhC,EAAIgC,MAAQA,EAEZ9B,GACD,gBA/KoBwD,GACbC,EAAWC,KAAKF,eAwBJA,GACZC,EAAWE,IAAIH,gBAwBFA,GACbC,EAAWG,KAAKJ,sBAuBGA,GACnBC,EAAWI,WAAWL"}
+{"version":3,"file":"Middlewares.js","sources":["../src/Middlewares.ts"],"sourcesContent":[null],"names":["__awaiter","HandleError","Readable"],"mappings":"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"}

package/dist/handler.esm.js

@@ -1,2 +1,171 @@
-import{__rest as e}from"./node_modules/tslib/tslib.es6.esm.js";import{joinDocs as s,createDynamicMiddleware as t,joinObject as r}from"./utils.esm.js";import{RequestMiddleware as i}from"./middleware.esm.js";import{Router as d}from"./router.esm.js";import{uuidv4 as o}from"@ismael1361/utils";class h extends i{constructor(e,s,t,r){super(void 0,e),this.router=e,this.type=s,this.path=t,this.doc=r,this.middlewares=[]}middleware(e,r){return e instanceof i?e.router.layers.filter(({type:e,handle:s})=>"middleware"===e&&!!s).map(({handle:e})=>e).forEach(e=>this.middlewares.push(...e)):this.middlewares.push(t(e)),r&&(this.doc=s(this.doc||{},r)),this}handler(i,d){i instanceof a?i.router.layers.filter(({type:e,handle:s})=>"middleware"===e&&!!s).map(({handle:e})=>e).forEach(e=>this.middlewares.push(...e)):this.middlewares.push(t(i));const o=this.router.layers[this.type](this.path,this.middlewares,s(this.doc||{},d||{}));return{type:this.type,path:this.path,middlewares:this.middlewares,handler:this.middlewares.length>0?this.middlewares[this.middlewares.length-1]:void 0,doc(t,i={}){const{components:d={}}=t,h=e(t,["components"]);return o.doc=s(o.doc,Object.assign(Object.assign({},h),{components:r(d,i)})),this}}}}class a{constructor(e,r=new d,i){this.router=r,this.doc=i,e&&(e instanceof a?e.router.layers.forEach(e=>{this.router.layers.push(e)}):(e.id=e.id||o("-"),e.doc=s((null==e?void 0:e.doc)||{},i||{}),this.router.middleware(t(e))))}execute(e,s,t){return this.router.executeMiddlewares(e,s,t)}}export{a as Handler,h as RequestHandler};
+import { __rest } from './node_modules/tslib/tslib.es6.esm.js';
+import { joinDocs, createDynamicMiddleware, joinObject } from './utils.esm.js';
+import { RequestMiddleware } from './middleware.esm.js';
+import { Router } from './router.esm.js';
+import { uuidv4 } from '@ismael1361/utils';
+
+/**
+ * Representa um construtor de rotas encadeável.
+ *
+ * Esta classe não deve ser instanciada diretamente. Em vez disso, uma instância é retornada
+ * quando você chama um método de rota como `.get()`, `.post()`, etc., em uma instância de `Router`.
+ *
+ * Ela permite encadear middlewares específicos para a rota e, finalmente, definir o manipulador
+ * da rota e sua documentação.
+ *
+ * @example
+ * const router = create();
+ *
+ * // A chamada a `router.post()` retorna uma instância de RequestHandler.
+ * router.post('/users')
+ *   // .middleware() aplica um middleware apenas a esta rota.
+ *   .middleware(validationMiddleware)
+ *   // .handler() define o controlador final da rota.
+ *   .handler((req, res) => {
+ *     res.status(201).json({ id: 1, ...req.body });
+ *   })
+ *   // .doc() anexa a documentação OpenAPI ao endpoint finalizado.
+ *   .doc({
+ *     summary: 'Cria um novo usuário',
+ *     tags: ['Users'],
+ *     body: { description: 'Dados do usuário' }
+ *   });
+ */
+class RequestHandler extends RequestMiddleware {
+    /** @internal */
+    constructor(router, type, path, doc) {
+        super(undefined, router);
+        this.router = router;
+        this.type = type;
+        this.path = path;
+        this.doc = doc;
+        this.middlewares = [];
+    }
+    /**
+     * Anexa um middleware que será executado especificamente para esta rota.
+     * Múltiplos middlewares podem ser encadeados.
+     *
+     * @template Req - Tipo de Request estendido pelo middleware.
+     * @template Res - Tipo de Response estendido pelo middleware.
+     * @param {MiddlewareCallback<Rq & Req, Rs & Res>} callback - A função de middleware a ser aplicada.
+     * @param {MiddlewareFCDoc} [doc] - Documentação OpenAPI opcional para este middleware.
+     * @returns {RequestHandler<Rq & Req, Rs & Res>} A mesma instância de `RequestHandler` para permitir encadeamento.
+     */
+    middleware(callback, doc) {
+        if (callback instanceof RequestMiddleware) {
+            callback.router.layers
+                .filter(({ type, handle }) => type === "middleware" && !!handle)
+                .map(({ handle }) => handle)
+                .forEach((handle) => this.middlewares.push(...handle));
+        }
+        else {
+            this.middlewares.push(createDynamicMiddleware(callback));
+        }
+        if (doc) {
+            this.doc = joinDocs(this.doc || {}, doc);
+        }
+        return this;
+    }
+    /**
+     * Define a função de manipulador (controller) final para a rota.
+     * Esta chamada finaliza a cadeia de middlewares e registra a rota no roteador.
+     *
+     * @template Req - Tipo de Request estendido pelo manipulador.
+     * @template Res - Tipo de Response estendido pelo manipulador.
+     * @param {HandlerCallback<Rq & Req, Rs & Res>} callback - A função que processará a requisição.
+     * @param {MiddlewareFCDoc} [doc] - Documentação OpenAPI opcional para este manipulador.
+     * @returns {RouterProps} Um objeto que contém as propriedades da rota e um método `.doc()` para adicionar a documentação final.
+     */
+    handler(callback, doc) {
+        if (callback instanceof Handler) {
+            callback.router.layers
+                .filter(({ type, handle }) => type === "middleware" && !!handle)
+                .map(({ handle }) => handle)
+                .forEach((handle) => this.middlewares.push(...handle));
+        }
+        else {
+            this.middlewares.push(createDynamicMiddleware(callback));
+        }
+        const route = this.router.layers[this.type](this.path, this.middlewares, joinDocs(this.doc || {}, doc || {}));
+        return {
+            type: this.type,
+            path: this.path,
+            middlewares: this.middlewares,
+            handler: this.middlewares.length > 0 ? this.middlewares[this.middlewares.length - 1] : undefined,
+            doc(operation, components = {}) {
+                const { components: comp = {} } = operation, op = __rest(operation, ["components"]);
+                route.doc = joinDocs(route.doc, Object.assign(Object.assign({}, op), { components: joinObject(comp, components) }));
+                return this;
+            },
+        };
+    }
+}
+/**
+ * Cria um componente de manipulador (handler) reutilizável.
+ *
+ * Esta classe encapsula uma função de manipulador, permitindo que ela seja combinada
+ * com outros middlewares e reutilizada em diferentes rotas.
+ *
+ * @example
+ * // handler.ts
+ * export const getUserProfile = handler<{ user: { id: string } }>((req, res) => {
+ *   res.json({ user: req.user });
+ * });
+ *
+ * // routes.ts
+ * router.get('/profile')
+ *   .middleware(authMiddleware) // Adiciona `req.user`
+ *   .handler(getUserProfile);   // Reutiliza o handler
+ */
+class Handler {
+    /** @internal */
+    constructor(callback, router = new Router(), doc) {
+        this.router = router;
+        this.doc = doc;
+        if (callback) {
+            if (callback instanceof Handler) {
+                callback.router.layers.forEach((l) => {
+                    this.router.layers.push(l);
+                });
+            }
+            else {
+                callback.id = callback.id || uuidv4("-");
+                callback.doc = joinDocs((callback === null || callback === void 0 ? void 0 : callback.doc) || {}, doc || {});
+                this.router.middleware(createDynamicMiddleware(callback));
+            }
+        }
+    }
+    /**
+     * Executa a cadeia de middlewares e o manipulador final encapsulados por esta instância de `Handler`.
+     * Este método é útil para testes unitários ou para invocar programaticamente a lógica do handler
+     * fora do ciclo de requisição/resposta padrão do Express.
+     *
+     * @param {Rq} request - O objeto de requisição (ou um mock dele).
+     * @param {Rs} response - O objeto de resposta (ou um mock dele).
+     * @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 da cadeia é concluída.
+     *
+     * @example
+     * import { handler, Request, Response, NextFunction } from '@ismael1361/router';
+     *
+     * // 1. Crie um handler reutilizável
+     * const myHandler = handler<{ user: { id: string } }>((req, res) => {
+     *   res.json({ userId: req.user.id });
+     * });
+     *
+     * // 2. Crie mocks para os objetos de requisição e resposta (ex: com Jest)
+     * const mockRequest = { user: { id: '123' } } as Request & { user: { id: string } };
+     * const mockResponse = { json: (data) => console.log(data) } as Response;
+     * const mockNext = () => {};
+     *
+     * // 3. Execute o handler programaticamente
+     * await myHandler.execute(mockRequest, mockResponse, mockNext);
+     * // Output: { userId: '123' }
+     */
+    execute(request, response, next) {
+        return this.router.executeMiddlewares(request, response, next);
+    }
+}
+
+export { Handler, RequestHandler };
 //# sourceMappingURL=handler.esm.js.map

package/dist/handler.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"handler.esm.js","sources":["../src/handler.ts"],"sourcesContent":[null],"names":["RequestHandler","RequestMiddleware","constructor","router","type","path","doc","super","undefined","this","middlewares","middleware","callback","layers","filter","handle","map","forEach","push","createDynamicMiddleware","joinDocs","handler","Handler","route","length","operation","components","comp","op","__rest","Object","assign","joinObject","Router","l","id","uuidv4","execute","request","response","next","executeMiddlewares"],"mappings":"kSAkCM,MAAOA,UAAqFC,EAIjG,WAAAC,CAA4BC,EAAgCC,EAAqCC,EAAqBC,GACrHC,WAAMC,EAAWL,GADUM,KAAMN,OAANA,EAAgCM,KAAIL,KAAJA,EAAqCK,KAAIJ,KAAJA,EAAqBI,KAAGH,IAAHA,EAH7GG,KAAWC,YAA6B,EAKhD,CAYD,UAAAC,CAA2EC,EAAkDN,GAY5H,OAXIM,aAAoBX,EACvBW,EAAST,OAAOU,OACdC,OAAO,EAAGV,OAAMW,YAAsB,eAATX,KAA2BW,GACxDC,IAAI,EAAGD,YAAaA,GACpBE,QAASF,GAAWN,KAAKC,YAAYQ,QAAQH,IAE/CN,KAAKC,YAAYQ,KAAKC,EAAwBP,IAE3CN,IACHG,KAAKH,IAAMc,EAASX,KAAKH,KAAO,CAAA,EAAIA,IAE9BG,IACP,CAYD,OAAAY,CAAwET,EAA+CN,GAClHM,aAAoBU,EACvBV,EAAST,OAAOU,OACdC,OAAO,EAAGV,OAAMW,YAAsB,eAATX,KAA2BW,GACxDC,IAAI,EAAGD,YAAaA,GACpBE,QAASF,GAAWN,KAAKC,YAAYQ,QAAQH,IAE/CN,KAAKC,YAAYQ,KAAKC,EAAwBP,IAG/C,MAAMW,EAAQd,KAAKN,OAAOU,OAAOJ,KAAKL,MAAMK,KAAKJ,KAAMI,KAAKC,YAAaU,EAASX,KAAKH,KAAO,CAAA,EAAIA,GAAO,CAAE,IAE3G,MAAO,CACNF,KAAMK,KAAKL,KACXC,KAAMI,KAAKJ,KACXK,YAAaD,KAAKC,YAClBW,QAASZ,KAAKC,YAAYc,OAAS,EAAIf,KAAKC,YAAYD,KAAKC,YAAYc,OAAS,QAAKhB,EACvF,GAAAF,CAAImB,EAAqDC,EAAsC,IAC9F,MAAQA,WAAYC,EAAO,CAAA,GAAcF,EAAPG,EAAOC,EAAAJ,EAAnC,CAAA,eAGN,OADAF,EAAMjB,IAAMc,EAASG,EAAMjB,IAAUwB,OAAAC,OAAAD,OAAAC,OAAA,CAAA,EAAAH,IAAIF,WAAYM,EAAWL,EAAMD,MAC/DjB,IACP,EAEF,QAoBWa,EAEZ,WAAApB,CAAYU,EAAwDT,EAAiB,IAAI8B,EAAiB3B,GAAtCG,KAAMN,OAANA,EAAsCM,KAAGH,IAAHA,EACrGM,IACCA,aAAoBU,EACvBV,EAAST,OAAOU,OAAOI,QAASiB,IAC/BzB,KAAKN,OAAOU,OAAOK,KAAKgB,MAGzBtB,EAASuB,GAAKvB,EAASuB,IAAMC,EAAO,KACpCxB,EAASN,IAAMc,GAASR,aAAQ,EAARA,EAAUN,MAAO,CAAA,EAAIA,GAAO,CAAA,GACpDG,KAAKN,OAAOQ,WAAWQ,EAAwBP,KAGjD,CA6BD,OAAAyB,CAAQC,EAAaC,EAAcC,GAClC,OAAO/B,KAAKN,OAAOsC,mBAAmBH,EAASC,EAAUC,EACzD"}
+{"version":3,"file":"handler.esm.js","sources":["../src/handler.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/handler.js

@@ -1,2 +1,174 @@
-"use strict";var e=require("./node_modules/tslib/tslib.es6.js"),s=require("./utils.js"),t=require("./middleware.js"),r=require("./router.js"),i=require("@ismael1361/utils");class d extends t.RequestMiddleware{constructor(e,s,t,r){super(void 0,e),this.router=e,this.type=s,this.path=t,this.doc=r,this.middlewares=[]}middleware(e,r){return e instanceof t.RequestMiddleware?e.router.layers.filter(({type:e,handle:s})=>"middleware"===e&&!!s).map(({handle:e})=>e).forEach(e=>this.middlewares.push(...e)):this.middlewares.push(s.createDynamicMiddleware(e)),r&&(this.doc=s.joinDocs(this.doc||{},r)),this}handler(t,r){t instanceof a?t.router.layers.filter(({type:e,handle:s})=>"middleware"===e&&!!s).map(({handle:e})=>e).forEach(e=>this.middlewares.push(...e)):this.middlewares.push(s.createDynamicMiddleware(t));const i=this.router.layers[this.type](this.path,this.middlewares,s.joinDocs(this.doc||{},r||{}));return{type:this.type,path:this.path,middlewares:this.middlewares,handler:this.middlewares.length>0?this.middlewares[this.middlewares.length-1]:void 0,doc(t,r={}){const{components:d={}}=t,a=e.__rest(t,["components"]);return i.doc=s.joinDocs(i.doc,Object.assign(Object.assign({},a),{components:s.joinObject(d,r)})),this}}}}class a{constructor(e,t=new r.Router,d){this.router=t,this.doc=d,e&&(e instanceof a?e.router.layers.forEach(e=>{this.router.layers.push(e)}):(e.id=e.id||i.uuidv4("-"),e.doc=s.joinDocs((null==e?void 0:e.doc)||{},d||{}),this.router.middleware(s.createDynamicMiddleware(e))))}execute(e,s,t){return this.router.executeMiddlewares(e,s,t)}}exports.Handler=a,exports.RequestHandler=d;
+'use strict';
+
+var tslib_es6 = require('./node_modules/tslib/tslib.es6.js');
+var utils$1 = require('./utils.js');
+var middleware = require('./middleware.js');
+var router = require('./router.js');
+var utils = require('@ismael1361/utils');
+
+/**
+ * Representa um construtor de rotas encadeável.
+ *
+ * Esta classe não deve ser instanciada diretamente. Em vez disso, uma instância é retornada
+ * quando você chama um método de rota como `.get()`, `.post()`, etc., em uma instância de `Router`.
+ *
+ * Ela permite encadear middlewares específicos para a rota e, finalmente, definir o manipulador
+ * da rota e sua documentação.
+ *
+ * @example
+ * const router = create();
+ *
+ * // A chamada a `router.post()` retorna uma instância de RequestHandler.
+ * router.post('/users')
+ *   // .middleware() aplica um middleware apenas a esta rota.
+ *   .middleware(validationMiddleware)
+ *   // .handler() define o controlador final da rota.
+ *   .handler((req, res) => {
+ *     res.status(201).json({ id: 1, ...req.body });
+ *   })
+ *   // .doc() anexa a documentação OpenAPI ao endpoint finalizado.
+ *   .doc({
+ *     summary: 'Cria um novo usuário',
+ *     tags: ['Users'],
+ *     body: { description: 'Dados do usuário' }
+ *   });
+ */
+class RequestHandler extends middleware.RequestMiddleware {
+    /** @internal */
+    constructor(router, type, path, doc) {
+        super(undefined, router);
+        this.router = router;
+        this.type = type;
+        this.path = path;
+        this.doc = doc;
+        this.middlewares = [];
+    }
+    /**
+     * Anexa um middleware que será executado especificamente para esta rota.
+     * Múltiplos middlewares podem ser encadeados.
+     *
+     * @template Req - Tipo de Request estendido pelo middleware.
+     * @template Res - Tipo de Response estendido pelo middleware.
+     * @param {MiddlewareCallback<Rq & Req, Rs & Res>} callback - A função de middleware a ser aplicada.
+     * @param {MiddlewareFCDoc} [doc] - Documentação OpenAPI opcional para este middleware.
+     * @returns {RequestHandler<Rq & Req, Rs & Res>} A mesma instância de `RequestHandler` para permitir encadeamento.
+     */
+    middleware(callback, doc) {
+        if (callback instanceof middleware.RequestMiddleware) {
+            callback.router.layers
+                .filter(({ type, handle }) => type === "middleware" && !!handle)
+                .map(({ handle }) => handle)
+                .forEach((handle) => this.middlewares.push(...handle));
+        }
+        else {
+            this.middlewares.push(utils$1.createDynamicMiddleware(callback));
+        }
+        if (doc) {
+            this.doc = utils$1.joinDocs(this.doc || {}, doc);
+        }
+        return this;
+    }
+    /**
+     * Define a função de manipulador (controller) final para a rota.
+     * Esta chamada finaliza a cadeia de middlewares e registra a rota no roteador.
+     *
+     * @template Req - Tipo de Request estendido pelo manipulador.
+     * @template Res - Tipo de Response estendido pelo manipulador.
+     * @param {HandlerCallback<Rq & Req, Rs & Res>} callback - A função que processará a requisição.
+     * @param {MiddlewareFCDoc} [doc] - Documentação OpenAPI opcional para este manipulador.
+     * @returns {RouterProps} Um objeto que contém as propriedades da rota e um método `.doc()` para adicionar a documentação final.
+     */
+    handler(callback, doc) {
+        if (callback instanceof Handler) {
+            callback.router.layers
+                .filter(({ type, handle }) => type === "middleware" && !!handle)
+                .map(({ handle }) => handle)
+                .forEach((handle) => this.middlewares.push(...handle));
+        }
+        else {
+            this.middlewares.push(utils$1.createDynamicMiddleware(callback));
+        }
+        const route = this.router.layers[this.type](this.path, this.middlewares, utils$1.joinDocs(this.doc || {}, doc || {}));
+        return {
+            type: this.type,
+            path: this.path,
+            middlewares: this.middlewares,
+            handler: this.middlewares.length > 0 ? this.middlewares[this.middlewares.length - 1] : undefined,
+            doc(operation, components = {}) {
+                const { components: comp = {} } = operation, op = tslib_es6.__rest(operation, ["components"]);
+                route.doc = utils$1.joinDocs(route.doc, Object.assign(Object.assign({}, op), { components: utils$1.joinObject(comp, components) }));
+                return this;
+            },
+        };
+    }
+}
+/**
+ * Cria um componente de manipulador (handler) reutilizável.
+ *
+ * Esta classe encapsula uma função de manipulador, permitindo que ela seja combinada
+ * com outros middlewares e reutilizada em diferentes rotas.
+ *
+ * @example
+ * // handler.ts
+ * export const getUserProfile = handler<{ user: { id: string } }>((req, res) => {
+ *   res.json({ user: req.user });
+ * });
+ *
+ * // routes.ts
+ * router.get('/profile')
+ *   .middleware(authMiddleware) // Adiciona `req.user`
+ *   .handler(getUserProfile);   // Reutiliza o handler
+ */
+class Handler {
+    /** @internal */
+    constructor(callback, router$1 = new router.Router(), doc) {
+        this.router = router$1;
+        this.doc = doc;
+        if (callback) {
+            if (callback instanceof Handler) {
+                callback.router.layers.forEach((l) => {
+                    this.router.layers.push(l);
+                });
+            }
+            else {
+                callback.id = callback.id || utils.uuidv4("-");
+                callback.doc = utils$1.joinDocs((callback === null || callback === void 0 ? void 0 : callback.doc) || {}, doc || {});
+                this.router.middleware(utils$1.createDynamicMiddleware(callback));
+            }
+        }
+    }
+    /**
+     * Executa a cadeia de middlewares e o manipulador final encapsulados por esta instância de `Handler`.
+     * Este método é útil para testes unitários ou para invocar programaticamente a lógica do handler
+     * fora do ciclo de requisição/resposta padrão do Express.
+     *
+     * @param {Rq} request - O objeto de requisição (ou um mock dele).
+     * @param {Rs} response - O objeto de resposta (ou um mock dele).
+     * @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 da cadeia é concluída.
+     *
+     * @example
+     * import { handler, Request, Response, NextFunction } from '@ismael1361/router';
+     *
+     * // 1. Crie um handler reutilizável
+     * const myHandler = handler<{ user: { id: string } }>((req, res) => {
+     *   res.json({ userId: req.user.id });
+     * });
+     *
+     * // 2. Crie mocks para os objetos de requisição e resposta (ex: com Jest)
+     * const mockRequest = { user: { id: '123' } } as Request & { user: { id: string } };
+     * const mockResponse = { json: (data) => console.log(data) } as Response;
+     * const mockNext = () => {};
+     *
+     * // 3. Execute o handler programaticamente
+     * await myHandler.execute(mockRequest, mockResponse, mockNext);
+     * // Output: { userId: '123' }
+     */
+    execute(request, response, next) {
+        return this.router.executeMiddlewares(request, response, next);
+    }
+}
+
+exports.Handler = Handler;
+exports.RequestHandler = RequestHandler;
 //# sourceMappingURL=handler.js.map

package/dist/handler.js.map

@@ -1 +1 @@
-{"version":3,"file":"handler.js","sources":["../src/handler.ts"],"sourcesContent":[null],"names":["RequestHandler","RequestMiddleware","constructor","router","type","path","doc","super","undefined","this","middlewares","middleware","callback","layers","filter","handle","map","forEach","push","createDynamicMiddleware","joinDocs","handler","Handler","route","length","operation","components","comp","op","__rest","Object","assign","joinObject","Router","l","id","uuidv4","execute","request","response","next","executeMiddlewares"],"mappings":"6KAkCM,MAAOA,UAAqFC,EAAAA,kBAIjG,WAAAC,CAA4BC,EAAgCC,EAAqCC,EAAqBC,GACrHC,WAAMC,EAAWL,GADUM,KAAMN,OAANA,EAAgCM,KAAIL,KAAJA,EAAqCK,KAAIJ,KAAJA,EAAqBI,KAAGH,IAAHA,EAH7GG,KAAWC,YAA6B,EAKhD,CAYD,UAAAC,CAA2EC,EAAkDN,GAY5H,OAXIM,aAAoBX,EAAAA,kBACvBW,EAAST,OAAOU,OACdC,OAAO,EAAGV,OAAMW,YAAsB,eAATX,KAA2BW,GACxDC,IAAI,EAAGD,YAAaA,GACpBE,QAASF,GAAWN,KAAKC,YAAYQ,QAAQH,IAE/CN,KAAKC,YAAYQ,KAAKC,EAAAA,wBAAwBP,IAE3CN,IACHG,KAAKH,IAAMc,WAASX,KAAKH,KAAO,CAAA,EAAIA,IAE9BG,IACP,CAYD,OAAAY,CAAwET,EAA+CN,GAClHM,aAAoBU,EACvBV,EAAST,OAAOU,OACdC,OAAO,EAAGV,OAAMW,YAAsB,eAATX,KAA2BW,GACxDC,IAAI,EAAGD,YAAaA,GACpBE,QAASF,GAAWN,KAAKC,YAAYQ,QAAQH,IAE/CN,KAAKC,YAAYQ,KAAKC,EAAAA,wBAAwBP,IAG/C,MAAMW,EAAQd,KAAKN,OAAOU,OAAOJ,KAAKL,MAAMK,KAAKJ,KAAMI,KAAKC,YAAaU,EAAQA,SAACX,KAAKH,KAAO,CAAA,EAAIA,GAAO,CAAE,IAE3G,MAAO,CACNF,KAAMK,KAAKL,KACXC,KAAMI,KAAKJ,KACXK,YAAaD,KAAKC,YAClBW,QAASZ,KAAKC,YAAYc,OAAS,EAAIf,KAAKC,YAAYD,KAAKC,YAAYc,OAAS,QAAKhB,EACvF,GAAAF,CAAImB,EAAqDC,EAAsC,IAC9F,MAAQA,WAAYC,EAAO,CAAA,GAAcF,EAAPG,EAAOC,SAAAJ,EAAnC,CAAA,eAGN,OADAF,EAAMjB,IAAMc,WAASG,EAAMjB,IAAUwB,OAAAC,OAAAD,OAAAC,OAAA,CAAA,EAAAH,IAAIF,WAAYM,EAAAA,WAAWL,EAAMD,MAC/DjB,IACP,EAEF,QAoBWa,EAEZ,WAAApB,CAAYU,EAAwDT,EAAiB,IAAI8B,EAAMA,OAAW3B,GAAtCG,KAAMN,OAANA,EAAsCM,KAAGH,IAAHA,EACrGM,IACCA,aAAoBU,EACvBV,EAAST,OAAOU,OAAOI,QAASiB,IAC/BzB,KAAKN,OAAOU,OAAOK,KAAKgB,MAGzBtB,EAASuB,GAAKvB,EAASuB,IAAMC,EAAMA,OAAC,KACpCxB,EAASN,IAAMc,EAAQA,UAACR,aAAQ,EAARA,EAAUN,MAAO,CAAA,EAAIA,GAAO,CAAA,GACpDG,KAAKN,OAAOQ,WAAWQ,EAAAA,wBAAwBP,KAGjD,CA6BD,OAAAyB,CAAQC,EAAaC,EAAcC,GAClC,OAAO/B,KAAKN,OAAOsC,mBAAmBH,EAASC,EAAUC,EACzD"}
+{"version":3,"file":"handler.js","sources":["../src/handler.ts"],"sourcesContent":[null],"names":["RequestMiddleware","createDynamicMiddleware","joinDocs","__rest","joinObject","router","Router","uuidv4"],"mappings":"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"}