@wild-framework/http 0.1.0 → 0.2.0

package/dist/index.d.ts

@@ -2,7 +2,8 @@ export { action } from "./action.js";
 export type { ActionHandler } from "./action.js";
 export { ForbiddenException, HttpException, NotFoundException, UnauthorizedException, ValidationException, } from "./errors.js";
 export { HttpProvider } from "./provider.js";
-export { Router } from "./router.js";
+export { Router, type RegisteredRoute } from "./router.js";
 export { ExpressServer, createErrorHandler } from "./server.js";
+export { requestIdMiddleware, requestLogger } from "./logging.js";
 export type { RouteHandler } from "./wrap.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EACH,kBAAkB,EAClB,aAAa,EACb,iBAAiB,EACjB,qBAAqB,EACrB,mBAAmB,GACtB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAChE,YAAY,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EACH,kBAAkB,EAClB,aAAa,EACb,iBAAiB,EACjB,qBAAqB,EACrB,mBAAmB,GACtB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,MAAM,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClE,YAAY,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -3,4 +3,5 @@ export { ForbiddenException, HttpException, NotFoundException, UnauthorizedExcep
 export { HttpProvider } from "./provider.js";
 export { Router } from "./router.js";
 export { ExpressServer, createErrorHandler } from "./server.js";
+export { requestIdMiddleware, requestLogger } from "./logging.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EACH,kBAAkB,EAClB,aAAa,EACb,iBAAiB,EACjB,qBAAqB,EACrB,mBAAmB,GACtB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EACH,kBAAkB,EAClB,aAAa,EACb,iBAAiB,EACjB,qBAAqB,EACrB,mBAAmB,GACtB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,MAAM,EAAwB,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}

package/dist/logging.d.ts

@@ -0,0 +1,16 @@
+import type { RequestHandler } from "express";
+import { Logger } from "@wild-framework/logging";
+/**
+ * Assigns a request id (reusing `x-request-id` when present), echoes it on
+ * the response, and runs the rest of the request inside the request-context
+ * store — so every `Logger` call downstream automatically carries `requestId`.
+ */
+export declare function requestIdMiddleware(): RequestHandler;
+/**
+ * Logs each request on completion: method, path, status, duration, request id.
+ *
+ * `getLogger` resolves lazily so this middleware can be mounted before the
+ * logger binding exists (return `null` to skip logging).
+ */
+export declare function requestLogger(getLogger: () => Logger | null): RequestHandler;
+//# sourceMappingURL=logging.d.ts.map

package/dist/logging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.d.ts","sourceRoot":"","sources":["../src/logging.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAmC,MAAM,SAAS,CAAC;AAE/E,OAAO,EAAE,MAAM,EAAsB,MAAM,yBAAyB,CAAC;AAErE;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,cAAc,CASpD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,MAAM,GAAG,IAAI,GAAG,cAAc,CA4B5E"}

package/dist/logging.js

@@ -0,0 +1,50 @@
+import { randomUUID } from "node:crypto";
+import { Logger, withRequestContext } from "@wild-framework/logging";
+/**
+ * Assigns a request id (reusing `x-request-id` when present), echoes it on
+ * the response, and runs the rest of the request inside the request-context
+ * store — so every `Logger` call downstream automatically carries `requestId`.
+ */
+export function requestIdMiddleware() {
+    return (req, res, next) => {
+        const incoming = req.headers["x-request-id"];
+        const requestId = (Array.isArray(incoming) ? incoming[0] : incoming) ?? randomUUID();
+        res.setHeader("x-request-id", requestId);
+        withRequestContext({ requestId }, () => next());
+    };
+}
+/**
+ * Logs each request on completion: method, path, status, duration, request id.
+ *
+ * `getLogger` resolves lazily so this middleware can be mounted before the
+ * logger binding exists (return `null` to skip logging).
+ */
+export function requestLogger(getLogger) {
+    let logger;
+    return (req, res, next) => {
+        logger ??= getLogger();
+        const start = process.hrtime.bigint();
+        res.on("finish", () => {
+            if (!logger)
+                return;
+            const durationMs = Number(process.hrtime.bigint() - start) / 1e6;
+            const statusCode = res.statusCode;
+            const message = `${req.method} ${req.originalUrl} ${statusCode}`;
+            const context = {
+                method: req.method,
+                path: req.originalUrl,
+                statusCode,
+                durationMs: Math.round(durationMs * 100) / 100,
+                requestId: req.headers["x-request-id"] ?? res.getHeader("x-request-id"),
+            };
+            if (statusCode >= 500)
+                logger.error(message, context);
+            else if (statusCode >= 400)
+                logger.warn(message, context);
+            else
+                logger.info(message, context);
+        });
+        next();
+    };
+}
+//# sourceMappingURL=logging.js.map

package/dist/logging.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.js","sourceRoot":"","sources":["../src/logging.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAErE;;;;GAIG;AACH,MAAM,UAAU,mBAAmB;IAC/B,OAAO,CAAC,GAAY,EAAE,GAAa,EAAE,IAAkB,EAAE,EAAE;QACvD,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QAC7C,MAAM,SAAS,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,UAAU,EAAE,CAAC;QAErF,GAAG,CAAC,SAAS,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC;QAEzC,kBAAkB,CAAC,EAAE,SAAS,EAAE,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;IACpD,CAAC,CAAC;AACN,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,SAA8B;IACxD,IAAI,MAAiC,CAAC;IAEtC,OAAO,CAAC,GAAY,EAAE,GAAa,EAAE,IAAkB,EAAE,EAAE;QACvD,MAAM,KAAK,SAAS,EAAE,CAAC;QAEvB,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACtC,GAAG,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;YAClB,IAAI,CAAC,MAAM;gBAAE,OAAO;YAEpB,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC;YACjE,MAAM,UAAU,GAAG,GAAG,CAAC,UAAU,CAAC;YAClC,MAAM,OAAO,GAAG,GAAG,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,WAAW,IAAI,UAAU,EAAE,CAAC;YACjE,MAAM,OAAO,GAAG;gBACZ,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,IAAI,EAAE,GAAG,CAAC,WAAW;gBACrB,UAAU;gBACV,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,GAAG,CAAC,GAAG,GAAG;gBAC9C,SAAS,EAAE,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,GAAG,CAAC,SAAS,CAAC,cAAc,CAAC;aAC1E,CAAC;YAEF,IAAI,UAAU,IAAI,GAAG;gBAAE,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;iBACjD,IAAI,UAAU,IAAI,GAAG;gBAAE,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;;gBACrD,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACvC,CAAC,CAAC,CAAC;QAEH,IAAI,EAAE,CAAC;IACX,CAAC,CAAC;AACN,CAAC"}

package/dist/provider.d.ts

@@ -3,12 +3,16 @@ import type { Provider, Application } from "@wild-framework/core";
  * Registers the HTTP layer with the application.
  *
  * - `register()`: creates Express app, Router, ExpressServer. Binds Router
- *   into the container and calls `app.setServer()`.
+ *   into the container and calls `app.setServer()`. Adds request-id +
+ *   request-logger middleware (the logger is resolved lazily, so this works
+ *   whether or not `@wild-framework/logging` is registered).
  * - `boot()`: registers the global error handler middleware on the Express app.
  */
 export declare class HttpProvider implements Provider {
     private expressApp;
+    private resolveLogger;
     register(app: Application): void;
     boot(_app: Application): void;
+    private tryResolveLogger;
 }
 //# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAMlE;;;;;;GAMG;AACH,qBAAa,YAAa,YAAW,QAAQ;IACzC,OAAO,CAAC,UAAU,CAAwB;IAE1C,QAAQ,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;IAkBhC,IAAI,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI;CAKhC"}
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAQlE;;;;;;;;GAQG;AACH,qBAAa,YAAa,YAAW,QAAQ;IACzC,OAAO,CAAC,UAAU,CAAwB;IAC1C,OAAO,CAAC,aAAa,CAAsC;IAE3D,QAAQ,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;IA8BhC,IAAI,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI;IAM7B,OAAO,CAAC,gBAAgB;CAG3B"}

package/dist/provider.js

@@ -1,20 +1,28 @@
 import { Container } from "@wild-framework/container";
 import express, {} from "express";
+import { Logger } from "@wild-framework/logging";
 import { Router } from "./router.js";
 import { ExpressServer, createErrorHandler } from "./server.js";
+import { requestIdMiddleware, requestLogger } from "./logging.js";
 /**
  * Registers the HTTP layer with the application.
  *
  * - `register()`: creates Express app, Router, ExpressServer. Binds Router
- *   into the container and calls `app.setServer()`.
+ *   into the container and calls `app.setServer()`. Adds request-id +
+ *   request-logger middleware (the logger is resolved lazily, so this works
+ *   whether or not `@wild-framework/logging` is registered).
  * - `boot()`: registers the global error handler middleware on the Express app.
  */
 export class HttpProvider {
     expressApp = null;
+    resolveLogger = null;
     register(app) {
         const container = app.resolve(Container);
         // Express app
         this.expressApp = express();
+        // Request id + request logging (logger resolved lazily on first request)
+        this.expressApp.use(requestIdMiddleware());
+        this.expressApp.use(requestLogger(() => this.tryResolveLogger()));
         // Router — bound into container so providers can add routes
         const router = new Router(container);
         container.singleton(Router, () => router);
@@ -23,11 +31,22 @@ export class HttpProvider {
         // Server — registered on app for app.listen()
         const server = new ExpressServer(this.expressApp);
         app.setServer(server);
+        this.resolveLogger = () => {
+            try {
+                return app.resolve(Logger);
+            }
+            catch {
+                return null;
+            }
+        };
     }
     boot(_app) {
         // Global error handler — must be the last middleware on the Express app.
         // Added during boot phase 2, after all routes have been registered.
-        this.expressApp.use(createErrorHandler());
+        this.expressApp.use(createErrorHandler(this.tryResolveLogger() ?? undefined));
+    }
+    tryResolveLogger() {
+        return this.resolveLogger ? this.resolveLogger() : null;
     }
 }
 //# sourceMappingURL=provider.js.map

package/dist/provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"provider.js","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,OAAO,EAAE,EAAgB,MAAM,SAAS,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEhE;;;;;;GAMG;AACH,MAAM,OAAO,YAAY;IACb,UAAU,GAAmB,IAAI,CAAC;IAE1C,QAAQ,CAAC,GAAgB;QACrB,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAEzC,cAAc;QACd,IAAI,CAAC,UAAU,GAAG,OAAO,EAAE,CAAC;QAE5B,4DAA4D;QAC5D,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,SAAS,CAAC,CAAC;QACrC,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC;QAE1C,0EAA0E;QAC1E,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,iBAAiB,EAAE,CAAC,CAAC;QAEhD,8CAA8C;QAC9C,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAClD,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAC1B,CAAC;IAED,IAAI,CAAC,IAAiB;QAClB,yEAAyE;QACzE,oEAAoE;QACpE,IAAI,CAAC,UAAW,CAAC,GAAG,CAAC,kBAAkB,EAAE,CAAC,CAAC;IAC/C,CAAC;CACJ"}
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,OAAO,EAAE,EAAgB,MAAM,SAAS,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElE;;;;;;;;GAQG;AACH,MAAM,OAAO,YAAY;IACb,UAAU,GAAmB,IAAI,CAAC;IAClC,aAAa,GAAiC,IAAI,CAAC;IAE3D,QAAQ,CAAC,GAAgB;QACrB,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAEzC,cAAc;QACd,IAAI,CAAC,UAAU,GAAG,OAAO,EAAE,CAAC;QAE5B,yEAAyE;QACzE,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,mBAAmB,EAAE,CAAC,CAAC;QAC3C,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,aAAa,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC;QAElE,4DAA4D;QAC5D,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,SAAS,CAAC,CAAC;QACrC,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC;QAE1C,0EAA0E;QAC1E,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,iBAAiB,EAAE,CAAC,CAAC;QAEhD,8CAA8C;QAC9C,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAClD,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAEtB,IAAI,CAAC,aAAa,GAAG,GAAG,EAAE;YACtB,IAAI,CAAC;gBACD,OAAO,GAAG,CAAC,OAAO,CAAS,MAAM,CAAC,CAAC;YACvC,CAAC;YAAC,MAAM,CAAC;gBACL,OAAO,IAAI,CAAC;YAChB,CAAC;QACL,CAAC,CAAC;IACN,CAAC;IAED,IAAI,CAAC,IAAiB;QAClB,yEAAyE;QACzE,oEAAoE;QACpE,IAAI,CAAC,UAAW,CAAC,GAAG,CAAC,kBAAkB,CAAC,IAAI,CAAC,gBAAgB,EAAE,IAAI,SAAS,CAAC,CAAC,CAAC;IACnF,CAAC;IAEO,gBAAgB;QACpB,OAAO,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAC5D,CAAC;CACJ"}

package/dist/router.d.ts

@@ -1,6 +1,24 @@
 import { Router as ExpressRouter, type RequestHandler } from "express";
+import type { ZodSchema } from "zod";
 import { Container } from "@wild-framework/container";
 import { type RouteHandler } from "./wrap.js";
+import type { ActionHandler } from "./action.js";
+/**
+ * A route registered on the Router, with enough metadata to generate
+ * OpenAPI docs.
+ */
+export interface RegisteredRoute {
+    /** HTTP method (lowercase). */
+    method: "get" | "post" | "put" | "patch" | "delete";
+    /** Route path, e.g. "/users/:id". */
+    path: string;
+    /** Zod request-body schema, if the route used a validator class. */
+    validator?: ZodSchema;
+    /** Name of the validator class, if any (used to name the OpenAPI schema). */
+    validatorName?: string;
+    /** Controller action, if the route used `action(Controller, "method")`. */
+    action?: ActionHandler;
+}
 /**
  * Wild Framework Router.
  *
@@ -13,6 +31,7 @@ import { type RouteHandler } from "./wrap.js";
 export declare class Router {
     private container;
     private expressRouter;
+    private registeredRoutes;
     constructor(container: Container);
     get(path: string, ...handlers: RouteHandler[]): void;
     post(path: string, ...handlers: RouteHandler[]): void;
@@ -23,8 +42,17 @@ export declare class Router {
      * Register global middleware on the router.
      */
     use(...handlers: RequestHandler[]): void;
+    /**
+     * All routes registered on this router, with validator/controller
+     * metadata. Used by `@wild-framework/openapi` to generate docs.
+     */
+    getRegisteredRoutes(): RegisteredRoute[];
     /** @internal — get the underlying Express router. */
     _getExpressRouter(): ExpressRouter;
+    /**
+     * Record a route's metadata for OpenAPI generation.
+     */
+    private track;
     private wrapAll;
 }
 //# sourceMappingURL=router.d.ts.map

package/dist/router.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,SAAS,CAAC;AACvE,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAe,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AAE3D;;;;;;;;GAQG;AACH,qBAAa,MAAM;IAGH,OAAO,CAAC,SAAS;IAF7B,OAAO,CAAC,aAAa,CAAgB;gBAEjB,SAAS,EAAE,SAAS;IAQxC,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,YAAY,EAAE,GAAG,IAAI;IAIpD,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,YAAY,EAAE,GAAG,IAAI;IAIrD,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,YAAY,EAAE,GAAG,IAAI;IAIpD,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,YAAY,EAAE,GAAG,IAAI;IAItD,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,YAAY,EAAE,GAAG,IAAI;IAQvD;;OAEG;IACH,GAAG,CAAC,GAAG,QAAQ,EAAE,cAAc,EAAE,GAAG,IAAI;IAQxC,qDAAqD;IACrD,iBAAiB,IAAI,aAAa;IAIlC,OAAO,CAAC,OAAO;CAGlB"}
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,SAAS,CAAC;AACvE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAe,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC5B,+BAA+B;IAC/B,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;IACpD,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,6EAA6E;IAC7E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,2EAA2E;IAC3E,MAAM,CAAC,EAAE,aAAa,CAAC;CAC1B;AAED;;;;;;;;GAQG;AACH,qBAAa,MAAM;IAIH,OAAO,CAAC,SAAS;IAH7B,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,gBAAgB,CAAyB;gBAE7B,SAAS,EAAE,SAAS;IAQxC,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,YAAY,EAAE,GAAG,IAAI;IAKpD,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,YAAY,EAAE,GAAG,IAAI;IAKrD,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,YAAY,EAAE,GAAG,IAAI;IAKpD,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,YAAY,EAAE,GAAG,IAAI;IAKtD,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,YAAY,EAAE,GAAG,IAAI;IASvD;;OAEG;IACH,GAAG,CAAC,GAAG,QAAQ,EAAE,cAAc,EAAE,GAAG,IAAI;IAQxC;;;OAGG;IACH,mBAAmB,IAAI,eAAe,EAAE;IAQxC,qDAAqD;IACrD,iBAAiB,IAAI,aAAa;IAIlC;;OAEG;IACH,OAAO,CAAC,KAAK;IAuBb,OAAO,CAAC,OAAO;CAGlB"}

package/dist/router.js

@@ -13,6 +13,7 @@ import { wrapHandler } from "./wrap.js";
 export class Router {
     container;
     expressRouter;
+    registeredRoutes = [];
     constructor(container) {
         this.container = container;
         this.expressRouter = ExpressRouter();
@@ -21,18 +22,23 @@ export class Router {
     // HTTP methods
     // -------------------------------------------------------------------
     get(path, ...handlers) {
+        this.track("get", path, handlers);
         this.expressRouter.get(path, ...this.wrapAll(handlers));
     }
     post(path, ...handlers) {
+        this.track("post", path, handlers);
         this.expressRouter.post(path, ...this.wrapAll(handlers));
     }
     put(path, ...handlers) {
+        this.track("put", path, handlers);
         this.expressRouter.put(path, ...this.wrapAll(handlers));
     }
     patch(path, ...handlers) {
+        this.track("patch", path, handlers);
         this.expressRouter.patch(path, ...this.wrapAll(handlers));
     }
     delete(path, ...handlers) {
+        this.track("delete", path, handlers);
         this.expressRouter.delete(path, ...this.wrapAll(handlers));
     }
     // -------------------------------------------------------------------
@@ -45,12 +51,41 @@ export class Router {
         this.expressRouter.use(...handlers);
     }
     // -------------------------------------------------------------------
+    // OpenAPI metadata
+    // -------------------------------------------------------------------
+    /**
+     * All routes registered on this router, with validator/controller
+     * metadata. Used by `@wild-framework/openapi` to generate docs.
+     */
+    getRegisteredRoutes() {
+        return [...this.registeredRoutes];
+    }
+    // -------------------------------------------------------------------
     // Internal
     // -------------------------------------------------------------------
     /** @internal — get the underlying Express router. */
     _getExpressRouter() {
         return this.expressRouter;
     }
+    /**
+     * Record a route's metadata for OpenAPI generation.
+     */
+    track(method, path, handlers) {
+        const entry = { method, path };
+        for (const h of handlers) {
+            // Validator class (has `static schema`)
+            if (typeof h === "function" && "schema" in h) {
+                entry.validator = h.schema;
+                entry.validatorName = h.name;
+                continue;
+            }
+            // Controller action
+            if (typeof h === "object" && h !== null && "controller" in h && "method" in h) {
+                entry.action = h;
+            }
+        }
+        this.registeredRoutes.push(entry);
+    }
     wrapAll(handlers) {
         return handlers.map((h) => wrapHandler(h, this.container));
     }

package/dist/router.js.map

@@ -1 +1 @@
-{"version":3,"file":"router.js","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,aAAa,EAAuB,MAAM,SAAS,CAAC;AACvE,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAE,WAAW,EAAqB,MAAM,WAAW,CAAC;AAE3D;;;;;;;;GAQG;AACH,MAAM,OAAO,MAAM;IAGK;IAFZ,aAAa,CAAgB;IAErC,YAAoB,SAAoB;QAApB,cAAS,GAAT,SAAS,CAAW;QACpC,IAAI,CAAC,aAAa,GAAG,aAAa,EAAE,CAAC;IACzC,CAAC;IAED,sEAAsE;IACtE,eAAe;IACf,sEAAsE;IAEtE,GAAG,CAAC,IAAY,EAAE,GAAG,QAAwB;QACzC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC5D,CAAC;IAED,IAAI,CAAC,IAAY,EAAE,GAAG,QAAwB;QAC1C,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC7D,CAAC;IAED,GAAG,CAAC,IAAY,EAAE,GAAG,QAAwB;QACzC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC5D,CAAC;IAED,KAAK,CAAC,IAAY,EAAE,GAAG,QAAwB;QAC3C,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC9D,CAAC;IAED,MAAM,CAAC,IAAY,EAAE,GAAG,QAAwB;QAC5C,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC/D,CAAC;IAED,sEAAsE;IACtE,aAAa;IACb,sEAAsE;IAEtE;;OAEG;IACH,GAAG,CAAC,GAAG,QAA0B;QAC7B,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC;IACxC,CAAC;IAED,sEAAsE;IACtE,WAAW;IACX,sEAAsE;IAEtE,qDAAqD;IACrD,iBAAiB;QACb,OAAO,IAAI,CAAC,aAAa,CAAC;IAC9B,CAAC;IAEO,OAAO,CAAC,QAAwB;QACpC,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,CAAqB,CAAC;IACnF,CAAC;CACJ"}
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"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"}

package/dist/server.d.ts

@@ -1,5 +1,6 @@
 import type { Server as CoreServer } from "@wild-framework/core";
 import express, { type Express } from "express";
+import type { Logger } from "@wild-framework/logging";
 /**
  * Express-backed implementation of core's `Server` interface.
  *
@@ -17,8 +18,13 @@ export declare class ExpressServer implements CoreServer {
 /**
  * Create a global error handler middleware for Express.
  *
- * Formats `HttpException` instances as structured JSON.
- * Unexpected errors return 500 with a generic message.
+ * Formats `HttpException` instances as structured JSON. Also recognizes
+ * any error carrying a numeric `statusCode` (e.g. `@wild-framework/auth` exceptions),
+ * keeping http decoupled from other packages.
+ *
+ * Unexpected errors return 500 with a generic message. When a `logger` is
+ * provided, unexpected errors are logged through it (carrying the request
+ * id from the request context) instead of `console.error`.
  */
-export declare function createErrorHandler(): express.ErrorRequestHandler;
+export declare function createErrorHandler(logger?: Logger): express.ErrorRequestHandler;
 //# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,OAAO,EAAE,EAAE,KAAK,OAAO,EAAE,MAAM,SAAS,CAAC;AAIhD;;;;GAIG;AACH,qBAAa,aAAc,YAAW,UAAU;IAC5C,OAAO,CAAC,GAAG,CAAU;IACrB,OAAO,CAAC,MAAM,CAA2B;gBAE7B,GAAG,EAAE,OAAO;IAIlB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOnC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAS/B,gBAAgB;IAChB,cAAc,IAAI,OAAO;CAG5B;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAAC,mBAAmB,CAehE"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,OAAO,EAAE,EAAE,KAAK,OAAO,EAAE,MAAM,SAAS,CAAC;AAEhD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAGtD;;;;GAIG;AACH,qBAAa,aAAc,YAAW,UAAU;IAC5C,OAAO,CAAC,GAAG,CAAU;IACrB,OAAO,CAAC,MAAM,CAA2B;gBAE7B,GAAG,EAAE,OAAO;IAIlB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOnC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAS/B,gBAAgB;IAChB,cAAc,IAAI,OAAO;CAG5B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAwC/E"}

package/dist/server.js

@@ -33,17 +33,40 @@ export class ExpressServer {
 /**
  * Create a global error handler middleware for Express.
  *
- * Formats `HttpException` instances as structured JSON.
- * Unexpected errors return 500 with a generic message.
+ * Formats `HttpException` instances as structured JSON. Also recognizes
+ * any error carrying a numeric `statusCode` (e.g. `@wild-framework/auth` exceptions),
+ * keeping http decoupled from other packages.
+ *
+ * Unexpected errors return 500 with a generic message. When a `logger` is
+ * provided, unexpected errors are logged through it (carrying the request
+ * id from the request context) instead of `console.error`.
  */
-export function createErrorHandler() {
-    return (err, _req, res, _next) => {
+export function createErrorHandler(logger) {
+    const logError = logger ?? {
+        error: (message, context) => {
+            console.error(message, context ?? "");
+        },
+    };
+    return (err, req, res, _next) => {
         if (err instanceof HttpException) {
             res.status(err.statusCode).json(err.toJSON());
             return;
         }
-        // Unexpected error — log and return generic 500
-        console.error("[wild/http] Unhandled error:", err);
+        // Structural fallback: any error exposing a statusCode (e.g. auth)
+        const status = err?.statusCode;
+        if (typeof status === "number" && status >= 400 && status < 600) {
+            const message = err instanceof Error ? err.message : "Error";
+            res.status(status).json({
+                error: "Error",
+                message,
+                statusCode: status,
+            });
+            return;
+        }
+        // Unexpected error — log (through the logger when available) and return generic 500
+        logError.error(`Unhandled error: ${req.method} ${req.originalUrl}`, {
+            error: err instanceof Error ? { name: err.name, message: err.message, stack: err.stack } : err,
+        });
         res.status(500).json({
             error: "Internal Server Error",
             message: "An unexpected error occurred.",

package/dist/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AACA,OAAO,OAAO,EAAE,EAAgB,MAAM,SAAS,CAAC;AAEhD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C;;;;GAIG;AACH,MAAM,OAAO,aAAa;IACd,GAAG,CAAU;IACb,MAAM,GAAsB,IAAI,CAAC;IAEzC,YAAY,GAAY;QACpB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IAAY;QACrB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACnC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;YACrD,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;IACP,CAAC;IAED,KAAK,CAAC,QAAQ;QACV,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACnC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;gBACf,OAAO,OAAO,EAAE,CAAC;YACrB,CAAC;YACD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAChE,CAAC,CAAC,CAAC;IACP,CAAC;IAED,gBAAgB;IAChB,cAAc;QACV,OAAO,IAAI,CAAC,GAAG,CAAC;IACpB,CAAC;CACJ;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB;IAC9B,OAAO,CAAC,GAAY,EAAE,IAAqB,EAAE,GAAqB,EAAE,KAA2B,EAAE,EAAE;QAC/F,IAAI,GAAG,YAAY,aAAa,EAAE,CAAC;YAC/B,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;YAC9C,OAAO;QACX,CAAC;QAED,gDAAgD;QAChD,OAAO,CAAC,KAAK,CAAC,8BAA8B,EAAE,GAAG,CAAC,CAAC;QACnD,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;YACjB,KAAK,EAAE,uBAAuB;YAC9B,OAAO,EAAE,+BAA+B;YACxC,UAAU,EAAE,GAAG;SAClB,CAAC,CAAC;IACP,CAAC,CAAC;AACN,CAAC"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AACA,OAAO,OAAO,EAAE,EAAgB,MAAM,SAAS,CAAC;AAGhD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C;;;;GAIG;AACH,MAAM,OAAO,aAAa;IACd,GAAG,CAAU;IACb,MAAM,GAAsB,IAAI,CAAC;IAEzC,YAAY,GAAY;QACpB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IAAY;QACrB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACnC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;YACrD,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;IACP,CAAC;IAED,KAAK,CAAC,QAAQ;QACV,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACnC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;gBACf,OAAO,OAAO,EAAE,CAAC;YACrB,CAAC;YACD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAChE,CAAC,CAAC,CAAC;IACP,CAAC;IAED,gBAAgB;IAChB,cAAc;QACV,OAAO,IAAI,CAAC,GAAG,CAAC;IACpB,CAAC;CACJ;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAe;IAC9C,MAAM,QAAQ,GAAG,MAAM,IAAI;QACvB,KAAK,EAAE,CAAC,OAAe,EAAE,OAAiC,EAAE,EAAE;YAC1D,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC;QAC1C,CAAC;KACJ,CAAC;IAEF,OAAO,CACH,GAAY,EACZ,GAAoB,EACpB,GAAqB,EACrB,KAA2B,EAC7B,EAAE;QACA,IAAI,GAAG,YAAY,aAAa,EAAE,CAAC;YAC/B,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;YAC9C,OAAO;QACX,CAAC;QAED,mEAAmE;QACnE,MAAM,MAAM,GAAI,GAAsC,EAAE,UAAU,CAAC;QACnE,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,IAAI,GAAG,IAAI,MAAM,GAAG,GAAG,EAAE,CAAC;YAC9D,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;YAC7D,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC;gBACpB,KAAK,EAAE,OAAO;gBACd,OAAO;gBACP,UAAU,EAAE,MAAM;aACrB,CAAC,CAAC;YACH,OAAO;QACX,CAAC;QAED,oFAAoF;QACpF,QAAQ,CAAC,KAAK,CAAC,oBAAoB,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,WAAW,EAAE,EAAE;YAChE,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG;SACjG,CAAC,CAAC;QACH,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;YACjB,KAAK,EAAE,uBAAuB;YAC9B,OAAO,EAAE,+BAA+B;YACxC,UAAU,EAAE,GAAG;SAClB,CAAC,CAAC;IACP,CAAC,CAAC;AACN,CAAC"}

package/dist/wrap.d.ts

@@ -2,8 +2,11 @@ import type { Request, Response, NextFunction } from "express";
 import type { ActionHandler } from "./action.js";
 /**
  * Express request handler type (after wrapping).
+ *
+ * Deliberately a loose function signature so user middleware written with
+ * Express 5 types (whose RequestHandler returns `unknown`) is assignable.
  */
-type ExpressHandler = (req: Request, res: Response, next: NextFunction) => void | Promise<void>;
+type ExpressHandler = (req: Request, res: Response, next: NextFunction) => unknown;
 /**
  * Any value that can be used as a route handler — raw middleware,
  * ActionHandler, or a validator class (must have `static schema`).

package/dist/wrap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wrap.d.ts","sourceRoot":"","sources":["../src/wrap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAG/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD;;GAEG;AACH,KAAK,cAAc,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAEhG;;;GAGG;AACH,MAAM,MAAM,YAAY,GAClB,cAAc,GACd,aAAa,GACb,CAAC,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,CAAC;AAExC;;GAEG;AACH,UAAU,QAAQ;IACd,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,CAAC,CAAC;CACjC;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,QAAQ,GAAG,cAAc,CAatF"}
+{"version":3,"file":"wrap.d.ts","sourceRoot":"","sources":["../src/wrap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAG/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD;;;;;GAKG;AACH,KAAK,cAAc,GAAG,CAClB,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,QAAQ,EACb,IAAI,EAAE,YAAY,KACjB,OAAO,CAAC;AAEb;;;GAGG;AACH,MAAM,MAAM,YAAY,GAClB,cAAc,GACd,aAAa,GACb,CAAC,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,CAAC;AAExC;;GAEG;AACH,UAAU,QAAQ;IACd,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,CAAC,CAAC;CACjC;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,QAAQ,GAAG,cAAc,CAatF"}

package/dist/wrap.js.map

@@ -1 +1 @@
-{"version":3,"file":"wrap.js","sourceRoot":"","sources":["../src/wrap.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAwBlD;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,OAAqB,EAAE,SAAmB;IAClE,yEAAyE;IACzE,IAAI,gBAAgB,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5B,OAAO,aAAa,CAAC,OAAO,CAAC,CAAC;IAClC,CAAC;IAED,8CAA8C;IAC9C,IAAI,eAAe,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,OAAO,UAAU,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAC1C,CAAC;IAED,wBAAwB;IACxB,OAAO,OAAyB,CAAC;AACrC,CAAC;AAED,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,SAAS,gBAAgB,CAAC,CAAe;IACrC,OAAO,CACH,OAAO,CAAC,KAAK,UAAU;QACvB,QAAQ,IAAI,CAAC,CAChB,CAAC;AACN,CAAC;AAED,SAAS,eAAe,CAAC,CAAe;IACpC,OAAO,CACH,OAAO,CAAC,KAAK,QAAQ;QACrB,CAAC,KAAK,IAAI;QACV,YAAY,IAAI,CAAC;QACjB,QAAQ,IAAI,CAAC,CAChB,CAAC;AACN,CAAC;AAED,8EAA8E;AAC9E,WAAW;AACX,8EAA8E;AAE9E,SAAS,aAAa,CAClB,cAA6D;IAE7D,2CAA2C;IAC3C,MAAM,MAAM,GAAI,cAAmD,CAAC,MAAM,CAAC;IAE3E,OAAO,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE;QACvB,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAE1C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YAClB,OAAO,IAAI,CAAC,IAAI,mBAAmB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACvD,CAAC;QAED,GAAG,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACvB,IAAI,EAAE,CAAC;IACX,CAAC,CAAC;AACN,CAAC;AAED,SAAS,UAAU,CAAC,MAAqB,EAAE,SAAmB;IAC1D,OAAO,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QAC5B,IAAI,CAAC;YACD,MAAM,QAAQ,GAAG,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAA6B,CAAC;YAClF,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAEvC,IAAI,OAAO,MAAM,KAAK,UAAU,EAAE,CAAC;gBAC/B,MAAM,IAAI,KAAK,CACX,WAAW,MAAM,CAAC,MAAM,8BAA8B,MAAM,CAAC,UAAU,CAAC,IAAI,IAAI,CACnF,CAAC;YACN,CAAC;YAED,MAAM,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QAChD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,IAAI,CAAC,KAAK,CAAC,CAAC;QAChB,CAAC;IACL,CAAC,CAAC;AACN,CAAC"}
+{"version":3,"file":"wrap.js","sourceRoot":"","sources":["../src/wrap.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AA+BlD;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,OAAqB,EAAE,SAAmB;IAClE,yEAAyE;IACzE,IAAI,gBAAgB,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5B,OAAO,aAAa,CAAC,OAAO,CAAC,CAAC;IAClC,CAAC;IAED,8CAA8C;IAC9C,IAAI,eAAe,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,OAAO,UAAU,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAC1C,CAAC;IAED,wBAAwB;IACxB,OAAO,OAAyB,CAAC;AACrC,CAAC;AAED,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,SAAS,gBAAgB,CAAC,CAAe;IACrC,OAAO,CACH,OAAO,CAAC,KAAK,UAAU;QACvB,QAAQ,IAAI,CAAC,CAChB,CAAC;AACN,CAAC;AAED,SAAS,eAAe,CAAC,CAAe;IACpC,OAAO,CACH,OAAO,CAAC,KAAK,QAAQ;QACrB,CAAC,KAAK,IAAI;QACV,YAAY,IAAI,CAAC;QACjB,QAAQ,IAAI,CAAC,CAChB,CAAC;AACN,CAAC;AAED,8EAA8E;AAC9E,WAAW;AACX,8EAA8E;AAE9E,SAAS,aAAa,CAClB,cAA6D;IAE7D,2CAA2C;IAC3C,MAAM,MAAM,GAAI,cAAmD,CAAC,MAAM,CAAC;IAE3E,OAAO,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE;QACvB,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAE1C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YAClB,OAAO,IAAI,CAAC,IAAI,mBAAmB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACvD,CAAC;QAED,GAAG,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACvB,IAAI,EAAE,CAAC;IACX,CAAC,CAAC;AACN,CAAC;AAED,SAAS,UAAU,CAAC,MAAqB,EAAE,SAAmB;IAC1D,OAAO,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QAC5B,IAAI,CAAC;YACD,MAAM,QAAQ,GAAG,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAA6B,CAAC;YAClF,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAEvC,IAAI,OAAO,MAAM,KAAK,UAAU,EAAE,CAAC;gBAC/B,MAAM,IAAI,KAAK,CACX,WAAW,MAAM,CAAC,MAAM,8BAA8B,MAAM,CAAC,UAAU,CAAC,IAAI,IAAI,CACnF,CAAC;YACN,CAAC;YAED,MAAM,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QAChD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,IAAI,CAAC,KAAK,CAAC,CAAC;QAChB,CAAC;IACL,CAAC,CAAC;AACN,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wild-framework/http",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -32,8 +32,10 @@
   ],
   "dependencies": {
     "express": "^5.1.0",
-    "@wild-framework/core": "0.1.0",
-    "@wild-framework/container": "0.1.0"
+    "zod": "^3.24.0",
+    "@wild-framework/core": "0.2.0",
+    "@wild-framework/container": "0.2.0",
+    "@wild-framework/logging": "0.2.0"
   },
   "devDependencies": {
     "@types/express": "^5.0.0"