@kosmojs/api 0.0.9 → 0.0.11

package/package.json

@@ -1,7 +1,7 @@
 {
   "type": "module",
   "name": "@kosmojs/api",
-  "version": "0.0.9",
+  "version": "0.0.11",
   "author": "Slee Woo",
   "license": "MIT",
   "publishConfig": {
@@ -22,32 +22,26 @@
     "./queryparser": {
       "types": "./pkg/src/queryparser/index.d.ts",
       "default": "./pkg/queryparser/index.js"
-    },
-    "./debug": {
-      "types": "./pkg/src/debug.d.ts",
-      "default": "./pkg/debug.js"
     }
   },
   "dependencies": {
-    "@koa/router": "^14.0.0",
+    "@koa/router": "^15.0.0",
     "formidable": "^3.5.4",
     "koa": "^3.1.1",
-    "picomatch": "^4.0.3",
     "qs": "^6.14.0",
-    "raw-body": "^3.0.1",
+    "raw-body": "^3.0.2",
     "string-width": "^8.1.0"
   },
   "devDependencies": {
     "@types/formidable": "^3.4.6",
     "@types/koa": "^3.0.1",
-    "@types/koa__router": "^12.0.5",
     "@types/picomatch": "^4.0.2",
     "@types/qs": "^6.14.0",
-    "@kosmojs/config": "^0.0.9",
-    "@kosmojs/devlib": "^0.0.9"
+    "@kosmojs/config": "^0.0.11",
+    "@kosmojs/devlib": "^0.0.11"
   },
   "scripts": {
-    "build": "esbuilder src/index.ts src/bodyparser/index.ts src/queryparser/index.ts src/debug.ts",
+    "build": "esbuilder src/index.ts src/bodyparser/index.ts src/queryparser/index.ts",
     "test": "vitest --root ../../.. --project core/api"
   }
 }

package/pkg/bodyparser/index.js

@@ -24,7 +24,7 @@ var config_default = {
 var bodyparser_default = { json: json2, form: form2, raw: raw2 };
 function json2(opts = {}) {
   return [
-    async (ctx, next) => {
+    async function useJSONBodyparser(ctx, next) {
       const form3 = IncomingForm({
         maxFieldsSize: opts.limit || config_default.json.limit,
         ...opts
@@ -44,7 +44,7 @@ function json2(opts = {}) {
 }
 function form2(opts = {}) {
   return [
-    async (ctx, next) => {
+    async function useFormBodyparser(ctx, next) {
       const form3 = IncomingForm({
         maxFieldsSize: opts.limit || config_default.form.limit,
         maxFileSize: opts.limit || config_default.form.limit,
@@ -71,7 +71,7 @@ function form2(opts = {}) {
 }
 function raw2(opts = {}) {
   return [
-    async (ctx, next) => {
+    async function useRawBodyparser(ctx, next) {
       const { chunkSize, ...rawParserOptions } = { ...config_default.raw, ...opts };
       const stream = ctx.request.req.pipe(zlib.createUnzip({ chunkSize }));
       ctx.request.body = await rawParser(stream, rawParserOptions);

package/pkg/bodyparser/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/bodyparser/index.ts", "../../src/bodyparser/config.ts"],
-  "sourcesContent": ["import zlib from \"node:zlib\";\n\nimport IncomingForm from \"formidable\";\nimport rawParser from \"raw-body\";\n\nimport type { Middleware } from \"@kosmojs/api\";\n\nimport config from \"./config\";\nimport type {\n  FormOptions,\n  JsonOptions,\n  RawOptions,\n  Trimmer,\n  TrimOption,\n} from \"./types\";\n\nexport * from \"./types\";\nexport { config };\nexport default { json, form, raw };\n\nexport function json(opts: JsonOptions = {}): Array<Middleware> {\n  return [\n    async (ctx, next) => {\n      const form = IncomingForm({\n        maxFieldsSize: opts.limit || config.json.limit,\n        ...opts,\n      });\n\n      const trimmer = trimmerFactory(opts.trim);\n\n      ctx.request.body = await new Promise((resolve, reject) => {\n        form.parse(ctx.request.req, (err, fields) => {\n          if (err) {\n            return reject(err);\n          }\n\n          resolve(trimmer ? trimmer(fields) : fields);\n        });\n      });\n\n      return next();\n    },\n  ];\n}\n\nexport function form(opts: FormOptions = {}): Array<Middleware> {\n  return [\n    async (ctx, next) => {\n      const form = IncomingForm({\n        maxFieldsSize: opts.limit || config.form.limit,\n        maxFileSize: opts.limit || config.form.limit,\n        ...opts,\n      });\n\n      let trimmer = trimmerFactory(opts.trim);\n\n      if (opts.multipart || opts.urlencoded) {\n        trimmer = undefined;\n      }\n\n      ctx.request.body = await new Promise((resolve, reject) => {\n        form.parse(ctx.request.req, (err, fields, files) => {\n          if (err) {\n            return reject(err);\n          }\n\n          resolve({\n            fields: trimmer ? trimmer(fields) : fields,\n            files,\n          });\n        });\n      });\n\n      return next();\n    },\n  ];\n}\n\nexport function raw(opts: RawOptions = {}): Array<Middleware> {\n  return [\n    async (ctx, next) => {\n      const { chunkSize, ...rawParserOptions } = { ...config.raw, ...opts };\n\n      const stream = ctx.request.req.pipe(zlib.createUnzip({ chunkSize }));\n      ctx.request.body = await rawParser(stream, rawParserOptions);\n\n      return next();\n    },\n  ];\n}\n\nfunction trimmerFactory(\n  trimOption: TrimOption | undefined,\n): Trimmer | undefined {\n  if (!Array.isArray(trimOption) || !trimOption.length) {\n    return;\n  }\n\n  const trimableKeys: {\n    [key: string]: boolean;\n  } = trimOption.reduce((m: Record<string, boolean>, k) => {\n    m[k] = true;\n    return m;\n  }, {});\n\n  const trim = (key: string, val: unknown) => {\n    return typeof val === \"string\"\n      ? trimableKeys[key] || trimableKeys[\"*\"]\n        ? val.trim()\n        : val\n      : val;\n  };\n\n  const reducer = (\n    memo: Record<string, unknown>,\n    [key, val]: [string, unknown],\n  ) => {\n    memo[key] = trim(key, val);\n    return memo;\n  };\n\n  return (payload) =>\n    Object.entries(payload).reduce(\n      reducer,\n      // accumulator is set to payload intentionally, to avoid duplication of big strings.\n      // if using a new object for accumulator then trimmed strings will be duplicated?\n      payload,\n    );\n}\n", "import type { FormOptions, JsonOptions, RawOptions } from \"./types\";\n\nexport const json: JsonOptions = {\n  limit: 1024 ** 2,\n  trim: [\"*\"],\n};\n\nexport const form: FormOptions = {\n  limit: 1024 ** 2,\n};\n\nexport const raw: RawOptions = {\n  limit: 1024 ** 2,\n};\n\nexport default {\n  json,\n  form,\n  raw,\n};\n"],
-  "mappings": "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",
+  "sourcesContent": ["import zlib from \"node:zlib\";\n\nimport IncomingForm from \"formidable\";\nimport rawParser from \"raw-body\";\n\nimport type { ParameterizedMiddleware } from \"@kosmojs/api\";\n\nimport config from \"./config\";\nimport type {\n  FormOptions,\n  JsonOptions,\n  RawOptions,\n  Trimmer,\n  TrimOption,\n} from \"./types\";\n\nexport * from \"./types\";\nexport { config };\nexport default { json, form, raw };\n\nexport function json(opts: JsonOptions = {}): Array<ParameterizedMiddleware> {\n  return [\n    async function useJSONBodyparser(ctx, next) {\n      const form = IncomingForm({\n        maxFieldsSize: opts.limit || config.json.limit,\n        ...opts,\n      });\n\n      const trimmer = trimmerFactory(opts.trim);\n\n      ctx.request.body = await new Promise((resolve, reject) => {\n        form.parse(ctx.request.req, (err, fields) => {\n          if (err) {\n            return reject(err);\n          }\n\n          resolve(trimmer ? trimmer(fields) : fields);\n        });\n      });\n\n      return next();\n    },\n  ];\n}\n\nexport function form(opts: FormOptions = {}): Array<ParameterizedMiddleware> {\n  return [\n    async function useFormBodyparser(ctx, next) {\n      const form = IncomingForm({\n        maxFieldsSize: opts.limit || config.form.limit,\n        maxFileSize: opts.limit || config.form.limit,\n        ...opts,\n      });\n\n      let trimmer = trimmerFactory(opts.trim);\n\n      if (opts.multipart || opts.urlencoded) {\n        trimmer = undefined;\n      }\n\n      ctx.request.body = await new Promise((resolve, reject) => {\n        form.parse(ctx.request.req, (err, fields, files) => {\n          if (err) {\n            return reject(err);\n          }\n\n          resolve({\n            fields: trimmer ? trimmer(fields) : fields,\n            files,\n          });\n        });\n      });\n\n      return next();\n    },\n  ];\n}\n\nexport function raw(opts: RawOptions = {}): Array<ParameterizedMiddleware> {\n  return [\n    async function useRawBodyparser(ctx, next) {\n      const { chunkSize, ...rawParserOptions } = { ...config.raw, ...opts };\n\n      const stream = ctx.request.req.pipe(zlib.createUnzip({ chunkSize }));\n      ctx.request.body = await rawParser(stream, rawParserOptions);\n\n      return next();\n    },\n  ];\n}\n\nfunction trimmerFactory(\n  trimOption: TrimOption | undefined,\n): Trimmer | undefined {\n  if (!Array.isArray(trimOption) || !trimOption.length) {\n    return;\n  }\n\n  const trimableKeys: {\n    [key: string]: boolean;\n  } = trimOption.reduce((m: Record<string, boolean>, k) => {\n    m[k] = true;\n    return m;\n  }, {});\n\n  const trim = (key: string, val: unknown) => {\n    return typeof val === \"string\"\n      ? trimableKeys[key] || trimableKeys[\"*\"]\n        ? val.trim()\n        : val\n      : val;\n  };\n\n  const reducer = (\n    memo: Record<string, unknown>,\n    [key, val]: [string, unknown],\n  ) => {\n    memo[key] = trim(key, val);\n    return memo;\n  };\n\n  return (payload) =>\n    Object.entries(payload).reduce(\n      reducer,\n      // accumulator is set to payload intentionally, to avoid duplication of big strings.\n      // if using a new object for accumulator then trimmed strings will be duplicated?\n      payload,\n    );\n}\n", "import type { FormOptions, JsonOptions, RawOptions } from \"./types\";\n\nexport const json: JsonOptions = {\n  limit: 1024 ** 2,\n  trim: [\"*\"],\n};\n\nexport const form: FormOptions = {\n  limit: 1024 ** 2,\n};\n\nexport const raw: RawOptions = {\n  limit: 1024 ** 2,\n};\n\nexport default {\n  json,\n  form,\n  raw,\n};\n"],
+  "mappings": "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",
   "names": ["json", "form", "raw"]
 }

package/pkg/index.js

@@ -20,21 +20,84 @@ var ValidationError = class extends Error {
     this.errorSummary = errorSummary;
   }
 };
+var createErrorHandler = (handler) => handler;
 
 // src/router.ts
 import Router from "@koa/router";
 
-// src/types.ts
-var HTTPMethods = /* @__PURE__ */ ((HTTPMethods2) => {
-  HTTPMethods2["HEAD"] = "HEAD";
-  HTTPMethods2["OPTIONS"] = "OPTIONS";
-  HTTPMethods2["GET"] = "GET";
-  HTTPMethods2["PUT"] = "PUT";
-  HTTPMethods2["PATCH"] = "PATCH";
-  HTTPMethods2["POST"] = "POST";
-  HTTPMethods2["DELETE"] = "DELETE";
-  return HTTPMethods2;
-})(HTTPMethods || {});
+// src/debug.ts
+import { styleText } from "node:util";
+import stringWidth from "string-width";
+var colorizeMethod = (method) => {
+  const color = {
+    HEAD: "gray",
+    GET: "green",
+    POST: "blue",
+    PATCH: "blue",
+    PUT: "blue",
+    DELETE: "red"
+  }[method];
+  return color ? styleText(color, method) : method;
+};
+var debug_default = (entry) => {
+  const { path, file } = entry;
+  const methodLines = entry.methods.flatMap((method) => {
+    const coloredMethod = colorizeMethod(method);
+    return method === "GET" ? [coloredMethod + styleText("gray", "|HEAD")] : [coloredMethod];
+  });
+  const middlewareLines = entry.middleware.map(({ options, middleware: middleware2 }) => {
+    const lines = [];
+    if (options?.slot) {
+      lines.push(
+        `${styleText("dim", "slot:")} ${styleText("blue", options.slot)};`
+      );
+    }
+    const funcNames = middleware2.map((fn) => {
+      return styleText("magenta", funcName(fn));
+    });
+    lines.push(`${styleText("dim", "exec:")} ${funcNames.join("; ")}`);
+    return lines.join(" ");
+  }).join(`
+${Array(12).fill(" ").join("")}`);
+  const handlerLines = entry.handler.middleware.map((fn) => {
+    return styleText("yellow", funcName(fn));
+  });
+  const headline = `${styleText("bgBlue", styleText("black", ` ${path} `))} ${styleText("gray", `[ ${file} ]`)}`;
+  const methods = `${styleText("dim", "   methods:")} ${methodLines.join(" ")}`;
+  const middleware = `${styleText("dim", "middleware:")} ${middlewareLines}`;
+  const handler = `${styleText("dim", "   handler:")} ${handlerLines.join(Array(7).fill(" ").join(""))}`;
+  const maxColumns = process.stdout.isTTY ? Number(process.stdout.columns || 80) : 80;
+  const debugEntries = [
+    ["headline", headline],
+    ["methods", methods],
+    ["middleware", middleware],
+    ["handler", handler]
+  ];
+  const lineMapper = (line) => {
+    const freeColumns = maxColumns - stringWidth(line);
+    return freeColumns > 0 ? [
+      line,
+      styleText(
+        "dim",
+        styleText("gray", Array(freeColumns).fill("\xB7").join(""))
+      )
+    ].join("") : line;
+  };
+  const debug = debugEntries.reduce(
+    (map, [key, line]) => {
+      map[key] = line.split("\n").map(lineMapper).join("\n");
+      return map;
+    },
+    {}
+  );
+  return {
+    ...debug,
+    full: Object.values(debug).join("\n")
+  };
+};
+var funcName = (fn) => {
+  return fn.name || fn.toString().split("\n")[0].slice(0, 30);
+};
 
 // src/use.ts
 var use = (middleware, options) => {
@@ -114,6 +177,7 @@ var routerRoutesFactory = (routeSources, {
   coreMiddleware
 }) => {
   const prioritizedSlots = [
+    "errorHandler",
     "params",
     // Path params processing
     "validateParams",
@@ -128,23 +192,17 @@ var routerRoutesFactory = (routeSources, {
     // Response validation
   ];
   const stack = [];
-  for (const route of routeSources) {
-    const {
-      name,
-      path,
-      file,
-      definitionItems,
-      // Includes both middleware and HTTP method handlers
-      params,
-      numericParams,
-      validationSchemas
-    } = route;
+  for (const { name, path, file, ...rest } of routeSources) {
+    const definitionItems = [
+      ...rest.useWrappers,
+      ...rest.definitionItems
+    ].flat();
     const routeMiddleware = definitionItems.filter(
       (e) => e.kind === "middleware"
     );
     const middlewareStack = [
-      ...paramsMiddlewareFactory(params, numericParams),
-      ...validationMiddlewareFactory(validationSchemas),
+      ...paramsMiddlewareFactory(rest.params, rest.numericParams),
+      ...validationMiddlewareFactory(rest.validationSchemas),
       // core middleware overrides builtin middleware (of same slot)
       ...coreMiddleware,
       // route middleware overrides core middleware (of same slot)
@@ -187,25 +245,30 @@ var routerRoutesFactory = (routeSources, {
       })
     ];
     for (const entry of routeStack) {
-      if (entry.kind === "middleware") {
-        stack.push({
-          name,
-          path,
-          file,
-          methods: entry.options?.on || Object.keys(HTTPMethods),
-          middleware: entry.middleware,
-          kind: entry.kind,
-          slot: entry.options?.slot,
-          debug: entry.options?.debug
+      if (entry.kind === "handler") {
+        const middleware = routeStack.flatMap((e) => {
+          if (e.kind === "middleware") {
+            return !e.options?.on || e.options.on.includes(entry.method) ? [e] : [];
+          }
+          return [];
         });
-      } else if (entry.kind === "handler") {
         stack.push({
           name,
           path,
           file,
           methods: [entry.method],
-          middleware: entry.middleware,
-          kind: entry.kind
+          middleware: [
+            ...middleware.flatMap((e) => e.middleware),
+            ...entry.middleware
+          ],
+          debug: debug_default({
+            name,
+            path,
+            file,
+            methods: [entry.method],
+            middleware,
+            handler: entry
+          })
         });
       }
     }
@@ -214,7 +277,7 @@ var routerRoutesFactory = (routeSources, {
 };
 var paramsMiddlewareFactory = (params, numericParams) => [
   use(
-    (ctx, next) => {
+    function useParams(ctx, next) {
       ctx.typedParams = params.reduce(
         (map, [name, isRest]) => {
           const value = ctx.params[name];
@@ -238,14 +301,14 @@ var paramsMiddlewareFactory = (params, numericParams) => [
 ];
 var validationMiddlewareFactory = (validationSchemas) => [
   use(
-    (ctx, next) => {
+    function useValidateParams(ctx, next) {
       validationSchemas.params?.validate(ctx.typedParams);
       return next();
     },
     { slot: "validateParams" }
   ),
   use(
-    (ctx, next) => {
+    function useValidatePayload(ctx, next) {
       validationSchemas.payload?.[ctx.method]?.validate(ctx.payload);
       return next();
     },
@@ -255,7 +318,7 @@ var validationMiddlewareFactory = (validationSchemas) => [
     }
   ),
   use(
-    async (ctx, next) => {
+    async function useValidateResponse(ctx, next) {
       if (validationSchemas.response?.[ctx.method]) {
         await next();
         validationSchemas.response?.[ctx.method]?.validate(ctx.body);
@@ -269,10 +332,23 @@ var validationMiddlewareFactory = (validationSchemas) => [
     }
   )
 ];
+
+// src/types.ts
+var HTTPMethods = /* @__PURE__ */ ((HTTPMethods2) => {
+  HTTPMethods2["HEAD"] = "HEAD";
+  HTTPMethods2["OPTIONS"] = "OPTIONS";
+  HTTPMethods2["GET"] = "GET";
+  HTTPMethods2["PUT"] = "PUT";
+  HTTPMethods2["PATCH"] = "PATCH";
+  HTTPMethods2["POST"] = "POST";
+  HTTPMethods2["DELETE"] = "DELETE";
+  return HTTPMethods2;
+})(HTTPMethods || {});
 export {
   HTTPMethods,
   ValidationError,
   createApp,
+  createErrorHandler,
   createRouter,
   defineRoute,
   routerRoutesFactory,

package/pkg/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../src/app.ts", "../src/errors.ts", "../src/router.ts", "../src/types.ts", "../src/use.ts"],
-  "sourcesContent": ["import Koa from \"koa\";\n\nimport withQueryparser from \"@kosmojs/api/queryparser\";\n\nimport type { CreateApp } from \"./types\";\n\nexport const createApp: CreateApp = (options) => {\n  return withQueryparser(new Koa(options));\n};\n", "import type {\n  ValidationErrorData,\n  ValidationErrorEntry,\n  ValidationErrorScope,\n} from \"./types\";\n\n/**\n * Standardized error wrapper used by validation generators.\n *\n * Instances of this class are thrown whenever validation fails,\n * carrying both the error scope (e.g. `\"params\"`, `\"payload\"`)\n * and the list of validation error details.\n */\nexport class ValidationError extends Error {\n  public scope: ValidationErrorScope;\n  public errors: Array<ValidationErrorEntry> = [];\n  public errorMessage: string;\n  public errorSummary: string;\n\n  constructor([scope, { errors, errorMessage, errorSummary }]: [\n    ValidationErrorScope,\n    ValidationErrorData,\n  ]) {\n    super(JSON.stringify(errors, null, 2));\n    this.name = `${scope}ValidationError`;\n    this.scope = scope;\n    this.errors = errors;\n    this.errorMessage = errorMessage;\n    this.errorSummary = errorSummary;\n  }\n}\n", "import Router from \"@koa/router\";\n\nimport {\n  type CreateRouter,\n  type DefineRoute,\n  type HandlerDefinition,\n  HTTPMethods,\n  type MiddlewareDefinition,\n  type RouterRoute,\n  type RouterRouteSource,\n  type UseSlots,\n  type ValidationSchemas,\n} from \"./types\";\nimport { use } from \"./use\";\n\nexport const createRouter: CreateRouter = (options) => {\n  return new Router(options);\n};\n\nexport const defineRoute: DefineRoute = (factory) => {\n  return factory({\n    use(middleware, options) {\n      return {\n        kind: \"middleware\",\n        middleware: [middleware as never].flat(),\n        options,\n      };\n    },\n    HEAD(middleware) {\n      return {\n        kind: \"handler\",\n        middleware: [middleware as never].flat(),\n        method: \"HEAD\",\n      };\n    },\n    OPTIONS(middleware) {\n      return {\n        kind: \"handler\",\n        middleware: [middleware as never].flat(),\n        method: \"OPTIONS\",\n      };\n    },\n    GET(middleware) {\n      return {\n        kind: \"handler\",\n        middleware: [middleware as never].flat(),\n        method: \"GET\",\n      };\n    },\n    POST(middleware) {\n      return {\n        kind: \"handler\",\n        middleware: [middleware as never].flat(),\n        method: \"POST\",\n      };\n    },\n    PUT(middleware) {\n      return {\n        kind: \"handler\",\n        middleware: [middleware as never].flat(),\n        method: \"PUT\",\n      };\n    },\n    PATCH(middleware) {\n      return {\n        kind: \"handler\",\n        middleware: [middleware as never].flat(),\n        method: \"PATCH\",\n      };\n    },\n    DELETE(middleware) {\n      return {\n        kind: \"handler\",\n        middleware: [middleware as never].flat(),\n        method: \"DELETE\",\n      };\n    },\n  });\n};\n\nexport const routerRoutesFactory = (\n  routeSources: Array<RouterRouteSource>,\n  {\n    // Global middleware applied to every route (e.g., logging)\n    coreMiddleware,\n  }: {\n    coreMiddleware: Array<MiddlewareDefinition>;\n  },\n) => {\n  // WARN:: prioritized middleware must run in this exact order!\n  const prioritizedSlots: Array<keyof UseSlots> = [\n    \"params\", // Path params processing\n    \"validateParams\", // Path params validation\n    \"bodyparser\", // Raw request body parsing\n    \"payload\", // Set ctx.payload\n    \"validatePayload\", // Payload validation\n    \"validateResponse\", // Response validation\n  ];\n\n  const stack: Array<RouterRoute> = [];\n\n  // Iterate over each route definition\n  for (const route of routeSources) {\n    const {\n      name,\n      path,\n      file,\n      definitionItems, // Includes both middleware and HTTP method handlers\n      params,\n      numericParams,\n      validationSchemas,\n    } = route;\n\n    const routeMiddleware: Array<MiddlewareDefinition> = definitionItems.filter(\n      (e) => e.kind === \"middleware\",\n    );\n\n    // WARN: the order is critical!\n    // the last defined middleware will take precedence.\n    const middlewareStack: Array<MiddlewareDefinition> = [\n      ...paramsMiddlewareFactory(params, numericParams),\n      ...validationMiddlewareFactory(validationSchemas),\n      // core middleware overrides builtin middleware (of same slot)\n      ...coreMiddleware,\n      // route middleware overrides core middleware (of same slot)\n      ...routeMiddleware,\n    ];\n\n    const routeStack: Array<MiddlewareDefinition | HandlerDefinition> = [\n      ...prioritizedSlots.flatMap((slot) => {\n        const middleware = middlewareStack.findLast(\n          // Using findLast to pick the latest entry,\n          // ensuring later entries override earlier ones.\n          (e) => e.options?.slot === slot,\n        );\n        return middleware //\n          ? [middleware]\n          : [];\n      }),\n\n      ...coreMiddleware.flatMap((entry) => {\n        if (!entry.options?.slot) {\n          // no slot, including regardless\n          return [entry];\n        }\n        if (prioritizedSlots.includes(entry.options?.slot)) {\n          // already picked when inserted prioritized middleware, excluding\n          return [];\n        }\n        const override = routeMiddleware.findLast(\n          // Using findLast to pick the latest entry,\n          // ensuring later entries override earlier ones.\n          (e) => e.options?.slot === entry.options?.slot,\n        );\n        return [override || entry];\n      }),\n\n      ...definitionItems.flatMap((entry) => {\n        const slot =\n          entry.kind === \"middleware\" //\n            ? entry.options?.slot\n            : undefined;\n\n        if (slot) {\n          if (prioritizedSlots.includes(slot)) {\n            // already picked when inserted prioritized middleware, excluding\n            return [];\n          }\n          if (coreMiddleware.some((e) => e.options?.slot === slot)) {\n            // already picked when inserted core middleware, excluding\n            return [];\n          }\n        }\n\n        return [entry];\n      }),\n    ];\n\n    for (const entry of routeStack) {\n      if (entry.kind === \"middleware\") {\n        stack.push({\n          name,\n          path,\n          file,\n          methods: entry.options?.on || Object.keys(HTTPMethods),\n          middleware: entry.middleware,\n          kind: entry.kind,\n          slot: entry.options?.slot,\n          debug: entry.options?.debug,\n        });\n      } else if (entry.kind === \"handler\") {\n        stack.push({\n          name,\n          path,\n          file,\n          methods: [entry.method],\n          middleware: entry.middleware,\n          kind: entry.kind,\n        });\n      }\n    }\n  }\n\n  return stack;\n};\n\nconst paramsMiddlewareFactory = (\n  params: RouterRouteSource[\"params\"],\n  numericParams: RouterRouteSource[\"numericParams\"],\n) => [\n  use(\n    (ctx, next) => {\n      ctx.typedParams = params.reduce(\n        (map: Record<string, unknown>, [name, isRest]) => {\n          const value = ctx.params[name];\n          if (value) {\n            if (isRest) {\n              map[name] = numericParams.includes(name)\n                ? value.split(\"/\").map(Number)\n                : value.split(\"/\");\n            } else {\n              map[name] = numericParams.includes(name) ? Number(value) : value;\n            }\n          } else {\n            map[name] = value;\n          }\n          return map;\n        },\n        {},\n      ) as never;\n      return next();\n    },\n    { slot: \"params\" },\n  ),\n];\n\nconst validationMiddlewareFactory = (validationSchemas: ValidationSchemas) => [\n  use(\n    (ctx, next) => {\n      validationSchemas.params?.validate(ctx.typedParams);\n      return next();\n    },\n    { slot: \"validateParams\" },\n  ),\n\n  use(\n    (ctx, next) => {\n      validationSchemas.payload?.[ctx.method]?.validate(ctx.payload);\n      return next();\n    },\n    {\n      slot: \"validatePayload\",\n      on: Object.keys(validationSchemas.payload || {}) as never,\n    },\n  ),\n\n  use(\n    async (ctx, next) => {\n      if (validationSchemas.response?.[ctx.method]) {\n        await next();\n        validationSchemas.response?.[ctx.method]?.validate(ctx.body);\n      } else {\n        return next();\n      }\n    },\n    {\n      slot: \"validateResponse\",\n      on: Object.keys(validationSchemas.response || {}) as never,\n    },\n  ),\n];\n", "import type {\n  Middleware,\n  RouterOptions,\n  RouterParamContext,\n} from \"@koa/router\";\nimport type { Next } from \"koa\";\n\ndeclare module \"koa\" {\n  interface Request {\n    body?: unknown;\n    rawBody: string;\n  }\n}\n\nexport interface DefaultState {}\nexport interface DefaultContext {}\n\nexport enum HTTPMethods {\n  HEAD = \"HEAD\",\n  OPTIONS = \"OPTIONS\",\n  GET = \"GET\",\n  PUT = \"PUT\",\n  PATCH = \"PATCH\",\n  POST = \"POST\",\n  DELETE = \"DELETE\",\n}\n\nexport type { Middleware };\n\nexport type HTTPMethod = keyof typeof HTTPMethods;\n\nexport type ParameterizedContext<\n  ParamsT,\n  StateT,\n  ContextT,\n  PayloadT = unknown,\n  ResponseT = unknown,\n> = import(\"koa\").ParameterizedContext<\n  DefaultState & StateT,\n  RouterParamContext<StateT, ContextT> &\n    DefaultContext &\n    ContextT & {\n      typedParams: ParamsT;\n      payload: PayloadT;\n    },\n  ResponseT\n>;\n\ntype RouteMiddleware<ParamsT, StateT, ContextT> = (\n  ctx: ParameterizedContext<ParamsT, StateT, ContextT>,\n  next: Next,\n) => Promise<void> | void;\n\nexport type RouteHandler<\n  ParamsT,\n  StateT,\n  ContextT,\n  PayloadT = unknown,\n  ResponseT = unknown,\n> = (\n  ctx: ParameterizedContext<ParamsT, StateT, ContextT, PayloadT, ResponseT>,\n  next: Next,\n) => Promise<void> | void;\n\nexport type MiddlewareDefinition = {\n  kind: \"middleware\";\n  middleware: Array<Middleware>;\n  options?: UseOptions | undefined;\n};\n\nexport type HandlerDefinition = {\n  kind: \"handler\";\n  middleware: Array<Middleware>;\n  method: HTTPMethod;\n};\n\nexport type RouteDefinitionItem = MiddlewareDefinition | HandlerDefinition;\n\nexport type DefineRouteHelpers<\n  ParamsT,\n  StateT,\n  ContextT,\n  OptionalHandlers = undefined,\n> = {\n  // INFO: The `use` helper intentionally does not accept type parameters.\n  // PayloadT and ResponseT are only relevant to route handlers,\n  // as different request methods receive different payloads and return different responses.\n  // Allowing these type parameters on `use` would be misleading,\n  // since middleware operates across multiple request methods with varying types.\n  use: (\n    middleware:\n      | RouteMiddleware<ParamsT, StateT, ContextT>\n      | Array<RouteMiddleware<ParamsT, StateT, ContextT>>,\n    options?: UseOptions,\n  ) => RouteDefinitionItem;\n} & {\n  [M in HTTPMethod]: M extends OptionalHandlers\n    ? <PayloadT = unknown, ResponseT = unknown>(\n        handler?:\n          | RouteHandler<ParamsT, StateT, ContextT, PayloadT, ResponseT>\n          | Array<RouteHandler<ParamsT, StateT, ContextT, PayloadT, ResponseT>>,\n      ) => RouteDefinitionItem\n    : <PayloadT = unknown, ResponseT = unknown>(\n        handler:\n          | RouteHandler<ParamsT, StateT, ContextT, PayloadT, ResponseT>\n          | Array<RouteHandler<ParamsT, StateT, ContextT, PayloadT, ResponseT>>,\n      ) => RouteDefinitionItem;\n};\n\nexport type DefineRoute = <\n  ParamsT = Record<string, string>,\n  StateT = object,\n  ContextT = object,\n>(\n  factory: (\n    helpers: DefineRouteHelpers<ParamsT, StateT, ContextT>,\n  ) => Array<RouteDefinitionItem>,\n) => Array<RouteDefinitionItem>;\n\nexport interface UseSlots {\n  params: string;\n  validateParams: string;\n  bodyparser: string;\n  payload: string;\n  validatePayload: string;\n  validateResponse: string;\n}\n\nexport type UseOptions = {\n  on?: Array<HTTPMethod>;\n  slot?: keyof UseSlots;\n  debug?: string | undefined;\n};\n\nexport type Use = <StateT = DefaultState, ContextT = DefaultContext>(\n  middleware:\n    | RouteMiddleware<Record<string, string>, StateT, ContextT>\n    | Array<RouteMiddleware<Record<string, string>, StateT, ContextT>>,\n  options?: UseOptions,\n) => MiddlewareDefinition;\n\nexport type RouterRouteSource = {\n  name: string;\n  path: string;\n  file: string;\n  definitionItems: Array<RouteDefinitionItem>;\n  params: Array<[name: string, isRest?: boolean]>;\n  numericParams: Array<string>;\n  validationSchemas: ValidationSchemas;\n  meta?: Record<string, unknown>;\n};\n\nexport type RouterRoute = {\n  name: string;\n  path: string;\n  file: string;\n  methods: Array<string>;\n  middleware: Array<Middleware>;\n  kind: \"middleware\" | \"handler\";\n  slot?: keyof UseSlots | undefined;\n  debug?: string | undefined;\n};\n\nimport type Koa from \"koa\";\nexport type App = Koa<DefaultState, DefaultContext>;\nexport type AppOptions = ConstructorParameters<typeof import(\"koa\")>[0];\nexport type CreateApp = (options?: AppOptions) => App;\n\nimport type KoaRouter from \"@koa/router\";\nexport type Router = KoaRouter<DefaultState, DefaultContext>;\nexport type { RouterOptions };\nexport type CreateRouter = (options?: RouterOptions) => Router;\n\nexport type DevMiddlewareFactory = (\n  app: App,\n) => (\n  req: import(\"node:http\").IncomingMessage,\n  res: import(\"node:http\").ServerResponse,\n  next: () => Promise<void>,\n) => Promise<void>;\nexport type TeardownHandler = (app: App) => void | Promise<void>;\n\nexport type ValidationSchema = {\n  check: (data: unknown) => boolean;\n  errors: (data: unknown) => Array<ValidationErrorEntry>;\n  errorMessage: (data: unknown) => string;\n  errorSummary: (data: unknown) => string;\n  validate: (data: unknown) => void;\n};\n\nexport type ValidationSchemas<Extend = object> = {\n  params?: ValidationSchema & Extend;\n  payload?: Record<string, ValidationSchema & Extend>;\n  response?: Record<string, ValidationSchema & Extend>;\n};\n\nexport type ValidationErrorScope = \"params\" | \"payload\" | \"response\";\n\n/**\n * Shape of individual validation errors emitted by generators.\n */\nexport type ValidationErrorEntry = {\n  /** JSON Schema keyword that triggered the error (e.g. `format`, `maxItems`, `maxLength`). */\n  keyword: string;\n  /** JSON Pointer\u2013style path to the invalid field (matches JSON Schema `instancePath`). */\n  path: string;\n  /** Human-readable error message. */\n  message: string;\n  /** Constraint parameters (e.g. `{ limit: 5 }`, `{ format: \"email\" }`). */\n  params?: Record<string, unknown>;\n  /** Optional error code for i18n/l10n or custom handling. */\n  code?: string;\n};\n\nexport type ValidationErrorData = {\n  errors: Array<ValidationErrorEntry>;\n  /**\n   * Formats errors into a single human-readable message.\n   * @example: Validation failed: user: missing required properties: \"email\", \"name\"; password: must be at least 8 characters long\n   */\n  errorMessage: string;\n  /**\n   * Gets a simple error summary for quick feedback.\n   * @example: 2 validation errors found across 2 fields\n   */\n  errorSummary: string;\n};\n", "import type { Use } from \"./types\";\n\nexport const use: Use = (middleware, options) => {\n  return {\n    kind: \"middleware\",\n    middleware: [middleware].flat() as never,\n    options,\n  };\n};\n"],
-  "mappings": "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",
-  "names": ["HTTPMethods"]
+  "sources": ["../src/app.ts", "../src/errors.ts", "../src/router.ts", "../src/debug.ts", "../src/use.ts", "../src/types.ts"],
+  "sourcesContent": ["import Koa from \"koa\";\n\nimport withQueryparser from \"@kosmojs/api/queryparser\";\n\nimport type { CreateApp } from \"./types\";\n\nexport const createApp: CreateApp = (options) => {\n  return withQueryparser(new Koa(options));\n};\n", "import type {\n  ParameterizedMiddleware,\n  ValidationErrorData,\n  ValidationErrorEntry,\n  ValidationErrorScope,\n} from \"./types\";\n\n/**\n * Standardized error wrapper used by validation generators.\n *\n * Instances of this class are thrown whenever validation fails,\n * carrying both the error scope (e.g. `\"params\"`, `\"payload\"`)\n * and the list of validation error details.\n */\nexport class ValidationError extends Error {\n  public scope: ValidationErrorScope;\n  public errors: Array<ValidationErrorEntry> = [];\n  public errorMessage: string;\n  public errorSummary: string;\n\n  constructor([scope, { errors, errorMessage, errorSummary }]: [\n    ValidationErrorScope,\n    ValidationErrorData,\n  ]) {\n    super(JSON.stringify(errors, null, 2));\n    this.name = `${scope}ValidationError`;\n    this.scope = scope;\n    this.errors = errors;\n    this.errorMessage = errorMessage;\n    this.errorSummary = errorSummary;\n  }\n}\n\nexport const createErrorHandler = (handler: ParameterizedMiddleware) => handler;\n", "import Router, { type RouterMiddleware } from \"@koa/router\";\n\nimport debugRouteEntry from \"./debug\";\nimport type {\n  CreateRouter,\n  DefineRoute,\n  HandlerDefinition,\n  MiddlewareDefinition,\n  RouterRoute,\n  RouterRouteSource,\n  UseSlots,\n  ValidationSchemas,\n} from \"./types\";\nimport { use } from \"./use\";\n\nexport const createRouter: CreateRouter = (options) => {\n  return new Router(options);\n};\n\nexport const defineRoute: DefineRoute = (factory) => {\n  return factory({\n    use(middleware, options) {\n      return {\n        kind: \"middleware\",\n        middleware: [middleware as never].flat(),\n        options,\n      };\n    },\n    HEAD(middleware) {\n      return {\n        kind: \"handler\",\n        middleware: [middleware as never].flat(),\n        method: \"HEAD\",\n      };\n    },\n    OPTIONS(middleware) {\n      return {\n        kind: \"handler\",\n        middleware: [middleware as never].flat(),\n        method: \"OPTIONS\",\n      };\n    },\n    GET(middleware) {\n      return {\n        kind: \"handler\",\n        middleware: [middleware as never].flat(),\n        method: \"GET\",\n      };\n    },\n    POST(middleware) {\n      return {\n        kind: \"handler\",\n        middleware: [middleware as never].flat(),\n        method: \"POST\",\n      };\n    },\n    PUT(middleware) {\n      return {\n        kind: \"handler\",\n        middleware: [middleware as never].flat(),\n        method: \"PUT\",\n      };\n    },\n    PATCH(middleware) {\n      return {\n        kind: \"handler\",\n        middleware: [middleware as never].flat(),\n        method: \"PATCH\",\n      };\n    },\n    DELETE(middleware) {\n      return {\n        kind: \"handler\",\n        middleware: [middleware as never].flat(),\n        method: \"DELETE\",\n      };\n    },\n  });\n};\n\nexport const routerRoutesFactory = (\n  routeSources: Array<RouterRouteSource>,\n  {\n    // Global middleware applied to every route (e.g., logging)\n    coreMiddleware,\n  }: {\n    coreMiddleware: Array<MiddlewareDefinition>;\n  },\n): Array<RouterRoute> => {\n  // WARN:: prioritized middleware must run in this exact order!\n  const prioritizedSlots: Array<keyof UseSlots> = [\n    \"errorHandler\",\n    \"params\", // Path params processing\n    \"validateParams\", // Path params validation\n    \"bodyparser\", // Raw request body parsing\n    \"payload\", // Set ctx.payload\n    \"validatePayload\", // Payload validation\n    \"validateResponse\", // Response validation\n  ];\n\n  const stack: Array<RouterRoute> = [];\n\n  // Iterate over each route definition\n  for (const { name, path, file, ...rest } of routeSources) {\n    // Include both middleware and HTTP method handlers\n    const definitionItems = [\n      ...rest.useWrappers,\n      ...rest.definitionItems,\n    ].flat();\n\n    const routeMiddleware: Array<MiddlewareDefinition> = definitionItems.filter(\n      (e) => e.kind === \"middleware\",\n    );\n\n    // WARN: the order is critical!\n    // the last defined middleware will take precedence.\n    const middlewareStack: Array<MiddlewareDefinition> = [\n      ...paramsMiddlewareFactory(rest.params, rest.numericParams),\n      ...validationMiddlewareFactory(rest.validationSchemas),\n      // core middleware overrides builtin middleware (of same slot)\n      ...coreMiddleware,\n      // route middleware overrides core middleware (of same slot)\n      ...routeMiddleware,\n    ];\n\n    const routeStack: Array<MiddlewareDefinition | HandlerDefinition> = [\n      ...prioritizedSlots.flatMap((slot) => {\n        const middleware = middlewareStack.findLast(\n          // Using findLast to pick the latest entry,\n          // ensuring later entries override earlier ones.\n          (e) => e.options?.slot === slot,\n        );\n        return middleware //\n          ? [middleware]\n          : [];\n      }),\n\n      ...coreMiddleware.flatMap((entry) => {\n        if (!entry.options?.slot) {\n          // no slot, including regardless\n          return [entry];\n        }\n        if (prioritizedSlots.includes(entry.options?.slot)) {\n          // already picked when inserted prioritized middleware, excluding\n          return [];\n        }\n        const override = routeMiddleware.findLast(\n          // Using findLast to pick the latest entry,\n          // ensuring later entries override earlier ones.\n          (e) => e.options?.slot === entry.options?.slot,\n        );\n        return [override || entry];\n      }),\n\n      ...definitionItems.flatMap((entry) => {\n        const slot =\n          entry.kind === \"middleware\" //\n            ? entry.options?.slot\n            : undefined;\n\n        if (slot) {\n          if (prioritizedSlots.includes(slot)) {\n            // already picked when inserted prioritized middleware, excluding\n            return [];\n          }\n          if (coreMiddleware.some((e) => e.options?.slot === slot)) {\n            // already picked when inserted core middleware, excluding\n            return [];\n          }\n        }\n\n        return [entry];\n      }),\n    ];\n\n    for (const entry of routeStack) {\n      if (entry.kind === \"handler\") {\n        const middleware = routeStack.flatMap((e) => {\n          if (e.kind === \"middleware\") {\n            return !e.options?.on || e.options.on.includes(entry.method)\n              ? [e]\n              : [];\n          }\n          return [];\n        });\n        stack.push({\n          name,\n          path,\n          file,\n          methods: [entry.method],\n          middleware: [\n            ...middleware.flatMap((e) => e.middleware),\n            ...entry.middleware,\n          ] as unknown as Array<RouterMiddleware>,\n          debug: debugRouteEntry({\n            name,\n            path,\n            file,\n            methods: [entry.method],\n            middleware,\n            handler: entry,\n          }),\n        });\n      }\n    }\n  }\n\n  return stack;\n};\n\nconst paramsMiddlewareFactory = (\n  params: RouterRouteSource[\"params\"],\n  numericParams: RouterRouteSource[\"numericParams\"],\n) => [\n  use(\n    function useParams(ctx, next) {\n      ctx.typedParams = params.reduce(\n        (map: Record<string, unknown>, [name, isRest]) => {\n          const value = ctx.params[name];\n          if (value) {\n            if (isRest) {\n              map[name] = numericParams.includes(name)\n                ? value.split(\"/\").map(Number)\n                : value.split(\"/\");\n            } else {\n              map[name] = numericParams.includes(name) ? Number(value) : value;\n            }\n          } else {\n            map[name] = value;\n          }\n          return map;\n        },\n        {},\n      ) as never;\n      return next();\n    },\n    { slot: \"params\" },\n  ),\n];\n\nconst validationMiddlewareFactory = (validationSchemas: ValidationSchemas) => [\n  use(\n    function useValidateParams(ctx, next) {\n      validationSchemas.params?.validate(ctx.typedParams);\n      return next();\n    },\n    { slot: \"validateParams\" },\n  ),\n\n  use(\n    function useValidatePayload(ctx, next) {\n      validationSchemas.payload?.[ctx.method]?.validate(ctx.payload);\n      return next();\n    },\n    {\n      slot: \"validatePayload\",\n      on: Object.keys(validationSchemas.payload || {}) as never,\n    },\n  ),\n\n  use(\n    async function useValidateResponse(ctx, next) {\n      if (validationSchemas.response?.[ctx.method]) {\n        await next();\n        validationSchemas.response?.[ctx.method]?.validate(ctx.body);\n      } else {\n        return next();\n      }\n    },\n    {\n      slot: \"validateResponse\",\n      on: Object.keys(validationSchemas.response || {}) as never,\n    },\n  ),\n];\n", "import { styleText } from \"node:util\";\n\nimport stringWidth from \"string-width\";\n\nimport type {\n  HandlerDefinition,\n  MiddlewareDefinition,\n  RouterRoute,\n} from \"./types\";\n\nconst colorizeMethod = (method: string): string => {\n  const color = (\n    {\n      HEAD: \"gray\",\n      GET: \"green\",\n      POST: \"blue\",\n      PATCH: \"blue\",\n      PUT: \"blue\",\n      DELETE: \"red\",\n    } as const\n  )[method];\n  return color ? styleText(color, method) : method;\n};\n\nexport default (entry: {\n  name: string;\n  path: string;\n  file: string;\n  methods: Array<string>;\n  middleware: Array<MiddlewareDefinition>;\n  handler: HandlerDefinition;\n}): RouterRoute[\"debug\"] => {\n  const { path, file } = entry;\n\n  const methodLines = entry.methods.flatMap((method) => {\n    const coloredMethod = colorizeMethod(method);\n    return method === \"GET\"\n      ? [coloredMethod + styleText(\"gray\", \"|HEAD\")]\n      : [coloredMethod];\n  });\n\n  const middlewareLines = entry.middleware\n    .map(({ options, middleware }) => {\n      const lines: Array<string> = [];\n\n      if (options?.slot) {\n        lines.push(\n          `${styleText(\"dim\", \"slot:\")} ${styleText(\"blue\", options.slot)};`,\n        );\n      }\n\n      const funcNames = middleware.map((fn) => {\n        return styleText(\"magenta\", funcName(fn));\n      });\n\n      lines.push(`${styleText(\"dim\", \"exec:\")} ${funcNames.join(\"; \")}`);\n\n      return lines.join(\" \");\n    })\n    .join(`\\n${Array(12).fill(\" \").join(\"\")}`);\n\n  const handlerLines = entry.handler.middleware.map((fn) => {\n    return styleText(\"yellow\", funcName(fn));\n  });\n\n  const headline = `${styleText(\"bgBlue\", styleText(\"black\", ` ${path} `))} ${styleText(\"gray\", `[ ${file} ]`)}`;\n  const methods = `${styleText(\"dim\", \"   methods:\")} ${methodLines.join(\" \")}`;\n  const middleware = `${styleText(\"dim\", \"middleware:\")} ${middlewareLines}`;\n  const handler = `${styleText(\"dim\", \"   handler:\")} ${handlerLines.join(Array(7).fill(\" \").join(\"\"))}`;\n\n  const maxColumns = process.stdout.isTTY\n    ? Number(process.stdout.columns || 80)\n    : 80;\n\n  const debugEntries = [\n    [\"headline\", headline],\n    [\"methods\", methods],\n    [\"middleware\", middleware],\n    [\"handler\", handler],\n  ] as const;\n\n  const lineMapper = (line: string) => {\n    const freeColumns = maxColumns - stringWidth(line);\n    return freeColumns > 0\n      ? [\n          line,\n          styleText(\n            \"dim\",\n            styleText(\"gray\", Array(freeColumns).fill(\"\u00B7\").join(\"\")),\n          ),\n        ].join(\"\")\n      : line;\n  };\n\n  const debug = debugEntries.reduce(\n    (map, [key, line]) => {\n      map[key] = line.split(\"\\n\").map(lineMapper).join(\"\\n\");\n      return map;\n    },\n    {} as RouterRoute[\"debug\"],\n  );\n\n  return {\n    ...debug,\n    full: Object.values(debug).join(\"\\n\"),\n  };\n};\n\nconst funcName = (fn: Function) => {\n  return fn.name || fn.toString().split(\"\\n\")[0].slice(0, 30);\n};\n", "import type { Use } from \"./types\";\n\nexport const use: Use = (middleware, options) => {\n  return {\n    kind: \"middleware\",\n    middleware: [middleware].flat() as never,\n    options,\n  };\n};\n", "import type {\n  RouterContext,\n  RouterMiddleware,\n  RouterOptions,\n} from \"@koa/router\";\nimport type { Next } from \"koa\";\n\ndeclare module \"koa\" {\n  interface Request {\n    body?: unknown;\n    rawBody: string;\n  }\n}\n\nexport interface DefaultState {}\nexport interface DefaultContext {}\n\nexport enum HTTPMethods {\n  HEAD = \"HEAD\",\n  OPTIONS = \"OPTIONS\",\n  GET = \"GET\",\n  PUT = \"PUT\",\n  PATCH = \"PATCH\",\n  POST = \"POST\",\n  DELETE = \"DELETE\",\n}\n\nexport type HTTPMethod = keyof typeof HTTPMethods;\n\nexport type ParameterizedContext<\n  ParamsT,\n  StateT,\n  ContextT,\n  PayloadT = unknown,\n  ResponseT = unknown,\n> = RouterContext<\n  DefaultState & StateT,\n  DefaultContext &\n    ContextT & {\n      typedParams: ParamsT;\n      payload: PayloadT;\n    },\n  ResponseT\n>;\n\nexport type ParameterizedMiddleware<\n  ParamsT = {},\n  StateT = {},\n  ContextT = {},\n> = (\n  ctx: ParameterizedContext<ParamsT, StateT, ContextT>,\n  next: Next,\n) => Promise<void> | void;\n\nexport type RouteHandler<\n  ParamsT,\n  StateT,\n  ContextT,\n  PayloadT = unknown,\n  ResponseT = unknown,\n> = (\n  ctx: ParameterizedContext<ParamsT, StateT, ContextT, PayloadT, ResponseT>,\n  next: Next,\n) => Promise<void> | void;\n\nexport type MiddlewareDefinition = {\n  kind: \"middleware\";\n  middleware: Array<ParameterizedMiddleware>;\n  options?: UseOptions | undefined;\n};\n\nexport type HandlerDefinition = {\n  kind: \"handler\";\n  middleware: Array<ParameterizedMiddleware>;\n  method: HTTPMethod;\n};\n\nexport type RouteDefinitionItem = MiddlewareDefinition | HandlerDefinition;\n\nexport type DefineRouteHelpers<\n  ParamsT,\n  StateT,\n  ContextT,\n  OptionalHandlers = undefined,\n> = {\n  // INFO: The `use` helper intentionally does not accept type parameters.\n  // PayloadT and ResponseT are only relevant to route handlers,\n  // as different request methods receive different payloads and return different responses.\n  // Allowing these type parameters on `use` would be misleading,\n  // since middleware operates across multiple request methods with varying types.\n  use: (\n    middleware:\n      | ParameterizedMiddleware<ParamsT, StateT, ContextT>\n      | Array<ParameterizedMiddleware<ParamsT, StateT, ContextT>>,\n    options?: UseOptions,\n  ) => RouteDefinitionItem;\n} & {\n  [M in HTTPMethod]: M extends OptionalHandlers\n    ? <PayloadT = unknown, ResponseT = unknown>(\n        handler?:\n          | RouteHandler<ParamsT, StateT, ContextT, PayloadT, ResponseT>\n          | Array<RouteHandler<ParamsT, StateT, ContextT, PayloadT, ResponseT>>,\n      ) => RouteDefinitionItem\n    : <PayloadT = unknown, ResponseT = unknown>(\n        handler:\n          | RouteHandler<ParamsT, StateT, ContextT, PayloadT, ResponseT>\n          | Array<RouteHandler<ParamsT, StateT, ContextT, PayloadT, ResponseT>>,\n      ) => RouteDefinitionItem;\n};\n\nexport type DefineRoute = <\n  ParamsT = Record<string, string>,\n  StateT = object,\n  ContextT = object,\n>(\n  factory: (\n    helpers: DefineRouteHelpers<ParamsT, StateT, ContextT>,\n  ) => Array<RouteDefinitionItem>,\n) => Array<RouteDefinitionItem>;\n\nexport interface UseSlots {\n  errorHandler: string;\n  params: string;\n  validateParams: string;\n  bodyparser: string;\n  payload: string;\n  validatePayload: string;\n  validateResponse: string;\n}\n\nexport type UseOptions = {\n  on?: Array<HTTPMethod>;\n  slot?: keyof UseSlots;\n  debug?: string | undefined;\n};\n\nexport type Use = <StateT = DefaultState, ContextT = DefaultContext>(\n  middleware:\n    | ParameterizedMiddleware<Record<string, string>, StateT, ContextT>\n    | Array<ParameterizedMiddleware<Record<string, string>, StateT, ContextT>>,\n  options?: UseOptions,\n) => MiddlewareDefinition;\n\nexport type RouterRouteSource = {\n  name: string;\n  path: string;\n  file: string;\n  // useWrappers is same as defining middleware inside route definition,\n  // just automatically imported from use.ts files\n  useWrappers: [...a: Array<MiddlewareDefinition>];\n  definitionItems: Array<RouteDefinitionItem>;\n  params: Array<[name: string, isRest?: boolean]>;\n  numericParams: Array<string>;\n  validationSchemas: ValidationSchemas;\n  meta?: Record<string, unknown>;\n};\n\nexport type RouterRoute = {\n  name: string;\n  path: string;\n  file: string;\n  methods: Array<string>;\n  middleware: Array<RouterMiddleware>;\n  debug: {\n    headline: string;\n    methods: string;\n    middleware: string;\n    handler: string;\n    full: string;\n  };\n};\n\nimport type Koa from \"koa\";\nexport type App = Koa<DefaultState, DefaultContext>;\nexport type AppOptions = ConstructorParameters<typeof import(\"koa\")>[0];\nexport type CreateApp = (options?: AppOptions) => App;\n\nimport type KoaRouter from \"@koa/router\";\nexport type Router = KoaRouter<DefaultState, DefaultContext>;\nexport type { RouterOptions };\nexport type CreateRouter = (options?: RouterOptions) => Router;\n\nexport type DevMiddlewareFactory = (\n  app: App,\n) => (\n  req: import(\"node:http\").IncomingMessage,\n  res: import(\"node:http\").ServerResponse,\n  next: () => Promise<void>,\n) => Promise<void>;\nexport type TeardownHandler = (app: App) => void | Promise<void>;\n\nexport type ValidationSchema = {\n  check: (data: unknown) => boolean;\n  errors: (data: unknown) => Array<ValidationErrorEntry>;\n  errorMessage: (data: unknown) => string;\n  errorSummary: (data: unknown) => string;\n  validate: (data: unknown) => void;\n};\n\nexport type ValidationSchemas<Extend = object> = {\n  params?: ValidationSchema & Extend;\n  payload?: Record<string, ValidationSchema & Extend>;\n  response?: Record<string, ValidationSchema & Extend>;\n};\n\nexport type ValidationErrorScope = \"params\" | \"payload\" | \"response\";\n\n/**\n * Shape of individual validation errors emitted by generators.\n */\nexport type ValidationErrorEntry = {\n  /** JSON Schema keyword that triggered the error (e.g. `format`, `maxItems`, `maxLength`). */\n  keyword: string;\n  /** JSON Pointer\u2013style path to the invalid field (matches JSON Schema `instancePath`). */\n  path: string;\n  /** Human-readable error message. */\n  message: string;\n  /** Constraint parameters (e.g. `{ limit: 5 }`, `{ format: \"email\" }`). */\n  params?: Record<string, unknown>;\n  /** Optional error code for i18n/l10n or custom handling. */\n  code?: string;\n};\n\nexport type ValidationErrorData = {\n  errors: Array<ValidationErrorEntry>;\n  /**\n   * Formats errors into a single human-readable message.\n   * @example: Validation failed: user: missing required properties: \"email\", \"name\"; password: must be at least 8 characters long\n   */\n  errorMessage: string;\n  /**\n   * Gets a simple error summary for quick feedback.\n   * @example: 2 validation errors found across 2 fields\n   */\n  errorSummary: string;\n};\n"],
+  "mappings": "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",
+  "names": ["middleware", "HTTPMethods"]
 }

package/pkg/src/bodyparser/index.d.ts

@@ -1,4 +1,4 @@
-import type { Middleware } from "@kosmojs/api";
+import type { ParameterizedMiddleware } from "@kosmojs/api";
 import config from "./config";
 import type { FormOptions, JsonOptions, RawOptions } from "./types";
 export * from "./types";
@@ -9,6 +9,6 @@ declare const _default: {
     raw: typeof raw;
 };
 export default _default;
-export declare function json(opts?: JsonOptions): Array<Middleware>;
-export declare function form(opts?: FormOptions): Array<Middleware>;
-export declare function raw(opts?: RawOptions): Array<Middleware>;
+export declare function json(opts?: JsonOptions): Array<ParameterizedMiddleware>;
+export declare function form(opts?: FormOptions): Array<ParameterizedMiddleware>;
+export declare function raw(opts?: RawOptions): Array<ParameterizedMiddleware>;

package/pkg/src/debug.d.ts

@@ -1,4 +1,10 @@
-import type { RouterRoute } from "./types";
-type Printer = (line: string) => void;
-declare const _default: (routes: Array<RouterRoute>, printer: Printer, patterns?: Array<string> | undefined) => void;
+import type { HandlerDefinition, MiddlewareDefinition, RouterRoute } from "./types";
+declare const _default: (entry: {
+    name: string;
+    path: string;
+    file: string;
+    methods: Array<string>;
+    middleware: Array<MiddlewareDefinition>;
+    handler: HandlerDefinition;
+}) => RouterRoute["debug"];
 export default _default;

package/pkg/src/errors.d.ts

@@ -1,4 +1,4 @@
-import type { ValidationErrorData, ValidationErrorEntry, ValidationErrorScope } from "./types";
+import type { ParameterizedMiddleware, ValidationErrorData, ValidationErrorEntry, ValidationErrorScope } from "./types";
 /**
  * Standardized error wrapper used by validation generators.
  *
@@ -16,3 +16,4 @@ export declare class ValidationError extends Error {
         ValidationErrorData
     ]);
 }
+export declare const createErrorHandler: (handler: ParameterizedMiddleware) => ParameterizedMiddleware;

package/pkg/src/router.d.ts

@@ -1,6 +1,6 @@
-import { type CreateRouter, type DefineRoute, type MiddlewareDefinition, type RouterRoute, type RouterRouteSource } from "./types";
+import type { CreateRouter, DefineRoute, MiddlewareDefinition, RouterRoute, RouterRouteSource } from "./types";
 export declare const createRouter: CreateRouter;
 export declare const defineRoute: DefineRoute;
 export declare const routerRoutesFactory: (routeSources: Array<RouterRouteSource>, { coreMiddleware, }: {
     coreMiddleware: Array<MiddlewareDefinition>;
-}) => RouterRoute[];
+}) => Array<RouterRoute>;

package/pkg/src/types.d.ts

@@ -1,4 +1,4 @@
-import type { Middleware, RouterOptions, RouterParamContext } from "@koa/router";
+import type { RouterContext, RouterMiddleware, RouterOptions } from "@koa/router";
 import type { Next } from "koa";
 declare module "koa" {
     interface Request {
@@ -19,32 +19,32 @@ export declare enum HTTPMethods {
     POST = "POST",
     DELETE = "DELETE"
 }
-export type { Middleware };
 export type HTTPMethod = keyof typeof HTTPMethods;
-export type ParameterizedContext<ParamsT, StateT, ContextT, PayloadT = unknown, ResponseT = unknown> = import("koa").ParameterizedContext<DefaultState & StateT, RouterParamContext<StateT, ContextT> & DefaultContext & ContextT & {
+export type ParameterizedContext<ParamsT, StateT, ContextT, PayloadT = unknown, ResponseT = unknown> = RouterContext<DefaultState & StateT, DefaultContext & ContextT & {
     typedParams: ParamsT;
     payload: PayloadT;
 }, ResponseT>;
-type RouteMiddleware<ParamsT, StateT, ContextT> = (ctx: ParameterizedContext<ParamsT, StateT, ContextT>, next: Next) => Promise<void> | void;
+export type ParameterizedMiddleware<ParamsT = {}, StateT = {}, ContextT = {}> = (ctx: ParameterizedContext<ParamsT, StateT, ContextT>, next: Next) => Promise<void> | void;
 export type RouteHandler<ParamsT, StateT, ContextT, PayloadT = unknown, ResponseT = unknown> = (ctx: ParameterizedContext<ParamsT, StateT, ContextT, PayloadT, ResponseT>, next: Next) => Promise<void> | void;
 export type MiddlewareDefinition = {
     kind: "middleware";
-    middleware: Array<Middleware>;
+    middleware: Array<ParameterizedMiddleware>;
     options?: UseOptions | undefined;
 };
 export type HandlerDefinition = {
     kind: "handler";
-    middleware: Array<Middleware>;
+    middleware: Array<ParameterizedMiddleware>;
     method: HTTPMethod;
 };
 export type RouteDefinitionItem = MiddlewareDefinition | HandlerDefinition;
 export type DefineRouteHelpers<ParamsT, StateT, ContextT, OptionalHandlers = undefined> = {
-    use: (middleware: RouteMiddleware<ParamsT, StateT, ContextT> | Array<RouteMiddleware<ParamsT, StateT, ContextT>>, options?: UseOptions) => RouteDefinitionItem;
+    use: (middleware: ParameterizedMiddleware<ParamsT, StateT, ContextT> | Array<ParameterizedMiddleware<ParamsT, StateT, ContextT>>, options?: UseOptions) => RouteDefinitionItem;
 } & {
     [M in HTTPMethod]: M extends OptionalHandlers ? <PayloadT = unknown, ResponseT = unknown>(handler?: RouteHandler<ParamsT, StateT, ContextT, PayloadT, ResponseT> | Array<RouteHandler<ParamsT, StateT, ContextT, PayloadT, ResponseT>>) => RouteDefinitionItem : <PayloadT = unknown, ResponseT = unknown>(handler: RouteHandler<ParamsT, StateT, ContextT, PayloadT, ResponseT> | Array<RouteHandler<ParamsT, StateT, ContextT, PayloadT, ResponseT>>) => RouteDefinitionItem;
 };
 export type DefineRoute = <ParamsT = Record<string, string>, StateT = object, ContextT = object>(factory: (helpers: DefineRouteHelpers<ParamsT, StateT, ContextT>) => Array<RouteDefinitionItem>) => Array<RouteDefinitionItem>;
 export interface UseSlots {
+    errorHandler: string;
     params: string;
     validateParams: string;
     bodyparser: string;
@@ -57,11 +57,12 @@ export type UseOptions = {
     slot?: keyof UseSlots;
     debug?: string | undefined;
 };
-export type Use = <StateT = DefaultState, ContextT = DefaultContext>(middleware: RouteMiddleware<Record<string, string>, StateT, ContextT> | Array<RouteMiddleware<Record<string, string>, StateT, ContextT>>, options?: UseOptions) => MiddlewareDefinition;
+export type Use = <StateT = DefaultState, ContextT = DefaultContext>(middleware: ParameterizedMiddleware<Record<string, string>, StateT, ContextT> | Array<ParameterizedMiddleware<Record<string, string>, StateT, ContextT>>, options?: UseOptions) => MiddlewareDefinition;
 export type RouterRouteSource = {
     name: string;
     path: string;
     file: string;
+    useWrappers: [...a: Array<MiddlewareDefinition>];
     definitionItems: Array<RouteDefinitionItem>;
     params: Array<[name: string, isRest?: boolean]>;
     numericParams: Array<string>;
@@ -73,10 +74,14 @@ export type RouterRoute = {
     path: string;
     file: string;
     methods: Array<string>;
-    middleware: Array<Middleware>;
-    kind: "middleware" | "handler";
-    slot?: keyof UseSlots | undefined;
-    debug?: string | undefined;
+    middleware: Array<RouterMiddleware>;
+    debug: {
+        headline: string;
+        methods: string;
+        middleware: string;
+        handler: string;
+        full: string;
+    };
 };
 import type Koa from "koa";
 export type App = Koa<DefaultState, DefaultContext>;

package/pkg/debug.js

@@ -1,62 +0,0 @@
-// src/debug.ts
-import { styleText } from "node:util";
-import picomatch from "picomatch";
-import stringWidth from "string-width";
-var dot = "\xB7";
-var colorizeMethod = (method) => {
-  const color = {
-    HEAD: "grey",
-    GET: "green",
-    POST: "blue",
-    PATCH: "blue",
-    PUT: "blue",
-    DELETE: "red"
-  }[method];
-  return color ? styleText(color, method) : method;
-};
-var debug_default = (routes, printer, patterns) => {
-  const patternMatchers = patterns?.flatMap((pattern) => {
-    return pattern?.trim?.() ? [picomatch(pattern)] : [];
-  });
-  for (const { path, file, methods, slot, debug, kind } of routes.filter(
-    ({ name, path: path2 }) => {
-      return patternMatchers?.length ? patternMatchers.some((isMatch) => isMatch(name) || isMatch(path2)) : true;
-    }
-  )) {
-    const lines = [];
-    lines.push(
-      `[ ${styleText("bgBlue", styleText("black", ` ${path} `))} ] ${styleText("gray", file)}`
-    );
-    const methodsLine = methods.map((method) => {
-      const coloredMethod = colorizeMethod(method);
-      if (method === "GET" && kind === "handler") {
-        return coloredMethod + styleText("gray", "|HEAD");
-      }
-      return coloredMethod;
-    }).join(" ");
-    lines.push(`${styleText("dim", "  methods:")} ${methodsLine}`);
-    if (slot) {
-      lines.push(
-        `${styleText("dim", "  slot:   ")} ${styleText("cyan", slot)}`
-      );
-    }
-    if (debug) {
-      lines.push(`  ${styleText("cyan", debug)}`);
-    }
-    const maxColumns = process.stdout.isTTY ? Number(process.stdout.columns || 80) : 80;
-    for (const line of lines.map((e) => `${e} `)) {
-      const freeColumns = maxColumns - stringWidth(line);
-      printer(
-        freeColumns > 0 ? line + styleText(
-          "dim",
-          styleText("gray", Array(freeColumns).fill(dot).join(""))
-        ) : line
-      );
-    }
-    printer("\n");
-  }
-};
-export {
-  debug_default as default
-};
-//# sourceMappingURL=debug.js.map

package/pkg/debug.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../src/debug.ts"],
-  "sourcesContent": ["import { styleText } from \"node:util\";\n\nimport picomatch from \"picomatch\";\nimport stringWidth from \"string-width\";\n\nimport type { RouterRoute } from \"./types\";\n\ntype Printer = (line: string) => void;\n\nconst dot = \"\u00B7\";\n\nconst colorizeMethod = (method: string): string => {\n  const color = (\n    {\n      HEAD: \"grey\",\n      GET: \"green\",\n      POST: \"blue\",\n      PATCH: \"blue\",\n      PUT: \"blue\",\n      DELETE: \"red\",\n    } as const\n  )[method];\n  return color ? styleText(color, method) : method;\n};\n\nexport default (\n  routes: Array<RouterRoute>,\n  printer: Printer,\n  patterns?: Array<string> | undefined, // picomatch patterns\n) => {\n  const patternMatchers = patterns?.flatMap((pattern) => {\n    return pattern?.trim?.() ? [picomatch(pattern)] : [];\n  });\n\n  for (const { path, file, methods, slot, debug, kind } of routes.filter(\n    ({ name, path }) => {\n      return patternMatchers?.length\n        ? patternMatchers.some((isMatch) => isMatch(name) || isMatch(path))\n        : true;\n    },\n  )) {\n    const lines: Array<string> = [];\n\n    lines.push(\n      `[ ${styleText(\"bgBlue\", styleText(\"black\", ` ${path} `))} ] ${styleText(\"gray\", file)}`,\n    );\n\n    const methodsLine = methods\n      .map((method) => {\n        const coloredMethod = colorizeMethod(method);\n        if (method === \"GET\" && kind === \"handler\") {\n          return coloredMethod + styleText(\"gray\", \"|HEAD\");\n        }\n        return coloredMethod;\n      })\n      .join(\" \");\n\n    lines.push(`${styleText(\"dim\", \"  methods:\")} ${methodsLine}`);\n\n    if (slot) {\n      lines.push(\n        `${styleText(\"dim\", \"  slot:   \")} ${styleText(\"cyan\", slot)}`,\n      );\n    }\n\n    if (debug) {\n      lines.push(`  ${styleText(\"cyan\", debug)}`);\n    }\n\n    const maxColumns = process.stdout.isTTY\n      ? Number(process.stdout.columns || 80)\n      : 80;\n\n    for (const line of lines.map((e) => `${e} `)) {\n      const freeColumns = maxColumns - stringWidth(line);\n      printer(\n        freeColumns > 0 //\n          ? line +\n              styleText(\n                \"dim\",\n                styleText(\"gray\", Array(freeColumns).fill(dot).join(\"\")),\n              )\n          : line,\n      );\n    }\n\n    printer(\"\\n\");\n  }\n};\n"],
-  "mappings": ";AAAA,SAAS,iBAAiB;AAE1B,OAAO,eAAe;AACtB,OAAO,iBAAiB;AAMxB,IAAM,MAAM;AAEZ,IAAM,iBAAiB,CAAC,WAA2B;AACjD,QAAM,QACJ;AAAA,IACE,MAAM;AAAA,IACN,KAAK;AAAA,IACL,MAAM;AAAA,IACN,OAAO;AAAA,IACP,KAAK;AAAA,IACL,QAAQ;AAAA,EACV,EACA,MAAM;AACR,SAAO,QAAQ,UAAU,OAAO,MAAM,IAAI;AAC5C;AAEA,IAAO,gBAAQ,CACb,QACA,SACA,aACG;AACH,QAAM,kBAAkB,UAAU,QAAQ,CAAC,YAAY;AACrD,WAAO,SAAS,OAAO,IAAI,CAAC,UAAU,OAAO,CAAC,IAAI,CAAC;AAAA,EACrD,CAAC;AAED,aAAW,EAAE,MAAM,MAAM,SAAS,MAAM,OAAO,KAAK,KAAK,OAAO;AAAA,IAC9D,CAAC,EAAE,MAAM,MAAAA,MAAK,MAAM;AAClB,aAAO,iBAAiB,SACpB,gBAAgB,KAAK,CAAC,YAAY,QAAQ,IAAI,KAAK,QAAQA,KAAI,CAAC,IAChE;AAAA,IACN;AAAA,EACF,GAAG;AACD,UAAM,QAAuB,CAAC;AAE9B,UAAM;AAAA,MACJ,KAAK,UAAU,UAAU,UAAU,SAAS,IAAI,IAAI,GAAG,CAAC,CAAC,MAAM,UAAU,QAAQ,IAAI,CAAC;AAAA,IACxF;AAEA,UAAM,cAAc,QACjB,IAAI,CAAC,WAAW;AACf,YAAM,gBAAgB,eAAe,MAAM;AAC3C,UAAI,WAAW,SAAS,SAAS,WAAW;AAC1C,eAAO,gBAAgB,UAAU,QAAQ,OAAO;AAAA,MAClD;AACA,aAAO;AAAA,IACT,CAAC,EACA,KAAK,GAAG;AAEX,UAAM,KAAK,GAAG,UAAU,OAAO,YAAY,CAAC,IAAI,WAAW,EAAE;AAE7D,QAAI,MAAM;AACR,YAAM;AAAA,QACJ,GAAG,UAAU,OAAO,YAAY,CAAC,IAAI,UAAU,QAAQ,IAAI,CAAC;AAAA,MAC9D;AAAA,IACF;AAEA,QAAI,OAAO;AACT,YAAM,KAAK,KAAK,UAAU,QAAQ,KAAK,CAAC,EAAE;AAAA,IAC5C;AAEA,UAAM,aAAa,QAAQ,OAAO,QAC9B,OAAO,QAAQ,OAAO,WAAW,EAAE,IACnC;AAEJ,eAAW,QAAQ,MAAM,IAAI,CAAC,MAAM,GAAG,CAAC,GAAG,GAAG;AAC5C,YAAM,cAAc,aAAa,YAAY,IAAI;AACjD;AAAA,QACE,cAAc,IACV,OACE;AAAA,UACE;AAAA,UACA,UAAU,QAAQ,MAAM,WAAW,EAAE,KAAK,GAAG,EAAE,KAAK,EAAE,CAAC;AAAA,QACzD,IACF;AAAA,MACN;AAAA,IACF;AAEA,YAAQ,IAAI;AAAA,EACd;AACF;",
-  "names": ["path"]
-}

package/pkg/test/routerRoutesFactory/customMiddleware.test.d.ts

@@ -1 +0,0 @@
-export {};

package/pkg/test/routerRoutesFactory/prioritizedMiddleware.test.d.ts

@@ -1 +0,0 @@
-export {};