@ismael1361/router 1.0.1 → 1.0.6

package/dist/Doc/index.d.ts

@@ -0,0 +1,21 @@
+import type swaggerJSDoc from "swagger-jsdoc";
+import type { ExtractScopesBySecuritySchemes, Reference, ComponentSecurity, SecuritySchemesTypes, ComponentSchema } from "./type";
+import type { MiddlewareFCDoc } from "../type";
+export declare class Doc {
+    operation: swaggerJSDoc.Operation;
+    components: swaggerJSDoc.Components;
+    constructor(operation?: swaggerJSDoc.Operation, components?: swaggerJSDoc.Components);
+    get doc(): MiddlewareFCDoc;
+    summary(summary: string): this;
+    description(description: string): this;
+    tags<T extends string>(...tags: T[]): this;
+    operationId(operationId: string): this;
+    parameter(options: swaggerJSDoc.Parameter | swaggerJSDoc.Reference): this;
+    requestBody(): void;
+    security<S extends string | ComponentSecurity<any, any>, E extends ExtractScopesBySecuritySchemes<S>>(security: S, ...scopes: E[]): this;
+    static ref<R extends string | ComponentSecurity<any, any> | ComponentSchema<any, any>>(ref: R): Reference<R>;
+    static component: {
+        securityScheme<N extends string, O extends SecuritySchemesTypes>(name: N, options: O): ComponentSecurity<N, O>;
+    };
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/Doc/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/Doc/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,YAAY,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,8BAA8B,EAAE,SAAS,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,eAAe,EAAsC,MAAM,QAAQ,CAAC;AACtK,OAAO,KAAK,EAAE,eAAe,EAAY,MAAM,SAAS,CAAC;AA2CzD,qBAAa,GAAG;IACI,SAAS,EAAE,YAAY,CAAC,SAAS;IAAc,UAAU,EAAE,YAAY,CAAC,UAAU;gBAAlF,SAAS,GAAE,YAAY,CAAC,SAAc,EAAS,UAAU,GAAE,YAAY,CAAC,UAAsB;IAEjH,IAAI,GAAG,IAAI,eAAe,CAKzB;IAED,OAAO,CAAC,OAAO,EAAE,MAAM;IAKvB,WAAW,CAAC,WAAW,EAAE,MAAM;IAK/B,IAAI,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,IAAI,EAAE,CAAC,EAAE;IAKnC,WAAW,CAAC,WAAW,EAAE,MAAM;IAK/B,SAAS,CAAC,OAAO,EAAE,YAAY,CAAC,SAAS,GAAG,YAAY,CAAC,SAAS;IAKlE,WAAW;IAEX,QAAQ,CAAC,CAAC,SAAS,MAAM,GAAG,iBAAiB,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC,SAAS,8BAA8B,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,GAAG,MAAM,EAAE,CAAC,EAAE;IAiBjI,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,MAAM,GAAG,iBAAiB,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,eAAe,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC;IAoB5G,MAAM,CAAC,SAAS;uBACA,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,oBAAoB,QAAQ,CAAC,WAAW,CAAC,GAAG,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC;MAO7G;CACF"}

package/dist/Doc/type.d.ts

@@ -0,0 +1,66 @@
+import type swaggerJSDoc from "swagger-jsdoc";
+import { Prettify } from "../type";
+export type SecuritySchemes_apiKey = {
+    type: "apiKey";
+    name: string;
+    in: "query" | "header" | "cookie";
+    description?: string;
+};
+export type SecuritySchemes_http = {
+    type: "http";
+    scheme: "basic" | "bearer" | "digest" | "ntlm";
+    bearerFormat?: "JWT" | "SAML" | "WS-Security";
+    description?: string;
+};
+export type SecuritySchemes_oauth2 = {
+    type: "oauth2";
+    flows: swaggerJSDoc.OAuthFlows;
+    description?: string;
+};
+export type SecuritySchemes_openIdConnect = {
+    type: "openIdConnect";
+    openIdConnectUrl: string;
+    description?: string;
+};
+export type SecuritySchemes_mutualTLS = {
+    type: "mutualTLS";
+    description?: string;
+};
+export type SecuritySchemesTypes = SecuritySchemes_apiKey | SecuritySchemes_http | SecuritySchemes_oauth2 | SecuritySchemes_openIdConnect | SecuritySchemes_mutualTLS | swaggerJSDoc.SecurityScheme;
+export type ExtractScopesBySecuritySchemes<S> = S extends swaggerJSDoc.SecurityScheme & {
+    flows?: infer F;
+} ? F extends Record<string, infer Flow> ? Flow extends swaggerJSDoc.OAuthFlow ? keyof NonNullable<Flow["scopes"]> : never : never : S extends ComponentSecurity<any, infer I> ? ExtractScopesBySecuritySchemes<I> : never;
+export type ComponentSecurity<N extends string, O extends SecuritySchemesTypes> = {
+    securitySchemes: {
+        [k in N]: Prettify<O>;
+    };
+};
+export type ComponentSchema<N extends string, S extends swaggerJSDoc.Schema> = {
+    schemas: {
+        [k in N]: Prettify<S>;
+    };
+};
+export type Reference<R> = R extends string ? R extends `#/components/${infer I}` ? {
+    $ref: `#/components/${I}`;
+} : {
+    $ref: `#/components/${R}`;
+} : R extends ComponentSecurity<infer N, any> ? `#/components/securitySchemes/${N}` : R extends ComponentSchema<infer N, any> ? `#/components/schemas/${N}` : never;
+export interface ModelValueNumber extends swaggerJSDoc.Schema {
+    type?: "number" | "integer";
+    format?: "float" | "double" | "int32" | "int64";
+    minimum?: number;
+    maximum?: number;
+    exclusiveMinimum?: boolean;
+    exclusiveMaximum?: boolean;
+    description?: string;
+    nullable?: boolean;
+}
+export interface ModelValueString extends swaggerJSDoc.Schema {
+    format?: "date" | "date-time" | "password" | "byte" | "binary" | "email" | "uuid" | "uri" | "hostname" | "ipv4" | "ipv6";
+    minLength?: number;
+    maxLength?: number;
+    description?: string;
+    pattern?: RegExp | string;
+    nullable?: boolean;
+}
+//# sourceMappingURL=type.d.ts.map

package/dist/Doc/type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.d.ts","sourceRoot":"","sources":["../../src/Doc/type.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,YAAY,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAGnC,MAAM,MAAM,sBAAsB,GAAG;IACpC,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAGF,MAAM,MAAM,oBAAoB,GAAG;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC/C,YAAY,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,aAAa,CAAC;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAGF,MAAM,MAAM,sBAAsB,GAAG;IACpC,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,YAAY,CAAC,UAAU,CAAC;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAGF,MAAM,MAAM,6BAA6B,GAAG;IAC3C,IAAI,EAAE,eAAe,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAGF,MAAM,MAAM,yBAAyB,GAAG;IACvC,IAAI,EAAE,WAAW,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAGF,MAAM,MAAM,oBAAoB,GAAG,sBAAsB,GAAG,oBAAoB,GAAG,sBAAsB,GAAG,6BAA6B,GAAG,yBAAyB,GAAG,YAAY,CAAC,cAAc,CAAC;AAEpM,MAAM,MAAM,8BAA8B,CAAC,CAAC,IAAI,CAAC,SAAS,YAAY,CAAC,cAAc,GAAG;IACvF,KAAK,CAAC,EAAE,MAAM,CAAC,CAAC;CAChB,GACE,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC,GACnC,IAAI,SAAS,YAAY,CAAC,SAAS,GAClC,MAAM,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,GACjC,KAAK,GACN,KAAK,GACN,CAAC,SAAS,iBAAiB,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,GACzC,8BAA8B,CAAC,CAAC,CAAC,GACjC,KAAK,CAAC;AAET,MAAM,MAAM,iBAAiB,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,oBAAoB,IAAI;IACjF,eAAe,EAAE;SACf,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC;KACrB,CAAC;CACF,CAAC;AAEF,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,YAAY,CAAC,MAAM,IAAI;IAC9E,OAAO,EAAE;SAAG,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC;KAAE,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,GACxC,CAAC,SAAS,gBAAgB,MAAM,CAAC,EAAE,GAClC;IAAE,IAAI,EAAE,gBAAgB,CAAC,EAAE,CAAA;CAAE,GAC7B;IAAE,IAAI,EAAE,gBAAgB,CAAC,EAAE,CAAA;CAAE,GAC9B,CAAC,SAAS,iBAAiB,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,GACzC,gCAAgC,CAAC,EAAE,GACnC,CAAC,SAAS,eAAe,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,GACvC,wBAAwB,CAAC,EAAE,GAC3B,KAAK,CAAC;AAET,MAAM,WAAW,gBAAiB,SAAQ,YAAY,CAAC,MAAM;IAC5D,IAAI,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC5B,MAAM,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,CAAC;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,gBAAiB,SAAQ,YAAY,CAAC,MAAM;IAC5D,MAAM,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;IACzH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB"}

package/dist/HandleError.d.ts

@@ -62,13 +62,55 @@ declare const codes: {
     readonly 510: "Not Extended";
     readonly 511: "Network Authentication Required";
 };
+/**
+ * Uma classe de erro personalizada projetada para lidar com erros operacionais em uma aplicação,
+ * especialmente em um contexto de API HTTP. Permite encapsular uma mensagem de erro, um nome,
+ * um código de status HTTP e um nível de log.
+ *
+ * @example
+ * // Exemplo 1: Erro com mensagem e código de status.
+ * try {
+ *   throw new HandleError("Recurso não encontrado.", "NOT_FOUND", 404);
+ * } catch (e) {
+ *   if (e instanceof HandleError) {
+ *     // Em um handler de API, você poderia usar e.code para definir o status da resposta.
+ *     // res.status(e.code).json({ message: e.message, name: e.name });
+ *     console.log(e.message); // "Recurso não encontrado."
+ *     console.log(e.name);    // "NOT_FOUND"
+ *     console.log(e.code);    // 404
+ *     console.log(e.status);  // { code: 404, message: 'Not Found' }
+ *   }
+ * }
+ *
+ * // Exemplo 2: Erro de validação com nível de log 'WARN'.
+ * const validationError = new HandleError(
+ *   "O campo 'email' é inválido.",
+ *   "VALIDATION_ERROR",
+ *   400, // Bad Request
+ *   "WARN"
+ * );
+ *
+ * // Exemplo 3: Erro genérico, usando os valores padrão.
+ * const genericError = new HandleError("Algo deu errado.");
+ * console.log(genericError.name);  // "DEFAULT"
+ * console.log(genericError.code);  // 200 (comportamento padrão quando 'cause' não é número)
+ * console.log(genericError.level); // "ERROR"
+ */
 export declare class HandleError extends Error {
     readonly message: string;
     readonly name: string;
     readonly cause?: (keyof typeof codes | HandleError | Error | string | object) | undefined;
     readonly level: "ERROR" | "WARN" | "INFO" | "NONE";
+    /**
+     * @param {string} message A mensagem de erro principal, legível para humanos.
+     * @param {string} [name="DEFAULT"] Um nome/código para categorizar o erro (ex: "VALIDATION_ERROR").
+     * @param {keyof typeof codes | HandleError | Error | string | object} [cause] A causa raiz do erro. Se for um número, será tratado como um código de status HTTP.
+     * @param {"ERROR" | "WARN" | "INFO" | "NONE"} [level="ERROR"] O nível de severidade do erro, usado para controle de logs.
+     */
     constructor(message: string, name?: string, cause?: (keyof typeof codes | HandleError | Error | string | object) | undefined, level?: "ERROR" | "WARN" | "INFO" | "NONE");
+    /** Retorna o código de status HTTP associado ao erro. Extraído da propriedade `cause` se for um número, caso contrário, o padrão é 200. */
     get code(): 100 | 101 | 102 | 103 | 200 | 201 | 202 | 203 | 204 | 205 | 206 | 207 | 208 | 226 | 300 | 301 | 302 | 303 | 304 | 305 | 307 | 308 | 400 | 401 | 402 | 403 | 404 | 405 | 406 | 407 | 408 | 409 | 410 | 411 | 412 | 413 | 414 | 415 | 416 | 417 | 418 | 421 | 422 | 423 | 424 | 425 | 426 | 428 | 429 | 431 | 451 | 500 | 501 | 502 | 503 | 504 | 505 | 506 | 507 | 508 | 510 | 511;
+    /** Retorna um objeto contendo o código de status e a mensagem HTTP correspondente. */
     get status(): {
         code: 100 | 101 | 102 | 103 | 200 | 201 | 202 | 203 | 204 | 205 | 206 | 207 | 208 | 226 | 300 | 301 | 302 | 303 | 304 | 305 | 307 | 308 | 400 | 401 | 402 | 403 | 404 | 405 | 406 | 407 | 408 | 409 | 410 | 411 | 412 | 413 | 414 | 415 | 416 | 417 | 418 | 421 | 422 | 423 | 424 | 425 | 426 | 428 | 429 | 431 | 451 | 500 | 501 | 502 | 503 | 504 | 505 | 506 | 507 | 508 | 510 | 511;
         message: "Continue" | "Switching Protocols" | "Processing" | "Early Hints" | "OK" | "Created" | "Accepted" | "Non-Authoritative Information" | "No Content" | "Reset Content" | "Partial Content" | "Multi-Status" | "Already Reported" | "IM Used" | "Multiple Choices" | "Moved Permanently" | "Found" | "See Other" | "Not Modified" | "Use Proxy" | "Temporary Redirect" | "Permanent Redirect" | "Bad Request" | "Unauthorized" | "Payment Required" | "Forbidden" | "Not Found" | "Method Not Allowed" | "Not Acceptable" | "Proxy Authentication Required" | "Request Timeout" | "Conflict" | "Gone" | "Length Required" | "Precondition Failed" | "Payload Too Large" | "URI Too Long" | "Unsupported Media Type" | "Range Not Satisfiable" | "Expectation Failed" | "I'm a Teapot" | "Misdirected Request" | "Unprocessable Entity" | "Locked" | "Failed Dependency" | "Too Early" | "Upgrade Required" | "Precondition Required" | "Too Many Requests" | "Request Header Fields Too Large" | "Unavailable For Legal Reasons" | "Internal Server Error" | "Not Implemented" | "Bad Gateway" | "Service Unavailable" | "Gateway Timeout" | "HTTP Version Not Supported" | "Variant Also Negotiates" | "Insufficient Storage" | "Loop Detected" | "Not Extended" | "Network Authentication Required";

package/dist/HandleError.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HandleError.d.ts","sourceRoot":"","sources":["../src/HandleError.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+DD,CAAC;AAEX,qBAAa,WAAY,SAAQ,KAAK;IAEpC,QAAQ,CAAC,OAAO,EAAE,MAAM;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,QAAQ,CAAC,KAAK,CAAC,GAAE,MAAM,OAAO,KAAK,GAAG,WAAW,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM;IAC3E,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM;gBAHzC,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,MAAkB,EACxB,KAAK,CAAC,GAAE,MAAM,OAAO,KAAK,GAAG,WAAW,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,aAAA,EAClE,KAAK,GAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,MAAgB;IAK7D,IAAI,IAAI,sXAEP;IAED,IAAI,MAAM;;;MAKT;CACD"}
+{"version":3,"file":"HandleError.d.ts","sourceRoot":"","sources":["../src/HandleError.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+DD,CAAC;AAEX;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,qBAAa,WAAY,SAAQ,KAAK;IAQpC,QAAQ,CAAC,OAAO,EAAE,MAAM;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,QAAQ,CAAC,KAAK,CAAC,GAAE,MAAM,OAAO,KAAK,GAAG,WAAW,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM;IAC3E,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM;IAVnD;;;;;OAKG;gBAEO,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,MAAkB,EACxB,KAAK,CAAC,GAAE,MAAM,OAAO,KAAK,GAAG,WAAW,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,aAAA,EAClE,KAAK,GAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,MAAgB;IAK7D,2IAA2I;IAC3I,IAAI,IAAI,sXAEP;IAED,sFAAsF;IACtF,IAAI,MAAM;;;MAKT;CACD"}

package/dist/Layer.d.ts

@@ -0,0 +1,131 @@
+import { HandlerFC, ILayer, IRoute, MiddlewareFC, MiddlewareFCDoc, NextFunction, RouterMethods, Request, Response } from "./type";
+import { EventEmitter } from "@ismael1361/utils";
+/**
+ * @internal
+ * Representa uma camada interna do roteador, funcionando como uma coleção estruturada
+ * de definições de rotas e middlewares.
+ *
+ * Esta classe é o núcleo do sistema de roteamento, permitindo a construção de uma árvore
+ * de rotas aninhadas, onde middlewares de camadas superiores são aplicados às camadas inferiores.
+ * Ela não deve ser usada diretamente pelo consumidor da biblioteca.
+ */
+export declare class Layer extends Array<ILayer> {
+    path: string;
+    doc: MiddlewareFCDoc;
+    private __event__;
+    /** @internal O índice da última camada adicionada. */
+    index: number;
+    /**
+     * @internal
+     * @param {string} [path=""] O prefixo de caminho para esta camada.
+     * @param {MiddlewareFCDoc} [doc={}] A documentação base para esta camada.
+     */
+    constructor(path?: string, doc?: MiddlewareFCDoc);
+    /**
+     * Adiciona um ouvinte para eventos internos da camada.
+     * @param {"add"} event O nome do evento. Atualmente, apenas 'add' é suportado.
+     * @param {(route: IRoute) => void} listener A função a ser chamada quando o evento é emitido.
+     */
+    addListener(event: "add", listener: (route: IRoute) => void): import("@ismael1361/utils").EventHandler;
+    /**
+     * Remove um ouvinte de eventos.
+     * @param {"add"} event O nome do evento.
+     * @param {(route: IRoute) => void} listener A função ouvinte a ser removida.
+     */
+    removeListener(event: "add", listener: (route: IRoute) => void): EventEmitter<{
+        add: [route: IRoute];
+    }>;
+    /**
+     * @internal
+     * Adiciona uma nova definição (camada) à pilha. Este é o método base usado por `get`, `post`, `middleware`, etc.
+     * Retorna um objeto semelhante a `this` com um getter/setter para a documentação da camada recém-adicionada.
+     */
+    pushPath(type: "layer" | "middleware", method: RouterMethods, path: string, handle: Array<HandlerFC | MiddlewareFC> | Layer, doc?: MiddlewareFCDoc): this;
+    /**
+     * Cria uma nova sub-camada (sub-roteador) aninhada dentro da camada atual.
+     * Permite agrupar rotas sob um prefixo de caminho comum.
+     *
+     * @returns {Layer} A nova instância de `Layer` que representa o sub-roteador.
+     */
+    route(path: string, route: Layer, doc?: MiddlewareFCDoc): Layer;
+    route(path: string, doc?: MiddlewareFCDoc): Layer;
+    route(route: Layer, doc?: MiddlewareFCDoc): Layer;
+    route(doc?: MiddlewareFCDoc): Layer;
+    /**
+     * @internal
+     * Fábrica estática para criar uma nova instância de `Layer`.
+     */
+    static route(path?: string, doc?: MiddlewareFCDoc): Layer;
+    /**
+     * Anexa uma instância de `Layer` (um roteador) existente a esta camada.
+     * É um método de conveniência para compor roteadores.
+     *
+     * @returns {this} A própria instância da camada para encadeamento.
+     */
+    by(route: Layer, doc?: MiddlewareFCDoc): this;
+    /** @internal */
+    by(path: string, route: Layer, doc?: MiddlewareFCDoc): this;
+    /**
+     * @internal
+     * Retorna uma representação da pilha de camadas para fins de depuração.
+     */
+    get stack(): ILayer[];
+    executeMiddlewares(request: Request, response: Response, next: NextFunction): Promise<any>;
+    /**
+     * Processa e achata a árvore de camadas em uma lista linear de rotas finais (`IRoute`).
+     * Este getter é fundamental, pois resolve os middlewares aninhados, aplica-os às rotas filhas
+     * e consolida os caminhos e a documentação.
+     */
+    get routes(): IRoute[];
+    /**
+     * @internal
+     * Adiciona um middleware a esta camada.
+     */
+    middleware(handle: Array<MiddlewareFC>, doc?: MiddlewareFCDoc): this;
+    /**
+     * @internal
+     * Adiciona uma rota do tipo GET.
+     */
+    get(path: string, handle: Array<HandlerFC | MiddlewareFC>, doc?: MiddlewareFCDoc): this;
+    /**
+     * @internal
+     * Adiciona uma rota do tipo POST.
+     */
+    post(path: string, handle: Array<HandlerFC | MiddlewareFC>, doc?: MiddlewareFCDoc): this;
+    /**
+     * @internal
+     * Adiciona uma rota do tipo PUT.
+     */
+    put(path: string, handle: Array<HandlerFC | MiddlewareFC>, doc?: MiddlewareFCDoc): this;
+    /**
+     * @internal
+     * Adiciona uma rota do tipo DELETE.
+     */
+    delete(path: string, handle: Array<HandlerFC | MiddlewareFC>, doc?: MiddlewareFCDoc): this;
+    /**
+     * @internal
+     * Adiciona uma rota do tipo PATCH.
+     */
+    patch(path: string, handle: Array<HandlerFC | MiddlewareFC>, doc?: MiddlewareFCDoc): this;
+    /**
+     * @internal
+     * Adiciona uma rota do tipo OPTIONS.
+     */
+    options(path: string, handle: Array<HandlerFC | MiddlewareFC>, doc?: MiddlewareFCDoc): this;
+    /**
+     * @internal
+     * Adiciona uma rota do tipo HEAD.
+     */
+    head(path: string, handle: Array<HandlerFC | MiddlewareFC>, doc?: MiddlewareFCDoc): this;
+    /**
+     * @internal
+     * Adiciona uma rota que corresponde a todos os métodos HTTP.
+     */
+    all(path: string, handle: Array<HandlerFC | MiddlewareFC>, doc?: MiddlewareFCDoc): this;
+    /**
+     * @internal
+     * Adiciona um middleware a um caminho específico.
+     */
+    use(path: string, handle: Array<HandlerFC | MiddlewareFC>, doc?: MiddlewareFCDoc): this;
+}
+//# sourceMappingURL=Layer.d.ts.map

package/dist/Layer.d.ts.map

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

package/dist/Middlewares.d.ts

@@ -0,0 +1,89 @@
+import { MiddlewareFC, Request, Response } from "./type";
+import { OptionsJson, Options, OptionsText, OptionsUrlencoded } from "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 });
+ * });
+ */
+export declare const json: (options?: OptionsJson | undefined) => MiddlewareFC<Request, Response>;
+/**
+ * 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');
+ * });
+ */
+export declare const raw: (options?: Options) => MiddlewareFC<Request, Response>;
+/**
+ * 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');
+ * });
+ */
+export declare const text: (options?: OptionsText) => MiddlewareFC<Request, Response>;
+/**
+ * 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 });
+ * });
+ */
+export declare const urlencoded: (options?: OptionsUrlencoded) => MiddlewareFC<Request, Response>;
+//# sourceMappingURL=Middlewares.d.ts.map

package/dist/Middlewares.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Middlewares.d.ts","sourceRoot":"","sources":["../src/Middlewares.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AACzD,OAAmB,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAE/F;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,IAAI,GAAI,UAAU,WAAW,GAAG,SAAS,KAAG,YAAY,CAAC,OAAO,EAAE,QAAQ,CAEtF,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,GAAG,GAAI,UAAU,OAAO,KAAG,YAAY,CAAC,OAAO,EAAE,QAAQ,CAErE,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,IAAI,GAAI,UAAU,WAAW,KAAG,YAAY,CAAC,OAAO,EAAE,QAAQ,CAE1E,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,UAAU,GAAI,UAAU,iBAAiB,KAAG,YAAY,CAAC,OAAO,EAAE,QAAQ,CAEtF,CAAC"}

package/dist/handler.d.ts

@@ -1,114 +1,113 @@
-import type { Request, Response, ExpressRouter, MiddlewareFC, RouterMethods, HandlerFC } from "./type";
+import type { Request, Response, RouterProps, MiddlewareFC, RouterMethods, MiddlewareFCDoc, HandlerCallback, MiddlewareCallback, NextFunction } from "./type";
 import { RequestMiddleware } from "./middleware";
-import { RouterProps } from "./router";
+import { Router } from "./router";
 /**
- * Encapsula um handler de rota final junto com uma cadeia de middlewares pré-configurados.
+ * Representa um construtor de rotas encadeável.
  *
- * Esta classe é útil para criar "controllers" ou "actions" reutilizáveis, onde a lógica do handler
- * depende de um conjunto específico de middlewares que devem ser executados antes dele.
- * Em vez de adicionar manualmente os mesmos middlewares a várias rotas, você pode agrupá-los
- * com o handler em uma única unidade.
+ * 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`.
  *
- * @template Rq - O tipo de requisição (Request) esperado pelo handler final.
- * @template Rs - O tipo de resposta (Response) esperado pelo handler final.
+ * Ela permite encadear middlewares específicos para a rota e, finalmente, definir o manipulador
+ * da rota e sua documentação.
  *
  * @example
- * // 1. Definir um middleware que busca um usuário e o anexa à requisição.
- * interface UserRequest extends Request {
- *   user: { id: number; name: string; };
- * }
- * const findUserByIdMiddleware: MiddlewareFC<UserRequest> = (req, res, next) => {
- *   // Lógica para buscar o usuário pelo ID nos parâmetros da rota
- *   const userId = parseInt(req.params.id, 10);
- *   if (userId === 1) {
- *     req.user = { id: 1, name: "John Doe" };
- *     next();
- *   } else {
- *     res.status(404).send("User not found");
- *   }
- * };
+ * const router = create();
  *
- * // 2. Definir o handler final que usa os dados do middleware.
- * const getUserProfileHandler: HandlerFC<UserRequest> = (req, res) => {
- *   // `req.user` está disponível e tipado graças ao middleware.
- *   res.json(req.user);
- * };
- *
- * // 3. Criar uma instância de `PreparedHandler` que agrupa o middleware e o handler.
- * const getUserProfileController = new PreparedHandler(
- *   getUserProfileHandler,
- *   [findUserByIdMiddleware]
- * );
- *
- * // 4. Usar o controller pré-preparado em uma definição de rota.
- * // O `router` automaticamente aplicará `findUserByIdMiddleware` antes de `getUserProfileHandler`.
- * router.get("/users/:id").handler(getUserProfileController);
- */
-export declare class PreparedHandler<Rq extends Request = Request, Rs extends Response = Response> extends RequestMiddleware<Rq, Rs> {
-    readonly callback: HandlerFC<Rq, Rs>;
-    constructor(callback: HandlerFC<Rq, Rs>, middlewares?: MiddlewareFC<any, any>[]);
-}
-/**
- * Construtor de rotas que permite o encadeamento de middlewares antes do handler final.
- * Esta classe é a parte central da API fluente para definir rotas (ex: `router.get(...).middleware(...).handler(...)`).
- * Ela herda da classe `RequestMiddleware` para acumular middlewares e seus tipos associados.
- *
- * @template Rq - O tipo de requisição (Request) acumulado a partir dos middlewares anteriores.
- * @template Rs - O tipo de resposta (Response) acumulado a partir dos middlewares anteriores.
- *
- * @example
- * // Exemplo de como a classe Handler é usada internamente pelo RouterContext.
- *
- * // 1. RequestMiddleware de autenticação que adiciona `userId` à requisição.
- * interface AuthRequest extends Request { userId: number; }
- * const authMiddleware: MiddlewareFC<AuthRequest> = (req, res, next) => {
- *   req.userId = 123; // Simula a autenticação
- *   next();
- * };
- *
- * // 2. Criação da rota usando a API fluente.
- * // router.get() retorna uma instância de Handler.
- * router
- *   .get("/users/me")
- *   // .middleware() retorna uma nova instância de Handler com o middleware adicionado.
- *   .middleware(authMiddleware)
- *   // .handler() finaliza a cadeia, registrando a rota e o handler no Express.
+ * // 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) => {
- *     // Graças à tipagem encadeada, `req.userId` está disponível e é do tipo `number`.
- *     const userId = req.userId;
- *     res.json({ id: userId, name: "Usuário Logado" });
+ *     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' }
  *   });
  */
 export declare class RequestHandler<Rq extends Request = Request, Rs extends Response = Response> extends RequestMiddleware<Rq, Rs> {
-    readonly router: ExpressRouter;
+    readonly router: Router;
     readonly type: RouterMethods;
     readonly path: string;
-    readonly hierarchicalMiddleware: MiddlewareFC<any, any>[];
+    doc?: MiddlewareFCDoc | undefined;
+    readonly middlewares: MiddlewareFC<any, any>[];
+    /** @internal */
+    constructor(router: Router, type: RouterMethods, path: string, doc?: MiddlewareFCDoc | undefined);
     /**
-     * @param {ExpressRouter} router - A instância do roteador Express onde a rota será registrada.
-     * @param {RouterMethods} type - O método HTTP da rota (get, post, etc.).
-     * @param {string} path - O padrão de caminho da rota.
-     * @param {MiddlewareFC<any, any>[]} [middlewares=[]] - Uma lista inicial de 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.
      */
-    constructor(router: ExpressRouter, type: RouterMethods, path: string, middlewares?: MiddlewareFC<any, any>[], hierarchicalMiddleware?: MiddlewareFC<any, any>[]);
+    middleware<Req extends Request = Request, Res extends Response = Response>(callback: MiddlewareCallback<Rq & Req, Rs & Res>, doc?: MiddlewareFCDoc): RequestHandler<Rq & Req, Rs & Res>;
     /**
-     * Adiciona um middleware à cadeia de execução da rota atual.
-     * @template Req - O tipo que o novo middleware adiciona à requisição.
-     * @template Res - O tipo que o novo middleware adiciona à resposta.
-     * @param {MiddlewareFC<Rq & Req, Rs & Res>} callback - A função de middleware a ser adicionada.
-     * @returns {RequestHandler<Rq & Req, Rs & Res>} Uma nova instância de `RequestHandler` para permitir mais encadeamento.
+     * 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.
      */
-    middleware<Req extends Request = Request, Res extends Response = Response>(callback: MiddlewareFC<Rq & Req, Rs & Res>): RequestHandler<Rq & Req, Rs & Res>;
+    handler<Req extends Request = Request, Res extends Response = Response>(callback: HandlerCallback<Rq & Req, Rs & Res>, doc?: MiddlewareFCDoc): RouterProps;
+}
+/**
+ * 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
+ */
+export declare class Handler<Rq extends Request = Request, Rs extends Response = Response> {
+    readonly router: Router;
+    doc?: MiddlewareFCDoc | undefined;
+    /** @internal */
+    constructor(callback: HandlerCallback<Rq, Rs> | undefined, router?: Router, doc?: MiddlewareFCDoc | undefined);
     /**
-     * Define o handler final para a rota, completando a cadeia de configuração.
-     * Este método registra a rota no roteador Express, aplicando todos os middlewares
-     * que foram encadeados anteriormente.
+     * 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 = () => {};
      *
-     * @template Req - Tipos de requisição adicionais inferidos a partir do handler.
-     * @template Res - Tipos de resposta adicionais inferidos a partir do handler.
-     * @param {HandlerFC<Rq & Req, Rs & Res> | PreparedHandler<Rq & Req, Rs & Res>} callback - A função que processará a requisição. Pode ser uma função de handler (`HandlerFC`) ou uma instância de `PreparedHandler` que já encapsula um handler e seus próprios middlewares.
-     * @returns {RouterProps} Uma instância que permite adicionar metadados, como documentação Swagger, à rota.
+     * // 3. Execute o handler programaticamente
+     * await myHandler.execute(mockRequest, mockResponse, mockNext);
+     * // Output: { userId: '123' }
      */
-    handler<Req extends Request = Request, Res extends Response = Response>(callback: HandlerFC<Rq & Req, Rs & Res>): RouterProps;
+    execute(request: Rq, response: Rs, next: NextFunction): Promise<any>;
 }
 //# sourceMappingURL=handler.d.ts.map

package/dist/handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../src/handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAEvG,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,qBAAa,eAAe,CAAC,EAAE,SAAS,OAAO,GAAG,OAAO,EAAE,EAAE,SAAS,QAAQ,GAAG,QAAQ,CAAE,SAAQ,iBAAiB,CAAC,EAAE,EAAE,EAAE,CAAC;aAC/F,QAAQ,EAAE,SAAS,CAAC,EAAE,EAAE,EAAE,CAAC;gBAA3B,QAAQ,EAAE,SAAS,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,WAAW,GAAE,YAAY,CAAC,GAAG,EAAE,GAAG,CAAC,EAAO;CAGnG;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,qBAAa,cAAc,CAAC,EAAE,SAAS,OAAO,GAAG,OAAO,EAAE,EAAE,SAAS,QAAQ,GAAG,QAAQ,CAAE,SAAQ,iBAAiB,CAAC,EAAE,EAAE,EAAE,CAAC;aAQzG,MAAM,EAAE,aAAa;aACrB,IAAI,EAAE,aAAa;aACnB,IAAI,EAAE,MAAM;aAEZ,sBAAsB,EAAE,YAAY,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE;IAXjE;;;;;OAKG;gBAEc,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE,aAAa,EACnB,IAAI,EAAE,MAAM,EAC5B,WAAW,GAAE,YAAY,CAAC,GAAG,EAAE,GAAG,CAAC,EAAO,EAC1B,sBAAsB,GAAE,YAAY,CAAC,GAAG,EAAE,GAAG,CAAC,EAAO;IAKtE;;;;;;OAMG;IACH,UAAU,CAAC,GAAG,SAAS,OAAO,GAAG,OAAO,EAAE,GAAG,SAAS,QAAQ,GAAG,QAAQ,EAAE,QAAQ,EAAE,YAAY,CAAC,EAAE,GAAG,GAAG,EAAE,EAAE,GAAG,GAAG,CAAC,GAAG,cAAc,CAAC,EAAE,GAAG,GAAG,EAAE,EAAE,GAAG,GAAG,CAAC;IAI1J;;;;;;;;;OASG;IACH,OAAO,CAAC,GAAG,SAAS,OAAO,GAAG,OAAO,EAAE,GAAG,SAAS,QAAQ,GAAG,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC,EAAE,GAAG,GAAG,EAAE,EAAE,GAAG,GAAG,CAAC,GAAG,WAAW;CAW7H"}
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../src/handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAa,eAAe,EAAE,eAAe,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEzK,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAIlC;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,cAAc,CAAC,EAAE,SAAS,OAAO,GAAG,OAAO,EAAE,EAAE,SAAS,QAAQ,GAAG,QAAQ,CAAE,SAAQ,iBAAiB,CAAC,EAAE,EAAE,EAAE,CAAC;aAI9F,MAAM,EAAE,MAAM;aAAkB,IAAI,EAAE,aAAa;aAAkB,IAAI,EAAE,MAAM;IAAS,GAAG,CAAC,EAAE,eAAe;IAH3I,QAAQ,CAAC,WAAW,EAAE,YAAY,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAM;IAEpD,gBAAgB;gBACY,MAAM,EAAE,MAAM,EAAkB,IAAI,EAAE,aAAa,EAAkB,IAAI,EAAE,MAAM,EAAS,GAAG,CAAC,EAAE,eAAe,YAAA;IAI3I;;;;;;;;;OASG;IACH,UAAU,CAAC,GAAG,SAAS,OAAO,GAAG,OAAO,EAAE,GAAG,SAAS,QAAQ,GAAG,QAAQ,EAAE,QAAQ,EAAE,kBAAkB,CAAC,EAAE,GAAG,GAAG,EAAE,EAAE,GAAG,GAAG,CAAC,EAAE,GAAG,CAAC,EAAE,eAAe,GAAG,cAAc,CAAC,EAAE,GAAG,GAAG,EAAE,EAAE,GAAG,GAAG,CAAC;IAevL;;;;;;;;;OASG;IACH,OAAO,CAAC,GAAG,SAAS,OAAO,GAAG,OAAO,EAAE,GAAG,SAAS,QAAQ,GAAG,QAAQ,EAAE,QAAQ,EAAE,eAAe,CAAC,EAAE,GAAG,GAAG,EAAE,EAAE,GAAG,GAAG,CAAC,EAAE,GAAG,CAAC,EAAE,eAAe,GAAG,WAAW;CAyB1J;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,OAAO,CAAC,EAAE,SAAS,OAAO,GAAG,OAAO,EAAE,EAAE,SAAS,QAAQ,GAAG,QAAQ;IAErB,QAAQ,CAAC,MAAM,EAAE,MAAM;IAAwB,GAAG,CAAC,EAAE,eAAe;IAD/H,gBAAgB;gBACJ,QAAQ,EAAE,eAAe,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,SAAS,EAAW,MAAM,GAAE,MAAqB,EAAS,GAAG,CAAC,EAAE,eAAe,YAAA;IAc/H;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,OAAO,CAAC,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,YAAY;CAGrD"}