openapi-typesafe 0.0.0 → 1.0.0-rc.0

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

@@ -0,0 +1,114 @@
+'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 parameterObject = require('../../../domain/openapi/parameter-object.cjs');
+const refType = require('../ref-type.cjs');
+const schemaComment = require('../schema-comment.cjs');
+const parameter = require('./parameter.cjs');
+
+const PATH_TEMPLATE_RE = /\{([^}]+)\}/g;
+function resolveParameter(parameter, context) {
+  return "$ref" in parameter ? context.refs.resolve(parameter.$ref) : parameter;
+}
+function pathTemplateParameters(path) {
+  return (path.match(PATH_TEMPLATE_RE) ?? []).map((match) => ({
+    name: match.slice(1, -1),
+    in: "path",
+    required: true,
+    schema: { type: "string" }
+  }));
+}
+function withPathTemplateParameters(parameters, location, context) {
+  const result = [...parameters];
+  if (!context.options.generatePathParams || !location.path) {
+    return result;
+  }
+  for (const parameter of pathTemplateParameters(location.path)) {
+    const isDefined = result.some((candidate) => {
+      const resolved = resolveParameter(candidate, context);
+      return resolved?.in === "path" && resolved.name === parameter.name;
+    });
+    if (!isDefined) {
+      result.push(parameter);
+    }
+  }
+  return result;
+}
+function isDeprecatedParameter(parameter) {
+  const schema = parameter?.schema;
+  return Boolean(parameter?.deprecated || schema?.deprecated);
+}
+function parameterEntries(parameters, context) {
+  const entries = parameters.map((original) => ({
+    original,
+    resolved: resolveParameter(original, context)
+  }));
+  if (context.options.alphabetize) {
+    entries.sort(
+      (left, right) => (left.resolved?.name ?? "").localeCompare(right.resolved?.name ?? "")
+    );
+  }
+  return context.options.excludeDeprecated ? entries.filter(({ resolved }) => !isDeprecatedParameter(resolved)) : entries;
+}
+function parameterName(name) {
+  return typeof name === "string" || typeof name === "number" ? propertyName.toPropertyName(name) : { kind: "string", value: String(name) };
+}
+function referencedParameterType(ref, resolved) {
+  const isParameter = !resolved.$ref;
+  const parameter = isParameter ? { in: resolved.in, name: resolved.name } : null;
+  return refType.refType(ref, { parameter });
+}
+function entryType({ original, resolved }, location, context) {
+  const path = jsonPointer.createRef([location.path, "parameters", resolved.in, resolved.name]);
+  return "$ref" in original ? referencedParameterType(original.$ref, resolved) : parameter.parameterType(resolved, { ...location, path }, context);
+}
+function parameterMember(entry, location, context) {
+  const { resolved } = entry;
+  const property = constructors.irProperty(parameterName(resolved.name), entryType(entry, location, context), {
+    isOptional: resolved.in !== "path" && !resolved.required,
+    isReadonly: context.options.immutable
+  });
+  return schemaComment.withSchemaComment(property, resolved);
+}
+function querystringMember(entries, location, context) {
+  const querystring = entries.find(
+    (entry) => entry.resolved?.in === parameterObject.QUERYSTRING_LOCATION
+  );
+  if (!querystring || entries.some((entry) => entry.resolved?.in === "query")) {
+    return null;
+  }
+  const property = constructors.irProperty(propertyName.toPropertyName("query"), entryType(querystring, location, context), {
+    isOptional: !querystring.resolved.required,
+    isReadonly: context.options.immutable
+  });
+  return schemaComment.withSchemaComment(property, querystring.resolved);
+}
+function locationMember(parameterIn, entries, location, context) {
+  const members = entries.filter((entry) => entry.resolved?.in === parameterIn).map((entry) => parameterMember(entry, location, context));
+  return constructors.irProperty(
+    propertyName.toPropertyName(parameterIn),
+    members.length > 0 ? constructors.irObject(members) : constructors.irKeyword("never"),
+    {
+      isOptional: members.every((member) => member.isOptional),
+      isReadonly: context.options.immutable
+    }
+  );
+}
+function parametersMember(parameters, location, context) {
+  const entries = parameterEntries(
+    withPathTemplateParameters(parameters, location, context),
+    context
+  );
+  const querystring = querystringMember(entries, location, context);
+  const members = parameterObject.PARAMETER_LOCATIONS.map(
+    (parameterIn) => parameterIn === "query" && querystring ? querystring : locationMember(parameterIn, entries, location, context)
+  );
+  return constructors.irProperty(propertyName.toPropertyName("parameters"), constructors.irObject(members), {
+    isReadonly: context.options.immutable
+  });
+}
+
+exports.parametersMember = parametersMember;
+//# sourceMappingURL=parameters.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parameters.cjs","sources":["../../../../src/application/transform/document/parameters.ts"],"sourcesContent":["import { irKeyword, irObject, irProperty } from \"../../../domain/ir/constructors.js\";\nimport type { IrPropertyName, 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  PARAMETER_LOCATIONS,\n  type ParameterLocation,\n  type ParameterObject,\n  type ParameterOrReference,\n  QUERYSTRING_LOCATION,\n} from \"../../../domain/openapi/parameter-object.js\";\nimport type { SchemaObject } from \"../../../domain/openapi/schema-object.js\";\nimport { refType } from \"../ref-type.js\";\nimport type { SchemaLocation } from \"../schema/schema-context.js\";\nimport { withSchemaComment } from \"../schema-comment.js\";\nimport type { TransformContext } from \"../transform-context.js\";\nimport { parameterType } from \"./parameter.js\";\n\nconst PATH_TEMPLATE_RE = /\\{([^}]+)\\}/g;\n\n/** A parameter as written in the document, and the object its `$ref` points to. */\ninterface ParameterEntry {\n  readonly original: ParameterOrReference;\n  readonly resolved: ParameterObject | undefined;\n}\n\n/** An entry whose `$ref` resolved, so its location and name are known. */\ntype ResolvedEntry = ParameterEntry & { readonly resolved: ParameterObject };\n\nfunction resolveParameter(\n  parameter: ParameterOrReference,\n  context: TransformContext,\n): ParameterObject | undefined {\n  return \"$ref\" in parameter\n    ? (context.refs.resolve(parameter.$ref) as ParameterObject | undefined)\n    : parameter;\n}\n\n/** Required string parameters for every `{name}` in a path template. */\nfunction pathTemplateParameters(path: string): ParameterObject[] {\n  return (path.match(PATH_TEMPLATE_RE) ?? []).map((match) => ({\n    name: match.slice(1, -1),\n    in: \"path\",\n    required: true,\n    schema: { type: \"string\" },\n  }));\n}\n\n/** `--generate-path-params`: add the path template parameters the list does not define. */\nfunction withPathTemplateParameters(\n  parameters: readonly ParameterOrReference[],\n  location: SchemaLocation,\n  context: TransformContext,\n): ParameterOrReference[] {\n  const result = [...parameters];\n  if (!context.options.generatePathParams || !location.path) {\n    return result;\n  }\n  for (const parameter of pathTemplateParameters(location.path)) {\n    const isDefined = result.some((candidate) => {\n      const resolved = resolveParameter(candidate, context);\n      return resolved?.in === \"path\" && resolved.name === parameter.name;\n    });\n    if (!isDefined) {\n      result.push(parameter);\n    }\n  }\n  return result;\n}\n\nfunction isDeprecatedParameter(parameter: ParameterObject | undefined): boolean {\n  const schema = parameter?.schema as SchemaObject | undefined;\n  return Boolean(parameter?.deprecated || schema?.deprecated);\n}\n\n/** Resolved parameters, sorted for `--alphabetize`, without deprecated ones if excluded. */\nfunction parameterEntries(\n  parameters: readonly ParameterOrReference[],\n  context: TransformContext,\n): ParameterEntry[] {\n  const entries = parameters.map((original) => ({\n    original,\n    resolved: resolveParameter(original, context),\n  }));\n  if (context.options.alphabetize) {\n    // Unlike map keys, the original sorts parameters with the default locale's `localeCompare`.\n    entries.sort((left, right) =>\n      (left.resolved?.name ?? \"\").localeCompare(right.resolved?.name ?? \"\"),\n    );\n  }\n  return context.options.excludeDeprecated\n    ? entries.filter(({ resolved }) => !isDeprecatedParameter(resolved))\n    : entries;\n}\n\n/** The original quotes a name that is not text (a missing name prints as `\"undefined\"`). */\nfunction parameterName(name: unknown): IrPropertyName {\n  return typeof name === \"string\" || typeof name === \"number\"\n    ? toPropertyName(name)\n    : { kind: \"string\", value: String(name) };\n}\n\nfunction referencedParameterType(ref: string, resolved: ParameterObject): IrType {\n  // A `$ref` that resolves to another `$ref` is not a parameter object yet: index it as a path.\n  const isParameter = !(resolved as { $ref?: unknown }).$ref;\n  const parameter = isParameter ? { in: resolved.in, name: resolved.name } : null;\n  return refType(ref, { parameter });\n}\n\nfunction entryType(\n  { original, resolved }: ResolvedEntry,\n  location: SchemaLocation,\n  context: TransformContext,\n): IrType {\n  const path = createRef([location.path, \"parameters\", resolved.in, resolved.name]);\n  return \"$ref\" in original\n    ? referencedParameterType(original.$ref, resolved)\n    : parameterType(resolved, { ...location, path }, context);\n}\n\nfunction parameterMember(\n  entry: ResolvedEntry,\n  location: SchemaLocation,\n  context: TransformContext,\n): IrPropertySignature {\n  const { resolved } = entry;\n  const property = irProperty(parameterName(resolved.name), entryType(entry, location, context), {\n    isOptional: resolved.in !== \"path\" && !resolved.required,\n    isReadonly: context.options.immutable,\n  });\n  return withSchemaComment(property, resolved);\n}\n\n/**\n * The `query` member typed by an `in: querystring` parameter (OpenAPI 3.2, ADR-020): the parameter\n * is the whole query string. Null when there is none, or when `in: query` parameters sit next to\n * it, which 3.2 does not allow; those keep their types, and a warning names the parameter.\n */\nfunction querystringMember(\n  entries: readonly ParameterEntry[],\n  location: SchemaLocation,\n  context: TransformContext,\n): IrPropertySignature | null {\n  const querystring = entries.find(\n    (entry): entry is ResolvedEntry => entry.resolved?.in === QUERYSTRING_LOCATION,\n  );\n  if (!querystring || entries.some((entry) => entry.resolved?.in === \"query\")) {\n    return null;\n  }\n  const property = irProperty(toPropertyName(\"query\"), entryType(querystring, location, context), {\n    isOptional: !querystring.resolved.required,\n    isReadonly: context.options.immutable,\n  });\n  return withSchemaComment(property, querystring.resolved);\n}\n\n/** One location's parameters; optional when all of them are, and `never` when there are none. */\nfunction locationMember(\n  parameterIn: ParameterLocation,\n  entries: readonly ParameterEntry[],\n  location: SchemaLocation,\n  context: TransformContext,\n): IrPropertySignature {\n  const members = entries\n    .filter((entry): entry is ResolvedEntry => entry.resolved?.in === parameterIn)\n    .map((entry) => parameterMember(entry, location, context));\n  return irProperty(\n    toPropertyName(parameterIn),\n    members.length > 0 ? irObject(members) : irKeyword(\"never\"),\n    {\n      isOptional: members.every((member) => member.isOptional),\n      isReadonly: context.options.immutable,\n    },\n  );\n}\n\n/**\n * The `parameters` property of an operation or path item: one member per location, each an object\n * of that location's parameters. `location.path` is the path template for\n * `--generate-path-params`.\n */\nexport function parametersMember(\n  parameters: readonly ParameterOrReference[],\n  location: SchemaLocation,\n  context: TransformContext,\n): IrPropertySignature {\n  const entries = parameterEntries(\n    withPathTemplateParameters(parameters, location, context),\n    context,\n  );\n  const querystring = querystringMember(entries, location, context);\n  const members = PARAMETER_LOCATIONS.map((parameterIn) =>\n    parameterIn === \"query\" && querystring\n      ? querystring\n      : locationMember(parameterIn, entries, location, context),\n  );\n  return irProperty(toPropertyName(\"parameters\"), irObject(members), {\n    isReadonly: context.options.immutable,\n  });\n}\n"],"names":["toPropertyName","refType","createRef","parameterType","irProperty","withSchemaComment","QUERYSTRING_LOCATION","irObject","irKeyword","PARAMETER_LOCATIONS"],"mappings":"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"}

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

@@ -0,0 +1,112 @@
+import { irProperty, irObject, irKeyword } from '../../../domain/ir/constructors.mjs';
+import { toPropertyName } from '../../../domain/ir/property-name.mjs';
+import { createRef } from '../../../domain/openapi/json-pointer.mjs';
+import { PARAMETER_LOCATIONS, QUERYSTRING_LOCATION } from '../../../domain/openapi/parameter-object.mjs';
+import { refType } from '../ref-type.mjs';
+import { withSchemaComment } from '../schema-comment.mjs';
+import { parameterType } from './parameter.mjs';
+
+const PATH_TEMPLATE_RE = /\{([^}]+)\}/g;
+function resolveParameter(parameter, context) {
+  return "$ref" in parameter ? context.refs.resolve(parameter.$ref) : parameter;
+}
+function pathTemplateParameters(path) {
+  return (path.match(PATH_TEMPLATE_RE) ?? []).map((match) => ({
+    name: match.slice(1, -1),
+    in: "path",
+    required: true,
+    schema: { type: "string" }
+  }));
+}
+function withPathTemplateParameters(parameters, location, context) {
+  const result = [...parameters];
+  if (!context.options.generatePathParams || !location.path) {
+    return result;
+  }
+  for (const parameter of pathTemplateParameters(location.path)) {
+    const isDefined = result.some((candidate) => {
+      const resolved = resolveParameter(candidate, context);
+      return resolved?.in === "path" && resolved.name === parameter.name;
+    });
+    if (!isDefined) {
+      result.push(parameter);
+    }
+  }
+  return result;
+}
+function isDeprecatedParameter(parameter) {
+  const schema = parameter?.schema;
+  return Boolean(parameter?.deprecated || schema?.deprecated);
+}
+function parameterEntries(parameters, context) {
+  const entries = parameters.map((original) => ({
+    original,
+    resolved: resolveParameter(original, context)
+  }));
+  if (context.options.alphabetize) {
+    entries.sort(
+      (left, right) => (left.resolved?.name ?? "").localeCompare(right.resolved?.name ?? "")
+    );
+  }
+  return context.options.excludeDeprecated ? entries.filter(({ resolved }) => !isDeprecatedParameter(resolved)) : entries;
+}
+function parameterName(name) {
+  return typeof name === "string" || typeof name === "number" ? toPropertyName(name) : { kind: "string", value: String(name) };
+}
+function referencedParameterType(ref, resolved) {
+  const isParameter = !resolved.$ref;
+  const parameter = isParameter ? { in: resolved.in, name: resolved.name } : null;
+  return refType(ref, { parameter });
+}
+function entryType({ original, resolved }, location, context) {
+  const path = createRef([location.path, "parameters", resolved.in, resolved.name]);
+  return "$ref" in original ? referencedParameterType(original.$ref, resolved) : parameterType(resolved, { ...location, path }, context);
+}
+function parameterMember(entry, location, context) {
+  const { resolved } = entry;
+  const property = irProperty(parameterName(resolved.name), entryType(entry, location, context), {
+    isOptional: resolved.in !== "path" && !resolved.required,
+    isReadonly: context.options.immutable
+  });
+  return withSchemaComment(property, resolved);
+}
+function querystringMember(entries, location, context) {
+  const querystring = entries.find(
+    (entry) => entry.resolved?.in === QUERYSTRING_LOCATION
+  );
+  if (!querystring || entries.some((entry) => entry.resolved?.in === "query")) {
+    return null;
+  }
+  const property = irProperty(toPropertyName("query"), entryType(querystring, location, context), {
+    isOptional: !querystring.resolved.required,
+    isReadonly: context.options.immutable
+  });
+  return withSchemaComment(property, querystring.resolved);
+}
+function locationMember(parameterIn, entries, location, context) {
+  const members = entries.filter((entry) => entry.resolved?.in === parameterIn).map((entry) => parameterMember(entry, location, context));
+  return irProperty(
+    toPropertyName(parameterIn),
+    members.length > 0 ? irObject(members) : irKeyword("never"),
+    {
+      isOptional: members.every((member) => member.isOptional),
+      isReadonly: context.options.immutable
+    }
+  );
+}
+function parametersMember(parameters, location, context) {
+  const entries = parameterEntries(
+    withPathTemplateParameters(parameters, location, context),
+    context
+  );
+  const querystring = querystringMember(entries, location, context);
+  const members = PARAMETER_LOCATIONS.map(
+    (parameterIn) => parameterIn === "query" && querystring ? querystring : locationMember(parameterIn, entries, location, context)
+  );
+  return irProperty(toPropertyName("parameters"), irObject(members), {
+    isReadonly: context.options.immutable
+  });
+}
+
+export { parametersMember };
+//# sourceMappingURL=parameters.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parameters.mjs","sources":["../../../../src/application/transform/document/parameters.ts"],"sourcesContent":["import { irKeyword, irObject, irProperty } from \"../../../domain/ir/constructors.js\";\nimport type { IrPropertyName, 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  PARAMETER_LOCATIONS,\n  type ParameterLocation,\n  type ParameterObject,\n  type ParameterOrReference,\n  QUERYSTRING_LOCATION,\n} from \"../../../domain/openapi/parameter-object.js\";\nimport type { SchemaObject } from \"../../../domain/openapi/schema-object.js\";\nimport { refType } from \"../ref-type.js\";\nimport type { SchemaLocation } from \"../schema/schema-context.js\";\nimport { withSchemaComment } from \"../schema-comment.js\";\nimport type { TransformContext } from \"../transform-context.js\";\nimport { parameterType } from \"./parameter.js\";\n\nconst PATH_TEMPLATE_RE = /\\{([^}]+)\\}/g;\n\n/** A parameter as written in the document, and the object its `$ref` points to. */\ninterface ParameterEntry {\n  readonly original: ParameterOrReference;\n  readonly resolved: ParameterObject | undefined;\n}\n\n/** An entry whose `$ref` resolved, so its location and name are known. */\ntype ResolvedEntry = ParameterEntry & { readonly resolved: ParameterObject };\n\nfunction resolveParameter(\n  parameter: ParameterOrReference,\n  context: TransformContext,\n): ParameterObject | undefined {\n  return \"$ref\" in parameter\n    ? (context.refs.resolve(parameter.$ref) as ParameterObject | undefined)\n    : parameter;\n}\n\n/** Required string parameters for every `{name}` in a path template. */\nfunction pathTemplateParameters(path: string): ParameterObject[] {\n  return (path.match(PATH_TEMPLATE_RE) ?? []).map((match) => ({\n    name: match.slice(1, -1),\n    in: \"path\",\n    required: true,\n    schema: { type: \"string\" },\n  }));\n}\n\n/** `--generate-path-params`: add the path template parameters the list does not define. */\nfunction withPathTemplateParameters(\n  parameters: readonly ParameterOrReference[],\n  location: SchemaLocation,\n  context: TransformContext,\n): ParameterOrReference[] {\n  const result = [...parameters];\n  if (!context.options.generatePathParams || !location.path) {\n    return result;\n  }\n  for (const parameter of pathTemplateParameters(location.path)) {\n    const isDefined = result.some((candidate) => {\n      const resolved = resolveParameter(candidate, context);\n      return resolved?.in === \"path\" && resolved.name === parameter.name;\n    });\n    if (!isDefined) {\n      result.push(parameter);\n    }\n  }\n  return result;\n}\n\nfunction isDeprecatedParameter(parameter: ParameterObject | undefined): boolean {\n  const schema = parameter?.schema as SchemaObject | undefined;\n  return Boolean(parameter?.deprecated || schema?.deprecated);\n}\n\n/** Resolved parameters, sorted for `--alphabetize`, without deprecated ones if excluded. */\nfunction parameterEntries(\n  parameters: readonly ParameterOrReference[],\n  context: TransformContext,\n): ParameterEntry[] {\n  const entries = parameters.map((original) => ({\n    original,\n    resolved: resolveParameter(original, context),\n  }));\n  if (context.options.alphabetize) {\n    // Unlike map keys, the original sorts parameters with the default locale's `localeCompare`.\n    entries.sort((left, right) =>\n      (left.resolved?.name ?? \"\").localeCompare(right.resolved?.name ?? \"\"),\n    );\n  }\n  return context.options.excludeDeprecated\n    ? entries.filter(({ resolved }) => !isDeprecatedParameter(resolved))\n    : entries;\n}\n\n/** The original quotes a name that is not text (a missing name prints as `\"undefined\"`). */\nfunction parameterName(name: unknown): IrPropertyName {\n  return typeof name === \"string\" || typeof name === \"number\"\n    ? toPropertyName(name)\n    : { kind: \"string\", value: String(name) };\n}\n\nfunction referencedParameterType(ref: string, resolved: ParameterObject): IrType {\n  // A `$ref` that resolves to another `$ref` is not a parameter object yet: index it as a path.\n  const isParameter = !(resolved as { $ref?: unknown }).$ref;\n  const parameter = isParameter ? { in: resolved.in, name: resolved.name } : null;\n  return refType(ref, { parameter });\n}\n\nfunction entryType(\n  { original, resolved }: ResolvedEntry,\n  location: SchemaLocation,\n  context: TransformContext,\n): IrType {\n  const path = createRef([location.path, \"parameters\", resolved.in, resolved.name]);\n  return \"$ref\" in original\n    ? referencedParameterType(original.$ref, resolved)\n    : parameterType(resolved, { ...location, path }, context);\n}\n\nfunction parameterMember(\n  entry: ResolvedEntry,\n  location: SchemaLocation,\n  context: TransformContext,\n): IrPropertySignature {\n  const { resolved } = entry;\n  const property = irProperty(parameterName(resolved.name), entryType(entry, location, context), {\n    isOptional: resolved.in !== \"path\" && !resolved.required,\n    isReadonly: context.options.immutable,\n  });\n  return withSchemaComment(property, resolved);\n}\n\n/**\n * The `query` member typed by an `in: querystring` parameter (OpenAPI 3.2, ADR-020): the parameter\n * is the whole query string. Null when there is none, or when `in: query` parameters sit next to\n * it, which 3.2 does not allow; those keep their types, and a warning names the parameter.\n */\nfunction querystringMember(\n  entries: readonly ParameterEntry[],\n  location: SchemaLocation,\n  context: TransformContext,\n): IrPropertySignature | null {\n  const querystring = entries.find(\n    (entry): entry is ResolvedEntry => entry.resolved?.in === QUERYSTRING_LOCATION,\n  );\n  if (!querystring || entries.some((entry) => entry.resolved?.in === \"query\")) {\n    return null;\n  }\n  const property = irProperty(toPropertyName(\"query\"), entryType(querystring, location, context), {\n    isOptional: !querystring.resolved.required,\n    isReadonly: context.options.immutable,\n  });\n  return withSchemaComment(property, querystring.resolved);\n}\n\n/** One location's parameters; optional when all of them are, and `never` when there are none. */\nfunction locationMember(\n  parameterIn: ParameterLocation,\n  entries: readonly ParameterEntry[],\n  location: SchemaLocation,\n  context: TransformContext,\n): IrPropertySignature {\n  const members = entries\n    .filter((entry): entry is ResolvedEntry => entry.resolved?.in === parameterIn)\n    .map((entry) => parameterMember(entry, location, context));\n  return irProperty(\n    toPropertyName(parameterIn),\n    members.length > 0 ? irObject(members) : irKeyword(\"never\"),\n    {\n      isOptional: members.every((member) => member.isOptional),\n      isReadonly: context.options.immutable,\n    },\n  );\n}\n\n/**\n * The `parameters` property of an operation or path item: one member per location, each an object\n * of that location's parameters. `location.path` is the path template for\n * `--generate-path-params`.\n */\nexport function parametersMember(\n  parameters: readonly ParameterOrReference[],\n  location: SchemaLocation,\n  context: TransformContext,\n): IrPropertySignature {\n  const entries = parameterEntries(\n    withPathTemplateParameters(parameters, location, context),\n    context,\n  );\n  const querystring = querystringMember(entries, location, context);\n  const members = PARAMETER_LOCATIONS.map((parameterIn) =>\n    parameterIn === \"query\" && querystring\n      ? querystring\n      : locationMember(parameterIn, entries, location, context),\n  );\n  return irProperty(toPropertyName(\"parameters\"), irObject(members), {\n    isReadonly: context.options.immutable,\n  });\n}\n"],"names":[],"mappings":"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"}

package/dist/application/transform/document/path-item-conflicts.cjs

@@ -0,0 +1,51 @@
+'use strict';
+
+function nameOf(member) {
+  return member.name.kind === "string" ? member.name.value : member.name.text;
+}
+function presenceOf(member) {
+  if (member === void 0) {
+    return "absent";
+  }
+  if (member.type.kind === "keyword" && member.type.keyword === "never") {
+    return member.isOptional ? "never" : "unknown";
+  }
+  return member.isOptional ? "optional" : "required";
+}
+function propertiesOf(type) {
+  if (type.kind !== "object") {
+    return null;
+  }
+  const properties = type.members.filter((member) => {
+    return member.kind === "property";
+  });
+  return new Map(properties.map((property) => [nameOf(property), property]));
+}
+function isPresenceRejected(covering, covered) {
+  if (covered === "unknown") {
+    return false;
+  }
+  if (covering === "required") {
+    return covered !== "required";
+  }
+  return covering === "never" && (covered === "optional" || covered === "required");
+}
+function isPropertyRejected(covering, covered) {
+  if (isPresenceRejected(presenceOf(covering), presenceOf(covered))) {
+    return true;
+  }
+  return covered !== void 0 && isCoveredPathItemRejected(covered.type, covering.type);
+}
+function isCoveredPathItemRejected(covered, covering) {
+  const coveredProperties = propertiesOf(covered);
+  const coveringProperties = propertiesOf(covering);
+  if (coveredProperties === null || coveringProperties === null) {
+    return false;
+  }
+  return [...coveringProperties].some(
+    ([name, property]) => isPropertyRejected(property, coveredProperties.get(name))
+  );
+}
+
+exports.isCoveredPathItemRejected = isCoveredPathItemRejected;
+//# sourceMappingURL=path-item-conflicts.cjs.map

package/dist/application/transform/document/path-item-conflicts.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-item-conflicts.cjs","sources":["../../../../src/application/transform/document/path-item-conflicts.ts"],"sourcesContent":["import type { IrMember, IrPropertySignature, IrType } from \"../../../domain/ir/nodes.js\";\n\n/**\n * Whether TypeScript surely rejects a covered path item for the index signature that covers it\n * (roadmap R10.2). The original output compiles when every covered type is assignable to the\n * signature's type, and that output must stay the same, so a signature is only moved when this\n * check proves the error. It compares object types property by property, as the checker does: a\n * property the signature needs and the covered type may lack, or a value where the signature has\n * the `?: never` of an empty slot (a missing method, an empty parameter location), proves it. Two\n * object properties are compared the same way, inside. Any other pair of types (references,\n * unions, keywords) decides nothing, and that output is left as it was.\n */\n\n/**\n * How a property is written. `never` is the `?: never` of an empty slot; a required `never`\n * (assignable to every type) is `unknown` and decides nothing.\n */\ntype Presence = \"absent\" | \"never\" | \"optional\" | \"required\" | \"unknown\";\n\nfunction nameOf(member: IrPropertySignature): string {\n  return member.name.kind === \"string\" ? member.name.value : member.name.text;\n}\n\nfunction presenceOf(member: IrPropertySignature | undefined): Presence {\n  if (member === undefined) {\n    return \"absent\";\n  }\n  if (member.type.kind === \"keyword\" && member.type.keyword === \"never\") {\n    return member.isOptional ? \"never\" : \"unknown\";\n  }\n  return member.isOptional ? \"optional\" : \"required\";\n}\n\nfunction propertiesOf(type: IrType): ReadonlyMap<string, IrPropertySignature> | null {\n  if (type.kind !== \"object\") {\n    return null;\n  }\n  const properties = type.members.filter((member: IrMember): member is IrPropertySignature => {\n    return member.kind === \"property\";\n  });\n  return new Map(properties.map((property) => [nameOf(property), property]));\n}\n\n/**\n * Whether the covered property's presence fails the signature's: a required value it may lack, or\n * a value where the signature has `never` (an object is not `undefined`).\n */\nfunction isPresenceRejected(covering: Presence, covered: Presence): boolean {\n  if (covered === \"unknown\") {\n    return false;\n  }\n  if (covering === \"required\") {\n    return covered !== \"required\";\n  }\n  return covering === \"never\" && (covered === \"optional\" || covered === \"required\");\n}\n\nfunction isPropertyRejected(\n  covering: IrPropertySignature,\n  covered: IrPropertySignature | undefined,\n): boolean {\n  if (isPresenceRejected(presenceOf(covering), presenceOf(covered))) {\n    return true;\n  }\n  // A `never` is not an object type, so a slot that is empty on either side decides nothing here.\n  return covered !== undefined && isCoveredPathItemRejected(covered.type, covering.type);\n}\n\n/** Whether the covered type is surely not assignable to the covering signature's type. */\nexport function isCoveredPathItemRejected(covered: IrType, covering: IrType): boolean {\n  const coveredProperties = propertiesOf(covered);\n  const coveringProperties = propertiesOf(covering);\n  if (coveredProperties === null || coveringProperties === null) {\n    return false;\n  }\n  return [...coveringProperties].some(([name, property]) =>\n    isPropertyRejected(property, coveredProperties.get(name)),\n  );\n}\n"],"names":[],"mappings":";;AAmBA,SAAS,OAAO,MAAA,EAAqC;AACnD,EAAA,OAAO,MAAA,CAAO,KAAK,IAAA,KAAS,QAAA,GAAW,OAAO,IAAA,CAAK,KAAA,GAAQ,OAAO,IAAA,CAAK,IAAA;AACzE;AAEA,SAAS,WAAW,MAAA,EAAmD;AACrE,EAAA,IAAI,WAAW,MAAA,EAAW;AACxB,IAAA,OAAO,QAAA;AAAA,EACT;AACA,EAAA,IAAI,OAAO,IAAA,CAAK,IAAA,KAAS,aAAa,MAAA,CAAO,IAAA,CAAK,YAAY,OAAA,EAAS;AACrE,IAAA,OAAO,MAAA,CAAO,aAAa,OAAA,GAAU,SAAA;AAAA,EACvC;AACA,EAAA,OAAO,MAAA,CAAO,aAAa,UAAA,GAAa,UAAA;AAC1C;AAEA,SAAS,aAAa,IAAA,EAA+D;AACnF,EAAA,IAAI,IAAA,CAAK,SAAS,QAAA,EAAU;AAC1B,IAAA,OAAO,IAAA;AAAA,EACT;AACA,EAAA,MAAM,UAAA,GAAa,IAAA,CAAK,OAAA,CAAQ,MAAA,CAAO,CAAC,MAAA,KAAoD;AAC1F,IAAA,OAAO,OAAO,IAAA,KAAS,UAAA;AAAA,EACzB,CAAC,CAAA;AACD,EAAA,OAAO,IAAI,GAAA,CAAI,UAAA,CAAW,GAAA,CAAI,CAAC,QAAA,KAAa,CAAC,MAAA,CAAO,QAAQ,CAAA,EAAG,QAAQ,CAAC,CAAC,CAAA;AAC3E;AAMA,SAAS,kBAAA,CAAmB,UAAoB,OAAA,EAA4B;AAC1E,EAAA,IAAI,YAAY,SAAA,EAAW;AACzB,IAAA,OAAO,KAAA;AAAA,EACT;AACA,EAAA,IAAI,aAAa,UAAA,EAAY;AAC3B,IAAA,OAAO,OAAA,KAAY,UAAA;AAAA,EACrB;AACA,EAAA,OAAO,QAAA,KAAa,OAAA,KAAY,OAAA,KAAY,UAAA,IAAc,OAAA,KAAY,UAAA,CAAA;AACxE;AAEA,SAAS,kBAAA,CACP,UACA,OAAA,EACS;AACT,EAAA,IAAI,mBAAmB,UAAA,CAAW,QAAQ,GAAG,UAAA,CAAW,OAAO,CAAC,CAAA,EAAG;AACjE,IAAA,OAAO,IAAA;AAAA,EACT;AAEA,EAAA,OAAO,YAAY,MAAA,IAAa,yBAAA,CAA0B,OAAA,CAAQ,IAAA,EAAM,SAAS,IAAI,CAAA;AACvF;AAGO,SAAS,yBAAA,CAA0B,SAAiB,QAAA,EAA2B;AACpF,EAAA,MAAM,iBAAA,GAAoB,aAAa,OAAO,CAAA;AAC9C,EAAA,MAAM,kBAAA,GAAqB,aAAa,QAAQ,CAAA;AAChD,EAAA,IAAI,iBAAA,KAAsB,IAAA,IAAQ,kBAAA,KAAuB,IAAA,EAAM;AAC7D,IAAA,OAAO,KAAA;AAAA,EACT;AACA,EAAA,OAAO,CAAC,GAAG,kBAAkB,CAAA,CAAE,IAAA;AAAA,IAAK,CAAC,CAAC,IAAA,EAAM,QAAQ,CAAA,KAClD,mBAAmB,QAAA,EAAU,iBAAA,CAAkB,GAAA,CAAI,IAAI,CAAC;AAAA,GAC1D;AACF;;"}

package/dist/application/transform/document/path-item-conflicts.mjs

@@ -0,0 +1,49 @@
+function nameOf(member) {
+  return member.name.kind === "string" ? member.name.value : member.name.text;
+}
+function presenceOf(member) {
+  if (member === void 0) {
+    return "absent";
+  }
+  if (member.type.kind === "keyword" && member.type.keyword === "never") {
+    return member.isOptional ? "never" : "unknown";
+  }
+  return member.isOptional ? "optional" : "required";
+}
+function propertiesOf(type) {
+  if (type.kind !== "object") {
+    return null;
+  }
+  const properties = type.members.filter((member) => {
+    return member.kind === "property";
+  });
+  return new Map(properties.map((property) => [nameOf(property), property]));
+}
+function isPresenceRejected(covering, covered) {
+  if (covered === "unknown") {
+    return false;
+  }
+  if (covering === "required") {
+    return covered !== "required";
+  }
+  return covering === "never" && (covered === "optional" || covered === "required");
+}
+function isPropertyRejected(covering, covered) {
+  if (isPresenceRejected(presenceOf(covering), presenceOf(covered))) {
+    return true;
+  }
+  return covered !== void 0 && isCoveredPathItemRejected(covered.type, covering.type);
+}
+function isCoveredPathItemRejected(covered, covering) {
+  const coveredProperties = propertiesOf(covered);
+  const coveringProperties = propertiesOf(covering);
+  if (coveredProperties === null || coveringProperties === null) {
+    return false;
+  }
+  return [...coveringProperties].some(
+    ([name, property]) => isPropertyRejected(property, coveredProperties.get(name))
+  );
+}
+
+export { isCoveredPathItemRejected };
+//# sourceMappingURL=path-item-conflicts.mjs.map

package/dist/application/transform/document/path-item-conflicts.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-item-conflicts.mjs","sources":["../../../../src/application/transform/document/path-item-conflicts.ts"],"sourcesContent":["import type { IrMember, IrPropertySignature, IrType } from \"../../../domain/ir/nodes.js\";\n\n/**\n * Whether TypeScript surely rejects a covered path item for the index signature that covers it\n * (roadmap R10.2). The original output compiles when every covered type is assignable to the\n * signature's type, and that output must stay the same, so a signature is only moved when this\n * check proves the error. It compares object types property by property, as the checker does: a\n * property the signature needs and the covered type may lack, or a value where the signature has\n * the `?: never` of an empty slot (a missing method, an empty parameter location), proves it. Two\n * object properties are compared the same way, inside. Any other pair of types (references,\n * unions, keywords) decides nothing, and that output is left as it was.\n */\n\n/**\n * How a property is written. `never` is the `?: never` of an empty slot; a required `never`\n * (assignable to every type) is `unknown` and decides nothing.\n */\ntype Presence = \"absent\" | \"never\" | \"optional\" | \"required\" | \"unknown\";\n\nfunction nameOf(member: IrPropertySignature): string {\n  return member.name.kind === \"string\" ? member.name.value : member.name.text;\n}\n\nfunction presenceOf(member: IrPropertySignature | undefined): Presence {\n  if (member === undefined) {\n    return \"absent\";\n  }\n  if (member.type.kind === \"keyword\" && member.type.keyword === \"never\") {\n    return member.isOptional ? \"never\" : \"unknown\";\n  }\n  return member.isOptional ? \"optional\" : \"required\";\n}\n\nfunction propertiesOf(type: IrType): ReadonlyMap<string, IrPropertySignature> | null {\n  if (type.kind !== \"object\") {\n    return null;\n  }\n  const properties = type.members.filter((member: IrMember): member is IrPropertySignature => {\n    return member.kind === \"property\";\n  });\n  return new Map(properties.map((property) => [nameOf(property), property]));\n}\n\n/**\n * Whether the covered property's presence fails the signature's: a required value it may lack, or\n * a value where the signature has `never` (an object is not `undefined`).\n */\nfunction isPresenceRejected(covering: Presence, covered: Presence): boolean {\n  if (covered === \"unknown\") {\n    return false;\n  }\n  if (covering === \"required\") {\n    return covered !== \"required\";\n  }\n  return covering === \"never\" && (covered === \"optional\" || covered === \"required\");\n}\n\nfunction isPropertyRejected(\n  covering: IrPropertySignature,\n  covered: IrPropertySignature | undefined,\n): boolean {\n  if (isPresenceRejected(presenceOf(covering), presenceOf(covered))) {\n    return true;\n  }\n  // A `never` is not an object type, so a slot that is empty on either side decides nothing here.\n  return covered !== undefined && isCoveredPathItemRejected(covered.type, covering.type);\n}\n\n/** Whether the covered type is surely not assignable to the covering signature's type. */\nexport function isCoveredPathItemRejected(covered: IrType, covering: IrType): boolean {\n  const coveredProperties = propertiesOf(covered);\n  const coveringProperties = propertiesOf(covering);\n  if (coveredProperties === null || coveringProperties === null) {\n    return false;\n  }\n  return [...coveringProperties].some(([name, property]) =>\n    isPropertyRejected(property, coveredProperties.get(name)),\n  );\n}\n"],"names":[],"mappings":"AAmBA,SAAS,OAAO,MAAA,EAAqC;AACnD,EAAA,OAAO,MAAA,CAAO,KAAK,IAAA,KAAS,QAAA,GAAW,OAAO,IAAA,CAAK,KAAA,GAAQ,OAAO,IAAA,CAAK,IAAA;AACzE;AAEA,SAAS,WAAW,MAAA,EAAmD;AACrE,EAAA,IAAI,WAAW,MAAA,EAAW;AACxB,IAAA,OAAO,QAAA;AAAA,EACT;AACA,EAAA,IAAI,OAAO,IAAA,CAAK,IAAA,KAAS,aAAa,MAAA,CAAO,IAAA,CAAK,YAAY,OAAA,EAAS;AACrE,IAAA,OAAO,MAAA,CAAO,aAAa,OAAA,GAAU,SAAA;AAAA,EACvC;AACA,EAAA,OAAO,MAAA,CAAO,aAAa,UAAA,GAAa,UAAA;AAC1C;AAEA,SAAS,aAAa,IAAA,EAA+D;AACnF,EAAA,IAAI,IAAA,CAAK,SAAS,QAAA,EAAU;AAC1B,IAAA,OAAO,IAAA;AAAA,EACT;AACA,EAAA,MAAM,UAAA,GAAa,IAAA,CAAK,OAAA,CAAQ,MAAA,CAAO,CAAC,MAAA,KAAoD;AAC1F,IAAA,OAAO,OAAO,IAAA,KAAS,UAAA;AAAA,EACzB,CAAC,CAAA;AACD,EAAA,OAAO,IAAI,GAAA,CAAI,UAAA,CAAW,GAAA,CAAI,CAAC,QAAA,KAAa,CAAC,MAAA,CAAO,QAAQ,CAAA,EAAG,QAAQ,CAAC,CAAC,CAAA;AAC3E;AAMA,SAAS,kBAAA,CAAmB,UAAoB,OAAA,EAA4B;AAC1E,EAAA,IAAI,YAAY,SAAA,EAAW;AACzB,IAAA,OAAO,KAAA;AAAA,EACT;AACA,EAAA,IAAI,aAAa,UAAA,EAAY;AAC3B,IAAA,OAAO,OAAA,KAAY,UAAA;AAAA,EACrB;AACA,EAAA,OAAO,QAAA,KAAa,OAAA,KAAY,OAAA,KAAY,UAAA,IAAc,OAAA,KAAY,UAAA,CAAA;AACxE;AAEA,SAAS,kBAAA,CACP,UACA,OAAA,EACS;AACT,EAAA,IAAI,mBAAmB,UAAA,CAAW,QAAQ,GAAG,UAAA,CAAW,OAAO,CAAC,CAAA,EAAG;AACjE,IAAA,OAAO,IAAA;AAAA,EACT;AAEA,EAAA,OAAO,YAAY,MAAA,IAAa,yBAAA,CAA0B,OAAA,CAAQ,IAAA,EAAM,SAAS,IAAI,CAAA;AACvF;AAGO,SAAS,yBAAA,CAA0B,SAAiB,QAAA,EAA2B;AACpF,EAAA,MAAM,iBAAA,GAAoB,aAAa,OAAO,CAAA;AAC9C,EAAA,MAAM,kBAAA,GAAqB,aAAa,QAAQ,CAAA;AAChD,EAAA,IAAI,iBAAA,KAAsB,IAAA,IAAQ,kBAAA,KAAuB,IAAA,EAAM;AAC7D,IAAA,OAAO,KAAA;AAAA,EACT;AACA,EAAA,OAAO,CAAC,GAAG,kBAAkB,CAAA,CAAE,IAAA;AAAA,IAAK,CAAC,CAAC,IAAA,EAAM,QAAQ,CAAA,KAClD,mBAAmB,QAAA,EAAU,iBAAA,CAAkB,GAAA,CAAI,IAAI,CAAC;AAAA,GAC1D;AACF;;"}

package/dist/application/transform/document/path-item.cjs

@@ -0,0 +1,82 @@
+'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 pathItemObject = require('../../../domain/openapi/path-item-object.cjs');
+const documentEntries = require('../document-entries.cjs');
+const refType = require('../ref-type.cjs');
+const documentMember = require('./document-member.cjs');
+const operation = require('./operation.cjs');
+const parameters = require('./parameters.cjs');
+
+const HASH_RE = /#/g;
+function isIncluded(operation, context) {
+  if (!operation) {
+    return false;
+  }
+  const resolved = "$ref" in operation ? context.refs.resolve(operation.$ref) : operation;
+  return !(context.options.excludeDeprecated && resolved?.deprecated);
+}
+function mergedParameters(pathItem, operation, context) {
+  const byKey = /* @__PURE__ */ new Map();
+  for (const parameter of [...pathItem.parameters ?? [], ...operation.parameters ?? []]) {
+    const resolved = "$ref" in parameter ? context.refs.resolve(parameter.$ref) : parameter;
+    byKey.set(`${resolved?.in}-${resolved?.name}`, parameter);
+  }
+  return [...byKey.values()];
+}
+function operationType(pathItem, operation$1, location, context) {
+  const merged = { ...operation$1, parameters: mergedParameters(pathItem, operation$1, context) };
+  if (!operation$1.operationId) {
+    return constructors.irObject(operation.operationMembers(merged, location, context));
+  }
+  const operationId = operation$1.operationId.replace(HASH_RE, "/");
+  context.footer.addOperation(
+    () => constructors.irProperty(propertyName.toPropertyName(operationId), constructors.irObject(operation.operationMembers(merged, location, context)), {
+      isReadonly: context.options.immutable
+    })
+  );
+  return refType.refType(jsonPointer.createRef(["operations", operationId]));
+}
+function operationMember({ name, operation, path }, pathItem, location, context) {
+  const type = "$ref" in operation ? refType.refType(operation.$ref) : operationType(pathItem, operation, { ...location, path }, context);
+  return documentMember.documentMember(name, type, operation, { isReadonly: context.options.immutable });
+}
+function methodMember(method, pathItem, location, context) {
+  const operation = pathItem[method];
+  if (!isIncluded(operation, context)) {
+    const isReadonly = context.options.immutable;
+    return constructors.irProperty(propertyName.toPropertyName(method), constructors.irKeyword("never"), { isOptional: true, isReadonly });
+  }
+  const path = jsonPointer.createRef([location.path, method]);
+  return operationMember({ name: method, operation, path }, pathItem, location, context);
+}
+function additionalOperationsMember(pathItem, location, context) {
+  const entries = documentEntries.documentEntries(pathItem.additionalOperations ?? {}, context.options);
+  const members = entries.filter(([, operation]) => isIncluded(operation, context)).map(([method, operation]) => {
+    const path = jsonPointer.createRef([location.path, pathItemObject.ADDITIONAL_OPERATIONS_KEY, method]);
+    return operationMember({ name: method, operation, path }, pathItem, location, context);
+  });
+  return members.length > 0 ? constructors.irProperty(propertyName.toPropertyName(pathItemObject.ADDITIONAL_OPERATIONS_KEY), constructors.irObject(members), {
+    isReadonly: context.options.immutable
+  }) : null;
+}
+function pathItemType(pathItem, location, context) {
+  const parametersLocation = { ...location, path: jsonPointer.createRef([location.path, "parameters"]) };
+  const members = [
+    parameters.parametersMember(pathItem.parameters ?? [], parametersLocation, context),
+    ...pathItemObject.HTTP_METHODS.map((method) => methodMember(method, pathItem, location, context))
+  ];
+  if (pathItem[pathItemObject.QUERY_METHOD] !== void 0) {
+    members.push(methodMember(pathItemObject.QUERY_METHOD, pathItem, location, context));
+  }
+  const additionalOperations = additionalOperationsMember(pathItem, location, context);
+  if (additionalOperations) {
+    members.push(additionalOperations);
+  }
+  return constructors.irObject(members);
+}
+
+exports.pathItemType = pathItemType;
+//# sourceMappingURL=path-item.cjs.map

package/dist/application/transform/document/path-item.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-item.cjs","sources":["../../../../src/application/transform/document/path-item.ts"],"sourcesContent":["import { irKeyword, irObject, irProperty } from \"../../../domain/ir/constructors.js\";\nimport type { IrMember, IrPropertySignature, IrType } 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 {\n  ParameterObject,\n  ParameterOrReference,\n} from \"../../../domain/openapi/parameter-object.js\";\nimport {\n  ADDITIONAL_OPERATIONS_KEY,\n  HTTP_METHODS,\n  type OperationEntry,\n  type PathItemMethod,\n  type PathItemObject,\n  QUERY_METHOD,\n} from \"../../../domain/openapi/path-item-object.js\";\nimport { documentEntries } from \"../document-entries.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 { operationMembers } from \"./operation.js\";\nimport { parametersMember } from \"./parameters.js\";\n\n/** Redocly reads `#` in an operation ID as a pointer, so it is replaced (upstream issue #1542). */\nconst HASH_RE = /#/g;\n\n/** Whether the method has an operation, not removed by `--exclude-deprecated`. */\nfunction isIncluded(\n  operation: OperationEntry | undefined,\n  context: TransformContext,\n): operation is OperationEntry {\n  if (!operation) {\n    return false;\n  }\n  const resolved =\n    \"$ref\" in operation\n      ? (context.refs.resolve(operation.$ref) as OperationObject | undefined)\n      : operation;\n  return !(context.options.excludeDeprecated && resolved?.deprecated);\n}\n\n/**\n * Path item parameters followed by the operation's, keyed by location and name, so an operation\n * parameter replaces the path item parameter it redefines (upstream issue #1798).\n */\nfunction mergedParameters(\n  pathItem: PathItemObject,\n  operation: OperationObject,\n  context: TransformContext,\n): ParameterOrReference[] {\n  const byKey = new Map<string, ParameterOrReference>();\n  for (const parameter of [...(pathItem.parameters ?? []), ...(operation.parameters ?? [])]) {\n    const resolved =\n      \"$ref\" in parameter\n        ? (context.refs.resolve(parameter.$ref) as ParameterObject | undefined)\n        : parameter;\n    byKey.set(`${resolved?.in}-${resolved?.name}`, parameter);\n  }\n  return [...byKey.values()];\n}\n\n/**\n * An operation with an `operationId` goes into the `operations` interface and is referenced from\n * the path item; others are written inline.\n */\nfunction operationType(\n  pathItem: PathItemObject,\n  operation: OperationObject,\n  location: SchemaLocation,\n  context: TransformContext,\n): IrType {\n  const merged = { ...operation, parameters: mergedParameters(pathItem, operation, context) };\n  if (!operation.operationId) {\n    return irObject(operationMembers(merged, location, context));\n  }\n  const operationId = operation.operationId.replace(HASH_RE, \"/\");\n  context.footer.addOperation(() =>\n    irProperty(toPropertyName(operationId), irObject(operationMembers(merged, location, context)), {\n      isReadonly: context.options.immutable,\n    }),\n  );\n  return refType(createRef([\"operations\", operationId]));\n}\n\n/** An included operation, the member name it gets and its location below the path item. */\ninterface DeclaredOperation {\n  readonly name: string;\n  readonly operation: OperationEntry;\n  readonly path: string;\n}\n\nfunction operationMember(\n  { name, operation, path }: DeclaredOperation,\n  pathItem: PathItemObject,\n  location: SchemaLocation,\n  context: TransformContext,\n): IrPropertySignature {\n  const type =\n    \"$ref\" in operation\n      ? refType(operation.$ref)\n      : operationType(pathItem, operation, { ...location, path }, context);\n  return documentMember(name, type, operation, { isReadonly: context.options.immutable });\n}\n\n/** A method member: the operation, or `?: never` when there is none or it is excluded. */\nfunction methodMember(\n  method: PathItemMethod,\n  pathItem: PathItemObject,\n  location: SchemaLocation,\n  context: TransformContext,\n): IrPropertySignature {\n  const operation = pathItem[method];\n  if (!isIncluded(operation, context)) {\n    const isReadonly = context.options.immutable;\n    return irProperty(toPropertyName(method), irKeyword(\"never\"), { isOptional: true, isReadonly });\n  }\n  const path = createRef([location.path, method]);\n  return operationMember({ name: method, operation, path }, pathItem, location, context);\n}\n\n/**\n * `additionalOperations` (OpenAPI 3.2): the included operations keyed by their exact method name,\n * or null when the path item has none left.\n */\nfunction additionalOperationsMember(\n  pathItem: PathItemObject,\n  location: SchemaLocation,\n  context: TransformContext,\n): IrPropertySignature | null {\n  const entries = documentEntries(pathItem.additionalOperations ?? {}, context.options);\n  const members = entries\n    .filter(([, operation]) => isIncluded(operation, context))\n    .map(([method, operation]) => {\n      const path = createRef([location.path, ADDITIONAL_OPERATIONS_KEY, method]);\n      return operationMember({ name: method, operation, path }, pathItem, location, context);\n    });\n  return members.length > 0\n    ? irProperty(toPropertyName(ADDITIONAL_OPERATIONS_KEY), irObject(members), {\n        isReadonly: context.options.immutable,\n      })\n    : null;\n}\n\n/**\n * A path item (OpenAPI 3.2 §4.8.9): its `parameters`, one member per HTTP method, then `query` and\n * `additionalOperations` when the path item declares them (ADR-020).\n */\nexport function pathItemType(\n  pathItem: PathItemObject,\n  location: SchemaLocation,\n  context: TransformContext,\n): IrType {\n  const parametersLocation = { ...location, path: createRef([location.path, \"parameters\"]) };\n  const members: IrMember[] = [\n    parametersMember(pathItem.parameters ?? [], parametersLocation, context),\n    ...HTTP_METHODS.map((method) => methodMember(method, pathItem, location, context)),\n  ];\n  if (pathItem[QUERY_METHOD] !== undefined) {\n    members.push(methodMember(QUERY_METHOD, pathItem, location, context));\n  }\n  const additionalOperations = additionalOperationsMember(pathItem, location, context);\n  if (additionalOperations) {\n    members.push(additionalOperations);\n  }\n  return irObject(members);\n}\n"],"names":["operation","irObject","operationMembers","irProperty","toPropertyName","refType","createRef","documentMember","irKeyword","documentEntries","ADDITIONAL_OPERATIONS_KEY","parametersMember","HTTP_METHODS","QUERY_METHOD"],"mappings":";;;;;;;;;;;;AA0BA,MAAM,OAAA,GAAU,IAAA;AAGhB,SAAS,UAAA,CACP,WACA,OAAA,EAC6B;AAC7B,EAAA,IAAI,CAAC,SAAA,EAAW;AACd,IAAA,OAAO,KAAA;AAAA,EACT;AACA,EAAA,MAAM,QAAA,GACJ,UAAU,SAAA,GACL,OAAA,CAAQ,KAAK,OAAA,CAAQ,SAAA,CAAU,IAAI,CAAA,GACpC,SAAA;AACN,EAAA,OAAO,EAAE,OAAA,CAAQ,OAAA,CAAQ,iBAAA,IAAqB,QAAA,EAAU,UAAA,CAAA;AAC1D;AAMA,SAAS,gBAAA,CACP,QAAA,EACA,SAAA,EACA,OAAA,EACwB;AACxB,EAAA,MAAM,KAAA,uBAAY,GAAA,EAAkC;AACpD,EAAA,KAAA,MAAW,SAAA,IAAa,CAAC,GAAI,QAAA,CAAS,UAAA,IAAc,EAAC,EAAI,GAAI,SAAA,CAAU,UAAA,IAAc,EAAG,CAAA,EAAG;AACzF,IAAA,MAAM,QAAA,GACJ,UAAU,SAAA,GACL,OAAA,CAAQ,KAAK,OAAA,CAAQ,SAAA,CAAU,IAAI,CAAA,GACpC,SAAA;AACN,IAAA,KAAA,CAAM,GAAA,CAAI,GAAG,QAAA,EAAU,EAAE,IAAI,QAAA,EAAU,IAAI,IAAI,SAAS,CAAA;AAAA,EAC1D;AACA,EAAA,OAAO,CAAC,GAAG,KAAA,CAAM,MAAA,EAAQ,CAAA;AAC3B;AAMA,SAAS,aAAA,CACP,QAAA,EACAA,WAAA,EACA,QAAA,EACA,OAAA,EACQ;AACR,EAAA,MAAM,MAAA,GAAS,EAAE,GAAGA,WAAA,EAAW,YAAY,gBAAA,CAAiB,QAAA,EAAUA,WAAA,EAAW,OAAO,CAAA,EAAE;AAC1F,EAAA,IAAI,CAACA,YAAU,WAAA,EAAa;AAC1B,IAAA,OAAOC,qBAAA,CAASC,0BAAA,CAAiB,MAAA,EAAQ,QAAA,EAAU,OAAO,CAAC,CAAA;AAAA,EAC7D;AACA,EAAA,MAAM,WAAA,GAAcF,WAAA,CAAU,WAAA,CAAY,OAAA,CAAQ,SAAS,GAAG,CAAA;AAC9D,EAAA,OAAA,CAAQ,MAAA,CAAO,YAAA;AAAA,IAAa,MAC1BG,uBAAA,CAAWC,2BAAA,CAAe,WAAW,CAAA,EAAGH,qBAAA,CAASC,0BAAA,CAAiB,MAAA,EAAQ,QAAA,EAAU,OAAO,CAAC,CAAA,EAAG;AAAA,MAC7F,UAAA,EAAY,QAAQ,OAAA,CAAQ;AAAA,KAC7B;AAAA,GACH;AACA,EAAA,OAAOG,gBAAQC,qBAAA,CAAU,CAAC,YAAA,EAAc,WAAW,CAAC,CAAC,CAAA;AACvD;AASA,SAAS,eAAA,CACP,EAAE,IAAA,EAAM,SAAA,EAAW,MAAK,EACxB,QAAA,EACA,UACA,OAAA,EACqB;AACrB,EAAA,MAAM,IAAA,GACJ,MAAA,IAAU,SAAA,GACND,eAAA,CAAQ,UAAU,IAAI,CAAA,GACtB,aAAA,CAAc,QAAA,EAAU,WAAW,EAAE,GAAG,QAAA,EAAU,IAAA,IAAQ,OAAO,CAAA;AACvE,EAAA,OAAOE,6BAAA,CAAe,MAAM,IAAA,EAAM,SAAA,EAAW,EAAE,UAAA,EAAY,OAAA,CAAQ,OAAA,CAAQ,SAAA,EAAW,CAAA;AACxF;AAGA,SAAS,YAAA,CACP,MAAA,EACA,QAAA,EACA,QAAA,EACA,OAAA,EACqB;AACrB,EAAA,MAAM,SAAA,GAAY,SAAS,MAAM,CAAA;AACjC,EAAA,IAAI,CAAC,UAAA,CAAW,SAAA,EAAW,OAAO,CAAA,EAAG;AACnC,IAAA,MAAM,UAAA,GAAa,QAAQ,OAAA,CAAQ,SAAA;AACnC,IAAA,OAAOJ,uBAAA,CAAWC,2BAAA,CAAe,MAAM,CAAA,EAAGI,sBAAA,CAAU,OAAO,CAAA,EAAG,EAAE,UAAA,EAAY,IAAA,EAAM,UAAA,EAAY,CAAA;AAAA,EAChG;AACA,EAAA,MAAM,OAAOF,qBAAA,CAAU,CAAC,QAAA,CAAS,IAAA,EAAM,MAAM,CAAC,CAAA;AAC9C,EAAA,OAAO,eAAA,CAAgB,EAAE,IAAA,EAAM,MAAA,EAAQ,WAAW,IAAA,EAAK,EAAG,QAAA,EAAU,QAAA,EAAU,OAAO,CAAA;AACvF;AAMA,SAAS,0BAAA,CACP,QAAA,EACA,QAAA,EACA,OAAA,EAC4B;AAC5B,EAAA,MAAM,UAAUG,+BAAA,CAAgB,QAAA,CAAS,wBAAwB,EAAC,EAAG,QAAQ,OAAO,CAAA;AACpF,EAAA,MAAM,UAAU,OAAA,CACb,MAAA,CAAO,CAAC,GAAG,SAAS,CAAA,KAAM,UAAA,CAAW,SAAA,EAAW,OAAO,CAAC,CAAA,CACxD,GAAA,CAAI,CAAC,CAAC,MAAA,EAAQ,SAAS,CAAA,KAAM;AAC5B,IAAA,MAAM,OAAOH,qBAAA,CAAU,CAAC,SAAS,IAAA,EAAMI,wCAAA,EAA2B,MAAM,CAAC,CAAA;AACzE,IAAA,OAAO,eAAA,CAAgB,EAAE,IAAA,EAAM,MAAA,EAAQ,WAAW,IAAA,EAAK,EAAG,QAAA,EAAU,QAAA,EAAU,OAAO,CAAA;AAAA,EACvF,CAAC,CAAA;AACH,EAAA,OAAO,OAAA,CAAQ,SAAS,CAAA,GACpBP,uBAAA,CAAWC,4BAAeM,wCAAyB,CAAA,EAAGT,qBAAA,CAAS,OAAO,CAAA,EAAG;AAAA,IACvE,UAAA,EAAY,QAAQ,OAAA,CAAQ;AAAA,GAC7B,CAAA,GACD,IAAA;AACN;AAMO,SAAS,YAAA,CACd,QAAA,EACA,QAAA,EACA,OAAA,EACQ;AACR,EAAA,MAAM,kBAAA,GAAqB,EAAE,GAAG,QAAA,EAAU,IAAA,EAAMK,qBAAA,CAAU,CAAC,QAAA,CAAS,IAAA,EAAM,YAAY,CAAC,CAAA,EAAE;AACzF,EAAA,MAAM,OAAA,GAAsB;AAAA,IAC1BK,4BAAiB,QAAA,CAAS,UAAA,IAAc,EAAC,EAAG,oBAAoB,OAAO,CAAA;AAAA,IACvE,GAAGC,2BAAA,CAAa,GAAA,CAAI,CAAC,MAAA,KAAW,aAAa,MAAA,EAAQ,QAAA,EAAU,QAAA,EAAU,OAAO,CAAC;AAAA,GACnF;AACA,EAAA,IAAI,QAAA,CAASC,2BAAY,CAAA,KAAM,MAAA,EAAW;AACxC,IAAA,OAAA,CAAQ,KAAK,YAAA,CAAaA,2BAAA,EAAc,QAAA,EAAU,QAAA,EAAU,OAAO,CAAC,CAAA;AAAA,EACtE;AACA,EAAA,MAAM,oBAAA,GAAuB,0BAAA,CAA2B,QAAA,EAAU,QAAA,EAAU,OAAO,CAAA;AACnF,EAAA,IAAI,oBAAA,EAAsB;AACxB,IAAA,OAAA,CAAQ,KAAK,oBAAoB,CAAA;AAAA,EACnC;AACA,EAAA,OAAOZ,sBAAS,OAAO,CAAA;AACzB;;"}

package/dist/application/transform/document/path-item.mjs

@@ -0,0 +1,80 @@
+import { irObject, irProperty, irKeyword } from '../../../domain/ir/constructors.mjs';
+import { toPropertyName } from '../../../domain/ir/property-name.mjs';
+import { createRef } from '../../../domain/openapi/json-pointer.mjs';
+import { HTTP_METHODS, QUERY_METHOD, ADDITIONAL_OPERATIONS_KEY } from '../../../domain/openapi/path-item-object.mjs';
+import { documentEntries } from '../document-entries.mjs';
+import { refType } from '../ref-type.mjs';
+import { documentMember } from './document-member.mjs';
+import { operationMembers } from './operation.mjs';
+import { parametersMember } from './parameters.mjs';
+
+const HASH_RE = /#/g;
+function isIncluded(operation, context) {
+  if (!operation) {
+    return false;
+  }
+  const resolved = "$ref" in operation ? context.refs.resolve(operation.$ref) : operation;
+  return !(context.options.excludeDeprecated && resolved?.deprecated);
+}
+function mergedParameters(pathItem, operation, context) {
+  const byKey = /* @__PURE__ */ new Map();
+  for (const parameter of [...pathItem.parameters ?? [], ...operation.parameters ?? []]) {
+    const resolved = "$ref" in parameter ? context.refs.resolve(parameter.$ref) : parameter;
+    byKey.set(`${resolved?.in}-${resolved?.name}`, parameter);
+  }
+  return [...byKey.values()];
+}
+function operationType(pathItem, operation, location, context) {
+  const merged = { ...operation, parameters: mergedParameters(pathItem, operation, context) };
+  if (!operation.operationId) {
+    return irObject(operationMembers(merged, location, context));
+  }
+  const operationId = operation.operationId.replace(HASH_RE, "/");
+  context.footer.addOperation(
+    () => irProperty(toPropertyName(operationId), irObject(operationMembers(merged, location, context)), {
+      isReadonly: context.options.immutable
+    })
+  );
+  return refType(createRef(["operations", operationId]));
+}
+function operationMember({ name, operation, path }, pathItem, location, context) {
+  const type = "$ref" in operation ? refType(operation.$ref) : operationType(pathItem, operation, { ...location, path }, context);
+  return documentMember(name, type, operation, { isReadonly: context.options.immutable });
+}
+function methodMember(method, pathItem, location, context) {
+  const operation = pathItem[method];
+  if (!isIncluded(operation, context)) {
+    const isReadonly = context.options.immutable;
+    return irProperty(toPropertyName(method), irKeyword("never"), { isOptional: true, isReadonly });
+  }
+  const path = createRef([location.path, method]);
+  return operationMember({ name: method, operation, path }, pathItem, location, context);
+}
+function additionalOperationsMember(pathItem, location, context) {
+  const entries = documentEntries(pathItem.additionalOperations ?? {}, context.options);
+  const members = entries.filter(([, operation]) => isIncluded(operation, context)).map(([method, operation]) => {
+    const path = createRef([location.path, ADDITIONAL_OPERATIONS_KEY, method]);
+    return operationMember({ name: method, operation, path }, pathItem, location, context);
+  });
+  return members.length > 0 ? irProperty(toPropertyName(ADDITIONAL_OPERATIONS_KEY), irObject(members), {
+    isReadonly: context.options.immutable
+  }) : null;
+}
+function pathItemType(pathItem, location, context) {
+  const parametersLocation = { ...location, path: createRef([location.path, "parameters"]) };
+  const members = [
+    parametersMember(pathItem.parameters ?? [], parametersLocation, context),
+    ...HTTP_METHODS.map((method) => methodMember(method, pathItem, location, context))
+  ];
+  if (pathItem[QUERY_METHOD] !== void 0) {
+    members.push(methodMember(QUERY_METHOD, pathItem, location, context));
+  }
+  const additionalOperations = additionalOperationsMember(pathItem, location, context);
+  if (additionalOperations) {
+    members.push(additionalOperations);
+  }
+  return irObject(members);
+}
+
+export { pathItemType };
+//# sourceMappingURL=path-item.mjs.map

package/dist/application/transform/document/path-item.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-item.mjs","sources":["../../../../src/application/transform/document/path-item.ts"],"sourcesContent":["import { irKeyword, irObject, irProperty } from \"../../../domain/ir/constructors.js\";\nimport type { IrMember, IrPropertySignature, IrType } 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 {\n  ParameterObject,\n  ParameterOrReference,\n} from \"../../../domain/openapi/parameter-object.js\";\nimport {\n  ADDITIONAL_OPERATIONS_KEY,\n  HTTP_METHODS,\n  type OperationEntry,\n  type PathItemMethod,\n  type PathItemObject,\n  QUERY_METHOD,\n} from \"../../../domain/openapi/path-item-object.js\";\nimport { documentEntries } from \"../document-entries.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 { operationMembers } from \"./operation.js\";\nimport { parametersMember } from \"./parameters.js\";\n\n/** Redocly reads `#` in an operation ID as a pointer, so it is replaced (upstream issue #1542). */\nconst HASH_RE = /#/g;\n\n/** Whether the method has an operation, not removed by `--exclude-deprecated`. */\nfunction isIncluded(\n  operation: OperationEntry | undefined,\n  context: TransformContext,\n): operation is OperationEntry {\n  if (!operation) {\n    return false;\n  }\n  const resolved =\n    \"$ref\" in operation\n      ? (context.refs.resolve(operation.$ref) as OperationObject | undefined)\n      : operation;\n  return !(context.options.excludeDeprecated && resolved?.deprecated);\n}\n\n/**\n * Path item parameters followed by the operation's, keyed by location and name, so an operation\n * parameter replaces the path item parameter it redefines (upstream issue #1798).\n */\nfunction mergedParameters(\n  pathItem: PathItemObject,\n  operation: OperationObject,\n  context: TransformContext,\n): ParameterOrReference[] {\n  const byKey = new Map<string, ParameterOrReference>();\n  for (const parameter of [...(pathItem.parameters ?? []), ...(operation.parameters ?? [])]) {\n    const resolved =\n      \"$ref\" in parameter\n        ? (context.refs.resolve(parameter.$ref) as ParameterObject | undefined)\n        : parameter;\n    byKey.set(`${resolved?.in}-${resolved?.name}`, parameter);\n  }\n  return [...byKey.values()];\n}\n\n/**\n * An operation with an `operationId` goes into the `operations` interface and is referenced from\n * the path item; others are written inline.\n */\nfunction operationType(\n  pathItem: PathItemObject,\n  operation: OperationObject,\n  location: SchemaLocation,\n  context: TransformContext,\n): IrType {\n  const merged = { ...operation, parameters: mergedParameters(pathItem, operation, context) };\n  if (!operation.operationId) {\n    return irObject(operationMembers(merged, location, context));\n  }\n  const operationId = operation.operationId.replace(HASH_RE, \"/\");\n  context.footer.addOperation(() =>\n    irProperty(toPropertyName(operationId), irObject(operationMembers(merged, location, context)), {\n      isReadonly: context.options.immutable,\n    }),\n  );\n  return refType(createRef([\"operations\", operationId]));\n}\n\n/** An included operation, the member name it gets and its location below the path item. */\ninterface DeclaredOperation {\n  readonly name: string;\n  readonly operation: OperationEntry;\n  readonly path: string;\n}\n\nfunction operationMember(\n  { name, operation, path }: DeclaredOperation,\n  pathItem: PathItemObject,\n  location: SchemaLocation,\n  context: TransformContext,\n): IrPropertySignature {\n  const type =\n    \"$ref\" in operation\n      ? refType(operation.$ref)\n      : operationType(pathItem, operation, { ...location, path }, context);\n  return documentMember(name, type, operation, { isReadonly: context.options.immutable });\n}\n\n/** A method member: the operation, or `?: never` when there is none or it is excluded. */\nfunction methodMember(\n  method: PathItemMethod,\n  pathItem: PathItemObject,\n  location: SchemaLocation,\n  context: TransformContext,\n): IrPropertySignature {\n  const operation = pathItem[method];\n  if (!isIncluded(operation, context)) {\n    const isReadonly = context.options.immutable;\n    return irProperty(toPropertyName(method), irKeyword(\"never\"), { isOptional: true, isReadonly });\n  }\n  const path = createRef([location.path, method]);\n  return operationMember({ name: method, operation, path }, pathItem, location, context);\n}\n\n/**\n * `additionalOperations` (OpenAPI 3.2): the included operations keyed by their exact method name,\n * or null when the path item has none left.\n */\nfunction additionalOperationsMember(\n  pathItem: PathItemObject,\n  location: SchemaLocation,\n  context: TransformContext,\n): IrPropertySignature | null {\n  const entries = documentEntries(pathItem.additionalOperations ?? {}, context.options);\n  const members = entries\n    .filter(([, operation]) => isIncluded(operation, context))\n    .map(([method, operation]) => {\n      const path = createRef([location.path, ADDITIONAL_OPERATIONS_KEY, method]);\n      return operationMember({ name: method, operation, path }, pathItem, location, context);\n    });\n  return members.length > 0\n    ? irProperty(toPropertyName(ADDITIONAL_OPERATIONS_KEY), irObject(members), {\n        isReadonly: context.options.immutable,\n      })\n    : null;\n}\n\n/**\n * A path item (OpenAPI 3.2 §4.8.9): its `parameters`, one member per HTTP method, then `query` and\n * `additionalOperations` when the path item declares them (ADR-020).\n */\nexport function pathItemType(\n  pathItem: PathItemObject,\n  location: SchemaLocation,\n  context: TransformContext,\n): IrType {\n  const parametersLocation = { ...location, path: createRef([location.path, \"parameters\"]) };\n  const members: IrMember[] = [\n    parametersMember(pathItem.parameters ?? [], parametersLocation, context),\n    ...HTTP_METHODS.map((method) => methodMember(method, pathItem, location, context)),\n  ];\n  if (pathItem[QUERY_METHOD] !== undefined) {\n    members.push(methodMember(QUERY_METHOD, pathItem, location, context));\n  }\n  const additionalOperations = additionalOperationsMember(pathItem, location, context);\n  if (additionalOperations) {\n    members.push(additionalOperations);\n  }\n  return irObject(members);\n}\n"],"names":[],"mappings":"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"}