@znight/openapi 0.0.0-stage → 0.1.0

package/dist/build-DXunOzlI.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-DXunOzlI.mjs","names":[],"sources":["../src/metadata.ts","../src/converters.ts","../src/build.ts"],"sourcesContent":["/**\n * `metadata.extensions.openapi` (format 1): the contract between the compiler extension\n * (`@znight/openapi/compiler`) and the runtime (`buildOpenApiDocument`, `OpenApiPlugin`).\n *\n * Everything is JSON-compatible, except the `schema` values of {@link OpenApiSchemaSlot}s (Standard\n * Schemas imported by the generated module). Where a schema is expected, the compiler writes JSON\n * Schema or a {@link SchemaPlaceholder} that the assembly replaces.\n */\nimport type { Token } from '@znight/core'\nimport type { StandardSchemaV1 } from '@znight/http'\nimport type {\n  ExternalDocumentationObject,\n  InfoObject,\n  JsonSchema,\n  JsonValue,\n  OpenApiMethod,\n  OperationObjectOf,\n  SecurityRequirementObject,\n  SecuritySchemeObject,\n  ServerObject,\n  TagObject,\n} from './types.ts'\n\n/** Format version of {@link OpenApiMetadata}. */\nexport const OPENAPI_METADATA_VERSION = 1\n\n/** A Standard Schema converted at assembly: `{ $ref }` to its component once replaced. */\nexport interface SchemaPlaceholder {\n  readonly $znight: 'schema'\n  /** Slot name ({@link OpenApiSchemaSlot.name}). */\n  readonly name: string\n  readonly io: 'input' | 'output'\n}\n\n/**\n * In `parameters` arrays: one parameter per property of the (input) object schema of a slot\n * (`@Query(SearchQuery)`), `required` from its `required` list.\n */\nexport interface ParametersPlaceholder {\n  readonly $znight: 'parameters'\n  readonly in: 'path' | 'query' | 'header' | 'cookie'\n  /** Slot name. */\n  readonly name: string\n  readonly io: 'input'\n}\n\n/** JSON Schema, or a placeholder of a Standard Schema. */\nexport type SchemaTemplate = JsonSchema | SchemaPlaceholder\n\n/** An Operation Object whose schemas are {@link SchemaTemplate}s and whose parameters may be {@link ParametersPlaceholder}s. */\nexport type OperationTemplate = OperationObjectOf<SchemaTemplate, ParametersPlaceholder>\n\n/** Root fields of the document known at build time. */\nexport interface OpenApiDocumentTemplate {\n  readonly openapi: string\n  readonly info: InfoObject\n  readonly servers?: readonly ServerObject[]\n  readonly tags?: readonly TagObject[]\n  readonly externalDocs?: ExternalDocumentationObject\n  readonly security?: readonly SecurityRequirementObject[]\n  readonly [extension: `x-${string}`]: JsonValue | undefined\n}\n\n/** A documented operation. */\nexport interface OpenApiOperationDefinition {\n  /** Controller token. */\n  readonly controller: Token\n  readonly handler: string\n  /** The compiled route method (`'ALL'` gives one definition per documented method). */\n  readonly route: string\n  readonly method: OpenApiMethod\n  /** OpenAPI path template, without the HTTP prefix (`/books/{id}`). */\n  readonly path: string\n  readonly operation: OperationTemplate\n}\n\n/** A Standard Schema converted when the document is assembled. */\nexport interface OpenApiSchemaSlot {\n  /** Component name (export name of the binding: `CreateBook`). */\n  readonly name: string\n  /** The imported schema value. */\n  readonly schema: StandardSchemaV1\n  /** The JSON Schemas needed: `input` for requests, `output` for responses. */\n  readonly io: readonly ('input' | 'output')[]\n  /** Where the schema is declared (relative path), for messages. */\n  readonly source?: { readonly file: string; readonly line: number; readonly column: number }\n}\n\n/** `metadata.extensions.openapi`. */\nexport interface OpenApiMetadata {\n  readonly version: 1\n  /** SHA-256 (base64url) of the section, schema values replaced by their names (stale-file detection). */\n  readonly fingerprint: string\n  readonly document: OpenApiDocumentTemplate\n  /** Sorted by path, then by method (get, put, post, delete, options, head, patch). */\n  readonly operations: readonly OpenApiOperationDefinition[]\n  /** JSON Schemas computed by the compiler from TypeScript declarations, by component name (sorted). */\n  readonly components: Readonly<Record<string, SchemaTemplate>>\n  readonly securitySchemes: Readonly<Record<string, SecuritySchemeObject>>\n  /** Standard Schemas converted at assembly, sorted by name. */\n  readonly schemas: readonly OpenApiSchemaSlot[]\n  /** Standard error components; absent with `errors: false`. */\n  readonly errors?: { readonly contentType: string; readonly schema?: string }\n  /** Descriptions of the default tags (JSDoc of the controllers), by tag name; absent when empty. */\n  readonly tagDescriptions?: Readonly<Record<string, string>>\n}\n\ndeclare module '@znight/core' {\n  interface ZnightExtensionsMetadata {\n    readonly openapi?: OpenApiMetadata\n  }\n}\n","/**\n * Standard Schema → JSON Schema converters (§7.3 of RFC 0002). The library that defines a schema is\n * the only one that knows its JSON Schema: Zod, ArkType and the libraries implementing Standard\n * JSON Schema convert their own schemas; Valibot goes through `@valibot/to-json-schema`.\n */\nimport type { StandardSchemaV1 } from '@znight/http'\nimport type { JsonSchema } from './types.ts'\n\n/** What a converter receives next to the schema. */\nexport interface SchemaConverterContext {\n  /** `input` for requests (what clients send), `output` for responses (what the server sends). */\n  readonly io: 'input' | 'output'\n  readonly target: 'draft-2020-12'\n  /** Retry after a failure with `unrepresentable: 'warn'`: approximate instead of throwing. */\n  readonly lenient: boolean\n}\n\n/** Converts Standard Schemas of one library to JSON Schema 2020-12. */\nexport interface SchemaConverter {\n  readonly name: string\n  /** `undefined`: not supported, the next converter is tried. Throwing reports ZNIGHT037. */\n  convert(\n    schema: StandardSchemaV1,\n    context: SchemaConverterContext,\n  ): JsonSchema | undefined | Promise<JsonSchema | undefined>\n}\n\n/** The Standard JSON Schema interface (`~standard.jsonSchema`). */\ninterface StandardJsonSchemaProps {\n  readonly vendor?: unknown\n  readonly jsonSchema?: {\n    readonly input?: (options: { target: string; libraryOptions?: Record<string, unknown> }) => unknown\n    readonly output?: (options: { target: string; libraryOptions?: Record<string, unknown> }) => unknown\n  }\n}\n\nfunction propsOf(schema: StandardSchemaV1): StandardJsonSchemaProps | undefined {\n  const props = (schema as unknown as { '~standard'?: unknown })['~standard']\n  return typeof props === 'object' && props !== null ? (props as StandardJsonSchemaProps) : undefined\n}\n\n/** `vendor` of a Standard Schema (`zod`, `valibot`, `arktype`...). */\nexport function vendorOf(schema: StandardSchemaV1): string {\n  const vendor = propsOf(schema)?.vendor\n  return typeof vendor === 'string' ? vendor : 'unknown'\n}\n\n/** How a date travels in JSON: an ISO 8601 string. */\nconst DATE_TIME: JsonSchema = Object.freeze({ type: 'string', format: 'date-time' })\n\n/**\n * Zod dates are serialised with `Date.prototype.toJSON`: in responses they are ISO strings. A\n * coerced date (`z.coerce.date()`) reads a string in requests (query, path, body). Other\n * unrepresentable parts throw (or become `{}` when lenient).\n */\nfunction zodOptions(context: SchemaConverterContext): Record<string, unknown> {\n  return {\n    unrepresentable: (site: { zodSchema?: { _zod?: { def?: { type?: unknown; coerce?: unknown } } } }) => {\n      const def = site.zodSchema?._zod?.def\n      if (def?.type === 'date' && (context.io === 'output' || def.coerce === true)) return { ...DATE_TIME }\n      return context.lenient ? 'any' : 'throw'\n    },\n  }\n}\n\n/**\n * `@valibot/to-json-schema` options: dates of responses are ISO strings (`Date.prototype.toJSON`),\n * other unrepresentable parts throw (or are left out when lenient).\n */\nfunction valibotOptions(context: SchemaConverterContext): Record<string, unknown> {\n  return {\n    ...(context.lenient ? { errorMode: 'ignore' } : {}),\n    overrideSchema: (site: { valibotSchema?: { type?: unknown } }) =>\n      context.io === 'output' && site.valibotSchema?.type === 'date' ? { ...DATE_TIME } : undefined,\n  }\n}\n\nfunction callStandard(\n  props: StandardJsonSchemaProps | undefined,\n  context: SchemaConverterContext,\n  libraryOptions?: Record<string, unknown>,\n): unknown {\n  const convert = props?.jsonSchema?.[context.io]\n  if (typeof convert !== 'function') return undefined\n  return convert.call(props?.jsonSchema, {\n    target: context.target,\n    ...(libraryOptions === undefined ? {} : { libraryOptions }),\n  })\n}\n\n/**\n * Standard JSON Schema (`schema['~standard'].jsonSchema[io]({ target: 'draft-2020-12' })`): Zod ≥ 4.2,\n * ArkType ≥ 2.1.28 and every library implementing the interface.\n */\nexport const standardJsonSchemaConverter: SchemaConverter = Object.freeze({\n  name: 'standard-json-schema',\n  convert(schema: StandardSchemaV1, context: SchemaConverterContext): JsonSchema | undefined {\n    const props = propsOf(schema)\n    if (typeof props?.jsonSchema?.[context.io] !== 'function') return undefined\n    const result = callStandard(props, context, props.vendor === 'zod' ? zodOptions(context) : undefined)\n    return result as JsonSchema | undefined\n  },\n})\n\n/** Valibot schemas (no `~standard.jsonSchema`) through `toStandardJsonSchema()` of `@valibot/to-json-schema`. */\nexport const valibotConverter: SchemaConverter = Object.freeze({\n  name: 'valibot',\n  async convert(schema: StandardSchemaV1, context: SchemaConverterContext): Promise<JsonSchema | undefined> {\n    const props = propsOf(schema)\n    if (props?.vendor !== 'valibot' || props.jsonSchema !== undefined) return undefined\n    let module: { toStandardJsonSchema?: (schema: unknown) => unknown }\n    try {\n      module = (await import('@valibot/to-json-schema')) as typeof module\n    } catch (error) {\n      throw new Error(\n        'Valibot schemas need the optional peer @valibot/to-json-schema (npm install @valibot/to-json-schema)',\n        {\n          cause: error,\n        },\n      )\n    }\n    if (typeof module.toStandardJsonSchema !== 'function') {\n      throw new Error('@valibot/to-json-schema has no toStandardJsonSchema(): install version 1.5 or later')\n    }\n    // options go through `libraryOptions` (toStandardJsonSchema takes the schema only)\n    const standard = module.toStandardJsonSchema(schema)\n    return callStandard(propsOf(standard as StandardSchemaV1), context, valibotOptions(context)) as\n      | JsonSchema\n      | undefined\n  },\n})\n\n/** Built-in converters, tried after the user's. */\nexport const BUILT_IN_CONVERTERS: readonly SchemaConverter[] = Object.freeze([\n  standardJsonSchemaConverter,\n  valibotConverter,\n])\n","/**\n * `buildOpenApiDocument` (§7.3 of RFC 0002, normative): assembles the OpenAPI document from\n * `metadata.extensions.openapi`. The same pure function runs at boot (`OpenApiPlugin`), at build time\n * (`znight openapi`, `znight build --openapi`, the `openapi()` Vite plugin) and in tests, so the\n * served document and the emitted file are byte-identical.\n */\nimport type { ZnightMetadata } from '@znight/core'\nimport type { StandardSchemaV1 } from '@znight/http'\nimport type { SchemaConverter } from './converters.ts'\nimport type { OpenApiMetadata, OpenApiSchemaSlot } from './metadata.ts'\nimport type {\n  InfoObject,\n  JsonSchema,\n  JsonValue,\n  OpenApiMethod,\n  OpenApiObject,\n  ServerObject,\n  TagObject,\n} from './types.ts'\n\nimport { displayName, ErrorCode, ZnightError } from '@znight/core'\n\nimport { BUILT_IN_CONVERTERS, vendorOf } from './converters.ts'\nimport { OPENAPI_METADATA_VERSION } from './metadata.ts'\nimport {\n  compareStrings,\n  componentName,\n  ERROR_COMPONENTS,\n  ERROR_RESPONSES,\n  jsonEquals,\n  reasonPhrase,\n  schemaRef,\n} from './shared.ts'\n\n/** A static view of an operation (no schema conversion), used by `filter` and `OpenApi.operations`. */\nexport interface OpenApiOperationView {\n  readonly method: OpenApiMethod\n  /** Path template without the HTTP prefix (`/books/{id}`). */\n  readonly path: string\n  readonly operationId: string\n  readonly tags: readonly string[]\n  /** Controller display name. */\n  readonly controller: string\n  readonly handler: string\n  /** Effective route metadata (`createRouteDecorator` values, the nearest decision of each group). */\n  readonly meta: Readonly<Record<string, unknown>>\n}\n\n/** Options of {@link buildOpenApiDocument}. */\nexport interface BuildOpenApiOptions {\n  /** The HTTP prefix: `servers` defaults to `[{ url: prefix }]` when nothing declares servers. */\n  readonly prefix?: string\n  /** Merged over the static `info`. */\n  readonly info?: Partial<InfoObject>\n  /** Replaces the declared `servers`. */\n  readonly servers?: readonly ServerObject[]\n  /** Hides operations; unreferenced components are pruned. */\n  readonly filter?: (operation: OpenApiOperationView) => boolean\n  /** Last-resort escape hatch, applied before freezing. */\n  readonly transform?: (document: OpenApiObject) => OpenApiObject\n  /** Extra converters, tried before the built-in ones. */\n  readonly converters?: readonly SchemaConverter[]\n  /** `'warn'`: a schema that cannot be converted becomes `{}` with a ZNIGHT037 warning. Default `'error'`. */\n  readonly unrepresentable?: 'error' | 'warn'\n}\n\n/** A warning of the assembly. */\nexport interface OpenApiWarning {\n  readonly code: ErrorCode\n  readonly message: string\n  readonly hints: readonly string[]\n}\n\n/** Result of {@link buildOpenApiDocument}. */\nexport interface OpenApiBuildResult {\n  /** The document, deep-frozen. */\n  readonly document: OpenApiObject\n  /** `JSON.stringify(document, null, 2)` and a final newline. */\n  readonly json: string\n  readonly warnings: readonly OpenApiWarning[]\n  readonly stats: { readonly operations: number; readonly schemas: number; readonly durationMs: number }\n}\n\ntype Json = Record<string, unknown>\n\n/** Reads and checks `metadata.extensions.openapi` (ZNIGHT030 when missing, ZNIGHT018 for another version). */\nexport function openApiSection(metadata: ZnightMetadata): OpenApiMetadata {\n  const section = (metadata?.extensions as { openapi?: unknown } | undefined)?.openapi\n  if (section === undefined || section === null || typeof section !== 'object') {\n    throw new ZnightError(\n      ErrorCode.InvalidOpenApiDefinition,\n      'The metadata has no OpenAPI section (metadata.extensions.openapi)',\n      {\n        hints: [\n          'Import @znight/openapi in a scanned file (src/main.ts imports OpenApiPlugin) and regenerate the container (znight generate)',\n        ],\n      },\n    )\n  }\n  const version = (section as { version?: unknown }).version\n  if (version !== OPENAPI_METADATA_VERSION) {\n    throw new ZnightError(\n      ErrorCode.VersionMismatch,\n      `Unsupported metadata.extensions.openapi version ${JSON.stringify(version)} (this @znight/openapi reads version ${OPENAPI_METADATA_VERSION})`,\n      { hints: ['Use the same version of @znight/compiler and @znight/openapi, then regenerate the container'] },\n    )\n  }\n  const value = section as OpenApiMetadata\n  if (!Array.isArray(value.operations) || !Array.isArray(value.schemas) || typeof value.document !== 'object') {\n    throw new ZnightError(ErrorCode.InvalidOpenApiDefinition, 'Malformed metadata.extensions.openapi', {\n      hints: ['Regenerate the container (znight generate)'],\n    })\n  }\n  return value\n}\n\n/**\n * Assembles the OpenAPI 3.1 document of an application from its generated metadata: converts the\n * Standard Schemas (user converters, Standard JSON Schema, Valibot), hoists their `$defs`, names\n * the components, fills the placeholders of the compiler, applies `filter`, prunes the unused\n * components, applies `transform`, deep-freezes and serialises once.\n *\n * @throws ZnightError ZNIGHT030 (no OpenAPI section), ZNIGHT018 (another format version), ZNIGHT034\n *   (component name conflict), ZNIGHT037 (schema conversion, unless `unrepresentable: 'warn'`).\n */\nexport async function buildOpenApiDocument(\n  metadata: ZnightMetadata,\n  options: BuildOpenApiOptions = {},\n): Promise<OpenApiBuildResult> {\n  const started = performance.now()\n  const section = openApiSection(metadata)\n  const warnings: OpenApiWarning[] = []\n  const lenient = options.unrepresentable === 'warn'\n  const converters = [...(options.converters ?? []), ...BUILT_IN_CONVERTERS]\n\n  // 1. conversion of the Standard Schemas\n  const failures: string[] = []\n  const converted = new Map<string, { input?: JsonSchema; output?: JsonSchema }>()\n  for (const slot of section.schemas) {\n    const entry: { input?: JsonSchema; output?: JsonSchema } = {}\n    for (const io of [...slot.io].sort()) {\n      const result = await convertSlot(slot, io, converters, false)\n      if (result.schema !== undefined) {\n        entry[io] = result.schema\n        continue\n      }\n      if (!lenient) {\n        failures.push(result.message)\n        continue\n      }\n      const retried = await convertSlot(slot, io, converters, true)\n      entry[io] = retried.schema ?? {}\n      warnings.push({\n        code: ErrorCode.SchemaConversionFailed,\n        message: `${result.message}; documented as ${retried.schema === undefined ? 'any value ({})' : 'an approximation'}`,\n        hints: [],\n      })\n    }\n    converted.set(slot.name, entry)\n  }\n  if (failures.length > 0) {\n    throw new ZnightError(\n      ErrorCode.SchemaConversionFailed,\n      `Cannot convert ${failures.length === 1 ? 'a schema' : `${failures.length} schemas`} to JSON Schema:\\n${failures.map(line => `  - ${line}`).join('\\n')}`,\n      {\n        hints: [\n          'Add a converter (OpenApiPlugin.configure({ converters }), --converters), or document the schema with unrepresentable: \"warn\"',\n        ],\n      },\n    )\n  }\n\n  // 2. names of the converted schemas\n  const schemas = new Map<string, JsonSchema>()\n  const owners = new Map<string, string>()\n  const define = (name: string, schema: JsonSchema, owner: string): void => {\n    const existing = schemas.get(name)\n    if (existing === undefined) {\n      schemas.set(name, schema)\n      owners.set(name, owner)\n      return\n    }\n    if (jsonEquals(existing, schema)) return\n    throw new ZnightError(\n      ErrorCode.SchemaNameConflict,\n      `Two different schemas are named \"${name}\" in the OpenAPI document (${owners.get(name)} and ${owner})`,\n      { hints: ['Rename one of them (exported schema names and ids of hoisted definitions name the components)'] },\n    )\n  }\n  for (const [name, schema] of Object.entries(section.components ?? {}))\n    define(name, schema as JsonSchema, 'a TypeScript declaration')\n  const named = nameConverted(section.schemas, converted)\n  for (const item of named.components) define(item.name, item.schema, item.owner)\n  const slotNames = named.slots\n\n  // 3. standard errors\n  const errors = section.errors\n  const responses: Json = {}\n  if (errors !== undefined) {\n    let body: string\n    let validation: string\n    if (errors.schema === undefined) {\n      define(ERROR_COMPONENTS.body, HTTP_ERROR_BODY, 'the standard errors')\n      define(ERROR_COMPONENTS.validation, VALIDATION_ERROR_BODY, 'the standard errors')\n      body = ERROR_COMPONENTS.body\n      validation = ERROR_COMPONENTS.validation\n    } else {\n      body = slotNames.get(errors.schema)?.output ?? errors.schema\n      validation = body\n    }\n    const response = (status: string, name: string): Json => ({\n      description: reasonPhrase(status),\n      content: { [errors.contentType]: { schema: { $ref: schemaRef(name) } } },\n    })\n    responses[ERROR_RESPONSES.badRequest] = response('400', validation)\n    responses[ERROR_RESPONSES.payloadTooLarge] = response('413', body)\n    responses[ERROR_RESPONSES.unsupportedMediaType] = response('415', body)\n  }\n\n  // 4. placeholders\n  const duplicates: string[] = []\n  const resolve = (value: unknown, where = ''): unknown =>\n    replacePlaceholders(value, slotNames, schemas, (parameter, slot) =>\n      duplicates.push(`${where}: the ${parameter.in} parameter \"${parameter.name}\" of the schema ${slot}`),\n    )\n  for (const [name, schema] of schemas) schemas.set(name, resolve(schema) as JsonSchema)\n\n  // 5. operations, filter\n  const views = operationViews(metadata, section)\n  const paths: Record<string, Json> = {}\n  let operations = 0\n  section.operations.forEach((definition, index) => {\n    const view = views[index] as OpenApiOperationView\n    if (options.filter !== undefined && !options.filter(view)) return\n    let item = paths[definition.path]\n    if (item === undefined) {\n      item = {}\n      paths[definition.path] = item\n    }\n    item[definition.method] = resolve(definition.operation, `${definition.method.toUpperCase()} ${definition.path}`)\n    operations++\n  })\n  if (duplicates.length > 0) {\n    warnings.push({\n      code: ErrorCode.InconsistentOperation,\n      message: `${duplicates.length === 1 ? 'A parameter expanded from a whole-object schema is' : 'Parameters expanded from whole-object schemas are'} already documented (OpenAPI forbids two parameters with one name and location), the duplicate is dropped:\\n${duplicates.map(line => `  - ${line}`).join('\\n')}`,\n      hints: [\"Remove the property from the schema, or the @Query('name') / @ApiQuery('name') that reads it again\"],\n    })\n  }\n\n  // 6. document\n  const template = section.document\n  const document: Json = { openapi: template.openapi }\n  document['info'] = options.info === undefined ? template.info : { ...template.info, ...options.info }\n  const servers =\n    options.servers ??\n    template.servers ??\n    (options.prefix !== undefined && options.prefix !== '' && options.prefix !== '/'\n      ? [{ url: options.prefix }]\n      : undefined)\n  if (servers !== undefined) document['servers'] = servers\n  if (template.security !== undefined) document['security'] = template.security\n  const tags = tagsOf(template.tags ?? [], paths, section.tagDescriptions ?? {})\n  if (tags.length > 0) document['tags'] = tags\n  if (template.externalDocs !== undefined) document['externalDocs'] = template.externalDocs\n  document['paths'] = paths\n  const components = prune(document, {\n    schemas: Object.fromEntries([...schemas].sort(([a], [b]) => compareStrings(a, b))),\n    responses,\n    securitySchemes: section.securitySchemes ?? {},\n  })\n  if (Object.keys(components).length > 0) document['components'] = components\n  for (const [key, value] of Object.entries(template)) {\n    if (key.startsWith('x-') && value !== undefined) document[key] = value\n  }\n  document['x-znight-fingerprint'] = section.fingerprint\n\n  // 7. output\n  const transformed =\n    options.transform === undefined\n      ? (document as unknown as OpenApiObject)\n      : options.transform(document as unknown as OpenApiObject)\n  const json = `${JSON.stringify(transformed, null, 2)}\\n`\n  const frozen = deepFreeze(JSON.parse(json) as OpenApiObject)\n  const componentCount = Object.keys((frozen.components?.schemas ?? {}) as object).length\n  return {\n    document: frozen,\n    json,\n    warnings,\n    stats: { operations, schemas: componentCount, durationMs: performance.now() - started },\n  }\n}\n\n/** Root keys of a document, in the order {@link buildOpenApiDocument} writes them. */\nconst ROOT_ORDER = ['openapi', 'info', 'servers', 'security', 'tags', 'externalDocs', 'paths', 'components']\n\n/**\n * Applies the runtime options of {@link buildOpenApiDocument} to a prebuilt document (`OpenApiPlugin`\n * with `document: { file }`), so that a file and a build serve the same document: `filter` (the\n * operations are matched by path and method, unreferenced components and unused tags are pruned),\n * `info`, `servers`, else the `prefix` rule when the file declares no servers, then `transform`.\n * `undefined` when there is nothing to apply (the file is served as is).\n */\nexport function applyDocumentOptions(\n  text: string,\n  metadata: ZnightMetadata,\n  options: Pick<BuildOpenApiOptions, 'filter' | 'info' | 'servers' | 'transform' | 'prefix'>,\n): { document: OpenApiObject; json: string } | undefined {\n  const document = JSON.parse(text) as Json\n  const prefixed =\n    document['servers'] === undefined && options.prefix !== undefined && options.prefix !== '' && options.prefix !== '/'\n  if (\n    options.filter === undefined &&\n    options.info === undefined &&\n    options.servers === undefined &&\n    options.transform === undefined &&\n    !prefixed\n  ) {\n    return undefined\n  }\n  if (options.filter !== undefined) filterDocument(document, metadata, options.filter)\n  if (options.info !== undefined) document['info'] = { ...(document['info'] as Json), ...options.info }\n  if (options.servers !== undefined) document['servers'] = options.servers\n  else if (prefixed) document['servers'] = [{ url: options.prefix }]\n  const ordered: Json = {}\n  for (const key of ROOT_ORDER) if (document[key] !== undefined) ordered[key] = document[key]\n  for (const [key, value] of Object.entries(document)) if (!(key in ordered)) ordered[key] = value\n  const transformed =\n    options.transform === undefined\n      ? (ordered as unknown as OpenApiObject)\n      : options.transform(ordered as unknown as OpenApiObject)\n  const json = `${JSON.stringify(transformed, null, 2)}\\n`\n  return { document: deepFreeze(JSON.parse(json) as OpenApiObject), json }\n}\n\n/** Removes the operations `filter` rejects, the paths left empty, the unused tags and components. */\nfunction filterDocument(\n  document: Json,\n  metadata: ZnightMetadata,\n  filter: (operation: OpenApiOperationView) => boolean,\n): void {\n  const section = openApiSection(metadata)\n  const views = new Map<string, OpenApiOperationView>()\n  for (const view of operationViews(metadata, section)) views.set(`${view.method} ${view.path}`, view)\n  const paths: Record<string, Json> = {}\n  for (const [path, item] of Object.entries((document['paths'] ?? {}) as Record<string, Json>)) {\n    const kept: Json = {}\n    let methods = 0\n    for (const [key, value] of Object.entries(item)) {\n      if (METHODS.has(key)) {\n        // an operation unknown to this build (stale file) is kept: the filter cannot judge it\n        const view = views.get(`${key} ${path}`)\n        if (view !== undefined && !filter(view)) continue\n        methods++\n      }\n      kept[key] = value\n    }\n    if (methods > 0) paths[path] = kept\n  }\n  document['paths'] = paths\n  if (Array.isArray(document['tags'])) {\n    const declared = new Set((section.document.tags ?? []).map(tag => tag.name))\n    const used = new Set(tagsOf([], paths, {}).map(tag => tag.name))\n    const tags = (document['tags'] as TagObject[]).filter(tag => declared.has(tag.name) || used.has(tag.name))\n    if (tags.length > 0) document['tags'] = tags\n    else delete document['tags']\n  }\n  const components = (document['components'] ?? {}) as Json\n  delete document['components']\n  const pruned = prune(document, {\n    schemas: (components['schemas'] ?? {}) as Json,\n    responses: (components['responses'] ?? {}) as Json,\n    securitySchemes: (components['securitySchemes'] ?? {}) as Json,\n  })\n  const result: Json = {}\n  for (const [kind, value] of Object.entries(components)) {\n    if (kind !== 'schemas' && kind !== 'responses' && kind !== 'securitySchemes') result[kind] = value\n    else if (pruned[kind] !== undefined) result[kind] = pruned[kind]\n  }\n  if (Object.keys(result).length > 0) document['components'] = result\n}\n\nconst METHODS: ReadonlySet<string> = new Set(['get', 'put', 'post', 'delete', 'options', 'head', 'patch', 'trace'])\n\nasync function convertSlot(\n  slot: OpenApiSchemaSlot,\n  io: 'input' | 'output',\n  converters: readonly SchemaConverter[],\n  lenient: boolean,\n): Promise<{ schema: JsonSchema | undefined; message: string }> {\n  const where = slot.source === undefined ? '' : ` (${slot.source.file}:${slot.source.line}:${slot.source.column})`\n  const label = `${slot.name}${where}, ${vendorOf(slot.schema)} schema, ${io}`\n  for (const converter of converters) {\n    let result: unknown\n    try {\n      result = await converter.convert(slot.schema as StandardSchemaV1, { io, target: 'draft-2020-12', lenient })\n    } catch (error) {\n      return {\n        schema: undefined,\n        message: `${label}: the converter \"${converter.name}\" failed: ${error instanceof Error ? error.message : String(error)}`,\n      }\n    }\n    if (result === undefined) continue\n    if (typeof result !== 'object' || result === null || Array.isArray(result)) {\n      return {\n        schema: undefined,\n        message: `${label}: the converter \"${converter.name}\" returned ${Array.isArray(result) ? 'an array' : typeof result} instead of a JSON Schema object`,\n      }\n    }\n    return { schema: result as JsonSchema, message: '' }\n  }\n  return {\n    schema: undefined,\n    message: `${label}: no converter supports it (the library implements no Standard JSON Schema)`,\n  }\n}\n\n/** Drops `$schema` and `$id` (top level). */\nfunction clean(schema: JsonSchema): JsonSchema {\n  const { $schema: _schema, $id: _id, ...rest } = schema\n  return JSON.parse(JSON.stringify(rest)) as JsonSchema\n}\n\n/**\n * Definition names a library generates for anonymous sub-schemas (Zod: `__schema0` for a recursive\n * schema without id). They are local to one conversion, so they are scoped to their slot.\n */\nconst ANONYMOUS_DEFINITION = /^__schema(\\d+)$/\n\n/** Marks the references between definitions until the final names are known (`\\0<name>\\0<rest>`). */\nconst MARK = '\\u0000'\n\n/** A JSON Schema of one slot and one io, split into its root and its local definitions. */\ninterface ConvertedUnit {\n  readonly slot: string\n  readonly io: 'input' | 'output'\n  /** Global names of the bodies (the root is the slot name), references marked. */\n  readonly bodies: { readonly name: string; readonly body: unknown; readonly owner: string }[]\n}\n\n/**\n * Names the converted schemas (steps 3 and 4 of §7.3): hoists `$defs` / `definitions` into\n * components, scopes anonymous definitions to their slot (`Tree_schema0`), takes the definition as\n * the slot component when the root only references it (`.meta({ id })` equal to the export name),\n * and gives `<Name>Input` to the input variant of every schema — slot or definition — whose input\n * and output JSON Schemas differ (directly or through the definitions it references). Two different\n * schemas of one io under one name are ZNIGHT034.\n */\nfunction nameConverted(\n  slots: readonly OpenApiSchemaSlot[],\n  converted: ReadonlyMap<string, { input?: JsonSchema; output?: JsonSchema }>,\n): {\n  components: { name: string; schema: JsonSchema; owner: string }[]\n  slots: Map<string, { input?: string; output?: string }>\n} {\n  const units: ConvertedUnit[] = []\n  for (const slot of slots) {\n    const entry = converted.get(slot.name) ?? {}\n    for (const io of ['output', 'input'] as const) {\n      const schema = entry[io]\n      if (schema !== undefined) units.push(splitUnit(slot.name, io, clean(schema)))\n    }\n  }\n  // variants of every global name, by io\n  const variants = new Map<string, { input?: unknown; output?: unknown; owners: Partial<Record<string, string>> }>()\n  for (const unit of units) {\n    for (const { name, body, owner } of unit.bodies) {\n      let entry = variants.get(name)\n      if (entry === undefined) {\n        entry = { owners: {} }\n        variants.set(name, entry)\n      }\n      const existing = entry[unit.io]\n      if (existing === undefined) {\n        entry[unit.io] = body\n        entry.owners[unit.io] = owner\n      } else if (!jsonEquals(existing, body)) {\n        throw new ZnightError(\n          ErrorCode.SchemaNameConflict,\n          `Two different schemas are named \"${name}\" in the OpenAPI document (${entry.owners[unit.io]} and ${owner})`,\n          { hints: ['Rename one of them (exported schema names and ids of hoisted definitions name the components)'] },\n        )\n      }\n    }\n  }\n  // `<Name>Input` when the input variant differs, directly or through a definition it references\n  const split = new Set<string>()\n  for (const [name, entry] of variants) {\n    if (entry.input !== undefined && entry.output !== undefined && !jsonEquals(entry.input, entry.output)) {\n      split.add(name)\n    }\n  }\n  for (let changed = true; changed; ) {\n    changed = false\n    for (const [name, entry] of variants) {\n      if (split.has(name) || entry.input === undefined || entry.output === undefined) continue\n      if ([...referencedNames(entry.input)].some(target => split.has(target))) {\n        split.add(name)\n        changed = true\n      }\n    }\n  }\n  const nameFor = (name: string, io: 'input' | 'output'): string =>\n    io === 'input' && split.has(name) ? `${name}Input` : name\n  const components: { name: string; schema: JsonSchema; owner: string }[] = []\n  for (const [name, entry] of variants) {\n    if (entry.output !== undefined) {\n      components.push({\n        name,\n        schema: resolveMarks(entry.output, 'output', nameFor) as JsonSchema,\n        owner: entry.owners['output'] as string,\n      })\n    }\n    if (entry.input !== undefined && (entry.output === undefined || split.has(name))) {\n      components.push({\n        name: nameFor(name, 'input'),\n        schema: resolveMarks(entry.input, 'input', nameFor) as JsonSchema,\n        owner: entry.owners['input'] as string,\n      })\n    }\n  }\n  const names = new Map<string, { input?: string; output?: string }>()\n  for (const slot of slots) {\n    const entry = converted.get(slot.name) ?? {}\n    const result: { input?: string; output?: string } = {}\n    if (entry.output !== undefined) result.output = nameFor(slot.name, 'output')\n    if (entry.input !== undefined) result.input = nameFor(slot.name, 'input')\n    names.set(slot.name, result)\n  }\n  return { components, slots: names }\n}\n\n/**\n * Splits a converted schema into its root and its `$defs` / `definitions` (at every level), with\n * global names: the slot name for the root, `<slot>_schemaN` for anonymous definitions, the\n * definition name (a library id) otherwise. Inside an OpenAPI document `#` is the document, not the\n * schema, so every local reference is rewritten (`#/$defs/X`, `#`, `#/properties/...`).\n */\nfunction splitUnit(slot: string, io: 'input' | 'output', schema: JsonSchema): ConvertedUnit {\n  const defs = new Map<string, unknown>()\n  const collect = (value: unknown): void => {\n    if (typeof value !== 'object' || value === null) return\n    if (Array.isArray(value)) {\n      for (const item of value) collect(item)\n      return\n    }\n    for (const key of ['$defs', 'definitions']) {\n      const block = (value as Json)[key]\n      if (typeof block === 'object' && block !== null && !Array.isArray(block)) {\n        for (const [defName, def] of Object.entries(block)) defs.set(defName, def)\n      }\n    }\n    for (const [key, item] of Object.entries(value)) if (key !== '$defs' && key !== 'definitions') collect(item)\n  }\n  collect(schema)\n  const globals = new Map<string, string>()\n  for (const local of defs.keys()) {\n    const anonymous = ANONYMOUS_DEFINITION.exec(local)\n    globals.set(local, anonymous === null ? componentName(local) : componentName(`${slot}_schema${anonymous[1]}`))\n  }\n  let root: unknown = schema\n  // `{ $ref: '#/$defs/X', $defs: { X } }` (Zod `.meta({ id })` on the root): X is the slot itself\n  const keys = Object.keys(schema).filter(key => key !== '$defs' && key !== 'definitions')\n  const target = keys.length === 1 && typeof schema['$ref'] === 'string' ? localTarget(schema['$ref']) : undefined\n  if (target !== undefined && target.rest === '' && defs.has(target.local)) {\n    const global = globals.get(target.local) as string\n    if (global === slot || ANONYMOUS_DEFINITION.test(target.local)) {\n      root = defs.get(target.local)\n      defs.delete(target.local)\n      globals.set(target.local, slot)\n    }\n  }\n  const rewrite = (value: unknown): unknown => {\n    if (Array.isArray(value)) return value.map(rewrite)\n    if (typeof value !== 'object' || value === null) return value\n    const result: Json = {}\n    for (const [key, item] of Object.entries(value)) {\n      if (key === '$defs' || key === 'definitions') continue\n      if (key === '$ref' && typeof item === 'string') result[key] = markRef(item, slot, globals)\n      else result[key] = rewrite(item)\n    }\n    return result\n  }\n  const bodies = [{ name: slot, body: rewrite(root), owner: `the schema ${slot}` }]\n  for (const [local, def] of defs) {\n    bodies.push({ name: globals.get(local) as string, body: rewrite(def), owner: `a definition of ${slot}` })\n  }\n  return { slot, io, bodies }\n}\n\n/** The local definition a reference points to (`#/$defs/X/rest`), JSON pointer and URI escapes decoded. */\nfunction localTarget(ref: string): { local: string; rest: string } | undefined {\n  for (const prefix of ['#/$defs/', '#/definitions/']) {\n    if (!ref.startsWith(prefix)) continue\n    const tail = ref.slice(prefix.length)\n    const slash = tail.indexOf('/')\n    const segment = slash === -1 ? tail : tail.slice(0, slash)\n    let local: string\n    try {\n      local = decodeURIComponent(segment)\n    } catch {\n      local = segment\n    }\n    return { local: local.replaceAll('~1', '/').replaceAll('~0', '~'), rest: slash === -1 ? '' : tail.slice(slash) }\n  }\n  return undefined\n}\n\nfunction markRef(ref: string, slot: string, globals: ReadonlyMap<string, string>): string {\n  const target = localTarget(ref)\n  if (target !== undefined) {\n    return `${MARK}${globals.get(target.local) ?? componentName(target.local)}${MARK}${target.rest}`\n  }\n  if (ref === '#') return `${MARK}${slot}${MARK}`\n  if (ref.startsWith('#/')) return `${MARK}${slot}${MARK}${ref.slice(1)}`\n  return ref\n}\n\nfunction parseMark(ref: string): { name: string; rest: string } | undefined {\n  if (!ref.startsWith(MARK)) return undefined\n  const end = ref.indexOf(MARK, 1)\n  return end === -1 ? undefined : { name: ref.slice(1, end), rest: ref.slice(end + 1) }\n}\n\n/** Global names referenced by a marked body. */\nfunction referencedNames(value: unknown, found: Set<string> = new Set()): Set<string> {\n  if (Array.isArray(value)) {\n    for (const item of value) referencedNames(item, found)\n  } else if (typeof value === 'object' && value !== null) {\n    for (const [key, item] of Object.entries(value)) {\n      const mark = key === '$ref' && typeof item === 'string' ? parseMark(item) : undefined\n      if (mark === undefined) referencedNames(item, found)\n      else found.add(mark.name)\n    }\n  }\n  return found\n}\n\n/** Replaces the marked references with `#/components/schemas/<final name>`. */\nfunction resolveMarks(\n  value: unknown,\n  io: 'input' | 'output',\n  nameFor: (name: string, io: 'input' | 'output') => string,\n): unknown {\n  if (Array.isArray(value)) return value.map(item => resolveMarks(item, io, nameFor))\n  if (typeof value !== 'object' || value === null) return value\n  const result: Json = {}\n  for (const [key, item] of Object.entries(value)) {\n    const mark = key === '$ref' && typeof item === 'string' ? parseMark(item) : undefined\n    result[key] =\n      mark === undefined ? resolveMarks(item, io, nameFor) : `${schemaRef(nameFor(mark.name, io))}${mark.rest}`\n  }\n  return result\n}\n\nfunction isPlaceholder(\n  value: unknown,\n): value is { $znight: string; name: string; io: 'input' | 'output'; in?: string } {\n  return typeof value === 'object' && value !== null && typeof (value as { $znight?: unknown }).$znight === 'string'\n}\n\nfunction replacePlaceholders(\n  value: unknown,\n  names: ReadonlyMap<string, { input?: string; output?: string }>,\n  schemas: ReadonlyMap<string, JsonSchema>,\n  duplicate: (parameter: { in: string; name: string }, slot: string) => void,\n): unknown {\n  if (Array.isArray(value)) {\n    if (!value.some(item => isPlaceholder(item) && item.$znight === 'parameters')) {\n      return value.map(item => replacePlaceholders(item, names, schemas, duplicate))\n    }\n    // a parameters array: OpenAPI forbids two parameters with one name and location, explicit ones win\n    const explicit = new Set<string>()\n    for (const item of value) {\n      const key = isPlaceholder(item) ? undefined : parameterKey(item)\n      if (key !== undefined) explicit.add(key)\n    }\n    const expanded = new Set<string>()\n    const result: unknown[] = []\n    for (const item of value) {\n      if (!isPlaceholder(item) || item.$znight !== 'parameters') {\n        result.push(replacePlaceholders(item, names, schemas, duplicate))\n        continue\n      }\n      for (const parameter of expandParameters(item, names, schemas)) {\n        const key = parameterKey(parameter) as string\n        if (explicit.has(key) || expanded.has(key)) {\n          duplicate(parameter as { in: string; name: string }, item.name)\n          continue\n        }\n        expanded.add(key)\n        result.push(parameter)\n      }\n    }\n    return result\n  }\n  if (typeof value !== 'object' || value === null) return value\n  if (isPlaceholder(value) && value.$znight === 'schema') {\n    const name = names.get(value.name)?.[value.io] ?? value.name\n    return { $ref: schemaRef(name) }\n  }\n  const result: Json = {}\n  for (const [key, item] of Object.entries(value)) result[key] = replacePlaceholders(item, names, schemas, duplicate)\n  return result\n}\n\n/** `in name` of a Parameter Object (header names are case-insensitive), `undefined` for a `$ref`. */\nfunction parameterKey(parameter: unknown): string | undefined {\n  if (typeof parameter !== 'object' || parameter === null) return undefined\n  const { in: location, name } = parameter as { in?: unknown; name?: unknown }\n  if (typeof location !== 'string' || typeof name !== 'string') return undefined\n  return `${location} ${location === 'header' ? name.toLowerCase() : name}`\n}\n\n/** One parameter per property of the (input) object schema of a slot. */\nfunction expandParameters(\n  placeholder: { name: string; in?: string },\n  names: ReadonlyMap<string, { input?: string; output?: string }>,\n  schemas: ReadonlyMap<string, JsonSchema>,\n): Json[] {\n  const name = names.get(placeholder.name)?.input ?? placeholder.name\n  let schema = schemas.get(name)\n  for (let depth = 0; depth < 8 && typeof schema?.['$ref'] === 'string'; depth++) {\n    schema = schemas.get(String(schema['$ref']).slice('#/components/schemas/'.length))\n  }\n  const properties = schema?.['properties']\n  if (schema === undefined || typeof properties !== 'object' || properties === null || Array.isArray(properties)) {\n    throw new ZnightError(\n      ErrorCode.SchemaConversionFailed,\n      `The ${placeholder.in ?? 'query'} schema ${placeholder.name} is not an object schema: its properties cannot become parameters`,\n      { hints: [`Validate the whole ${placeholder.in ?? 'query'} object with an object schema (z.object({...}))`] },\n    )\n  }\n  const required = new Set(Array.isArray(schema['required']) ? (schema['required'] as string[]) : [])\n  return Object.entries(properties).map(([property, propertySchema]) => {\n    const { description, ...rest } = propertySchema as Json\n    const parameter: Json = { name: property, in: placeholder.in ?? 'query' }\n    if (typeof description === 'string') parameter['description'] = description\n    if (placeholder.in === 'path' || required.has(property)) parameter['required'] = true\n    parameter['schema'] = rest\n    if ((rest['type'] === 'array' || Array.isArray(rest['items'])) && placeholder.in === 'query') {\n      parameter['style'] = 'form'\n      parameter['explode'] = true\n    }\n    return parameter\n  })\n}\n\n/** Declared tags first (in order), then the used tags, sorted. */\nfunction tagsOf(\n  declared: readonly TagObject[],\n  paths: Readonly<Record<string, Json>>,\n  descriptions: Readonly<Record<string, string>>,\n): TagObject[] {\n  const tags: TagObject[] = [...declared]\n  const known = new Set(declared.map(tag => tag.name))\n  const used = new Set<string>()\n  for (const item of Object.values(paths)) {\n    for (const operation of Object.values(item)) {\n      for (const tag of ((operation as { tags?: unknown }).tags ?? []) as string[]) used.add(tag)\n    }\n  }\n  for (const tag of [...used].sort(compareStrings)) {\n    if (known.has(tag)) continue\n    const description = descriptions[tag]\n    tags.push(description === undefined ? { name: tag } : { name: tag, description })\n  }\n  return tags\n}\n\n/** Components referenced by the document (paths, security), transitively. */\nfunction prune(document: Json, components: { schemas: Json; responses: Json; securitySchemes: Json }): Json {\n  const used = { schemas: new Set<string>(), responses: new Set<string>(), securitySchemes: new Set<string>() }\n  const visit = (value: unknown): void => {\n    if (Array.isArray(value)) {\n      for (const item of value) visit(item)\n      return\n    }\n    if (typeof value !== 'object' || value === null) return\n    for (const [key, item] of Object.entries(value)) {\n      if (key === '$ref' && typeof item === 'string') {\n        const match = /^#\\/components\\/(schemas|responses)\\/([^/]+)/.exec(item)\n        const kind = match?.[1] as 'schemas' | 'responses' | undefined\n        const name =\n          match?.[2] === undefined\n            ? undefined\n            : decodeURIComponent(match[2].replaceAll('~1', '/').replaceAll('~0', '~'))\n        if (kind !== undefined && name !== undefined && !used[kind].has(name)) {\n          used[kind].add(name)\n          visit(components[kind][name])\n        }\n      } else if (key === 'security' && Array.isArray(item)) {\n        for (const requirement of item)\n          for (const scheme of Object.keys(requirement as object)) used.securitySchemes.add(scheme)\n      } else {\n        visit(item)\n      }\n    }\n  }\n  visit(document)\n  const result: Json = {}\n  for (const kind of ['schemas', 'responses', 'securitySchemes'] as const) {\n    const kept: Json = {}\n    for (const name of Object.keys(components[kind]).sort(compareStrings)) {\n      if (used[kind].has(name)) kept[name] = components[kind][name]\n    }\n    if (Object.keys(kept).length > 0) result[kind] = kept\n  }\n  return result\n}\n\n/** Views of the operations of the section (effective route metadata from `extensions.http`). */\nexport function operationViews(\n  metadata: ZnightMetadata,\n  section: OpenApiMetadata = openApiSection(metadata),\n): OpenApiOperationView[] {\n  const http = (metadata.extensions as { http?: HttpSectionLike } | undefined)?.http\n  const groups = new Map<string, string>()\n  for (const [group, definition] of Object.entries(http?.groups ?? {})) {\n    for (const key of definition.keys ?? []) groups.set(key, group)\n  }\n  const groupOf = (key: string): string => groups.get(key) ?? key\n  return section.operations.map(definition => {\n    const controller = http?.controllers?.find(candidate => candidate.token === definition.controller)\n    const route = controller?.routes?.find(\n      candidate => candidate.handler === definition.handler && candidate.method === definition.route,\n    )\n    const routeMeta = route?.meta ?? {}\n    const decided = new Set(Object.keys(routeMeta).map(groupOf))\n    const meta: Record<string, unknown> = {}\n    for (const [key, value] of Object.entries(controller?.meta ?? {})) if (!decided.has(groupOf(key))) meta[key] = value\n    Object.assign(meta, routeMeta)\n    const operation = definition.operation as { operationId?: string; tags?: readonly string[] }\n    return Object.freeze({\n      method: definition.method,\n      path: definition.path,\n      operationId: operation.operationId ?? '',\n      tags: Object.freeze([...(operation.tags ?? [])]),\n      controller: displayName(definition.controller),\n      handler: definition.handler,\n      meta: Object.freeze(meta),\n    })\n  })\n}\n\n/** The parts of `metadata.extensions.http` read for the effective metadata. */\ninterface HttpSectionLike {\n  readonly controllers?: readonly {\n    readonly token: string\n    readonly meta?: Readonly<Record<string, unknown>>\n    readonly routes?: readonly {\n      readonly method: string\n      readonly handler: string\n      readonly meta?: Readonly<Record<string, unknown>>\n    }[]\n  }[]\n  readonly groups?: Readonly<Record<string, { readonly keys?: readonly string[] }>>\n}\n\nfunction deepFreeze<T>(value: T): T {\n  if (typeof value === 'object' && value !== null && !Object.isFrozen(value)) {\n    Object.freeze(value)\n    for (const item of Object.values(value)) deepFreeze(item)\n  }\n  return value\n}\n\n/** `HttpErrorBody` (the body of every Znight error response). */\nconst HTTP_ERROR_BODY: JsonSchema = {\n  type: 'object',\n  properties: {\n    statusCode: { type: 'integer' },\n    error: { type: 'string' },\n    message: { type: 'string' },\n    details: {},\n  },\n  required: ['statusCode', 'error', 'message'],\n}\n\n/** `ValidationErrorBody`: a 400 body; validation failures list their issues in `details`. */\nconst VALIDATION_ERROR_BODY: JsonSchema = {\n  allOf: [\n    { $ref: schemaRef(ERROR_COMPONENTS.body) },\n    {\n      type: 'object',\n      properties: {\n        details: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: { path: { type: 'string' }, message: { type: 'string' } },\n            required: ['path', 'message'],\n          },\n        },\n      },\n    },\n  ],\n} satisfies Record<string, JsonValue>\n"],"mappings":";;;;AAwBA,MAAa,2BAA2B;;ACYxC,SAAS,QAAQ,QAA+D;CAC9E,MAAM,QAAS,OAAgD;CAC/D,OAAO,OAAO,UAAU,YAAY,UAAU,OAAQ,QAAoC,KAAA;AAC5F;;AAGA,SAAgB,SAAS,QAAkC;CACzD,MAAM,SAAS,QAAQ,MAAM,CAAC,EAAE;CAChC,OAAO,OAAO,WAAW,WAAW,SAAS;AAC/C;;AAGA,MAAM,YAAwB,OAAO,OAAO;CAAE,MAAM;CAAU,QAAQ;AAAY,CAAC;;;;;;AAOnF,SAAS,WAAW,SAA0D;CAC5E,OAAO,EACL,kBAAkB,SAAoF;EACpG,MAAM,MAAM,KAAK,WAAW,MAAM;EAClC,IAAI,KAAK,SAAS,WAAW,QAAQ,OAAO,YAAY,IAAI,WAAW,OAAO,OAAO,EAAE,GAAG,UAAU;EACpG,OAAO,QAAQ,UAAU,QAAQ;CACnC,EACF;AACF;;;;;AAMA,SAAS,eAAe,SAA0D;CAChF,OAAO;EACL,GAAI,QAAQ,UAAU,EAAE,WAAW,SAAS,IAAI,CAAC;EACjD,iBAAiB,SACf,QAAQ,OAAO,YAAY,KAAK,eAAe,SAAS,SAAS,EAAE,GAAG,UAAU,IAAI,KAAA;CACxF;AACF;AAEA,SAAS,aACP,OACA,SACA,gBACS;CACT,MAAM,UAAU,OAAO,aAAa,QAAQ;CAC5C,IAAI,OAAO,YAAY,YAAY,OAAO,KAAA;CAC1C,OAAO,QAAQ,KAAK,OAAO,YAAY;EACrC,QAAQ,QAAQ;EAChB,GAAI,mBAAmB,KAAA,IAAY,CAAC,IAAI,EAAE,eAAe;CAC3D,CAAC;AACH;;;;;AAMA,MAAa,8BAA+C,OAAO,OAAO;CACxE,MAAM;CACN,QAAQ,QAA0B,SAAyD;EACzF,MAAM,QAAQ,QAAQ,MAAM;EAC5B,IAAI,OAAO,OAAO,aAAa,QAAQ,QAAQ,YAAY,OAAO,KAAA;EAElE,OADe,aAAa,OAAO,SAAS,MAAM,WAAW,QAAQ,WAAW,OAAO,IAAI,KAAA,CAC/E;CACd;AACF,CAAC;;AAGD,MAAa,mBAAoC,OAAO,OAAO;CAC7D,MAAM;CACN,MAAM,QAAQ,QAA0B,SAAkE;EACxG,MAAM,QAAQ,QAAQ,MAAM;EAC5B,IAAI,OAAO,WAAW,aAAa,MAAM,eAAe,KAAA,GAAW,OAAO,KAAA;EAC1E,IAAI;EACJ,IAAI;GACF,SAAU,MAAM,OAAO;EACzB,SAAS,OAAO;GACd,MAAM,IAAI,MACR,wGACA,EACE,OAAO,MACT,CACF;EACF;EACA,IAAI,OAAO,OAAO,yBAAyB,YACzC,MAAM,IAAI,MAAM,qFAAqF;EAIvG,OAAO,aAAa,QADH,OAAO,qBAAqB,MACV,CAAqB,GAAG,SAAS,eAAe,OAAO,CAAC;CAG7F;AACF,CAAC;;AAGD,MAAa,sBAAkD,OAAO,OAAO,CAC3E,6BACA,gBACF,CAAC;;;AClDD,SAAgB,eAAe,UAA2C;CACxE,MAAM,WAAW,UAAU,WAAA,EAAkD;CAC7E,IAAI,YAAY,KAAA,KAAa,YAAY,QAAQ,OAAO,YAAY,UAClE,MAAM,IAAI,YACR,UAAU,0BACV,qEACA,EACE,OAAO,CACL,6HACF,EACF,CACF;CAEF,MAAM,UAAW,QAAkC;CACnD,IAAI,YAAA,GACF,MAAM,IAAI,YACR,UAAU,iBACV,mDAAmD,KAAK,UAAU,OAAO,EAAE,0CAC3E,EAAE,OAAO,CAAC,6FAA6F,EAAE,CAC3G;CAEF,MAAM,QAAQ;CACd,IAAI,CAAC,MAAM,QAAQ,MAAM,UAAU,KAAK,CAAC,MAAM,QAAQ,MAAM,OAAO,KAAK,OAAO,MAAM,aAAa,UACjG,MAAM,IAAI,YAAY,UAAU,0BAA0B,yCAAyC,EACjG,OAAO,CAAC,4CAA4C,EACtD,CAAC;CAEH,OAAO;AACT;;;;;;;;;;AAWA,eAAsB,qBACpB,UACA,UAA+B,CAAC,GACH;CAC7B,MAAM,UAAU,YAAY,IAAI;CAChC,MAAM,UAAU,eAAe,QAAQ;CACvC,MAAM,WAA6B,CAAC;CACpC,MAAM,UAAU,QAAQ,oBAAoB;CAC5C,MAAM,aAAa,CAAC,GAAI,QAAQ,cAAc,CAAC,GAAI,GAAG,mBAAmB;CAGzE,MAAM,WAAqB,CAAC;CAC5B,MAAM,4BAAY,IAAI,IAAyD;CAC/E,KAAK,MAAM,QAAQ,QAAQ,SAAS;EAClC,MAAM,QAAqD,CAAC;EAC5D,KAAK,MAAM,MAAM,CAAC,GAAG,KAAK,EAAE,CAAC,CAAC,KAAK,GAAG;GACpC,MAAM,SAAS,MAAM,YAAY,MAAM,IAAI,YAAY,KAAK;GAC5D,IAAI,OAAO,WAAW,KAAA,GAAW;IAC/B,MAAM,MAAM,OAAO;IACnB;GACF;GACA,IAAI,CAAC,SAAS;IACZ,SAAS,KAAK,OAAO,OAAO;IAC5B;GACF;GACA,MAAM,UAAU,MAAM,YAAY,MAAM,IAAI,YAAY,IAAI;GAC5D,MAAM,MAAM,QAAQ,UAAU,CAAC;GAC/B,SAAS,KAAK;IACZ,MAAM,UAAU;IAChB,SAAS,GAAG,OAAO,QAAQ,kBAAkB,QAAQ,WAAW,KAAA,IAAY,mBAAmB;IAC/F,OAAO,CAAC;GACV,CAAC;EACH;EACA,UAAU,IAAI,KAAK,MAAM,KAAK;CAChC;CACA,IAAI,SAAS,SAAS,GACpB,MAAM,IAAI,YACR,UAAU,wBACV,kBAAkB,SAAS,WAAW,IAAI,aAAa,GAAG,SAAS,OAAO,UAAU,oBAAoB,SAAS,KAAI,SAAQ,OAAO,MAAM,CAAC,CAAC,KAAK,IAAI,KACrJ,EACE,OAAO,CACL,gIACF,EACF,CACF;CAIF,MAAM,0BAAU,IAAI,IAAwB;CAC5C,MAAM,yBAAS,IAAI,IAAoB;CACvC,MAAM,UAAU,MAAc,QAAoB,UAAwB;EACxE,MAAM,WAAW,QAAQ,IAAI,IAAI;EACjC,IAAI,aAAa,KAAA,GAAW;GAC1B,QAAQ,IAAI,MAAM,MAAM;GACxB,OAAO,IAAI,MAAM,KAAK;GACtB;EACF;EACA,IAAI,WAAW,UAAU,MAAM,GAAG;EAClC,MAAM,IAAI,YACR,UAAU,oBACV,oCAAoC,KAAK,6BAA6B,OAAO,IAAI,IAAI,EAAE,OAAO,MAAM,IACpG,EAAE,OAAO,CAAC,+FAA+F,EAAE,CAC7G;CACF;CACA,KAAK,MAAM,CAAC,MAAM,WAAW,OAAO,QAAQ,QAAQ,cAAc,CAAC,CAAC,GAClE,OAAO,MAAM,QAAsB,0BAA0B;CAC/D,MAAM,QAAQ,cAAc,QAAQ,SAAS,SAAS;CACtD,KAAK,MAAM,QAAQ,MAAM,YAAY,OAAO,KAAK,MAAM,KAAK,QAAQ,KAAK,KAAK;CAC9E,MAAM,YAAY,MAAM;CAGxB,MAAM,SAAS,QAAQ;CACvB,MAAM,YAAkB,CAAC;CACzB,IAAI,WAAW,KAAA,GAAW;EACxB,IAAI;EACJ,IAAI;EACJ,IAAI,OAAO,WAAW,KAAA,GAAW;GAC/B,OAAO,iBAAiB,MAAM,iBAAiB,qBAAqB;GACpE,OAAO,iBAAiB,YAAY,uBAAuB,qBAAqB;GAChF,OAAO,iBAAiB;GACxB,aAAa,iBAAiB;EAChC,OAAO;GACL,OAAO,UAAU,IAAI,OAAO,MAAM,CAAC,EAAE,UAAU,OAAO;GACtD,aAAa;EACf;EACA,MAAM,YAAY,QAAgB,UAAwB;GACxD,aAAa,aAAa,MAAM;GAChC,SAAS,GAAG,OAAO,cAAc,EAAE,QAAQ,EAAE,MAAM,UAAU,IAAI,EAAE,EAAE,EAAE;EACzE;EACA,UAAU,gBAAgB,cAAc,SAAS,OAAO,UAAU;EAClE,UAAU,gBAAgB,mBAAmB,SAAS,OAAO,IAAI;EACjE,UAAU,gBAAgB,wBAAwB,SAAS,OAAO,IAAI;CACxE;CAGA,MAAM,aAAuB,CAAC;CAC9B,MAAM,WAAW,OAAgB,QAAQ,OACvC,oBAAoB,OAAO,WAAW,UAAU,WAAW,SACzD,WAAW,KAAK,GAAG,MAAM,QAAQ,UAAU,GAAG,cAAc,UAAU,KAAK,kBAAkB,MAAM,CACrG;CACF,KAAK,MAAM,CAAC,MAAM,WAAW,SAAS,QAAQ,IAAI,MAAM,QAAQ,MAAM,CAAe;CAGrF,MAAM,QAAQ,eAAe,UAAU,OAAO;CAC9C,MAAM,QAA8B,CAAC;CACrC,IAAI,aAAa;CACjB,QAAQ,WAAW,SAAS,YAAY,UAAU;EAChD,MAAM,OAAO,MAAM;EACnB,IAAI,QAAQ,WAAW,KAAA,KAAa,CAAC,QAAQ,OAAO,IAAI,GAAG;EAC3D,IAAI,OAAO,MAAM,WAAW;EAC5B,IAAI,SAAS,KAAA,GAAW;GACtB,OAAO,CAAC;GACR,MAAM,WAAW,QAAQ;EAC3B;EACA,KAAK,WAAW,UAAU,QAAQ,WAAW,WAAW,GAAG,WAAW,OAAO,YAAY,EAAE,GAAG,WAAW,MAAM;EAC/G;CACF,CAAC;CACD,IAAI,WAAW,SAAS,GACtB,SAAS,KAAK;EACZ,MAAM,UAAU;EAChB,SAAS,GAAG,WAAW,WAAW,IAAI,uDAAuD,oDAAoD,8GAA8G,WAAW,KAAI,SAAQ,OAAO,MAAM,CAAC,CAAC,KAAK,IAAI;EAC9S,OAAO,CAAC,oGAAoG;CAC9G,CAAC;CAIH,MAAM,WAAW,QAAQ;CACzB,MAAM,WAAiB,EAAE,SAAS,SAAS,QAAQ;CACnD,SAAS,UAAU,QAAQ,SAAS,KAAA,IAAY,SAAS,OAAO;EAAE,GAAG,SAAS;EAAM,GAAG,QAAQ;CAAK;CACpG,MAAM,UACJ,QAAQ,WACR,SAAS,YACR,QAAQ,WAAW,KAAA,KAAa,QAAQ,WAAW,MAAM,QAAQ,WAAW,MACzE,CAAC,EAAE,KAAK,QAAQ,OAAO,CAAC,IACxB,KAAA;CACN,IAAI,YAAY,KAAA,GAAW,SAAS,aAAa;CACjD,IAAI,SAAS,aAAa,KAAA,GAAW,SAAS,cAAc,SAAS;CACrE,MAAM,OAAO,OAAO,SAAS,QAAQ,CAAC,GAAG,OAAO,QAAQ,mBAAmB,CAAC,CAAC;CAC7E,IAAI,KAAK,SAAS,GAAG,SAAS,UAAU;CACxC,IAAI,SAAS,iBAAiB,KAAA,GAAW,SAAS,kBAAkB,SAAS;CAC7E,SAAS,WAAW;CACpB,MAAM,aAAa,MAAM,UAAU;EACjC,SAAS,OAAO,YAAY,CAAC,GAAG,OAAO,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,eAAe,GAAG,CAAC,CAAC,CAAC;EACjF;EACA,iBAAiB,QAAQ,mBAAmB,CAAC;CAC/C,CAAC;CACD,IAAI,OAAO,KAAK,UAAU,CAAC,CAAC,SAAS,GAAG,SAAS,gBAAgB;CACjE,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,QAAQ,GAChD,IAAI,IAAI,WAAW,IAAI,KAAK,UAAU,KAAA,GAAW,SAAS,OAAO;CAEnE,SAAS,0BAA0B,QAAQ;CAG3C,MAAM,cACJ,QAAQ,cAAc,KAAA,IACjB,WACD,QAAQ,UAAU,QAAoC;CAC5D,MAAM,OAAO,GAAG,KAAK,UAAU,aAAa,MAAM,CAAC,EAAE;CACrD,MAAM,SAAS,WAAW,KAAK,MAAM,IAAI,CAAkB;CAC3D,MAAM,iBAAiB,OAAO,KAAM,OAAO,YAAY,WAAW,CAAC,CAAY,CAAC,CAAC;CACjF,OAAO;EACL,UAAU;EACV;EACA;EACA,OAAO;GAAE;GAAY,SAAS;GAAgB,YAAY,YAAY,IAAI,IAAI;EAAQ;CACxF;AACF;;AAGA,MAAM,aAAa;CAAC;CAAW;CAAQ;CAAW;CAAY;CAAQ;CAAgB;CAAS;AAAY;;;;;;;;AAS3G,SAAgB,qBACd,MACA,UACA,SACuD;CACvD,MAAM,WAAW,KAAK,MAAM,IAAI;CAChC,MAAM,WACJ,SAAS,eAAe,KAAA,KAAa,QAAQ,WAAW,KAAA,KAAa,QAAQ,WAAW,MAAM,QAAQ,WAAW;CACnH,IACE,QAAQ,WAAW,KAAA,KACnB,QAAQ,SAAS,KAAA,KACjB,QAAQ,YAAY,KAAA,KACpB,QAAQ,cAAc,KAAA,KACtB,CAAC,UAED;CAEF,IAAI,QAAQ,WAAW,KAAA,GAAW,eAAe,UAAU,UAAU,QAAQ,MAAM;CACnF,IAAI,QAAQ,SAAS,KAAA,GAAW,SAAS,UAAU;EAAE,GAAI,SAAS;EAAkB,GAAG,QAAQ;CAAK;CACpG,IAAI,QAAQ,YAAY,KAAA,GAAW,SAAS,aAAa,QAAQ;MAC5D,IAAI,UAAU,SAAS,aAAa,CAAC,EAAE,KAAK,QAAQ,OAAO,CAAC;CACjE,MAAM,UAAgB,CAAC;CACvB,KAAK,MAAM,OAAO,YAAY,IAAI,SAAS,SAAS,KAAA,GAAW,QAAQ,OAAO,SAAS;CACvF,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,QAAQ,GAAG,IAAI,EAAE,OAAO,UAAU,QAAQ,OAAO;CAC3F,MAAM,cACJ,QAAQ,cAAc,KAAA,IACjB,UACD,QAAQ,UAAU,OAAmC;CAC3D,MAAM,OAAO,GAAG,KAAK,UAAU,aAAa,MAAM,CAAC,EAAE;CACrD,OAAO;EAAE,UAAU,WAAW,KAAK,MAAM,IAAI,CAAkB;EAAG;CAAK;AACzE;;AAGA,SAAS,eACP,UACA,UACA,QACM;CACN,MAAM,UAAU,eAAe,QAAQ;CACvC,MAAM,wBAAQ,IAAI,IAAkC;CACpD,KAAK,MAAM,QAAQ,eAAe,UAAU,OAAO,GAAG,MAAM,IAAI,GAAG,KAAK,OAAO,GAAG,KAAK,QAAQ,IAAI;CACnG,MAAM,QAA8B,CAAC;CACrC,KAAK,MAAM,CAAC,MAAM,SAAS,OAAO,QAAS,SAAS,YAAY,CAAC,CAA0B,GAAG;EAC5F,MAAM,OAAa,CAAC;EACpB,IAAI,UAAU;EACd,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,IAAI,GAAG;GAC/C,IAAI,QAAQ,IAAI,GAAG,GAAG;IAEpB,MAAM,OAAO,MAAM,IAAI,GAAG,IAAI,GAAG,MAAM;IACvC,IAAI,SAAS,KAAA,KAAa,CAAC,OAAO,IAAI,GAAG;IACzC;GACF;GACA,KAAK,OAAO;EACd;EACA,IAAI,UAAU,GAAG,MAAM,QAAQ;CACjC;CACA,SAAS,WAAW;CACpB,IAAI,MAAM,QAAQ,SAAS,OAAO,GAAG;EACnC,MAAM,WAAW,IAAI,KAAK,QAAQ,SAAS,QAAQ,CAAC,EAAA,CAAG,KAAI,QAAO,IAAI,IAAI,CAAC;EAC3E,MAAM,OAAO,IAAI,IAAI,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,KAAI,QAAO,IAAI,IAAI,CAAC;EAC/D,MAAM,OAAQ,SAAS,OAAO,CAAiB,QAAO,QAAO,SAAS,IAAI,IAAI,IAAI,KAAK,KAAK,IAAI,IAAI,IAAI,CAAC;EACzG,IAAI,KAAK,SAAS,GAAG,SAAS,UAAU;OACnC,OAAO,SAAS;CACvB;CACA,MAAM,aAAc,SAAS,iBAAiB,CAAC;CAC/C,OAAO,SAAS;CAChB,MAAM,SAAS,MAAM,UAAU;EAC7B,SAAU,WAAW,cAAc,CAAC;EACpC,WAAY,WAAW,gBAAgB,CAAC;EACxC,iBAAkB,WAAW,sBAAsB,CAAC;CACtD,CAAC;CACD,MAAM,SAAe,CAAC;CACtB,KAAK,MAAM,CAAC,MAAM,UAAU,OAAO,QAAQ,UAAU,GACnD,IAAI,SAAS,aAAa,SAAS,eAAe,SAAS,mBAAmB,OAAO,QAAQ;MACxF,IAAI,OAAO,UAAU,KAAA,GAAW,OAAO,QAAQ,OAAO;CAE7D,IAAI,OAAO,KAAK,MAAM,CAAC,CAAC,SAAS,GAAG,SAAS,gBAAgB;AAC/D;AAEA,MAAM,0BAA+B,IAAI,IAAI;CAAC;CAAO;CAAO;CAAQ;CAAU;CAAW;CAAQ;CAAS;AAAO,CAAC;AAElH,eAAe,YACb,MACA,IACA,YACA,SAC8D;CAC9D,MAAM,QAAQ,KAAK,WAAW,KAAA,IAAY,KAAK,KAAK,KAAK,OAAO,KAAK,GAAG,KAAK,OAAO,KAAK,GAAG,KAAK,OAAO,OAAO;CAC/G,MAAM,QAAQ,GAAG,KAAK,OAAO,MAAM,IAAI,SAAS,KAAK,MAAM,EAAE,WAAW;CACxE,KAAK,MAAM,aAAa,YAAY;EAClC,IAAI;EACJ,IAAI;GACF,SAAS,MAAM,UAAU,QAAQ,KAAK,QAA4B;IAAE;IAAI,QAAQ;IAAiB;GAAQ,CAAC;EAC5G,SAAS,OAAO;GACd,OAAO;IACL,QAAQ,KAAA;IACR,SAAS,GAAG,MAAM,mBAAmB,UAAU,KAAK,YAAY,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;GACvH;EACF;EACA,IAAI,WAAW,KAAA,GAAW;EAC1B,IAAI,OAAO,WAAW,YAAY,WAAW,QAAQ,MAAM,QAAQ,MAAM,GACvE,OAAO;GACL,QAAQ,KAAA;GACR,SAAS,GAAG,MAAM,mBAAmB,UAAU,KAAK,aAAa,MAAM,QAAQ,MAAM,IAAI,aAAa,OAAO,OAAO;EACtH;EAEF,OAAO;GAAE,QAAQ;GAAsB,SAAS;EAAG;CACrD;CACA,OAAO;EACL,QAAQ,KAAA;EACR,SAAS,GAAG,MAAM;CACpB;AACF;;AAGA,SAAS,MAAM,QAAgC;CAC7C,MAAM,EAAE,SAAS,SAAS,KAAK,KAAK,GAAG,SAAS;CAChD,OAAO,KAAK,MAAM,KAAK,UAAU,IAAI,CAAC;AACxC;;;;;AAMA,MAAM,uBAAuB;;AAG7B,MAAM,OAAO;;;;;;;;;AAkBb,SAAS,cACP,OACA,WAIA;CACA,MAAM,QAAyB,CAAC;CAChC,KAAK,MAAM,QAAQ,OAAO;EACxB,MAAM,QAAQ,UAAU,IAAI,KAAK,IAAI,KAAK,CAAC;EAC3C,KAAK,MAAM,MAAM,CAAC,UAAU,OAAO,GAAY;GAC7C,MAAM,SAAS,MAAM;GACrB,IAAI,WAAW,KAAA,GAAW,MAAM,KAAK,UAAU,KAAK,MAAM,IAAI,MAAM,MAAM,CAAC,CAAC;EAC9E;CACF;CAEA,MAAM,2BAAW,IAAI,IAA4F;CACjH,KAAK,MAAM,QAAQ,OACjB,KAAK,MAAM,EAAE,MAAM,MAAM,WAAW,KAAK,QAAQ;EAC/C,IAAI,QAAQ,SAAS,IAAI,IAAI;EAC7B,IAAI,UAAU,KAAA,GAAW;GACvB,QAAQ,EAAE,QAAQ,CAAC,EAAE;GACrB,SAAS,IAAI,MAAM,KAAK;EAC1B;EACA,MAAM,WAAW,MAAM,KAAK;EAC5B,IAAI,aAAa,KAAA,GAAW;GAC1B,MAAM,KAAK,MAAM;GACjB,MAAM,OAAO,KAAK,MAAM;EAC1B,OAAO,IAAI,CAAC,WAAW,UAAU,IAAI,GACnC,MAAM,IAAI,YACR,UAAU,oBACV,oCAAoC,KAAK,6BAA6B,MAAM,OAAO,KAAK,IAAI,OAAO,MAAM,IACzG,EAAE,OAAO,CAAC,+FAA+F,EAAE,CAC7G;CAEJ;CAGF,MAAM,wBAAQ,IAAI,IAAY;CAC9B,KAAK,MAAM,CAAC,MAAM,UAAU,UAC1B,IAAI,MAAM,UAAU,KAAA,KAAa,MAAM,WAAW,KAAA,KAAa,CAAC,WAAW,MAAM,OAAO,MAAM,MAAM,GAClG,MAAM,IAAI,IAAI;CAGlB,KAAK,IAAI,UAAU,MAAM,UAAW;EAClC,UAAU;EACV,KAAK,MAAM,CAAC,MAAM,UAAU,UAAU;GACpC,IAAI,MAAM,IAAI,IAAI,KAAK,MAAM,UAAU,KAAA,KAAa,MAAM,WAAW,KAAA,GAAW;GAChF,IAAI,CAAC,GAAG,gBAAgB,MAAM,KAAK,CAAC,CAAC,CAAC,MAAK,WAAU,MAAM,IAAI,MAAM,CAAC,GAAG;IACvE,MAAM,IAAI,IAAI;IACd,UAAU;GACZ;EACF;CACF;CACA,MAAM,WAAW,MAAc,OAC7B,OAAO,WAAW,MAAM,IAAI,IAAI,IAAI,GAAG,KAAK,SAAS;CACvD,MAAM,aAAoE,CAAC;CAC3E,KAAK,MAAM,CAAC,MAAM,UAAU,UAAU;EACpC,IAAI,MAAM,WAAW,KAAA,GACnB,WAAW,KAAK;GACd;GACA,QAAQ,aAAa,MAAM,QAAQ,UAAU,OAAO;GACpD,OAAO,MAAM,OAAO;EACtB,CAAC;EAEH,IAAI,MAAM,UAAU,KAAA,MAAc,MAAM,WAAW,KAAA,KAAa,MAAM,IAAI,IAAI,IAC5E,WAAW,KAAK;GACd,MAAM,QAAQ,MAAM,OAAO;GAC3B,QAAQ,aAAa,MAAM,OAAO,SAAS,OAAO;GAClD,OAAO,MAAM,OAAO;EACtB,CAAC;CAEL;CACA,MAAM,wBAAQ,IAAI,IAAiD;CACnE,KAAK,MAAM,QAAQ,OAAO;EACxB,MAAM,QAAQ,UAAU,IAAI,KAAK,IAAI,KAAK,CAAC;EAC3C,MAAM,SAA8C,CAAC;EACrD,IAAI,MAAM,WAAW,KAAA,GAAW,OAAO,SAAS,QAAQ,KAAK,MAAM,QAAQ;EAC3E,IAAI,MAAM,UAAU,KAAA,GAAW,OAAO,QAAQ,QAAQ,KAAK,MAAM,OAAO;EACxE,MAAM,IAAI,KAAK,MAAM,MAAM;CAC7B;CACA,OAAO;EAAE;EAAY,OAAO;CAAM;AACpC;;;;;;;AAQA,SAAS,UAAU,MAAc,IAAwB,QAAmC;CAC1F,MAAM,uBAAO,IAAI,IAAqB;CACtC,MAAM,WAAW,UAAyB;EACxC,IAAI,OAAO,UAAU,YAAY,UAAU,MAAM;EACjD,IAAI,MAAM,QAAQ,KAAK,GAAG;GACxB,KAAK,MAAM,QAAQ,OAAO,QAAQ,IAAI;GACtC;EACF;EACA,KAAK,MAAM,OAAO,CAAC,SAAS,aAAa,GAAG;GAC1C,MAAM,QAAS,MAAe;GAC9B,IAAI,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK,GACrE,KAAK,MAAM,CAAC,SAAS,QAAQ,OAAO,QAAQ,KAAK,GAAG,KAAK,IAAI,SAAS,GAAG;EAE7E;EACA,KAAK,MAAM,CAAC,KAAK,SAAS,OAAO,QAAQ,KAAK,GAAG,IAAI,QAAQ,WAAW,QAAQ,eAAe,QAAQ,IAAI;CAC7G;CACA,QAAQ,MAAM;CACd,MAAM,0BAAU,IAAI,IAAoB;CACxC,KAAK,MAAM,SAAS,KAAK,KAAK,GAAG;EAC/B,MAAM,YAAY,qBAAqB,KAAK,KAAK;EACjD,QAAQ,IAAI,OAAO,cAAc,OAAO,cAAc,KAAK,IAAI,cAAc,GAAG,KAAK,SAAS,UAAU,IAAI,CAAC;CAC/G;CACA,IAAI,OAAgB;CAGpB,MAAM,SADO,OAAO,KAAK,MAAM,CAAC,CAAC,QAAO,QAAO,QAAQ,WAAW,QAAQ,aACxD,CAAC,CAAC,WAAW,KAAK,OAAO,OAAO,YAAY,WAAW,YAAY,OAAO,OAAO,IAAI,KAAA;CACvG,IAAI,WAAW,KAAA,KAAa,OAAO,SAAS,MAAM,KAAK,IAAI,OAAO,KAAK,GACtD;MAAA,QAAQ,IAAI,OAAO,KACzB,MAAM,QAAQ,qBAAqB,KAAK,OAAO,KAAK,GAAG;GAC9D,OAAO,KAAK,IAAI,OAAO,KAAK;GAC5B,KAAK,OAAO,OAAO,KAAK;GACxB,QAAQ,IAAI,OAAO,OAAO,IAAI;EAChC;;CAEF,MAAM,WAAW,UAA4B;EAC3C,IAAI,MAAM,QAAQ,KAAK,GAAG,OAAO,MAAM,IAAI,OAAO;EAClD,IAAI,OAAO,UAAU,YAAY,UAAU,MAAM,OAAO;EACxD,MAAM,SAAe,CAAC;EACtB,KAAK,MAAM,CAAC,KAAK,SAAS,OAAO,QAAQ,KAAK,GAAG;GAC/C,IAAI,QAAQ,WAAW,QAAQ,eAAe;GAC9C,IAAI,QAAQ,UAAU,OAAO,SAAS,UAAU,OAAO,OAAO,QAAQ,MAAM,MAAM,OAAO;QACpF,OAAO,OAAO,QAAQ,IAAI;EACjC;EACA,OAAO;CACT;CACA,MAAM,SAAS,CAAC;EAAE,MAAM;EAAM,MAAM,QAAQ,IAAI;EAAG,OAAO,cAAc;CAAO,CAAC;CAChF,KAAK,MAAM,CAAC,OAAO,QAAQ,MACzB,OAAO,KAAK;EAAE,MAAM,QAAQ,IAAI,KAAK;EAAa,MAAM,QAAQ,GAAG;EAAG,OAAO,mBAAmB;CAAO,CAAC;CAE1G,OAAO;EAAE;EAAM;EAAI;CAAO;AAC5B;;AAGA,SAAS,YAAY,KAA0D;CAC7E,KAAK,MAAM,UAAU,CAAC,YAAY,gBAAgB,GAAG;EACnD,IAAI,CAAC,IAAI,WAAW,MAAM,GAAG;EAC7B,MAAM,OAAO,IAAI,MAAM,OAAO,MAAM;EACpC,MAAM,QAAQ,KAAK,QAAQ,GAAG;EAC9B,MAAM,UAAU,UAAU,KAAK,OAAO,KAAK,MAAM,GAAG,KAAK;EACzD,IAAI;EACJ,IAAI;GACF,QAAQ,mBAAmB,OAAO;EACpC,QAAQ;GACN,QAAQ;EACV;EACA,OAAO;GAAE,OAAO,MAAM,WAAW,MAAM,GAAG,CAAC,CAAC,WAAW,MAAM,GAAG;GAAG,MAAM,UAAU,KAAK,KAAK,KAAK,MAAM,KAAK;EAAE;CACjH;AAEF;AAEA,SAAS,QAAQ,KAAa,MAAc,SAA8C;CACxF,MAAM,SAAS,YAAY,GAAG;CAC9B,IAAI,WAAW,KAAA,GACb,OAAO,GAAG,OAAO,QAAQ,IAAI,OAAO,KAAK,KAAK,cAAc,OAAO,KAAK,IAAI,OAAO,OAAO;CAE5F,IAAI,QAAQ,KAAK,OAAO,GAAG,OAAO,OAAO;CACzC,IAAI,IAAI,WAAW,IAAI,GAAG,OAAO,GAAG,OAAO,OAAO,OAAO,IAAI,MAAM,CAAC;CACpE,OAAO;AACT;AAEA,SAAS,UAAU,KAAyD;CAC1E,IAAI,CAAC,IAAI,WAAW,IAAI,GAAG,OAAO,KAAA;CAClC,MAAM,MAAM,IAAI,QAAQ,MAAM,CAAC;CAC/B,OAAO,QAAQ,KAAK,KAAA,IAAY;EAAE,MAAM,IAAI,MAAM,GAAG,GAAG;EAAG,MAAM,IAAI,MAAM,MAAM,CAAC;CAAE;AACtF;;AAGA,SAAS,gBAAgB,OAAgB,wBAAqB,IAAI,IAAI,GAAgB;CACpF,IAAI,MAAM,QAAQ,KAAK,GACrB,KAAK,MAAM,QAAQ,OAAO,gBAAgB,MAAM,KAAK;MAChD,IAAI,OAAO,UAAU,YAAY,UAAU,MAChD,KAAK,MAAM,CAAC,KAAK,SAAS,OAAO,QAAQ,KAAK,GAAG;EAC/C,MAAM,OAAO,QAAQ,UAAU,OAAO,SAAS,WAAW,UAAU,IAAI,IAAI,KAAA;EAC5E,IAAI,SAAS,KAAA,GAAW,gBAAgB,MAAM,KAAK;OAC9C,MAAM,IAAI,KAAK,IAAI;CAC1B;CAEF,OAAO;AACT;;AAGA,SAAS,aACP,OACA,IACA,SACS;CACT,IAAI,MAAM,QAAQ,KAAK,GAAG,OAAO,MAAM,KAAI,SAAQ,aAAa,MAAM,IAAI,OAAO,CAAC;CAClF,IAAI,OAAO,UAAU,YAAY,UAAU,MAAM,OAAO;CACxD,MAAM,SAAe,CAAC;CACtB,KAAK,MAAM,CAAC,KAAK,SAAS,OAAO,QAAQ,KAAK,GAAG;EAC/C,MAAM,OAAO,QAAQ,UAAU,OAAO,SAAS,WAAW,UAAU,IAAI,IAAI,KAAA;EAC5E,OAAO,OACL,SAAS,KAAA,IAAY,aAAa,MAAM,IAAI,OAAO,IAAI,GAAG,UAAU,QAAQ,KAAK,MAAM,EAAE,CAAC,IAAI,KAAK;CACvG;CACA,OAAO;AACT;AAEA,SAAS,cACP,OACiF;CACjF,OAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,OAAQ,MAAgC,YAAY;AAC5G;AAEA,SAAS,oBACP,OACA,OACA,SACA,WACS;CACT,IAAI,MAAM,QAAQ,KAAK,GAAG;EACxB,IAAI,CAAC,MAAM,MAAK,SAAQ,cAAc,IAAI,KAAK,KAAK,YAAY,YAAY,GAC1E,OAAO,MAAM,KAAI,SAAQ,oBAAoB,MAAM,OAAO,SAAS,SAAS,CAAC;EAG/E,MAAM,2BAAW,IAAI,IAAY;EACjC,KAAK,MAAM,QAAQ,OAAO;GACxB,MAAM,MAAM,cAAc,IAAI,IAAI,KAAA,IAAY,aAAa,IAAI;GAC/D,IAAI,QAAQ,KAAA,GAAW,SAAS,IAAI,GAAG;EACzC;EACA,MAAM,2BAAW,IAAI,IAAY;EACjC,MAAM,SAAoB,CAAC;EAC3B,KAAK,MAAM,QAAQ,OAAO;GACxB,IAAI,CAAC,cAAc,IAAI,KAAK,KAAK,YAAY,cAAc;IACzD,OAAO,KAAK,oBAAoB,MAAM,OAAO,SAAS,SAAS,CAAC;IAChE;GACF;GACA,KAAK,MAAM,aAAa,iBAAiB,MAAM,OAAO,OAAO,GAAG;IAC9D,MAAM,MAAM,aAAa,SAAS;IAClC,IAAI,SAAS,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,GAAG;KAC1C,UAAU,WAA2C,KAAK,IAAI;KAC9D;IACF;IACA,SAAS,IAAI,GAAG;IAChB,OAAO,KAAK,SAAS;GACvB;EACF;EACA,OAAO;CACT;CACA,IAAI,OAAO,UAAU,YAAY,UAAU,MAAM,OAAO;CACxD,IAAI,cAAc,KAAK,KAAK,MAAM,YAAY,UAAU;EACtD,MAAM,OAAO,MAAM,IAAI,MAAM,IAAI,CAAC,GAAG,MAAM,OAAO,MAAM;EACxD,OAAO,EAAE,MAAM,UAAU,IAAI,EAAE;CACjC;CACA,MAAM,SAAe,CAAC;CACtB,KAAK,MAAM,CAAC,KAAK,SAAS,OAAO,QAAQ,KAAK,GAAG,OAAO,OAAO,oBAAoB,MAAM,OAAO,SAAS,SAAS;CAClH,OAAO;AACT;;AAGA,SAAS,aAAa,WAAwC;CAC5D,IAAI,OAAO,cAAc,YAAY,cAAc,MAAM,OAAO,KAAA;CAChE,MAAM,EAAE,IAAI,UAAU,SAAS;CAC/B,IAAI,OAAO,aAAa,YAAY,OAAO,SAAS,UAAU,OAAO,KAAA;CACrE,OAAO,GAAG,SAAS,GAAG,aAAa,WAAW,KAAK,YAAY,IAAI;AACrE;;AAGA,SAAS,iBACP,aACA,OACA,SACQ;CACR,MAAM,OAAO,MAAM,IAAI,YAAY,IAAI,CAAC,EAAE,SAAS,YAAY;CAC/D,IAAI,SAAS,QAAQ,IAAI,IAAI;CAC7B,KAAK,IAAI,QAAQ,GAAG,QAAQ,KAAK,OAAO,SAAS,YAAY,UAAU,SACrE,SAAS,QAAQ,IAAI,OAAO,OAAO,OAAO,CAAC,CAAC,MAAM,EAA8B,CAAC;CAEnF,MAAM,aAAa,SAAS;CAC5B,IAAI,WAAW,KAAA,KAAa,OAAO,eAAe,YAAY,eAAe,QAAQ,MAAM,QAAQ,UAAU,GAC3G,MAAM,IAAI,YACR,UAAU,wBACV,OAAO,YAAY,MAAM,QAAQ,UAAU,YAAY,KAAK,oEAC5D,EAAE,OAAO,CAAC,sBAAsB,YAAY,MAAM,QAAQ,gDAAgD,EAAE,CAC9G;CAEF,MAAM,WAAW,IAAI,IAAI,MAAM,QAAQ,OAAO,WAAW,IAAK,OAAO,cAA2B,CAAC,CAAC;CAClG,OAAO,OAAO,QAAQ,UAAU,CAAC,CAAC,KAAK,CAAC,UAAU,oBAAoB;EACpE,MAAM,EAAE,aAAa,GAAG,SAAS;EACjC,MAAM,YAAkB;GAAE,MAAM;GAAU,IAAI,YAAY,MAAM;EAAQ;EACxE,IAAI,OAAO,gBAAgB,UAAU,UAAU,iBAAiB;EAChE,IAAI,YAAY,OAAO,UAAU,SAAS,IAAI,QAAQ,GAAG,UAAU,cAAc;EACjF,UAAU,YAAY;EACtB,KAAK,KAAK,YAAY,WAAW,MAAM,QAAQ,KAAK,QAAQ,MAAM,YAAY,OAAO,SAAS;GAC5F,UAAU,WAAW;GACrB,UAAU,aAAa;EACzB;EACA,OAAO;CACT,CAAC;AACH;;AAGA,SAAS,OACP,UACA,OACA,cACa;CACb,MAAM,OAAoB,CAAC,GAAG,QAAQ;CACtC,MAAM,QAAQ,IAAI,IAAI,SAAS,KAAI,QAAO,IAAI,IAAI,CAAC;CACnD,MAAM,uBAAO,IAAI,IAAY;CAC7B,KAAK,MAAM,QAAQ,OAAO,OAAO,KAAK,GACpC,KAAK,MAAM,aAAa,OAAO,OAAO,IAAI,GACxC,KAAK,MAAM,OAAS,UAAiC,QAAQ,CAAC,GAAgB,KAAK,IAAI,GAAG;CAG9F,KAAK,MAAM,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC,KAAK,cAAc,GAAG;EAChD,IAAI,MAAM,IAAI,GAAG,GAAG;EACpB,MAAM,cAAc,aAAa;EACjC,KAAK,KAAK,gBAAgB,KAAA,IAAY,EAAE,MAAM,IAAI,IAAI;GAAE,MAAM;GAAK;EAAY,CAAC;CAClF;CACA,OAAO;AACT;;AAGA,SAAS,MAAM,UAAgB,YAA6E;CAC1G,MAAM,OAAO;EAAE,yBAAS,IAAI,IAAY;EAAG,2BAAW,IAAI,IAAY;EAAG,iCAAiB,IAAI,IAAY;CAAE;CAC5G,MAAM,SAAS,UAAyB;EACtC,IAAI,MAAM,QAAQ,KAAK,GAAG;GACxB,KAAK,MAAM,QAAQ,OAAO,MAAM,IAAI;GACpC;EACF;EACA,IAAI,OAAO,UAAU,YAAY,UAAU,MAAM;EACjD,KAAK,MAAM,CAAC,KAAK,SAAS,OAAO,QAAQ,KAAK,GAC5C,IAAI,QAAQ,UAAU,OAAO,SAAS,UAAU;GAC9C,MAAM,QAAQ,+CAA+C,KAAK,IAAI;GACtE,MAAM,OAAO,QAAQ;GACrB,MAAM,OACJ,QAAQ,OAAO,KAAA,IACX,KAAA,IACA,mBAAmB,MAAM,EAAE,CAAC,WAAW,MAAM,GAAG,CAAC,CAAC,WAAW,MAAM,GAAG,CAAC;GAC7E,IAAI,SAAS,KAAA,KAAa,SAAS,KAAA,KAAa,CAAC,KAAK,KAAK,CAAC,IAAI,IAAI,GAAG;IACrE,KAAK,KAAK,CAAC,IAAI,IAAI;IACnB,MAAM,WAAW,KAAK,CAAC,KAAK;GAC9B;EACF,OAAO,IAAI,QAAQ,cAAc,MAAM,QAAQ,IAAI,GACjD,KAAK,MAAM,eAAe,MACxB,KAAK,MAAM,UAAU,OAAO,KAAK,WAAqB,GAAG,KAAK,gBAAgB,IAAI,MAAM;OAE1F,MAAM,IAAI;CAGhB;CACA,MAAM,QAAQ;CACd,MAAM,SAAe,CAAC;CACtB,KAAK,MAAM,QAAQ;EAAC;EAAW;EAAa;CAAiB,GAAY;EACvE,MAAM,OAAa,CAAC;EACpB,KAAK,MAAM,QAAQ,OAAO,KAAK,WAAW,KAAK,CAAC,CAAC,KAAK,cAAc,GAClE,IAAI,KAAK,KAAK,CAAC,IAAI,IAAI,GAAG,KAAK,QAAQ,WAAW,KAAK,CAAC;EAE1D,IAAI,OAAO,KAAK,IAAI,CAAC,CAAC,SAAS,GAAG,OAAO,QAAQ;CACnD;CACA,OAAO;AACT;;AAGA,SAAgB,eACd,UACA,UAA2B,eAAe,QAAQ,GAC1B;CACxB,MAAM,OAAQ,SAAS,YAAuD;CAC9E,MAAM,yBAAS,IAAI,IAAoB;CACvC,KAAK,MAAM,CAAC,OAAO,eAAe,OAAO,QAAQ,MAAM,UAAU,CAAC,CAAC,GACjE,KAAK,MAAM,OAAO,WAAW,QAAQ,CAAC,GAAG,OAAO,IAAI,KAAK,KAAK;CAEhE,MAAM,WAAW,QAAwB,OAAO,IAAI,GAAG,KAAK;CAC5D,OAAO,QAAQ,WAAW,KAAI,eAAc;EAC1C,MAAM,aAAa,MAAM,aAAa,MAAK,cAAa,UAAU,UAAU,WAAW,UAAU;EAIjG,MAAM,aAHQ,YAAY,QAAQ,MAChC,cAAa,UAAU,YAAY,WAAW,WAAW,UAAU,WAAW,WAAW,KAC3F,EAAA,EACyB,QAAQ,CAAC;EAClC,MAAM,UAAU,IAAI,IAAI,OAAO,KAAK,SAAS,CAAC,CAAC,IAAI,OAAO,CAAC;EAC3D,MAAM,OAAgC,CAAC;EACvC,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,YAAY,QAAQ,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,IAAI,QAAQ,GAAG,CAAC,GAAG,KAAK,OAAO;EAC/G,OAAO,OAAO,MAAM,SAAS;EAC7B,MAAM,YAAY,WAAW;EAC7B,OAAO,OAAO,OAAO;GACnB,QAAQ,WAAW;GACnB,MAAM,WAAW;GACjB,aAAa,UAAU,eAAe;GACtC,MAAM,OAAO,OAAO,CAAC,GAAI,UAAU,QAAQ,CAAC,CAAE,CAAC;GAC/C,YAAY,YAAY,WAAW,UAAU;GAC7C,SAAS,WAAW;GACpB,MAAM,OAAO,OAAO,IAAI;EAC1B,CAAC;CACH,CAAC;AACH;AAgBA,SAAS,WAAc,OAAa;CAClC,IAAI,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,OAAO,SAAS,KAAK,GAAG;EAC1E,OAAO,OAAO,KAAK;EACnB,KAAK,MAAM,QAAQ,OAAO,OAAO,KAAK,GAAG,WAAW,IAAI;CAC1D;CACA,OAAO;AACT;;AAGA,MAAM,kBAA8B;CAClC,MAAM;CACN,YAAY;EACV,YAAY,EAAE,MAAM,UAAU;EAC9B,OAAO,EAAE,MAAM,SAAS;EACxB,SAAS,EAAE,MAAM,SAAS;EAC1B,SAAS,CAAC;CACZ;CACA,UAAU;EAAC;EAAc;EAAS;CAAS;AAC7C;;AAGA,MAAM,wBAAoC,EACxC,OAAO,CACL,EAAE,MAAM,UAAU,iBAAiB,IAAI,EAAE,GACzC;CACE,MAAM;CACN,YAAY,EACV,SAAS;EACP,MAAM;EACN,OAAO;GACL,MAAM;GACN,YAAY;IAAE,MAAM,EAAE,MAAM,SAAS;IAAG,SAAS,EAAE,MAAM,SAAS;GAAE;GACpE,UAAU,CAAC,QAAQ,SAAS;EAC9B;CACF,EACF;AACF,CACF,EACF"}

package/dist/compiler.d.mts

@@ -0,0 +1,16 @@
+import { CompilerExtension, Location } from "@znight/compiler";
+/** Data stored by `analyzeClass`. */
+type OpenApiStored = {
+  readonly kind: "document";
+  readonly identity: string;
+  readonly displayName: string;
+  readonly location: Location;
+} | {
+  readonly kind: "controller";
+  readonly identity: string;
+  readonly displayName: string;
+};
+/** The `@znight/openapi` compiler extension. */
+declare const openapi: CompilerExtension<OpenApiStored>;
+export { type OpenApiStored, openapi as default };
+//# sourceMappingURL=compiler.d.mts.map