@alis-kit/routers 1.0.0

package/dist/adapters/FastifyAdapter.js

@@ -0,0 +1,132 @@
+import { BaseAdapter } from "./BaseAdapter.js";
+/**
+ * Fastify adapter implementation.
+ *
+ * Middleware Express-style dikonversi ke Fastify `preHandler` hooks.
+ * Handler di-await dan reply di-return untuk mencegah Fastify auto-send.
+ *
+ * @example
+ * ```typescript
+ * const fastify = Fastify();
+ * const adapter = new FastifyAdapter(fastify);
+ * adapter.registerRoute("get", "/hello", [], async (req, reply) => {
+ *   reply.code(200).send({ message: "OK" });
+ * });
+ * ```
+ */
+export class FastifyAdapter extends BaseAdapter {
+    app;
+    constructor(app) {
+        super();
+        this.app = app;
+    }
+    /**
+     * Fastify route handler signature berbeda dari Express.
+     * Middleware dikonversi ke preHandler, handler di-await.
+     */
+    registerRoute(method, path, middlewares, handler) {
+        const fastifyPath = path;
+        const routeHandler = this.app[method].bind(this.app);
+        const preHandlers = middlewares.map((mw) => {
+            return async (request, reply) => {
+                return new Promise((resolve, reject) => {
+                    mw(request, reply, (err) => {
+                        if (err)
+                            reject(err);
+                        else
+                            resolve();
+                    });
+                });
+            };
+        });
+        routeHandler(fastifyPath, { preHandler: preHandlers }, async (request, reply) => {
+            await handler(request, reply);
+            return reply;
+        });
+    }
+    getBody(req) {
+        return req.body;
+    }
+    getQuery(req) {
+        return req.query;
+    }
+    getParams(req) {
+        return req.params;
+    }
+    getHeaders(req) {
+        return req.headers;
+    }
+    getCookies(req) {
+        return req.cookies ?? {};
+    }
+    /**
+     * Sets a cookie on Fastify reply.
+     * Fallback ke manual Set-Cookie header jika `setCookie` tidak tersedia.
+     */
+    setCookie(res, key, value, options) {
+        const fastifyReply = res;
+        if (typeof fastifyReply.setCookie === "function") {
+            fastifyReply.setCookie(key, value, {
+                httpOnly: options.httpOnly,
+                secure: options.secure,
+                maxAge: options.maxAge ?? undefined,
+                path: options.path,
+                sameSite: options.sameSite,
+            });
+        }
+        else {
+            const parts = [`${key}=${value}`];
+            if (options.path)
+                parts.push(`Path=${options.path}`);
+            if (options.httpOnly)
+                parts.push("HttpOnly");
+            if (options.secure)
+                parts.push("Secure");
+            if (options.maxAge)
+                parts.push(`Max-Age=${options.maxAge}`);
+            if (options.sameSite)
+                parts.push(`SameSite=${options.sameSite}`);
+            fastifyReply.header("Set-Cookie", parts.join("; "));
+        }
+    }
+    /**
+     * Deletes a cookie on Fastify reply.
+     * Fallback ke Expires header manual jika `clearCookie` tidak tersedia.
+     */
+    deleteCookie(res, key) {
+        const fastifyReply = res;
+        if (typeof fastifyReply.clearCookie === "function") {
+            fastifyReply.clearCookie(key, { path: "/" });
+        }
+        else {
+            fastifyReply.header("Set-Cookie", `${key}=; Path=/; Expires=Thu, 01 Jan 1970 00:00:00 GMT`);
+        }
+    }
+    getUrl(req) {
+        const r = req;
+        return r.raw?.url || r.url || "";
+    }
+    getMethod(req) {
+        const r = req;
+        return r.raw?.method || r.method || "UNKNOWN";
+    }
+    sendResponse(res, status, body) {
+        const fastifyReply = res;
+        fastifyReply.code(status).send(body);
+    }
+    /**
+     * Fastify memiliki `setNotFoundHandler` native. Jika tidak ada,
+     * fallback ke warning — tidak runtime error.
+     */
+    registerNotFoundHandler(handler) {
+        if (typeof this.app.setNotFoundHandler === "function") {
+            this.app.setNotFoundHandler((request, reply) => {
+                handler(request, reply);
+            });
+        }
+        else {
+            console.warn("[RouterKit] Fastify instance is missing setNotFoundHandler. Catch-all route not registered.");
+        }
+    }
+}
+//# sourceMappingURL=FastifyAdapter.js.map

package/dist/adapters/FastifyAdapter.js.map

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

package/dist/cookie/CookieSetter.d.ts

@@ -0,0 +1,74 @@
+import type { CookieOptions } from "../types/index.js";
+import type { BaseAdapter } from "../adapters/BaseAdapter.js";
+/**
+ * Helper class for reading, setting, and deleting cookies.
+ *
+ * Mengabstraksi operasi cookie antara Express dan Fastify melalui adapter pattern.
+ * Di-inject ke controller method via decorator `@Cookie()`.
+ *
+ * @example
+ * ```typescript
+ * @ReqController("/auth")
+ * class AuthController {
+ *   @PostMapping("/login")
+ *   async login(@Body(LoginSchema) body: ILogin, @Cookie() cookie: CookieSetter) {
+ *     // Set cookie
+ *     cookie.set("refresh_token", "jwt-token", {
+ *       httpOnly: true,
+ *       secure: true,
+ *       maxAge: 7 * 24 * 60 * 60, // 7 hari dalam detik
+ *     });
+ *
+ *     // Read cookie
+ *     const existing = cookie.get("refresh_token");
+ *
+ *     // Delete cookie
+ *     cookie.delete("old_session");
+ *   }
+ * }
+ * ```
+ */
+export declare class CookieSetter {
+    private readonly adapter;
+    private readonly req;
+    private readonly res;
+    constructor(adapter: BaseAdapter, req: unknown, res: unknown);
+    /**
+     * Sets a cookie with the given key, value, and options.
+     *
+     * @param key - Cookie name
+     * @param value - Cookie value
+     * @param options - Cookie options (httpOnly, secure, maxAge, path, sameSite)
+     *
+     * @example
+     * ```typescript
+     * cookie.set("session", "abc123", { httpOnly: true, maxAge: 3600 });
+     * ```
+     */
+    set(key: string, value: string, options?: CookieOptions): void;
+    /**
+     * Gets a cookie value by key.
+     *
+     * @param key - Cookie name
+     * @returns The cookie value, or `undefined` if the cookie doesn't exist
+     *
+     * @example
+     * ```typescript
+     * const token = cookie.get("refresh_token");
+     * if (token) { /* use token *\/ }
+     * ```
+     */
+    get(key: string): string | undefined;
+    /**
+     * Deletes a cookie by key (sets empty value with expired date).
+     *
+     * @param key - Cookie name to delete
+     *
+     * @example
+     * ```typescript
+     * cookie.delete("refresh_token");
+     * ```
+     */
+    delete(key: string): void;
+}
+//# sourceMappingURL=CookieSetter.d.ts.map

package/dist/cookie/CookieSetter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CookieSetter.d.ts","sourceRoot":"","sources":["../../cookie/CookieSetter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAE9D;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,YAAY;IAErB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAFH,OAAO,EAAE,WAAW,EACpB,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,OAAO;IAG/B;;;;;;;;;;;OAWG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,IAAI;IAU9D;;;;;;;;;;;OAWG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAKpC;;;;;;;;;OASG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;CAG1B"}

package/dist/cookie/CookieSetter.js

@@ -0,0 +1,89 @@
+/**
+ * Helper class for reading, setting, and deleting cookies.
+ *
+ * Mengabstraksi operasi cookie antara Express dan Fastify melalui adapter pattern.
+ * Di-inject ke controller method via decorator `@Cookie()`.
+ *
+ * @example
+ * ```typescript
+ * @ReqController("/auth")
+ * class AuthController {
+ *   @PostMapping("/login")
+ *   async login(@Body(LoginSchema) body: ILogin, @Cookie() cookie: CookieSetter) {
+ *     // Set cookie
+ *     cookie.set("refresh_token", "jwt-token", {
+ *       httpOnly: true,
+ *       secure: true,
+ *       maxAge: 7 * 24 * 60 * 60, // 7 hari dalam detik
+ *     });
+ *
+ *     // Read cookie
+ *     const existing = cookie.get("refresh_token");
+ *
+ *     // Delete cookie
+ *     cookie.delete("old_session");
+ *   }
+ * }
+ * ```
+ */
+export class CookieSetter {
+    adapter;
+    req;
+    res;
+    constructor(adapter, req, res) {
+        this.adapter = adapter;
+        this.req = req;
+        this.res = res;
+    }
+    /**
+     * Sets a cookie with the given key, value, and options.
+     *
+     * @param key - Cookie name
+     * @param value - Cookie value
+     * @param options - Cookie options (httpOnly, secure, maxAge, path, sameSite)
+     *
+     * @example
+     * ```typescript
+     * cookie.set("session", "abc123", { httpOnly: true, maxAge: 3600 });
+     * ```
+     */
+    set(key, value, options) {
+        this.adapter.setCookie(this.res, key, value, {
+            httpOnly: options?.httpOnly !== false,
+            secure: options?.secure !== false,
+            maxAge: options?.maxAge,
+            path: options?.path ?? "/",
+            sameSite: options?.sameSite,
+        });
+    }
+    /**
+     * Gets a cookie value by key.
+     *
+     * @param key - Cookie name
+     * @returns The cookie value, or `undefined` if the cookie doesn't exist
+     *
+     * @example
+     * ```typescript
+     * const token = cookie.get("refresh_token");
+     * if (token) { /* use token *\/ }
+     * ```
+     */
+    get(key) {
+        const cookies = this.adapter.getCookies(this.req);
+        return cookies[key];
+    }
+    /**
+     * Deletes a cookie by key (sets empty value with expired date).
+     *
+     * @param key - Cookie name to delete
+     *
+     * @example
+     * ```typescript
+     * cookie.delete("refresh_token");
+     * ```
+     */
+    delete(key) {
+        this.adapter.deleteCookie(this.res, key);
+    }
+}
+//# sourceMappingURL=CookieSetter.js.map

package/dist/cookie/CookieSetter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CookieSetter.js","sourceRoot":"","sources":["../../cookie/CookieSetter.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,OAAO,YAAY;IAEJ;IACA;IACA;IAHnB,YACmB,OAAoB,EACpB,GAAY,EACZ,GAAY;QAFZ,YAAO,GAAP,OAAO,CAAa;QACpB,QAAG,GAAH,GAAG,CAAS;QACZ,QAAG,GAAH,GAAG,CAAS;IAC5B,CAAC;IAEJ;;;;;;;;;;;OAWG;IACH,GAAG,CAAC,GAAW,EAAE,KAAa,EAAE,OAAuB;QACrD,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE;YAC3C,QAAQ,EAAE,OAAO,EAAE,QAAQ,KAAK,KAAK;YACrC,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,KAAK;YACjC,MAAM,EAAE,OAAO,EAAE,MAAM;YACvB,IAAI,EAAE,OAAO,EAAE,IAAI,IAAI,GAAG;YAC1B,QAAQ,EAAE,OAAO,EAAE,QAAQ;SAC5B,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;OAWG;IACH,GAAG,CAAC,GAAW;QACb,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAClD,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC;IACtB,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,GAAW;QAChB,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAC3C,CAAC;CACF"}

package/dist/core/Logger.d.ts

@@ -0,0 +1,36 @@
+import type { LoggerMeta } from "../types/index.js";
+/**
+ * Utility class for structured request logging with ANSI-colored output.
+ * Mendukung console logging dan custom handler untuk integrasi eksternal.
+ */
+export declare class Logger {
+    /**
+     * Logs an HTTP request with method, URL, status code, and duration.
+     * Error responses (status >= 500) include the error object for debugging.
+     *
+     * @param method - HTTP method (GET, POST, dll)
+     * @param url - Request URL path
+     * @param status - HTTP response status code
+     * @param durationMs - Request duration in milliseconds
+     * @param error - Optional error object (ditampilkan jika status >= 500)
+     * @param customHandler - Optional custom handler untuk log ke file/service eksternal
+     *
+     * @example
+     * ```typescript
+     * // Default console logging
+     * Logger.logRequest("GET", "/users", 200, 42);
+     * // Output: ✅ [GET] /users - 200 (42ms)
+     * ```
+     *
+     * @example
+     * ```typescript
+     * // Custom handler — kirim ke file atau service monitoring
+     * const customLogger = (level, msg, meta) => {
+     *   fileLog.write(`[${level}] ${msg}`);
+     * };
+     * Logger.logRequest("POST", "/users", 201, 120, undefined, customLogger);
+     * ```
+     */
+    static logRequest(method: string, url: string, status: number, durationMs: number, error?: unknown, customHandler?: (level: "info" | "error", message: string, meta: LoggerMeta) => void): void;
+}
+//# sourceMappingURL=Logger.d.ts.map

package/dist/core/Logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Logger.d.ts","sourceRoot":"","sources":["../../core/Logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD;;;GAGG;AACH,qBAAa,MAAM;IACjB;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,MAAM,CAAC,UAAU,CACf,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,KAAK,CAAC,EAAE,OAAO,EACf,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,KAAK,IAAI;CAwBvF"}

package/dist/core/Logger.js

@@ -0,0 +1,53 @@
+/**
+ * Utility class for structured request logging with ANSI-colored output.
+ * Mendukung console logging dan custom handler untuk integrasi eksternal.
+ */
+export class Logger {
+    /**
+     * Logs an HTTP request with method, URL, status code, and duration.
+     * Error responses (status >= 500) include the error object for debugging.
+     *
+     * @param method - HTTP method (GET, POST, dll)
+     * @param url - Request URL path
+     * @param status - HTTP response status code
+     * @param durationMs - Request duration in milliseconds
+     * @param error - Optional error object (ditampilkan jika status >= 500)
+     * @param customHandler - Optional custom handler untuk log ke file/service eksternal
+     *
+     * @example
+     * ```typescript
+     * // Default console logging
+     * Logger.logRequest("GET", "/users", 200, 42);
+     * // Output: ✅ [GET] /users - 200 (42ms)
+     * ```
+     *
+     * @example
+     * ```typescript
+     * // Custom handler — kirim ke file atau service monitoring
+     * const customLogger = (level, msg, meta) => {
+     *   fileLog.write(`[${level}] ${msg}`);
+     * };
+     * Logger.logRequest("POST", "/users", 201, 120, undefined, customLogger);
+     * ```
+     */
+    static logRequest(method, url, status, durationMs, error, customHandler) {
+        const isError = status >= 400;
+        const level = isError ? "error" : "info";
+        const icon = isError ? "❌" : "✅";
+        const reset = "\x1b[0m";
+        const methodColor = "\x1b[36m";
+        const statusColor = isError ? "\x1b[31m" : "\x1b[32m";
+        const timeColor = "\x1b[90m";
+        const methodUpper = String(method).toUpperCase();
+        const message = `${icon} ${methodColor}[${methodUpper}]${reset} ${url} - ${statusColor}${status}${reset} ${timeColor}(${durationMs}ms)${reset}`;
+        console.log(message);
+        if (isError && error && status >= 500) {
+            console.error(error);
+        }
+        if (customHandler) {
+            const cleanMessage = `${icon} [${methodUpper}] ${url} - ${status} (${durationMs}ms)`;
+            customHandler(level, cleanMessage, { method: methodUpper, path: url, status, durationMs, error });
+        }
+    }
+}
+//# sourceMappingURL=Logger.js.map

package/dist/core/Logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Logger.js","sourceRoot":"","sources":["../../core/Logger.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,OAAO,MAAM;IACjB;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,MAAM,CAAC,UAAU,CACf,MAAc,EACd,GAAW,EACX,MAAc,EACd,UAAkB,EAClB,KAAe,EACf,aAAoF;QAEpF,MAAM,OAAO,GAAG,MAAM,IAAI,GAAG,CAAC;QAC9B,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;QACzC,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;QAEjC,MAAM,KAAK,GAAG,SAAS,CAAC;QACxB,MAAM,WAAW,GAAG,UAAU,CAAC;QAC/B,MAAM,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC;QACtD,MAAM,SAAS,GAAG,UAAU,CAAC;QAE7B,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;QACjD,MAAM,OAAO,GAAG,GAAG,IAAI,IAAI,WAAW,IAAI,WAAW,IAAI,KAAK,IAAI,GAAG,MAAM,WAAW,GAAG,MAAM,GAAG,KAAK,IAAI,SAAS,IAAI,UAAU,MAAM,KAAK,EAAE,CAAC;QAEhJ,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACrB,IAAI,OAAO,IAAI,KAAK,IAAI,MAAM,IAAI,GAAG,EAAE,CAAC;YACrC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACxB,CAAC;QAED,IAAI,aAAa,EAAE,CAAC;YAClB,MAAM,YAAY,GAAG,GAAG,IAAI,KAAK,WAAW,KAAK,GAAG,MAAM,MAAM,KAAK,UAAU,KAAK,CAAC;YACrF,aAAa,CAAC,KAAK,EAAE,YAAY,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;QACpG,CAAC;IACH,CAAC;CACF"}

package/dist/core/RouteResolver.d.ts

@@ -0,0 +1,91 @@
+import type { MiddlewareFn, ResolvedRoute, Class } from "../types/index.js";
+import type { BaseAdapter } from "../adapters/BaseAdapter.js";
+/**
+ * Internal engine yang membaca metadata dari TC39 decorators (`Symbol.metadata`)
+ * dan WeakMap (parameter decorators), lalu mendaftarkan route ke framework adapter.
+ *
+ * Semua logic inti ada di sini: parameter injection, Zod validation,
+ * error handling, response envelope, auth middleware, dan logging.
+ */
+export declare class RouteResolver {
+    private readonly adapter;
+    private readonly loggerConfig?;
+    private readonly authMiddleware?;
+    private readonly refreshMiddleware?;
+    private readonly responseEnvelope;
+    private readonly globalPrefix;
+    /** Melacak route yang sudah didaftarkan untuk deteksi duplikat */
+    private readonly registeredRoutes;
+    /** Semua route yang sudah di-resolve — digunakan untuk generate Swagger spec */
+    readonly resolvedRoutes: ResolvedRoute[];
+    /**
+     * @param adapter - Framework adapter (Express / Fastify)
+     * @param loggerConfig - Konfigurasi logger
+     * @param authMiddleware - Middleware untuk authentication type "auth"
+     * @param refreshMiddleware - Middleware untuk authentication type "refresh"
+     * @param responseEnvelope - Mode response wrapping ("wrap" | "raw")
+     * @param globalPrefix - Prefix global untuk semua route (contoh: "/api")
+     */
+    constructor(adapter: BaseAdapter, loggerConfig?: (boolean | import("../types/index.js").LoggerConfig) | undefined, authMiddleware?: MiddlewareFn | undefined, refreshMiddleware?: MiddlewareFn | undefined, responseEnvelope?: "wrap" | "raw", globalPrefix?: string);
+    /**
+     * Resolves and registers all routes from a controller class.
+     * Membaca metadata dari `Symbol.metadata` (TC39) dan WeakMap (parameter),
+     * lalu mendaftarkan setiap route ke adapter.
+     *
+     * @param Controller - Controller class yang sudah di-decorate dengan @ReqController
+     *
+     * @throws Error jika class tidak memiliki @ReqController
+     * @throws Error jika ditemukan duplikat route
+     *
+     * @example
+     * ```typescript
+     * const resolver = new RouteResolver(adapter);
+     * resolver.resolve(UserController);
+     * ```
+     */
+    resolve(Controller: Class): void;
+    /**
+     * Registers a single route: build path, resolve auth, inject params, register to adapter.
+     */
+    private registerRoute;
+    /**
+     * Builds the full URL path from controller base path + method path + global prefix.
+     */
+    private buildFullPath;
+    /**
+     * Resolves effective auth type: method-level override, else controller-level.
+     */
+    private resolveAuthType;
+    /**
+     * Resolves authentication middleware array from auth type.
+     * Returns empty array if auth is disabled or middleware not configured.
+     */
+    private resolveAuthMiddleware;
+    /**
+     * Creates the route handler that manages parameter injection, response sending,
+     * error handling, and logging.
+     */
+    private createHandler;
+    /**
+     * Resolves parameter values from the request based on param metadata.
+     * Parameters are sorted by index to ensure correct order.
+     */
+    private resolveParams;
+    /**
+     * Resolves a single parameter value from the request.
+     * Supports: body, query, param, req, cookie, reply.
+     */
+    private resolveParam;
+    /**
+     * Validates data against a Zod schema.
+     * Throws BadRequestException with field-level errors on validation failure.
+     */
+    private validateWithZod;
+    /**
+     * Handles errors thrown during route execution:
+     * - BaseException → send with its status code
+     * - Unknown errors → wrap as 500 ServerErrorException
+     */
+    private handleError;
+}
+//# sourceMappingURL=RouteResolver.d.ts.map

package/dist/core/RouteResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RouteResolver.d.ts","sourceRoot":"","sources":["../../core/RouteResolver.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAIV,YAAY,EACZ,aAAa,EACb,KAAK,EAEN,MAAM,mBAAmB,CAAC;AAE3B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAO9D;;;;;;GAMG;AACH,qBAAa,aAAa;IAgBtB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;IAC9B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC;IAChC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC;IACnC,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IACjC,OAAO,CAAC,QAAQ,CAAC,YAAY;IApB/B,kEAAkE;IAClE,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAqB;IAEtD,gFAAgF;IAChF,QAAQ,CAAC,cAAc,EAAE,aAAa,EAAE,CAAM;IAE9C;;;;;;;OAOG;gBAEgB,OAAO,EAAE,WAAW,EACpB,YAAY,CAAC,GAAE,OAAO,GAAG,OAAO,mBAAmB,EAAE,YAAY,aAAA,EACjE,cAAc,CAAC,EAAE,YAAY,YAAA,EAC7B,iBAAiB,CAAC,EAAE,YAAY,YAAA,EAChC,gBAAgB,GAAE,MAAM,GAAG,KAAc,EACzC,YAAY,GAAE,MAAW;IAG5C;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,UAAU,EAAE,KAAK,GAAG,IAAI;IAmBhC;;OAEG;IACH,OAAO,CAAC,aAAa;IAkDrB;;OAEG;IACH,OAAO,CAAC,aAAa;IAUrB;;OAEG;IACH,OAAO,CAAC,eAAe;IAUvB;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAW7B;;;OAGG;IACH,OAAO,CAAC,aAAa;IAqDrB;;;OAGG;IACH,OAAO,CAAC,aAAa;IAWrB;;;OAGG;IACH,OAAO,CAAC,YAAY;IAqCpB;;;OAGG;IACH,OAAO,CAAC,eAAe;IAiBvB;;;;OAIG;IACH,OAAO,CAAC,WAAW;CAsBpB"}