openapi-typesafe 0.0.0 → 1.0.0-rc.0

package/dist/application/transform/document/header.mjs

@@ -0,0 +1,25 @@
+import { irObject } from '../../../domain/ir/constructors.mjs';
+import { escapePointerSegment } from '../../../domain/openapi/json-pointer.mjs';
+import { documentEntries } from '../document-entries.mjs';
+import { transformSchema } from '../schema/schema-transform.mjs';
+import { UNKNOWN_TYPE } from '../shared-types.mjs';
+import { documentMember } from './document-member.mjs';
+import { contentEntryType } from './media-type.mjs';
+
+function headerType(header, location, context) {
+  if (header.schema) {
+    return transformSchema(header.schema, location, context);
+  }
+  if (!header.content) {
+    return UNKNOWN_TYPE;
+  }
+  const members = documentEntries(header.content, context.options).map(([contentType, entry]) => {
+    const path = `${location.path ?? "#"}/${escapePointerSegment(contentType)}`;
+    const type = contentEntryType(entry, { ...location, path }, context);
+    return documentMember(contentType, type, entry, { isReadonly: context.options.immutable });
+  });
+  return irObject(members);
+}
+
+export { headerType };
+//# sourceMappingURL=header.mjs.map

package/dist/application/transform/document/header.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"header.mjs","sources":["../../../../src/application/transform/document/header.ts"],"sourcesContent":["import { irObject } from \"../../../domain/ir/constructors.js\";\nimport type { IrType } from \"../../../domain/ir/nodes.js\";\nimport type { HeaderObject } from \"../../../domain/openapi/header-object.js\";\nimport { escapePointerSegment } from \"../../../domain/openapi/json-pointer.js\";\nimport { documentEntries } from \"../document-entries.js\";\nimport type { SchemaContext, SchemaLocation } from \"../schema/schema-context.js\";\nimport { transformSchema } from \"../schema/schema-transform.js\";\nimport { UNKNOWN_TYPE } from \"../shared-types.js\";\nimport { documentMember } from \"./document-member.js\";\nimport { contentEntryType } from \"./media-type.js\";\n\n/**\n * A header's type (OpenAPI 3.1 §4.8.21): its schema, else an object with one property per media\n * type in `content`, else `unknown`.\n */\nexport function headerType(\n  header: HeaderObject,\n  location: SchemaLocation,\n  context: SchemaContext,\n): IrType {\n  if (header.schema) {\n    return transformSchema(header.schema, location, context);\n  }\n  if (!header.content) {\n    return UNKNOWN_TYPE;\n  }\n  const members = documentEntries(header.content, context.options).map(([contentType, entry]) => {\n    // Unlike other content maps, the original joins this path by hand: a missing path is `#`.\n    const path = `${location.path ?? \"#\"}/${escapePointerSegment(contentType)}`;\n    const type = contentEntryType(entry, { ...location, path }, context);\n    return documentMember(contentType, type, entry, { isReadonly: context.options.immutable });\n  });\n  return irObject(members);\n}\n"],"names":[],"mappings":";;;;;;;;AAeO,SAAS,UAAA,CACd,MAAA,EACA,QAAA,EACA,OAAA,EACQ;AACR,EAAA,IAAI,OAAO,MAAA,EAAQ;AACjB,IAAA,OAAO,eAAA,CAAgB,MAAA,CAAO,MAAA,EAAQ,QAAA,EAAU,OAAO,CAAA;AAAA,EACzD;AACA,EAAA,IAAI,CAAC,OAAO,OAAA,EAAS;AACnB,IAAA,OAAO,YAAA;AAAA,EACT;AACA,EAAA,MAAM,OAAA,GAAU,eAAA,CAAgB,MAAA,CAAO,OAAA,EAAS,OAAA,CAAQ,OAAO,CAAA,CAAE,GAAA,CAAI,CAAC,CAAC,WAAA,EAAa,KAAK,CAAA,KAAM;AAE7F,IAAA,MAAM,IAAA,GAAO,GAAG,QAAA,CAAS,IAAA,IAAQ,GAAG,CAAA,CAAA,EAAI,oBAAA,CAAqB,WAAW,CAAC,CAAA,CAAA;AACzE,IAAA,MAAM,IAAA,GAAO,iBAAiB,KAAA,EAAO,EAAE,GAAG,QAAA,EAAU,IAAA,IAAQ,OAAO,CAAA;AACnE,IAAA,OAAO,cAAA,CAAe,aAAa,IAAA,EAAM,KAAA,EAAO,EAAE,UAAA,EAAY,OAAA,CAAQ,OAAA,CAAQ,SAAA,EAAW,CAAA;AAAA,EAC3F,CAAC,CAAA;AACD,EAAA,OAAO,SAAS,OAAO,CAAA;AACzB;;"}

package/dist/application/transform/document/kept-deprecated.cjs

@@ -0,0 +1,96 @@
+'use strict';
+
+const componentsObject = require('../../../domain/openapi/components-object.cjs');
+const documentEntries = require('../document-entries.cjs');
+
+const UNTYPED_KEYS = /* @__PURE__ */ new Set([
+  "callbacks",
+  "discriminator",
+  "example",
+  "examples",
+  "externalDocs",
+  "links",
+  "security",
+  "securitySchemes",
+  "servers",
+  "xml"
+]);
+const EXTENSION_PREFIX = "x-";
+const RESOLVED_ENTRY_KEYS = /* @__PURE__ */ new Set([
+  "properties",
+  "parameters",
+  "get",
+  "put",
+  "post",
+  "delete",
+  "options",
+  "head",
+  "patch",
+  "trace",
+  "query"
+]);
+const COMPONENTS_PREFIX = "#/components/";
+function isObject(value) {
+  return typeof value === "object" && value !== null;
+}
+function refOf(value) {
+  return isObject(value) && typeof value.$ref === "string" ? value.$ref : void 0;
+}
+function isDroppedEntry(value, scan) {
+  const ref = refOf(value);
+  return documentEntries.isDeprecated(value) || ref !== void 0 && documentEntries.isDeprecated(scan.refs.resolve(ref));
+}
+function visitRef(ref, scan) {
+  const target = ref.startsWith(COMPONENTS_PREFIX) ? scan.refs.resolve(ref) : void 0;
+  if (isObject(target) && documentEntries.isDeprecated(target) && !scan.kept.has(target)) {
+    scan.kept.add(target);
+    visitContents(target, scan);
+  }
+}
+function visitEntries(value, scan) {
+  for (const entry of Array.isArray(value) ? value : Object.values(value)) {
+    if (!isDroppedEntry(entry, scan)) {
+      visit(entry, scan);
+    }
+  }
+}
+function visit(node, scan) {
+  if (Array.isArray(node)) {
+    for (const item of node) {
+      visit(item, scan);
+    }
+  } else if (isObject(node) && !documentEntries.isDeprecated(node)) {
+    visitContents(node, scan);
+  }
+}
+function visitContents(node, scan) {
+  const ref = refOf(node);
+  if (ref !== void 0) {
+    visitRef(ref, scan);
+  }
+  for (const [key, value] of Object.entries(node)) {
+    if (UNTYPED_KEYS.has(key) || key.startsWith(EXTENSION_PREFIX) || !isObject(value)) {
+      continue;
+    }
+    if (RESOLVED_ENTRY_KEYS.has(key)) {
+      visitEntries(key === "properties" || key === "parameters" ? value : [value], scan);
+    } else {
+      visit(value, scan);
+    }
+  }
+}
+function keptComponentEntries(components) {
+  const kinds = [...componentsObject.COMPONENT_KINDS, ...componentsObject.DECLARED_COMPONENT_KINDS];
+  return kinds.flatMap(
+    (kind) => Object.values(components?.[kind] ?? {}).filter((item) => !documentEntries.isDeprecated(item))
+  );
+}
+function keptDeprecatedComponents(document, refs) {
+  const scan = { refs, kept: /* @__PURE__ */ new Set() };
+  visit([document.paths, document.webhooks, document.$defs], scan);
+  visit(keptComponentEntries(document.components), scan);
+  return scan.kept;
+}
+
+exports.keptDeprecatedComponents = keptDeprecatedComponents;
+//# sourceMappingURL=kept-deprecated.cjs.map

package/dist/application/transform/document/kept-deprecated.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"kept-deprecated.cjs","sources":["../../../../src/application/transform/document/kept-deprecated.ts"],"sourcesContent":["import {\n  COMPONENT_KINDS,\n  type ComponentsObject,\n  DECLARED_COMPONENT_KINDS,\n} from \"../../../domain/openapi/components-object.js\";\nimport type { DocumentObject } from \"../../../domain/openapi/document-object.js\";\nimport { isDeprecated } from \"../document-entries.js\";\nimport type { RefResolver } from \"../schema/schema-context.js\";\n\n/**\n * `--exclude-deprecated` and references (roadmap R10.3, backlog 29). A deprecated component is\n * left out, but a kept schema may still point to it (an array's `items`, say), and the output then\n * names a missing `components` key. This scan finds the deprecated components that the kept output\n * references, so they are kept too. It follows the generator's rules: a property, parameter or\n * operation whose (resolved) object is deprecated is dropped, so its `$ref` does not count. Keys\n * that are not typed are not followed, so a component they name stays out, as before.\n */\n\n/** Keys whose contents the generator does not type. */\nconst UNTYPED_KEYS: ReadonlySet<string> = new Set([\n  \"callbacks\",\n  \"discriminator\",\n  \"example\",\n  \"examples\",\n  \"externalDocs\",\n  \"links\",\n  \"security\",\n  \"securitySchemes\",\n  \"servers\",\n  \"xml\",\n]);\nconst EXTENSION_PREFIX = \"x-\";\n/** Keys whose entries the generator drops when the entry or its `$ref` target is deprecated. */\nconst RESOLVED_ENTRY_KEYS: ReadonlySet<string> = new Set([\n  \"properties\",\n  \"parameters\",\n  \"get\",\n  \"put\",\n  \"post\",\n  \"delete\",\n  \"options\",\n  \"head\",\n  \"patch\",\n  \"trace\",\n  \"query\",\n]);\nconst COMPONENTS_PREFIX = \"#/components/\";\n\ninterface Scan {\n  readonly refs: RefResolver;\n  /** The deprecated components to keep, as the document's own objects. */\n  readonly kept: Set<object>;\n}\n\nfunction isObject(value: unknown): value is Readonly<Record<string, unknown>> {\n  return typeof value === \"object\" && value !== null;\n}\n\nfunction refOf(value: unknown): string | undefined {\n  return isObject(value) && typeof value.$ref === \"string\" ? value.$ref : undefined;\n}\n\n/** Whether a dropped-when-deprecated entry is dropped: its own or its target's `deprecated`. */\nfunction isDroppedEntry(value: unknown, scan: Scan): boolean {\n  const ref = refOf(value);\n  return isDeprecated(value) || (ref !== undefined && isDeprecated(scan.refs.resolve(ref)));\n}\n\n/** A `$ref` to a deprecated component keeps it, and the component is scanned once. */\nfunction visitRef(ref: string, scan: Scan): void {\n  const target = ref.startsWith(COMPONENTS_PREFIX) ? scan.refs.resolve(ref) : undefined;\n  if (isObject(target) && isDeprecated(target) && !scan.kept.has(target)) {\n    scan.kept.add(target);\n    visitContents(target, scan);\n  }\n}\n\nfunction visitEntries(value: unknown, scan: Scan): void {\n  for (const entry of Array.isArray(value) ? value : Object.values(value as object)) {\n    if (!isDroppedEntry(entry, scan)) {\n      visit(entry, scan);\n    }\n  }\n}\n\n/** A node of kept output; a deprecated object here is dropped, so it is not followed. */\nfunction visit(node: unknown, scan: Scan): void {\n  if (Array.isArray(node)) {\n    for (const item of node) {\n      visit(item, scan);\n    }\n  } else if (isObject(node) && !isDeprecated(node)) {\n    visitContents(node, scan);\n  }\n}\n\n/** The `$ref` and the typed keys of an object. */\nfunction visitContents(node: Readonly<Record<string, unknown>>, scan: Scan): void {\n  const ref = refOf(node);\n  if (ref !== undefined) {\n    visitRef(ref, scan);\n  }\n  for (const [key, value] of Object.entries(node)) {\n    if (UNTYPED_KEYS.has(key) || key.startsWith(EXTENSION_PREFIX) || !isObject(value)) {\n      continue;\n    }\n    if (RESOLVED_ENTRY_KEYS.has(key)) {\n      visitEntries(key === \"properties\" || key === \"parameters\" ? value : [value], scan);\n    } else {\n      visit(value, scan);\n    }\n  }\n}\n\n/** The kept (not deprecated) entries of the typed component kinds. */\nfunction keptComponentEntries(components: ComponentsObject | undefined): unknown[] {\n  const kinds = [...COMPONENT_KINDS, ...DECLARED_COMPONENT_KINDS];\n  return kinds.flatMap((kind) =>\n    Object.values(components?.[kind] ?? {}).filter((item) => !isDeprecated(item)),\n  );\n}\n\n/**\n * The deprecated components that kept output references, as the objects of `document.components`\n * (the resolver returns those), so names that need escaping in a `$ref` match too.\n */\nexport function keptDeprecatedComponents(\n  document: DocumentObject,\n  refs: RefResolver,\n): ReadonlySet<object> {\n  const scan: Scan = { refs, kept: new Set() };\n  visit([document.paths, document.webhooks, document.$defs], scan);\n  visit(keptComponentEntries(document.components), scan);\n  return scan.kept;\n}\n"],"names":["isDeprecated","COMPONENT_KINDS","DECLARED_COMPONENT_KINDS"],"mappings":"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"}

package/dist/application/transform/document/kept-deprecated.mjs

@@ -0,0 +1,94 @@
+import { COMPONENT_KINDS, DECLARED_COMPONENT_KINDS } from '../../../domain/openapi/components-object.mjs';
+import { isDeprecated } from '../document-entries.mjs';
+
+const UNTYPED_KEYS = /* @__PURE__ */ new Set([
+  "callbacks",
+  "discriminator",
+  "example",
+  "examples",
+  "externalDocs",
+  "links",
+  "security",
+  "securitySchemes",
+  "servers",
+  "xml"
+]);
+const EXTENSION_PREFIX = "x-";
+const RESOLVED_ENTRY_KEYS = /* @__PURE__ */ new Set([
+  "properties",
+  "parameters",
+  "get",
+  "put",
+  "post",
+  "delete",
+  "options",
+  "head",
+  "patch",
+  "trace",
+  "query"
+]);
+const COMPONENTS_PREFIX = "#/components/";
+function isObject(value) {
+  return typeof value === "object" && value !== null;
+}
+function refOf(value) {
+  return isObject(value) && typeof value.$ref === "string" ? value.$ref : void 0;
+}
+function isDroppedEntry(value, scan) {
+  const ref = refOf(value);
+  return isDeprecated(value) || ref !== void 0 && isDeprecated(scan.refs.resolve(ref));
+}
+function visitRef(ref, scan) {
+  const target = ref.startsWith(COMPONENTS_PREFIX) ? scan.refs.resolve(ref) : void 0;
+  if (isObject(target) && isDeprecated(target) && !scan.kept.has(target)) {
+    scan.kept.add(target);
+    visitContents(target, scan);
+  }
+}
+function visitEntries(value, scan) {
+  for (const entry of Array.isArray(value) ? value : Object.values(value)) {
+    if (!isDroppedEntry(entry, scan)) {
+      visit(entry, scan);
+    }
+  }
+}
+function visit(node, scan) {
+  if (Array.isArray(node)) {
+    for (const item of node) {
+      visit(item, scan);
+    }
+  } else if (isObject(node) && !isDeprecated(node)) {
+    visitContents(node, scan);
+  }
+}
+function visitContents(node, scan) {
+  const ref = refOf(node);
+  if (ref !== void 0) {
+    visitRef(ref, scan);
+  }
+  for (const [key, value] of Object.entries(node)) {
+    if (UNTYPED_KEYS.has(key) || key.startsWith(EXTENSION_PREFIX) || !isObject(value)) {
+      continue;
+    }
+    if (RESOLVED_ENTRY_KEYS.has(key)) {
+      visitEntries(key === "properties" || key === "parameters" ? value : [value], scan);
+    } else {
+      visit(value, scan);
+    }
+  }
+}
+function keptComponentEntries(components) {
+  const kinds = [...COMPONENT_KINDS, ...DECLARED_COMPONENT_KINDS];
+  return kinds.flatMap(
+    (kind) => Object.values(components?.[kind] ?? {}).filter((item) => !isDeprecated(item))
+  );
+}
+function keptDeprecatedComponents(document, refs) {
+  const scan = { refs, kept: /* @__PURE__ */ new Set() };
+  visit([document.paths, document.webhooks, document.$defs], scan);
+  visit(keptComponentEntries(document.components), scan);
+  return scan.kept;
+}
+
+export { keptDeprecatedComponents };
+//# sourceMappingURL=kept-deprecated.mjs.map

package/dist/application/transform/document/kept-deprecated.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"kept-deprecated.mjs","sources":["../../../../src/application/transform/document/kept-deprecated.ts"],"sourcesContent":["import {\n  COMPONENT_KINDS,\n  type ComponentsObject,\n  DECLARED_COMPONENT_KINDS,\n} from \"../../../domain/openapi/components-object.js\";\nimport type { DocumentObject } from \"../../../domain/openapi/document-object.js\";\nimport { isDeprecated } from \"../document-entries.js\";\nimport type { RefResolver } from \"../schema/schema-context.js\";\n\n/**\n * `--exclude-deprecated` and references (roadmap R10.3, backlog 29). A deprecated component is\n * left out, but a kept schema may still point to it (an array's `items`, say), and the output then\n * names a missing `components` key. This scan finds the deprecated components that the kept output\n * references, so they are kept too. It follows the generator's rules: a property, parameter or\n * operation whose (resolved) object is deprecated is dropped, so its `$ref` does not count. Keys\n * that are not typed are not followed, so a component they name stays out, as before.\n */\n\n/** Keys whose contents the generator does not type. */\nconst UNTYPED_KEYS: ReadonlySet<string> = new Set([\n  \"callbacks\",\n  \"discriminator\",\n  \"example\",\n  \"examples\",\n  \"externalDocs\",\n  \"links\",\n  \"security\",\n  \"securitySchemes\",\n  \"servers\",\n  \"xml\",\n]);\nconst EXTENSION_PREFIX = \"x-\";\n/** Keys whose entries the generator drops when the entry or its `$ref` target is deprecated. */\nconst RESOLVED_ENTRY_KEYS: ReadonlySet<string> = new Set([\n  \"properties\",\n  \"parameters\",\n  \"get\",\n  \"put\",\n  \"post\",\n  \"delete\",\n  \"options\",\n  \"head\",\n  \"patch\",\n  \"trace\",\n  \"query\",\n]);\nconst COMPONENTS_PREFIX = \"#/components/\";\n\ninterface Scan {\n  readonly refs: RefResolver;\n  /** The deprecated components to keep, as the document's own objects. */\n  readonly kept: Set<object>;\n}\n\nfunction isObject(value: unknown): value is Readonly<Record<string, unknown>> {\n  return typeof value === \"object\" && value !== null;\n}\n\nfunction refOf(value: unknown): string | undefined {\n  return isObject(value) && typeof value.$ref === \"string\" ? value.$ref : undefined;\n}\n\n/** Whether a dropped-when-deprecated entry is dropped: its own or its target's `deprecated`. */\nfunction isDroppedEntry(value: unknown, scan: Scan): boolean {\n  const ref = refOf(value);\n  return isDeprecated(value) || (ref !== undefined && isDeprecated(scan.refs.resolve(ref)));\n}\n\n/** A `$ref` to a deprecated component keeps it, and the component is scanned once. */\nfunction visitRef(ref: string, scan: Scan): void {\n  const target = ref.startsWith(COMPONENTS_PREFIX) ? scan.refs.resolve(ref) : undefined;\n  if (isObject(target) && isDeprecated(target) && !scan.kept.has(target)) {\n    scan.kept.add(target);\n    visitContents(target, scan);\n  }\n}\n\nfunction visitEntries(value: unknown, scan: Scan): void {\n  for (const entry of Array.isArray(value) ? value : Object.values(value as object)) {\n    if (!isDroppedEntry(entry, scan)) {\n      visit(entry, scan);\n    }\n  }\n}\n\n/** A node of kept output; a deprecated object here is dropped, so it is not followed. */\nfunction visit(node: unknown, scan: Scan): void {\n  if (Array.isArray(node)) {\n    for (const item of node) {\n      visit(item, scan);\n    }\n  } else if (isObject(node) && !isDeprecated(node)) {\n    visitContents(node, scan);\n  }\n}\n\n/** The `$ref` and the typed keys of an object. */\nfunction visitContents(node: Readonly<Record<string, unknown>>, scan: Scan): void {\n  const ref = refOf(node);\n  if (ref !== undefined) {\n    visitRef(ref, scan);\n  }\n  for (const [key, value] of Object.entries(node)) {\n    if (UNTYPED_KEYS.has(key) || key.startsWith(EXTENSION_PREFIX) || !isObject(value)) {\n      continue;\n    }\n    if (RESOLVED_ENTRY_KEYS.has(key)) {\n      visitEntries(key === \"properties\" || key === \"parameters\" ? value : [value], scan);\n    } else {\n      visit(value, scan);\n    }\n  }\n}\n\n/** The kept (not deprecated) entries of the typed component kinds. */\nfunction keptComponentEntries(components: ComponentsObject | undefined): unknown[] {\n  const kinds = [...COMPONENT_KINDS, ...DECLARED_COMPONENT_KINDS];\n  return kinds.flatMap((kind) =>\n    Object.values(components?.[kind] ?? {}).filter((item) => !isDeprecated(item)),\n  );\n}\n\n/**\n * The deprecated components that kept output references, as the objects of `document.components`\n * (the resolver returns those), so names that need escaping in a `$ref` match too.\n */\nexport function keptDeprecatedComponents(\n  document: DocumentObject,\n  refs: RefResolver,\n): ReadonlySet<object> {\n  const scan: Scan = { refs, kept: new Set() };\n  visit([document.paths, document.webhooks, document.$defs], scan);\n  visit(keptComponentEntries(document.components), scan);\n  return scan.kept;\n}\n"],"names":[],"mappings":"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"}

package/dist/application/transform/document/media-type.cjs

@@ -0,0 +1,42 @@
+'use strict';
+
+const constructors = require('../../../domain/ir/constructors.cjs');
+const propertyName = require('../../../domain/ir/property-name.cjs');
+const jsonPointer = require('../../../domain/openapi/json-pointer.cjs');
+const mediaTypeObject = require('../../../domain/openapi/media-type-object.cjs');
+const documentEntries = require('../document-entries.cjs');
+const schemaTransform = require('../schema/schema-transform.cjs');
+const sharedTypes = require('../shared-types.cjs');
+const documentMember = require('./document-member.cjs');
+
+const ITEM_CONTENT_KEY = "itemContent";
+function mediaTypeType(mediaType, location, context) {
+  return mediaType.schema ? schemaTransform.transformSchema(mediaType.schema, location, context) : sharedTypes.UNKNOWN_TYPE;
+}
+function contentEntryType(entry, location, context) {
+  return "$ref" in entry ? schemaTransform.transformSchema(entry, location, context) : mediaTypeType(entry, location, context);
+}
+function itemSchemaAt(entry, path, context) {
+  if ("$ref" in entry) {
+    const resolved = mediaTypeObject.isMediaTypeComponentRef(entry.$ref) ? context.refs.resolve(entry.$ref) : void 0;
+    return { schema: resolved?.itemSchema, path: jsonPointer.createRef([entry.$ref, "itemSchema"]) };
+  }
+  return { schema: entry.itemSchema, path: jsonPointer.createRef([path, "itemSchema"]) };
+}
+function itemContentMember(content, location, context, flags) {
+  const members = documentEntries.documentEntries(content, context.options).flatMap(([mediaType, entry]) => {
+    const contentPath = jsonPointer.createRef([location.path, "content", mediaType]);
+    const item = itemSchemaAt(entry, contentPath, context);
+    if (item.schema === void 0) {
+      return [];
+    }
+    const type = schemaTransform.transformSchema(item.schema, { ...location, path: item.path }, context);
+    return [documentMember.documentMember(mediaType, type, entry, { isReadonly: context.options.immutable })];
+  });
+  return members.length > 0 ? constructors.irProperty(propertyName.toPropertyName(ITEM_CONTENT_KEY), constructors.irObject(members), flags) : null;
+}
+
+exports.contentEntryType = contentEntryType;
+exports.itemContentMember = itemContentMember;
+exports.mediaTypeType = mediaTypeType;
+//# sourceMappingURL=media-type.cjs.map

package/dist/application/transform/document/media-type.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-type.cjs","sources":["../../../../src/application/transform/document/media-type.ts"],"sourcesContent":["import { irObject, irProperty } from \"../../../domain/ir/constructors.js\";\nimport type { IrPropertySignature, IrType } from \"../../../domain/ir/nodes.js\";\nimport { toPropertyName } from \"../../../domain/ir/property-name.js\";\nimport { createRef } from \"../../../domain/openapi/json-pointer.js\";\nimport {\n  type ContentMap,\n  isMediaTypeComponentRef,\n  type MediaTypeObject,\n} from \"../../../domain/openapi/media-type-object.js\";\nimport { documentEntries } from \"../document-entries.js\";\nimport type { SchemaContext, SchemaLocation } from \"../schema/schema-context.js\";\nimport { transformSchema } from \"../schema/schema-transform.js\";\nimport { UNKNOWN_TYPE } from \"../shared-types.js\";\nimport { documentMember } from \"./document-member.js\";\n\n/** The sibling of `content` that holds item types (ADR-020). */\nconst ITEM_CONTENT_KEY = \"itemContent\";\n\n/** A media type's schema, or `unknown` when it has none (OpenAPI 3.1 §4.8.14). */\nexport function mediaTypeType(\n  mediaType: MediaTypeObject,\n  location: SchemaLocation,\n  context: SchemaContext,\n): IrType {\n  return mediaType.schema ? transformSchema(mediaType.schema, location, context) : UNKNOWN_TYPE;\n}\n\n/** A `content` entry: a `$ref` is transformed like a schema `$ref`, the rest as a media type. */\nexport function contentEntryType(\n  entry: ContentMap[string],\n  location: SchemaLocation,\n  context: SchemaContext,\n): IrType {\n  // `in` throws for a null entry, as in the original.\n  return \"$ref\" in entry\n    ? transformSchema(entry, location, context)\n    : mediaTypeType(entry, location, context);\n}\n\n/** The `itemSchema` of a `content` entry and where it is, following a `$ref` to a component. */\nfunction itemSchemaAt(\n  entry: ContentMap[string],\n  path: string,\n  context: SchemaContext,\n): { readonly schema: MediaTypeObject[\"itemSchema\"]; readonly path: string } {\n  if (\"$ref\" in entry) {\n    // Other `$ref`s in `content` keep their pre-3.2 output, so only media type components count.\n    const resolved = isMediaTypeComponentRef(entry.$ref)\n      ? (context.refs.resolve(entry.$ref) as MediaTypeObject | undefined)\n      : undefined;\n    return { schema: resolved?.itemSchema, path: createRef([entry.$ref, \"itemSchema\"]) };\n  }\n  return { schema: entry.itemSchema, path: createRef([path, \"itemSchema\"]) };\n}\n\n/**\n * `itemContent`: the type of one item of each media type with an `itemSchema` (OpenAPI 3.2), next\n * to `content`, which keeps the type of the complete body. Null when no media type has one.\n */\nexport function itemContentMember(\n  content: ContentMap,\n  location: SchemaLocation,\n  context: SchemaContext,\n  flags: { readonly isReadonly: boolean },\n): IrPropertySignature | null {\n  const members = documentEntries(content, context.options).flatMap(([mediaType, entry]) => {\n    const contentPath = createRef([location.path, \"content\", mediaType]);\n    const item = itemSchemaAt(entry, contentPath, context);\n    if (item.schema === undefined) {\n      return [];\n    }\n    const type = transformSchema(item.schema, { ...location, path: item.path }, context);\n    return [documentMember(mediaType, type, entry, { isReadonly: context.options.immutable })];\n  });\n  return members.length > 0\n    ? irProperty(toPropertyName(ITEM_CONTENT_KEY), irObject(members), flags)\n    : null;\n}\n"],"names":["transformSchema","UNKNOWN_TYPE","isMediaTypeComponentRef","createRef","documentEntries","documentMember","irProperty","toPropertyName","irObject"],"mappings":";;;;;;;;;;;AAgBA,MAAM,gBAAA,GAAmB,aAAA;AAGlB,SAAS,aAAA,CACd,SAAA,EACA,QAAA,EACA,OAAA,EACQ;AACR,EAAA,OAAO,UAAU,MAAA,GAASA,+BAAA,CAAgB,UAAU,MAAA,EAAQ,QAAA,EAAU,OAAO,CAAA,GAAIC,wBAAA;AACnF;AAGO,SAAS,gBAAA,CACd,KAAA,EACA,QAAA,EACA,OAAA,EACQ;AAER,EAAA,OAAO,MAAA,IAAU,KAAA,GACbD,+BAAA,CAAgB,KAAA,EAAO,QAAA,EAAU,OAAO,CAAA,GACxC,aAAA,CAAc,KAAA,EAAO,QAAA,EAAU,OAAO,CAAA;AAC5C;AAGA,SAAS,YAAA,CACP,KAAA,EACA,IAAA,EACA,OAAA,EAC2E;AAC3E,EAAA,IAAI,UAAU,KAAA,EAAO;AAEnB,IAAA,MAAM,QAAA,GAAWE,uCAAA,CAAwB,KAAA,CAAM,IAAI,CAAA,GAC9C,QAAQ,IAAA,CAAK,OAAA,CAAQ,KAAA,CAAM,IAAI,CAAA,GAChC,MAAA;AACJ,IAAA,OAAO,EAAE,MAAA,EAAQ,QAAA,EAAU,UAAA,EAAY,IAAA,EAAMC,qBAAA,CAAU,CAAC,KAAA,CAAM,IAAA,EAAM,YAAY,CAAC,CAAA,EAAE;AAAA,EACrF;AACA,EAAA,OAAO,EAAE,MAAA,EAAQ,KAAA,CAAM,UAAA,EAAY,IAAA,EAAMA,sBAAU,CAAC,IAAA,EAAM,YAAY,CAAC,CAAA,EAAE;AAC3E;AAMO,SAAS,iBAAA,CACd,OAAA,EACA,QAAA,EACA,OAAA,EACA,KAAA,EAC4B;AAC5B,EAAA,MAAM,OAAA,GAAUC,+BAAA,CAAgB,OAAA,EAAS,OAAA,CAAQ,OAAO,CAAA,CAAE,OAAA,CAAQ,CAAC,CAAC,SAAA,EAAW,KAAK,CAAA,KAAM;AACxF,IAAA,MAAM,cAAcD,qBAAA,CAAU,CAAC,SAAS,IAAA,EAAM,SAAA,EAAW,SAAS,CAAC,CAAA;AACnE,IAAA,MAAM,IAAA,GAAO,YAAA,CAAa,KAAA,EAAO,WAAA,EAAa,OAAO,CAAA;AACrD,IAAA,IAAI,IAAA,CAAK,WAAW,MAAA,EAAW;AAC7B,MAAA,OAAO,EAAC;AAAA,IACV;AACA,IAAA,MAAM,IAAA,GAAOH,+BAAA,CAAgB,IAAA,CAAK,MAAA,EAAQ,EAAE,GAAG,QAAA,EAAU,IAAA,EAAM,IAAA,CAAK,IAAA,EAAK,EAAG,OAAO,CAAA;AACnF,IAAA,OAAO,CAACK,6BAAA,CAAe,SAAA,EAAW,IAAA,EAAM,KAAA,EAAO,EAAE,UAAA,EAAY,OAAA,CAAQ,OAAA,CAAQ,SAAA,EAAW,CAAC,CAAA;AAAA,EAC3F,CAAC,CAAA;AACD,EAAA,OAAO,OAAA,CAAQ,MAAA,GAAS,CAAA,GACpBC,uBAAA,CAAWC,2BAAA,CAAe,gBAAgB,CAAA,EAAGC,qBAAA,CAAS,OAAO,CAAA,EAAG,KAAK,CAAA,GACrE,IAAA;AACN;;;;"}

package/dist/application/transform/document/media-type.mjs

@@ -0,0 +1,38 @@
+import { irProperty, irObject } from '../../../domain/ir/constructors.mjs';
+import { toPropertyName } from '../../../domain/ir/property-name.mjs';
+import { createRef } from '../../../domain/openapi/json-pointer.mjs';
+import { isMediaTypeComponentRef } from '../../../domain/openapi/media-type-object.mjs';
+import { documentEntries } from '../document-entries.mjs';
+import { transformSchema } from '../schema/schema-transform.mjs';
+import { UNKNOWN_TYPE } from '../shared-types.mjs';
+import { documentMember } from './document-member.mjs';
+
+const ITEM_CONTENT_KEY = "itemContent";
+function mediaTypeType(mediaType, location, context) {
+  return mediaType.schema ? transformSchema(mediaType.schema, location, context) : UNKNOWN_TYPE;
+}
+function contentEntryType(entry, location, context) {
+  return "$ref" in entry ? transformSchema(entry, location, context) : mediaTypeType(entry, location, context);
+}
+function itemSchemaAt(entry, path, context) {
+  if ("$ref" in entry) {
+    const resolved = isMediaTypeComponentRef(entry.$ref) ? context.refs.resolve(entry.$ref) : void 0;
+    return { schema: resolved?.itemSchema, path: createRef([entry.$ref, "itemSchema"]) };
+  }
+  return { schema: entry.itemSchema, path: createRef([path, "itemSchema"]) };
+}
+function itemContentMember(content, location, context, flags) {
+  const members = documentEntries(content, context.options).flatMap(([mediaType, entry]) => {
+    const contentPath = createRef([location.path, "content", mediaType]);
+    const item = itemSchemaAt(entry, contentPath, context);
+    if (item.schema === void 0) {
+      return [];
+    }
+    const type = transformSchema(item.schema, { ...location, path: item.path }, context);
+    return [documentMember(mediaType, type, entry, { isReadonly: context.options.immutable })];
+  });
+  return members.length > 0 ? irProperty(toPropertyName(ITEM_CONTENT_KEY), irObject(members), flags) : null;
+}
+
+export { contentEntryType, itemContentMember, mediaTypeType };
+//# sourceMappingURL=media-type.mjs.map

package/dist/application/transform/document/media-type.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-type.mjs","sources":["../../../../src/application/transform/document/media-type.ts"],"sourcesContent":["import { irObject, irProperty } from \"../../../domain/ir/constructors.js\";\nimport type { IrPropertySignature, IrType } from \"../../../domain/ir/nodes.js\";\nimport { toPropertyName } from \"../../../domain/ir/property-name.js\";\nimport { createRef } from \"../../../domain/openapi/json-pointer.js\";\nimport {\n  type ContentMap,\n  isMediaTypeComponentRef,\n  type MediaTypeObject,\n} from \"../../../domain/openapi/media-type-object.js\";\nimport { documentEntries } from \"../document-entries.js\";\nimport type { SchemaContext, SchemaLocation } from \"../schema/schema-context.js\";\nimport { transformSchema } from \"../schema/schema-transform.js\";\nimport { UNKNOWN_TYPE } from \"../shared-types.js\";\nimport { documentMember } from \"./document-member.js\";\n\n/** The sibling of `content` that holds item types (ADR-020). */\nconst ITEM_CONTENT_KEY = \"itemContent\";\n\n/** A media type's schema, or `unknown` when it has none (OpenAPI 3.1 §4.8.14). */\nexport function mediaTypeType(\n  mediaType: MediaTypeObject,\n  location: SchemaLocation,\n  context: SchemaContext,\n): IrType {\n  return mediaType.schema ? transformSchema(mediaType.schema, location, context) : UNKNOWN_TYPE;\n}\n\n/** A `content` entry: a `$ref` is transformed like a schema `$ref`, the rest as a media type. */\nexport function contentEntryType(\n  entry: ContentMap[string],\n  location: SchemaLocation,\n  context: SchemaContext,\n): IrType {\n  // `in` throws for a null entry, as in the original.\n  return \"$ref\" in entry\n    ? transformSchema(entry, location, context)\n    : mediaTypeType(entry, location, context);\n}\n\n/** The `itemSchema` of a `content` entry and where it is, following a `$ref` to a component. */\nfunction itemSchemaAt(\n  entry: ContentMap[string],\n  path: string,\n  context: SchemaContext,\n): { readonly schema: MediaTypeObject[\"itemSchema\"]; readonly path: string } {\n  if (\"$ref\" in entry) {\n    // Other `$ref`s in `content` keep their pre-3.2 output, so only media type components count.\n    const resolved = isMediaTypeComponentRef(entry.$ref)\n      ? (context.refs.resolve(entry.$ref) as MediaTypeObject | undefined)\n      : undefined;\n    return { schema: resolved?.itemSchema, path: createRef([entry.$ref, \"itemSchema\"]) };\n  }\n  return { schema: entry.itemSchema, path: createRef([path, \"itemSchema\"]) };\n}\n\n/**\n * `itemContent`: the type of one item of each media type with an `itemSchema` (OpenAPI 3.2), next\n * to `content`, which keeps the type of the complete body. Null when no media type has one.\n */\nexport function itemContentMember(\n  content: ContentMap,\n  location: SchemaLocation,\n  context: SchemaContext,\n  flags: { readonly isReadonly: boolean },\n): IrPropertySignature | null {\n  const members = documentEntries(content, context.options).flatMap(([mediaType, entry]) => {\n    const contentPath = createRef([location.path, \"content\", mediaType]);\n    const item = itemSchemaAt(entry, contentPath, context);\n    if (item.schema === undefined) {\n      return [];\n    }\n    const type = transformSchema(item.schema, { ...location, path: item.path }, context);\n    return [documentMember(mediaType, type, entry, { isReadonly: context.options.immutable })];\n  });\n  return members.length > 0\n    ? irProperty(toPropertyName(ITEM_CONTENT_KEY), irObject(members), flags)\n    : null;\n}\n"],"names":[],"mappings":";;;;;;;;;AAgBA,MAAM,gBAAA,GAAmB,aAAA;AAGlB,SAAS,aAAA,CACd,SAAA,EACA,QAAA,EACA,OAAA,EACQ;AACR,EAAA,OAAO,UAAU,MAAA,GAAS,eAAA,CAAgB,UAAU,MAAA,EAAQ,QAAA,EAAU,OAAO,CAAA,GAAI,YAAA;AACnF;AAGO,SAAS,gBAAA,CACd,KAAA,EACA,QAAA,EACA,OAAA,EACQ;AAER,EAAA,OAAO,MAAA,IAAU,KAAA,GACb,eAAA,CAAgB,KAAA,EAAO,QAAA,EAAU,OAAO,CAAA,GACxC,aAAA,CAAc,KAAA,EAAO,QAAA,EAAU,OAAO,CAAA;AAC5C;AAGA,SAAS,YAAA,CACP,KAAA,EACA,IAAA,EACA,OAAA,EAC2E;AAC3E,EAAA,IAAI,UAAU,KAAA,EAAO;AAEnB,IAAA,MAAM,QAAA,GAAW,uBAAA,CAAwB,KAAA,CAAM,IAAI,CAAA,GAC9C,QAAQ,IAAA,CAAK,OAAA,CAAQ,KAAA,CAAM,IAAI,CAAA,GAChC,MAAA;AACJ,IAAA,OAAO,EAAE,MAAA,EAAQ,QAAA,EAAU,UAAA,EAAY,IAAA,EAAM,SAAA,CAAU,CAAC,KAAA,CAAM,IAAA,EAAM,YAAY,CAAC,CAAA,EAAE;AAAA,EACrF;AACA,EAAA,OAAO,EAAE,MAAA,EAAQ,KAAA,CAAM,UAAA,EAAY,IAAA,EAAM,UAAU,CAAC,IAAA,EAAM,YAAY,CAAC,CAAA,EAAE;AAC3E;AAMO,SAAS,iBAAA,CACd,OAAA,EACA,QAAA,EACA,OAAA,EACA,KAAA,EAC4B;AAC5B,EAAA,MAAM,OAAA,GAAU,eAAA,CAAgB,OAAA,EAAS,OAAA,CAAQ,OAAO,CAAA,CAAE,OAAA,CAAQ,CAAC,CAAC,SAAA,EAAW,KAAK,CAAA,KAAM;AACxF,IAAA,MAAM,cAAc,SAAA,CAAU,CAAC,SAAS,IAAA,EAAM,SAAA,EAAW,SAAS,CAAC,CAAA;AACnE,IAAA,MAAM,IAAA,GAAO,YAAA,CAAa,KAAA,EAAO,WAAA,EAAa,OAAO,CAAA;AACrD,IAAA,IAAI,IAAA,CAAK,WAAW,MAAA,EAAW;AAC7B,MAAA,OAAO,EAAC;AAAA,IACV;AACA,IAAA,MAAM,IAAA,GAAO,eAAA,CAAgB,IAAA,CAAK,MAAA,EAAQ,EAAE,GAAG,QAAA,EAAU,IAAA,EAAM,IAAA,CAAK,IAAA,EAAK,EAAG,OAAO,CAAA;AACnF,IAAA,OAAO,CAAC,cAAA,CAAe,SAAA,EAAW,IAAA,EAAM,KAAA,EAAO,EAAE,UAAA,EAAY,OAAA,CAAQ,OAAA,CAAQ,SAAA,EAAW,CAAC,CAAA;AAAA,EAC3F,CAAC,CAAA;AACD,EAAA,OAAO,OAAA,CAAQ,MAAA,GAAS,CAAA,GACpB,UAAA,CAAW,cAAA,CAAe,gBAAgB,CAAA,EAAG,QAAA,CAAS,OAAO,CAAA,EAAG,KAAK,CAAA,GACrE,IAAA;AACN;;"}

package/dist/application/transform/document/operation.cjs

@@ -0,0 +1,45 @@
+'use strict';
+
+const constructors = require('../../../domain/ir/constructors.cjs');
+const propertyName = require('../../../domain/ir/property-name.cjs');
+const jsonPointer = require('../../../domain/openapi/json-pointer.cjs');
+const refType = require('../ref-type.cjs');
+const documentMember = require('./document-member.cjs');
+const parameters = require('./parameters.cjs');
+const requestBody = require('./request-body.cjs');
+const responses = require('./responses.cjs');
+
+function requestBodyMember(operation, location, context) {
+  const isReadonly = context.options.immutable;
+  const body = operation.requestBody;
+  if (!body) {
+    return constructors.irProperty(propertyName.toPropertyName("requestBody"), constructors.irKeyword("never"), {
+      isOptional: true,
+      isReadonly
+    });
+  }
+  const isReference = "$ref" in body;
+  const type = isReference ? refType.refType(body.$ref) : requestBody.requestBodyType(
+    body,
+    { ...location, path: jsonPointer.createRef([location.path, "requestBody"]) },
+    context
+  );
+  const resolved = isReference ? context.refs.resolve(body.$ref) : body;
+  return documentMember.documentMember("requestBody", type, body, {
+    isReadonly,
+    isOptional: !resolved?.required
+  });
+}
+function operationMembers(operation, location, context) {
+  const parameters$1 = parameters.parametersMember(operation.parameters ?? [], location, context);
+  const requestBody = requestBodyMember(operation, location, context);
+  const responses$1 = responses.responsesType(operation.responses ?? {}, location, context);
+  return [
+    parameters$1,
+    requestBody,
+    constructors.irProperty(propertyName.toPropertyName("responses"), responses$1, { isReadonly: context.options.immutable })
+  ];
+}
+
+exports.operationMembers = operationMembers;
+//# sourceMappingURL=operation.cjs.map

package/dist/application/transform/document/operation.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation.cjs","sources":["../../../../src/application/transform/document/operation.ts"],"sourcesContent":["import { irKeyword, irProperty } from \"../../../domain/ir/constructors.js\";\nimport type { IrPropertySignature } from \"../../../domain/ir/nodes.js\";\nimport { toPropertyName } from \"../../../domain/ir/property-name.js\";\nimport { createRef } from \"../../../domain/openapi/json-pointer.js\";\nimport type { OperationObject } from \"../../../domain/openapi/operation-object.js\";\nimport type { RequestBodyObject } from \"../../../domain/openapi/request-body-object.js\";\nimport { refType } from \"../ref-type.js\";\nimport type { SchemaLocation } from \"../schema/schema-context.js\";\nimport type { TransformContext } from \"../transform-context.js\";\nimport { documentMember } from \"./document-member.js\";\nimport { parametersMember } from \"./parameters.js\";\nimport { requestBodyType } from \"./request-body.js\";\nimport { responsesType } from \"./responses.js\";\n\n/** `requestBody`, optional unless the resolved body is required; `requestBody?: never` if none. */\nfunction requestBodyMember(\n  operation: OperationObject,\n  location: SchemaLocation,\n  context: TransformContext,\n): IrPropertySignature {\n  const isReadonly = context.options.immutable;\n  const body = operation.requestBody;\n  if (!body) {\n    return irProperty(toPropertyName(\"requestBody\"), irKeyword(\"never\"), {\n      isOptional: true,\n      isReadonly,\n    });\n  }\n  const isReference = \"$ref\" in body;\n  const type = isReference\n    ? refType(body.$ref)\n    : requestBodyType(\n        body,\n        { ...location, path: createRef([location.path, \"requestBody\"]) },\n        context,\n      );\n  const resolved = isReference\n    ? (context.refs.resolve(body.$ref) as RequestBodyObject | undefined)\n    : body;\n  return documentMember(\"requestBody\", type, body, {\n    isReadonly,\n    isOptional: !resolved?.required,\n  });\n}\n\n/**\n * The members of an operation (OpenAPI 3.1 §4.8.10): `parameters`, `requestBody` and `responses`.\n * `location.path` is the operation's pointer.\n */\nexport function operationMembers(\n  operation: OperationObject,\n  location: SchemaLocation,\n  context: TransformContext,\n): IrPropertySignature[] {\n  // Built in document order: each part may add footer declarations (enums), in this order.\n  const parameters = parametersMember(operation.parameters ?? [], location, context);\n  const requestBody = requestBodyMember(operation, location, context);\n  const responses = responsesType(operation.responses ?? {}, location, context);\n  return [\n    parameters,\n    requestBody,\n    irProperty(toPropertyName(\"responses\"), responses, { isReadonly: context.options.immutable }),\n  ];\n}\n"],"names":["irProperty","toPropertyName","irKeyword","refType","requestBodyType","createRef","documentMember","parameters","parametersMember","responses","responsesType"],"mappings":";;;;;;;;;;;AAeA,SAAS,iBAAA,CACP,SAAA,EACA,QAAA,EACA,OAAA,EACqB;AACrB,EAAA,MAAM,UAAA,GAAa,QAAQ,OAAA,CAAQ,SAAA;AACnC,EAAA,MAAM,OAAO,SAAA,CAAU,WAAA;AACvB,EAAA,IAAI,CAAC,IAAA,EAAM;AACT,IAAA,OAAOA,wBAAWC,2BAAA,CAAe,aAAa,CAAA,EAAGC,sBAAA,CAAU,OAAO,CAAA,EAAG;AAAA,MACnE,UAAA,EAAY,IAAA;AAAA,MACZ;AAAA,KACD,CAAA;AAAA,EACH;AACA,EAAA,MAAM,cAAc,MAAA,IAAU,IAAA;AAC9B,EAAA,MAAM,IAAA,GAAO,WAAA,GACTC,eAAA,CAAQ,IAAA,CAAK,IAAI,CAAA,GACjBC,2BAAA;AAAA,IACE,IAAA;AAAA,IACA,EAAE,GAAG,QAAA,EAAU,IAAA,EAAMC,qBAAA,CAAU,CAAC,QAAA,CAAS,IAAA,EAAM,aAAa,CAAC,CAAA,EAAE;AAAA,IAC/D;AAAA,GACF;AACJ,EAAA,MAAM,WAAW,WAAA,GACZ,OAAA,CAAQ,KAAK,OAAA,CAAQ,IAAA,CAAK,IAAI,CAAA,GAC/B,IAAA;AACJ,EAAA,OAAOC,6BAAA,CAAe,aAAA,EAAe,IAAA,EAAM,IAAA,EAAM;AAAA,IAC/C,UAAA;AAAA,IACA,UAAA,EAAY,CAAC,QAAA,EAAU;AAAA,GACxB,CAAA;AACH;AAMO,SAAS,gBAAA,CACd,SAAA,EACA,QAAA,EACA,OAAA,EACuB;AAEvB,EAAA,MAAMC,eAAaC,2BAAA,CAAiB,SAAA,CAAU,cAAc,EAAC,EAAG,UAAU,OAAO,CAAA;AACjF,EAAA,MAAM,WAAA,GAAc,iBAAA,CAAkB,SAAA,EAAW,QAAA,EAAU,OAAO,CAAA;AAClE,EAAA,MAAMC,cAAYC,uBAAA,CAAc,SAAA,CAAU,aAAa,EAAC,EAAG,UAAU,OAAO,CAAA;AAC5E,EAAA,OAAO;AAAA,IACLH,YAAA;AAAA,IACA,WAAA;AAAA,IACAP,uBAAA,CAAWC,2BAAA,CAAe,WAAW,CAAA,EAAGQ,WAAA,EAAW,EAAE,UAAA,EAAY,OAAA,CAAQ,OAAA,CAAQ,SAAA,EAAW;AAAA,GAC9F;AACF;;"}

package/dist/application/transform/document/operation.mjs

@@ -0,0 +1,43 @@
+import { irProperty, irKeyword } from '../../../domain/ir/constructors.mjs';
+import { toPropertyName } from '../../../domain/ir/property-name.mjs';
+import { createRef } from '../../../domain/openapi/json-pointer.mjs';
+import { refType } from '../ref-type.mjs';
+import { documentMember } from './document-member.mjs';
+import { parametersMember } from './parameters.mjs';
+import { requestBodyType } from './request-body.mjs';
+import { responsesType } from './responses.mjs';
+
+function requestBodyMember(operation, location, context) {
+  const isReadonly = context.options.immutable;
+  const body = operation.requestBody;
+  if (!body) {
+    return irProperty(toPropertyName("requestBody"), irKeyword("never"), {
+      isOptional: true,
+      isReadonly
+    });
+  }
+  const isReference = "$ref" in body;
+  const type = isReference ? refType(body.$ref) : requestBodyType(
+    body,
+    { ...location, path: createRef([location.path, "requestBody"]) },
+    context
+  );
+  const resolved = isReference ? context.refs.resolve(body.$ref) : body;
+  return documentMember("requestBody", type, body, {
+    isReadonly,
+    isOptional: !resolved?.required
+  });
+}
+function operationMembers(operation, location, context) {
+  const parameters = parametersMember(operation.parameters ?? [], location, context);
+  const requestBody = requestBodyMember(operation, location, context);
+  const responses = responsesType(operation.responses ?? {}, location, context);
+  return [
+    parameters,
+    requestBody,
+    irProperty(toPropertyName("responses"), responses, { isReadonly: context.options.immutable })
+  ];
+}
+
+export { operationMembers };
+//# sourceMappingURL=operation.mjs.map

package/dist/application/transform/document/operation.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation.mjs","sources":["../../../../src/application/transform/document/operation.ts"],"sourcesContent":["import { irKeyword, irProperty } from \"../../../domain/ir/constructors.js\";\nimport type { IrPropertySignature } from \"../../../domain/ir/nodes.js\";\nimport { toPropertyName } from \"../../../domain/ir/property-name.js\";\nimport { createRef } from \"../../../domain/openapi/json-pointer.js\";\nimport type { OperationObject } from \"../../../domain/openapi/operation-object.js\";\nimport type { RequestBodyObject } from \"../../../domain/openapi/request-body-object.js\";\nimport { refType } from \"../ref-type.js\";\nimport type { SchemaLocation } from \"../schema/schema-context.js\";\nimport type { TransformContext } from \"../transform-context.js\";\nimport { documentMember } from \"./document-member.js\";\nimport { parametersMember } from \"./parameters.js\";\nimport { requestBodyType } from \"./request-body.js\";\nimport { responsesType } from \"./responses.js\";\n\n/** `requestBody`, optional unless the resolved body is required; `requestBody?: never` if none. */\nfunction requestBodyMember(\n  operation: OperationObject,\n  location: SchemaLocation,\n  context: TransformContext,\n): IrPropertySignature {\n  const isReadonly = context.options.immutable;\n  const body = operation.requestBody;\n  if (!body) {\n    return irProperty(toPropertyName(\"requestBody\"), irKeyword(\"never\"), {\n      isOptional: true,\n      isReadonly,\n    });\n  }\n  const isReference = \"$ref\" in body;\n  const type = isReference\n    ? refType(body.$ref)\n    : requestBodyType(\n        body,\n        { ...location, path: createRef([location.path, \"requestBody\"]) },\n        context,\n      );\n  const resolved = isReference\n    ? (context.refs.resolve(body.$ref) as RequestBodyObject | undefined)\n    : body;\n  return documentMember(\"requestBody\", type, body, {\n    isReadonly,\n    isOptional: !resolved?.required,\n  });\n}\n\n/**\n * The members of an operation (OpenAPI 3.1 §4.8.10): `parameters`, `requestBody` and `responses`.\n * `location.path` is the operation's pointer.\n */\nexport function operationMembers(\n  operation: OperationObject,\n  location: SchemaLocation,\n  context: TransformContext,\n): IrPropertySignature[] {\n  // Built in document order: each part may add footer declarations (enums), in this order.\n  const parameters = parametersMember(operation.parameters ?? [], location, context);\n  const requestBody = requestBodyMember(operation, location, context);\n  const responses = responsesType(operation.responses ?? {}, location, context);\n  return [\n    parameters,\n    requestBody,\n    irProperty(toPropertyName(\"responses\"), responses, { isReadonly: context.options.immutable }),\n  ];\n}\n"],"names":[],"mappings":";;;;;;;;;AAeA,SAAS,iBAAA,CACP,SAAA,EACA,QAAA,EACA,OAAA,EACqB;AACrB,EAAA,MAAM,UAAA,GAAa,QAAQ,OAAA,CAAQ,SAAA;AACnC,EAAA,MAAM,OAAO,SAAA,CAAU,WAAA;AACvB,EAAA,IAAI,CAAC,IAAA,EAAM;AACT,IAAA,OAAO,WAAW,cAAA,CAAe,aAAa,CAAA,EAAG,SAAA,CAAU,OAAO,CAAA,EAAG;AAAA,MACnE,UAAA,EAAY,IAAA;AAAA,MACZ;AAAA,KACD,CAAA;AAAA,EACH;AACA,EAAA,MAAM,cAAc,MAAA,IAAU,IAAA;AAC9B,EAAA,MAAM,IAAA,GAAO,WAAA,GACT,OAAA,CAAQ,IAAA,CAAK,IAAI,CAAA,GACjB,eAAA;AAAA,IACE,IAAA;AAAA,IACA,EAAE,GAAG,QAAA,EAAU,IAAA,EAAM,SAAA,CAAU,CAAC,QAAA,CAAS,IAAA,EAAM,aAAa,CAAC,CAAA,EAAE;AAAA,IAC/D;AAAA,GACF;AACJ,EAAA,MAAM,WAAW,WAAA,GACZ,OAAA,CAAQ,KAAK,OAAA,CAAQ,IAAA,CAAK,IAAI,CAAA,GAC/B,IAAA;AACJ,EAAA,OAAO,cAAA,CAAe,aAAA,EAAe,IAAA,EAAM,IAAA,EAAM;AAAA,IAC/C,UAAA;AAAA,IACA,UAAA,EAAY,CAAC,QAAA,EAAU;AAAA,GACxB,CAAA;AACH;AAMO,SAAS,gBAAA,CACd,SAAA,EACA,QAAA,EACA,OAAA,EACuB;AAEvB,EAAA,MAAM,aAAa,gBAAA,CAAiB,SAAA,CAAU,cAAc,EAAC,EAAG,UAAU,OAAO,CAAA;AACjF,EAAA,MAAM,WAAA,GAAc,iBAAA,CAAkB,SAAA,EAAW,QAAA,EAAU,OAAO,CAAA;AAClE,EAAA,MAAM,YAAY,aAAA,CAAc,SAAA,CAAU,aAAa,EAAC,EAAG,UAAU,OAAO,CAAA;AAC5E,EAAA,OAAO;AAAA,IACL,UAAA;AAAA,IACA,WAAA;AAAA,IACA,UAAA,CAAW,cAAA,CAAe,WAAW,CAAA,EAAG,SAAA,EAAW,EAAE,UAAA,EAAY,OAAA,CAAQ,OAAA,CAAQ,SAAA,EAAW;AAAA,GAC9F;AACF;;"}

package/dist/application/transform/document/parameter.cjs

@@ -0,0 +1,25 @@
+'use strict';
+
+const constructors = require('../../../domain/ir/constructors.cjs');
+const jsonPointer = require('../../../domain/openapi/json-pointer.cjs');
+const parameterObject = require('../../../domain/openapi/parameter-object.cjs');
+const schemaTransform = require('../schema/schema-transform.cjs');
+const mediaType = require('./media-type.cjs');
+
+function querystringType(parameter, location, context) {
+  const [mediaType$1, entry] = Object.entries(parameter.content ?? {})[0] ?? [];
+  if (mediaType$1 === void 0 || entry === void 0) {
+    return constructors.irKeyword("string");
+  }
+  const path = jsonPointer.createRef([location.path, "content", mediaType$1]);
+  return mediaType.contentEntryType(entry, { ...location, path }, context);
+}
+function parameterType(parameter, location, context) {
+  if (parameter.in === parameterObject.QUERYSTRING_LOCATION) {
+    return querystringType(parameter, location, context);
+  }
+  return parameter.schema ? schemaTransform.transformSchema(parameter.schema, location, context) : constructors.irKeyword("string");
+}
+
+exports.parameterType = parameterType;
+//# sourceMappingURL=parameter.cjs.map

package/dist/application/transform/document/parameter.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"parameter.cjs","sources":["../../../../src/application/transform/document/parameter.ts"],"sourcesContent":["import { irKeyword } from \"../../../domain/ir/constructors.js\";\nimport type { IrType } from \"../../../domain/ir/nodes.js\";\nimport { createRef } from \"../../../domain/openapi/json-pointer.js\";\nimport {\n  type ParameterObject,\n  QUERYSTRING_LOCATION,\n} from \"../../../domain/openapi/parameter-object.js\";\nimport type { SchemaContext, SchemaLocation } from \"../schema/schema-context.js\";\nimport { transformSchema } from \"../schema/schema-transform.js\";\nimport { contentEntryType } from \"./media-type.js\";\n\n/**\n * An `in: querystring` parameter (OpenAPI 3.2): the whole query string, typed by the schema of its\n * one `content` media type (ADR-020). Without one it is `string`, the query string as text.\n */\nfunction querystringType(\n  parameter: ParameterObject,\n  location: SchemaLocation,\n  context: SchemaContext,\n): IrType {\n  const [mediaType, entry] = Object.entries(parameter.content ?? {})[0] ?? [];\n  if (mediaType === undefined || entry === undefined) {\n    return irKeyword(\"string\");\n  }\n  const path = createRef([location.path, \"content\", mediaType]);\n  return contentEntryType(entry, { ...location, path }, context);\n}\n\n/**\n * A parameter's type (OpenAPI 3.2 §4.8.12). Without a schema it is `string`, not `unknown`:\n * query, path, header and cookie values all arrive as text. `content` is read only for\n * `in: querystring`; other parameters with `content` keep their pre-3.2 type.\n */\nexport function parameterType(\n  parameter: ParameterObject,\n  location: SchemaLocation,\n  context: SchemaContext,\n): IrType {\n  if (parameter.in === QUERYSTRING_LOCATION) {\n    return querystringType(parameter, location, context);\n  }\n  return parameter.schema\n    ? transformSchema(parameter.schema, location, context)\n    : irKeyword(\"string\");\n}\n"],"names":["mediaType","irKeyword","createRef","contentEntryType","QUERYSTRING_LOCATION","transformSchema"],"mappings":";;;;;;;;AAeA,SAAS,eAAA,CACP,SAAA,EACA,QAAA,EACA,OAAA,EACQ;AACR,EAAA,MAAM,CAACA,WAAA,EAAW,KAAK,CAAA,GAAI,MAAA,CAAO,OAAA,CAAQ,SAAA,CAAU,OAAA,IAAW,EAAE,CAAA,CAAE,CAAC,KAAK,EAAC;AAC1E,EAAA,IAAIA,WAAA,KAAc,MAAA,IAAa,KAAA,KAAU,MAAA,EAAW;AAClD,IAAA,OAAOC,uBAAU,QAAQ,CAAA;AAAA,EAC3B;AACA,EAAA,MAAM,OAAOC,qBAAA,CAAU,CAAC,SAAS,IAAA,EAAM,SAAA,EAAWF,WAAS,CAAC,CAAA;AAC5D,EAAA,OAAOG,2BAAiB,KAAA,EAAO,EAAE,GAAG,QAAA,EAAU,IAAA,IAAQ,OAAO,CAAA;AAC/D;AAOO,SAAS,aAAA,CACd,SAAA,EACA,QAAA,EACA,OAAA,EACQ;AACR,EAAA,IAAI,SAAA,CAAU,OAAOC,oCAAA,EAAsB;AACzC,IAAA,OAAO,eAAA,CAAgB,SAAA,EAAW,QAAA,EAAU,OAAO,CAAA;AAAA,EACrD;AACA,EAAA,OAAO,SAAA,CAAU,SACbC,+BAAA,CAAgB,SAAA,CAAU,QAAQ,QAAA,EAAU,OAAO,CAAA,GACnDJ,sBAAA,CAAU,QAAQ,CAAA;AACxB;;"}

package/dist/application/transform/document/parameter.mjs

@@ -0,0 +1,23 @@
+import { irKeyword } from '../../../domain/ir/constructors.mjs';
+import { createRef } from '../../../domain/openapi/json-pointer.mjs';
+import { QUERYSTRING_LOCATION } from '../../../domain/openapi/parameter-object.mjs';
+import { transformSchema } from '../schema/schema-transform.mjs';
+import { contentEntryType } from './media-type.mjs';
+
+function querystringType(parameter, location, context) {
+  const [mediaType, entry] = Object.entries(parameter.content ?? {})[0] ?? [];
+  if (mediaType === void 0 || entry === void 0) {
+    return irKeyword("string");
+  }
+  const path = createRef([location.path, "content", mediaType]);
+  return contentEntryType(entry, { ...location, path }, context);
+}
+function parameterType(parameter, location, context) {
+  if (parameter.in === QUERYSTRING_LOCATION) {
+    return querystringType(parameter, location, context);
+  }
+  return parameter.schema ? transformSchema(parameter.schema, location, context) : irKeyword("string");
+}
+
+export { parameterType };
+//# sourceMappingURL=parameter.mjs.map

package/dist/application/transform/document/parameter.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"parameter.mjs","sources":["../../../../src/application/transform/document/parameter.ts"],"sourcesContent":["import { irKeyword } from \"../../../domain/ir/constructors.js\";\nimport type { IrType } from \"../../../domain/ir/nodes.js\";\nimport { createRef } from \"../../../domain/openapi/json-pointer.js\";\nimport {\n  type ParameterObject,\n  QUERYSTRING_LOCATION,\n} from \"../../../domain/openapi/parameter-object.js\";\nimport type { SchemaContext, SchemaLocation } from \"../schema/schema-context.js\";\nimport { transformSchema } from \"../schema/schema-transform.js\";\nimport { contentEntryType } from \"./media-type.js\";\n\n/**\n * An `in: querystring` parameter (OpenAPI 3.2): the whole query string, typed by the schema of its\n * one `content` media type (ADR-020). Without one it is `string`, the query string as text.\n */\nfunction querystringType(\n  parameter: ParameterObject,\n  location: SchemaLocation,\n  context: SchemaContext,\n): IrType {\n  const [mediaType, entry] = Object.entries(parameter.content ?? {})[0] ?? [];\n  if (mediaType === undefined || entry === undefined) {\n    return irKeyword(\"string\");\n  }\n  const path = createRef([location.path, \"content\", mediaType]);\n  return contentEntryType(entry, { ...location, path }, context);\n}\n\n/**\n * A parameter's type (OpenAPI 3.2 §4.8.12). Without a schema it is `string`, not `unknown`:\n * query, path, header and cookie values all arrive as text. `content` is read only for\n * `in: querystring`; other parameters with `content` keep their pre-3.2 type.\n */\nexport function parameterType(\n  parameter: ParameterObject,\n  location: SchemaLocation,\n  context: SchemaContext,\n): IrType {\n  if (parameter.in === QUERYSTRING_LOCATION) {\n    return querystringType(parameter, location, context);\n  }\n  return parameter.schema\n    ? transformSchema(parameter.schema, location, context)\n    : irKeyword(\"string\");\n}\n"],"names":[],"mappings":";;;;;;AAeA,SAAS,eAAA,CACP,SAAA,EACA,QAAA,EACA,OAAA,EACQ;AACR,EAAA,MAAM,CAAC,SAAA,EAAW,KAAK,CAAA,GAAI,MAAA,CAAO,OAAA,CAAQ,SAAA,CAAU,OAAA,IAAW,EAAE,CAAA,CAAE,CAAC,KAAK,EAAC;AAC1E,EAAA,IAAI,SAAA,KAAc,MAAA,IAAa,KAAA,KAAU,MAAA,EAAW;AAClD,IAAA,OAAO,UAAU,QAAQ,CAAA;AAAA,EAC3B;AACA,EAAA,MAAM,OAAO,SAAA,CAAU,CAAC,SAAS,IAAA,EAAM,SAAA,EAAW,SAAS,CAAC,CAAA;AAC5D,EAAA,OAAO,iBAAiB,KAAA,EAAO,EAAE,GAAG,QAAA,EAAU,IAAA,IAAQ,OAAO,CAAA;AAC/D;AAOO,SAAS,aAAA,CACd,SAAA,EACA,QAAA,EACA,OAAA,EACQ;AACR,EAAA,IAAI,SAAA,CAAU,OAAO,oBAAA,EAAsB;AACzC,IAAA,OAAO,eAAA,CAAgB,SAAA,EAAW,QAAA,EAAU,OAAO,CAAA;AAAA,EACrD;AACA,EAAA,OAAO,SAAA,CAAU,SACb,eAAA,CAAgB,SAAA,CAAU,QAAQ,QAAA,EAAU,OAAO,CAAA,GACnD,SAAA,CAAU,QAAQ,CAAA;AACxB;;"}