@cosmneo/onion-lasagna 0.2.0 → 0.2.1

package/dist/{chunk-PUVAB3JX.js → chunk-XIRJ73IO.js}

@@ -1,8 +1,9 @@
 import {
   collectRoutes,
+  generateOperationId,
   getPathParamNames,
   isRouterDefinition
-} from "./chunk-DS7TE6KZ.js";
+} from "./chunk-XP6PLTV2.js";
 
 // src/presentation/http/openapi/generate.ts
 function isValidJsonSchema(value) {
@@ -17,12 +18,12 @@ function generateOpenAPI(router, config) {
   const collectedRoutes = collectRoutes(routes);
   const paths = {};
   const allTags = /* @__PURE__ */ new Set();
-  for (const { route } of collectedRoutes) {
+  for (const { key, route } of collectedRoutes) {
     const openAPIPath = convertToOpenAPIPath(route.path);
     if (!paths[openAPIPath]) {
       paths[openAPIPath] = {};
     }
-    const operation = buildOperation(route);
+    const operation = buildOperation(key, route);
     const method = route.method.toLowerCase();
     paths[openAPIPath][method] = operation;
     if (operation.tags) {
@@ -64,13 +65,12 @@ function generateOpenAPI(router, config) {
 function convertToOpenAPIPath(path) {
   return path.replace(/:([a-zA-Z_][a-zA-Z0-9_]*)/g, "{$1}");
 }
-function buildOperation(route) {
+function buildOperation(key, route) {
   const operation = {
     responses: buildResponses(route)
   };
-  if (route.docs.operationId) {
-    operation.operationId = route.docs.operationId;
-  }
+  const operationId = route.docs.operationId ?? generateOperationId(key);
+  operation.operationId = operationId;
   if (route.docs.summary) {
     operation.summary = route.docs.summary;
   }
@@ -108,8 +108,8 @@ function buildParameters(route) {
       required: true,
       schema: { type: "string" }
     };
-    if (route.request.params?.schema) {
-      const jsonSchema = route.request.params.schema.toJsonSchema();
+    if (route.request.params) {
+      const jsonSchema = route.request.params.toJsonSchema();
       if (jsonSchema.properties && typeof jsonSchema.properties === "object") {
         const propSchema = jsonSchema.properties[name];
         if (isValidJsonSchema(propSchema)) {
@@ -119,8 +119,8 @@ function buildParameters(route) {
     }
     parameters.push(param);
   }
-  if (route.request.query?.schema) {
-    const querySchema = route.request.query.schema.toJsonSchema();
+  if (route.request.query) {
+    const querySchema = route.request.query.toJsonSchema();
     if (querySchema.properties && typeof querySchema.properties === "object") {
       const requiredFields = new Set(
         Array.isArray(querySchema.required) ? querySchema.required : []
@@ -144,8 +144,8 @@ function buildParameters(route) {
       }
     }
   }
-  if (route.request.headers?.schema) {
-    const headersSchema = route.request.headers.schema.toJsonSchema();
+  if (route.request.headers) {
+    const headersSchema = route.request.headers.toJsonSchema();
     if (headersSchema.properties && typeof headersSchema.properties === "object") {
       const requiredFields = new Set(
         Array.isArray(headersSchema.required) ? headersSchema.required : []
@@ -169,40 +169,42 @@ function buildParameters(route) {
   return parameters;
 }
 function buildRequestBody(route) {
-  const bodyConfig = route.request.body;
-  const contentType = bodyConfig.contentType ?? "application/json";
+  const bodySchema = route.request.body;
+  const meta = route._meta?.body;
+  const contentType = meta?.contentType ?? "application/json";
   const requestBody = {
-    required: bodyConfig.required !== false,
+    required: meta?.required !== false,
     content: {
       [contentType]: {
-        schema: bodyConfig.schema.toJsonSchema()
+        schema: bodySchema.toJsonSchema()
       }
     }
   };
-  if (bodyConfig.description) {
-    requestBody.description = bodyConfig.description;
+  if (meta?.description) {
+    requestBody.description = meta.description;
   }
   return requestBody;
 }
 function buildResponses(route) {
   const responses = {};
-  for (const [statusCode, responseConfig] of Object.entries(route.responses)) {
-    if (!responseConfig || typeof responseConfig !== "object") continue;
-    const response = {
-      description: responseConfig.description ?? `Response ${statusCode}`
-    };
-    const schema = responseConfig.schema;
-    if (schema) {
-      const contentType = responseConfig.contentType ?? "application/json";
-      response.content = {
-        [contentType]: {
-          schema: schema.toJsonSchema()
-        }
-      };
+  if (route.responses && Object.keys(route.responses).length > 0) {
+    for (const [statusCode, config] of Object.entries(route.responses)) {
+      const description = config.description ?? `Response ${statusCode}`;
+      if (config.schema) {
+        const contentType = config.contentType ?? "application/json";
+        responses[statusCode] = {
+          description,
+          content: {
+            [contentType]: {
+              schema: config.schema.toJsonSchema()
+            }
+          }
+        };
+      } else {
+        responses[statusCode] = { description };
+      }
     }
-    responses[statusCode] = response;
-  }
-  if (Object.keys(responses).length === 0) {
+  } else {
     responses["200"] = { description: "Successful response" };
   }
   return responses;
@@ -211,4 +213,4 @@ function buildResponses(route) {
 export {
   generateOpenAPI
 };
-//# sourceMappingURL=chunk-PUVAB3JX.js.map
+//# sourceMappingURL=chunk-XIRJ73IO.js.map

package/dist/chunk-XIRJ73IO.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/presentation/http/openapi/generate.ts"],"sourcesContent":["/**\n * @fileoverview OpenAPI specification generation from router definitions (v2 — flat API).\n *\n * The `generateOpenAPI` function creates a complete OpenAPI 3.1 specification\n * from a router definition. All route schemas are converted to JSON Schema\n * and included in the specification.\n *\n * Schemas are read from `route.request` (body, query, params, headers) and\n * per-status response schemas from `route.responses`.\n *\n * @module unified/openapi/generate\n */\n\nimport type { JsonSchema, SchemaAdapter } from '../schema/types';\nimport type { RouterConfig, RouterDefinition, RouteDefinition } from '../route/types';\nimport { isRouterDefinition, collectRoutes, getPathParamNames } from '../route/types';\nimport { generateOperationId } from '../route/utils';\nimport type {\n  OpenAPIConfig,\n  OpenAPISpec,\n  OpenAPIPaths,\n  OpenAPIPathItem,\n  OpenAPIOperation,\n  OpenAPIParameter,\n  OpenAPIRequestBody,\n  OpenAPIResponses,\n  OpenAPITag,\n} from './types';\n\n/**\n * Checks if a value is a valid JSON schema structure.\n *\n * A valid JSON schema must be an object and have at least one of:\n * - `type` property (primitive or object types)\n * - `$ref` property (reference to another schema)\n * - `oneOf`, `anyOf`, `allOf` (composition)\n * - `properties` (object schema without explicit type)\n * - `items` (array schema without explicit type)\n * - `enum` (enumeration)\n * - `const` (constant value)\n *\n * @param value - The value to check\n * @returns True if value appears to be a valid JSON schema\n */\nfunction isValidJsonSchema(value: unknown): value is JsonSchema {\n  if (!value || typeof value !== 'object' || Array.isArray(value)) {\n    return false;\n  }\n\n  const schema = value as Record<string, unknown>;\n\n  // Check for valid JSON schema indicators\n  return (\n    'type' in schema ||\n    '$ref' in schema ||\n    'oneOf' in schema ||\n    'anyOf' in schema ||\n    'allOf' in schema ||\n    'properties' in schema ||\n    'items' in schema ||\n    'enum' in schema ||\n    'const' in schema\n  );\n}\n\n/**\n * Generates an OpenAPI specification from a router definition.\n *\n * This function walks the router structure, extracts JSON schemas from\n * all route definitions, and builds a complete OpenAPI 3.1 specification.\n *\n * Operation IDs are auto-generated from the router key path when not\n * explicitly specified in the route docs.\n *\n * @param router - Router definition or router config\n * @param config - OpenAPI configuration (info, servers, security, etc.)\n * @returns Complete OpenAPI specification\n *\n * @example Basic usage\n * ```typescript\n * import { generateOpenAPI } from '@cosmneo/onion-lasagna/http/openapi';\n * import { api } from './routes';\n *\n * const spec = generateOpenAPI(api, {\n *   info: {\n *     title: 'My API',\n *     version: '1.0.0',\n *     description: 'A comprehensive API for managing resources',\n *   },\n *   servers: [\n *     { url: 'http://localhost:3000', description: 'Development' },\n *     { url: 'https://api.example.com', description: 'Production' },\n *   ],\n * });\n *\n * // Serve the spec\n * app.get('/openapi.json', (c) => c.json(spec));\n * ```\n */\nexport function generateOpenAPI<T extends RouterConfig>(\n  router: T | RouterDefinition<T>,\n  config: OpenAPIConfig,\n): OpenAPISpec {\n  const routes = isRouterDefinition(router) ? router.routes : router;\n  const collectedRoutes = collectRoutes(routes);\n\n  // Build paths\n  const paths: OpenAPIPaths = {};\n  const allTags = new Set<string>();\n\n  for (const { key, route } of collectedRoutes) {\n    const openAPIPath = convertToOpenAPIPath(route.path);\n\n    if (!paths[openAPIPath]) {\n      paths[openAPIPath] = {};\n    }\n\n    const operation = buildOperation(key, route);\n    const method = route.method.toLowerCase() as keyof OpenAPIPathItem;\n\n    (paths[openAPIPath] as Record<string, OpenAPIOperation>)[method] = operation;\n\n    // Collect tags\n    if (operation.tags) {\n      for (const tag of operation.tags) {\n        allTags.add(tag);\n      }\n    }\n  }\n\n  // Build the specification\n  const spec: OpenAPISpec = {\n    openapi: config.openapi ?? '3.1.0',\n    info: config.info,\n    paths,\n  };\n\n  // Add optional sections\n  if (config.servers && config.servers.length > 0) {\n    (spec as { servers: typeof config.servers }).servers = config.servers;\n  }\n\n  if (config.securitySchemes && Object.keys(config.securitySchemes).length > 0) {\n    (spec as { components: { securitySchemes: typeof config.securitySchemes } }).components = {\n      securitySchemes: config.securitySchemes,\n    };\n  }\n\n  if (config.security && config.security.length > 0) {\n    (spec as { security: typeof config.security }).security = config.security;\n  }\n\n  // Merge custom tags with collected tags\n  const tags: OpenAPITag[] = config.tags ? [...config.tags] : [];\n  for (const tagName of allTags) {\n    if (!tags.some((t) => t.name === tagName)) {\n      tags.push({ name: tagName });\n    }\n  }\n  if (tags.length > 0) {\n    (spec as unknown as { tags: OpenAPITag[] }).tags = tags;\n  }\n\n  if (config.externalDocs) {\n    (spec as { externalDocs: typeof config.externalDocs }).externalDocs = config.externalDocs;\n  }\n\n  return spec;\n}\n\n/**\n * Converts a path with :param to OpenAPI {param} format.\n */\nfunction convertToOpenAPIPath(path: string): string {\n  return path.replace(/:([a-zA-Z_][a-zA-Z0-9_]*)/g, '{$1}');\n}\n\n/**\n * Builds an OpenAPI operation from a route definition.\n * Auto-generates operationId from the key if not explicitly set.\n */\nfunction buildOperation(key: string, route: RouteDefinition): OpenAPIOperation {\n  const operation: OpenAPIOperation = {\n    responses: buildResponses(route),\n  };\n\n  // operationId: use explicit or auto-generate from router key\n  const operationId = route.docs.operationId ?? generateOperationId(key);\n  (operation as { operationId: string }).operationId = operationId;\n\n  if (route.docs.summary) {\n    (operation as { summary: string }).summary = route.docs.summary;\n  }\n\n  if (route.docs.description) {\n    (operation as { description: string }).description = route.docs.description;\n  }\n\n  if (route.docs.tags && route.docs.tags.length > 0) {\n    (operation as { tags: readonly string[] }).tags = route.docs.tags;\n  }\n\n  if (route.docs.deprecated) {\n    (operation as { deprecated: boolean }).deprecated = true;\n  }\n\n  if (route.docs.security && route.docs.security.length > 0) {\n    (operation as { security: typeof route.docs.security }).security = route.docs.security;\n  }\n\n  if (route.docs.externalDocs) {\n    (operation as { externalDocs: typeof route.docs.externalDocs }).externalDocs =\n      route.docs.externalDocs;\n  }\n\n  // Add parameters\n  const parameters = buildParameters(route);\n  if (parameters.length > 0) {\n    (operation as unknown as { parameters: OpenAPIParameter[] }).parameters = parameters;\n  }\n\n  // Add request body\n  if (route.request.body) {\n    (operation as { requestBody: OpenAPIRequestBody }).requestBody = buildRequestBody(route);\n  }\n\n  return operation;\n}\n\n/**\n * Builds OpenAPI parameters from route request schemas.\n */\nfunction buildParameters(route: RouteDefinition): OpenAPIParameter[] {\n  const parameters: OpenAPIParameter[] = [];\n\n  // Path parameters\n  const pathParamNames = getPathParamNames(route.path);\n  for (const name of pathParamNames) {\n    const param: OpenAPIParameter = {\n      name,\n      in: 'path',\n      required: true,\n      schema: { type: 'string' },\n    };\n\n    // If we have a params schema, try to get more info\n    if (route.request.params) {\n      const jsonSchema = (route.request.params as SchemaAdapter).toJsonSchema();\n      if (jsonSchema.properties && typeof jsonSchema.properties === 'object') {\n        const propSchema = (jsonSchema.properties as Record<string, unknown>)[name];\n        if (isValidJsonSchema(propSchema)) {\n          (param as { schema: JsonSchema }).schema = propSchema;\n        }\n      }\n    }\n\n    parameters.push(param);\n  }\n\n  // Query parameters\n  if (route.request.query) {\n    const querySchema = (route.request.query as SchemaAdapter).toJsonSchema();\n\n    if (querySchema.properties && typeof querySchema.properties === 'object') {\n      const requiredFields = new Set(\n        Array.isArray(querySchema.required) ? querySchema.required : [],\n      );\n\n      for (const [name, propSchema] of Object.entries(\n        querySchema.properties as Record<string, unknown>,\n      )) {\n        // Skip invalid schema structures\n        if (!isValidJsonSchema(propSchema)) {\n          continue;\n        }\n\n        const param: OpenAPIParameter = {\n          name,\n          in: 'query',\n          required: requiredFields.has(name),\n          schema: propSchema,\n        };\n\n        // Add description if present\n        if ('description' in propSchema && typeof propSchema.description === 'string') {\n          (param as { description: string }).description = propSchema.description;\n        }\n\n        parameters.push(param);\n      }\n    }\n  }\n\n  // Header parameters\n  if (route.request.headers) {\n    const headersSchema = (route.request.headers as SchemaAdapter).toJsonSchema();\n\n    if (headersSchema.properties && typeof headersSchema.properties === 'object') {\n      const requiredFields = new Set(\n        Array.isArray(headersSchema.required) ? headersSchema.required : [],\n      );\n\n      for (const [name, propSchema] of Object.entries(\n        headersSchema.properties as Record<string, unknown>,\n      )) {\n        // Skip invalid schema structures\n        if (!isValidJsonSchema(propSchema)) {\n          continue;\n        }\n\n        const param: OpenAPIParameter = {\n          name,\n          in: 'header',\n          required: requiredFields.has(name),\n          schema: propSchema,\n        };\n\n        parameters.push(param);\n      }\n    }\n  }\n\n  return parameters;\n}\n\n/**\n * Builds OpenAPI request body from route.\n * Reads metadata (contentType, required, description) from `route._meta.body`.\n */\nfunction buildRequestBody(route: RouteDefinition): OpenAPIRequestBody {\n  const bodySchema = route.request.body as SchemaAdapter;\n  const meta = route._meta?.body;\n\n  const contentType = meta?.contentType ?? 'application/json';\n\n  const requestBody: OpenAPIRequestBody = {\n    required: meta?.required !== false,\n    content: {\n      [contentType]: {\n        schema: bodySchema.toJsonSchema(),\n      },\n    },\n  };\n\n  if (meta?.description) {\n    (requestBody as { description: string }).description = meta.description;\n  }\n\n  return requestBody;\n}\n\n/**\n * Builds OpenAPI responses from route.\n *\n * Each status code in `route.responses` gets its own entry with\n * description, schema, and content type. If no responses are defined,\n * a default `200` entry is generated.\n */\nfunction buildResponses(route: RouteDefinition): OpenAPIResponses {\n  const responses: OpenAPIResponses = {};\n\n  if (route.responses && Object.keys(route.responses).length > 0) {\n    for (const [statusCode, config] of Object.entries(route.responses)) {\n      const description = config.description ?? `Response ${statusCode}`;\n\n      if (config.schema) {\n        const contentType = config.contentType ?? 'application/json';\n        responses[statusCode] = {\n          description,\n          content: {\n            [contentType]: {\n              schema: (config.schema as SchemaAdapter).toJsonSchema(),\n            },\n          },\n        };\n      } else {\n        responses[statusCode] = { description };\n      }\n    }\n  } else {\n    responses['200'] = { description: 'Successful response' };\n  }\n\n  return responses;\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-DS7TE6KZ.js → chunk-XP6PLTV2.js}

@@ -25,7 +25,7 @@ function normalizePath(path) {
 
 // src/presentation/http/route/types/router-definition.type.ts
 function isRouteDefinition(value) {
-  return typeof value === "object" && value !== null && "method" in value && "path" in value && "responses" in value && "_types" in value;
+  return typeof value === "object" && value !== null && "method" in value && "path" in value && "_types" in value;
 }
 function isRouterDefinition(value) {
   return typeof value === "object" && value !== null && "_isRouter" in value && value._isRouter === true;
@@ -45,6 +45,13 @@ function collectRoutes(config, basePath = "") {
   return routes;
 }
 
+// src/presentation/http/route/utils.ts
+function generateOperationId(key) {
+  return key.split(".").map(
+    (segment, index) => index === 0 ? segment : segment.charAt(0).toUpperCase() + segment.slice(1)
+  ).join("");
+}
+
 export {
   pathToRegex,
   getPathParamNames,
@@ -53,6 +60,7 @@ export {
   normalizePath,
   isRouteDefinition,
   isRouterDefinition,
-  collectRoutes
+  collectRoutes,
+  generateOperationId
 };
-//# sourceMappingURL=chunk-DS7TE6KZ.js.map
+//# sourceMappingURL=chunk-XP6PLTV2.js.map

package/dist/chunk-XP6PLTV2.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/presentation/http/route/types/path-params.type.ts","../src/presentation/http/route/types/router-definition.type.ts","../src/presentation/http/route/utils.ts"],"sourcesContent":["/**\n * @fileoverview Path parameter extraction types.\n *\n * These types enable TypeScript to extract path parameter names from\n * URL path templates at compile time, providing full type safety for\n * path parameters in routes.\n *\n * @module unified/route/types/path-params\n */\n\n/**\n * Extracts parameter names from a path template string.\n *\n * Supports both `:param` and `{param}` syntaxes for maximum compatibility\n * with different routing conventions.\n *\n * @example Colon syntax (Express-style)\n * ```typescript\n * type Params = ExtractPathParamNames<'/users/:userId/posts/:postId'>;\n * // 'userId' | 'postId'\n * ```\n *\n * @example Brace syntax (OpenAPI-style)\n * ```typescript\n * type Params = ExtractPathParamNames<'/users/{userId}/posts/{postId}'>;\n * // 'userId' | 'postId'\n * ```\n *\n * @example No parameters\n * ```typescript\n * type Params = ExtractPathParamNames<'/users'>;\n * // never\n * ```\n */\nexport type ExtractPathParamNames<T extends string> =\n  // Match :param followed by more path\n  T extends `${string}:${infer Param}/${infer Rest}`\n    ? Param | ExtractPathParamNames<`/${Rest}`>\n    : // Match :param at end\n      T extends `${string}:${infer Param}`\n      ? Param\n      : // Match {param} followed by more path\n        T extends `${string}{${infer Param}}/${infer Rest}`\n        ? Param | ExtractPathParamNames<`/${Rest}`>\n        : // Match {param} at end\n          T extends `${string}{${infer Param}}`\n          ? Param\n          : never;\n\n/**\n * Creates an object type with all path parameters as string properties.\n *\n * @example\n * ```typescript\n * type Params = PathParams<'/projects/:projectId/tasks/:taskId'>;\n * // { projectId: string; taskId: string }\n *\n * type NoParams = PathParams<'/projects'>;\n * // Record<string, never> (empty object type)\n * ```\n */\nexport type PathParams<T extends string> =\n  ExtractPathParamNames<T> extends never\n    ? Record<string, never>\n    : Record<ExtractPathParamNames<T>, string>;\n\n/**\n * Checks if a path has any parameters.\n *\n * @example\n * ```typescript\n * type HasParams = HasPathParams<'/users/:id'>; // true\n * type NoParams = HasPathParams<'/users'>; // false\n * ```\n */\nexport type HasPathParams<T extends string> = ExtractPathParamNames<T> extends never ? false : true;\n\n/**\n * Converts a path template with parameters to a regex pattern.\n * This is used internally for route matching.\n *\n * @example\n * ```typescript\n * pathToRegex('/users/:id/posts/:postId')\n * // /^\\/users\\/([^\\/]+)\\/posts\\/([^\\/]+)\\/?$/\n * ```\n */\nexport function pathToRegex(path: string): RegExp {\n  const pattern = path\n    // Escape special regex characters except : and {}\n    .replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&')\n    // Replace :param with capture group\n    .replace(/:([a-zA-Z_][a-zA-Z0-9_]*)/g, '([^/]+)')\n    // Replace {param} with capture group\n    .replace(/\\\\\\{([a-zA-Z_][a-zA-Z0-9_]*)\\\\\\}/g, '([^/]+)');\n\n  return new RegExp(`^${pattern}/?$`);\n}\n\n/**\n * Extracts parameter names from a path string at runtime.\n *\n * @example\n * ```typescript\n * getPathParamNames('/users/:userId/posts/:postId')\n * // ['userId', 'postId']\n * ```\n */\nexport function getPathParamNames(path: string): string[] {\n  // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- regex capture group always exists\n  const colonParams = [...path.matchAll(/:([a-zA-Z_][a-zA-Z0-9_]*)/g)].map((m) => m[1]!);\n  // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- regex capture group always exists\n  const braceParams = [...path.matchAll(/\\{([a-zA-Z_][a-zA-Z0-9_]*)\\}/g)].map((m) => m[1]!);\n  return [...colonParams, ...braceParams];\n}\n\n/**\n * Checks if a path has any parameters at runtime.\n */\nexport function hasPathParams(path: string): boolean {\n  return /:([a-zA-Z_][a-zA-Z0-9_]*)/.test(path) || /\\{([a-zA-Z_][a-zA-Z0-9_]*)\\}/.test(path);\n}\n\n/**\n * Replaces path parameters with actual values.\n *\n * @example\n * ```typescript\n * buildPath('/users/:userId/posts/:postId', { userId: '123', postId: '456' })\n * // '/users/123/posts/456'\n *\n * buildPath('/users/{userId}', { userId: '123' })\n * // '/users/123'\n * ```\n */\nexport function buildPath(template: string, params: Record<string, string>): string {\n  let result = template;\n\n  // Replace :param syntax\n  for (const [key, value] of Object.entries(params)) {\n    result = result.replace(`:${key}`, encodeURIComponent(value));\n    result = result.replace(`{${key}}`, encodeURIComponent(value));\n  }\n\n  return result;\n}\n\n/**\n * Normalizes a path template to use consistent :param syntax.\n *\n * @example\n * ```typescript\n * normalizePath('/users/{userId}')\n * // '/users/:userId'\n * ```\n */\nexport function normalizePath(path: string): string {\n  return path.replace(/\\{([a-zA-Z_][a-zA-Z0-9_]*)\\}/g, ':$1');\n}\n","/**\n * @fileoverview Router definition types for grouping routes.\n *\n * A router is a hierarchical grouping of routes that enables:\n * - Organized API structure\n * - Nested client method generation\n * - Grouped OpenAPI tags\n *\n * @module unified/route/types/router-definition\n */\n\nimport type { RouteDefinition } from './route-definition.type';\nimport type { HttpMethod } from './http.type';\nimport type { SchemaAdapter } from '../../schema/types';\n\n// ============================================================================\n// Router Types\n// ============================================================================\n\n/**\n * A router entry can be a route definition, a nested router config, or a router definition.\n */\nexport type RouterEntry =\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  | RouteDefinition<HttpMethod, string, unknown, unknown, unknown, unknown, unknown, any>\n  | RouterConfig\n  | RouterDefinition;\n\n/**\n * Configuration for a router (group of routes).\n */\nexport interface RouterConfig {\n  readonly [key: string]: RouterEntry;\n}\n\n/**\n * Router-level defaults applied to all child routes.\n */\nexport interface RouterDefaults {\n  /**\n   * Default tags for all routes in this router.\n   * Merged with route-specific tags.\n   */\n  readonly tags?: readonly string[];\n\n  /**\n   * Default context schema for all routes in this router.\n   * Applied to routes that don't define their own context.\n   */\n  readonly context?: SchemaAdapter;\n}\n\n/**\n * A fully defined router.\n */\nexport interface RouterDefinition<T extends RouterConfig = RouterConfig> {\n  /**\n   * The routes and nested routers in this router.\n   */\n  readonly routes: T;\n\n  /**\n   * Base path prefix for all routes in this router.\n   */\n  readonly basePath?: string;\n\n  /**\n   * Default values applied to all child routes.\n   */\n  readonly defaults?: RouterDefaults;\n\n  /**\n   * Marker to identify this as a router.\n   * @internal\n   */\n  readonly _isRouter: true;\n}\n\n// ============================================================================\n// Type Guards\n// ============================================================================\n\n/**\n * Checks if a value is a RouteDefinition.\n */\nexport function isRouteDefinition(value: unknown): value is RouteDefinition {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    'method' in value &&\n    'path' in value &&\n    '_types' in value\n  );\n}\n\n/**\n * Checks if a value is a RouterDefinition.\n */\nexport function isRouterDefinition(value: unknown): value is RouterDefinition {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    '_isRouter' in value &&\n    (value as RouterDefinition)._isRouter === true\n  );\n}\n\n// ============================================================================\n// Utility Types\n// ============================================================================\n\n/**\n * Flattens a router into a map of path keys to route definitions.\n */\nexport type FlattenRouter<\n  T extends RouterConfig,\n  Prefix extends string = '',\n> = T extends RouterConfig\n  ? {\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      [K in keyof T]: T[K] extends RouteDefinition<any, any, any, any, any, any, any, any>\n        ? { [P in `${Prefix}${K & string}`]: T[K] }\n        : T[K] extends RouterConfig\n          ? FlattenRouter<T[K], `${Prefix}${K & string}.`>\n          : never;\n    }[keyof T] extends infer U\n    ? // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      U extends Record<string, RouteDefinition<any, any, any, any, any, any, any, any>>\n      ? U\n      : never\n    : never\n  : never;\n\n/**\n * Gets all route keys from a router.\n */\nexport type RouterKeys<T extends RouterConfig, Prefix extends string = ''> = T extends RouterConfig\n  ? {\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      [K in keyof T]: T[K] extends RouteDefinition<any, any, any, any, any, any, any, any>\n        ? `${Prefix}${K & string}`\n        : T[K] extends RouterConfig\n          ? RouterKeys<T[K], `${Prefix}${K & string}.`>\n          : never;\n    }[keyof T]\n  : never;\n\n/**\n * Gets a route by its dotted key path.\n */\nexport type GetRoute<\n  T extends RouterConfig,\n  K extends string,\n> = K extends `${infer Head}.${infer Tail}`\n  ? Head extends keyof T\n    ? T[Head] extends RouterConfig\n      ? GetRoute<T[Head], Tail>\n      : never\n    : never\n  : K extends keyof T\n    ? // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      T[K] extends RouteDefinition<any, any, any, any, any, any, any, any>\n      ? T[K]\n      : never\n    : never;\n\n// ============================================================================\n// Deep Merge Types\n// ============================================================================\n\n/**\n * Deep-merges two router configs at the type level.\n */\nexport type DeepMergeTwo<A extends RouterConfig, B extends RouterConfig> = {\n  readonly [K in keyof A | keyof B]: K extends keyof A\n    ? K extends keyof B\n      ? A[K] extends RouterConfig\n        ? B[K] extends RouterConfig\n          ? DeepMergeTwo<A[K], B[K]>\n          : B[K]\n        : B[K]\n      : A[K]\n    : K extends keyof B\n      ? B[K]\n      : never;\n};\n\n/**\n * Recursively deep-merges N router configs left-to-right.\n */\nexport type DeepMergeAll<T extends readonly RouterConfig[]> = T extends readonly [\n  infer Only extends RouterConfig,\n]\n  ? Only\n  : T extends readonly [\n        infer First extends RouterConfig,\n        infer Second extends RouterConfig,\n        ...infer Rest extends readonly RouterConfig[],\n      ]\n    ? DeepMergeAll<[DeepMergeTwo<First, Second>, ...Rest]>\n    : RouterConfig;\n\n/**\n * Recursively flattens complex types for clean IDE hover display.\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type PrettifyDeep<T> = T extends (...args: any[]) => any\n  ? T\n  : T extends object\n    ? { readonly [K in keyof T]: PrettifyDeep<T[K]> }\n    : T;\n\n/**\n * Collects all routes from a router into an array.\n */\nexport function collectRoutes(\n  config: RouterConfig,\n  basePath = '',\n): { key: string; route: RouteDefinition }[] {\n  const routes: { key: string; route: RouteDefinition }[] = [];\n\n  for (const [key, value] of Object.entries(config)) {\n    const fullKey = basePath ? `${basePath}.${key}` : key;\n\n    if (isRouteDefinition(value)) {\n      routes.push({ key: fullKey, route: value });\n    } else if (isRouterDefinition(value)) {\n      routes.push(...collectRoutes(value.routes, fullKey));\n    } else if (typeof value === 'object' && value !== null) {\n      routes.push(...collectRoutes(value as RouterConfig, fullKey));\n    }\n  }\n\n  return routes;\n}\n","/**\n * @fileoverview Route utility functions.\n *\n * @module unified/route/utils\n */\n\n/**\n * Generates an operationId from a router key path.\n *\n * Converts dotted key paths to camelCase:\n * - `\"users.list\"` → `\"usersList\"`\n * - `\"organizations.members.get\"` → `\"organizationsMembersGet\"`\n *\n * @param key - The dotted router key path\n * @returns A camelCase operationId string\n */\nexport function generateOperationId(key: string): string {\n  return key\n    .split('.')\n    .map((segment, index) =>\n      index === 0 ? segment : segment.charAt(0).toUpperCase() + segment.slice(1),\n    )\n    .join('');\n}\n"],"mappings":";AAuFO,SAAS,YAAY,MAAsB;AAChD,QAAM,UAAU,KAEb,QAAQ,uBAAuB,MAAM,EAErC,QAAQ,8BAA8B,SAAS,EAE/C,QAAQ,qCAAqC,SAAS;AAEzD,SAAO,IAAI,OAAO,IAAI,OAAO,KAAK;AACpC;AAWO,SAAS,kBAAkB,MAAwB;AAExD,QAAM,cAAc,CAAC,GAAG,KAAK,SAAS,4BAA4B,CAAC,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAE;AAErF,QAAM,cAAc,CAAC,GAAG,KAAK,SAAS,+BAA+B,CAAC,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAE;AACxF,SAAO,CAAC,GAAG,aAAa,GAAG,WAAW;AACxC;AAKO,SAAS,cAAc,MAAuB;AACnD,SAAO,4BAA4B,KAAK,IAAI,KAAK,+BAA+B,KAAK,IAAI;AAC3F;AAcO,SAAS,UAAU,UAAkB,QAAwC;AAClF,MAAI,SAAS;AAGb,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,MAAM,GAAG;AACjD,aAAS,OAAO,QAAQ,IAAI,GAAG,IAAI,mBAAmB,KAAK,CAAC;AAC5D,aAAS,OAAO,QAAQ,IAAI,GAAG,KAAK,mBAAmB,KAAK,CAAC;AAAA,EAC/D;AAEA,SAAO;AACT;AAWO,SAAS,cAAc,MAAsB;AAClD,SAAO,KAAK,QAAQ,iCAAiC,KAAK;AAC5D;;;ACzEO,SAAS,kBAAkB,OAA0C;AAC1E,SACE,OAAO,UAAU,YACjB,UAAU,QACV,YAAY,SACZ,UAAU,SACV,YAAY;AAEhB;AAKO,SAAS,mBAAmB,OAA2C;AAC5E,SACE,OAAO,UAAU,YACjB,UAAU,QACV,eAAe,SACd,MAA2B,cAAc;AAE9C;AA8GO,SAAS,cACd,QACA,WAAW,IACgC;AAC3C,QAAM,SAAoD,CAAC;AAE3D,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,MAAM,GAAG;AACjD,UAAM,UAAU,WAAW,GAAG,QAAQ,IAAI,GAAG,KAAK;AAElD,QAAI,kBAAkB,KAAK,GAAG;AAC5B,aAAO,KAAK,EAAE,KAAK,SAAS,OAAO,MAAM,CAAC;AAAA,IAC5C,WAAW,mBAAmB,KAAK,GAAG;AACpC,aAAO,KAAK,GAAG,cAAc,MAAM,QAAQ,OAAO,CAAC;AAAA,IACrD,WAAW,OAAO,UAAU,YAAY,UAAU,MAAM;AACtD,aAAO,KAAK,GAAG,cAAc,OAAuB,OAAO,CAAC;AAAA,IAC9D;AAAA,EACF;AAEA,SAAO;AACT;;;AC1NO,SAAS,oBAAoB,KAAqB;AACvD,SAAO,IACJ,MAAM,GAAG,EACT;AAAA,IAAI,CAAC,SAAS,UACb,UAAU,IAAI,UAAU,QAAQ,OAAO,CAAC,EAAE,YAAY,IAAI,QAAQ,MAAM,CAAC;AAAA,EAC3E,EACC,KAAK,EAAE;AACZ;","names":[]}

package/dist/global.js

@@ -1,15 +1,15 @@
 import {
   fieldChanged
 } from "./chunk-3QKQCJSP.js";
-import {
-  ObjectValidationError
-} from "./chunk-3BY5RBF2.js";
 import {
   wrapError,
   wrapErrorAsync,
   wrapErrorUnless,
   wrapErrorUnlessAsync
 } from "./chunk-ZG26OQFN.js";
+import {
+  ObjectValidationError
+} from "./chunk-3BY5RBF2.js";
 import {
   CodedError,
   ErrorCodes