@warlock.js/core 5.30.0 → 5.31.0

package/esm/mail/config.mjs

@@ -54,6 +54,21 @@ function setMailMode(mode) {
 	explicitMode = mode;
 }
 /**
+* The mode set with {@link setMailMode}, or `undefined` when the mode is
+* derived from the environment.
+*/
+function getExplicitMailMode() {
+	return explicitMode;
+}
+/**
+* Forget a mode set with {@link setMailMode}, so the mode is derived from the
+* environment again. Unlike {@link resetMailConfig}, the configured mailers
+* are kept.
+*/
+function resetMailMode() {
+	explicitMode = void 0;
+}
+/**
 * Get the current mail mode
 */
 function getMailMode() {
@@ -149,5 +164,5 @@ function resetMailConfig() {
 }
 
 //#endregion
-export { getDefaultMailConfig, getMailMode, getMailerConfig, isDevelopmentMode, isProductionMode, isTestMode, resetMailConfig, resolveMailConfig, setMailConfigurations, setMailMode };
+export { getDefaultMailConfig, getExplicitMailMode, getMailMode, getMailerConfig, isDevelopmentMode, isProductionMode, isTestMode, resetMailConfig, resetMailMode, resolveMailConfig, setMailConfigurations, setMailMode };
 //# sourceMappingURL=config.mjs.map

package/esm/mail/config.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"config.mjs","names":[],"sources":["../../../../../../../../packages/core/src/mail/config.ts"],"sourcesContent":["import { config } from \"../config\";\nimport { environment } from \"../utils/environment\";\nimport type { MailConfigurations, MailersConfig, MailMode, SMTPConfigurations } from \"./types\";\n\n/**\n * Default mail configurations\n */\nconst defaultConfigurations: Partial<SMTPConfigurations> = {\n  tls: true,\n  driver: \"smtp\",\n};\n\n/**\n * Merge defaults into an SMTP config.\n * `secure` is derived from the port when not set explicitly:\n * 465 uses implicit TLS, every other port (e.g. 587) uses STARTTLS.\n */\nfunction withSmtpDefaults(config: MailConfigurations): SMTPConfigurations {\n  const merged = { ...defaultConfigurations, ...config } as SMTPConfigurations;\n\n  if (merged.secure === undefined) {\n    merged.secure = Number(merged.port) === 465;\n  }\n\n  return merged;\n}\n\n/**\n * Mode set explicitly through `setMailMode`; when undefined the mode is\n * derived from the environment.\n */\nlet explicitMode: MailMode | undefined;\n\n/**\n * Registered mailers configuration\n */\nlet mailersConfig: MailersConfig = {};\n\n/**\n * Set the mail mode\n *\n * @param mode \"production\" | \"development\" | \"test\"\n *\n * - **production**: Actually sends emails via SMTP\n * - **development**: Logs emails to console without sending\n * - **test**: Captures emails to test mailbox for assertions\n *\n * @example\n * ```typescript\n * // In test setup\n * setMailMode(\"test\");\n *\n * // In development\n * setMailMode(\"development\");\n * ```\n */\nexport function setMailMode(mode: MailMode): void {\n  explicitMode = mode;\n}\n\n/**\n * Get the current mail mode\n */\nexport function getMailMode(): MailMode {\n  if (explicitMode) return explicitMode;\n\n  // Development and test never send real mail unless `mail.sendInDevelopment` is true\n  if (environment() !== \"production\" && config.key(\"mail.sendInDevelopment\") !== true) {\n    return \"development\";\n  }\n\n  return \"production\";\n}\n\n/**\n * Check if in production mode\n */\nexport function isProductionMode(): boolean {\n  return getMailMode() === \"production\";\n}\n\n/**\n * Check if in development mode\n */\nexport function isDevelopmentMode(): boolean {\n  return getMailMode() === \"development\";\n}\n\n/**\n * Check if in test mode\n */\nexport function isTestMode(): boolean {\n  return getMailMode() === \"test\";\n}\n\n/**\n * Set mail configurations\n *\n * Supports both simple config and named mailers.\n *\n * @example\n * ```typescript\n * // Simple config (sets as default)\n * setMailConfigurations({\n *   host: \"smtp.gmail.com\",\n *   port: 587,\n *   username: \"...\",\n *   password: \"...\",\n * });\n *\n * // Named mailers\n * setMailConfigurations({\n *   default: { host: \"smtp.sendgrid.net\", ... },\n *   mailers: {\n *     marketing: { host: \"smtp.mailchimp.com\", ... },\n *     transactional: { host: \"smtp.postmark.com\", ... },\n *   },\n * });\n * ```\n */\nexport function setMailConfigurations(config: MailConfigurations | MailersConfig): void {\n  // Check if it's a MailersConfig (has 'default' or 'mailers' key)\n  if (\"default\" in config || \"mailers\" in config) {\n    mailersConfig = config as MailersConfig;\n  } else {\n    // Simple config - set as default\n    mailersConfig = {\n      default: config as MailConfigurations,\n    };\n  }\n}\n\nexport function getDefaultMailConfig(): MailConfigurations {\n  const config = mailersConfig.default;\n  if (!config) return {} as MailConfigurations;\n  if (\"driver\" in config && config.driver === \"ses\") return config;\n\n  return withSmtpDefaults(config);\n}\n\n/**\n * Get a named mailer configuration\n */\nexport function getMailerConfig(name: string): MailConfigurations | undefined {\n  if (name === \"default\") {\n    return getDefaultMailConfig();\n  }\n\n  const config = mailersConfig.mailers?.[name];\n  if (!config) {\n    return undefined;\n  }\n\n  if (\"driver\" in config && config.driver === \"ses\") return config;\n\n  return withSmtpDefaults(config);\n}\n\n/**\n * Resolve configuration from options\n * Priority: config > mailer > default\n */\nexport function resolveMailConfig(options: {\n  config?: MailConfigurations;\n  mailer?: string;\n}): MailConfigurations {\n  if (options.config) {\n    // SES config passes through as-is, no defaultConfigurations merge\n    if (\"driver\" in options.config && options.config.driver === \"ses\") {\n      return options.config;\n    }\n\n    return withSmtpDefaults(options.config);\n  }\n\n  if (options.mailer) {\n    const config = getMailerConfig(options.mailer);\n    if (!config) {\n      throw new Error(`Mailer \"${options.mailer}\" not found in configuration`);\n    }\n    return config;\n  }\n\n  return getDefaultMailConfig();\n}\n\n/**\n * Reset all configurations (useful for testing)\n */\nexport function resetMailConfig(): void {\n  explicitMode = undefined;\n  mailersConfig = {};\n}\n"],"mappings":";;;;;;;;AAOA,MAAM,wBAAqD;CACzD,KAAK;CACL,QAAQ;AACV;;;;;;AAOA,SAAS,iBAAiB,QAAgD;CACxE,MAAM,SAAS;EAAE,GAAG;EAAuB,GAAG;CAAO;CAErD,IAAI,OAAO,WAAW,QACpB,OAAO,SAAS,OAAO,OAAO,IAAI,MAAM;CAG1C,OAAO;AACT;;;;;AAMA,IAAI;;;;AAKJ,IAAI,gBAA+B,CAAC;;;;;;;;;;;;;;;;;;;AAoBpC,SAAgB,YAAY,MAAsB;CAChD,eAAe;AACjB;;;;AAKA,SAAgB,cAAwB;CACtC,IAAI,cAAc,OAAO;CAGzB,IAAI,YAAY,MAAM,gBAAgB,OAAO,IAAI,wBAAwB,MAAM,MAC7E,OAAO;CAGT,OAAO;AACT;;;;AAKA,SAAgB,mBAA4B;CAC1C,OAAO,YAAY,MAAM;AAC3B;;;;AAKA,SAAgB,oBAA6B;CAC3C,OAAO,YAAY,MAAM;AAC3B;;;;AAKA,SAAgB,aAAsB;CACpC,OAAO,YAAY,MAAM;AAC3B;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BA,SAAgB,sBAAsB,QAAkD;CAEtF,IAAI,aAAa,UAAU,aAAa,QACtC,gBAAgB;MAGhB,gBAAgB,EACd,SAAS,OACX;AAEJ;AAEA,SAAgB,uBAA2C;CACzD,MAAM,SAAS,cAAc;CAC7B,IAAI,CAAC,QAAQ,OAAO,CAAC;CACrB,IAAI,YAAY,UAAU,OAAO,WAAW,OAAO,OAAO;CAE1D,OAAO,iBAAiB,MAAM;AAChC;;;;AAKA,SAAgB,gBAAgB,MAA8C;CAC5E,IAAI,SAAS,WACX,OAAO,qBAAqB;CAG9B,MAAM,SAAS,cAAc,UAAU;CACvC,IAAI,CAAC,QACH;CAGF,IAAI,YAAY,UAAU,OAAO,WAAW,OAAO,OAAO;CAE1D,OAAO,iBAAiB,MAAM;AAChC;;;;;AAMA,SAAgB,kBAAkB,SAGX;CACrB,IAAI,QAAQ,QAAQ;EAElB,IAAI,YAAY,QAAQ,UAAU,QAAQ,OAAO,WAAW,OAC1D,OAAO,QAAQ;EAGjB,OAAO,iBAAiB,QAAQ,MAAM;CACxC;CAEA,IAAI,QAAQ,QAAQ;EAClB,MAAM,SAAS,gBAAgB,QAAQ,MAAM;EAC7C,IAAI,CAAC,QACH,MAAM,IAAI,MAAM,WAAW,QAAQ,OAAO,6BAA6B;EAEzE,OAAO;CACT;CAEA,OAAO,qBAAqB;AAC9B;;;;AAKA,SAAgB,kBAAwB;CACtC,eAAe;CACf,gBAAgB,CAAC;AACnB"}
+{"version":3,"file":"config.mjs","names":[],"sources":["../../../../../../../../packages/core/src/mail/config.ts"],"sourcesContent":["import { config } from \"../config\";\nimport { environment } from \"../utils/environment\";\nimport type { MailConfigurations, MailersConfig, MailMode, SMTPConfigurations } from \"./types\";\n\n/**\n * Default mail configurations\n */\nconst defaultConfigurations: Partial<SMTPConfigurations> = {\n  tls: true,\n  driver: \"smtp\",\n};\n\n/**\n * Merge defaults into an SMTP config.\n * `secure` is derived from the port when not set explicitly:\n * 465 uses implicit TLS, every other port (e.g. 587) uses STARTTLS.\n */\nfunction withSmtpDefaults(config: MailConfigurations): SMTPConfigurations {\n  const merged = { ...defaultConfigurations, ...config } as SMTPConfigurations;\n\n  if (merged.secure === undefined) {\n    merged.secure = Number(merged.port) === 465;\n  }\n\n  return merged;\n}\n\n/**\n * Mode set explicitly through `setMailMode`; when undefined the mode is\n * derived from the environment.\n */\nlet explicitMode: MailMode | undefined;\n\n/**\n * Registered mailers configuration\n */\nlet mailersConfig: MailersConfig = {};\n\n/**\n * Set the mail mode\n *\n * @param mode \"production\" | \"development\" | \"test\"\n *\n * - **production**: Actually sends emails via SMTP\n * - **development**: Logs emails to console without sending\n * - **test**: Captures emails to test mailbox for assertions\n *\n * @example\n * ```typescript\n * // In test setup\n * setMailMode(\"test\");\n *\n * // In development\n * setMailMode(\"development\");\n * ```\n */\nexport function setMailMode(mode: MailMode): void {\n  explicitMode = mode;\n}\n\n/**\n * The mode set with {@link setMailMode}, or `undefined` when the mode is\n * derived from the environment.\n */\nexport function getExplicitMailMode(): MailMode | undefined {\n  return explicitMode;\n}\n\n/**\n * Forget a mode set with {@link setMailMode}, so the mode is derived from the\n * environment again. Unlike {@link resetMailConfig}, the configured mailers\n * are kept.\n */\nexport function resetMailMode(): void {\n  explicitMode = undefined;\n}\n\n/**\n * Get the current mail mode\n */\nexport function getMailMode(): MailMode {\n  if (explicitMode) return explicitMode;\n\n  // Development and test never send real mail unless `mail.sendInDevelopment` is true\n  if (environment() !== \"production\" && config.key(\"mail.sendInDevelopment\") !== true) {\n    return \"development\";\n  }\n\n  return \"production\";\n}\n\n/**\n * Check if in production mode\n */\nexport function isProductionMode(): boolean {\n  return getMailMode() === \"production\";\n}\n\n/**\n * Check if in development mode\n */\nexport function isDevelopmentMode(): boolean {\n  return getMailMode() === \"development\";\n}\n\n/**\n * Check if in test mode\n */\nexport function isTestMode(): boolean {\n  return getMailMode() === \"test\";\n}\n\n/**\n * Set mail configurations\n *\n * Supports both simple config and named mailers.\n *\n * @example\n * ```typescript\n * // Simple config (sets as default)\n * setMailConfigurations({\n *   host: \"smtp.gmail.com\",\n *   port: 587,\n *   username: \"...\",\n *   password: \"...\",\n * });\n *\n * // Named mailers\n * setMailConfigurations({\n *   default: { host: \"smtp.sendgrid.net\", ... },\n *   mailers: {\n *     marketing: { host: \"smtp.mailchimp.com\", ... },\n *     transactional: { host: \"smtp.postmark.com\", ... },\n *   },\n * });\n * ```\n */\nexport function setMailConfigurations(config: MailConfigurations | MailersConfig): void {\n  // Check if it's a MailersConfig (has 'default' or 'mailers' key)\n  if (\"default\" in config || \"mailers\" in config) {\n    mailersConfig = config as MailersConfig;\n  } else {\n    // Simple config - set as default\n    mailersConfig = {\n      default: config as MailConfigurations,\n    };\n  }\n}\n\nexport function getDefaultMailConfig(): MailConfigurations {\n  const config = mailersConfig.default;\n  if (!config) return {} as MailConfigurations;\n  if (\"driver\" in config && config.driver === \"ses\") return config;\n\n  return withSmtpDefaults(config);\n}\n\n/**\n * Get a named mailer configuration\n */\nexport function getMailerConfig(name: string): MailConfigurations | undefined {\n  if (name === \"default\") {\n    return getDefaultMailConfig();\n  }\n\n  const config = mailersConfig.mailers?.[name];\n  if (!config) {\n    return undefined;\n  }\n\n  if (\"driver\" in config && config.driver === \"ses\") return config;\n\n  return withSmtpDefaults(config);\n}\n\n/**\n * Resolve configuration from options\n * Priority: config > mailer > default\n */\nexport function resolveMailConfig(options: {\n  config?: MailConfigurations;\n  mailer?: string;\n}): MailConfigurations {\n  if (options.config) {\n    // SES config passes through as-is, no defaultConfigurations merge\n    if (\"driver\" in options.config && options.config.driver === \"ses\") {\n      return options.config;\n    }\n\n    return withSmtpDefaults(options.config);\n  }\n\n  if (options.mailer) {\n    const config = getMailerConfig(options.mailer);\n    if (!config) {\n      throw new Error(`Mailer \"${options.mailer}\" not found in configuration`);\n    }\n    return config;\n  }\n\n  return getDefaultMailConfig();\n}\n\n/**\n * Reset all configurations (useful for testing)\n */\nexport function resetMailConfig(): void {\n  explicitMode = undefined;\n  mailersConfig = {};\n}\n"],"mappings":";;;;;;;;AAOA,MAAM,wBAAqD;CACzD,KAAK;CACL,QAAQ;AACV;;;;;;AAOA,SAAS,iBAAiB,QAAgD;CACxE,MAAM,SAAS;EAAE,GAAG;EAAuB,GAAG;CAAO;CAErD,IAAI,OAAO,WAAW,QACpB,OAAO,SAAS,OAAO,OAAO,IAAI,MAAM;CAG1C,OAAO;AACT;;;;;AAMA,IAAI;;;;AAKJ,IAAI,gBAA+B,CAAC;;;;;;;;;;;;;;;;;;;AAoBpC,SAAgB,YAAY,MAAsB;CAChD,eAAe;AACjB;;;;;AAMA,SAAgB,sBAA4C;CAC1D,OAAO;AACT;;;;;;AAOA,SAAgB,gBAAsB;CACpC,eAAe;AACjB;;;;AAKA,SAAgB,cAAwB;CACtC,IAAI,cAAc,OAAO;CAGzB,IAAI,YAAY,MAAM,gBAAgB,OAAO,IAAI,wBAAwB,MAAM,MAC7E,OAAO;CAGT,OAAO;AACT;;;;AAKA,SAAgB,mBAA4B;CAC1C,OAAO,YAAY,MAAM;AAC3B;;;;AAKA,SAAgB,oBAA6B;CAC3C,OAAO,YAAY,MAAM;AAC3B;;;;AAKA,SAAgB,aAAsB;CACpC,OAAO,YAAY,MAAM;AAC3B;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BA,SAAgB,sBAAsB,QAAkD;CAEtF,IAAI,aAAa,UAAU,aAAa,QACtC,gBAAgB;MAGhB,gBAAgB,EACd,SAAS,OACX;AAEJ;AAEA,SAAgB,uBAA2C;CACzD,MAAM,SAAS,cAAc;CAC7B,IAAI,CAAC,QAAQ,OAAO,CAAC;CACrB,IAAI,YAAY,UAAU,OAAO,WAAW,OAAO,OAAO;CAE1D,OAAO,iBAAiB,MAAM;AAChC;;;;AAKA,SAAgB,gBAAgB,MAA8C;CAC5E,IAAI,SAAS,WACX,OAAO,qBAAqB;CAG9B,MAAM,SAAS,cAAc,UAAU;CACvC,IAAI,CAAC,QACH;CAGF,IAAI,YAAY,UAAU,OAAO,WAAW,OAAO,OAAO;CAE1D,OAAO,iBAAiB,MAAM;AAChC;;;;;AAMA,SAAgB,kBAAkB,SAGX;CACrB,IAAI,QAAQ,QAAQ;EAElB,IAAI,YAAY,QAAQ,UAAU,QAAQ,OAAO,WAAW,OAC1D,OAAO,QAAQ;EAGjB,OAAO,iBAAiB,QAAQ,MAAM;CACxC;CAEA,IAAI,QAAQ,QAAQ;EAClB,MAAM,SAAS,gBAAgB,QAAQ,MAAM;EAC7C,IAAI,CAAC,QACH,MAAM,IAAI,MAAM,WAAW,QAAQ,OAAO,6BAA6B;EAEzE,OAAO;CACT;CAEA,OAAO,qBAAqB;AAC9B;;;;AAKA,SAAgB,kBAAwB;CACtC,eAAe;CACf,gBAAgB,CAAC;AACnB"}

package/esm/mail/index.d.mts

@@ -1,5 +1,5 @@
 import { CapturedMail, MailAddress, MailAttachment, MailConfigurations, MailError, MailErrorCode, MailEvents, MailMode, MailOptions, MailPriority, MailResult, MailersConfig, NormalizedMail, SESConfigurations, SMTPConfigurations } from "./types.mjs";
-import { getDefaultMailConfig, getMailMode, getMailerConfig, isDevelopmentMode, isProductionMode, isTestMode, resetMailConfig, resolveMailConfig, setMailConfigurations, setMailMode } from "./config.mjs";
+import { getDefaultMailConfig, getExplicitMailMode, getMailMode, getMailerConfig, isDevelopmentMode, isProductionMode, isTestMode, resetMailConfig, resetMailMode, resolveMailConfig, setMailConfigurations, setMailMode } from "./config.mjs";
 import { MAIL_EVENTS, generateMailId, getMailEventName, mailEvents } from "./events.mjs";
 import { closeAllMailers, closeMailer, getMailer, getPoolStats, verifyMailer } from "./mailer-pool.mjs";
 import { renderReactMail } from "./react-mail.mjs";

package/esm/mail/index.mjs

@@ -1,4 +1,4 @@
-import { getDefaultMailConfig, getMailMode, getMailerConfig, isDevelopmentMode, isProductionMode, isTestMode, resetMailConfig, resolveMailConfig, setMailConfigurations, setMailMode } from "./config.mjs";
+import { getDefaultMailConfig, getExplicitMailMode, getMailMode, getMailerConfig, isDevelopmentMode, isProductionMode, isTestMode, resetMailConfig, resetMailMode, resolveMailConfig, setMailConfigurations, setMailMode } from "./config.mjs";
 import { MAIL_EVENTS, generateMailId, getMailEventName, mailEvents } from "./events.mjs";
 import { closeAllMailers, closeMailer, getMailer, getPoolStats, verifyMailer } from "./mailer-pool.mjs";
 import { renderReactMail } from "./react-mail.mjs";

package/esm/net/index.d.mts

@@ -0,0 +1,2 @@
+import { isPrivateOrReservedIp } from "../storage/utils/classify-ip-address.mjs";
+export { isPrivateOrReservedIp };

package/esm/net/index.mjs

@@ -0,0 +1,3 @@
+import { isPrivateOrReservedIp } from "../storage/utils/classify-ip-address.mjs";
+
+export { isPrivateOrReservedIp };

package/esm/openapi/build-openapi-document.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"build-openapi-document.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/openapi/build-openapi-document.ts"],"mappings":";;;;cA2Ba,2BAAA;AAAb;;;;AAAwC;AA8BxC;;;AA9BA,iBA8BgB,oBAAA,CACd,MAAA,WAAiB,iBAAA,IACjB,OAAA,EAAS,cAAA,GACR,kBAAA"}
+{"version":3,"file":"build-openapi-document.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/openapi/build-openapi-document.ts"],"mappings":";;;;cA6Ba,2BAAA;AAAb;;;;AAAwC;AA8BxC;;;AA9BA,iBA8BgB,oBAAA,CACd,MAAA,WAAiB,iBAAA,IACjB,OAAA,EAAS,cAAA,GACR,kBAAA"}

package/esm/openapi/build-openapi-document.mjs

@@ -1,5 +1,6 @@
+import { resolveRouteValidation } from "../router/resolve-route-validation.mjs";
 import { buildDeclaredResponses } from "./response-schemas.mjs";
-import { buildUnauthorizedResponse, buildValidationFailedResponse, resolveValidationResponse } from "./error-responses.mjs";
+import { buildCustomValidationFailedResponse, buildUnauthorizedResponse, buildValidationFailedResponse, resolveValidationResponse } from "./error-responses.mjs";
 import { buildOperationId, expandMethods, firstSegmentTag, toOpenApiPath } from "./paths.mjs";
 import { buildRequestParts } from "./request-schemas.mjs";
 import { SchemaRegistry } from "./schema-registry.mjs";
@@ -46,7 +47,7 @@ function buildOpenApiDocument(routes, context) {
 			continue;
 		}
 		const handler = route.handler;
-		const validation = handler?.validation;
+		const validation = resolveRouteValidation(route);
 		const auth = readRouteAuth(route.middleware, warn);
 		const tag = firstSegmentTag(route.path);
 		const pathKey = toOpenApiPath(route.path);
@@ -72,14 +73,16 @@ function buildOpenApiDocument(routes, context) {
 				validation,
 				warn
 			});
-			const responses = route.isPage ? { "200": {
+			const declared = route.isPage ? { "200": {
 				description: "HTML page",
 				content: { "text/html": { schema: { type: "string" } } }
 			} } : buildDeclaredResponses(handler?.responseSchema, registry, warn);
+			const responses = { ...declared };
 			if (!Object.keys(responses).some((status) => status.startsWith("2"))) responses["200"] = { description: "Successful response" };
 			if (validation?.schema) {
-				const failed = buildValidationFailedResponse(validationShape, registry);
-				responses[failed.status] ??= failed.response;
+				const routeHook = typeof validation.onFailure === "function";
+				const failed = routeHook || validationShape.customBody ? buildCustomValidationFailedResponse(validationShape, declared, routeHook, warn) : buildValidationFailedResponse(validationShape, registry);
+				if (failed) responses[failed.status] ??= failed.response;
 			}
 			if (auth) responses["401"] ??= buildUnauthorizedResponse(registry);
 			if (tag) tags.add(tag);

package/esm/openapi/build-openapi-document.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"build-openapi-document.mjs","names":[],"sources":["../../../../../../../../packages/core/src/openapi/build-openapi-document.ts"],"sourcesContent":["import {\n  buildUnauthorizedResponse,\n  buildValidationFailedResponse,\n  resolveValidationResponse,\n} from \"./error-responses\";\nimport {\n  buildOperationId,\n  expandMethods,\n  firstSegmentTag,\n  toOpenApiPath,\n  type OpenApiMethod,\n} from \"./paths\";\nimport { buildRequestParts } from \"./request-schemas\";\nimport { buildDeclaredResponses } from \"./response-schemas\";\nimport { SchemaRegistry } from \"./schema-registry\";\nimport { readRouteAuth, SecuritySchemes } from \"./security\";\nimport type {\n  AuthDescriptor,\n  OpenApiBuildResult,\n  OpenApiContext,\n  OpenApiDocument,\n  OpenApiOperation,\n  OpenApiResponse,\n  OpenApiRouteInput,\n} from \"./types\";\n\n/** `jsonSchemaDialect` of every document: OpenAPI 3.1 schemas are JSON Schema 2020-12. */\nexport const OPENAPI_JSON_SCHEMA_DIALECT = \"https://json-schema.org/draft/2020-12/schema\";\n\nconst UNSAFE_METHODS: readonly OpenApiMethod[] = [\"post\", \"put\", \"patch\", \"delete\"];\n\nfunction describeAuth(auth: AuthDescriptor, method: OpenApiMethod): string[] {\n  const lines: string[] = [];\n\n  if (auth.userTypes.length > 0) {\n    lines.push(`Requires an authenticated user of type: ${auth.userTypes.join(\", \")}.`);\n  }\n\n  const usesCookie = auth.sources.some((source) => typeof source !== \"string\");\n\n  if (usesCookie && UNSAFE_METHODS.includes(method)) {\n    lines.push(\n      \"When authenticating with the cookie, the request must also carry a same-origin Origin or Referer header (CSRF guard).\",\n    );\n  }\n\n  return lines;\n}\n\n/**\n * Build an OpenAPI 3.1 document from registered routes.\n *\n * Pure: it reads the routes it is given (`router.list()` in the app), converts Seal schemas\n * with `toJsonSchema(\"draft-2020-12\")` and returns plain JSON plus the gaps it found as\n * `warnings`. It never throws for a single route it cannot document; that route is\n * documented as far as possible and a warning explains what was left out.\n */\nexport function buildOpenApiDocument(\n  routes: readonly OpenApiRouteInput[],\n  context: OpenApiContext,\n): OpenApiBuildResult {\n  const warnings: string[] = [];\n  const registry = new SchemaRegistry(context.resolveResourceName, (message) => warnings.push(message));\n  const security = new SecuritySchemes();\n  const validationShape = resolveValidationResponse(context.validationResponse);\n  const paths: OpenApiDocument[\"paths\"] = {};\n  const tags = new Set<string>();\n  const operationIds = new Set<string>();\n\n  for (const route of routes) {\n    if (route.isPage && !context.includePages) {\n      continue;\n    }\n\n    const methods = expandMethods(route.method);\n    const label = `${String(route.method).toUpperCase()} ${route.path}`;\n    const warn = (message: string) => warnings.push(`${label}: ${message}`);\n\n    if (methods.length === 0) {\n      warn(`unsupported method \"${String(route.method)}\", route skipped.`);\n\n      continue;\n    }\n\n    const handler = route.handler as OpenApiRouteInput[\"handler\"] | undefined;\n    const validation = handler?.validation;\n    const auth = readRouteAuth(route.middleware, warn);\n    const tag = firstSegmentTag(route.path);\n    const pathKey = toOpenApiPath(route.path);\n\n    if (validation?.validate) {\n      warn(\"validation.validate is custom middleware and is not documented.\");\n    }\n\n    for (const method of methods) {\n      paths[pathKey] ??= {};\n\n      if (paths[pathKey][method]) {\n        warn(`${method.toUpperCase()} ${pathKey} is already documented by an earlier route; this one is skipped.`);\n\n        continue;\n      }\n\n      let operationId = buildOperationId(route.name, method, route.path, methods.length > 1);\n\n      if (operationIds.has(operationId)) {\n        let suffix = 2;\n\n        while (operationIds.has(`${operationId}_${suffix}`)) {\n          suffix++;\n        }\n\n        warn(`operationId \"${operationId}\" is already used; renamed to \"${operationId}_${suffix}\".`);\n        operationId = `${operationId}_${suffix}`;\n      }\n\n      operationIds.add(operationId);\n\n      const description = [\n        route.description ?? handler?.description,\n        ...(auth ? describeAuth(auth, method) : []),\n      ].filter((line): line is string => typeof line === \"string\" && line.length > 0);\n\n      const request = buildRequestParts({ method, path: route.path, validation, warn });\n\n      const responses: Record<string, OpenApiResponse> = route.isPage\n        ? { \"200\": { description: \"HTML page\", content: { \"text/html\": { schema: { type: \"string\" } } } } }\n        : buildDeclaredResponses(handler?.responseSchema, registry, warn);\n\n      if (!Object.keys(responses).some((status) => status.startsWith(\"2\"))) {\n        responses[\"200\"] = { description: \"Successful response\" };\n      }\n\n      if (validation?.schema) {\n        const failed = buildValidationFailedResponse(validationShape, registry);\n\n        responses[failed.status] ??= failed.response;\n      }\n\n      if (auth) {\n        responses[\"401\"] ??= buildUnauthorizedResponse(registry);\n      }\n\n      if (tag) {\n        tags.add(tag);\n      }\n\n      // Built in reading order: identity, prose, inputs, outputs, security.\n      const operation: OpenApiOperation = {\n        operationId,\n        ...(route.label ? { summary: route.label } : {}),\n        ...(description.length > 0 ? { description: description.join(\"\\n\\n\") } : {}),\n        ...(tag ? { tags: [tag] } : {}),\n        ...(request.parameters.length > 0 ? { parameters: request.parameters } : {}),\n        ...(request.requestBody ? { requestBody: request.requestBody } : {}),\n        responses: sortResponses(responses),\n        ...(auth ? { security: security.requirementsFor(auth) } : {}),\n      };\n\n      paths[pathKey][method] = operation;\n    }\n  }\n\n  // Keys in reading order: header, servers, tags, paths, components.\n  const document: OpenApiDocument = {\n    openapi: \"3.1.0\",\n    jsonSchemaDialect: OPENAPI_JSON_SCHEMA_DIALECT,\n    info: { ...context.info },\n    ...(context.servers && context.servers.length > 0\n      ? { servers: context.servers.map((url) => ({ url })) }\n      : {}),\n    ...(tags.size > 0 ? { tags: [...tags].sort().map((name) => ({ name })) } : {}),\n    paths,\n  };\n\n  const hasSchemas = Object.keys(registry.schemas).length > 0;\n\n  if (hasSchemas || security.hasSchemes()) {\n    document.components = {};\n\n    if (hasSchemas) {\n      document.components.schemas = registry.schemas;\n    }\n\n    if (security.hasSchemes()) {\n      document.components.securitySchemes = security.schemes;\n    }\n  }\n\n  return { document, warnings: [...new Set(warnings)] };\n}\n\nfunction sortResponses(responses: Record<string, OpenApiResponse>): Record<string, OpenApiResponse> {\n  return Object.fromEntries(\n    Object.entries(responses).sort(([first], [second]) => first.localeCompare(second)),\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"build-openapi-document.mjs","names":[],"sources":["../../../../../../../../packages/core/src/openapi/build-openapi-document.ts"],"sourcesContent":["import { resolveRouteValidation } from \"../router/resolve-route-validation\";\nimport {\n  buildCustomValidationFailedResponse,\n  buildUnauthorizedResponse,\n  buildValidationFailedResponse,\n  resolveValidationResponse,\n} from \"./error-responses\";\nimport {\n  buildOperationId,\n  expandMethods,\n  firstSegmentTag,\n  toOpenApiPath,\n  type OpenApiMethod,\n} from \"./paths\";\nimport { buildRequestParts } from \"./request-schemas\";\nimport { buildDeclaredResponses } from \"./response-schemas\";\nimport { SchemaRegistry } from \"./schema-registry\";\nimport { readRouteAuth, SecuritySchemes } from \"./security\";\nimport type {\n  AuthDescriptor,\n  OpenApiBuildResult,\n  OpenApiContext,\n  OpenApiDocument,\n  OpenApiOperation,\n  OpenApiResponse,\n  OpenApiRouteInput,\n} from \"./types\";\n\n/** `jsonSchemaDialect` of every document: OpenAPI 3.1 schemas are JSON Schema 2020-12. */\nexport const OPENAPI_JSON_SCHEMA_DIALECT = \"https://json-schema.org/draft/2020-12/schema\";\n\nconst UNSAFE_METHODS: readonly OpenApiMethod[] = [\"post\", \"put\", \"patch\", \"delete\"];\n\nfunction describeAuth(auth: AuthDescriptor, method: OpenApiMethod): string[] {\n  const lines: string[] = [];\n\n  if (auth.userTypes.length > 0) {\n    lines.push(`Requires an authenticated user of type: ${auth.userTypes.join(\", \")}.`);\n  }\n\n  const usesCookie = auth.sources.some((source) => typeof source !== \"string\");\n\n  if (usesCookie && UNSAFE_METHODS.includes(method)) {\n    lines.push(\n      \"When authenticating with the cookie, the request must also carry a same-origin Origin or Referer header (CSRF guard).\",\n    );\n  }\n\n  return lines;\n}\n\n/**\n * Build an OpenAPI 3.1 document from registered routes.\n *\n * Pure: it reads the routes it is given (`router.list()` in the app), converts Seal schemas\n * with `toJsonSchema(\"draft-2020-12\")` and returns plain JSON plus the gaps it found as\n * `warnings`. It never throws for a single route it cannot document; that route is\n * documented as far as possible and a warning explains what was left out.\n */\nexport function buildOpenApiDocument(\n  routes: readonly OpenApiRouteInput[],\n  context: OpenApiContext,\n): OpenApiBuildResult {\n  const warnings: string[] = [];\n  const registry = new SchemaRegistry(context.resolveResourceName, (message) =>\n    warnings.push(message),\n  );\n  const security = new SecuritySchemes();\n  const validationShape = resolveValidationResponse(context.validationResponse);\n  const paths: OpenApiDocument[\"paths\"] = {};\n  const tags = new Set<string>();\n  const operationIds = new Set<string>();\n\n  for (const route of routes) {\n    if (route.isPage && !context.includePages) {\n      continue;\n    }\n\n    const methods = expandMethods(route.method);\n    const label = `${String(route.method).toUpperCase()} ${route.path}`;\n    const warn = (message: string) => warnings.push(`${label}: ${message}`);\n\n    if (methods.length === 0) {\n      warn(`unsupported method \"${String(route.method)}\", route skipped.`);\n\n      continue;\n    }\n\n    const handler = route.handler as OpenApiRouteInput[\"handler\"] | undefined;\n    const validation = resolveRouteValidation(route);\n    const auth = readRouteAuth(route.middleware, warn);\n    const tag = firstSegmentTag(route.path);\n    const pathKey = toOpenApiPath(route.path);\n\n    if (validation?.validate) {\n      warn(\"validation.validate is custom middleware and is not documented.\");\n    }\n\n    for (const method of methods) {\n      paths[pathKey] ??= {};\n\n      if (paths[pathKey][method]) {\n        warn(\n          `${method.toUpperCase()} ${pathKey} is already documented by an earlier route; this one is skipped.`,\n        );\n\n        continue;\n      }\n\n      let operationId = buildOperationId(route.name, method, route.path, methods.length > 1);\n\n      if (operationIds.has(operationId)) {\n        let suffix = 2;\n\n        while (operationIds.has(`${operationId}_${suffix}`)) {\n          suffix++;\n        }\n\n        warn(\n          `operationId \"${operationId}\" is already used; renamed to \"${operationId}_${suffix}\".`,\n        );\n        operationId = `${operationId}_${suffix}`;\n      }\n\n      operationIds.add(operationId);\n\n      const description = [\n        route.description ?? handler?.description,\n        ...(auth ? describeAuth(auth, method) : []),\n      ].filter((line): line is string => typeof line === \"string\" && line.length > 0);\n\n      const request = buildRequestParts({ method, path: route.path, validation, warn });\n\n      const declared: Record<string, OpenApiResponse> = route.isPage\n        ? {\n            \"200\": {\n              description: \"HTML page\",\n              content: { \"text/html\": { schema: { type: \"string\" } } },\n            },\n          }\n        : buildDeclaredResponses(handler?.responseSchema, registry, warn);\n      const responses: Record<string, OpenApiResponse> = { ...declared };\n\n      if (!Object.keys(responses).some((status) => status.startsWith(\"2\"))) {\n        responses[\"200\"] = { description: \"Successful response\" };\n      }\n\n      if (validation?.schema) {\n        const routeHook = typeof validation.onFailure === \"function\";\n        const failed =\n          routeHook || validationShape.customBody\n            ? buildCustomValidationFailedResponse(validationShape, declared, routeHook, warn)\n            : buildValidationFailedResponse(validationShape, registry);\n\n        if (failed) {\n          responses[failed.status] ??= failed.response;\n        }\n      }\n\n      if (auth) {\n        responses[\"401\"] ??= buildUnauthorizedResponse(registry);\n      }\n\n      if (tag) {\n        tags.add(tag);\n      }\n\n      // Built in reading order: identity, prose, inputs, outputs, security.\n      const operation: OpenApiOperation = {\n        operationId,\n        ...(route.label ? { summary: route.label } : {}),\n        ...(description.length > 0 ? { description: description.join(\"\\n\\n\") } : {}),\n        ...(tag ? { tags: [tag] } : {}),\n        ...(request.parameters.length > 0 ? { parameters: request.parameters } : {}),\n        ...(request.requestBody ? { requestBody: request.requestBody } : {}),\n        responses: sortResponses(responses),\n        ...(auth ? { security: security.requirementsFor(auth) } : {}),\n      };\n\n      paths[pathKey][method] = operation;\n    }\n  }\n\n  // Keys in reading order: header, servers, tags, paths, components.\n  const document: OpenApiDocument = {\n    openapi: \"3.1.0\",\n    jsonSchemaDialect: OPENAPI_JSON_SCHEMA_DIALECT,\n    info: { ...context.info },\n    ...(context.servers && context.servers.length > 0\n      ? { servers: context.servers.map((url) => ({ url })) }\n      : {}),\n    ...(tags.size > 0 ? { tags: [...tags].sort().map((name) => ({ name })) } : {}),\n    paths,\n  };\n\n  const hasSchemas = Object.keys(registry.schemas).length > 0;\n\n  if (hasSchemas || security.hasSchemes()) {\n    document.components = {};\n\n    if (hasSchemas) {\n      document.components.schemas = registry.schemas;\n    }\n\n    if (security.hasSchemes()) {\n      document.components.securitySchemes = security.schemes;\n    }\n  }\n\n  return { document, warnings: [...new Set(warnings)] };\n}\n\nfunction sortResponses(\n  responses: Record<string, OpenApiResponse>,\n): Record<string, OpenApiResponse> {\n  return Object.fromEntries(\n    Object.entries(responses).sort(([first], [second]) => first.localeCompare(second)),\n  );\n}\n"],"mappings":"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"}

package/esm/openapi/error-responses.mjs

@@ -5,7 +5,9 @@ const DEFAULT_VALIDATION_RESPONSE = {
 	errors: "errors",
 	inputKey: "input",
 	inputError: "error",
-	status: 422
+	status: 422,
+	/** A global `validation.response.body` hook replaces the framework body. */
+	customBody: false
 };
 /**
 * The `validation.response` config over its documented defaults, as `Response.failedSchema`
@@ -17,6 +19,7 @@ function resolveValidationResponse(config) {
 	if (typeof config?.inputKey === "string" && config.inputKey) merged.inputKey = config.inputKey;
 	if (typeof config?.inputError === "string" && config.inputError) merged.inputError = config.inputError;
 	if (typeof config?.status === "number" && Number.isInteger(config.status)) merged.status = config.status;
+	merged.customBody = typeof config?.body === "function";
 	return merged;
 }
 /**
@@ -61,7 +64,30 @@ function buildUnauthorizedResponse(registry) {
 		content: { "application/json": { schema: ref } }
 	};
 }
+/**
+* The failed-validation response of a route whose failure body is customized, by its own
+* `validation.onFailure` or the global `validation.response.body` hook. The framework body
+* would be wrong here, so:
+*
+* - a status the handler's `responseSchema` declares documents the custom body as written;
+* - otherwise the configured failure status is documented without a body. A route hook may
+*   also change the status, so when the handler declares any 4xx entry of its own, those
+*   entries are trusted and nothing is added.
+*
+* Returns `undefined` when nothing should be added, and warns when a route hook's body is
+* left undocumented.
+*/
+function buildCustomValidationFailedResponse(shape, declared, routeHook, warn) {
+	const status = String(shape.status);
+	if (declared[status]) return;
+	if (routeHook && Object.keys(declared).some((code) => /^4\d\d$/.test(code))) return;
+	if (routeHook) warn("validation.onFailure customizes the failure response; declare its status and body in responseSchema to document it.");
+	return {
+		status,
+		response: { description: describeStatus(status) }
+	};
+}
 
 //#endregion
-export { buildUnauthorizedResponse, buildValidationFailedResponse, resolveValidationResponse };
+export { buildCustomValidationFailedResponse, buildUnauthorizedResponse, buildValidationFailedResponse, resolveValidationResponse };
 //# sourceMappingURL=error-responses.mjs.map

package/esm/openapi/error-responses.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"error-responses.mjs","names":[],"sources":["../../../../../../../../packages/core/src/openapi/error-responses.ts"],"sourcesContent":["import { describeStatus } from \"./response-schemas\";\nimport type { SchemaRegistry } from \"./schema-registry\";\nimport type { OpenApiResponse, OpenApiValidationResponseConfig } from \"./types\";\n\nconst DEFAULT_VALIDATION_RESPONSE = {\n  errors: \"errors\",\n  inputKey: \"input\",\n  inputError: \"error\",\n  status: 422,\n};\n\nexport type ValidationResponseShape = typeof DEFAULT_VALIDATION_RESPONSE;\n\n/**\n * The `validation.response` config over its documented defaults, as `Response.failedSchema`\n * reads it.\n */\nexport function resolveValidationResponse(\n  config: OpenApiValidationResponseConfig | undefined,\n): ValidationResponseShape {\n  const merged = { ...DEFAULT_VALIDATION_RESPONSE };\n\n  if (typeof config?.errors === \"string\" && config.errors) {\n    merged.errors = config.errors;\n  }\n\n  if (typeof config?.inputKey === \"string\" && config.inputKey) {\n    merged.inputKey = config.inputKey;\n  }\n\n  if (typeof config?.inputError === \"string\" && config.inputError) {\n    merged.inputError = config.inputError;\n  }\n\n  if (typeof config?.status === \"number\" && Number.isInteger(config.status)) {\n    merged.status = config.status;\n  }\n\n  return merged;\n}\n\n/**\n * The failed-validation response: `{ [errors]: [{ [inputKey]: string, [inputError]: string }] }`\n * under the configured status. The body is a shared component, emitted once.\n */\nexport function buildValidationFailedResponse(\n  shape: ValidationResponseShape,\n  registry: SchemaRegistry,\n): { status: string; response: OpenApiResponse } {\n  const ref = registry.shared(\"ValidationFailed\", {\n    type: \"object\",\n    properties: {\n      [shape.errors]: {\n        type: \"array\",\n        items: {\n          type: \"object\",\n          properties: {\n            [shape.inputKey]: { type: \"string\" },\n            [shape.inputError]: { type: \"string\" },\n          },\n          required: [shape.inputKey, shape.inputError],\n        },\n      },\n    },\n    required: [shape.errors],\n  });\n\n  return {\n    status: String(shape.status),\n    response: {\n      description: describeStatus(\"422\"),\n      content: { \"application/json\": { schema: ref } },\n    },\n  };\n}\n\n/**\n * The 401 response of a guarded route: the conventional `{ error: string }` body.\n */\nexport function buildUnauthorizedResponse(registry: SchemaRegistry): OpenApiResponse {\n  const ref = registry.shared(\"Unauthorized\", {\n    type: \"object\",\n    properties: { error: { type: \"string\" } },\n    required: [\"error\"],\n  });\n\n  return {\n    description: describeStatus(\"401\"),\n    content: { \"application/json\": { schema: ref } },\n  };\n}\n"],"mappings":";;;AAIA,MAAM,8BAA8B;CAClC,QAAQ;CACR,UAAU;CACV,YAAY;CACZ,QAAQ;AACV;;;;;AAQA,SAAgB,0BACd,QACyB;CACzB,MAAM,SAAS,EAAE,GAAG,4BAA4B;CAEhD,IAAI,OAAO,QAAQ,WAAW,YAAY,OAAO,QAC/C,OAAO,SAAS,OAAO;CAGzB,IAAI,OAAO,QAAQ,aAAa,YAAY,OAAO,UACjD,OAAO,WAAW,OAAO;CAG3B,IAAI,OAAO,QAAQ,eAAe,YAAY,OAAO,YACnD,OAAO,aAAa,OAAO;CAG7B,IAAI,OAAO,QAAQ,WAAW,YAAY,OAAO,UAAU,OAAO,MAAM,GACtE,OAAO,SAAS,OAAO;CAGzB,OAAO;AACT;;;;;AAMA,SAAgB,8BACd,OACA,UAC+C;CAC/C,MAAM,MAAM,SAAS,OAAO,oBAAoB;EAC9C,MAAM;EACN,YAAY,GACT,MAAM,SAAS;GACd,MAAM;GACN,OAAO;IACL,MAAM;IACN,YAAY;MACT,MAAM,WAAW,EAAE,MAAM,SAAS;MAClC,MAAM,aAAa,EAAE,MAAM,SAAS;IACvC;IACA,UAAU,CAAC,MAAM,UAAU,MAAM,UAAU;GAC7C;EACF,EACF;EACA,UAAU,CAAC,MAAM,MAAM;CACzB,CAAC;CAED,OAAO;EACL,QAAQ,OAAO,MAAM,MAAM;EAC3B,UAAU;GACR,aAAa,eAAe,KAAK;GACjC,SAAS,EAAE,oBAAoB,EAAE,QAAQ,IAAI,EAAE;EACjD;CACF;AACF;;;;AAKA,SAAgB,0BAA0B,UAA2C;CACnF,MAAM,MAAM,SAAS,OAAO,gBAAgB;EAC1C,MAAM;EACN,YAAY,EAAE,OAAO,EAAE,MAAM,SAAS,EAAE;EACxC,UAAU,CAAC,OAAO;CACpB,CAAC;CAED,OAAO;EACL,aAAa,eAAe,KAAK;EACjC,SAAS,EAAE,oBAAoB,EAAE,QAAQ,IAAI,EAAE;CACjD;AACF"}
+{"version":3,"file":"error-responses.mjs","names":[],"sources":["../../../../../../../../packages/core/src/openapi/error-responses.ts"],"sourcesContent":["import { describeStatus } from \"./response-schemas\";\nimport type { SchemaRegistry } from \"./schema-registry\";\nimport type { OpenApiResponse, OpenApiValidationResponseConfig } from \"./types\";\n\nconst DEFAULT_VALIDATION_RESPONSE = {\n  errors: \"errors\",\n  inputKey: \"input\",\n  inputError: \"error\",\n  status: 422,\n  /** A global `validation.response.body` hook replaces the framework body. */\n  customBody: false,\n};\n\nexport type ValidationResponseShape = typeof DEFAULT_VALIDATION_RESPONSE;\n\n/**\n * The `validation.response` config over its documented defaults, as `Response.failedSchema`\n * reads it.\n */\nexport function resolveValidationResponse(\n  config: OpenApiValidationResponseConfig | undefined,\n): ValidationResponseShape {\n  const merged = { ...DEFAULT_VALIDATION_RESPONSE };\n\n  if (typeof config?.errors === \"string\" && config.errors) {\n    merged.errors = config.errors;\n  }\n\n  if (typeof config?.inputKey === \"string\" && config.inputKey) {\n    merged.inputKey = config.inputKey;\n  }\n\n  if (typeof config?.inputError === \"string\" && config.inputError) {\n    merged.inputError = config.inputError;\n  }\n\n  if (typeof config?.status === \"number\" && Number.isInteger(config.status)) {\n    merged.status = config.status;\n  }\n\n  merged.customBody = typeof config?.body === \"function\";\n\n  return merged;\n}\n\n/**\n * The failed-validation response: `{ [errors]: [{ [inputKey]: string, [inputError]: string }] }`\n * under the configured status. The body is a shared component, emitted once.\n */\nexport function buildValidationFailedResponse(\n  shape: ValidationResponseShape,\n  registry: SchemaRegistry,\n): { status: string; response: OpenApiResponse } {\n  const ref = registry.shared(\"ValidationFailed\", {\n    type: \"object\",\n    properties: {\n      [shape.errors]: {\n        type: \"array\",\n        items: {\n          type: \"object\",\n          properties: {\n            [shape.inputKey]: { type: \"string\" },\n            [shape.inputError]: { type: \"string\" },\n          },\n          required: [shape.inputKey, shape.inputError],\n        },\n      },\n    },\n    required: [shape.errors],\n  });\n\n  return {\n    status: String(shape.status),\n    response: {\n      description: describeStatus(\"422\"),\n      content: { \"application/json\": { schema: ref } },\n    },\n  };\n}\n\n/**\n * The 401 response of a guarded route: the conventional `{ error: string }` body.\n */\nexport function buildUnauthorizedResponse(registry: SchemaRegistry): OpenApiResponse {\n  const ref = registry.shared(\"Unauthorized\", {\n    type: \"object\",\n    properties: { error: { type: \"string\" } },\n    required: [\"error\"],\n  });\n\n  return {\n    description: describeStatus(\"401\"),\n    content: { \"application/json\": { schema: ref } },\n  };\n}\n\n/**\n * The failed-validation response of a route whose failure body is customized, by its own\n * `validation.onFailure` or the global `validation.response.body` hook. The framework body\n * would be wrong here, so:\n *\n * - a status the handler's `responseSchema` declares documents the custom body as written;\n * - otherwise the configured failure status is documented without a body. A route hook may\n *   also change the status, so when the handler declares any 4xx entry of its own, those\n *   entries are trusted and nothing is added.\n *\n * Returns `undefined` when nothing should be added, and warns when a route hook's body is\n * left undocumented.\n */\nexport function buildCustomValidationFailedResponse(\n  shape: ValidationResponseShape,\n  declared: Readonly<Record<string, OpenApiResponse>>,\n  routeHook: boolean,\n  warn: (message: string) => void,\n): { status: string; response: OpenApiResponse } | undefined {\n  const status = String(shape.status);\n\n  if (declared[status]) {\n    return undefined;\n  }\n\n  if (routeHook && Object.keys(declared).some((code) => /^4\\d\\d$/.test(code))) {\n    return undefined;\n  }\n\n  if (routeHook) {\n    warn(\n      \"validation.onFailure customizes the failure response; declare its status and body in responseSchema to document it.\",\n    );\n  }\n\n  return { status, response: { description: describeStatus(status) } };\n}\n"],"mappings":";;;AAIA,MAAM,8BAA8B;CAClC,QAAQ;CACR,UAAU;CACV,YAAY;CACZ,QAAQ;;CAER,YAAY;AACd;;;;;AAQA,SAAgB,0BACd,QACyB;CACzB,MAAM,SAAS,EAAE,GAAG,4BAA4B;CAEhD,IAAI,OAAO,QAAQ,WAAW,YAAY,OAAO,QAC/C,OAAO,SAAS,OAAO;CAGzB,IAAI,OAAO,QAAQ,aAAa,YAAY,OAAO,UACjD,OAAO,WAAW,OAAO;CAG3B,IAAI,OAAO,QAAQ,eAAe,YAAY,OAAO,YACnD,OAAO,aAAa,OAAO;CAG7B,IAAI,OAAO,QAAQ,WAAW,YAAY,OAAO,UAAU,OAAO,MAAM,GACtE,OAAO,SAAS,OAAO;CAGzB,OAAO,aAAa,OAAO,QAAQ,SAAS;CAE5C,OAAO;AACT;;;;;AAMA,SAAgB,8BACd,OACA,UAC+C;CAC/C,MAAM,MAAM,SAAS,OAAO,oBAAoB;EAC9C,MAAM;EACN,YAAY,GACT,MAAM,SAAS;GACd,MAAM;GACN,OAAO;IACL,MAAM;IACN,YAAY;MACT,MAAM,WAAW,EAAE,MAAM,SAAS;MAClC,MAAM,aAAa,EAAE,MAAM,SAAS;IACvC;IACA,UAAU,CAAC,MAAM,UAAU,MAAM,UAAU;GAC7C;EACF,EACF;EACA,UAAU,CAAC,MAAM,MAAM;CACzB,CAAC;CAED,OAAO;EACL,QAAQ,OAAO,MAAM,MAAM;EAC3B,UAAU;GACR,aAAa,eAAe,KAAK;GACjC,SAAS,EAAE,oBAAoB,EAAE,QAAQ,IAAI,EAAE;EACjD;CACF;AACF;;;;AAKA,SAAgB,0BAA0B,UAA2C;CACnF,MAAM,MAAM,SAAS,OAAO,gBAAgB;EAC1C,MAAM;EACN,YAAY,EAAE,OAAO,EAAE,MAAM,SAAS,EAAE;EACxC,UAAU,CAAC,OAAO;CACpB,CAAC;CAED,OAAO;EACL,aAAa,eAAe,KAAK;EACjC,SAAS,EAAE,oBAAoB,EAAE,QAAQ,IAAI,EAAE;CACjD;AACF;;;;;;;;;;;;;;AAeA,SAAgB,oCACd,OACA,UACA,WACA,MAC2D;CAC3D,MAAM,SAAS,OAAO,MAAM,MAAM;CAElC,IAAI,SAAS,SACX;CAGF,IAAI,aAAa,OAAO,KAAK,QAAQ,CAAC,CAAC,MAAM,SAAS,UAAU,KAAK,IAAI,CAAC,GACxE;CAGF,IAAI,WACF,KACE,qHACF;CAGF,OAAO;EAAE;EAAQ,UAAU,EAAE,aAAa,eAAe,MAAM,EAAE;CAAE;AACrE"}

package/esm/openapi/postman/build-request-body.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"build-request-body.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/openapi/postman/build-request-body.ts"],"sourcesContent":["import type { OpenApiRequestBody, OpenApiSchema } from \"../types\";\nimport { exampleFromSchema } from \"./example-from-schema\";\nimport type { PostmanBody, PostmanFormParam } from \"./postman-types\";\nimport { isRecord, primaryType, resolveSchema, type SchemaComponents } from \"./schema-refs\";\n\nexport type RequestBodyParts = {\n  body: PostmanBody;\n  /** Set when the request needs an explicit `Content-Type` header; Postman adds the form ones itself. */\n  contentType?: string;\n};\n\nconst MULTIPART = \"multipart/form-data\";\nconst URL_ENCODED = \"application/x-www-form-urlencoded\";\n\nfunction isJsonContentType(contentType: string): boolean {\n  return contentType === \"application/json\" || contentType.endsWith(\"+json\");\n}\n\nfunction stringifyValue(value: unknown): string {\n  if (typeof value === \"string\") {\n    return value;\n  }\n\n  return isRecord(value) || Array.isArray(value) ? JSON.stringify(value) : String(value);\n}\n\nfunction isFileSchema(schema: OpenApiSchema, components: SchemaComponents): boolean {\n  const resolved = resolveSchema(schema, components);\n\n  if (resolved.format === \"binary\" || typeof resolved.contentMediaType === \"string\") {\n    return true;\n  }\n\n  return primaryType(resolved) === \"array\" && isRecord(resolved.items)\n    ? isFileSchema(resolved.items, components)\n    : false;\n}\n\nfunction formFields(schema: OpenApiSchema, components: SchemaComponents): PostmanFormParam[] {\n  const resolved = resolveSchema(schema, components);\n  const properties = isRecord(resolved.properties) ? resolved.properties : {};\n\n  return Object.entries(properties).flatMap(([key, property]): PostmanFormParam[] => {\n    if (!isRecord(property)) {\n      return [];\n    }\n\n    const description = typeof property.description === \"string\" ? { description: property.description } : {};\n\n    if (isFileSchema(property, components)) {\n      return [{ key, type: \"file\", src: [], ...description }];\n    }\n\n    return [{ key, value: stringifyValue(exampleFromSchema(property, components)), type: \"text\", ...description }];\n  });\n}\n\nfunction pickContentType(contentTypes: string[]): string | undefined {\n  return (\n    contentTypes.find(isJsonContentType) ??\n    contentTypes.find((contentType) => contentType === MULTIPART) ??\n    contentTypes.find((contentType) => contentType === URL_ENCODED) ??\n    contentTypes[0]\n  );\n}\n\n/**\n * The Postman body of an operation's request body: JSON becomes a raw JSON example, multipart\n * becomes `formdata` (binary properties as file rows), url-encoded becomes `urlencoded`.\n *\n * @returns `undefined` when the operation has no usable body.\n */\nexport function buildRequestBody(\n  requestBody: OpenApiRequestBody | undefined,\n  components: SchemaComponents,\n): RequestBodyParts | undefined {\n  if (!requestBody) {\n    return undefined;\n  }\n\n  const contentType = pickContentType(Object.keys(requestBody.content));\n  const schema = contentType !== undefined ? requestBody.content[contentType]?.schema : undefined;\n\n  if (contentType === undefined || schema === undefined) {\n    return undefined;\n  }\n\n  if (contentType === MULTIPART) {\n    return { body: { mode: \"formdata\", formdata: formFields(schema, components) } };\n  }\n\n  if (contentType === URL_ENCODED) {\n    const urlencoded = formFields(schema, components).flatMap((field) =>\n      field.type === \"text\" ? [{ key: field.key, value: field.value, type: \"text\" as const }] : [],\n    );\n\n    return { body: { mode: \"urlencoded\", urlencoded } };\n  }\n\n  const example = exampleFromSchema(schema, components);\n\n  if (isJsonContentType(contentType)) {\n    return {\n      contentType,\n      body: {\n        mode: \"raw\",\n        raw: JSON.stringify(example, null, 2),\n        options: { raw: { language: \"json\" } },\n      },\n    };\n  }\n\n  return {\n    contentType,\n    body: {\n      mode: \"raw\",\n      raw: typeof example === \"string\" ? example : \"\",\n      options: { raw: { language: \"text\" } },\n    },\n  };\n}\n"],"mappings":";;;;AAWA,MAAM,YAAY;AAClB,MAAM,cAAc;AAEpB,SAAS,kBAAkB,aAA8B;CACvD,OAAO,gBAAgB,sBAAsB,YAAY,SAAS,OAAO;AAC3E;AAEA,SAAS,eAAe,OAAwB;CAC9C,IAAI,OAAO,UAAU,UACnB,OAAO;CAGT,OAAO,SAAS,KAAK,KAAK,MAAM,QAAQ,KAAK,IAAI,KAAK,UAAU,KAAK,IAAI,OAAO,KAAK;AACvF;AAEA,SAAS,aAAa,QAAuB,YAAuC;CAClF,MAAM,WAAW,cAAc,QAAQ,UAAU;CAEjD,IAAI,SAAS,WAAW,YAAY,OAAO,SAAS,qBAAqB,UACvE,OAAO;CAGT,OAAO,YAAY,QAAQ,MAAM,WAAW,SAAS,SAAS,KAAK,IAC/D,aAAa,SAAS,OAAO,UAAU,IACvC;AACN;AAEA,SAAS,WAAW,QAAuB,YAAkD;CAC3F,MAAM,WAAW,cAAc,QAAQ,UAAU;CACjD,MAAM,aAAa,SAAS,SAAS,UAAU,IAAI,SAAS,aAAa,CAAC;CAE1E,OAAO,OAAO,QAAQ,UAAU,CAAC,CAAC,SAAS,CAAC,KAAK,cAAkC;EACjF,IAAI,CAAC,SAAS,QAAQ,GACpB,OAAO,CAAC;EAGV,MAAM,cAAc,OAAO,SAAS,gBAAgB,WAAW,EAAE,aAAa,SAAS,YAAY,IAAI,CAAC;EAExG,IAAI,aAAa,UAAU,UAAU,GACnC,OAAO,CAAC;GAAE;GAAK,MAAM;GAAQ,KAAK,CAAC;GAAG,GAAG;EAAY,CAAC;EAGxD,OAAO,CAAC;GAAE;GAAK,OAAO,eAAe,kBAAkB,UAAU,UAAU,CAAC;GAAG,MAAM;GAAQ,GAAG;EAAY,CAAC;CAC/G,CAAC;AACH;AAEA,SAAS,gBAAgB,cAA4C;CACnE,OACE,aAAa,KAAK,iBAAiB,KACnC,aAAa,MAAM,gBAAgB,gBAAgB,SAAS,KAC5D,aAAa,MAAM,gBAAgB,gBAAgB,WAAW,KAC9D,aAAa;AAEjB;;;;;;;AAQA,SAAgB,iBACd,aACA,YAC8B;CAC9B,IAAI,CAAC,aACH;CAGF,MAAM,cAAc,gBAAgB,OAAO,KAAK,YAAY,OAAO,CAAC;CACpE,MAAM,SAAS,gBAAgB,SAAY,YAAY,QAAQ,YAAY,EAAE,SAAS;CAEtF,IAAI,gBAAgB,UAAa,WAAW,QAC1C;CAGF,IAAI,gBAAgB,WAClB,OAAO,EAAE,MAAM;EAAE,MAAM;EAAY,UAAU,WAAW,QAAQ,UAAU;CAAE,EAAE;CAGhF,IAAI,gBAAgB,aAKlB,OAAO,EAAE,MAAM;EAAE,MAAM;EAAc,YAJlB,WAAW,QAAQ,UAAU,CAAC,CAAC,SAAS,UACzD,MAAM,SAAS,SAAS,CAAC;GAAE,KAAK,MAAM;GAAK,OAAO,MAAM;GAAO,MAAM;EAAgB,CAAC,IAAI,CAAC,CAG/C;CAAE,EAAE;CAGpD,MAAM,UAAU,kBAAkB,QAAQ,UAAU;CAEpD,IAAI,kBAAkB,WAAW,GAC/B,OAAO;EACL;EACA,MAAM;GACJ,MAAM;GACN,KAAK,KAAK,UAAU,SAAS,MAAM,CAAC;GACpC,SAAS,EAAE,KAAK,EAAE,UAAU,OAAO,EAAE;EACvC;CACF;CAGF,OAAO;EACL;EACA,MAAM;GACJ,MAAM;GACN,KAAK,OAAO,YAAY,WAAW,UAAU;GAC7C,SAAS,EAAE,KAAK,EAAE,UAAU,OAAO,EAAE;EACvC;CACF;AACF"}
+{"version":3,"file":"build-request-body.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/openapi/postman/build-request-body.ts"],"sourcesContent":["import type { OpenApiRequestBody, OpenApiSchema } from \"../types\";\nimport { exampleFromSchema } from \"./example-from-schema\";\nimport type { PostmanBody, PostmanFormParam } from \"./postman-types\";\nimport { isRecord, primaryType, resolveSchema, type SchemaComponents } from \"./schema-refs\";\n\nexport type RequestBodyParts = {\n  body: PostmanBody;\n  /** Set when the request needs an explicit `Content-Type` header; Postman adds the form ones itself. */\n  contentType?: string;\n};\n\nconst MULTIPART = \"multipart/form-data\";\nconst URL_ENCODED = \"application/x-www-form-urlencoded\";\n\nfunction isJsonContentType(contentType: string): boolean {\n  return contentType === \"application/json\" || contentType.endsWith(\"+json\");\n}\n\nfunction stringifyValue(value: unknown): string {\n  if (typeof value === \"string\") {\n    return value;\n  }\n\n  return isRecord(value) || Array.isArray(value) ? JSON.stringify(value) : String(value);\n}\n\nfunction isFileSchema(schema: OpenApiSchema, components: SchemaComponents): boolean {\n  const resolved = resolveSchema(schema, components);\n\n  if (resolved.format === \"binary\" || typeof resolved.contentMediaType === \"string\") {\n    return true;\n  }\n\n  return primaryType(resolved) === \"array\" && isRecord(resolved.items)\n    ? isFileSchema(resolved.items, components)\n    : false;\n}\n\nfunction formFields(schema: OpenApiSchema, components: SchemaComponents): PostmanFormParam[] {\n  const resolved = resolveSchema(schema, components);\n  const properties = isRecord(resolved.properties) ? resolved.properties : {};\n\n  return Object.entries(properties).flatMap(([key, property]): PostmanFormParam[] => {\n    if (!isRecord(property)) {\n      return [];\n    }\n\n    const description =\n      typeof property.description === \"string\" ? { description: property.description } : {};\n\n    if (isFileSchema(property, components)) {\n      return [{ key, type: \"file\", src: [], ...description }];\n    }\n\n    return [\n      {\n        key,\n        value: stringifyValue(exampleFromSchema(property, components)),\n        type: \"text\",\n        ...description,\n      },\n    ];\n  });\n}\n\nfunction pickContentType(contentTypes: string[]): string | undefined {\n  return (\n    contentTypes.find(isJsonContentType) ??\n    contentTypes.find((contentType) => contentType === MULTIPART) ??\n    contentTypes.find((contentType) => contentType === URL_ENCODED) ??\n    contentTypes[0]\n  );\n}\n\n/**\n * The Postman body of an operation's request body: JSON becomes a raw JSON example, multipart\n * becomes `formdata` (binary properties as file rows), url-encoded becomes `urlencoded`.\n *\n * @returns `undefined` when the operation has no usable body.\n */\nexport function buildRequestBody(\n  requestBody: OpenApiRequestBody | undefined,\n  components: SchemaComponents,\n): RequestBodyParts | undefined {\n  if (!requestBody) {\n    return undefined;\n  }\n\n  const contentType = pickContentType(Object.keys(requestBody.content));\n  const schema = contentType !== undefined ? requestBody.content[contentType]?.schema : undefined;\n\n  if (contentType === undefined || schema === undefined) {\n    return undefined;\n  }\n\n  if (contentType === MULTIPART) {\n    return { body: { mode: \"formdata\", formdata: formFields(schema, components) } };\n  }\n\n  if (contentType === URL_ENCODED) {\n    const urlencoded = formFields(schema, components).flatMap((field) =>\n      field.type === \"text\" ? [{ key: field.key, value: field.value, type: \"text\" as const }] : [],\n    );\n\n    return { body: { mode: \"urlencoded\", urlencoded } };\n  }\n\n  const example = exampleFromSchema(schema, components);\n\n  if (isJsonContentType(contentType)) {\n    return {\n      contentType,\n      body: {\n        mode: \"raw\",\n        raw: JSON.stringify(example, null, 2),\n        options: { raw: { language: \"json\" } },\n      },\n    };\n  }\n\n  return {\n    contentType,\n    body: {\n      mode: \"raw\",\n      raw: typeof example === \"string\" ? example : \"\",\n      options: { raw: { language: \"text\" } },\n    },\n  };\n}\n"],"mappings":";;;;AAWA,MAAM,YAAY;AAClB,MAAM,cAAc;AAEpB,SAAS,kBAAkB,aAA8B;CACvD,OAAO,gBAAgB,sBAAsB,YAAY,SAAS,OAAO;AAC3E;AAEA,SAAS,eAAe,OAAwB;CAC9C,IAAI,OAAO,UAAU,UACnB,OAAO;CAGT,OAAO,SAAS,KAAK,KAAK,MAAM,QAAQ,KAAK,IAAI,KAAK,UAAU,KAAK,IAAI,OAAO,KAAK;AACvF;AAEA,SAAS,aAAa,QAAuB,YAAuC;CAClF,MAAM,WAAW,cAAc,QAAQ,UAAU;CAEjD,IAAI,SAAS,WAAW,YAAY,OAAO,SAAS,qBAAqB,UACvE,OAAO;CAGT,OAAO,YAAY,QAAQ,MAAM,WAAW,SAAS,SAAS,KAAK,IAC/D,aAAa,SAAS,OAAO,UAAU,IACvC;AACN;AAEA,SAAS,WAAW,QAAuB,YAAkD;CAC3F,MAAM,WAAW,cAAc,QAAQ,UAAU;CACjD,MAAM,aAAa,SAAS,SAAS,UAAU,IAAI,SAAS,aAAa,CAAC;CAE1E,OAAO,OAAO,QAAQ,UAAU,CAAC,CAAC,SAAS,CAAC,KAAK,cAAkC;EACjF,IAAI,CAAC,SAAS,QAAQ,GACpB,OAAO,CAAC;EAGV,MAAM,cACJ,OAAO,SAAS,gBAAgB,WAAW,EAAE,aAAa,SAAS,YAAY,IAAI,CAAC;EAEtF,IAAI,aAAa,UAAU,UAAU,GACnC,OAAO,CAAC;GAAE;GAAK,MAAM;GAAQ,KAAK,CAAC;GAAG,GAAG;EAAY,CAAC;EAGxD,OAAO,CACL;GACE;GACA,OAAO,eAAe,kBAAkB,UAAU,UAAU,CAAC;GAC7D,MAAM;GACN,GAAG;EACL,CACF;CACF,CAAC;AACH;AAEA,SAAS,gBAAgB,cAA4C;CACnE,OACE,aAAa,KAAK,iBAAiB,KACnC,aAAa,MAAM,gBAAgB,gBAAgB,SAAS,KAC5D,aAAa,MAAM,gBAAgB,gBAAgB,WAAW,KAC9D,aAAa;AAEjB;;;;;;;AAQA,SAAgB,iBACd,aACA,YAC8B;CAC9B,IAAI,CAAC,aACH;CAGF,MAAM,cAAc,gBAAgB,OAAO,KAAK,YAAY,OAAO,CAAC;CACpE,MAAM,SAAS,gBAAgB,SAAY,YAAY,QAAQ,YAAY,EAAE,SAAS;CAEtF,IAAI,gBAAgB,UAAa,WAAW,QAC1C;CAGF,IAAI,gBAAgB,WAClB,OAAO,EAAE,MAAM;EAAE,MAAM;EAAY,UAAU,WAAW,QAAQ,UAAU;CAAE,EAAE;CAGhF,IAAI,gBAAgB,aAKlB,OAAO,EAAE,MAAM;EAAE,MAAM;EAAc,YAJlB,WAAW,QAAQ,UAAU,CAAC,CAAC,SAAS,UACzD,MAAM,SAAS,SAAS,CAAC;GAAE,KAAK,MAAM;GAAK,OAAO,MAAM;GAAO,MAAM;EAAgB,CAAC,IAAI,CAAC,CAG/C;CAAE,EAAE;CAGpD,MAAM,UAAU,kBAAkB,QAAQ,UAAU;CAEpD,IAAI,kBAAkB,WAAW,GAC/B,OAAO;EACL;EACA,MAAM;GACJ,MAAM;GACN,KAAK,KAAK,UAAU,SAAS,MAAM,CAAC;GACpC,SAAS,EAAE,KAAK,EAAE,UAAU,OAAO,EAAE;EACvC;CACF;CAGF,OAAO;EACL;EACA,MAAM;GACJ,MAAM;GACN,KAAK,OAAO,YAAY,WAAW,UAAU;GAC7C,SAAS,EAAE,KAAK,EAAE,UAAU,OAAO,EAAE;EACvC;CACF;AACF"}

package/esm/openapi/postman/build-request-url.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"build-request-url.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/openapi/postman/build-request-url.ts"],"sourcesContent":["import type { OpenApiParameter, OpenApiSchema } from \"../types\";\nimport { isRecord, resolveSchema, type SchemaComponents } from \"./schema-refs\";\nimport type { PostmanHeader, PostmanQueryParam, PostmanUrl, PostmanVariable } from \"./postman-types\";\n\n/** The Postman variable every request URL starts with. */\nexport const BASE_URL_HOST = \"{{baseUrl}}\";\n\nconst PATH_TEMPLATE_PARAM = /\\{([^}]+)\\}/g;\n\nfunction stringifyValue(value: unknown): string {\n  if (typeof value === \"string\") {\n    return value;\n  }\n\n  return isRecord(value) || Array.isArray(value) ? JSON.stringify(value) : String(value);\n}\n\n/**\n * Value a parameter starts with in Postman: its declared `example`, `default`, `const` or\n * first `enum` value, otherwise empty so the caller fills it in.\n */\nfunction parameterValue(schema: OpenApiSchema, components: SchemaComponents): string {\n  const resolved = resolveSchema(schema, components);\n\n  for (const key of [\"example\", \"default\", \"const\"]) {\n    if (key in resolved) {\n      return stringifyValue(resolved[key]);\n    }\n  }\n\n  if (Array.isArray(resolved.enum) && resolved.enum.length > 0) {\n    return stringifyValue(resolved.enum[0]);\n  }\n\n  return \"\";\n}\n\nfunction withDescription<T extends object>(row: T, parameter: OpenApiParameter): T & { description?: string } {\n  return parameter.description ? { ...row, description: parameter.description } : row;\n}\n\nfunction queryRows(parameter: OpenApiParameter, components: SchemaComponents): PostmanQueryParam[] {\n  const disabled = parameter.required === true ? {} : { disabled: true as const };\n  const schema = resolveSchema(parameter.schema, components);\n\n  if (parameter.style === \"deepObject\" && isRecord(schema.properties)) {\n    return Object.entries(schema.properties).map(([property, propertySchema]) => ({\n      key: `${parameter.name}[${property}]`,\n      value: isRecord(propertySchema) ? parameterValue(propertySchema, components) : \"\",\n      ...disabled,\n    }));\n  }\n\n  return [\n    {\n      key: parameter.name,\n      value: parameterValue(parameter.schema, components),\n      ...(parameter.description ? { description: parameter.description } : {}),\n      ...disabled,\n    },\n  ];\n}\n\n/**\n * Header rows for the `header` parameters of an operation. Optional ones start disabled.\n */\nexport function buildHeaderParameters(\n  parameters: readonly OpenApiParameter[],\n  components: SchemaComponents,\n): PostmanHeader[] {\n  return parameters\n    .filter((parameter) => parameter.in === \"header\")\n    .map((parameter) =>\n      withDescription(\n        {\n          key: parameter.name,\n          value: parameterValue(parameter.schema, components),\n          ...(parameter.required === true ? {} : { disabled: true as const }),\n        },\n        parameter,\n      ),\n    );\n}\n\n/**\n * The Postman URL of an operation: `{id}` templates become `:id` path variables, query\n * parameters become rows (optional ones disabled, so `raw` carries only the enabled ones).\n */\nexport function buildRequestUrl(\n  path: string,\n  parameters: readonly OpenApiParameter[],\n  components: SchemaComponents,\n): PostmanUrl {\n  const segments = path\n    .split(\"/\")\n    .filter((segment) => segment.length > 0)\n    .map((segment) => segment.replace(PATH_TEMPLATE_PARAM, \":$1\"));\n\n  const variables: PostmanVariable[] = [...path.matchAll(PATH_TEMPLATE_PARAM)].flatMap((match) => {\n    const name = match[1];\n\n    if (name === undefined) {\n      return [];\n    }\n\n    const description = parameters.find((parameter) => parameter.in === \"path\" && parameter.name === name)\n      ?.description;\n\n    return [{ key: name, value: \"\", ...(description ? { description } : {}) }];\n  });\n\n  const query = parameters\n    .filter((parameter) => parameter.in === \"query\")\n    .flatMap((parameter) => queryRows(parameter, components));\n\n  const search = query\n    .filter((row) => row.disabled !== true)\n    .map((row) => `${row.key}=${row.value}`)\n    .join(\"&\");\n\n  return {\n    raw: `${BASE_URL_HOST}/${segments.join(\"/\")}${search ? `?${search}` : \"\"}`,\n    host: [BASE_URL_HOST],\n    path: segments,\n    ...(variables.length > 0 ? { variable: variables } : {}),\n    ...(query.length > 0 ? { query } : {}),\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"build-request-url.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/openapi/postman/build-request-url.ts"],"sourcesContent":["import type { OpenApiParameter, OpenApiSchema } from \"../types\";\nimport { isRecord, resolveSchema, type SchemaComponents } from \"./schema-refs\";\nimport type {\n  PostmanHeader,\n  PostmanQueryParam,\n  PostmanUrl,\n  PostmanVariable,\n} from \"./postman-types\";\n\n/** The Postman variable every request URL starts with. */\nexport const BASE_URL_HOST = \"{{baseUrl}}\";\n\nconst PATH_TEMPLATE_PARAM = /\\{([^}]+)\\}/g;\n\nfunction stringifyValue(value: unknown): string {\n  if (typeof value === \"string\") {\n    return value;\n  }\n\n  return isRecord(value) || Array.isArray(value) ? JSON.stringify(value) : String(value);\n}\n\n/**\n * Value a parameter starts with in Postman: its declared `example`, `default`, `const` or\n * first `enum` value, otherwise empty so the caller fills it in.\n */\nfunction parameterValue(schema: OpenApiSchema, components: SchemaComponents): string {\n  const resolved = resolveSchema(schema, components);\n\n  for (const key of [\"example\", \"default\", \"const\"]) {\n    if (key in resolved) {\n      return stringifyValue(resolved[key]);\n    }\n  }\n\n  if (Array.isArray(resolved.enum) && resolved.enum.length > 0) {\n    return stringifyValue(resolved.enum[0]);\n  }\n\n  return \"\";\n}\n\nfunction withDescription<T extends object>(\n  row: T,\n  parameter: OpenApiParameter,\n): T & { description?: string } {\n  return parameter.description ? { ...row, description: parameter.description } : row;\n}\n\nfunction queryRows(parameter: OpenApiParameter, components: SchemaComponents): PostmanQueryParam[] {\n  const disabled = parameter.required === true ? {} : { disabled: true as const };\n  const schema = resolveSchema(parameter.schema, components);\n\n  if (parameter.style === \"deepObject\" && isRecord(schema.properties)) {\n    return Object.entries(schema.properties).map(([property, propertySchema]) => ({\n      key: `${parameter.name}[${property}]`,\n      value: isRecord(propertySchema) ? parameterValue(propertySchema, components) : \"\",\n      ...disabled,\n    }));\n  }\n\n  return [\n    {\n      key: parameter.name,\n      value: parameterValue(parameter.schema, components),\n      ...(parameter.description ? { description: parameter.description } : {}),\n      ...disabled,\n    },\n  ];\n}\n\n/**\n * Header rows for the `header` parameters of an operation. Optional ones start disabled.\n */\nexport function buildHeaderParameters(\n  parameters: readonly OpenApiParameter[],\n  components: SchemaComponents,\n): PostmanHeader[] {\n  return parameters\n    .filter((parameter) => parameter.in === \"header\")\n    .map((parameter) =>\n      withDescription(\n        {\n          key: parameter.name,\n          value: parameterValue(parameter.schema, components),\n          ...(parameter.required === true ? {} : { disabled: true as const }),\n        },\n        parameter,\n      ),\n    );\n}\n\n/**\n * The Postman URL of an operation: `{id}` templates become `:id` path variables, query\n * parameters become rows (optional ones disabled, so `raw` carries only the enabled ones).\n */\nexport function buildRequestUrl(\n  path: string,\n  parameters: readonly OpenApiParameter[],\n  components: SchemaComponents,\n): PostmanUrl {\n  const segments = path\n    .split(\"/\")\n    .filter((segment) => segment.length > 0)\n    .map((segment) => segment.replace(PATH_TEMPLATE_PARAM, \":$1\"));\n\n  const variables: PostmanVariable[] = [...path.matchAll(PATH_TEMPLATE_PARAM)].flatMap((match) => {\n    const name = match[1];\n\n    if (name === undefined) {\n      return [];\n    }\n\n    const description = parameters.find(\n      (parameter) => parameter.in === \"path\" && parameter.name === name,\n    )?.description;\n\n    return [{ key: name, value: \"\", ...(description ? { description } : {}) }];\n  });\n\n  const query = parameters\n    .filter((parameter) => parameter.in === \"query\")\n    .flatMap((parameter) => queryRows(parameter, components));\n\n  const search = query\n    .filter((row) => row.disabled !== true)\n    .map((row) => `${row.key}=${row.value}`)\n    .join(\"&\");\n\n  return {\n    raw: `${BASE_URL_HOST}/${segments.join(\"/\")}${search ? `?${search}` : \"\"}`,\n    host: [BASE_URL_HOST],\n    path: segments,\n    ...(variables.length > 0 ? { variable: variables } : {}),\n    ...(query.length > 0 ? { query } : {}),\n  };\n}\n"],"mappings":"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"}

package/esm/openapi/postman/build-saved-responses.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"build-saved-responses.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/openapi/postman/build-saved-responses.ts"],"sourcesContent":["import type { OpenApiOperation } from \"../types\";\nimport { exampleFromSchema } from \"./example-from-schema\";\nimport { httpStatusText } from \"./http-status-text\";\nimport type { PostmanHeader, PostmanOriginalRequest, PostmanResponse } from \"./postman-types\";\nimport type { SchemaComponents } from \"./schema-refs\";\n\ntype PreviewLanguage = PostmanResponse[\"_postman_previewlanguage\"];\n\nfunction previewLanguage(contentType: string): PreviewLanguage {\n  if (contentType === \"application/json\" || contentType.endsWith(\"+json\")) {\n    return \"json\";\n  }\n\n  return contentType === \"text/html\" ? \"html\" : \"text\";\n}\n\nfunction stringExample(example: unknown): string {\n  return typeof example === \"string\" ? example : \"\";\n}\n\nfunction responseBody(\n  content: NonNullable<OpenApiOperation[\"responses\"][string][\"content\"]>,\n  components: SchemaComponents,\n): { body: string; header: PostmanHeader[]; language: PreviewLanguage } {\n  const contentTypes = Object.keys(content);\n  const contentType = contentTypes.find((type) => previewLanguage(type) === \"json\") ?? contentTypes[0];\n  const schema = contentType !== undefined ? content[contentType]?.schema : undefined;\n\n  if (contentType === undefined || schema === undefined) {\n    return { body: \"\", header: [], language: \"text\" };\n  }\n\n  const language = previewLanguage(contentType);\n  const example = exampleFromSchema(schema, components);\n  const body = language === \"json\" ? JSON.stringify(example, null, 2) : stringExample(example);\n\n  return { body, header: [{ key: \"Content-Type\", value: contentType, type: \"text\" }], language };\n}\n\n/**\n * One saved Postman response per declared numeric status, with an example body from the\n * response schema. `default` and range keys (`2XX`) have no single status code and are skipped.\n */\nexport function buildSavedResponses(\n  responses: OpenApiOperation[\"responses\"],\n  originalRequest: PostmanOriginalRequest,\n  components: SchemaComponents,\n): PostmanResponse[] {\n  return Object.entries(responses).flatMap(([status, response]): PostmanResponse[] => {\n    if (!/^\\d{3}$/.test(status)) {\n      return [];\n    }\n\n    const code = Number(status);\n    const { body, header, language } = response.content\n      ? responseBody(response.content, components)\n      : { body: \"\", header: [], language: \"text\" as const };\n\n    return [\n      {\n        name: `${status} ${response.description}`,\n        originalRequest,\n        status: httpStatusText(code, response.description),\n        code,\n        _postman_previewlanguage: language,\n        header,\n        body,\n      },\n    ];\n  });\n}\n"],"mappings":";;;;AAQA,SAAS,gBAAgB,aAAsC;CAC7D,IAAI,gBAAgB,sBAAsB,YAAY,SAAS,OAAO,GACpE,OAAO;CAGT,OAAO,gBAAgB,cAAc,SAAS;AAChD;AAEA,SAAS,cAAc,SAA0B;CAC/C,OAAO,OAAO,YAAY,WAAW,UAAU;AACjD;AAEA,SAAS,aACP,SACA,YACsE;CACtE,MAAM,eAAe,OAAO,KAAK,OAAO;CACxC,MAAM,cAAc,aAAa,MAAM,SAAS,gBAAgB,IAAI,MAAM,MAAM,KAAK,aAAa;CAClG,MAAM,SAAS,gBAAgB,SAAY,QAAQ,YAAY,EAAE,SAAS;CAE1E,IAAI,gBAAgB,UAAa,WAAW,QAC1C,OAAO;EAAE,MAAM;EAAI,QAAQ,CAAC;EAAG,UAAU;CAAO;CAGlD,MAAM,WAAW,gBAAgB,WAAW;CAC5C,MAAM,UAAU,kBAAkB,QAAQ,UAAU;CAGpD,OAAO;EAAE,MAFI,aAAa,SAAS,KAAK,UAAU,SAAS,MAAM,CAAC,IAAI,cAAc,OAAO;EAE5E,QAAQ,CAAC;GAAE,KAAK;GAAgB,OAAO;GAAa,MAAM;EAAO,CAAC;EAAG;CAAS;AAC/F;;;;;AAMA,SAAgB,oBACd,WACA,iBACA,YACmB;CACnB,OAAO,OAAO,QAAQ,SAAS,CAAC,CAAC,SAAS,CAAC,QAAQ,cAAiC;EAClF,IAAI,CAAC,UAAU,KAAK,MAAM,GACxB,OAAO,CAAC;EAGV,MAAM,OAAO,OAAO,MAAM;EAC1B,MAAM,EAAE,MAAM,QAAQ,aAAa,SAAS,UACxC,aAAa,SAAS,SAAS,UAAU,IACzC;GAAE,MAAM;GAAI,QAAQ,CAAC;GAAG,UAAU;EAAgB;EAEtD,OAAO,CACL;GACE,MAAM,GAAG,OAAO,GAAG,SAAS;GAC5B;GACA,QAAQ,eAAe,MAAM,SAAS,WAAW;GACjD;GACA,0BAA0B;GAC1B;GACA;EACF,CACF;CACF,CAAC;AACH"}
+{"version":3,"file":"build-saved-responses.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/openapi/postman/build-saved-responses.ts"],"sourcesContent":["import type { OpenApiOperation } from \"../types\";\nimport { exampleFromSchema } from \"./example-from-schema\";\nimport { httpStatusText } from \"./http-status-text\";\nimport type { PostmanHeader, PostmanOriginalRequest, PostmanResponse } from \"./postman-types\";\nimport type { SchemaComponents } from \"./schema-refs\";\n\ntype PreviewLanguage = PostmanResponse[\"_postman_previewlanguage\"];\n\nfunction previewLanguage(contentType: string): PreviewLanguage {\n  if (contentType === \"application/json\" || contentType.endsWith(\"+json\")) {\n    return \"json\";\n  }\n\n  return contentType === \"text/html\" ? \"html\" : \"text\";\n}\n\nfunction stringExample(example: unknown): string {\n  return typeof example === \"string\" ? example : \"\";\n}\n\nfunction responseBody(\n  content: NonNullable<OpenApiOperation[\"responses\"][string][\"content\"]>,\n  components: SchemaComponents,\n): { body: string; header: PostmanHeader[]; language: PreviewLanguage } {\n  const contentTypes = Object.keys(content);\n  const contentType =\n    contentTypes.find((type) => previewLanguage(type) === \"json\") ?? contentTypes[0];\n  const schema = contentType !== undefined ? content[contentType]?.schema : undefined;\n\n  if (contentType === undefined || schema === undefined) {\n    return { body: \"\", header: [], language: \"text\" };\n  }\n\n  const language = previewLanguage(contentType);\n  const example = exampleFromSchema(schema, components);\n  const body = language === \"json\" ? JSON.stringify(example, null, 2) : stringExample(example);\n\n  return { body, header: [{ key: \"Content-Type\", value: contentType, type: \"text\" }], language };\n}\n\n/**\n * One saved Postman response per declared numeric status, with an example body from the\n * response schema. `default` and range keys (`2XX`) have no single status code and are skipped.\n */\nexport function buildSavedResponses(\n  responses: OpenApiOperation[\"responses\"],\n  originalRequest: PostmanOriginalRequest,\n  components: SchemaComponents,\n): PostmanResponse[] {\n  return Object.entries(responses).flatMap(([status, response]): PostmanResponse[] => {\n    if (!/^\\d{3}$/.test(status)) {\n      return [];\n    }\n\n    const code = Number(status);\n    const { body, header, language } = response.content\n      ? responseBody(response.content, components)\n      : { body: \"\", header: [], language: \"text\" as const };\n\n    return [\n      {\n        name: `${status} ${response.description}`,\n        originalRequest,\n        status: httpStatusText(code, response.description),\n        code,\n        _postman_previewlanguage: language,\n        header,\n        body,\n      },\n    ];\n  });\n}\n"],"mappings":";;;;AAQA,SAAS,gBAAgB,aAAsC;CAC7D,IAAI,gBAAgB,sBAAsB,YAAY,SAAS,OAAO,GACpE,OAAO;CAGT,OAAO,gBAAgB,cAAc,SAAS;AAChD;AAEA,SAAS,cAAc,SAA0B;CAC/C,OAAO,OAAO,YAAY,WAAW,UAAU;AACjD;AAEA,SAAS,aACP,SACA,YACsE;CACtE,MAAM,eAAe,OAAO,KAAK,OAAO;CACxC,MAAM,cACJ,aAAa,MAAM,SAAS,gBAAgB,IAAI,MAAM,MAAM,KAAK,aAAa;CAChF,MAAM,SAAS,gBAAgB,SAAY,QAAQ,YAAY,EAAE,SAAS;CAE1E,IAAI,gBAAgB,UAAa,WAAW,QAC1C,OAAO;EAAE,MAAM;EAAI,QAAQ,CAAC;EAAG,UAAU;CAAO;CAGlD,MAAM,WAAW,gBAAgB,WAAW;CAC5C,MAAM,UAAU,kBAAkB,QAAQ,UAAU;CAGpD,OAAO;EAAE,MAFI,aAAa,SAAS,KAAK,UAAU,SAAS,MAAM,CAAC,IAAI,cAAc,OAAO;EAE5E,QAAQ,CAAC;GAAE,KAAK;GAAgB,OAAO;GAAa,MAAM;EAAO,CAAC;EAAG;CAAS;AAC/F;;;;;AAMA,SAAgB,oBACd,WACA,iBACA,YACmB;CACnB,OAAO,OAAO,QAAQ,SAAS,CAAC,CAAC,SAAS,CAAC,QAAQ,cAAiC;EAClF,IAAI,CAAC,UAAU,KAAK,MAAM,GACxB,OAAO,CAAC;EAGV,MAAM,OAAO,OAAO,MAAM;EAC1B,MAAM,EAAE,MAAM,QAAQ,aAAa,SAAS,UACxC,aAAa,SAAS,SAAS,UAAU,IACzC;GAAE,MAAM;GAAI,QAAQ,CAAC;GAAG,UAAU;EAAgB;EAEtD,OAAO,CACL;GACE,MAAM,GAAG,OAAO,GAAG,SAAS;GAC5B;GACA,QAAQ,eAAe,MAAM,SAAS,WAAW;GACjD;GACA,0BAA0B;GAC1B;GACA;EACF,CACF;CACF,CAAC;AACH"}

package/esm/openapi/postman/example-from-schema.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"example-from-schema.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/openapi/postman/example-from-schema.ts"],"mappings":";;;;;;AAgJA;;;;;;;iBAAgB,iBAAA,CAAkB,MAAA,EAAQ,aAAA,EAAe,UAAA,GAAa,gBAAgB"}
+{"version":3,"file":"example-from-schema.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/openapi/postman/example-from-schema.ts"],"mappings":";;;;;;AA2JA;;;;;;;iBAAgB,iBAAA,CAAkB,MAAA,EAAQ,aAAA,EAAe,UAAA,GAAa,gBAAgB"}

package/esm/openapi/postman/example-from-schema.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"example-from-schema.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/openapi/postman/example-from-schema.ts"],"sourcesContent":["import type { OpenApiSchema } from \"../types\";\nimport { isRecord, primaryType, refName, resolveSchema, type SchemaComponents } from \"./schema-refs\";\n\nconst STRING_FORMAT_EXAMPLES: Record<string, string> = {\n  email: \"user@example.com\",\n  \"date-time\": \"2024-01-01T00:00:00.000Z\",\n  date: \"2024-01-01\",\n  time: \"00:00:00\",\n  uri: \"https://example.com\",\n  url: \"https://example.com\",\n  iri: \"https://example.com\",\n  uuid: \"00000000-0000-4000-8000-000000000000\",\n  hostname: \"example.com\",\n  ipv4: \"127.0.0.1\",\n  ipv6: \"::1\",\n};\n\nfunction numberExample(schema: OpenApiSchema): number {\n  if (typeof schema.minimum === \"number\" && schema.minimum > 0) {\n    return schema.minimum;\n  }\n\n  if (typeof schema.maximum === \"number\" && schema.maximum < 0) {\n    return schema.maximum;\n  }\n\n  return 0;\n}\n\nfunction stringExample(schema: OpenApiSchema): string {\n  const format = typeof schema.format === \"string\" ? schema.format : undefined;\n\n  return (format !== undefined ? STRING_FORMAT_EXAMPLES[format] : undefined) ?? \"string\";\n}\n\nfunction isNullBranch(branch: unknown, components: SchemaComponents): boolean {\n  return isRecord(branch) && primaryType(resolveSchema(branch, components)) === \"null\";\n}\n\nfunction mergeExamples(parts: unknown[]): unknown {\n  const objects = parts.filter(isRecord);\n\n  if (objects.length === parts.length) {\n    return Object.assign({}, ...objects);\n  }\n\n  return parts[parts.length - 1] ?? null;\n}\n\n/**\n * `undefined` marks a `$ref` cycle: the caller omits the property, or yields an empty array.\n */\nfunction generate(schema: unknown, components: SchemaComponents, stack: readonly string[]): unknown {\n  if (!isRecord(schema)) {\n    return null;\n  }\n\n  const name = refName(schema);\n\n  if (name !== undefined) {\n    const target = components?.[name];\n\n    if (stack.includes(name)) {\n      return undefined;\n    }\n\n    return target ? generate(target, components, [...stack, name]) : null;\n  }\n\n  if (\"example\" in schema) {\n    return schema.example;\n  }\n\n  if (\"const\" in schema) {\n    return schema.const;\n  }\n\n  if (\"default\" in schema) {\n    return schema.default;\n  }\n\n  if (Array.isArray(schema.enum) && schema.enum.length > 0) {\n    return schema.enum[0];\n  }\n\n  if (Array.isArray(schema.examples) && schema.examples.length > 0) {\n    return schema.examples[0];\n  }\n\n  for (const key of [\"oneOf\", \"anyOf\"] as const) {\n    const branches = schema[key];\n\n    if (Array.isArray(branches) && branches.length > 0) {\n      const branch = branches.find((candidate) => !isNullBranch(candidate, components)) ?? branches[0];\n\n      return generate(branch, components, stack);\n    }\n  }\n\n  if (Array.isArray(schema.allOf) && schema.allOf.length > 0) {\n    return mergeExamples(schema.allOf.map((part) => generate(part, components, stack)));\n  }\n\n  switch (primaryType(schema)) {\n    case \"string\":\n      return stringExample(schema);\n    case \"number\":\n    case \"integer\":\n      return numberExample(schema);\n    case \"boolean\":\n      return false;\n    case \"array\": {\n      const item = generate(schema.items, components, stack);\n\n      return item === undefined ? [] : [item];\n    }\n    case \"object\": {\n      const result: Record<string, unknown> = {};\n      const properties = isRecord(schema.properties) ? schema.properties : {};\n\n      for (const [key, property] of Object.entries(properties)) {\n        const value = generate(property, components, stack);\n\n        if (value !== undefined) {\n          result[key] = value;\n        }\n      }\n\n      return result;\n    }\n    default:\n      return null;\n  }\n}\n\n/**\n * A deterministic example value for a JSON Schema.\n *\n * Explicit `example`, `const`, `default`, `enum[0]` and `examples[0]` win, in that order;\n * otherwise a type sample is produced (format-aware strings, `0`, `false`, one array item,\n * every object property). `$ref`s resolve against `components`; a cyclic reference is cut\n * (the property is omitted, an array of it is empty). A nullable union yields its non-null\n * branch. A schema with no usable type is `null`.\n */\nexport function exampleFromSchema(schema: OpenApiSchema, components?: SchemaComponents): unknown {\n  const value = generate(schema, components, []);\n\n  return value === undefined ? null : value;\n}\n"],"mappings":"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"}
+{"version":3,"file":"example-from-schema.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/openapi/postman/example-from-schema.ts"],"sourcesContent":["import type { OpenApiSchema } from \"../types\";\nimport {\n  isRecord,\n  primaryType,\n  refName,\n  resolveSchema,\n  type SchemaComponents,\n} from \"./schema-refs\";\n\nconst STRING_FORMAT_EXAMPLES: Record<string, string> = {\n  email: \"user@example.com\",\n  \"date-time\": \"2024-01-01T00:00:00.000Z\",\n  date: \"2024-01-01\",\n  time: \"00:00:00\",\n  uri: \"https://example.com\",\n  url: \"https://example.com\",\n  iri: \"https://example.com\",\n  uuid: \"00000000-0000-4000-8000-000000000000\",\n  hostname: \"example.com\",\n  ipv4: \"127.0.0.1\",\n  ipv6: \"::1\",\n};\n\nfunction numberExample(schema: OpenApiSchema): number {\n  if (typeof schema.minimum === \"number\" && schema.minimum > 0) {\n    return schema.minimum;\n  }\n\n  if (typeof schema.maximum === \"number\" && schema.maximum < 0) {\n    return schema.maximum;\n  }\n\n  return 0;\n}\n\nfunction stringExample(schema: OpenApiSchema): string {\n  const format = typeof schema.format === \"string\" ? schema.format : undefined;\n\n  return (format !== undefined ? STRING_FORMAT_EXAMPLES[format] : undefined) ?? \"string\";\n}\n\nfunction isNullBranch(branch: unknown, components: SchemaComponents): boolean {\n  return isRecord(branch) && primaryType(resolveSchema(branch, components)) === \"null\";\n}\n\nfunction mergeExamples(parts: unknown[]): unknown {\n  const objects = parts.filter(isRecord);\n\n  if (objects.length === parts.length) {\n    return Object.assign({}, ...objects);\n  }\n\n  return parts[parts.length - 1] ?? null;\n}\n\n/**\n * `undefined` marks a `$ref` cycle: the caller omits the property, or yields an empty array.\n */\nfunction generate(\n  schema: unknown,\n  components: SchemaComponents,\n  stack: readonly string[],\n): unknown {\n  if (!isRecord(schema)) {\n    return null;\n  }\n\n  const name = refName(schema);\n\n  if (name !== undefined) {\n    const target = components?.[name];\n\n    if (stack.includes(name)) {\n      return undefined;\n    }\n\n    return target ? generate(target, components, [...stack, name]) : null;\n  }\n\n  if (\"example\" in schema) {\n    return schema.example;\n  }\n\n  if (\"const\" in schema) {\n    return schema.const;\n  }\n\n  if (\"default\" in schema) {\n    return schema.default;\n  }\n\n  if (Array.isArray(schema.enum) && schema.enum.length > 0) {\n    return schema.enum[0];\n  }\n\n  if (Array.isArray(schema.examples) && schema.examples.length > 0) {\n    return schema.examples[0];\n  }\n\n  for (const key of [\"oneOf\", \"anyOf\"] as const) {\n    const branches = schema[key];\n\n    if (Array.isArray(branches) && branches.length > 0) {\n      const branch =\n        branches.find((candidate) => !isNullBranch(candidate, components)) ?? branches[0];\n\n      return generate(branch, components, stack);\n    }\n  }\n\n  if (Array.isArray(schema.allOf) && schema.allOf.length > 0) {\n    return mergeExamples(schema.allOf.map((part) => generate(part, components, stack)));\n  }\n\n  switch (primaryType(schema)) {\n    case \"string\":\n      return stringExample(schema);\n    case \"number\":\n    case \"integer\":\n      return numberExample(schema);\n    case \"boolean\":\n      return false;\n    case \"array\": {\n      const item = generate(schema.items, components, stack);\n\n      return item === undefined ? [] : [item];\n    }\n    case \"object\": {\n      const result: Record<string, unknown> = {};\n      const properties = isRecord(schema.properties) ? schema.properties : {};\n\n      for (const [key, property] of Object.entries(properties)) {\n        const value = generate(property, components, stack);\n\n        if (value !== undefined) {\n          result[key] = value;\n        }\n      }\n\n      return result;\n    }\n    default:\n      return null;\n  }\n}\n\n/**\n * A deterministic example value for a JSON Schema.\n *\n * Explicit `example`, `const`, `default`, `enum[0]` and `examples[0]` win, in that order;\n * otherwise a type sample is produced (format-aware strings, `0`, `false`, one array item,\n * every object property). `$ref`s resolve against `components`; a cyclic reference is cut\n * (the property is omitted, an array of it is empty). A nullable union yields its non-null\n * branch. A schema with no usable type is `null`.\n */\nexport function exampleFromSchema(schema: OpenApiSchema, components?: SchemaComponents): unknown {\n  const value = generate(schema, components, []);\n\n  return value === undefined ? null : value;\n}\n"],"mappings":"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"}

package/esm/openapi/postman/openapi-to-postman-collection.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"openapi-to-postman-collection.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/openapi/postman/openapi-to-postman-collection.ts"],"mappings":";;;;;cAgBa,yBAAA;AAAb;AAAA,cAGa,wBAAA;;;AAHyB;AAGtC;;;;AAAqC;AAqDrC;;iBAAgB,0BAAA,CACd,QAAA,EAAU,eAAA,EACV,OAAA,GAAS,wBAAA,GACR,iBAAA"}
+{"version":3,"file":"openapi-to-postman-collection.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/openapi/postman/openapi-to-postman-collection.ts"],"mappings":";;;;;cAoBa,yBAAA;AAAb;AAAA,cAIa,wBAAA;;;AAJyB;AAItC;;;;AAAqC;AAyDrC;;iBAAgB,0BAAA,CACd,QAAA,EAAU,eAAA,EACV,OAAA,GAAS,wBAAA,GACR,iBAAA"}

package/esm/openapi/postman/openapi-to-postman-collection.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"openapi-to-postman-collection.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/openapi/postman/openapi-to-postman-collection.ts"],"sourcesContent":["import type { OpenApiDocument, OpenApiOperation } from \"../types\";\nimport { buildRequestBody } from \"./build-request-body\";\nimport { buildHeaderParameters, buildRequestUrl } from \"./build-request-url\";\nimport { buildSavedResponses } from \"./build-saved-responses\";\nimport type {\n  PostmanCollection,\n  PostmanCollectionOptions,\n  PostmanFolder,\n  PostmanHeader,\n  PostmanItem,\n  PostmanRequestItem,\n} from \"./postman-types\";\nimport { collectionBearerAuth, hasBearerScheme, resolveOperationAuth } from \"./resolve-operation-auth\";\nimport { uuidV5 } from \"./uuid-v5\";\n\n/** `info.schema` of every collection this converter produces. */\nexport const POSTMAN_COLLECTION_SCHEMA = \"https://schema.getpostman.com/json/collection/v2.1.0/collection.json\";\n\n/** `{{baseUrl}}` when neither the options nor the document name a server. */\nexport const DEFAULT_POSTMAN_BASE_URL = \"http://localhost:3000\";\n\nconst OPERATION_METHODS = [\"get\", \"put\", \"post\", \"delete\", \"options\", \"head\", \"patch\", \"trace\"];\n\nfunction buildRequestItem(\n  path: string,\n  method: string,\n  operation: OpenApiOperation,\n  document: OpenApiDocument,\n): PostmanRequestItem {\n  const components = document.components?.schemas;\n  const parameters = operation.parameters ?? [];\n  const body = buildRequestBody(operation.requestBody, components);\n  const { auth, note } = resolveOperationAuth(operation, document.components);\n  const description = [operation.description, note].filter((line): line is string => Boolean(line)).join(\"\\n\\n\");\n\n  const header: PostmanHeader[] = [\n    ...(body?.contentType ? [{ key: \"Content-Type\", value: body.contentType, type: \"text\" as const }] : []),\n    ...buildHeaderParameters(parameters, components),\n  ];\n\n  const originalRequest = {\n    method: method.toUpperCase(),\n    header,\n    ...(body ? { body: body.body } : {}),\n    url: buildRequestUrl(path, parameters, components),\n  };\n\n  return {\n    name: operation.summary ?? operation.operationId,\n    request: {\n      ...originalRequest,\n      ...(auth ? { auth } : {}),\n      ...(description ? { description } : {}),\n    },\n    response: buildSavedResponses(operation.responses, originalRequest, components),\n  };\n}\n\nfunction normalizeBaseUrl(baseUrl: string): string {\n  return baseUrl.replace(/\\/+$/, \"\");\n}\n\n/**\n * Convert an OpenAPI document into a Postman Collection v2.1.0 object.\n *\n * Pure and deterministic (the collection id is a UUIDv5 of the title), derived only from the\n * document so the collection can never disagree with the OpenAPI output. Each tag becomes a\n * folder in order of first appearance and untagged operations stay at the root; each\n * operation becomes a request with example bodies generated from its schemas and a saved\n * response per declared status. `{{baseUrl}}` and `{{token}}` are collection variables; a\n * bearer scheme becomes collection-level bearer auth and public operations opt out of it.\n */\nexport function openApiToPostmanCollection(\n  document: OpenApiDocument,\n  options: PostmanCollectionOptions = {},\n): PostmanCollection {\n  const name = options.title ?? document.info.title;\n  const baseUrl = normalizeBaseUrl(options.baseUrl ?? document.servers?.[0]?.url ?? DEFAULT_POSTMAN_BASE_URL);\n  const root: PostmanItem[] = [];\n  const folders = new Map<string, PostmanFolder>();\n\n  for (const [path, pathItem] of Object.entries(document.paths)) {\n    for (const [method, operation] of Object.entries(pathItem)) {\n      if (!OPERATION_METHODS.includes(method)) {\n        continue;\n      }\n\n      const item = buildRequestItem(path, method, operation, document);\n      const tag = operation.tags?.[0];\n\n      if (tag === undefined) {\n        root.push(item);\n\n        continue;\n      }\n\n      let folder = folders.get(tag);\n\n      if (!folder) {\n        folder = { name: tag, item: [] };\n        folders.set(tag, folder);\n        root.push(folder);\n      }\n\n      folder.item.push(item);\n    }\n  }\n\n  return {\n    info: {\n      _postman_id: uuidV5(name),\n      name,\n      ...(document.info.description ? { description: document.info.description } : {}),\n      schema: POSTMAN_COLLECTION_SCHEMA,\n    },\n    item: root,\n    ...(hasBearerScheme(document.components) ? { auth: collectionBearerAuth() } : {}),\n    variable: [\n      { key: \"baseUrl\", value: baseUrl, type: \"string\" },\n      { key: \"token\", value: \"\", type: \"string\" },\n    ],\n  };\n}\n"],"mappings":";;;;;;;;AAgBA,MAAa,4BAA4B;;AAGzC,MAAa,2BAA2B;AAExC,MAAM,oBAAoB;CAAC;CAAO;CAAO;CAAQ;CAAU;CAAW;CAAQ;CAAS;AAAO;AAE9F,SAAS,iBACP,MACA,QACA,WACA,UACoB;CACpB,MAAM,aAAa,SAAS,YAAY;CACxC,MAAM,aAAa,UAAU,cAAc,CAAC;CAC5C,MAAM,OAAO,iBAAiB,UAAU,aAAa,UAAU;CAC/D,MAAM,EAAE,MAAM,SAAS,qBAAqB,WAAW,SAAS,UAAU;CAC1E,MAAM,cAAc,CAAC,UAAU,aAAa,IAAI,CAAC,CAAC,QAAQ,SAAyB,QAAQ,IAAI,CAAC,CAAC,CAAC,KAAK,MAAM;CAE7G,MAAM,SAA0B,CAC9B,GAAI,MAAM,cAAc,CAAC;EAAE,KAAK;EAAgB,OAAO,KAAK;EAAa,MAAM;CAAgB,CAAC,IAAI,CAAC,GACrG,GAAG,sBAAsB,YAAY,UAAU,CACjD;CAEA,MAAM,kBAAkB;EACtB,QAAQ,OAAO,YAAY;EAC3B;EACA,GAAI,OAAO,EAAE,MAAM,KAAK,KAAK,IAAI,CAAC;EAClC,KAAK,gBAAgB,MAAM,YAAY,UAAU;CACnD;CAEA,OAAO;EACL,MAAM,UAAU,WAAW,UAAU;EACrC,SAAS;GACP,GAAG;GACH,GAAI,OAAO,EAAE,KAAK,IAAI,CAAC;GACvB,GAAI,cAAc,EAAE,YAAY,IAAI,CAAC;EACvC;EACA,UAAU,oBAAoB,UAAU,WAAW,iBAAiB,UAAU;CAChF;AACF;AAEA,SAAS,iBAAiB,SAAyB;CACjD,OAAO,QAAQ,QAAQ,QAAQ,EAAE;AACnC;;;;;;;;;;;AAYA,SAAgB,2BACd,UACA,UAAoC,CAAC,GAClB;CACnB,MAAM,OAAO,QAAQ,SAAS,SAAS,KAAK;CAC5C,MAAM,UAAU,iBAAiB,QAAQ,WAAW,SAAS,UAAU,EAAE,EAAE,8BAA+B;CAC1G,MAAM,OAAsB,CAAC;CAC7B,MAAM,0BAAU,IAAI,IAA2B;CAE/C,KAAK,MAAM,CAAC,MAAM,aAAa,OAAO,QAAQ,SAAS,KAAK,GAC1D,KAAK,MAAM,CAAC,QAAQ,cAAc,OAAO,QAAQ,QAAQ,GAAG;EAC1D,IAAI,CAAC,kBAAkB,SAAS,MAAM,GACpC;EAGF,MAAM,OAAO,iBAAiB,MAAM,QAAQ,WAAW,QAAQ;EAC/D,MAAM,MAAM,UAAU,OAAO;EAE7B,IAAI,QAAQ,QAAW;GACrB,KAAK,KAAK,IAAI;GAEd;EACF;EAEA,IAAI,SAAS,QAAQ,IAAI,GAAG;EAE5B,IAAI,CAAC,QAAQ;GACX,SAAS;IAAE,MAAM;IAAK,MAAM,CAAC;GAAE;GAC/B,QAAQ,IAAI,KAAK,MAAM;GACvB,KAAK,KAAK,MAAM;EAClB;EAEA,OAAO,KAAK,KAAK,IAAI;CACvB;CAGF,OAAO;EACL,MAAM;GACJ,aAAa,OAAO,IAAI;GACxB;GACA,GAAI,SAAS,KAAK,cAAc,EAAE,aAAa,SAAS,KAAK,YAAY,IAAI,CAAC;GAC9E,QAAQ;EACV;EACA,MAAM;EACN,GAAI,gBAAgB,SAAS,UAAU,IAAI,EAAE,MAAM,qBAAqB,EAAE,IAAI,CAAC;EAC/E,UAAU,CACR;GAAE,KAAK;GAAW,OAAO;GAAS,MAAM;EAAS,GACjD;GAAE,KAAK;GAAS,OAAO;GAAI,MAAM;EAAS,CAC5C;CACF;AACF"}
+{"version":3,"file":"openapi-to-postman-collection.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/openapi/postman/openapi-to-postman-collection.ts"],"sourcesContent":["import type { OpenApiDocument, OpenApiOperation } from \"../types\";\nimport { buildRequestBody } from \"./build-request-body\";\nimport { buildHeaderParameters, buildRequestUrl } from \"./build-request-url\";\nimport { buildSavedResponses } from \"./build-saved-responses\";\nimport type {\n  PostmanCollection,\n  PostmanCollectionOptions,\n  PostmanFolder,\n  PostmanHeader,\n  PostmanItem,\n  PostmanRequestItem,\n} from \"./postman-types\";\nimport {\n  collectionBearerAuth,\n  hasBearerScheme,\n  resolveOperationAuth,\n} from \"./resolve-operation-auth\";\nimport { uuidV5 } from \"./uuid-v5\";\n\n/** `info.schema` of every collection this converter produces. */\nexport const POSTMAN_COLLECTION_SCHEMA =\n  \"https://schema.getpostman.com/json/collection/v2.1.0/collection.json\";\n\n/** `{{baseUrl}}` when neither the options nor the document name a server. */\nexport const DEFAULT_POSTMAN_BASE_URL = \"http://localhost:3000\";\n\nconst OPERATION_METHODS = [\"get\", \"put\", \"post\", \"delete\", \"options\", \"head\", \"patch\", \"trace\"];\n\nfunction buildRequestItem(\n  path: string,\n  method: string,\n  operation: OpenApiOperation,\n  document: OpenApiDocument,\n): PostmanRequestItem {\n  const components = document.components?.schemas;\n  const parameters = operation.parameters ?? [];\n  const body = buildRequestBody(operation.requestBody, components);\n  const { auth, note } = resolveOperationAuth(operation, document.components);\n  const description = [operation.description, note]\n    .filter((line): line is string => Boolean(line))\n    .join(\"\\n\\n\");\n\n  const header: PostmanHeader[] = [\n    ...(body?.contentType\n      ? [{ key: \"Content-Type\", value: body.contentType, type: \"text\" as const }]\n      : []),\n    ...buildHeaderParameters(parameters, components),\n  ];\n\n  const originalRequest = {\n    method: method.toUpperCase(),\n    header,\n    ...(body ? { body: body.body } : {}),\n    url: buildRequestUrl(path, parameters, components),\n  };\n\n  return {\n    name: operation.summary ?? operation.operationId,\n    request: {\n      ...originalRequest,\n      ...(auth ? { auth } : {}),\n      ...(description ? { description } : {}),\n    },\n    response: buildSavedResponses(operation.responses, originalRequest, components),\n  };\n}\n\nfunction normalizeBaseUrl(baseUrl: string): string {\n  return baseUrl.replace(/\\/+$/, \"\");\n}\n\n/**\n * Convert an OpenAPI document into a Postman Collection v2.1.0 object.\n *\n * Pure and deterministic (the collection id is a UUIDv5 of the title), derived only from the\n * document so the collection can never disagree with the OpenAPI output. Each tag becomes a\n * folder in order of first appearance and untagged operations stay at the root; each\n * operation becomes a request with example bodies generated from its schemas and a saved\n * response per declared status. `{{baseUrl}}` and `{{token}}` are collection variables; a\n * bearer scheme becomes collection-level bearer auth and public operations opt out of it.\n */\nexport function openApiToPostmanCollection(\n  document: OpenApiDocument,\n  options: PostmanCollectionOptions = {},\n): PostmanCollection {\n  const name = options.title ?? document.info.title;\n  const baseUrl = normalizeBaseUrl(\n    options.baseUrl ?? document.servers?.[0]?.url ?? DEFAULT_POSTMAN_BASE_URL,\n  );\n  const root: PostmanItem[] = [];\n  const folders = new Map<string, PostmanFolder>();\n\n  for (const [path, pathItem] of Object.entries(document.paths)) {\n    for (const [method, operation] of Object.entries(pathItem)) {\n      if (!OPERATION_METHODS.includes(method)) {\n        continue;\n      }\n\n      const item = buildRequestItem(path, method, operation, document);\n      const tag = operation.tags?.[0];\n\n      if (tag === undefined) {\n        root.push(item);\n\n        continue;\n      }\n\n      let folder = folders.get(tag);\n\n      if (!folder) {\n        folder = { name: tag, item: [] };\n        folders.set(tag, folder);\n        root.push(folder);\n      }\n\n      folder.item.push(item);\n    }\n  }\n\n  return {\n    info: {\n      _postman_id: uuidV5(name),\n      name,\n      ...(document.info.description ? { description: document.info.description } : {}),\n      schema: POSTMAN_COLLECTION_SCHEMA,\n    },\n    item: root,\n    ...(hasBearerScheme(document.components) ? { auth: collectionBearerAuth() } : {}),\n    variable: [\n      { key: \"baseUrl\", value: baseUrl, type: \"string\" },\n      { key: \"token\", value: \"\", type: \"string\" },\n    ],\n  };\n}\n"],"mappings":";;;;;;;;AAoBA,MAAa,4BACX;;AAGF,MAAa,2BAA2B;AAExC,MAAM,oBAAoB;CAAC;CAAO;CAAO;CAAQ;CAAU;CAAW;CAAQ;CAAS;AAAO;AAE9F,SAAS,iBACP,MACA,QACA,WACA,UACoB;CACpB,MAAM,aAAa,SAAS,YAAY;CACxC,MAAM,aAAa,UAAU,cAAc,CAAC;CAC5C,MAAM,OAAO,iBAAiB,UAAU,aAAa,UAAU;CAC/D,MAAM,EAAE,MAAM,SAAS,qBAAqB,WAAW,SAAS,UAAU;CAC1E,MAAM,cAAc,CAAC,UAAU,aAAa,IAAI,CAAC,CAC9C,QAAQ,SAAyB,QAAQ,IAAI,CAAC,CAAC,CAC/C,KAAK,MAAM;CAEd,MAAM,SAA0B,CAC9B,GAAI,MAAM,cACN,CAAC;EAAE,KAAK;EAAgB,OAAO,KAAK;EAAa,MAAM;CAAgB,CAAC,IACxE,CAAC,GACL,GAAG,sBAAsB,YAAY,UAAU,CACjD;CAEA,MAAM,kBAAkB;EACtB,QAAQ,OAAO,YAAY;EAC3B;EACA,GAAI,OAAO,EAAE,MAAM,KAAK,KAAK,IAAI,CAAC;EAClC,KAAK,gBAAgB,MAAM,YAAY,UAAU;CACnD;CAEA,OAAO;EACL,MAAM,UAAU,WAAW,UAAU;EACrC,SAAS;GACP,GAAG;GACH,GAAI,OAAO,EAAE,KAAK,IAAI,CAAC;GACvB,GAAI,cAAc,EAAE,YAAY,IAAI,CAAC;EACvC;EACA,UAAU,oBAAoB,UAAU,WAAW,iBAAiB,UAAU;CAChF;AACF;AAEA,SAAS,iBAAiB,SAAyB;CACjD,OAAO,QAAQ,QAAQ,QAAQ,EAAE;AACnC;;;;;;;;;;;AAYA,SAAgB,2BACd,UACA,UAAoC,CAAC,GAClB;CACnB,MAAM,OAAO,QAAQ,SAAS,SAAS,KAAK;CAC5C,MAAM,UAAU,iBACd,QAAQ,WAAW,SAAS,UAAU,EAAE,EAAE,8BAC5C;CACA,MAAM,OAAsB,CAAC;CAC7B,MAAM,0BAAU,IAAI,IAA2B;CAE/C,KAAK,MAAM,CAAC,MAAM,aAAa,OAAO,QAAQ,SAAS,KAAK,GAC1D,KAAK,MAAM,CAAC,QAAQ,cAAc,OAAO,QAAQ,QAAQ,GAAG;EAC1D,IAAI,CAAC,kBAAkB,SAAS,MAAM,GACpC;EAGF,MAAM,OAAO,iBAAiB,MAAM,QAAQ,WAAW,QAAQ;EAC/D,MAAM,MAAM,UAAU,OAAO;EAE7B,IAAI,QAAQ,QAAW;GACrB,KAAK,KAAK,IAAI;GAEd;EACF;EAEA,IAAI,SAAS,QAAQ,IAAI,GAAG;EAE5B,IAAI,CAAC,QAAQ;GACX,SAAS;IAAE,MAAM;IAAK,MAAM,CAAC;GAAE;GAC/B,QAAQ,IAAI,KAAK,MAAM;GACvB,KAAK,KAAK,MAAM;EAClB;EAEA,OAAO,KAAK,KAAK,IAAI;CACvB;CAGF,OAAO;EACL,MAAM;GACJ,aAAa,OAAO,IAAI;GACxB;GACA,GAAI,SAAS,KAAK,cAAc,EAAE,aAAa,SAAS,KAAK,YAAY,IAAI,CAAC;GAC9E,QAAQ;EACV;EACA,MAAM;EACN,GAAI,gBAAgB,SAAS,UAAU,IAAI,EAAE,MAAM,qBAAqB,EAAE,IAAI,CAAC;EAC/E,UAAU,CACR;GAAE,KAAK;GAAW,OAAO;GAAS,MAAM;EAAS,GACjD;GAAE,KAAK;GAAS,OAAO;GAAI,MAAM;EAAS,CAC5C;CACF;AACF"}

package/esm/openapi/postman/schema-refs.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"schema-refs.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/openapi/postman/schema-refs.ts"],"sourcesContent":["import type { OpenApiSchema } from \"../types\";\n\nexport type SchemaComponents = Record<string, OpenApiSchema> | undefined;\n\nconst REF_PREFIX = \"#/components/schemas/\";\n\nexport function isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\n/**\n * Component name a `$ref` schema points at, or `undefined` for a schema that is not a local\n * component reference.\n */\nexport function refName(schema: OpenApiSchema): string | undefined {\n  const ref = schema.$ref;\n\n  return typeof ref === \"string\" && ref.startsWith(REF_PREFIX) ? ref.slice(REF_PREFIX.length) : undefined;\n}\n\n/**\n * Follow `$ref`s (with a hop limit, so a ref loop cannot hang) to the schema they name.\n * An unknown component resolves to `{}`.\n */\nexport function resolveSchema(schema: OpenApiSchema, components: SchemaComponents): OpenApiSchema {\n  let current = schema;\n\n  for (let hop = 0; hop < 32; hop++) {\n    const name = refName(current);\n\n    if (name === undefined) {\n      return current;\n    }\n\n    current = components?.[name] ?? {};\n  }\n\n  return {};\n}\n\n/**\n * The effective JSON Schema type: `type`, or the first non-null member of a `type` array\n * (the 3.1 nullable form), or one inferred from `properties` / `items`.\n */\nexport function primaryType(schema: OpenApiSchema): string | undefined {\n  const { type } = schema;\n\n  if (typeof type === \"string\") {\n    return type;\n  }\n\n  if (Array.isArray(type)) {\n    const concrete = type.find((member): member is string => typeof member === \"string\" && member !== \"null\");\n\n    return concrete ?? (type.includes(\"null\") ? \"null\" : undefined);\n  }\n\n  if (isRecord(schema.properties)) {\n    return \"object\";\n  }\n\n  if (isRecord(schema.items)) {\n    return \"array\";\n  }\n\n  return undefined;\n}\n"],"mappings":";AAIA,MAAM,aAAa;AAEnB,SAAgB,SAAS,OAAkD;CACzE,OAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAC5E;;;;;AAMA,SAAgB,QAAQ,QAA2C;CACjE,MAAM,MAAM,OAAO;CAEnB,OAAO,OAAO,QAAQ,YAAY,IAAI,WAAW,UAAU,IAAI,IAAI,MAAM,EAAiB,IAAI;AAChG;;;;;AAMA,SAAgB,cAAc,QAAuB,YAA6C;CAChG,IAAI,UAAU;CAEd,KAAK,IAAI,MAAM,GAAG,MAAM,IAAI,OAAO;EACjC,MAAM,OAAO,QAAQ,OAAO;EAE5B,IAAI,SAAS,QACX,OAAO;EAGT,UAAU,aAAa,SAAS,CAAC;CACnC;CAEA,OAAO,CAAC;AACV;;;;;AAMA,SAAgB,YAAY,QAA2C;CACrE,MAAM,EAAE,SAAS;CAEjB,IAAI,OAAO,SAAS,UAClB,OAAO;CAGT,IAAI,MAAM,QAAQ,IAAI,GAGpB,OAFiB,KAAK,MAAM,WAA6B,OAAO,WAAW,YAAY,WAAW,MAEpF,MAAM,KAAK,SAAS,MAAM,IAAI,SAAS;CAGvD,IAAI,SAAS,OAAO,UAAU,GAC5B,OAAO;CAGT,IAAI,SAAS,OAAO,KAAK,GACvB,OAAO;AAIX"}
+{"version":3,"file":"schema-refs.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/openapi/postman/schema-refs.ts"],"sourcesContent":["import type { OpenApiSchema } from \"../types\";\n\nexport type SchemaComponents = Record<string, OpenApiSchema> | undefined;\n\nconst REF_PREFIX = \"#/components/schemas/\";\n\nexport function isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\n/**\n * Component name a `$ref` schema points at, or `undefined` for a schema that is not a local\n * component reference.\n */\nexport function refName(schema: OpenApiSchema): string | undefined {\n  const ref = schema.$ref;\n\n  return typeof ref === \"string\" && ref.startsWith(REF_PREFIX)\n    ? ref.slice(REF_PREFIX.length)\n    : undefined;\n}\n\n/**\n * Follow `$ref`s (with a hop limit, so a ref loop cannot hang) to the schema they name.\n * An unknown component resolves to `{}`.\n */\nexport function resolveSchema(schema: OpenApiSchema, components: SchemaComponents): OpenApiSchema {\n  let current = schema;\n\n  for (let hop = 0; hop < 32; hop++) {\n    const name = refName(current);\n\n    if (name === undefined) {\n      return current;\n    }\n\n    current = components?.[name] ?? {};\n  }\n\n  return {};\n}\n\n/**\n * The effective JSON Schema type: `type`, or the first non-null member of a `type` array\n * (the 3.1 nullable form), or one inferred from `properties` / `items`.\n */\nexport function primaryType(schema: OpenApiSchema): string | undefined {\n  const { type } = schema;\n\n  if (typeof type === \"string\") {\n    return type;\n  }\n\n  if (Array.isArray(type)) {\n    const concrete = type.find(\n      (member): member is string => typeof member === \"string\" && member !== \"null\",\n    );\n\n    return concrete ?? (type.includes(\"null\") ? \"null\" : undefined);\n  }\n\n  if (isRecord(schema.properties)) {\n    return \"object\";\n  }\n\n  if (isRecord(schema.items)) {\n    return \"array\";\n  }\n\n  return undefined;\n}\n"],"mappings":";AAIA,MAAM,aAAa;AAEnB,SAAgB,SAAS,OAAkD;CACzE,OAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAC5E;;;;;AAMA,SAAgB,QAAQ,QAA2C;CACjE,MAAM,MAAM,OAAO;CAEnB,OAAO,OAAO,QAAQ,YAAY,IAAI,WAAW,UAAU,IACvD,IAAI,MAAM,EAAiB,IAC3B;AACN;;;;;AAMA,SAAgB,cAAc,QAAuB,YAA6C;CAChG,IAAI,UAAU;CAEd,KAAK,IAAI,MAAM,GAAG,MAAM,IAAI,OAAO;EACjC,MAAM,OAAO,QAAQ,OAAO;EAE5B,IAAI,SAAS,QACX,OAAO;EAGT,UAAU,aAAa,SAAS,CAAC;CACnC;CAEA,OAAO,CAAC;AACV;;;;;AAMA,SAAgB,YAAY,QAA2C;CACrE,MAAM,EAAE,SAAS;CAEjB,IAAI,OAAO,SAAS,UAClB,OAAO;CAGT,IAAI,MAAM,QAAQ,IAAI,GAKpB,OAJiB,KAAK,MACnB,WAA6B,OAAO,WAAW,YAAY,WAAW,MAG3D,MAAM,KAAK,SAAS,MAAM,IAAI,SAAS;CAGvD,IAAI,SAAS,OAAO,UAAU,GAC5B,OAAO;CAGT,IAAI,SAAS,OAAO,KAAK,GACvB,OAAO;AAIX"}

package/esm/openapi/postman/uuid-v5.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"uuid-v5.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/openapi/postman/uuid-v5.ts"],"sourcesContent":["import { createHash } from \"node:crypto\";\n\n/**\n * Namespace of every id the Postman converter derives. Fixed forever: changing it would\n * change the `_postman_id` of every collection already imported.\n */\nexport const POSTMAN_ID_NAMESPACE = \"8f1c2b64-3d7a-4c59-9a0e-5b6d1e47c2a3\";\n\n/**\n * RFC 4122 version 5 (SHA-1, name based) UUID, so the same name always yields the same id.\n */\nexport function uuidV5(name: string, namespace: string = POSTMAN_ID_NAMESPACE): string {\n  const digest = createHash(\"sha1\")\n    .update(Buffer.from(namespace.replace(/-/g, \"\"), \"hex\"))\n    .update(name, \"utf8\")\n    .digest();\n  const bytes = Buffer.from(digest.subarray(0, 16));\n\n  bytes.writeUInt8((bytes.readUInt8(6) & 0x0f) | 0x50, 6);\n  bytes.writeUInt8((bytes.readUInt8(8) & 0x3f) | 0x80, 8);\n\n  const hex = bytes.toString(\"hex\");\n\n  return [hex.slice(0, 8), hex.slice(8, 12), hex.slice(12, 16), hex.slice(16, 20), hex.slice(20, 32)].join(\"-\");\n}\n"],"mappings":";;;;;;;AAMA,MAAa,uBAAuB;;;;AAKpC,SAAgB,OAAO,MAAc,YAAoB,sBAA8B;CACrF,MAAM,SAAS,WAAW,MAAM,CAAC,CAC9B,OAAO,OAAO,KAAK,UAAU,QAAQ,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,CACvD,OAAO,MAAM,MAAM,CAAC,CACpB,OAAO;CACV,MAAM,QAAQ,OAAO,KAAK,OAAO,SAAS,GAAG,EAAE,CAAC;CAEhD,MAAM,WAAY,MAAM,UAAU,CAAC,IAAI,KAAQ,IAAM,CAAC;CACtD,MAAM,WAAY,MAAM,UAAU,CAAC,IAAI,KAAQ,KAAM,CAAC;CAEtD,MAAM,MAAM,MAAM,SAAS,KAAK;CAEhC,OAAO;EAAC,IAAI,MAAM,GAAG,CAAC;EAAG,IAAI,MAAM,GAAG,EAAE;EAAG,IAAI,MAAM,IAAI,EAAE;EAAG,IAAI,MAAM,IAAI,EAAE;EAAG,IAAI,MAAM,IAAI,EAAE;CAAC,CAAC,CAAC,KAAK,GAAG;AAC9G"}
+{"version":3,"file":"uuid-v5.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/openapi/postman/uuid-v5.ts"],"sourcesContent":["import { createHash } from \"node:crypto\";\n\n/**\n * Namespace of every id the Postman converter derives. Fixed forever: changing it would\n * change the `_postman_id` of every collection already imported.\n */\nexport const POSTMAN_ID_NAMESPACE = \"8f1c2b64-3d7a-4c59-9a0e-5b6d1e47c2a3\";\n\n/**\n * RFC 4122 version 5 (SHA-1, name based) UUID, so the same name always yields the same id.\n */\nexport function uuidV5(name: string, namespace: string = POSTMAN_ID_NAMESPACE): string {\n  const digest = createHash(\"sha1\")\n    .update(Buffer.from(namespace.replace(/-/g, \"\"), \"hex\"))\n    .update(name, \"utf8\")\n    .digest();\n  const bytes = Buffer.from(digest.subarray(0, 16));\n\n  bytes.writeUInt8((bytes.readUInt8(6) & 0x0f) | 0x50, 6);\n  bytes.writeUInt8((bytes.readUInt8(8) & 0x3f) | 0x80, 8);\n\n  const hex = bytes.toString(\"hex\");\n\n  return [\n    hex.slice(0, 8),\n    hex.slice(8, 12),\n    hex.slice(12, 16),\n    hex.slice(16, 20),\n    hex.slice(20, 32),\n  ].join(\"-\");\n}\n"],"mappings":";;;;;;;AAMA,MAAa,uBAAuB;;;;AAKpC,SAAgB,OAAO,MAAc,YAAoB,sBAA8B;CACrF,MAAM,SAAS,WAAW,MAAM,CAAC,CAC9B,OAAO,OAAO,KAAK,UAAU,QAAQ,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,CACvD,OAAO,MAAM,MAAM,CAAC,CACpB,OAAO;CACV,MAAM,QAAQ,OAAO,KAAK,OAAO,SAAS,GAAG,EAAE,CAAC;CAEhD,MAAM,WAAY,MAAM,UAAU,CAAC,IAAI,KAAQ,IAAM,CAAC;CACtD,MAAM,WAAY,MAAM,UAAU,CAAC,IAAI,KAAQ,KAAM,CAAC;CAEtD,MAAM,MAAM,MAAM,SAAS,KAAK;CAEhC,OAAO;EACL,IAAI,MAAM,GAAG,CAAC;EACd,IAAI,MAAM,GAAG,EAAE;EACf,IAAI,MAAM,IAAI,EAAE;EAChB,IAAI,MAAM,IAAI,EAAE;EAChB,IAAI,MAAM,IAAI,EAAE;CAClB,CAAC,CAAC,KAAK,GAAG;AACZ"}

package/esm/openapi/request-schemas.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"request-schemas.mjs","names":[],"sources":["../../../../../../../../packages/core/src/openapi/request-schemas.ts"],"sourcesContent":["import type { RequestHandlerValidation } from \"../router/types\";\nimport { extractPathParamNames, isBodylessMethod, type OpenApiMethod } from \"./paths\";\nimport type {\n  OpenApiParameter,\n  OpenApiRequestBody,\n  OpenApiSchema,\n  WarningSink,\n} from \"./types\";\n\ntype ValidatingLocation = \"body\" | \"query\" | \"params\" | \"headers\";\n\ntype ObjectSchemaParts = {\n  schema: OpenApiSchema;\n  properties: Record<string, OpenApiSchema>;\n  required: Set<string>;\n};\n\n/** A `validation.schema` property placed in a request location, with its JSON Schema. */\ntype LocatedProperty = {\n  key: string;\n  schema: OpenApiSchema;\n};\n\nexport type RequestParts = {\n  parameters: OpenApiParameter[];\n  requestBody?: OpenApiRequestBody;\n};\n\nexport type BuildRequestPartsInput = {\n  method: OpenApiMethod;\n  /** Warlock path, with `:param` segments. */\n  path: string;\n  validation: RequestHandlerValidation | undefined;\n  warn: WarningSink;\n};\n\nconst VALIDATING_LOCATIONS: readonly string[] = [\"body\", \"query\", \"params\", \"headers\"];\n\n/**\n * Convert a Seal validator to a JSON Schema object (`draft-2020-12`, the OpenAPI 3.1 dialect)\n * and split it into properties and required keys. Never throws: a validator that cannot be\n * converted is reported through `warn` and yields `undefined`.\n */\nfunction readObjectSchema(\n  validator: unknown,\n  what: string,\n  warn: WarningSink,\n): ObjectSchemaParts | undefined {\n  const convert = (validator as { toJsonSchema?: unknown } | undefined)?.toJsonSchema;\n\n  if (typeof convert !== \"function\") {\n    return undefined;\n  }\n\n  let schema: unknown;\n\n  try {\n    schema = convert.call(validator, \"draft-2020-12\");\n  } catch (error) {\n    warn(\n      `${what} could not be converted to JSON Schema and is not documented: ${\n        error instanceof Error ? error.message : String(error)\n      }`,\n    );\n\n    return undefined;\n  }\n\n  const properties = (schema as { properties?: unknown } | undefined)?.properties;\n\n  if (typeof schema !== \"object\" || schema === null || !isRecord(properties)) {\n    warn(`${what} is not an object schema and is not documented.`);\n\n    return undefined;\n  }\n\n  const required = (schema as { required?: unknown }).required;\n\n  return {\n    schema: schema as OpenApiSchema,\n    properties: properties as Record<string, OpenApiSchema>,\n    required: new Set(Array.isArray(required) ? required.filter((key) => typeof key === \"string\") : []),\n  };\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction describeParameter(\n  name: string,\n  location: OpenApiParameter[\"in\"],\n  schema: OpenApiSchema,\n  required: boolean,\n): OpenApiParameter {\n  const parameter: OpenApiParameter = { name, in: location, required, schema };\n\n  if (typeof schema.description === \"string\") {\n    parameter.description = schema.description;\n  }\n\n  if (location === \"query\" && schema.type === \"object\") {\n    parameter.style = \"deepObject\";\n    parameter.explode = true;\n  }\n\n  return parameter;\n}\n\n/**\n * Where an unscoped or scoped `validating` puts the non-path properties.\n *\n * `validateAll` merges body and query (unset) or exactly the listed sources. The OpenAPI\n * placement follows: unset -> by method, a single source -> that source, `body` + `query`\n * -> body for verbs that carry one, query for the rest (and a warning, it is ambiguous).\n */\nfunction resolvePrimaryLocation(\n  method: OpenApiMethod,\n  validating: ValidatingLocation[],\n  warn: WarningSink,\n): \"body\" | \"query\" | \"header\" | undefined {\n  if (validating.length === 0) {\n    return isBodylessMethod(method) ? \"query\" : \"body\";\n  }\n\n  const hasBody = validating.includes(\"body\");\n  const hasQuery = validating.includes(\"query\");\n\n  if (hasBody && hasQuery) {\n    warn(\n      `validating lists both \"body\" and \"query\"; the properties are documented as ${\n        isBodylessMethod(method) ? \"query parameters\" : \"the request body\"\n      }.`,\n    );\n\n    return isBodylessMethod(method) ? \"query\" : \"body\";\n  }\n\n  if (hasBody) {\n    return \"body\";\n  }\n\n  if (hasQuery) {\n    return \"query\";\n  }\n\n  if (validating.includes(\"headers\")) {\n    return \"header\";\n  }\n\n  return undefined;\n}\n\n/**\n * Map a handler's `validation` to OpenAPI parameters and a request body.\n *\n * - `validation.params` -> one required path parameter per property.\n * - Path segments without a declared schema -> required string path parameters.\n * - `validation.schema` -> request body (verbs that carry one) or query parameters, placed by\n *   `validating` exactly as `validateAll` reads the request; a property named like a path\n *   segment is a path parameter whenever `params` is validated (unset counts).\n */\nexport function buildRequestParts(input: BuildRequestPartsInput): RequestParts {\n  const { method, path, validation, warn } = input;\n  const validating = (validation?.validating ?? []).filter((location): location is ValidatingLocation =>\n    VALIDATING_LOCATIONS.includes(location),\n  );\n  const pathNames = extractPathParamNames(path);\n\n  const paramsSchema = validation?.params\n    ? readObjectSchema(validation.params, \"validation.params\", warn)\n    : undefined;\n  const mainSchema = validation?.schema\n    ? readObjectSchema(validation.schema, \"validation.schema\", warn)\n    : undefined;\n\n  const pathSchemas = new Map<string, OpenApiSchema>();\n  const primary = resolvePrimaryLocation(method, validating, warn);\n  const takesPathNames = validating.length === 0 || validating.includes(\"params\");\n\n  const located: Record<\"body\" | \"query\" | \"header\", LocatedProperty[]> = {\n    body: [],\n    query: [],\n    header: [],\n  };\n\n  if (paramsSchema) {\n    for (const name of pathNames) {\n      if (paramsSchema.properties[name]) {\n        pathSchemas.set(name, paramsSchema.properties[name]);\n      }\n    }\n  }\n\n  if (mainSchema) {\n    for (const [key, propertySchema] of Object.entries(mainSchema.properties)) {\n      if (takesPathNames && pathNames.includes(key)) {\n        if (!pathSchemas.has(key)) {\n          pathSchemas.set(key, propertySchema);\n        }\n\n        continue;\n      }\n\n      if (!primary) {\n        warn(`validation.schema property \"${key}\" is not a path parameter and is not documented.`);\n\n        continue;\n      }\n\n      located[primary].push({ key, schema: propertySchema });\n    }\n  }\n\n  const requiredKeys = mainSchema?.required ?? new Set<string>();\n\n  const parameters: OpenApiParameter[] = pathNames.map((name) =>\n    describeParameter(name, \"path\", pathSchemas.get(name) ?? { type: \"string\" }, true),\n  );\n\n  for (const { key, schema } of located.query) {\n    parameters.push(describeParameter(key, \"query\", schema, requiredKeys.has(key)));\n  }\n\n  for (const { key, schema } of located.header) {\n    parameters.push(describeParameter(key.toLowerCase(), \"header\", schema, requiredKeys.has(key)));\n  }\n\n  if (located.body.length === 0 || !mainSchema) {\n    return { parameters };\n  }\n\n  const properties: Record<string, OpenApiSchema> = {};\n\n  for (const { key, schema } of located.body) {\n    properties[key] = schema;\n  }\n\n  const required = located.body.filter(({ key }) => mainSchema.required.has(key)).map(({ key }) => key);\n  const bodySchema: OpenApiSchema = { ...mainSchema.schema, properties };\n\n  if (required.length > 0) {\n    bodySchema.required = required;\n  } else {\n    delete bodySchema.required;\n  }\n\n  return {\n    parameters,\n    requestBody: {\n      required: required.length > 0,\n      content: { \"application/json\": { schema: bodySchema } },\n    },\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"request-schemas.mjs","names":[],"sources":["../../../../../../../../packages/core/src/openapi/request-schemas.ts"],"sourcesContent":["import type { RequestHandlerValidation } from \"../router/types\";\nimport { extractPathParamNames, isBodylessMethod, type OpenApiMethod } from \"./paths\";\nimport type { OpenApiParameter, OpenApiRequestBody, OpenApiSchema, WarningSink } from \"./types\";\n\ntype ValidatingLocation = \"body\" | \"query\" | \"params\" | \"headers\";\n\ntype ObjectSchemaParts = {\n  schema: OpenApiSchema;\n  properties: Record<string, OpenApiSchema>;\n  required: Set<string>;\n};\n\n/** A `validation.schema` property placed in a request location, with its JSON Schema. */\ntype LocatedProperty = {\n  key: string;\n  schema: OpenApiSchema;\n};\n\nexport type RequestParts = {\n  parameters: OpenApiParameter[];\n  requestBody?: OpenApiRequestBody;\n};\n\nexport type BuildRequestPartsInput = {\n  method: OpenApiMethod;\n  /** Warlock path, with `:param` segments. */\n  path: string;\n  validation: RequestHandlerValidation | undefined;\n  warn: WarningSink;\n};\n\nconst VALIDATING_LOCATIONS: readonly string[] = [\"body\", \"query\", \"params\", \"headers\"];\n\n/**\n * Convert a Seal validator to a JSON Schema object (`draft-2020-12`, the OpenAPI 3.1 dialect)\n * and split it into properties and required keys. Never throws: a validator that cannot be\n * converted is reported through `warn` and yields `undefined`.\n */\nfunction readObjectSchema(\n  validator: unknown,\n  what: string,\n  warn: WarningSink,\n): ObjectSchemaParts | undefined {\n  const convert = (validator as { toJsonSchema?: unknown } | undefined)?.toJsonSchema;\n\n  if (typeof convert !== \"function\") {\n    return undefined;\n  }\n\n  let schema: unknown;\n\n  try {\n    schema = convert.call(validator, \"draft-2020-12\");\n  } catch (error) {\n    warn(\n      `${what} could not be converted to JSON Schema and is not documented: ${\n        error instanceof Error ? error.message : String(error)\n      }`,\n    );\n\n    return undefined;\n  }\n\n  const properties = (schema as { properties?: unknown } | undefined)?.properties;\n\n  if (typeof schema !== \"object\" || schema === null || !isRecord(properties)) {\n    warn(`${what} is not an object schema and is not documented.`);\n\n    return undefined;\n  }\n\n  const required = (schema as { required?: unknown }).required;\n\n  return {\n    schema: schema as OpenApiSchema,\n    properties: properties as Record<string, OpenApiSchema>,\n    required: new Set(\n      Array.isArray(required) ? required.filter((key) => typeof key === \"string\") : [],\n    ),\n  };\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction describeParameter(\n  name: string,\n  location: OpenApiParameter[\"in\"],\n  schema: OpenApiSchema,\n  required: boolean,\n): OpenApiParameter {\n  const parameter: OpenApiParameter = { name, in: location, required, schema };\n\n  if (typeof schema.description === \"string\") {\n    parameter.description = schema.description;\n  }\n\n  if (location === \"query\" && schema.type === \"object\") {\n    parameter.style = \"deepObject\";\n    parameter.explode = true;\n  }\n\n  return parameter;\n}\n\n/**\n * Where an unscoped or scoped `validating` puts the non-path properties.\n *\n * `validateAll` merges body and query (unset) or exactly the listed sources. The OpenAPI\n * placement follows: unset -> by method, a single source -> that source, `body` + `query`\n * -> body for verbs that carry one, query for the rest (and a warning, it is ambiguous).\n */\nfunction resolvePrimaryLocation(\n  method: OpenApiMethod,\n  validating: ValidatingLocation[],\n  warn: WarningSink,\n): \"body\" | \"query\" | \"header\" | undefined {\n  if (validating.length === 0) {\n    return isBodylessMethod(method) ? \"query\" : \"body\";\n  }\n\n  const hasBody = validating.includes(\"body\");\n  const hasQuery = validating.includes(\"query\");\n\n  if (hasBody && hasQuery) {\n    warn(\n      `validating lists both \"body\" and \"query\"; the properties are documented as ${\n        isBodylessMethod(method) ? \"query parameters\" : \"the request body\"\n      }.`,\n    );\n\n    return isBodylessMethod(method) ? \"query\" : \"body\";\n  }\n\n  if (hasBody) {\n    return \"body\";\n  }\n\n  if (hasQuery) {\n    return \"query\";\n  }\n\n  if (validating.includes(\"headers\")) {\n    return \"header\";\n  }\n\n  return undefined;\n}\n\n/**\n * Map a handler's `validation` to OpenAPI parameters and a request body.\n *\n * - `validation.params` -> one required path parameter per property.\n * - Path segments without a declared schema -> required string path parameters.\n * - `validation.schema` -> request body (verbs that carry one) or query parameters, placed by\n *   `validating` exactly as `validateAll` reads the request; a property named like a path\n *   segment is a path parameter whenever `params` is validated (unset counts).\n */\nexport function buildRequestParts(input: BuildRequestPartsInput): RequestParts {\n  const { method, path, validation, warn } = input;\n  const validating = (validation?.validating ?? []).filter(\n    (location): location is ValidatingLocation => VALIDATING_LOCATIONS.includes(location),\n  );\n  const pathNames = extractPathParamNames(path);\n\n  const paramsSchema = validation?.params\n    ? readObjectSchema(validation.params, \"validation.params\", warn)\n    : undefined;\n  const mainSchema = validation?.schema\n    ? readObjectSchema(validation.schema, \"validation.schema\", warn)\n    : undefined;\n\n  const pathSchemas = new Map<string, OpenApiSchema>();\n  const primary = resolvePrimaryLocation(method, validating, warn);\n  const takesPathNames = validating.length === 0 || validating.includes(\"params\");\n\n  const located: Record<\"body\" | \"query\" | \"header\", LocatedProperty[]> = {\n    body: [],\n    query: [],\n    header: [],\n  };\n\n  if (paramsSchema) {\n    for (const name of pathNames) {\n      if (paramsSchema.properties[name]) {\n        pathSchemas.set(name, paramsSchema.properties[name]);\n      }\n    }\n  }\n\n  if (mainSchema) {\n    for (const [key, propertySchema] of Object.entries(mainSchema.properties)) {\n      if (takesPathNames && pathNames.includes(key)) {\n        if (!pathSchemas.has(key)) {\n          pathSchemas.set(key, propertySchema);\n        }\n\n        continue;\n      }\n\n      if (!primary) {\n        warn(`validation.schema property \"${key}\" is not a path parameter and is not documented.`);\n\n        continue;\n      }\n\n      located[primary].push({ key, schema: propertySchema });\n    }\n  }\n\n  const requiredKeys = mainSchema?.required ?? new Set<string>();\n\n  const parameters: OpenApiParameter[] = pathNames.map((name) =>\n    describeParameter(name, \"path\", pathSchemas.get(name) ?? { type: \"string\" }, true),\n  );\n\n  for (const { key, schema } of located.query) {\n    parameters.push(describeParameter(key, \"query\", schema, requiredKeys.has(key)));\n  }\n\n  for (const { key, schema } of located.header) {\n    parameters.push(describeParameter(key.toLowerCase(), \"header\", schema, requiredKeys.has(key)));\n  }\n\n  if (located.body.length === 0 || !mainSchema) {\n    return { parameters };\n  }\n\n  const properties: Record<string, OpenApiSchema> = {};\n\n  for (const { key, schema } of located.body) {\n    properties[key] = schema;\n  }\n\n  const required = located.body\n    .filter(({ key }) => mainSchema.required.has(key))\n    .map(({ key }) => key);\n  const bodySchema: OpenApiSchema = { ...mainSchema.schema, properties };\n\n  if (required.length > 0) {\n    bodySchema.required = required;\n  } else {\n    delete bodySchema.required;\n  }\n\n  return {\n    parameters,\n    requestBody: {\n      required: required.length > 0,\n      content: { \"application/json\": { schema: bodySchema } },\n    },\n  };\n}\n"],"mappings":"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"}

package/esm/openapi/response-schemas.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"response-schemas.mjs","names":[],"sources":["../../../../../../../../packages/core/src/openapi/response-schemas.ts"],"sourcesContent":["import { isNullableResource } from \"../resource/nullable-resource\";\nimport type { SchemaRegistry } from \"./schema-registry\";\nimport type { OpenApiResponse, OpenApiSchema, WarningSink } from \"./types\";\n\nconst STATUS_TEXT: Record<string, string> = {\n  \"200\": \"Successful response\",\n  \"201\": \"Created\",\n  \"202\": \"Accepted\",\n  \"204\": \"No content\",\n  \"301\": \"Moved permanently\",\n  \"302\": \"Found\",\n  \"304\": \"Not modified\",\n  \"400\": \"Bad request\",\n  \"401\": \"Unauthorized\",\n  \"403\": \"Forbidden\",\n  \"404\": \"Not found\",\n  \"405\": \"Method not allowed\",\n  \"409\": \"Conflict\",\n  \"410\": \"Gone\",\n  \"422\": \"Validation failed\",\n  \"429\": \"Too many requests\",\n  \"500\": \"Internal server error\",\n  \"503\": \"Service unavailable\",\n};\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\n/**\n * Human description of a status code for the required `description` of a response.\n */\nexport function describeStatus(status: string): string {\n  return STATUS_TEXT[status] ?? `Status ${status}`;\n}\n\n/**\n * JSON Schema of one response body value: a cast string, a resource class, `[Resource]`\n * (array of it), `nullable(Resource)` (the resource or null) or a nested plain object of those. Anything else (a resolver function, a\n * builder) is `{}` plus a warning.\n */\nfunction bodyValueSchema(value: unknown, path: string, registry: SchemaRegistry, warn: WarningSink): OpenApiSchema {\n  if (typeof value === \"string\") {\n    return registry.cast(value, path, warn);\n  }\n\n  if (isNullableResource(value)) {\n    return { oneOf: [bodyValueSchema(value.resource, path, registry, warn), { type: \"null\" }] };\n  }\n\n  if (typeof value === \"function\") {\n    if (registry.isResourceClass(value)) {\n      return registry.resourceRef(value);\n    }\n\n    warn(`${path}: a function that is not a resource class has no static shape and is documented as {}.`);\n\n    return {};\n  }\n\n  if (Array.isArray(value)) {\n    return { type: \"array\", items: bodyValueSchema(value[0], `${path}[]`, registry, warn) };\n  }\n\n  if (isRecord(value)) {\n    return objectSchema(value, path, registry, warn);\n  }\n\n  warn(`${path}: unsupported response value is documented as {}.`);\n\n  return {};\n}\n\nfunction objectSchema(\n  body: Record<string, unknown>,\n  path: string,\n  registry: SchemaRegistry,\n  warn: WarningSink,\n): OpenApiSchema {\n  const properties: Record<string, OpenApiSchema> = {};\n\n  for (const [key, member] of Object.entries(body)) {\n    properties[key] = bodyValueSchema(member, `${path}.${key}`, registry, warn);\n  }\n\n  return { type: \"object\", properties, required: Object.keys(properties) };\n}\n\n/**\n * Map a handler's `responseSchema` to OpenAPI responses, one per declared status code.\n *\n * `routeLabel` prefixes warnings (for example `POST /login`). A status without a usable\n * `body` becomes a description-only response.\n */\nexport function buildDeclaredResponses(\n  responseSchema: unknown,\n  registry: SchemaRegistry,\n  warn: WarningSink,\n): Record<string, OpenApiResponse> {\n  const responses: Record<string, OpenApiResponse> = {};\n\n  if (!isRecord(responseSchema)) {\n    return responses;\n  }\n\n  for (const [status, entry] of Object.entries(responseSchema)) {\n    const body = isRecord(entry) ? entry.body : undefined;\n\n    if (!isRecord(body)) {\n      responses[status] = { description: describeStatus(status) };\n\n      continue;\n    }\n\n    responses[status] = {\n      description: describeStatus(status),\n      content: {\n        \"application/json\": { schema: objectSchema(body, `response ${status}`, registry, warn) },\n      },\n    };\n  }\n\n  return responses;\n}\n"],"mappings":";;;AAIA,MAAM,cAAsC;CAC1C,OAAO;CACP,OAAO;CACP,OAAO;CACP,OAAO;CACP,OAAO;CACP,OAAO;CACP,OAAO;CACP,OAAO;CACP,OAAO;CACP,OAAO;CACP,OAAO;CACP,OAAO;CACP,OAAO;CACP,OAAO;CACP,OAAO;CACP,OAAO;CACP,OAAO;CACP,OAAO;AACT;AAEA,SAAS,SAAS,OAAkD;CAClE,OAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAC5E;;;;AAKA,SAAgB,eAAe,QAAwB;CACrD,OAAO,YAAY,WAAW,UAAU;AAC1C;;;;;;AAOA,SAAS,gBAAgB,OAAgB,MAAc,UAA0B,MAAkC;CACjH,IAAI,OAAO,UAAU,UACnB,OAAO,SAAS,KAAK,OAAO,MAAM,IAAI;CAGxC,IAAI,mBAAmB,KAAK,GAC1B,OAAO,EAAE,OAAO,CAAC,gBAAgB,MAAM,UAAU,MAAM,UAAU,IAAI,GAAG,EAAE,MAAM,OAAO,CAAC,EAAE;CAG5F,IAAI,OAAO,UAAU,YAAY;EAC/B,IAAI,SAAS,gBAAgB,KAAK,GAChC,OAAO,SAAS,YAAY,KAAK;EAGnC,KAAK,GAAG,KAAK,uFAAuF;EAEpG,OAAO,CAAC;CACV;CAEA,IAAI,MAAM,QAAQ,KAAK,GACrB,OAAO;EAAE,MAAM;EAAS,OAAO,gBAAgB,MAAM,IAAI,GAAG,KAAK,KAAK,UAAU,IAAI;CAAE;CAGxF,IAAI,SAAS,KAAK,GAChB,OAAO,aAAa,OAAO,MAAM,UAAU,IAAI;CAGjD,KAAK,GAAG,KAAK,kDAAkD;CAE/D,OAAO,CAAC;AACV;AAEA,SAAS,aACP,MACA,MACA,UACA,MACe;CACf,MAAM,aAA4C,CAAC;CAEnD,KAAK,MAAM,CAAC,KAAK,WAAW,OAAO,QAAQ,IAAI,GAC7C,WAAW,OAAO,gBAAgB,QAAQ,GAAG,KAAK,GAAG,OAAO,UAAU,IAAI;CAG5E,OAAO;EAAE,MAAM;EAAU;EAAY,UAAU,OAAO,KAAK,UAAU;CAAE;AACzE;;;;;;;AAQA,SAAgB,uBACd,gBACA,UACA,MACiC;CACjC,MAAM,YAA6C,CAAC;CAEpD,IAAI,CAAC,SAAS,cAAc,GAC1B,OAAO;CAGT,KAAK,MAAM,CAAC,QAAQ,UAAU,OAAO,QAAQ,cAAc,GAAG;EAC5D,MAAM,OAAO,SAAS,KAAK,IAAI,MAAM,OAAO;EAE5C,IAAI,CAAC,SAAS,IAAI,GAAG;GACnB,UAAU,UAAU,EAAE,aAAa,eAAe,MAAM,EAAE;GAE1D;EACF;EAEA,UAAU,UAAU;GAClB,aAAa,eAAe,MAAM;GAClC,SAAS,EACP,oBAAoB,EAAE,QAAQ,aAAa,MAAM,YAAY,UAAU,UAAU,IAAI,EAAE,EACzF;EACF;CACF;CAEA,OAAO;AACT"}
+{"version":3,"file":"response-schemas.mjs","names":[],"sources":["../../../../../../../../packages/core/src/openapi/response-schemas.ts"],"sourcesContent":["import { isNullableResource } from \"../resource/nullable-resource\";\nimport type { SchemaRegistry } from \"./schema-registry\";\nimport type { OpenApiResponse, OpenApiSchema, WarningSink } from \"./types\";\n\nconst STATUS_TEXT: Record<string, string> = {\n  \"200\": \"Successful response\",\n  \"201\": \"Created\",\n  \"202\": \"Accepted\",\n  \"204\": \"No content\",\n  \"301\": \"Moved permanently\",\n  \"302\": \"Found\",\n  \"304\": \"Not modified\",\n  \"400\": \"Bad request\",\n  \"401\": \"Unauthorized\",\n  \"403\": \"Forbidden\",\n  \"404\": \"Not found\",\n  \"405\": \"Method not allowed\",\n  \"409\": \"Conflict\",\n  \"410\": \"Gone\",\n  \"422\": \"Validation failed\",\n  \"429\": \"Too many requests\",\n  \"500\": \"Internal server error\",\n  \"503\": \"Service unavailable\",\n};\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\n/**\n * Human description of a status code for the required `description` of a response.\n */\nexport function describeStatus(status: string): string {\n  return STATUS_TEXT[status] ?? `Status ${status}`;\n}\n\n/**\n * JSON Schema of one response body value: a cast string, a resource class, `[Resource]`\n * (array of it), `nullable(Resource)` (the resource or null) or a nested plain object of those. Anything else (a resolver function, a\n * builder) is `{}` plus a warning.\n */\nfunction bodyValueSchema(\n  value: unknown,\n  path: string,\n  registry: SchemaRegistry,\n  warn: WarningSink,\n): OpenApiSchema {\n  if (typeof value === \"string\") {\n    return registry.cast(value, path, warn);\n  }\n\n  if (isNullableResource(value)) {\n    return { oneOf: [bodyValueSchema(value.resource, path, registry, warn), { type: \"null\" }] };\n  }\n\n  if (typeof value === \"function\") {\n    if (registry.isResourceClass(value)) {\n      return registry.resourceRef(value);\n    }\n\n    warn(\n      `${path}: a function that is not a resource class has no static shape and is documented as {}.`,\n    );\n\n    return {};\n  }\n\n  if (Array.isArray(value)) {\n    return { type: \"array\", items: bodyValueSchema(value[0], `${path}[]`, registry, warn) };\n  }\n\n  if (isRecord(value)) {\n    return objectSchema(value, path, registry, warn);\n  }\n\n  warn(`${path}: unsupported response value is documented as {}.`);\n\n  return {};\n}\n\nfunction objectSchema(\n  body: Record<string, unknown>,\n  path: string,\n  registry: SchemaRegistry,\n  warn: WarningSink,\n): OpenApiSchema {\n  const properties: Record<string, OpenApiSchema> = {};\n\n  for (const [key, member] of Object.entries(body)) {\n    properties[key] = bodyValueSchema(member, `${path}.${key}`, registry, warn);\n  }\n\n  return { type: \"object\", properties, required: Object.keys(properties) };\n}\n\n/**\n * Map a handler's `responseSchema` to OpenAPI responses, one per declared status code.\n *\n * `routeLabel` prefixes warnings (for example `POST /login`). A status without a usable\n * `body` becomes a description-only response.\n */\nexport function buildDeclaredResponses(\n  responseSchema: unknown,\n  registry: SchemaRegistry,\n  warn: WarningSink,\n): Record<string, OpenApiResponse> {\n  const responses: Record<string, OpenApiResponse> = {};\n\n  if (!isRecord(responseSchema)) {\n    return responses;\n  }\n\n  for (const [status, entry] of Object.entries(responseSchema)) {\n    const body = isRecord(entry) ? entry.body : undefined;\n\n    if (!isRecord(body)) {\n      responses[status] = { description: describeStatus(status) };\n\n      continue;\n    }\n\n    responses[status] = {\n      description: describeStatus(status),\n      content: {\n        \"application/json\": { schema: objectSchema(body, `response ${status}`, registry, warn) },\n      },\n    };\n  }\n\n  return responses;\n}\n"],"mappings":";;;AAIA,MAAM,cAAsC;CAC1C,OAAO;CACP,OAAO;CACP,OAAO;CACP,OAAO;CACP,OAAO;CACP,OAAO;CACP,OAAO;CACP,OAAO;CACP,OAAO;CACP,OAAO;CACP,OAAO;CACP,OAAO;CACP,OAAO;CACP,OAAO;CACP,OAAO;CACP,OAAO;CACP,OAAO;CACP,OAAO;AACT;AAEA,SAAS,SAAS,OAAkD;CAClE,OAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAC5E;;;;AAKA,SAAgB,eAAe,QAAwB;CACrD,OAAO,YAAY,WAAW,UAAU;AAC1C;;;;;;AAOA,SAAS,gBACP,OACA,MACA,UACA,MACe;CACf,IAAI,OAAO,UAAU,UACnB,OAAO,SAAS,KAAK,OAAO,MAAM,IAAI;CAGxC,IAAI,mBAAmB,KAAK,GAC1B,OAAO,EAAE,OAAO,CAAC,gBAAgB,MAAM,UAAU,MAAM,UAAU,IAAI,GAAG,EAAE,MAAM,OAAO,CAAC,EAAE;CAG5F,IAAI,OAAO,UAAU,YAAY;EAC/B,IAAI,SAAS,gBAAgB,KAAK,GAChC,OAAO,SAAS,YAAY,KAAK;EAGnC,KACE,GAAG,KAAK,uFACV;EAEA,OAAO,CAAC;CACV;CAEA,IAAI,MAAM,QAAQ,KAAK,GACrB,OAAO;EAAE,MAAM;EAAS,OAAO,gBAAgB,MAAM,IAAI,GAAG,KAAK,KAAK,UAAU,IAAI;CAAE;CAGxF,IAAI,SAAS,KAAK,GAChB,OAAO,aAAa,OAAO,MAAM,UAAU,IAAI;CAGjD,KAAK,GAAG,KAAK,kDAAkD;CAE/D,OAAO,CAAC;AACV;AAEA,SAAS,aACP,MACA,MACA,UACA,MACe;CACf,MAAM,aAA4C,CAAC;CAEnD,KAAK,MAAM,CAAC,KAAK,WAAW,OAAO,QAAQ,IAAI,GAC7C,WAAW,OAAO,gBAAgB,QAAQ,GAAG,KAAK,GAAG,OAAO,UAAU,IAAI;CAG5E,OAAO;EAAE,MAAM;EAAU;EAAY,UAAU,OAAO,KAAK,UAAU;CAAE;AACzE;;;;;;;AAQA,SAAgB,uBACd,gBACA,UACA,MACiC;CACjC,MAAM,YAA6C,CAAC;CAEpD,IAAI,CAAC,SAAS,cAAc,GAC1B,OAAO;CAGT,KAAK,MAAM,CAAC,QAAQ,UAAU,OAAO,QAAQ,cAAc,GAAG;EAC5D,MAAM,OAAO,SAAS,KAAK,IAAI,MAAM,OAAO;EAE5C,IAAI,CAAC,SAAS,IAAI,GAAG;GACnB,UAAU,UAAU,EAAE,aAAa,eAAe,MAAM,EAAE;GAE1D;EACF;EAEA,UAAU,UAAU;GAClB,aAAa,eAAe,MAAM;GAClC,SAAS,EACP,oBAAoB,EAAE,QAAQ,aAAa,MAAM,YAAY,UAAU,UAAU,IAAI,EAAE,EACzF;EACF;CACF;CAEA,OAAO;AACT"}

package/esm/openapi/schema-registry.d.mts

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