@cosmneo/onion-lasagna 0.2.0 → 0.3.0

package/dist/chunk-H5TNDC5U.js

@@ -0,0 +1,138 @@
+import {
+  AccessDeniedError,
+  ConflictError,
+  DomainError,
+  ForbiddenError,
+  InfraError,
+  NotFoundError,
+  UnprocessableError
+} from "./chunk-2BVCU32G.js";
+import {
+  ControllerError,
+  InvalidRequestError,
+  UnauthorizedError,
+  UseCaseError
+} from "./chunk-T7S574XQ.js";
+import {
+  ObjectValidationError
+} from "./chunk-3BY5RBF2.js";
+import {
+  CodedError
+} from "./chunk-A4JUAZK4.js";
+
+// src/presentation/http/shared/error-mapping.ts
+var MASKED_ERROR_BODY = {
+  message: "An unexpected error occurred",
+  errorCode: "INTERNAL_ERROR"
+};
+var INTERNAL_ERROR_TYPES = [
+  "DomainError",
+  "InfraError",
+  "ControllerError",
+  "NetworkError",
+  "PersistenceError",
+  "ExternalServiceError",
+  "InvariantViolationError"
+];
+function isErrorType(error, typeName) {
+  if (!error || typeof error !== "object") return false;
+  const constructor = Object.prototype.hasOwnProperty.call(error, "constructor") ? error.constructor : Object.getPrototypeOf(error)?.constructor;
+  if (!constructor) return false;
+  const name = constructor.name;
+  return name === typeName || name === `_${typeName}`;
+}
+function hasValidationErrors(error) {
+  if (!error || typeof error !== "object") return false;
+  return "validationErrors" in error && Array.isArray(error.validationErrors);
+}
+function buildValidationErrorBody(message, code, validationErrors) {
+  return {
+    message,
+    errorCode: code,
+    errorItems: validationErrors.map((e) => ({
+      item: e.field,
+      message: e.message
+    }))
+  };
+}
+function buildSimpleErrorBody(message, code) {
+  return {
+    message,
+    errorCode: code
+  };
+}
+function getHttpStatusCode(error) {
+  if (error instanceof ObjectValidationError) return 400;
+  if (error instanceof InvalidRequestError) return 400;
+  if (error instanceof UnauthorizedError) return 401;
+  if (error instanceof ForbiddenError) return 403;
+  if (error instanceof AccessDeniedError) return 403;
+  if (error instanceof NotFoundError) return 404;
+  if (error instanceof ConflictError) return 409;
+  if (error instanceof UnprocessableError) return 422;
+  if (error instanceof UseCaseError) return 400;
+  if (isErrorType(error, "ObjectValidationError")) return 400;
+  if (isErrorType(error, "InvalidRequestError")) return 400;
+  if (isErrorType(error, "UnauthorizedError")) return 401;
+  if (isErrorType(error, "ForbiddenError")) return 403;
+  if (isErrorType(error, "AccessDeniedError")) return 403;
+  if (isErrorType(error, "NotFoundError")) return 404;
+  if (isErrorType(error, "ConflictError")) return 409;
+  if (isErrorType(error, "UnprocessableError")) return 422;
+  if (isErrorType(error, "UseCaseError")) return 400;
+  return 500;
+}
+function shouldMaskError(error) {
+  if (error instanceof DomainError || error instanceof InfraError || error instanceof ControllerError) {
+    return true;
+  }
+  for (const errorType of INTERNAL_ERROR_TYPES) {
+    if (isErrorType(error, errorType)) {
+      return true;
+    }
+  }
+  return false;
+}
+function createErrorResponseBody(error) {
+  if (shouldMaskError(error)) {
+    return MASKED_ERROR_BODY;
+  }
+  if (error instanceof ObjectValidationError) {
+    return buildValidationErrorBody(error.message, error.code, error.validationErrors);
+  }
+  if (error instanceof InvalidRequestError) {
+    return buildValidationErrorBody(error.message, error.code, error.validationErrors);
+  }
+  if (isErrorType(error, "ObjectValidationError") && hasValidationErrors(error)) {
+    return buildValidationErrorBody(error.message, error.code, error.validationErrors);
+  }
+  if (isErrorType(error, "InvalidRequestError") && hasValidationErrors(error)) {
+    return buildValidationErrorBody(error.message, error.code, error.validationErrors);
+  }
+  if (error instanceof CodedError) {
+    return buildSimpleErrorBody(error.message, error.code);
+  }
+  if (isErrorType(error, "CodedError")) {
+    return buildSimpleErrorBody(error.message, error.code);
+  }
+  if (error && typeof error === "object" && "message" in error && "code" in error && typeof error.message === "string" && typeof error.code === "string") {
+    return buildSimpleErrorBody(error.message, error.code);
+  }
+  return MASKED_ERROR_BODY;
+}
+function mapErrorToHttpResponse(error) {
+  return {
+    status: getHttpStatusCode(error),
+    body: createErrorResponseBody(error)
+  };
+}
+
+export {
+  isErrorType,
+  hasValidationErrors,
+  getHttpStatusCode,
+  shouldMaskError,
+  createErrorResponseBody,
+  mapErrorToHttpResponse
+};
+//# sourceMappingURL=chunk-H5TNDC5U.js.map

package/dist/chunk-H5TNDC5U.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/presentation/http/shared/error-mapping.ts"],"sourcesContent":["/**\n * @fileoverview Centralized error mapping for HTTP frameworks.\n *\n * Provides a single source of truth for mapping onion-lasagna errors\n * to HTTP status codes and response bodies.\n *\n * @module http/shared/error-mapping\n */\n\nimport { CodedError } from '../../../global/exceptions/coded-error.error';\nimport { ObjectValidationError } from '../../../global/exceptions/object-validation.error';\nimport { DomainError } from '../../../domain/exceptions/domain.error';\nimport { UseCaseError } from '../../../app/exceptions/use-case.error';\nimport { NotFoundError } from '../../../app/exceptions/not-found.error';\nimport { ConflictError } from '../../../app/exceptions/conflict.error';\nimport { UnprocessableError } from '../../../app/exceptions/unprocessable.error';\nimport { ForbiddenError } from '../../../app/exceptions/forbidden.error';\nimport { UnauthorizedError } from '../../../app/exceptions/unauthorized.error';\nimport { InfraError } from '../../../infra/exceptions/infra.error';\nimport { ControllerError } from '../../exceptions/controller.error';\nimport { AccessDeniedError } from '../../exceptions/access-denied.error';\nimport { InvalidRequestError } from '../../exceptions/invalid-request.error';\nimport type { ErrorResponseBody, MappedErrorResponse } from './types';\n\n// ============================================================================\n// Constants and Interfaces\n// ============================================================================\n\n/**\n * Default masked error response for internal errors.\n */\nconst MASKED_ERROR_BODY: ErrorResponseBody = {\n  message: 'An unexpected error occurred',\n  errorCode: 'INTERNAL_ERROR',\n};\n\n/**\n * Known internal error type names that should be masked.\n */\nconst INTERNAL_ERROR_TYPES = [\n  'DomainError',\n  'InfraError',\n  'ControllerError',\n  'NetworkError',\n  'PersistenceError',\n  'ExternalServiceError',\n  'InvariantViolationError',\n];\n\n/**\n * Validation error item structure.\n */\ninterface ValidationErrorInput {\n  field: string;\n  message: string;\n}\n\n/**\n * Validation error structure for string-based checking.\n */\ninterface ValidationErrorItem {\n  field: string;\n  message: string;\n}\n\n/**\n * Interface for errors with validation items.\n */\ninterface ErrorWithValidation {\n  message: string;\n  code: string;\n  validationErrors: ValidationErrorItem[];\n}\n\n/**\n * Interface for coded errors.\n */\ninterface CodedErrorLike {\n  message: string;\n  code: string;\n}\n\n// ============================================================================\n// String-based type checking helpers (for bundled code compatibility)\n// ============================================================================\n\n/**\n * Checks if error matches a specific error type by checking its constructor name.\n * This approach avoids issues with multiple class instances in bundled code.\n * Handles both original names and tsup's mangled names (prefixed with _).\n *\n * @param error - The error to check\n * @param typeName - The error type name to match\n * @returns True if error matches the type name\n */\nexport function isErrorType(error: unknown, typeName: string): error is CodedErrorLike {\n  if (!error || typeof error !== 'object') return false;\n  // Guard against objects without constructor (e.g., Object.create(null))\n  const constructor = Object.prototype.hasOwnProperty.call(error, 'constructor')\n    ? (error as { constructor?: { name?: string } }).constructor\n    : Object.getPrototypeOf(error)?.constructor;\n  if (!constructor) return false;\n  const name = constructor.name;\n  // Check both the original name and the mangled name (tsup prefixes with _)\n  return name === typeName || name === `_${typeName}`;\n}\n\n/**\n * Checks if error has validation errors array.\n *\n * @param error - The error to check\n * @returns True if error has validationErrors property\n */\nexport function hasValidationErrors(error: unknown): error is ErrorWithValidation {\n  if (!error || typeof error !== 'object') return false;\n  return (\n    'validationErrors' in error && Array.isArray((error as ErrorWithValidation).validationErrors)\n  );\n}\n\n// ============================================================================\n// Response body builders\n// ============================================================================\n\n/**\n * Builds a validation error response body from error details.\n *\n * @param message - The error message\n * @param code - The error code\n * @param validationErrors - Array of field validation errors\n * @returns Error response body with errorItems\n */\nfunction buildValidationErrorBody(\n  message: string,\n  code: string,\n  validationErrors: readonly ValidationErrorInput[],\n): ErrorResponseBody {\n  return {\n    message,\n    errorCode: code,\n    errorItems: validationErrors.map((e) => ({\n      item: e.field,\n      message: e.message,\n    })),\n  };\n}\n\n/**\n * Builds a simple error response body from error details.\n *\n * @param message - The error message\n * @param code - The error code\n * @returns Error response body\n */\nfunction buildSimpleErrorBody(message: string, code: string): ErrorResponseBody {\n  return {\n    message,\n    errorCode: code,\n  };\n}\n\n// ============================================================================\n// Primary error mapping functions (with bundled code fallback)\n// ============================================================================\n\n/**\n * Maps an error to the appropriate HTTP status code.\n * Uses instanceof first, then falls back to name-based checking for bundled code.\n *\n * @param error - The error to map\n * @returns HTTP status code\n */\nexport function getHttpStatusCode(error: unknown): number {\n  // Try instanceof first (faster)\n  if (error instanceof ObjectValidationError) return 400;\n  if (error instanceof InvalidRequestError) return 400;\n  if (error instanceof UnauthorizedError) return 401;\n  if (error instanceof ForbiddenError) return 403;\n  if (error instanceof AccessDeniedError) return 403;\n  if (error instanceof NotFoundError) return 404;\n  if (error instanceof ConflictError) return 409;\n  if (error instanceof UnprocessableError) return 422;\n  if (error instanceof UseCaseError) return 400;\n\n  // Fall back to name-based checking for bundled code (e.g., _NotFoundError)\n  if (isErrorType(error, 'ObjectValidationError')) return 400;\n  if (isErrorType(error, 'InvalidRequestError')) return 400;\n  if (isErrorType(error, 'UnauthorizedError')) return 401;\n  if (isErrorType(error, 'ForbiddenError')) return 403;\n  if (isErrorType(error, 'AccessDeniedError')) return 403;\n  if (isErrorType(error, 'NotFoundError')) return 404;\n  if (isErrorType(error, 'ConflictError')) return 409;\n  if (isErrorType(error, 'UnprocessableError')) return 422;\n  if (isErrorType(error, 'UseCaseError')) return 400;\n\n  return 500;\n}\n\n/**\n * Checks if an error should have its details masked in the response.\n *\n * Security-sensitive errors (domain, infrastructure, controller) are masked\n * to prevent leaking implementation details.\n * Uses instanceof first, then falls back to name-based checking for bundled code.\n *\n * @param error - The error to check\n * @returns True if error details should be hidden\n */\nexport function shouldMaskError(error: unknown): boolean {\n  // Try instanceof first (faster)\n  if (\n    error instanceof DomainError ||\n    error instanceof InfraError ||\n    error instanceof ControllerError\n  ) {\n    return true;\n  }\n\n  // Fall back to name-based checking for bundled code\n  for (const errorType of INTERNAL_ERROR_TYPES) {\n    if (isErrorType(error, errorType)) {\n      return true;\n    }\n  }\n\n  return false;\n}\n\n/**\n * Creates the response body for an error.\n * Uses instanceof first, then falls back to name-based checking for bundled code.\n *\n * @param error - The error to create body for\n * @returns Error response body\n */\nexport function createErrorResponseBody(error: unknown): ErrorResponseBody {\n  // Masked errors - hide internal details\n  if (shouldMaskError(error)) {\n    return MASKED_ERROR_BODY;\n  }\n\n  // Validation errors - include field details (try instanceof first)\n  if (error instanceof ObjectValidationError) {\n    return buildValidationErrorBody(error.message, error.code, error.validationErrors);\n  }\n  if (error instanceof InvalidRequestError) {\n    return buildValidationErrorBody(error.message, error.code, error.validationErrors);\n  }\n\n  // Validation errors - fall back to name-based checking for bundled code\n  if (isErrorType(error, 'ObjectValidationError') && hasValidationErrors(error)) {\n    return buildValidationErrorBody(error.message, error.code, error.validationErrors);\n  }\n  if (isErrorType(error, 'InvalidRequestError') && hasValidationErrors(error)) {\n    return buildValidationErrorBody(error.message, error.code, error.validationErrors);\n  }\n\n  // Other coded errors - expose message and code (try instanceof first)\n  if (error instanceof CodedError) {\n    return buildSimpleErrorBody(error.message, error.code);\n  }\n\n  // Other coded errors - fall back to name-based checking\n  if (isErrorType(error, 'CodedError')) {\n    return buildSimpleErrorBody(error.message, error.code);\n  }\n\n  // Check for any error with message and code properties\n  if (\n    error &&\n    typeof error === 'object' &&\n    'message' in error &&\n    'code' in error &&\n    typeof (error as CodedErrorLike).message === 'string' &&\n    typeof (error as CodedErrorLike).code === 'string'\n  ) {\n    return buildSimpleErrorBody((error as CodedErrorLike).message, (error as CodedErrorLike).code);\n  }\n\n  // Unknown errors - mask\n  return MASKED_ERROR_BODY;\n}\n\n/**\n * Maps an error to a complete HTTP response structure.\n *\n * Mapping strategy (checked in order):\n * 1. `ObjectValidationError` / `InvalidRequestError` → 400 Bad Request (with field errors)\n * 2. `UseCaseError` → 400 Bad Request\n * 3. `UnauthorizedError` → 401 Unauthorized\n * 4. `ForbiddenError` / `AccessDeniedError` → 403 Forbidden\n * 5. `NotFoundError` → 404 Not Found\n * 6. `ConflictError` → 409 Conflict\n * 7. `UnprocessableError` → 422 Unprocessable Entity\n * 8. `DomainError` / `InfraError` / `ControllerError` → 500 Internal Server Error (masked)\n * 9. Unknown → 500 Internal Server Error (masked)\n *\n * @param error - The error to map\n * @returns Mapped error response with status and body\n */\nexport function mapErrorToHttpResponse(error: unknown): MappedErrorResponse {\n  return {\n    status: getHttpStatusCode(error),\n    body: createErrorResponseBody(error),\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-KJ4JGZOE.js

@@ -0,0 +1,96 @@
+import {
+  collectEventHandlers,
+  generateHandlerId,
+  isEventRouterDefinition
+} from "./chunk-CBTICRSM.js";
+
+// src/presentation/events/asyncapi/generate.ts
+function generateAsyncAPI(router, config) {
+  const routerConfig = isEventRouterDefinition(router) ? router.handlers : router;
+  const handlers = collectEventHandlers(routerConfig);
+  const channels = {};
+  const operations = {};
+  const allTags = /* @__PURE__ */ new Set();
+  for (const { key, handler } of handlers) {
+    const handlerId = generateHandlerId(key);
+    const channelId = handler.eventType;
+    const message = buildMessage(handler.eventType, handler.payload, handler.docs);
+    if (!channels[channelId]) {
+      channels[channelId] = {
+        address: handler.eventType,
+        messages: {}
+      };
+    }
+    const channelMessages = { ...channels[channelId].messages ?? {} };
+    channelMessages[handlerId] = message;
+    channels[channelId] = { ...channels[channelId], messages: channelMessages };
+    const operation = {
+      action: "receive",
+      channel: { $ref: `#/channels/${channelId}` },
+      messages: [{ $ref: `#/channels/${channelId}/messages/${handlerId}` }]
+    };
+    if (handler.docs.summary) {
+      operation.summary = handler.docs.summary;
+    }
+    if (handler.docs.description) {
+      operation.description = handler.docs.description;
+    }
+    if (handler.docs.deprecated) {
+      operation.deprecated = true;
+    }
+    if (handler.docs.tags && handler.docs.tags.length > 0) {
+      operation.tags = handler.docs.tags.map((t) => ({
+        name: t
+      }));
+      for (const tag of handler.docs.tags) {
+        allTags.add(tag);
+      }
+    }
+    operations[handlerId] = operation;
+  }
+  const tags = config.tags ? [...config.tags] : [];
+  for (const tagName of allTags) {
+    if (!tags.some((t) => t.name === tagName)) {
+      tags.push({ name: tagName });
+    }
+  }
+  const info = tags.length > 0 ? { ...config.info, tags } : config.info;
+  const spec = {
+    asyncapi: config.asyncapi ?? "3.0.0",
+    info,
+    defaultContentType: config.defaultContentType ?? "application/json",
+    channels,
+    operations
+  };
+  if (config.servers && Object.keys(config.servers).length > 0) {
+    spec.servers = config.servers;
+  }
+  if (config.externalDocs) {
+    spec.externalDocs = config.externalDocs;
+  }
+  return spec;
+}
+function buildMessage(eventType, payload, docs) {
+  const message = {
+    name: eventType
+  };
+  if (docs.summary) {
+    message.summary = docs.summary;
+  }
+  if (docs.description) {
+    message.description = docs.description;
+  }
+  if (docs.deprecated) {
+    message.deprecated = true;
+  }
+  if (payload) {
+    const schema = payload.toJsonSchema();
+    message.payload = schema;
+  }
+  return message;
+}
+
+export {
+  generateAsyncAPI
+};
+//# sourceMappingURL=chunk-KJ4JGZOE.js.map

package/dist/chunk-KJ4JGZOE.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/presentation/events/asyncapi/generate.ts"],"sourcesContent":["/**\n * @fileoverview AsyncAPI specification generation from event router definitions.\n *\n * The `generateAsyncAPI` function creates a complete AsyncAPI 3.0 specification\n * from an event router definition. All handler payload schemas are converted to\n * JSON Schema and included in the specification.\n *\n * @module events/asyncapi/generate\n */\n\nimport type { SchemaAdapter } from '../../http/schema/types';\nimport type { EventRouterConfig, EventRouterDefinition } from '../handler/types';\nimport { isEventRouterDefinition, collectEventHandlers } from '../handler/types';\nimport { generateHandlerId } from '../handler/utils';\nimport type {\n  AsyncAPIConfig,\n  AsyncAPISpec,\n  AsyncAPIChannel,\n  AsyncAPIOperation,\n  AsyncAPIMessage,\n  AsyncAPITag,\n} from './types';\n\n/**\n * Generates an AsyncAPI 3.0 specification from an event router definition.\n *\n * This function walks the event router structure, extracts JSON schemas from\n * all handler payload definitions, and builds a complete AsyncAPI 3.0 specification.\n *\n * @param router - Event router definition or raw config\n * @param config - AsyncAPI configuration (info, servers, tags, etc.)\n * @returns Complete AsyncAPI specification\n *\n * @example\n * ```typescript\n * import { generateAsyncAPI } from '@cosmneo/onion-lasagna/events/asyncapi';\n * import { notificationEventRouter } from './events/router';\n *\n * const spec = generateAsyncAPI(notificationEventRouter, {\n *   info: {\n *     title: 'My Event API',\n *     version: '1.0.0',\n *     description: 'Domain events for the application',\n *   },\n * });\n *\n * app.get('/asyncapi.json', (c) => c.json(spec));\n * ```\n */\nexport function generateAsyncAPI<T extends EventRouterConfig>(\n  router: T | EventRouterDefinition<T>,\n  config: AsyncAPIConfig,\n): AsyncAPISpec {\n  const routerConfig = isEventRouterDefinition(router) ? router.handlers : router;\n  const handlers = collectEventHandlers(routerConfig);\n\n  const channels: Record<string, AsyncAPIChannel> = {};\n  const operations: Record<string, AsyncAPIOperation> = {};\n  const allTags = new Set<string>();\n\n  for (const { key, handler } of handlers) {\n    const handlerId = generateHandlerId(key);\n    const channelId = handler.eventType;\n\n    // Build message\n    const message = buildMessage(handler.eventType, handler.payload, handler.docs);\n\n    // Build channel (group by eventType — multiple handlers may share a channel)\n    if (!channels[channelId]) {\n      channels[channelId] = {\n        address: handler.eventType,\n        messages: {},\n      };\n    }\n    const channelMessages = { ...(channels[channelId]!.messages ?? {}) };\n    channelMessages[handlerId] = message;\n    channels[channelId] = { ...channels[channelId]!, messages: channelMessages };\n\n    // Build operation (one per handler)\n    const operation: AsyncAPIOperation = {\n      action: 'receive',\n      channel: { $ref: `#/channels/${channelId}` },\n      messages: [{ $ref: `#/channels/${channelId}/messages/${handlerId}` }],\n    };\n\n    if (handler.docs.summary) {\n      (operation as { summary: string }).summary = handler.docs.summary;\n    }\n    if (handler.docs.description) {\n      (operation as { description: string }).description = handler.docs.description;\n    }\n    if (handler.docs.deprecated) {\n      (operation as { deprecated: boolean }).deprecated = true;\n    }\n    if (handler.docs.tags && handler.docs.tags.length > 0) {\n      (operation as { tags: readonly AsyncAPITag[] }).tags = handler.docs.tags.map((t) => ({\n        name: t,\n      }));\n      for (const tag of handler.docs.tags) {\n        allTags.add(tag);\n      }\n    }\n\n    operations[handlerId] = operation;\n  }\n\n  // Merge custom tags with collected tags (AsyncAPI 3.0: tags live inside info)\n  const tags: AsyncAPITag[] = 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\n  const info = tags.length > 0 ? { ...config.info, tags } : config.info;\n\n  // Build the specification\n  const spec: AsyncAPISpec = {\n    asyncapi: config.asyncapi ?? '3.0.0',\n    info,\n    defaultContentType: config.defaultContentType ?? 'application/json',\n    channels,\n    operations,\n  };\n\n  if (config.servers && Object.keys(config.servers).length > 0) {\n    (spec as { servers: typeof config.servers }).servers = config.servers;\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 * Builds an AsyncAPI message from a handler definition.\n */\nfunction buildMessage(\n  eventType: string,\n  payload: unknown,\n  docs: {\n    readonly summary?: string;\n    readonly description?: string;\n    readonly tags?: readonly string[];\n    readonly deprecated?: boolean;\n  },\n): AsyncAPIMessage {\n  const message: AsyncAPIMessage = {\n    name: eventType,\n  };\n\n  if (docs.summary) {\n    (message as { summary: string }).summary = docs.summary;\n  }\n  if (docs.description) {\n    (message as { description: string }).description = docs.description;\n  }\n  if (docs.deprecated) {\n    (message as { deprecated: boolean }).deprecated = true;\n  }\n\n  if (payload) {\n    const schema = (payload as SchemaAdapter).toJsonSchema();\n    (message as { payload: typeof schema }).payload = schema;\n  }\n\n  return message;\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-MF2JDREK.js

@@ -0,0 +1,168 @@
+import {
+  isRouteDefinition,
+  isRouterDefinition
+} from "./chunk-XP6PLTV2.js";
+import {
+  isSchemaAdapter
+} from "./chunk-42JMR62O.js";
+
+// src/presentation/http/route/define-route.ts
+function extractSchema(field) {
+  if (field == null) return void 0;
+  if (isSchemaAdapter(field)) return field;
+  return field.schema;
+}
+function extractMeta(field) {
+  if (field == null || isSchemaAdapter(field)) return void 0;
+  const config = field;
+  if (config.description == null && config.contentType == null && config.required == null) {
+    return void 0;
+  }
+  return {
+    description: config.description,
+    contentType: config.contentType,
+    required: config.required
+  };
+}
+function normalizeResponses(responses) {
+  const result = {};
+  for (const [key, value] of Object.entries(responses)) {
+    result[String(key)] = value;
+  }
+  return result;
+}
+function defineRoute(input) {
+  const req = input.request;
+  const bodyMeta = extractMeta(req?.body);
+  const queryMeta = extractMeta(req?.query);
+  const paramsMeta = extractMeta(req?.params);
+  const headersMeta = extractMeta(req?.headers);
+  const contextMeta = extractMeta(req?.context);
+  const _meta = {
+    ...bodyMeta ? { body: bodyMeta } : {},
+    ...queryMeta ? { query: { description: queryMeta.description } } : {},
+    ...paramsMeta ? { params: { description: paramsMeta.description } } : {},
+    ...headersMeta ? { headers: { description: headersMeta.description } } : {},
+    ...contextMeta ? { context: { description: contextMeta.description } } : {}
+  };
+  const definition = {
+    method: input.method,
+    path: input.path,
+    request: {
+      body: extractSchema(req?.body) ?? void 0,
+      query: extractSchema(req?.query) ?? void 0,
+      params: extractSchema(req?.params) ?? void 0,
+      headers: extractSchema(req?.headers) ?? void 0,
+      context: extractSchema(req?.context) ?? void 0
+    },
+    responses: input.responses ? normalizeResponses(input.responses) : void 0,
+    docs: {
+      summary: input.docs?.summary,
+      description: input.docs?.description,
+      tags: input.docs?.tags,
+      operationId: input.docs?.operationId,
+      deprecated: input.docs?.deprecated ?? false,
+      security: input.docs?.security,
+      externalDocs: input.docs?.externalDocs
+    },
+    _meta,
+    _types: void 0
+  };
+  return Object.freeze(definition);
+}
+
+// src/presentation/http/route/define-router.ts
+function defineRouter(routes, options) {
+  const defaults = options?.defaults;
+  const processedRoutes = defaults?.context || defaults?.tags ? applyRouterDefaults(routes, defaults) : routes;
+  const definition = {
+    routes: processedRoutes,
+    basePath: options?.basePath,
+    defaults,
+    _isRouter: true
+  };
+  return deepFreeze(definition);
+}
+function applyRouterDefaults(routes, defaults) {
+  const result = {};
+  for (const [key, value] of Object.entries(routes)) {
+    if (isRouteDefinition(value)) {
+      result[key] = applyDefaultsToRoute(value, defaults);
+    } else if (isRouterDefinition(value)) {
+      result[key] = {
+        ...value,
+        routes: applyRouterDefaults(value.routes, defaults)
+      };
+    } else if (typeof value === "object" && value !== null) {
+      result[key] = applyRouterDefaults(value, defaults);
+    }
+  }
+  return result;
+}
+function applyDefaultsToRoute(route, defaults) {
+  const needsContext = defaults.context && !route.request.context;
+  const needsTags = defaults.tags && defaults.tags.length > 0;
+  if (!needsContext && !needsTags) return route;
+  return Object.freeze({
+    ...route,
+    request: {
+      ...route.request,
+      context: route.request.context ?? defaults.context ?? void 0
+    },
+    docs: {
+      ...route.docs,
+      tags: mergeTags(defaults.tags, route.docs.tags)
+    }
+  });
+}
+function mergeTags(routerTags, routeTags) {
+  if (!routerTags || routerTags.length === 0) return routeTags;
+  if (!routeTags || routeTags.length === 0) return routerTags;
+  const merged = [...routerTags];
+  for (const tag of routeTags) {
+    if (!merged.includes(tag)) {
+      merged.push(tag);
+    }
+  }
+  return merged;
+}
+function deepFreeze(obj) {
+  const propNames = Object.getOwnPropertyNames(obj);
+  for (const name of propNames) {
+    const value = obj[name];
+    if (value && typeof value === "object" && !Object.isFrozen(value)) {
+      deepFreeze(value);
+    }
+  }
+  return Object.freeze(obj);
+}
+function extractRoutes(input) {
+  return isRouterDefinition(input) ? input.routes : input;
+}
+function isSubRouter(value) {
+  return typeof value === "object" && value !== null && !isRouteDefinition(value) && !isRouterDefinition(value);
+}
+function deepMergeConfigs(a, b) {
+  const result = { ...a };
+  for (const key of Object.keys(b)) {
+    const aVal = result[key];
+    const bVal = b[key];
+    if (isSubRouter(aVal) && isSubRouter(bVal)) {
+      result[key] = deepMergeConfigs(aVal, bVal);
+    } else {
+      result[key] = bVal;
+    }
+  }
+  return result;
+}
+function mergeRouters(...routers) {
+  const merged = routers.map(extractRoutes).reduce(deepMergeConfigs);
+  return defineRouter(merged);
+}
+
+export {
+  defineRoute,
+  defineRouter,
+  mergeRouters
+};
+//# sourceMappingURL=chunk-MF2JDREK.js.map

package/dist/chunk-MF2JDREK.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/presentation/http/route/define-route.ts","../src/presentation/http/route/define-router.ts"],"sourcesContent":["/**\n * @fileoverview Factory function for creating route definitions (v2).\n *\n * The `defineRoute` function is the main entry point for defining routes.\n * Request schemas are grouped under a `request` field, while responses\n * are defined via the `responses` field with per-status-code config.\n *\n * Each schema field accepts either a bare `SchemaAdapter` or an object with\n * metadata: `{ schema, description?, contentType?, required? }`.\n *\n * The success response type is inferred from the first 2xx status with a schema.\n *\n * @module unified/route/define-route\n */\n\nimport type { SchemaAdapter, InferOutput } from '../schema/types';\nimport { isSchemaAdapter } from '../schema/types';\nimport type {\n  HttpMethod,\n  RouteDefinition,\n  PathParams,\n  SchemaFieldInput,\n  RouteFieldMeta,\n  ResponseFieldConfig,\n  ResponsesDefinition,\n  ExtractSuccessSchema,\n} from './types';\n\n// ============================================================================\n// Input Types\n// ============================================================================\n\n/**\n * Complete input for defineRoute.\n *\n * @example GET with query and response\n * ```typescript\n * defineRoute({\n *   method: 'GET',\n *   path: '/api/users',\n *   request: {\n *     query: zodSchema(z.object({ page: z.coerce.number().default(1) })),\n *   },\n *   responses: {\n *     200: { schema: zodSchema(userListSchema) },\n *   },\n *   docs: { summary: 'List users', tags: ['Users'] },\n * })\n * ```\n *\n * @example POST with body and multiple statuses\n * ```typescript\n * defineRoute({\n *   method: 'POST',\n *   path: '/api/users',\n *   request: {\n *     body: zodSchema(createUserSchema),\n *   },\n *   responses: {\n *     201: { schema: zodSchema(userSchema), description: 'Created' },\n *     400: { description: 'Validation error' },\n *     409: { description: 'Email already in use' },\n *   },\n * })\n * ```\n *\n * @example DELETE with 204\n * ```typescript\n * defineRoute({\n *   method: 'DELETE',\n *   path: '/api/users/:userId',\n *   responses: {\n *     204: { description: 'User deleted' },\n *     404: { description: 'User not found' },\n *   },\n * })\n * ```\n */\ninterface DefineRouteInput<\n  TMethod extends HttpMethod,\n  TPath extends string,\n  TBody extends SchemaAdapter | undefined = undefined,\n  TQuery extends SchemaAdapter | undefined = undefined,\n  TParams extends SchemaAdapter | undefined = undefined,\n  THeaders extends SchemaAdapter | undefined = undefined,\n  TContext extends SchemaAdapter | undefined = undefined,\n  TResponses extends ResponsesDefinition | undefined = undefined,\n> {\n  /** HTTP method for this route. */\n  readonly method: TMethod;\n\n  /** URL path pattern with optional parameters (`:param` or `{param}`). */\n  readonly path: TPath;\n\n  /** Request schemas (body, query, params, headers, context). */\n  readonly request?: {\n    /** Request body schema (or `{ schema, description?, contentType?, required? }`). */\n    readonly body?: TBody extends SchemaAdapter ? SchemaFieldInput<TBody> : TBody;\n\n    /** Query parameters schema (or `{ schema, description? }`). */\n    readonly query?: TQuery extends SchemaAdapter ? SchemaFieldInput<TQuery> : TQuery;\n\n    /** Path parameters schema (or `{ schema, description? }`). If omitted, inferred from path template. */\n    readonly params?: TParams extends SchemaAdapter ? SchemaFieldInput<TParams> : TParams;\n\n    /** Headers schema (or `{ schema, description? }`). */\n    readonly headers?: THeaders extends SchemaAdapter ? SchemaFieldInput<THeaders> : THeaders;\n\n    /** Context schema (or `{ schema, description? }`). */\n    readonly context?: TContext extends SchemaAdapter ? SchemaFieldInput<TContext> : TContext;\n  };\n\n  /**\n   * Per-status response definitions.\n   *\n   * Each key is an HTTP status code. Each value can have:\n   * - `schema` — response body schema (drives type inference for 2xx)\n   * - `description` — OpenAPI response description\n   * - `contentType` — response content type (default: `application/json`)\n   */\n  readonly responses?: TResponses;\n\n  /** OpenAPI documentation. */\n  readonly docs?: {\n    readonly summary?: string;\n    readonly description?: string;\n    readonly tags?: readonly string[];\n    readonly operationId?: string;\n    readonly deprecated?: boolean;\n    readonly security?: readonly Record<string, readonly string[]>[];\n    readonly externalDocs?: {\n      readonly url: string;\n      readonly description?: string;\n    };\n  };\n}\n\n// ============================================================================\n// Helpers\n// ============================================================================\n\n/**\n * Extracts the SchemaAdapter from a field that may be bare or wrapped in config.\n */\nfunction extractSchema<T extends SchemaAdapter>(\n  field: SchemaFieldInput<T> | undefined,\n): T | undefined {\n  if (field == null) return undefined;\n  if (isSchemaAdapter(field)) return field as T;\n  return (field as { schema: T }).schema;\n}\n\n/**\n * Extracts metadata from a field config, if it was passed as an object.\n */\nfunction extractMeta(\n  field: SchemaFieldInput | undefined,\n): { description?: string; contentType?: string; required?: boolean } | undefined {\n  if (field == null || isSchemaAdapter(field)) return undefined;\n  const config = field as { description?: string; contentType?: string; required?: boolean };\n  if (config.description == null && config.contentType == null && config.required == null) {\n    return undefined;\n  }\n  return {\n    description: config.description,\n    contentType: config.contentType,\n    required: config.required,\n  };\n}\n\n/**\n * Normalizes responses record keys to strings.\n */\nfunction normalizeResponses(\n  responses: Record<string | number, ResponseFieldConfig>,\n): Record<string, ResponseFieldConfig> {\n  const result: Record<string, ResponseFieldConfig> = {};\n  for (const [key, value] of Object.entries(responses)) {\n    result[String(key)] = value;\n  }\n  return result;\n}\n\n// ============================================================================\n// Return type helpers\n// ============================================================================\n\ntype ResolveBody<T> = T extends SchemaAdapter ? InferOutput<T> : undefined;\ntype ResolveQuery<T> = T extends SchemaAdapter ? InferOutput<T> : undefined;\ntype ResolveParams<T, TPath extends string> = T extends SchemaAdapter\n  ? InferOutput<T>\n  : PathParams<TPath>;\ntype ResolveHeaders<T> = T extends SchemaAdapter ? InferOutput<T> : undefined;\ntype ResolveContext<T> = T extends SchemaAdapter ? InferOutput<T> : undefined;\n\ntype ResolveResponse<T> = T extends ResponsesDefinition\n  ? ExtractSuccessSchema<T> extends SchemaAdapter\n    ? InferOutput<ExtractSuccessSchema<T>>\n    : undefined\n  : undefined;\n\n// ============================================================================\n// Factory Function\n// ============================================================================\n\n/**\n * Creates a route definition from the provided configuration.\n *\n * This is the main entry point for defining routes. The resulting definition\n * can be used for type-safe client generation, server-side route registration,\n * and OpenAPI specification generation.\n *\n * @param input - Route configuration with request schemas and responses\n * @returns A frozen RouteDefinition object with full type information\n */\nexport function defineRoute<\n  TMethod extends HttpMethod,\n  TPath extends string,\n  TBody extends SchemaAdapter | undefined = undefined,\n  TQuery extends SchemaAdapter | undefined = undefined,\n  TParams extends SchemaAdapter | undefined = undefined,\n  THeaders extends SchemaAdapter | undefined = undefined,\n  TContext extends SchemaAdapter | undefined = undefined,\n  TResponses extends ResponsesDefinition | undefined = undefined,\n>(\n  input: DefineRouteInput<TMethod, TPath, TBody, TQuery, TParams, THeaders, TContext, TResponses>,\n): RouteDefinition<\n  TMethod,\n  TPath,\n  ResolveBody<TBody>,\n  ResolveQuery<TQuery>,\n  ResolveParams<TParams, TPath>,\n  ResolveHeaders<THeaders>,\n  ResolveContext<TContext>,\n  ResolveResponse<TResponses>\n> {\n  const req = input.request;\n\n  // Build _meta from any config-wrapped fields\n  const bodyMeta = extractMeta(req?.body as SchemaFieldInput | undefined);\n  const queryMeta = extractMeta(req?.query as SchemaFieldInput | undefined);\n  const paramsMeta = extractMeta(req?.params as SchemaFieldInput | undefined);\n  const headersMeta = extractMeta(req?.headers as SchemaFieldInput | undefined);\n  const contextMeta = extractMeta(req?.context as SchemaFieldInput | undefined);\n\n  const _meta: RouteFieldMeta = {\n    ...(bodyMeta ? { body: bodyMeta } : {}),\n    ...(queryMeta ? { query: { description: queryMeta.description } } : {}),\n    ...(paramsMeta ? { params: { description: paramsMeta.description } } : {}),\n    ...(headersMeta ? { headers: { description: headersMeta.description } } : {}),\n    ...(contextMeta ? { context: { description: contextMeta.description } } : {}),\n  };\n\n  const definition = {\n    method: input.method,\n    path: input.path,\n    request: {\n      body: extractSchema(req?.body as SchemaFieldInput | undefined) ?? undefined,\n      query: extractSchema(req?.query as SchemaFieldInput | undefined) ?? undefined,\n      params: extractSchema(req?.params as SchemaFieldInput | undefined) ?? undefined,\n      headers: extractSchema(req?.headers as SchemaFieldInput | undefined) ?? undefined,\n      context: extractSchema(req?.context as SchemaFieldInput | undefined) ?? undefined,\n    },\n    responses: input.responses ? normalizeResponses(input.responses) : undefined,\n    docs: {\n      summary: input.docs?.summary,\n      description: input.docs?.description,\n      tags: input.docs?.tags,\n      operationId: input.docs?.operationId,\n      deprecated: input.docs?.deprecated ?? false,\n      security: input.docs?.security,\n      externalDocs: input.docs?.externalDocs,\n    },\n    _meta,\n    _types: undefined as unknown,\n  };\n\n  return Object.freeze(definition) as RouteDefinition<\n    TMethod,\n    TPath,\n    ResolveBody<TBody>,\n    ResolveQuery<TQuery>,\n    ResolveParams<TParams, TPath>,\n    ResolveHeaders<THeaders>,\n    ResolveContext<TContext>,\n    ResolveResponse<TResponses>\n  >;\n}\n","/**\n * @fileoverview Factory function for creating router definitions.\n *\n * The `defineRouter` function groups routes into a hierarchical structure\n * with optional router-level defaults for context and tags.\n *\n * @module unified/route/define-router\n */\n\nimport type {\n  RouterConfig,\n  RouterDefaults,\n  RouterDefinition,\n  RouteDefinition,\n  DeepMergeTwo,\n  DeepMergeAll,\n} from './types';\nimport { isRouteDefinition, isRouterDefinition } from './types';\n\n/**\n * Options for router definition.\n */\nexport interface DefineRouterOptions {\n  /**\n   * Base path prefix for all routes in this router.\n   * Will be prepended to all route paths.\n   */\n  readonly basePath?: string;\n\n  /**\n   * Default values applied to all child routes.\n   *\n   * @example\n   * ```typescript\n   * defineRouter({\n   *   list: listUsersRoute,\n   *   get: getUserRoute,\n   * }, {\n   *   defaults: {\n   *     context: zodSchema(executionContextSchema),\n   *     tags: ['Users'],\n   *   },\n   * })\n   * ```\n   */\n  readonly defaults?: RouterDefaults;\n}\n\n/**\n * Creates a router definition from a configuration object.\n *\n * A router is a hierarchical grouping of routes that provides:\n * - Organized API structure with nested namespaces\n * - Typed client method generation\n * - OpenAPI tag grouping\n * - Router-level defaults for context and tags\n *\n * @param routes - Object containing routes and nested routers\n * @param options - Optional router configuration\n * @returns A frozen RouterDefinition object\n *\n * @example Basic router\n * ```typescript\n * const api = defineRouter({\n *   users: {\n *     list: listUsersRoute,\n *     get: getUserRoute,\n *     create: createUserRoute,\n *   },\n * });\n * ```\n *\n * @example With router-level defaults\n * ```typescript\n * const api = defineRouter({\n *   list: listUsersRoute,\n *   get: getUserRoute,\n * }, {\n *   basePath: '/api/v1',\n *   defaults: {\n *     context: zodSchema(executionContextSchema),\n *     tags: ['Users'],\n *   },\n * });\n * // Context is applied to all routes that don't define their own.\n * // Tags are merged with each route's existing tags.\n * ```\n */\nexport function defineRouter<T extends RouterConfig>(\n  routes: T,\n  options?: DefineRouterOptions,\n): RouterDefinition<T> {\n  const defaults = options?.defaults;\n\n  // Apply defaults to routes if context or tags are provided\n  const processedRoutes =\n    defaults?.context || defaults?.tags ? (applyRouterDefaults(routes, defaults) as T) : routes;\n\n  const definition: RouterDefinition<T> = {\n    routes: processedRoutes,\n    basePath: options?.basePath,\n    defaults,\n    _isRouter: true,\n  };\n\n  // Deep freeze the router definition\n  return deepFreeze(definition);\n}\n\n/**\n * Recursively applies router-level defaults to all routes in the tree.\n */\nfunction applyRouterDefaults(routes: RouterConfig, defaults: RouterDefaults): RouterConfig {\n  const result: Record<string, unknown> = {};\n\n  for (const [key, value] of Object.entries(routes)) {\n    if (isRouteDefinition(value)) {\n      result[key] = applyDefaultsToRoute(value, defaults);\n    } else if (isRouterDefinition(value)) {\n      result[key] = {\n        ...value,\n        routes: applyRouterDefaults(value.routes, defaults),\n      };\n    } else if (typeof value === 'object' && value !== null) {\n      result[key] = applyRouterDefaults(value as RouterConfig, defaults);\n    }\n  }\n\n  return result as RouterConfig;\n}\n\n/**\n * Applies router-level defaults to a single route definition.\n */\nfunction applyDefaultsToRoute(route: RouteDefinition, defaults: RouterDefaults): RouteDefinition {\n  const needsContext = defaults.context && !route.request.context;\n  const needsTags = defaults.tags && defaults.tags.length > 0;\n\n  if (!needsContext && !needsTags) return route;\n\n  return Object.freeze({\n    ...route,\n    request: {\n      ...route.request,\n      context: route.request.context ?? defaults.context ?? undefined,\n    },\n    docs: {\n      ...route.docs,\n      tags: mergeTags(defaults.tags, route.docs.tags),\n    },\n  }) as RouteDefinition;\n}\n\n/**\n * Merges router-level tags with route-level tags, avoiding duplicates.\n */\nfunction mergeTags(\n  routerTags?: readonly string[],\n  routeTags?: readonly string[],\n): readonly string[] | undefined {\n  if (!routerTags || routerTags.length === 0) return routeTags;\n  if (!routeTags || routeTags.length === 0) return routerTags;\n\n  // Merge, preserving order: router tags first, then route-specific tags (no duplicates)\n  const merged = [...routerTags];\n  for (const tag of routeTags) {\n    if (!merged.includes(tag)) {\n      merged.push(tag);\n    }\n  }\n  return merged;\n}\n\n/**\n * Deep freezes an object and all its nested objects.\n */\nfunction deepFreeze<T extends object>(obj: T): T {\n  const propNames = Object.getOwnPropertyNames(obj) as (keyof T)[];\n\n  for (const name of propNames) {\n    const value = obj[name];\n    if (value && typeof value === 'object' && !Object.isFrozen(value)) {\n      deepFreeze(value);\n    }\n  }\n\n  return Object.freeze(obj);\n}\n\n// ============================================================================\n// mergeRouters — variadic deep merge\n// ============================================================================\n\ntype RouterInput<T extends RouterConfig> = T | RouterDefinition<T>;\n\n/** Extracts the raw RouterConfig from either a plain config or a RouterDefinition. */\nfunction extractRoutes<T extends RouterConfig>(input: RouterInput<T>): T {\n  return isRouterDefinition(input) ? input.routes : input;\n}\n\n/** Returns true if `value` is a plain sub-router object (not a RouteDefinition, not a RouterDefinition). */\nfunction isSubRouter(value: unknown): value is RouterConfig {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    !isRouteDefinition(value) &&\n    !isRouterDefinition(value)\n  );\n}\n\n/** Recursively deep-merges two router configs. Sub-routers are merged; leaves are overwritten. */\nfunction deepMergeConfigs(a: RouterConfig, b: RouterConfig): RouterConfig {\n  const result: Record<string, unknown> = { ...a };\n\n  for (const key of Object.keys(b)) {\n    const aVal = result[key];\n    const bVal = b[key];\n\n    if (isSubRouter(aVal) && isSubRouter(bVal)) {\n      result[key] = deepMergeConfigs(aVal, bVal);\n    } else {\n      result[key] = bVal;\n    }\n  }\n\n  return result as RouterConfig;\n}\n\n// Overloads for 2–8 routers (clean IDE experience)\nexport function mergeRouters<T1 extends RouterConfig, T2 extends RouterConfig>(\n  r1: RouterInput<T1>,\n  r2: RouterInput<T2>,\n): RouterDefinition<DeepMergeTwo<T1, T2>>;\nexport function mergeRouters<\n  T1 extends RouterConfig,\n  T2 extends RouterConfig,\n  T3 extends RouterConfig,\n>(\n  r1: RouterInput<T1>,\n  r2: RouterInput<T2>,\n  r3: RouterInput<T3>,\n): RouterDefinition<DeepMergeAll<[T1, T2, T3]>>;\nexport function mergeRouters<\n  T1 extends RouterConfig,\n  T2 extends RouterConfig,\n  T3 extends RouterConfig,\n  T4 extends RouterConfig,\n>(\n  r1: RouterInput<T1>,\n  r2: RouterInput<T2>,\n  r3: RouterInput<T3>,\n  r4: RouterInput<T4>,\n): RouterDefinition<DeepMergeAll<[T1, T2, T3, T4]>>;\nexport function mergeRouters<\n  T1 extends RouterConfig,\n  T2 extends RouterConfig,\n  T3 extends RouterConfig,\n  T4 extends RouterConfig,\n  T5 extends RouterConfig,\n>(\n  r1: RouterInput<T1>,\n  r2: RouterInput<T2>,\n  r3: RouterInput<T3>,\n  r4: RouterInput<T4>,\n  r5: RouterInput<T5>,\n): RouterDefinition<DeepMergeAll<[T1, T2, T3, T4, T5]>>;\nexport function mergeRouters<\n  T1 extends RouterConfig,\n  T2 extends RouterConfig,\n  T3 extends RouterConfig,\n  T4 extends RouterConfig,\n  T5 extends RouterConfig,\n  T6 extends RouterConfig,\n>(\n  r1: RouterInput<T1>,\n  r2: RouterInput<T2>,\n  r3: RouterInput<T3>,\n  r4: RouterInput<T4>,\n  r5: RouterInput<T5>,\n  r6: RouterInput<T6>,\n): RouterDefinition<DeepMergeAll<[T1, T2, T3, T4, T5, T6]>>;\nexport function mergeRouters<\n  T1 extends RouterConfig,\n  T2 extends RouterConfig,\n  T3 extends RouterConfig,\n  T4 extends RouterConfig,\n  T5 extends RouterConfig,\n  T6 extends RouterConfig,\n  T7 extends RouterConfig,\n>(\n  r1: RouterInput<T1>,\n  r2: RouterInput<T2>,\n  r3: RouterInput<T3>,\n  r4: RouterInput<T4>,\n  r5: RouterInput<T5>,\n  r6: RouterInput<T6>,\n  r7: RouterInput<T7>,\n): RouterDefinition<DeepMergeAll<[T1, T2, T3, T4, T5, T6, T7]>>;\nexport function mergeRouters<\n  T1 extends RouterConfig,\n  T2 extends RouterConfig,\n  T3 extends RouterConfig,\n  T4 extends RouterConfig,\n  T5 extends RouterConfig,\n  T6 extends RouterConfig,\n  T7 extends RouterConfig,\n  T8 extends RouterConfig,\n>(\n  r1: RouterInput<T1>,\n  r2: RouterInput<T2>,\n  r3: RouterInput<T3>,\n  r4: RouterInput<T4>,\n  r5: RouterInput<T5>,\n  r6: RouterInput<T6>,\n  r7: RouterInput<T7>,\n  r8: RouterInput<T8>,\n): RouterDefinition<DeepMergeAll<[T1, T2, T3, T4, T5, T6, T7, T8]>>;\n\n// Variadic fallback for 9+\nexport function mergeRouters(\n  ...routers: RouterInput<RouterConfig>[]\n): RouterDefinition<RouterConfig>;\n\n// Implementation\nexport function mergeRouters(\n  ...routers: RouterInput<RouterConfig>[]\n): RouterDefinition<RouterConfig> {\n  const merged = routers.map(extractRoutes).reduce(deepMergeConfigs);\n  return defineRouter(merged);\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-RVSBIYY4.js

@@ -0,0 +1 @@
+//# sourceMappingURL=chunk-RVSBIYY4.js.map

package/dist/chunk-RVSBIYY4.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

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