oas 32.1.11 → 32.1.13

package/dist/chunk-SAB2PGCD.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/erunion/code/readme/oas/packages/oas/dist/chunk-SAB2PGCD.cjs","../src/lib/matches-mimetype.ts","../src/lib/get-parameter-content-type.ts","../src/lib/refs.ts","../src/lib/helpers.ts","../src/lib/clone-object.ts","../src/lib/build-discriminator-one-of.ts","../src/lib/openapi-to-json-schema.ts","../src/operation/transformers/get-parameters-as-json-schema.ts","../src/utils.ts"],"names":["types","converted","schema"],"mappings":"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","file":"/Users/erunion/code/readme/oas/packages/oas/dist/chunk-SAB2PGCD.cjs","sourcesContent":[null,"function matchesMediaType(types: string[], mediaType: string): boolean {\n  return types.some(type => {\n    return mediaType.indexOf(type) > -1;\n  });\n}\n\nexport default {\n  formUrlEncoded: (mimeType: string): boolean => {\n    return matchesMediaType(['application/x-www-form-urlencoded'], mimeType);\n  },\n\n  json: (contentType: string): boolean => {\n    return matchesMediaType(\n      ['application/json', 'application/x-json', 'text/json', 'text/x-json', '+json'],\n      contentType,\n    );\n  },\n\n  multipart: (contentType: string): boolean => {\n    return matchesMediaType(\n      ['multipart/mixed', 'multipart/related', 'multipart/form-data', 'multipart/alternative'],\n      contentType,\n    );\n  },\n\n  wildcard: (contentType: string): boolean => {\n    return contentType === '*/*';\n  },\n\n  xml: (contentType: string): boolean => {\n    return matchesMediaType(\n      [\n        'application/xml',\n        'application/xml-external-parsed-entity',\n        'application/xml-dtd',\n        'text/xml',\n        'text/xml-external-parsed-entity',\n        '+xml',\n      ],\n      contentType,\n    );\n  },\n};\n","import matchesMimetype from './matches-mimetype.js';\n\n/**\n * Selects a content type from an array of content type keys, prioritizing `application/json`\n * and other JSON-like content types over other content types.\n *\n * When multiple content types are present:\n * - If there's exactly one content type, it's returned\n * - If there are multiple content types, JSON-like content types (e.g., `application/json`,\n *   `application/vnd.api+json`) are prioritized\n * - If no JSON-like content types are present, the first content type is returned\n *\n * @param contentKeys - Array of content type keys (e.g., ['application/json', 'application/xml'])\n * @returns The selected content type, or undefined if the array is empty\n */\nexport function getParameterContentType(contentKeys: string[]): string | undefined {\n  if (contentKeys.length === 0) {\n    return undefined;\n  }\n\n  if (contentKeys.length === 1) {\n    return contentKeys[0];\n  }\n\n  // We should always try to prioritize `application/json` over any other possible\n  // content that might be present on this schema.\n  const jsonLikeContentTypes = contentKeys.filter(k => matchesMimetype.json(k));\n  if (jsonLikeContentTypes.length) {\n    return jsonLikeContentTypes[0];\n  }\n\n  return contentKeys[0];\n}\n","import type { OASDocument, SchemaObject } from '../types.js';\nimport type { ParserOptions } from '@readme/openapi-parser';\n\nimport jsonpointer from 'jsonpointer';\n\nimport { isRef } from '../types.js';\n\nimport { isPrimitive } from './helpers.js';\n\n/**\n * Decorate component schemas within the API definition with a `x-readme-ref-name` property so we\n * can retin their original schema names during dereferencing or `$ref` resolution operations.\n *\n */\nexport function decorateComponentSchemasWithRefName(api: OASDocument): void {\n  if (!api?.components?.schemas || typeof api.components.schemas !== 'object') {\n    return;\n  }\n\n  Object.keys(api.components.schemas).forEach(schemaName => {\n    // As of OpenAPI 3.1 component schemas can be primitives or arrays. If this happens then we\n    // shouldn't try to add `x-readme-ref-name` properties because we can't. We'll have some data\n    // loss on these schemas but as they aren't objects they likely won't be used in ways that\n    // would require needing a `title` or `x-readme-ref-name` anyways.\n    if (\n      isPrimitive(api.components?.schemas?.[schemaName]) ||\n      Array.isArray(api.components?.schemas?.[schemaName]) ||\n      api.components?.schemas?.[schemaName] === null\n    ) {\n      return;\n    }\n\n    // oxlint-disable-next-line no-unsafe-optional-chaining\n    (api.components?.schemas?.[schemaName] as SchemaObject)['x-readme-ref-name'] = schemaName;\n  });\n}\n\n/**\n * Encode a string to be used as a JSON pointer.\n *\n * @see {@link https://tools.ietf.org/html/rfc6901}\n * @param str String to encode into string that can be used as a JSON pointer.\n */\nexport function encodePointer(str: string): string {\n  return str.replaceAll('~', '~0').replaceAll('/', '~1');\n}\n\n/**\n * Decode a JSON pointer string.\n *\n * Per RFC 6901, `~0` is unescaped to `~` and `~1` to `/`. A single-pass replacement is required:\n * the sequence `~01` must decode to `~1` (tilde then one), not `~/`. Replacing `~1` before `~0`\n * would incorrectly turn `~01` into `~/`.\n *\n * @see {@link https://tools.ietf.org/html/rfc6901}\n * @param str String to decode a JSON pointer from\n */\nexport function decodePointer(str: string): string {\n  return str.replace(/~([01])/g, (_, digit) => (digit === '0' ? '~' : '/'));\n}\n\n/**\n * Lookup a reference pointer within an a JSON object and return the schema that it resolves to.\n *\n * @param $ref Reference to look up a schema for.\n * @param definition OpenAPI definition to look for the `$ref` pointer in.\n */\nfunction findRef($ref: string, definition: OASDocument | SchemaObject): any {\n  let currRef = $ref.trim();\n  if (currRef === '') {\n    // If this ref is empty, don't bother trying to look for it.\n    return false;\n  }\n\n  if (currRef.startsWith('#')) {\n    // Decode URI fragment representation.\n    currRef = decodeURIComponent(currRef.substring(1));\n  } else {\n    throw new Error(`Could not find a definition for ${$ref}.`);\n  }\n\n  const current = jsonpointer.get(definition, currRef);\n  if (current === undefined) {\n    throw new Error(`Could not find a definition for ${$ref}.`);\n  }\n\n  return current;\n}\n\n/**\n * Dereference a `$ref` pointer if present, otherwise return the value as-is.\n *\n * This function handles `$ref` pointers on-the-fly without requiring full dereferencing and\n * prevents infinite loops by tracking seen `$ref` pointers and not re-processing circular\n * references.\n *\n * @param value The value that may contain a `$ref` pointer.\n * @param definition OpenAPI definition to look for the `$ref` pointer in.\n * @param seenRefs Optional Set to track `$ref` pointers that have already been processed to prevent circular references.\n * @returns The dereferenced value if it was a `$ref`, otherwise the original value. Returns the original `$ref` if it's circular.\n */\nexport function dereferenceRef<T>(\n  value: T,\n  definition?: OASDocument | SchemaObject,\n  seenRefs: Set<string> = new Set<string>(),\n): T {\n  if (value === undefined) {\n    return undefined as T;\n  }\n\n  if (isRef(value)) {\n    if (!definition) {\n      return value as T;\n    }\n\n    const ref = value.$ref;\n\n    // If we've seen this `$ref` before then it's circular and we should return the original `$ref`\n    // to prevent infinite loops\n    if (seenRefs.has(ref)) {\n      return value as T;\n    }\n\n    // Track this `$ref` as having been seen so we can avoid infinitely processing circular\n    // references.\n    seenRefs.add(ref);\n\n    try {\n      const dereferenced = findRef(ref, definition);\n\n      // If the dereferenced value is itself a `$ref` then recursively dereference it (but with\n      // `seenRefs` tracking).\n      if (isRef(dereferenced)) {\n        return dereferenceRef(dereferenced, definition, seenRefs) as T;\n      }\n\n      return {\n        ...dereferenced,\n      } as T;\n    } catch {\n      // If dereferencing fails return the original `$ref`.\n      return value as T;\n    }\n  }\n\n  return value;\n}\n\n/**\n * Recursively resolve `$ref` pointers inside a given schema.\n *\n * Uses the same `seenRefs` logic as `dereferenceRef` for protection against circular references.\n *\n * @see {@link dereferenceRef}\n */\nexport function dereferenceRefDeep<T>(\n  value: T,\n  definition?: OASDocument | SchemaObject,\n  seenRefs: Set<string> = new Set<string>(),\n): T {\n  if (value === null || value === undefined) return value;\n  if (typeof value !== 'object') return value;\n\n  if (isRef(value)) {\n    if (!definition) return value;\n\n    const resolved = dereferenceRef(value, definition, seenRefs);\n    if (isRef(resolved)) return resolved as T;\n\n    return dereferenceRefDeep(resolved, definition, seenRefs) as T;\n  }\n\n  if (Array.isArray(value)) {\n    return value.map(entry => dereferenceRefDeep(entry, definition, seenRefs)) as T;\n  }\n\n  const out: Record<string, unknown> = {};\n  for (const key of Object.keys(value)) {\n    out[key] = dereferenceRefDeep((value as Record<string, unknown>)[key], definition, seenRefs);\n  }\n\n  return out as T;\n}\n\n/**\n * Retrive our dereferencing configuration for `@readme/openapi-parser`.\n *\n */\nexport function getDereferencingOptions(circularRefs: Set<string>): Pick<ParserOptions, 'resolve' | 'dereference'> {\n  return {\n    resolve: {\n      // We shouldn't be resolving external pointers at this point so just ignore them.\n      external: false,\n    },\n    dereference: {\n      // If circular `$refs` are ignored they'll remain in the schema as `$ref: String`, otherwise\n      // `$ref` just won't exist. This, in tandem with `onCircular`, allows us to do easy and\n      // accumulate a list of circular references.\n      circular: 'ignore',\n\n      onCircular: (path: string) => {\n        // The circular references that are coming out of `json-schema-ref-parser` are prefixed\n        // with the schema path (file path, URL, whatever) that the schema exists in. Because we\n        // don't care about this information for this reporting mechanism, and only the `$ref`\n        // pointer, we're removing it.\n        circularRefs.add(`#${path.split('#')[1]}`);\n      },\n    },\n  };\n}\n\n/**\n * Recursively collect all `$ref` pointers in a schema.\n *\n */\nexport function collectRefsInSchema(schema: unknown): Set<string> {\n  const refs = new Set<string>();\n  if (!schema || typeof schema !== 'object') return refs;\n  const obj = schema as Record<string, unknown>;\n  if (isRef(obj)) {\n    refs.add(obj.$ref);\n  }\n\n  for (const value of Object.values(obj)) {\n    if (Array.isArray(value)) {\n      for (const item of value) {\n        for (const r of collectRefsInSchema(item)) refs.add(r);\n      }\n    } else if (value && typeof value === 'object') {\n      for (const r of collectRefsInSchema(value)) refs.add(r);\n    }\n  }\n\n  return refs;\n}\n\n/**\n * Given a set of `$ref` pointers and a full set of schema objects, mapped to their reference\n * locations, return only the schemas that are transitively referenced from those schemas.\n *\n */\nexport function filterRequiredRefsToReferenced(\n  requiredRefs: Set<string>,\n  usedSchemas: Map<string, SchemaObject>,\n): Map<string, SchemaObject> {\n  const referenced = new Set(requiredRefs);\n\n  let prevSize = 0;\n  while (referenced.size > prevSize) {\n    prevSize = referenced.size;\n    for (const ref of referenced) {\n      const schema = usedSchemas.get(ref);\n      if (schema) {\n        for (const r of collectRefsInSchema(schema)) {\n          referenced.add(r);\n        }\n      }\n    }\n  }\n\n  const filtered = new Map<string, SchemaObject>();\n  for (const ref of referenced) {\n    const s = usedSchemas.get(ref);\n    if (s !== undefined) {\n      filtered.set(ref, s);\n    }\n  }\n\n  return filtered;\n}\n\n/**\n * Parse a `$ref` pointers (e.g. `#/x-definitions/MySchema` or `#/components/schemas/Foo`) into\n * path segments. Returns `null` if the first segment is reserved (we should not embed at root\n * under that key).\n *\n */\nfunction getRefPathSegments(ref: string): string[] | null {\n  if (!ref.startsWith('#/')) return null;\n  const path = ref\n    .slice(2)\n    .split('/')\n    .map(seg => {\n      // We need to decode these segments twice because the first decode is to decode encoded JSON\n      // pointer segments, and the second is to decode any URI-encoded segments.\n      return decodeURIComponent(decodePointer(seg));\n    });\n\n  if (path.length < 2) {\n    // We need at least two pieces of a `$ref` for it to be valid. e.g. `#/x-definitions/MySchema`\n    // or `#/components/schemas/Foo`.\n    return null;\n  }\n\n  return path;\n}\n\nfunction isArrayIndexSegment(seg: string): boolean {\n  return /^\\d+$/.test(seg);\n}\n\nfunction childShouldBeSchemaArray(parentKey: string, childSeg: string | undefined): boolean {\n  if (!childSeg || !isArrayIndexSegment(childSeg)) {\n    return false;\n  }\n\n  return parentKey === 'allOf' || parentKey === 'anyOf' || parentKey === 'oneOf';\n}\n\n/**\n * Merge referenced schemas into the root schema at the paths defined by their reference location.\n *\n * @example `#/components/schemas/MySchema` -> `root.components.schemas.MySchema`\n */\nexport function mergeReferencedSchemasIntoRoot(root: SchemaObject, refToSchema: Map<string, unknown>): void {\n  for (const [ref, schema] of refToSchema) {\n    const segments = getRefPathSegments(ref);\n    if (!segments || segments.length === 0) {\n      continue;\n    }\n\n    let current: SchemaObject = root;\n    let pathInvalid = false;\n\n    for (let i = 0; i < segments.length - 1; i++) {\n      const seg = segments[i] as keyof SchemaObject;\n      const nextSeg = segments[i + 1];\n\n      if (Array.isArray(current)) {\n        const idx = Number(seg);\n        if (!Number.isInteger(idx) || idx < 0) {\n          pathInvalid = true;\n          break;\n        }\n\n        const slot: SchemaObject = current[idx];\n        if (slot === undefined || slot === null || typeof slot !== 'object' || Array.isArray(slot)) {\n          const nextObj: SchemaObject = {};\n          current[idx] = nextObj;\n          current = nextObj;\n        } else {\n          current = slot;\n        }\n\n        continue;\n      }\n\n      const cur = current;\n      const existing = cur[seg] as SchemaObject;\n\n      if (childShouldBeSchemaArray(seg, nextSeg)) {\n        if (!Array.isArray(existing)) {\n          cur[seg] = [];\n        }\n\n        current = cur[seg] as unknown[];\n        continue;\n      }\n\n      let next: Record<string, unknown>;\n      if (existing !== undefined && existing !== null && typeof existing === 'object' && !Array.isArray(existing)) {\n        next = existing as Record<string, unknown>;\n      } else {\n        next = {};\n        cur[seg] = next;\n      }\n\n      current = next;\n    }\n\n    if (pathInvalid) {\n      continue;\n    }\n\n    const lastSeg = segments[segments.length - 1] as keyof SchemaObject;\n    if (Array.isArray(current)) {\n      const idx = Number(lastSeg);\n      if (!Number.isInteger(idx) || idx < 0) {\n        continue;\n      }\n\n      current[idx] = schema;\n    } else {\n      current[lastSeg] = schema;\n    }\n  }\n}\n","import type { SchemaObject } from '../types.js';\n\nexport function hasSchemaType(schema: SchemaObject, discriminator: 'array' | 'object'): boolean {\n  if (Array.isArray(schema.type)) {\n    return schema.type.includes(discriminator);\n  }\n\n  return schema.type === discriminator;\n}\n\nexport function isObject(val: unknown): val is Record<string, unknown> {\n  return typeof val === 'object' && val !== null && !Array.isArray(val);\n}\n\nexport function isPrimitive(val: unknown): val is boolean | number | string {\n  return typeof val === 'string' || typeof val === 'number' || typeof val === 'boolean';\n}\n","/**\n * @deprecated Use `structuredClone` instead\n */\nexport function cloneObject<T>(obj: T): T {\n  if (typeof obj === 'undefined') {\n    return undefined as T;\n  }\n\n  // oxlint-disable-next-line readme/json-parse-try-catch\n  return JSON.parse(JSON.stringify(obj));\n}\n","import type { DiscriminatorChildrenMap, DiscriminatorObject, OASDocument, SchemaObject } from '../types.js';\n\nimport { isRef } from '../types.js';\n\nimport { cloneObject } from './clone-object.js';\n\n/**\n * Determines if a schema has a discriminator but is missing oneOf/anyOf polymorphism.\n *\n * @param schema Schema to check.\n * @returns If the schema has a discriminator but no oneOf/anyOf.\n */\nfunction hasDiscriminatorWithoutPolymorphism(schema: SchemaObject): boolean {\n  if (!schema || typeof schema !== 'object') return false;\n  if (!('discriminator' in schema)) return false;\n  if ('oneOf' in schema || 'anyOf' in schema) return false;\n  return true;\n}\n\n/**\n * Checks if a schema's allOf contains a $ref to a specific schema name.\n *\n * @param schema Schema to check.\n * @param targetSchemaName The schema name to look for (e.g., 'Pet').\n * @returns If the schema's allOf contains a $ref to the target schema.\n */\nfunction allOfReferencesSchema(schema: SchemaObject, targetSchemaName: string): boolean {\n  if (!schema || typeof schema !== 'object') return false;\n  if (!('allOf' in schema) || !Array.isArray(schema.allOf)) return false;\n\n  return schema.allOf.some(item => {\n    if (isRef(item)) {\n      // Check if the $ref points to the target schema\n      // Format: #/components/schemas/SchemaName\n      const refParts = item.$ref.split('/');\n      const refSchemaName = refParts[refParts.length - 1];\n      return refSchemaName === targetSchemaName;\n    }\n\n    return false;\n  });\n}\n\n/**\n * Phase 1: Before dereferencing, identify discriminator schemas and their children via allOf\n * inheritance. Returns a mapping that can be used after dereferencing.\n *\n * We don't add oneOf here because that would create circular references\n * (Pet → Cat → Pet via allOf) which would break dereferencing.\n *\n * Note: Schemas defined in mapping but NOT declared using anyOf, allOf or oneOf will not be considered\n * a valid child. The discriminator object is legal only when using one of the composite keywords oneOf, anyOf, allOf.\n * @link https://spec.openapis.org/oas/v3.1.0.html#fixed-fields-20\n *\n * @param api The OpenAPI definition to process (before dereferencing).\n * @returns Maps of discriminator schema names to their child schema names and `$ref` pointers.\n */\nexport function findDiscriminatorChildren(definition: Pick<OASDocument, 'components'>): {\n  children: DiscriminatorChildrenMap;\n  refs: Map<string, string>;\n} {\n  const childrenMap: DiscriminatorChildrenMap = new Map();\n  const childrenRefMap = new Map<string, string>();\n\n  if (!definition?.components?.schemas || typeof definition.components.schemas !== 'object') {\n    return { children: childrenMap, refs: childrenRefMap };\n  }\n\n  const schemas = definition.components.schemas as Record<string, SchemaObject>;\n  const schemaNames = Object.keys(schemas);\n\n  // Find all schemas with discriminator but no oneOf/anyOf\n  const discriminatorSchemas: string[] = schemaNames.filter(name => {\n    return hasDiscriminatorWithoutPolymorphism(schemas[name]);\n  });\n\n  // For each discriminator schema, record child schema names\n  for (const baseName of discriminatorSchemas) {\n    const baseSchema = schemas[baseName] as SchemaObject & { discriminator: DiscriminatorObject };\n    const discriminator = baseSchema.discriminator;\n\n    let childSchemaNames: string[] = [];\n\n    // If there's already a mapping defined, use it but only include schemas that\n    // actually inherit from this parent via allOf. A mapping entry for a schema\n    // that doesn't use allOf is just a value resolution hint, not a declaration\n    // of inheritance.\n    if (discriminator.mapping && typeof discriminator.mapping === 'object') {\n      const mappingRefs = Object.values(discriminator.mapping);\n      if (mappingRefs.length > 0) {\n        childSchemaNames = mappingRefs\n          .map(ref => ref.split('/').pop())\n          .filter((name): name is string => {\n            if (!name) return false;\n            const childSchema = schemas[name];\n            return !!childSchema && allOfReferencesSchema(childSchema, baseName);\n          });\n      }\n    }\n\n    // Otherwise, scan for schemas that extend this base via allOf\n    if (!childSchemaNames.length) {\n      childSchemaNames = schemaNames.filter(name => {\n        if (name === baseName) return false;\n        return allOfReferencesSchema(schemas[name], baseName);\n      });\n    }\n\n    // Store child schema names in the map\n    if (childSchemaNames.length) {\n      for (const childName of childSchemaNames) {\n        childrenRefMap.set(childName, `#/components/schemas/${childName}`);\n      }\n\n      childrenMap.set(baseName, childSchemaNames);\n      childrenRefMap.set(baseName, `#/components/schemas/${baseName}`);\n    }\n  }\n\n  return { children: childrenMap, refs: childrenRefMap };\n}\n\n/**\n * Apply discriminator oneOf to a map of used schemas (e.g. from `getParametersAsJSONSchema` and\n * `getResponseAsJSONSchema`). For each discriminator base in `usedSchemas`, it ensures children\n * are in the map via `getOrAddSchema`, then sets `oneOf` on the base.\n *\n * Optionally this also strips `oneOf` from the base when it appears inside a child's `allOf`\n * schema.\n *\n * @param api The OpenAPI definition (for findDiscriminatorChildren).\n * @param usedSchemas Map of schema name -> JSON Schema to update.\n * @param getOrAddSchema Callback that resolves, converts, and adds a schema by name; returns the converted schema or undefined.\n */\nexport function applyDiscriminatorOneOfToUsedSchemas(\n  definition: Pick<OASDocument, 'components'>,\n  usedSchemas: Map<string, SchemaObject>,\n  getOrAddSchema: (ref: string) => SchemaObject | undefined,\n): void {\n  const { children: childrenMap, refs: childrenRefMap } = findDiscriminatorChildren(definition);\n  if (!childrenMap.size) return;\n\n  // Build oneOf for each discriminator schema\n  for (const [baseName, childNames] of childrenMap) {\n    const baseRef = childrenRefMap.get(baseName);\n    if (!baseRef) continue;\n\n    const baseSchema = usedSchemas.get(baseRef);\n    if (!baseSchema || typeof baseSchema !== 'object') continue;\n\n    // Build `oneOf` from raw child schema `$ref` pointers.\n    const oneOf: SchemaObject[] = [];\n    for (const childName of childNames) {\n      const childRef = childrenRefMap.get(childName);\n      if (!childRef) continue;\n\n      const childSchema = getOrAddSchema(childRef);\n      if (childSchema) {\n        oneOf.push({\n          $ref: childRef,\n        });\n      }\n    }\n\n    if (oneOf.length > 0) {\n      (baseSchema as Record<string, unknown>).oneOf = oneOf;\n    }\n  }\n\n  // Strip `oneOf` from discriminator schemas embedded in child `allOf` structures.\n  //\n  // When `Cat` extends `Pet` via an `allOf` and `Pet` has a `discriminator` with a `oneOf` the\n  // embedded `Pet` inside `Cat`'s `allOf` should NOT have `oneOf` because this would create a\n  // circular `Cat.allOf[0].oneOf[0] = Cat` reference.\n  //\n  // We only strip from `allOf` entries to preserve `oneOf` in direct references.\n  for (const [parentSchemaName, childNames] of childrenMap) {\n    for (const childName of childNames) {\n      const childRef = childrenRefMap.get(childName);\n      if (!childRef) continue;\n\n      const childSchema = usedSchemas.get(childRef);\n      if (!childSchema || !('allOf' in childSchema) || !Array.isArray(childSchema.allOf)) {\n        continue;\n      }\n\n      for (let i = 0; i < childSchema.allOf.length; i++) {\n        const item = childSchema.allOf[i];\n        if (\n          item &&\n          typeof item === 'object' &&\n          'x-readme-ref-name' in item &&\n          item['x-readme-ref-name'] === parentSchemaName &&\n          'oneOf' in item\n        ) {\n          // Clone the allOf entry and strip oneOf from the clone to avoid mutating the shared reference.\n          // This ensures Pet in components.schemas keeps its oneOf while embedded Pet in Cat's allOf doesn't.\n          const clonedItem = cloneObject(item);\n          delete clonedItem.oneOf;\n          childSchema.allOf[i] = clonedItem;\n        }\n      }\n    }\n  }\n}\n","import type {\n  ExampleObject,\n  JSONSchema,\n  OASDocument,\n  ReferenceObject,\n  RequestBodyObject,\n  SchemaObject,\n} from '../types.js';\nimport type { JSONSchema4, JSONSchema7TypeName } from 'json-schema';\nimport type { Options as JSONSchemaMergeAllOfOptions } from 'json-schema-merge-allof';\n\nimport mergeJSONSchemaAllOf from 'json-schema-merge-allof';\nimport jsonpointer from 'jsonpointer';\nimport removeUndefinedObjects from 'remove-undefined-objects';\n\nimport { isOpenAPI30, isRef, isSchema } from '../types.js';\n\nimport { hasSchemaType, isObject, isPrimitive } from './helpers.js';\nimport { collectRefsInSchema, dereferenceRef, encodePointer } from './refs.js';\n\n/**\n * This list has been pulled from `openapi-schema-to-json-schema` but been slightly modified to fit\n * within the constraints in which ReadMe uses the output from this library in schema form\n * rendering as while properties like `readOnly` aren't represented within JSON Schema, we support\n * it within that library's handling of OpenAPI-friendly JSON Schema.\n *\n * @see {@link https://github.com/openapi-contrib/openapi-schema-to-json-schema/blob/main/src/consts.ts}\n */\nconst UNSUPPORTED_SCHEMA_PROPS = [\n  'example', // OpenAPI supports `example` but we're mapping it to `examples` in this library.\n  'externalDocs',\n  'xml',\n] as const;\n\nconst mergeAllOfSchemasOptions: JSONSchemaMergeAllOfOptions = {\n  ignoreAdditionalProperties: true,\n  resolvers: {\n    // `merge-json-schema-allof` by default takes the first `description` when you're merging an\n    // `allOf` but because generally when you're merging two schemas together with an `allOf` you\n    // want data in the subsequent schemas to be applied to the first and `description` should be a\n    // part of that.\n    description: (obj: string[]) => {\n      return obj.slice(-1)[0];\n    },\n\n    // `merge-json-schema-allof` doesn't support merging enum arrays but since that's a safe and\n    // simple operation as enums always contain primitives we can handle it ourselves with a custom\n    // resolver. We intersect the arrays so that child schemas can narrow a parent's broad enum\n    // (e.g. [1,2,20,50] ∩ [1] = [1]).\n    //\n    // We unfortunately need to cast our return value as `any[]` because the internal types of\n    // `merge-json-schema-allof`'s `enum` resolver are not portable.\n    enum: (obj: unknown[]) => {\n      const arrays = obj as any[][];\n      const intersection = arrays.reduce((acc, e) => acc.filter(v => e.includes(v)));\n      return intersection.length > 0 ? intersection : arrays.reduce((acc, e) => acc.concat(e), []);\n    },\n\n    // For any unknown keywords (e.g., `example`, `format`, `x-readme-ref-name`), we fallback to\n    // using the `title` resolver (which uses the first value found).\n    // https://github.com/mokkabonna/json-schema-merge-allof/blob/ea2e48ee34415022de5a50c236eb4793a943ad11/src/index.js#L292\n    // https://github.com/mokkabonna/json-schema-merge-allof/blob/ea2e48ee34415022de5a50c236eb4793a943ad11/README.md?plain=1#L147\n    defaultResolver: mergeJSONSchemaAllOf.options.resolvers.title,\n  },\n};\n\nexport interface toJSONSchemaOptions {\n  /**\n   * Whether or not to extend descriptions with a list of any present enums.\n   */\n  addEnumsToDescriptions?: boolean;\n\n  /**\n   * Current location within the schema -- this is a JSON pointer.\n   */\n  currentLocation?: string;\n\n  /**\n   * An OpenAPI definition to use for schema `$ref` pointer resolutions.\n   */\n  definition?: OASDocument;\n\n  /**\n   * Object containing a global set of defaults that we should apply to schemas that match it.\n   */\n  globalDefaults?: Record<string, unknown>;\n\n  /**\n   * If you wish to hide properties that are marked as being `readOnly`.\n   */\n  hideReadOnlyProperties?: boolean;\n\n  /**\n   * If you wish to hide properties that are marked as being `writeOnly`.\n   */\n  hideWriteOnlyProperties?: boolean;\n\n  /**\n   * Is this schema the child of a polymorphic `allOf` schema?\n   */\n  isPolymorphicAllOfChild?: boolean;\n\n  /**\n   * Array of parent `default` schemas to utilize when attempting to path together schema defaults.\n   */\n  prevDefaultSchemas?: SchemaObject[];\n\n  /**\n   * Array of parent `example` schemas to utilize when attempting to path together schema examples.\n   */\n  prevExampleSchemas?: SchemaObject[];\n\n  /**\n   * A function that's called anytime a (circular) `$ref` is found.\n   */\n  refLogger?: (ref: string, type: 'discriminator' | 'ref') => void;\n\n  /**\n   * Tracks component `$ref` pointers that were already emitted as bare `{ $ref }` stubs in this\n   * conversion. Used so a later duplicate bare `$ref` to the same component keeps the stub,\n   * while a bare `$ref` that follows an `allOf` merge of the same ref still inlines the expanded\n   * schema.\n   */\n  refsEmittedAsStub?: Set<string>;\n\n  /**\n   * A set of `$ref` pointers that have been seen during JSON Schema generation.\n   */\n  seenRefs?: Set<string>;\n\n  /**\n   * A dictionary of referenced schema names to their compiled JSON Schema objects.\n   */\n  usedSchemas?: Map<string, SchemaObject>;\n}\n\n/**\n * Placeholder value in `usedSchemas` while a schema is being converted (used for circular\n * references).\n */\nconst PENDING_SCHEMA = { __pending: true } as unknown as SchemaObject;\n\nfunction isPendingSchema(s: SchemaObject): boolean {\n  return isObject(s) && '__pending' in s && (s as Record<string, unknown>).__pending === true;\n}\n\nexport function getSchemaVersionString(schema: SchemaObject, api: OASDocument): string {\n  // If we're not on OpenAPI 3.1+ then we should fall back to the default schema version.\n  if (isOpenAPI30(api)) {\n    // This should remain as an HTTP url, not HTTPS.\n    return 'http://json-schema.org/draft-04/schema#';\n  }\n\n  // If the schema indicates the version, prefer that.\n  if (schema.$schema) {\n    return schema.$schema;\n  }\n\n  // If the user defined a global schema version on their OAS document, prefer that.\n  if (api.jsonSchemaDialect) {\n    return api.jsonSchemaDialect;\n  }\n\n  return 'https://json-schema.org/draft/2020-12/schema#';\n}\n\nfunction isPolymorphicSchema(schema: SchemaObject): boolean {\n  return 'allOf' in schema || 'anyOf' in schema || 'oneOf' in schema;\n}\n\n/**\n * Decides if a single `oneOf` / `anyOf` entry should be merged with the parent schemas' sibling\n * `items` by wrapping both in `allOf` and running them through `toJSONSchema` (which merges\n * `allOf` schemas together).\n *\n * The reason this exists is that end-users sometimes place `items` next to `oneOf` and `anyOf`\n * declarations within the same schema and we want to attach those element constraints to each\n * polymorphic branch. This however only works when the branch and `items` can be merged, otherwise\n * `json-schema-merge-allof` will throw an exception (eg. you can't merge `object` and `array`\n * together), resulting in us returning an invalid schema of `{}`.\n *\n */\nfunction shouldFoldParentItemsIntoPolymorphBranch(item: unknown): boolean {\n  if (!isObject(item)) return false;\n  if (isRef(item)) return true;\n\n  const branch: SchemaObject = item;\n  if (!('type' in branch) || branch.type === undefined) return true;\n  if (!hasSchemaType(branch, 'array')) return false;\n\n  return !('items' in branch) || branch.items === undefined;\n}\n\n/**\n * Determine if a polymorphic schema is comprised of empty schemas.\n *\n */\nfunction isEmptyPolymorphicSchema(list: unknown): boolean {\n  if (!Array.isArray(list)) return false;\n  if (!list.length) return true;\n\n  return list.every(branch => {\n    if (branch === null || branch === undefined) return true;\n    if (typeof branch !== 'object' || Array.isArray(branch)) return false;\n    return Array.isArray(branch) ? !branch.length : !Object.keys(branch as object).length;\n  });\n}\n\n/**\n * Inline any `$ref` pointer into an objects schema so that `json-schema-merge-allof` can merge\n * them together. We need to do this because `json-schema-merge-allof` does not support `$ref`\n * pointer resolution.\n */\nfunction inlinePropertyRefsForMerge(\n  schema: SchemaObject,\n  usedSchemas: Map<string, SchemaObject>,\n  refLogger: NonNullable<toJSONSchemaOptions['refLogger']>,\n): SchemaObject {\n  const out = structuredClone(schema);\n  if (!('properties' in out) || typeof out.properties !== 'object' || out.properties === null) {\n    return out;\n  }\n\n  for (const key of Object.keys(out.properties)) {\n    const val = out.properties[key];\n    if (isRef(val)) {\n      // Do not inline `#/paths/...` refs when we merge `allOf` schemas together, they should\n      // remain untouched so we can preserve them later.\n      if (val.$ref.startsWith('#/paths/')) {\n        refLogger(val.$ref, 'ref');\n        continue;\n      }\n\n      const resolved = usedSchemas.get(val.$ref);\n      if (resolved !== undefined && !isPendingSchema(resolved)) {\n        out.properties[key] = {\n          ...structuredClone(resolved),\n        };\n      }\n    }\n  }\n\n  return out;\n}\n\n/**\n * Resolve and convert a `$ref` schema, caching the converted result in `usedSchemas`.\n *\n * This helper always attempts to dereference and convert the target schema while guarding against\n * circular/invalid refs with `PENDING_SCHEMA`. The `returnMode` controls whether the caller gets\n * back the original `$ref` pointer or the converted JSON Schema representation.\n */\nfunction resolveAndCacheRefSchema({\n  schema,\n  definition,\n  usedSchemas,\n  seenRefs,\n  conversionOptions,\n  returnMode,\n  refLogger,\n}: {\n  schema: ReferenceObject;\n  definition: OASDocument;\n  usedSchemas: Map<string, SchemaObject>;\n  seenRefs: Set<string>;\n  conversionOptions: toJSONSchemaOptions;\n  returnMode: 'ref' | 'converted';\n  refLogger: NonNullable<toJSONSchemaOptions['refLogger']>;\n}): SchemaObject {\n  const ref = schema.$ref;\n  const refsEmittedAsStub = conversionOptions.refsEmittedAsStub;\n  const existing = usedSchemas.get(ref);\n  if (existing !== undefined && !isPendingSchema(existing)) {\n    if (returnMode === 'converted') {\n      return existing;\n    }\n\n    // If we have already seen this bare `$ref` pointer before, and emitted it as a stub, then we\n    // should do the same again here.\n    if (refsEmittedAsStub?.has(ref)) {\n      return { $ref: ref };\n    }\n\n    // If this existing schema isn't a `$ref` pointer then we should return it as-is.\n    if (!isRef(existing)) {\n      return structuredClone(existing);\n    }\n\n    return { $ref: ref };\n  }\n\n  // If our `$ref` was never resolved away from an in-progress schema then it's either invalid\n  // or a circular reference and we should return it as-is.\n  if (existing !== undefined && isPendingSchema(existing)) {\n    refsEmittedAsStub?.add(ref);\n    return { $ref: ref };\n  }\n\n  usedSchemas.set(ref, PENDING_SCHEMA);\n\n  if (returnMode === 'ref') {\n    // If we want to return the original `$ref` pointer then we should make an attempt to resolve\n    // and lazily dereference it into our `usedSchemas` store.\n    let resolved: SchemaObject;\n    try {\n      const dereferenced = dereferenceRef(schema, definition, seenRefs);\n      if (isRef(dereferenced)) {\n        refLogger(dereferenced.$ref, 'ref');\n\n        let converted: SchemaObject;\n        try {\n          // `jsonpointer` doesn't understand the `#` prefix that `$ref` pointers have so we need\n          // to shave it off.\n          const pointer = ref.startsWith('#') ? decodeURIComponent(ref.substring(1)) : ref;\n          const rawSchema = jsonpointer.get(definition, pointer);\n          if (rawSchema && typeof rawSchema === 'object') {\n            converted = toJSONSchema(structuredClone(rawSchema), { ...conversionOptions, seenRefs });\n          } else {\n            converted = { $ref: ref };\n          }\n        } catch {\n          converted = { $ref: ref };\n        }\n\n        usedSchemas.set(ref, converted);\n        refLogger(ref, 'ref');\n        refsEmittedAsStub?.add(ref);\n        return { $ref: ref };\n      }\n\n      resolved = dereferenced;\n    } catch {\n      refLogger(ref, 'ref');\n      usedSchemas.set(ref, { $ref: ref });\n      refsEmittedAsStub?.add(ref);\n      return { $ref: ref };\n    }\n\n    const converted = toJSONSchema(structuredClone(resolved), { ...conversionOptions, seenRefs });\n    usedSchemas.set(ref, converted);\n    refLogger(ref, 'ref');\n    refsEmittedAsStub?.add(ref);\n    return { $ref: ref };\n  }\n\n  try {\n    // If we want to return the generated and converted JSON Schema object then, if we have a `$ref`\n    // pointer we should make an attempt to resolve and lazily dereference that into our converted\n    // schema. If that fails then we'll return the original schema.\n    const dereferenced = dereferenceRef(schema, definition, seenRefs);\n    if (isRef(dereferenced)) {\n      let converted: SchemaObject;\n      try {\n        // `jsonpointer` doesn't understand the `#` prefix that `$ref` pointers have so\n        // we need to shave it off.\n        const pointer = ref.startsWith('#') ? decodeURIComponent(ref.substring(1)) : ref;\n        const rawSchema = jsonpointer.get(definition, pointer);\n        if (rawSchema && typeof rawSchema === 'object') {\n          converted = toJSONSchema(structuredClone(rawSchema), { ...conversionOptions, seenRefs });\n        } else {\n          converted = { $ref: ref };\n        }\n      } catch {\n        converted = { $ref: ref };\n      }\n\n      usedSchemas.set(ref, converted);\n      return converted;\n    }\n\n    const converted = toJSONSchema(structuredClone(dereferenced), { ...conversionOptions, seenRefs });\n    usedSchemas.set(ref, converted);\n    return converted;\n  } catch {\n    usedSchemas.set(ref, { $ref: ref });\n    return { $ref: ref };\n  }\n}\n\nfunction isRequestBodySchema(schema: unknown): schema is RequestBodyObject {\n  return 'content' in (schema as RequestBodyObject);\n}\n\n/**\n * Given a JSON pointer, a type of property to look for, and an array of schemas do a reverse\n * search through them until we find the JSON pointer, or part of it, within the array.\n *\n * This function will allow you to take a pointer like `/tags/name` and return back `buster` from\n * the following array:\n *\n * ```\n *  [\n *    {\n *      example: {id: 20}\n *    },\n *    {\n *      examples: {\n *        distinctName: {\n *          tags: {name: 'buster'}\n *        }\n *      }\n *    }\n *  ]\n * ```\n *\n * As with most things however, this is not without its quirks! If a deeply nested property shares\n * the same name as an example that's further up the stack (like `tags.id` and an example for `id`),\n * there's a chance that it'll be misidentified as having an example and receive the wrong value.\n *\n * That said, any example is usually better than no example though, so while it's quirky behavior\n * it shouldn't raise immediate cause for alarm.\n *\n * @see {@link https://tools.ietf.org/html/rfc6901}\n * @param property Specific type of schema property to look for a value for.\n * @param pointer JSON pointer to search for an example for.\n * @param schemas Array of previous schemas we've found relating to this pointer.\n */\nfunction searchForValueByPropAndPointer(\n  property: 'default' | 'example',\n  pointer: string,\n  schemas: toJSONSchemaOptions['prevDefaultSchemas'] | toJSONSchemaOptions['prevExampleSchemas'] = [],\n) {\n  if (!schemas.length || !pointer.length) {\n    return;\n  }\n\n  const locSplit = pointer.split('/').filter(Boolean).reverse();\n  const pointers = [];\n\n  let point = '';\n  for (let i = 0; i < locSplit.length; i += 1) {\n    point = `/${locSplit[i]}${point}`;\n    pointers.push(point);\n  }\n\n  let foundValue: any;\n  const rev = [...schemas].reverse();\n\n  for (let i = 0; i < pointers.length; i += 1) {\n    for (let ii = 0; ii < rev.length; ii += 1) {\n      let schema = rev[ii];\n\n      if (property === 'example') {\n        if ('example' in schema) {\n          schema = schema.example;\n        } else {\n          if (!Array.isArray(schema.examples) || !schema.examples.length) {\n            continue;\n          }\n\n          // Prevent us from crashing if `examples` is a completely empty object.\n          schema = [...schema.examples].shift();\n        }\n      } else {\n        schema = schema.default;\n      }\n\n      try {\n        foundValue = jsonpointer.get(schema, pointers[i]);\n      } catch {\n        // If the schema we're looking at is `{obj: null}` and our pointer is `/obj/propertyName`\n        // `jsonpointer` will throw an error. If that happens, we should silently catch and toss it\n        // and return no example.\n      }\n\n      if (foundValue !== undefined) {\n        break;\n      }\n    }\n\n    if (foundValue !== undefined) {\n      break;\n    }\n  }\n\n  return foundValue;\n}\n\n/**\n * Given an OpenAPI-flavored JSON Schema, make an effort to modify it so it's shaped more towards\n * stock JSON Schema.\n *\n * Why do this?\n *\n *  1. OpenAPI 3.0.x supports its own flavor of JSON Schema that isn't fully compatible with most\n *    JSON Schema tooling (like `@readme/oas-form` or `@rjsf/core`).\n *  2. While validating an OpenAPI definition will prevent corrupted or improper schemas from\n *    occuring, we have a lot of legacy schemas in ReadMe that were ingested before we had proper\n *    validation in place, and as a result have some API definitions that will not pass validation\n *    right now. In addition to reshaping OAS-JSON Schema into JSON Schema this library will also\n *    fix these improper schemas: things like `type: object` having `items` instead of `properties`,\n *    or `type: array` missing `items`.\n *  3. To ease the burden of polymorphic handling on our form rendering engine we make an attempt\n *    to merge `allOf` schemas here.\n *  4. Additionally due to OpenAPI 3.0.x not supporting JSON Schema, in order to support the\n *    `example` keyword that OAS supports, we need to do some work in here to remap it into\n *    `examples`. However, since all we care about in respect to examples for usage within\n *    `@readme/oas-form`, we're only retaining primitives. This *slightly* deviates from JSON\n *    Schema in that JSON Schema allows for any schema to be an example, but since\n *    `@readme/oas-form` can only actually **render** primitives, that's what we're retaining.\n *  5. Though OpenAPI 3.1 does support full JSON Schema, this library should be able to handle it\n *    without any problems.\n *\n * And why use this over `@openapi-contrib/openapi-schema-to-json-schema`? Fortunately and\n * unfortunately we've got a lot of API definitions in our database that aren't currently valid so\n * we need to have a lot of bespoke handling for odd quirks, typos, and missing declarations that\n * might be present.\n *\n * @todo add support for `schema: false` and `not` cases.\n * @todo tighten up `data` to allow for `SchemaObject | ReferenceObject`\n * @see {@link https://json-schema.org/draft/2019-09/json-schema-validation.html}\n * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#schema-object}\n * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#schema-object}\n * @param data OpenAPI Schema Object to convert to pure JSON Schema.\n */\nexport function toJSONSchema(data: SchemaObject | boolean, opts?: toJSONSchemaOptions): SchemaObject {\n  let schema = data === true ? {} : { ...data };\n  const schemaAdditionalProperties = isSchema(schema) ? schema.additionalProperties : null;\n\n  const {\n    addEnumsToDescriptions,\n    currentLocation,\n    definition,\n    globalDefaults,\n    hideReadOnlyProperties,\n    hideWriteOnlyProperties,\n    isPolymorphicAllOfChild,\n    prevDefaultSchemas = [],\n    prevExampleSchemas = [],\n    refLogger,\n    seenRefs,\n    usedSchemas,\n    refsEmittedAsStub = new Set<string>(),\n  } = {\n    addEnumsToDescriptions: false,\n    currentLocation: '',\n    globalDefaults: {},\n    hideReadOnlyProperties: false,\n    hideWriteOnlyProperties: false,\n    isPolymorphicAllOfChild: false,\n    prevDefaultSchemas: [] as toJSONSchemaOptions['prevDefaultSchemas'],\n    prevExampleSchemas: [] as toJSONSchemaOptions['prevExampleSchemas'],\n    refLogger: () => true,\n    seenRefs: new Set<string>(),\n    usedSchemas: new Map<string, SchemaObject>(),\n    refsEmittedAsStub: new Set<string>(),\n    ...opts,\n  };\n\n  const polyOptions: toJSONSchemaOptions = {\n    addEnumsToDescriptions,\n    currentLocation,\n    definition,\n    globalDefaults,\n    hideReadOnlyProperties,\n    hideWriteOnlyProperties,\n    isPolymorphicAllOfChild: false,\n    prevDefaultSchemas,\n    prevExampleSchemas,\n    refLogger,\n    seenRefs,\n    usedSchemas,\n    refsEmittedAsStub,\n  };\n\n  // If this schema contains a `$ref` make an attempt to resolve and convert it into our\n  // `usedSchemas` store, but still return the `$ref` in output so we preserve reference identity\n  // instead of inlining a duplicate converted schema at this location.\n  if (isRef(schema)) {\n    if (definition && usedSchemas) {\n      const resolved = resolveAndCacheRefSchema({\n        schema,\n        definition,\n        usedSchemas,\n        seenRefs,\n        conversionOptions: polyOptions,\n        returnMode: 'ref',\n        refLogger,\n      });\n\n      // Preserve metadata siblings (e.g. description, summary) alongside `$ref` pointers because\n      // OpenAPI 3.1 allows those to exist as local overrides. The `properties` keyword at the same\n      // level as `$ref` however is invalid in JSON Schema and should be ignored.\n      const { $ref: _$ref, properties: _propertiesWithRef, ...siblings } = schema as Record<string, unknown>;\n      if (Object.keys(siblings).length > 0) {\n        return { ...resolved, ...siblings };\n      }\n\n      return resolved;\n    }\n\n    refLogger(schema.$ref, 'ref');\n    return schema;\n  }\n\n  // If we don't have a set type, but are dealing with an `anyOf`, `oneOf`, or `allOf`\n  // representation let's run through them and make sure they're good.\n  if (isSchema(schema, isPolymorphicAllOfChild)) {\n    // If this is an `allOf` schema we should make an attempt to merge so as to ease the burden on\n    // the tooling that ingests these schemas.\n    if ('allOf' in schema && Array.isArray(schema.allOf)) {\n      // `json-schema-merge-allof` does not resolve `$ref` pointers so if this schema has sibling\n      // `properties` whose internal schemas _also_ contain an `allOf` with multiple `$ref`\n      // pointers, merging the parent `allOf` first can drop those pointers. We should instead\n      // convert each individual property schema first.\n      if (\n        'properties' in schema &&\n        schema.properties !== undefined &&\n        typeof schema.properties === 'object' &&\n        schema.properties !== null &&\n        !Array.isArray(schema.properties)\n      ) {\n        const preprocessed: SchemaObject['properties'] = {};\n        for (const prop of Object.keys(schema.properties)) {\n          const val = schema.properties[prop];\n          if (Array.isArray(val) || (typeof val === 'object' && val !== null)) {\n            preprocessed[prop] = toJSONSchema(val as SchemaObject, {\n              ...polyOptions,\n              currentLocation: `${currentLocation}/${encodePointer(prop)}`,\n              prevDefaultSchemas,\n              prevExampleSchemas,\n            });\n          } else {\n            preprocessed[prop] = val;\n          }\n        }\n        schema = { ...schema, properties: preprocessed } as SchemaObject;\n      }\n\n      // If we have an API definition present then we should attempt to resolve each `$ref` in an\n      // `allOf` before merging them together with `json-schema-merge-allof` so that that has access\n      // to the full and actual schemas.\n      let allOfSchemas = schema.allOf as SchemaObject[];\n      if (definition && usedSchemas) {\n        // When merging multiple `allOf` schemas together `$ref` pointers that are present are\n        // merged away so we shouldn't log them. When an `allOf` has a single item we're just\n        // unwrapping the schema, so `$ref` pointers _do_ appear in the output then we **should**\n        // log those.\n        const allOfOptions: toJSONSchemaOptions =\n          allOfSchemas.length > 1 ? { ...polyOptions, refLogger: () => {} } : polyOptions;\n\n        allOfSchemas = allOfSchemas.map(item => {\n          if (isRef(item)) {\n            // `isRef` is true for any object with a `$ref` key. When other keywords (e.g. `title`,\n            // `properties`) sit alongside `$ref` in an `allOf` branch, which can be common after\n            // `json-schema-merge-allof` merges a polymorphic schema, resolving only the `$ref`\n            // drops those siblings.\n            //\n            // We should always try to merge the converted target with its converted siblings.\n            if (Object.keys(item).length === 1) {\n              return resolveAndCacheRefSchema({\n                schema: item,\n                definition,\n                usedSchemas,\n                seenRefs,\n                conversionOptions: allOfOptions,\n                returnMode: 'converted',\n                refLogger,\n              });\n            }\n\n            const { $ref, ...siblings } = item as SchemaObject & ReferenceObject;\n            const resolved = resolveAndCacheRefSchema({\n              schema: { $ref },\n              definition,\n              usedSchemas,\n              seenRefs,\n              conversionOptions: allOfOptions,\n              returnMode: 'converted',\n              refLogger,\n            });\n\n            // If all we had was a `$ref` schema then we should return whatever it resolved to.\n            if (!Object.keys(siblings).length) {\n              return resolved;\n            }\n\n            const siblingSchema = toJSONSchema(siblings as SchemaObject, allOfOptions);\n            try {\n              return mergeJSONSchemaAllOf(\n                { allOf: [resolved as JSONSchema4, siblingSchema as JSONSchema4] },\n                mergeAllOfSchemasOptions,\n              ) as SchemaObject;\n            } catch {\n              return resolved;\n            }\n          }\n\n          return toJSONSchema(item as SchemaObject, allOfOptions);\n        });\n\n        schema = {\n          ...schema,\n          allOf: allOfSchemas.map(s => inlinePropertyRefsForMerge(s, usedSchemas, refLogger)),\n        } as SchemaObject;\n      }\n\n      try {\n        schema = mergeJSONSchemaAllOf(schema as JSONSchema, mergeAllOfSchemasOptions) as SchemaObject;\n      } catch {\n        // If we can't merge the `allOf` for whatever reason (like if one item is a `string` and\n        // the other is a `object`) then we should completely remove it from the schema and continue\n        // with whatever we've got. Why? If we don't, any tooling that's ingesting this will need\n        // to account for the incompatible `allOf` and it may be subject to more breakages than\n        // just not having it present would be.\n        const { ...schemaWithoutAllOf } = schema;\n        schema = schemaWithoutAllOf as SchemaObject;\n        delete schema.allOf;\n      }\n\n      // This is a little messy but because `json-schema-merge-allof` doesn't support attaching a\n      // resolver to a deeply nested `$ref` pointer, which we would need to do in order to emit\n      // that a `$ref` is present in this schema, we need to instead scan the resulting schema\n      // for them.\n      collectRefsInSchema(schema).forEach(ref => {\n        refLogger(ref, 'ref');\n      });\n\n      // If after merging the `allOf` this schema still contains a `$ref` then it's circular and\n      // we shouldn't do anything else. Preserve sibling properties alongside the `$ref`.\n      if (isRef(schema)) {\n        refLogger(schema.$ref, 'ref');\n\n        return schema;\n      }\n    }\n\n    (['anyOf', 'oneOf'] as const).forEach((polyType: 'anyOf' | 'oneOf') => {\n      if (polyType in schema && Array.isArray(schema[polyType])) {\n        const discriminatorPropertyName =\n          'discriminator' in schema && schema.discriminator && isObject(schema.discriminator)\n            ? schema.discriminator.propertyName\n            : undefined;\n\n        schema[polyType].forEach((item, idx) => {\n          if (!schema[polyType]?.[idx]) {\n            // We should never hit this because `anyOf` and `oneOf` ara guaranteed by this point to\n            // be arrays but TS isn't smart enough to carry this inferrence down to this block.\n            return;\n          }\n\n          const itemOptions: toJSONSchemaOptions = {\n            ...polyOptions,\n            currentLocation: `${currentLocation}/${idx}`,\n          };\n\n          // When `properties` or `items` are present alongside a polymorphic schema instead of\n          // letting whatever JSON Schema interpreter is handling these constructed schemas we can\n          // guide its hand a bit by manually transforming it into an inferred `allOf` of the\n          // `properties` + the polymorph schema.\n          //\n          // This `allOf` schema will be merged together when fed through `toJSONSchema`.\n          if ('properties' in schema) {\n            schema[polyType][idx] = toJSONSchema(\n              {\n                required: schema.required,\n                allOf: [item, { properties: schema.properties }],\n              } as SchemaObject,\n              itemOptions,\n            );\n          } else if ('items' in schema) {\n            if (shouldFoldParentItemsIntoPolymorphBranch(item)) {\n              schema[polyType][idx] = toJSONSchema(\n                {\n                  allOf: [item, { items: schema.items }],\n                } as SchemaObject,\n                itemOptions,\n              );\n            } else {\n              schema[polyType][idx] = toJSONSchema(item as SchemaObject, itemOptions);\n            }\n          } else {\n            schema[polyType][idx] = toJSONSchema(item as SchemaObject, itemOptions);\n          }\n\n          // Ensure that we don't have any invalid `required` booleans or empty arrays lying around.\n          if ('required' in (schema[polyType][idx] as SchemaObject)) {\n            if (Array.isArray(schema[polyType][idx].required) && schema[polyType][idx].required.length === 0) {\n              delete (schema[polyType][idx] as SchemaObject).required;\n            } else if (\n              isObject(schema[polyType][idx]) &&\n              typeof (schema[polyType][idx] as SchemaObject).required === 'boolean'\n            ) {\n              delete (schema[polyType][idx] as SchemaObject).required;\n            }\n          }\n\n          // When a parent schema has a discriminator and child schemas inherit via allOf, the child\n          // schemas can inherit the parent's discriminator, oneOf, and anyOf. We remove these\n          // from child schemas to avoid nested discriminator UIs where each child incorrectly shows\n          // all other children as options. This keeps the discriminator only at the parent level.\n          if (discriminatorPropertyName) {\n            const childSchema = schema[polyType][idx] as SchemaObject;\n            if (isObject(childSchema)) {\n              if ('discriminator' in childSchema) {\n                delete (childSchema as Record<string, unknown>).discriminator;\n              }\n              if ('oneOf' in childSchema) {\n                delete (childSchema as Record<string, unknown>).oneOf;\n              }\n              if ('anyOf' in childSchema) {\n                delete (childSchema as Record<string, unknown>).anyOf;\n              }\n            }\n\n            // When the child is a `$ref` the actual schema lives in `usedSchemas` so we should\n            // strip these polymorphic keywords there too.\n            if (definition && usedSchemas && isRef(childSchema)) {\n              const resolved = usedSchemas.get(childSchema.$ref);\n              if (resolved && typeof resolved === 'object' && !isPendingSchema(resolved)) {\n                if ('discriminator' in resolved) {\n                  delete (resolved as Record<string, unknown>).discriminator;\n                }\n                if ('oneOf' in resolved) {\n                  delete (resolved as Record<string, unknown>).oneOf;\n                }\n                if ('anyOf' in resolved) {\n                  delete (resolved as Record<string, unknown>).anyOf;\n                }\n\n                // Instead of relying on the `resolved` reference populating back into `usedSchemas`\n                // we should make sure that that schema is refreshed with our new schema.\n                usedSchemas.set(childSchema.$ref, resolved);\n              }\n            }\n          }\n        });\n      }\n    });\n\n    if (schema?.discriminator?.mapping && typeof schema.discriminator.mapping === 'object') {\n      // Discriminator mappings aren't written as traditional `$ref` pointers so in order to log\n      // them to the supplied `refLogger`.\n      const mapping = schema.discriminator.mapping;\n      Object.keys(mapping).forEach(k => {\n        refLogger(mapping[k], 'discriminator');\n      });\n    }\n  }\n\n  // If this schema is malformed for some reason, let's do our best to repair it.\n  if (!('type' in schema) && !isPolymorphicSchema(schema) && !isRequestBodySchema(schema)) {\n    if ('properties' in schema) {\n      schema.type = 'object';\n    } else if ('items' in schema) {\n      schema.type = 'array';\n    } else {\n      // If there's still no `type` on the schema we should leave it alone because we don't have a\n      // great way to know if it's part of a nested schema that should, and couldn't be merged,\n      // into another, or it's just purely malformed.\n      //\n      // Whatever tooling that ingests the generated schema should handle it however it needs to.\n    }\n  }\n\n  if ('type' in schema && schema.type !== undefined) {\n    // `nullable` isn't a thing in JSON Schema but it was in OpenAPI 3.0 so we should retain and\n    // translate it into something that's compatible with JSON Schema.\n    if ('nullable' in schema) {\n      if (schema.nullable) {\n        if (Array.isArray(schema.type)) {\n          schema.type.push('null');\n        } else if (schema.type !== null && schema.type !== 'null') {\n          schema.type = [schema.type, 'null'];\n        }\n      }\n\n      delete schema.nullable;\n    }\n\n    if (schema.type === null) {\n      // `type: null` is possible in JSON Schema but we're translating it to a string version\n      // so we don't need to worry about asserting nullish types in our implementations of this\n      // generated schema.\n      (schema as SchemaObject).type = 'null';\n    } else if (Array.isArray(schema.type)) {\n      // @ts-expect-error -- `null` is not valid in JSON Schema but it can be done in OpenAPI 3.0.\n      if (schema.type.includes(null)) {\n        // @ts-expect-error -- `null` is not valid in JSON Schema but it can be done in OpenAPI 3.0.\n        schema.type[schema.type.indexOf(null)] = 'null';\n      }\n\n      schema.type = Array.from(new Set(schema.type));\n\n      // We don't need `type: [<type>]` when we can just as easily make it `type: <type>`.\n      if (schema.type.length === 1) {\n        schema.type = schema.type.shift();\n      } else if (schema.type.includes('array') || schema.type.includes('boolean') || schema.type.includes('object')) {\n        // If we have a `null` type but there's only two types present then we can remove `null`\n        // as an option and flag the whole schema as `nullable`.\n        const isNullable = schema.type.includes('null');\n\n        if (schema.type.length === 2 && isNullable) {\n          // If this is `array | null` or `object | null` then we don't need to do anything.\n        } else {\n          // If this mixed type has non-primitives then we for convenience of our implementation\n          // we're moving them into a `oneOf`.\n          const nonPrimitives: any[] = [];\n\n          // Because arrays, booleans, and objects are not compatible with any other schem type\n          // other than null we're moving them into an isolated `oneOf`, and as such want to take\n          // with it its specific properties that may be present on our current schema.\n          Object.entries({\n            // https://json-schema.org/understanding-json-schema/reference/array.html\n            array: [\n              'additionalItems',\n              'contains',\n              'items',\n              'maxContains',\n              'maxItems',\n              'minContains',\n              'minItems',\n              'prefixItems',\n              'uniqueItems',\n            ],\n\n            // https://json-schema.org/understanding-json-schema/reference/boolean.html\n            boolean: [\n              // Booleans don't have any boolean-specific properties.\n            ],\n\n            // https://json-schema.org/understanding-json-schema/reference/object.html\n            object: [\n              'additionalProperties',\n              'maxProperties',\n              'minProperties',\n              'nullable',\n              'patternProperties',\n              'properties',\n              'propertyNames',\n              'required',\n            ],\n          } as Record<string, (keyof SchemaObject)[]>).forEach(([typeKey, keywords]) => {\n            if (!schema.type?.includes(typeKey as JSONSchema7TypeName)) {\n              return;\n            }\n\n            const reducedSchema: any = removeUndefinedObjects({\n              type: isNullable ? [typeKey, 'null'] : typeKey,\n\n              allowEmptyValue: (schema as any).allowEmptyValue ?? undefined,\n              deprecated: schema.deprecated ?? undefined,\n              description: schema.description ?? undefined,\n              readOnly: schema.readOnly ?? undefined,\n              title: schema.title ?? undefined,\n              writeOnly: schema.writeOnly ?? undefined,\n            });\n\n            keywords.forEach(keyword => {\n              if (keyword in schema) {\n                reducedSchema[keyword] = schema[keyword];\n                delete schema[keyword];\n              }\n            });\n\n            nonPrimitives.push(reducedSchema);\n          });\n\n          schema.type = schema.type.filter(t => t !== 'array' && t !== 'boolean' && t !== 'object');\n          if (schema.type.length === 1) {\n            schema.type = schema.type.shift();\n          }\n\n          // Because we may have encountered a fully mixed non-primitive type like `array | object`\n          // we only want to retain the existing schema object if we still have types remaining\n          // in it.\n          if (schema.type && schema.type.length > 1) {\n            schema = { oneOf: [schema, ...nonPrimitives] };\n          } else {\n            schema = { oneOf: nonPrimitives };\n          }\n        }\n      }\n    }\n  }\n\n  if (isSchema(schema, isPolymorphicAllOfChild)) {\n    if ('default' in schema && isObject(schema.default)) {\n      prevDefaultSchemas.push({ default: schema.default });\n    }\n\n    // JSON Schema doesn't support OpenAPI-style examples so we need to reshape them a bit.\n    if ('example' in schema) {\n      // Only bother adding primitive examples.\n      if (isPrimitive(schema.example)) {\n        schema.examples = [schema.example];\n      } else if (Array.isArray(schema.example)) {\n        schema.examples = schema.example.filter(example => isPrimitive(example));\n        if (!schema.examples.length) {\n          delete schema.examples;\n        }\n      } else {\n        prevExampleSchemas.push({ example: schema.example });\n      }\n\n      delete schema.example;\n    } else if ('examples' in schema) {\n      let reshapedExamples = false;\n      if (typeof schema.examples === 'object' && schema.examples !== null && !Array.isArray(schema.examples)) {\n        const examples: unknown[] = [];\n\n        Object.entries(schema.examples).forEach(([name, example]) => {\n          let currentExample = example as ExampleObject | ReferenceObject;\n          if (name === '$ref') {\n            currentExample = dereferenceRef({ $ref: currentExample } as ReferenceObject, definition, seenRefs);\n            if (!currentExample || isRef(currentExample)) {\n              // If this example is invalid or still a `$ref` after lazy dereferencing then we\n              // should log and ignore it.\n              refLogger(currentExample.$ref, 'ref');\n              return;\n            }\n          }\n\n          if ('value' in currentExample) {\n            if (isPrimitive(currentExample.value)) {\n              examples.push(currentExample.value);\n              reshapedExamples = true;\n            } else if (Array.isArray(currentExample.value) && isPrimitive(currentExample.value[0])) {\n              examples.push(currentExample.value[0]);\n              reshapedExamples = true;\n            } else {\n              // If this example is neither a primitive or an array we should dump it into the\n              // `prevExampleSchemas` array because we might be able to extract an example from it\n              // further downstream.\n              prevExampleSchemas.push({\n                example: currentExample.value,\n              });\n            }\n          }\n        });\n\n        if (examples.length) {\n          reshapedExamples = true;\n          schema.examples = examples;\n        }\n      } else if (Array.isArray(schema.examples) && isPrimitive(schema.examples[0])) {\n        // We haven't reshaped `examples` here, but since it's in a state that's preferrable to us\n        // let's keep it around.\n        reshapedExamples = true;\n      }\n\n      if (!reshapedExamples) {\n        delete schema.examples;\n      }\n    }\n\n    // If we didn't have any immediately defined examples, let's search backwards and see if we can\n    // find one. But as we're only looking for primitive example, only try to search for one if\n    // we're dealing with a primitive schema.\n    if (!hasSchemaType(schema, 'array') && !hasSchemaType(schema, 'object') && !schema.examples) {\n      const foundExample = searchForValueByPropAndPointer('example', currentLocation, prevExampleSchemas);\n      if (foundExample) {\n        // We can only really deal with primitives, so only promote those as the found example if\n        // it is.\n        if (isPrimitive(foundExample) || (Array.isArray(foundExample) && isPrimitive(foundExample[0]))) {\n          schema.examples = [foundExample];\n        }\n      }\n    }\n\n    if (hasSchemaType(schema, 'array')) {\n      if ('items' in schema && schema.items !== undefined) {\n        if (\n          !(definition && usedSchemas) &&\n          !Array.isArray(schema.items) &&\n          Object.keys(schema.items).length === 1 &&\n          isRef(schema.items)\n        ) {\n          // When not resolving refs, `items` that is a lone `$ref` is treated as circular; log and leave as-is.\n          refLogger(schema.items.$ref, 'ref');\n        } else if (schema.items !== true) {\n          // Run through the arrays contents and clean them up (including resolving $ref in items when in ref-resolution mode).\n          // Do not pass prevDefaultSchemas: the array's default (e.g. [12, 34, 56]) belongs on the array,\n          // not on items (we must not set default: 12 on items when the default is already on tags).\n          schema.items = toJSONSchema(schema.items as SchemaObject, {\n            ...polyOptions,\n            currentLocation: `${currentLocation}/0`,\n            prevDefaultSchemas: [],\n            prevExampleSchemas,\n          });\n\n          // If we have a non-array, or empty array, `required` entry in our `items` schema then\n          // it's invalid and we should remove it. We only support non-array boolean `required`\n          // properties inside object properties.\n          if ('required' in schema.items) {\n            if (Array.isArray(schema.items.required) && schema.items.required.length === 0) {\n              delete schema.items.required;\n            } else if (isObject(schema.items) && !Array.isArray(schema.items.required)) {\n              delete schema.items.required;\n            }\n          }\n        }\n      } else if ('properties' in schema || 'additionalProperties' in schema) {\n        // This is a fix to handle cases where someone may have typod `items` as `properties` on an\n        // array. Since throwing a complete failure isn't ideal, we can see that they meant for the\n        // type to be `object`, so we can do our best to shape the data into what they were\n        // intending it to be.\n        schema.type = 'object';\n      } else {\n        // This is a fix to handle cases where we have a malformed array with no `items` property\n        // present.\n        (schema as any).items = {};\n      }\n    } else if (hasSchemaType(schema, 'object')) {\n      if ('properties' in schema && schema.properties !== undefined) {\n        Object.keys(schema.properties).forEach(prop => {\n          if (\n            Array.isArray(schema.properties?.[prop]) ||\n            (typeof schema.properties?.[prop] === 'object' && schema.properties?.[prop] !== null)\n          ) {\n            const newPropSchema = toJSONSchema(schema.properties[prop] as SchemaObject, {\n              ...polyOptions,\n              currentLocation: `${currentLocation}/${encodePointer(prop)}`,\n              prevDefaultSchemas,\n              prevExampleSchemas,\n            });\n\n            // If this property is read or write only then we should fully hide it from its parent schema.\n            let propShouldBeUpdated = true;\n            if ((hideReadOnlyProperties || hideWriteOnlyProperties) && !Object.keys(newPropSchema).length) {\n              // We should only delete this schema if it wasn't already empty though. We do this\n              // because we (un)fortunately have handling in our API Explorer form system for\n              // schemas that are devoid of any `type` declaration.\n              if (Object.keys(schema.properties[prop]).length > 0) {\n                delete schema.properties[prop];\n                propShouldBeUpdated = false;\n              }\n            }\n\n            if (propShouldBeUpdated) {\n              schema.properties[prop] = newPropSchema;\n\n              /**\n               * JSON Schema does not have any support for `required: <boolean>` but because some\n               * of our users do this, and it does not throw OpenAPI validation errors thanks to\n               * some extremely loose typings around `schema` in the official JSON Schema\n               * definitions that the OAI offers, we're opting to support these users and upgrade\n               * their invalid `required` definitions into ones that our tooling can interpret.\n               *\n               * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/schemas/v3.1/schema.json#L1114-L1121}\n               */\n              if (\n                isObject(newPropSchema) &&\n                'required' in newPropSchema &&\n                typeof newPropSchema.required === 'boolean' &&\n                newPropSchema.required === true\n              ) {\n                if ('required' in schema && Array.isArray(schema.required)) {\n                  schema.required.push(prop);\n                } else {\n                  schema.required = [prop];\n                }\n\n                delete (schema.properties[prop] as SchemaObject).required;\n              }\n            }\n          }\n        });\n\n        // If we want to hide all readOnly or writeOnly properites and it happens to be that this\n        // object was comprised of only those then we shouldn't render this object.\n        if (hideReadOnlyProperties || hideWriteOnlyProperties) {\n          if (!Object.keys(schema.properties).length) {\n            return {};\n          }\n        }\n      }\n\n      if (typeof schemaAdditionalProperties === 'object' && schemaAdditionalProperties !== null) {\n        // If this `additionalProperties` is completely empty and devoid of any sort of schema,\n        // treat it as such. Otherwise let's recurse into it and see if we can sort it out.\n        if (\n          !('type' in schemaAdditionalProperties) &&\n          !('$ref' in schemaAdditionalProperties) &&\n          // We know it will be a schema object because it's dereferenced\n          !isPolymorphicSchema(schemaAdditionalProperties as SchemaObject)\n        ) {\n          schema.additionalProperties = true;\n        } else {\n          // We know it will be a schema object because it's dereferenced\n          schema.additionalProperties = toJSONSchema(schemaAdditionalProperties as SchemaObject, {\n            ...polyOptions,\n            currentLocation,\n            prevDefaultSchemas,\n            prevExampleSchemas,\n          });\n        }\n      }\n\n      // Since neither `properties` and `additionalProperties` are actually required to be present\n      // on an object, since we construct this schema work to build up a form we still need\n      // *something* for the user to enter in for this object so we'll add back in\n      // `additionalProperties` for that.\n      if (!isPolymorphicSchema(schema) && !('properties' in schema) && !('additionalProperties' in schema)) {\n        schema.additionalProperties = true;\n      }\n    }\n  }\n\n  /**\n   * Users can pass in parameter defaults via JWT User Data. We're checking to see if the defaults\n   * being passed in exist on endpoints via jsonpointer\n   *\n   * @see {@link https://docs.readme.com/docs/passing-data-to-jwt}\n   */\n  if (\n    isSchema(schema, isPolymorphicAllOfChild) &&\n    globalDefaults &&\n    Object.keys(globalDefaults).length > 0 &&\n    currentLocation\n  ) {\n    try {\n      const userJwtDefault = jsonpointer.get(globalDefaults, currentLocation);\n      if (userJwtDefault) {\n        schema.default = userJwtDefault;\n      }\n    } catch {\n      // If jsonpointer returns an error, we won't show any defaults for that path.\n    }\n  }\n\n  // Only add a default value if we actually have one.\n  if ('default' in schema && typeof schema.default !== 'undefined') {\n    if (hasSchemaType(schema, 'object')) {\n      // Defaults for `object` and types have been dereferenced into their children schemas already\n      // above so we don't need to preserve this default anymore.\n      delete schema.default;\n    } else if (\n      ('allowEmptyValue' in schema && schema.allowEmptyValue && schema.default === '') ||\n      schema.default !== ''\n    ) {\n      // If we have `allowEmptyValue` present, and the default is actually an empty string, let it\n      // through as it's allowed.\n    } else {\n      // If the default is empty and we don't want to allowEmptyValue, we need to remove the\n      // default.\n      delete schema.default;\n    }\n  } else if (prevDefaultSchemas.length) {\n    const foundDefault = searchForValueByPropAndPointer('default', currentLocation, prevDefaultSchemas);\n\n    // We shouldn't ever set an object default out of the parent lineage tree defaults because\n    // the contents of that object will be set on the schema that they're a part of. Setting\n    // that object as well would result us in duplicating the defaults for that schema in two\n    // places.\n    if (\n      isPrimitive(foundDefault) ||\n      foundDefault === null ||\n      (Array.isArray(foundDefault) && hasSchemaType(schema, 'array'))\n    ) {\n      (schema as SchemaObject).default = foundDefault;\n    }\n  }\n\n  if (isSchema(schema, isPolymorphicAllOfChild) && 'enum' in schema && Array.isArray(schema.enum)) {\n    // Enums should not have duplicated items as those will break AJV validation.\n    // If we ever target ES6 for typescript we can drop this array.from.\n    // https://stackoverflow.com/questions/33464504/using-spread-syntax-and-new-set-with-typescript/56870548\n    schema.enum = Array.from(new Set(schema.enum));\n\n    // If we want to add enums to descriptions (like in the case of response JSON Schema)\n    // generation we need to convert them into a list of Markdown tilda'd strings. We're also\n    // filtering away empty and falsy strings here because adding empty `` blocks to the description\n    // will serve nobody any good.\n    if (addEnumsToDescriptions) {\n      const enums = schema.enum\n        .filter(v => v !== undefined && (typeof v !== 'string' || v.trim() !== ''))\n        .map(str => `\\`${str}\\``)\n        .join(' ');\n\n      if (enums.length) {\n        const currentDescription =\n          'description' in schema && typeof schema.description === 'string' ? schema.description : '';\n\n        if (!currentDescription) {\n          schema.description = enums;\n        } else {\n          const paragraphs = currentDescription.split(/\\n\\n+/).map(p => p.trim());\n          const enumParagraphCount = paragraphs.filter(p => p === enums).length;\n\n          // After `allOf` merging nested properties are run through `toJSONSchema` again however\n          // enum description additions may already be present from the first pass, we should avoid\n          // duplicating thoes addendums.\n          if (enumParagraphCount > 1) {\n            const withoutEnum = paragraphs.filter(p => p !== enums);\n            schema.description = withoutEnum.length > 0 ? `${withoutEnum.join('\\n\\n')}\\n\\n${enums}` : enums;\n          } else if (paragraphs.some(p => p === enums)) {\n            // noop\n          } else {\n            schema.description = `${currentDescription}\\n\\n${enums}`;\n          }\n        }\n      }\n    }\n  }\n\n  // Clean up any remaining `items` or `properties` schema fragments lying around if there's also\n  // polymorphism present.\n  if ('anyOf' in schema || 'oneOf' in schema) {\n    // If this polymorphic schema is comprised of schemas that were unable to be merged and are now\n    // empty objects then we should wipe them out because they're fully invalid.\n    for (const key of ['anyOf', 'oneOf'] as const) {\n      if (key in schema && isEmptyPolymorphicSchema(schema[key])) {\n        delete schema[key];\n      }\n    }\n\n    if ('anyOf' in schema || 'oneOf' in schema) {\n      if ('properties' in schema) {\n        delete schema.properties;\n      }\n\n      if ('items' in schema) {\n        delete schema.items;\n        if ('type' in schema && schema.type === 'array') {\n          delete schema.type;\n        }\n      }\n    }\n  }\n\n  // Remove unsupported JSON Schema props.\n  for (let i = 0; i < UNSUPPORTED_SCHEMA_PROPS.length; i += 1) {\n    // Using the as here because the purpose is to delete keys we don't expect, so of course the\n    // typing won't work\n    delete (schema as Record<string, unknown>)[UNSUPPORTED_SCHEMA_PROPS[i]];\n  }\n\n  // If we want to hide any `readOnly` or `writeOnly` schemas, and this one is that, then we\n  // shouldn't return anything.\n  if (hideReadOnlyProperties && 'readOnly' in schema && schema.readOnly === true) {\n    return {};\n  } else if (hideWriteOnlyProperties && 'writeOnly' in schema && schema.writeOnly === true) {\n    return {};\n  }\n\n  return schema;\n}\n","import type { toJSONSchemaOptions } from '../../lib/openapi-to-json-schema.js';\nimport type { ExampleObject, OASDocument, ParameterObject, SchemaObject, SchemaWrapper } from '../../types.js';\nimport type { Operation } from '../index.js';\nimport type { OpenAPIV3_1 } from 'openapi-types';\n\nimport { getExtension, PARAMETER_ORDERING } from '../../extensions.js';\nimport { applyDiscriminatorOneOfToUsedSchemas } from '../../lib/build-discriminator-one-of.js';\nimport { cloneObject } from '../../lib/clone-object.js';\nimport { getParameterContentType } from '../../lib/get-parameter-content-type.js';\nimport { isPrimitive } from '../../lib/helpers.js';\nimport { getSchemaVersionString, toJSONSchema } from '../../lib/openapi-to-json-schema.js';\nimport {\n  collectRefsInSchema,\n  dereferenceRef,\n  filterRequiredRefsToReferenced,\n  mergeReferencedSchemasIntoRoot,\n} from '../../lib/refs.js';\nimport { isRef } from '../../types.js';\n\n/**\n * The order of this object determines how they will be sorted in the compiled JSON Schema\n * representation.\n *\n * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#parameter-object}\n * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#parameter-object}\n */\nexport const types: Record<keyof OASDocument, string> = {\n  path: 'Path Params',\n  query: 'Query Params',\n  body: 'Body Params',\n  cookie: 'Cookie Params',\n  formData: 'Form Data',\n  header: 'Headers',\n  metadata: 'Metadata', // This a special type reserved for https://npm.im/api\n};\n\nexport interface getParametersAsJSONSchemaOptions {\n  /**\n   * Contains an object of user defined schema defaults.\n   */\n  globalDefaults?: Record<string, unknown>;\n\n  /**\n   * If you wish to hide properties that are marked as being `readOnly`.\n   */\n  hideReadOnlyProperties?: boolean;\n\n  /**\n   * If you wish to hide properties that are marked as being `writeOnly`.\n   */\n  hideWriteOnlyProperties?: boolean;\n\n  /**\n   * If you wish to include discriminator mapping `$ref` components alongside your\n   * `discriminator` in schemas. Defaults to `true`.\n   */\n  includeDiscriminatorMappingRefs?: boolean;\n\n  /**\n   * If you want the output to be two objects: body (contains `body` and `formData` JSON\n   * Schema) and metadata (contains `path`, `query`, `cookie`, and `header`).\n   */\n  mergeIntoBodyAndMetadata?: boolean;\n}\n\nexport function getParametersAsJSONSchema(\n  operation: Operation,\n  api: OASDocument,\n  opts?: getParametersAsJSONSchemaOptions,\n): SchemaWrapper[] | null {\n  const seenRefs = new Set<string>();\n  const refsByGroup = new Map<string, Set<string>>();\n  const usedSchemasByGroup = new Map<string, Map<string, SchemaObject>>();\n\n  function refLoggerForSchemaGroup(group: string) {\n    let set = refsByGroup.get(group);\n    if (!set) {\n      set = new Set();\n      refsByGroup.set(group, set);\n    }\n\n    return set;\n  }\n\n  function usedSchemasForSchemaGroup(group: string) {\n    let map = usedSchemasByGroup.get(group);\n    if (!map) {\n      map = new Map<string, SchemaObject>();\n      usedSchemasByGroup.set(group, map);\n    }\n\n    return map;\n  }\n\n  const baseSchemaOptions: toJSONSchemaOptions = {\n    definition: api,\n    globalDefaults: opts?.globalDefaults,\n    hideReadOnlyProperties: opts?.hideReadOnlyProperties,\n    hideWriteOnlyProperties: opts?.hideWriteOnlyProperties,\n    seenRefs,\n  };\n\n  function transformRequestBody(): SchemaWrapper | null {\n    const requestBody = operation.getRequestBody();\n    if (!requestBody || !Array.isArray(requestBody)) return null;\n\n    const [mediaType, mediaTypeObject, description] = requestBody;\n    const type = mediaType === 'application/x-www-form-urlencoded' ? 'formData' : 'body';\n\n    // If this schema is completely empty, don't bother processing it.\n    if (!mediaTypeObject.schema || !Object.keys(mediaTypeObject.schema).length) {\n      return null;\n    }\n\n    const prevExampleSchemas: toJSONSchemaOptions['prevExampleSchemas'] = [];\n    if ('example' in mediaTypeObject) {\n      prevExampleSchemas.push({ example: mediaTypeObject.example });\n    } else if ('examples' in mediaTypeObject) {\n      prevExampleSchemas.push({\n        examples: Object.values(mediaTypeObject.examples || {})\n          .map(ex => {\n            let example = ex;\n            if (!example) return;\n            if (isRef(example)) {\n              example = dereferenceRef(example, operation.api);\n              if (!example || isRef(example)) return;\n            }\n\n            return example.value;\n          })\n          .filter((item): item is ExampleObject => item !== undefined),\n      });\n    }\n\n    // We're cloning the request schema because we've had issues with request schemas that were\n    // dereferenced being processed multiple times because their component is also processed.\n    const requestSchema = cloneObject(mediaTypeObject.schema);\n\n    const cleanedSchema = toJSONSchema(requestSchema, {\n      ...baseSchemaOptions,\n      usedSchemas: usedSchemasForSchemaGroup(type),\n      prevExampleSchemas,\n      refLogger: ref => refLoggerForSchemaGroup(type).add(ref),\n    });\n\n    // If this schema is **still** empty, don't bother returning it.\n    if (!Object.keys(cleanedSchema).length) {\n      return null;\n    }\n\n    return {\n      type,\n      label: types[type],\n      schema: isPrimitive(cleanedSchema)\n        ? cleanedSchema\n        : {\n            ...cleanedSchema,\n            $schema: getSchemaVersionString(cleanedSchema, api),\n          },\n      ...(description ? { description } : {}),\n    };\n  }\n\n  function transformParameters(): SchemaWrapper[] {\n    const operationParams = operation.getParameters();\n\n    const transformed = Object.keys(types)\n      .map(type => {\n        const required: string[] = [];\n\n        // This `as` actually *could* be a ref, but we don't want refs to pass through here, so\n        // `.in` will never match `type`\n        const parameters = operationParams.filter(param => (param as ParameterObject).in === type);\n        if (parameters.length === 0) {\n          return null;\n        }\n\n        const properties = parameters.reduce((prev: Record<string, SchemaObject>, current: ParameterObject) => {\n          let schema: SchemaObject = {};\n          if ('schema' in current) {\n            const currentSchema: SchemaObject = current.schema ? cloneObject(current.schema) : {};\n\n            if (current.example) {\n              // `example` can be present outside of the `schema` block so if it's there we should\n              // pull it in so it can be handled and returned if it's valid.\n              currentSchema.example = current.example;\n            } else if (current.examples) {\n              // `examples` isn't actually supported here in OAS 3.0, but we might as well support\n              // it because `examples` is JSON Schema and that's fully supported in OAS 3.1.\n              currentSchema.examples = current.examples as unknown as unknown[];\n            }\n\n            if (current.deprecated) currentSchema.deprecated = current.deprecated;\n\n            const interimSchema = toJSONSchema(currentSchema, {\n              ...baseSchemaOptions,\n              usedSchemas: usedSchemasForSchemaGroup(type),\n              currentLocation: `/${current.name}`,\n              refLogger: ref => refLoggerForSchemaGroup(type).add(ref),\n            });\n\n            schema = isPrimitive(interimSchema) ? interimSchema : { ...interimSchema };\n          } else if ('content' in current && typeof current.content === 'object') {\n            const contentKeys = Object.keys(current.content);\n            if (contentKeys.length) {\n              const contentType = getParameterContentType(contentKeys);\n              if (\n                contentType &&\n                typeof current.content[contentType] === 'object' &&\n                'schema' in current.content[contentType]\n              ) {\n                const currentSchema: SchemaObject = current.content[contentType].schema\n                  ? cloneObject(current.content[contentType].schema)\n                  : {};\n\n                if (current.example) {\n                  // `example` can be present outside of the `schema` block so if it's there we\n                  // should pull it in so it can be handled and returned if it's valid.\n                  currentSchema.example = current.example;\n                } else if (current.examples) {\n                  // `examples` isn't actually supported here in OAS 3.0, but we might as well\n                  // support it because `examples` is JSON Schema and that's fully supported in OAS\n                  // 3.1.\n                  currentSchema.examples = current.examples as unknown as unknown[];\n                }\n\n                if (current.deprecated) currentSchema.deprecated = current.deprecated;\n\n                const interimSchema = toJSONSchema(currentSchema, {\n                  ...baseSchemaOptions,\n                  usedSchemas: usedSchemasForSchemaGroup(type),\n                  currentLocation: `/${current.name}`,\n                  refLogger: ref => refLoggerForSchemaGroup(type).add(ref),\n                });\n\n                schema = isPrimitive(interimSchema) ? interimSchema : { ...interimSchema };\n              }\n            }\n          }\n\n          // Parameter descriptions don't exist in `current.schema` so `constructSchema` will never\n          // have access to it.\n          if (current.description) {\n            if (!isPrimitive(schema)) {\n              schema.description = current.description;\n            }\n          }\n\n          prev[current.name] = schema;\n\n          if (current.required) {\n            required.push(current.name);\n          }\n\n          return prev;\n        }, {});\n\n        const schema: OpenAPIV3_1.SchemaObject = {\n          $schema: getSchemaVersionString({}, api),\n          type: 'object',\n          properties: properties as Record<string, OpenAPIV3_1.SchemaObject>,\n          ...(required.length > 0 ? { required } : {}),\n        };\n\n        return {\n          type,\n          label: types[type],\n          schema,\n        };\n      })\n      .filter(item => item !== null);\n\n    if (!opts?.mergeIntoBodyAndMetadata) {\n      return transformed;\n    } else if (!transformed.length) {\n      return [];\n    }\n\n    // If we want to merge parameters into a single metadata entry then we need to pull all\n    // available schemas under one roof.\n    return [\n      {\n        type: 'metadata',\n        label: types.metadata,\n        schema: {\n          allOf: transformed.map(r => r.schema),\n        },\n      },\n    ];\n  }\n\n  // If this operation neither has any parameters or a request body then we should return `null`\n  // because there won't be any JSON Schema.\n  if (!operation.hasParameters() && !operation.hasRequestBody()) {\n    return null;\n  }\n\n  // `metadata` is `api` SDK specific, is not a part of the `PARAMETER_ORDERING` extension, and\n  // should always be sorted last. We also define `formData` as `form` in the extension because\n  // we don't want folks to have to deal with casing issues so we need to rewrite it to `formData`.\n  const typeKeys = (getExtension(PARAMETER_ORDERING, api, operation) as string[]).map(k => k.toLowerCase());\n  typeKeys[typeKeys.indexOf('form')] = 'formData';\n  typeKeys.push('metadata');\n\n  const jsonSchema = [transformRequestBody()]\n    .concat(...transformParameters())\n    .filter((item): item is SchemaWrapper => item !== null);\n\n  // For each group include only schemas that are referenced or otherwise used within that groups'\n  // schema. This allows us to avoid having to include schemas or components that are not used,\n  // which would otherwise add to the overall bloat and memory footprint of the generated JSON\n  // Schema object.\n  return jsonSchema\n    .map(group => {\n      if (group.schema && typeof group.schema === 'object') {\n        const usedSchemas = usedSchemasByGroup.get(group.type) ?? new Map<string, SchemaObject>();\n\n        // Apply discriminator `oneOf` arrays to used schemas.\n        applyDiscriminatorOneOfToUsedSchemas(api, usedSchemas, (ref: string) => {\n          if (usedSchemas.has(ref)) {\n            return usedSchemas.get(ref);\n          }\n\n          try {\n            const resolved = dereferenceRef({ $ref: ref }, api, seenRefs);\n            if (isRef(resolved)) return;\n            const converted = toJSONSchema(structuredClone(resolved) as SchemaObject, {\n              ...baseSchemaOptions,\n              usedSchemas,\n              seenRefs,\n            });\n\n            usedSchemas.set(ref, converted);\n            return converted;\n          } catch {\n            // no-op\n          }\n        });\n\n        // Because the `refLogger` does not see every `$ref` that is present in the generated\n        // schema (eg. nested refs inside an `anyOf` branch that was inlined from cache) we need to\n        // collect everything else.\n        const refsInOutput = collectRefsInSchema(group.schema);\n        const refsInGroup = refsByGroup.get(group.type) ?? new Set();\n        const referencedSchemas = filterRequiredRefsToReferenced(\n          new Set([...refsInGroup, ...refsInOutput]),\n          usedSchemas,\n        );\n\n        if (referencedSchemas.size > 0) {\n          mergeReferencedSchemasIntoRoot(group.schema, referencedSchemas);\n        }\n      }\n\n      return group;\n    })\n    .sort((a, b) => {\n      return typeKeys.indexOf(a.type) - typeKeys.indexOf(b.type);\n    });\n}\n","import { getParameterContentType } from './lib/get-parameter-content-type.js';\nimport matchesMimeType from './lib/matches-mimetype.js';\nimport { dereferenceRef } from './lib/refs.js';\nimport { types as jsonSchemaTypes } from './operation/transformers/get-parameters-as-json-schema.js';\n\nexport const supportedMethods = ['get', 'put', 'post', 'delete', 'options', 'head', 'patch', 'trace'] as const;\n\nexport const SERVER_VARIABLE_REGEX: RegExp = /{([-_a-zA-Z0-9:.[\\]]+)}/g;\n\nexport { getParameterContentType, jsonSchemaTypes, matchesMimeType, dereferenceRef };\n"]}

package/dist/index.cjs

@@ -1,13 +1,13 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _chunkFGPV2UXTcjs = require('./chunk-FGPV2UXT.cjs');
-require('./chunk-DNLCD3K6.cjs');
-require('./chunk-X7KOY66H.cjs');
+var _chunkBJEFIYTOcjs = require('./chunk-BJEFIYTO.cjs');
+require('./chunk-7BWVOLZR.cjs');
+require('./chunk-SAB2PGCD.cjs');
 require('./chunk-AYA3UT4L.cjs');
 require('./chunk-3MTU2ESP.cjs');
 
 
-exports.default = _chunkFGPV2UXTcjs.Oas;
+exports.default = _chunkBJEFIYTOcjs.Oas;
 
 module.exports = exports.default;
 //# sourceMappingURL=index.cjs.map

package/dist/index.js

@@ -1,8 +1,8 @@
 import {
   Oas
-} from "./chunk-2J4VKLIT.js";
-import "./chunk-JCBISKOK.js";
-import "./chunk-QINBUHP2.js";
+} from "./chunk-2EISA7HB.js";
+import "./chunk-GIFUTDD5.js";
+import "./chunk-K5WNB3M7.js";
 import "./chunk-S27IGTVG.js";
 import "./chunk-PSNTODZL.js";
 export {

package/dist/operation/index.cjs

@@ -2,13 +2,13 @@
 
 
 
-var _chunkDNLCD3K6cjs = require('../chunk-DNLCD3K6.cjs');
-require('../chunk-X7KOY66H.cjs');
+var _chunk7BWVOLZRcjs = require('../chunk-7BWVOLZR.cjs');
+require('../chunk-SAB2PGCD.cjs');
 require('../chunk-AYA3UT4L.cjs');
 require('../chunk-3MTU2ESP.cjs');
 
 
 
 
-exports.Callback = _chunkDNLCD3K6cjs.Callback; exports.Operation = _chunkDNLCD3K6cjs.Operation; exports.Webhook = _chunkDNLCD3K6cjs.Webhook;
+exports.Callback = _chunk7BWVOLZRcjs.Callback; exports.Operation = _chunk7BWVOLZRcjs.Operation; exports.Webhook = _chunk7BWVOLZRcjs.Webhook;
 //# sourceMappingURL=index.cjs.map

package/dist/operation/index.js

@@ -2,8 +2,8 @@ import {
   Callback,
   Operation,
   Webhook
-} from "../chunk-JCBISKOK.js";
-import "../chunk-QINBUHP2.js";
+} from "../chunk-GIFUTDD5.js";
+import "../chunk-K5WNB3M7.js";
 import "../chunk-S27IGTVG.js";
 import "../chunk-PSNTODZL.js";
 export {

package/dist/reducer/index.cjs

@@ -4,7 +4,7 @@ var _chunkW6GBV2JTcjs = require('../chunk-W6GBV2JT.cjs');
 
 
 
-var _chunkX7KOY66Hcjs = require('../chunk-X7KOY66H.cjs');
+var _chunkSAB2PGCDcjs = require('../chunk-SAB2PGCD.cjs');
 require('../chunk-AYA3UT4L.cjs');
 
 
@@ -274,7 +274,7 @@ var OpenAPIReducer = (_class = class _OpenAPIReducer {
       const pathSegment = match[1];
       const method = match[2];
       if (pathSegment && method) {
-        return { path: _chunkX7KOY66Hcjs.decodePointer.call(void 0, pathSegment), method };
+        return { path: _chunkSAB2PGCDcjs.decodePointer.call(void 0, pathSegment), method };
       }
     }
     return null;
@@ -293,7 +293,7 @@ var OpenAPIReducer = (_class = class _OpenAPIReducer {
       const webhookName = match[1];
       const method = match[2];
       if (webhookName && method) {
-        return { name: _chunkX7KOY66Hcjs.decodePointer.call(void 0, webhookName), method };
+        return { name: _chunkSAB2PGCDcjs.decodePointer.call(void 0, webhookName), method };
       }
     }
     return null;
@@ -321,7 +321,7 @@ var OpenAPIReducer = (_class = class _OpenAPIReducer {
         }
       }
       Object.keys(_optionalChain([this, 'access', _23 => _23.definition, 'access', _24 => _24.paths, 'optionalAccess', _25 => _25[path]]) || {}).forEach((method) => {
-        if (method === "parameters" || !_chunkX7KOY66Hcjs.supportedMethods.includes(method.toLowerCase())) {
+        if (method === "parameters" || !_chunkSAB2PGCDcjs.supportedMethods.includes(method.toLowerCase())) {
           return;
         }
         if (this.hasPathsToReduceBy) {
@@ -395,7 +395,7 @@ var OpenAPIReducer = (_class = class _OpenAPIReducer {
         return;
       }
       Object.keys(webhook).forEach((method) => {
-        if (method === "parameters" || !_chunkX7KOY66Hcjs.supportedMethods.includes(method.toLowerCase())) {
+        if (method === "parameters" || !_chunkSAB2PGCDcjs.supportedMethods.includes(method.toLowerCase())) {
           return;
         }
         if (this.hasWebhooksToReduceBy) {
@@ -470,7 +470,7 @@ var OpenAPIReducer = (_class = class _OpenAPIReducer {
       }
       Object.keys(_optionalChain([this, 'access', _39 => _39.definition, 'access', _40 => _40.paths, 'optionalAccess', _41 => _41[path]]) || {}).forEach((method) => {
         const methodLC = method.toLowerCase();
-        if (method === "parameters" || !_chunkX7KOY66Hcjs.supportedMethods.includes(methodLC)) {
+        if (method === "parameters" || !_chunkSAB2PGCDcjs.supportedMethods.includes(methodLC)) {
           return;
         }
         const retainedByRef = this.retainPathMethods.has(`${pathLC}|${methodLC}`) || Array.from(this.$refs).some((ref) => {
@@ -555,7 +555,7 @@ var OpenAPIReducer = (_class = class _OpenAPIReducer {
       }
       Object.keys(webhook).forEach((method) => {
         const methodLC = method.toLowerCase();
-        if (method === "parameters" || !_chunkX7KOY66Hcjs.supportedMethods.includes(methodLC)) {
+        if (method === "parameters" || !_chunkSAB2PGCDcjs.supportedMethods.includes(methodLC)) {
           return;
         }
         const retainedByRef = this.retainWebhookMethods.has(`${nameLC}|${methodLC}`);

package/dist/reducer/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/erunion/code/readme/oas/packages/oas/dist/reducer/index.cjs","../../src/reducer/index.ts"],"names":[],"mappings":"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","file":"/Users/erunion/code/readme/oas/packages/oas/dist/reducer/index.cjs","sourcesContent":[null,"import type { OpenAPIV3_1 } from 'openapi-types';\nimport type { ComponentsObject, HttpMethods, OASDocument, OperationObject, TagObject } from '../types.js';\n\nimport jsonPointer from 'jsonpointer';\n\nimport { query } from '../analyzer/util.js';\nimport { decodePointer } from '../lib/refs.js';\nimport { isOpenAPI31, isRef } from '../types.js';\nimport { supportedMethods } from '../utils.js';\n\nexport class OpenAPIReducer {\n  private definition: OASDocument;\n\n  /**\n   * A collection of `$ref` pointers that are used within our reduced API definition. This is used\n   * to ensure that all referenced schemas are retained in our resulting API definition. Not\n   * retaining them would result in an invalid OpenAPI definition.\n   */\n  private $refs: Set<string> = new Set();\n\n  /**\n   * A collection of OpenAPI tags that are used within our reduced API definition.\n   */\n  private usedTags: Set<string> = new Set();\n\n  /**\n   * A collection of OpenAPI paths and operations that are cross-referenced from any other paths\n   * and operations that we are reducing. This collection is used in order to ensure that those\n   * schemas are retained with our resulting API definition. Not retaining them would result in an\n   * invalid OpenAPI definition.\n   */\n  private retainPathMethods: Set<`${string}|${string}`> = new Set();\n\n  /**\n   * A collection of OpenAPI webhook names and methods that are cross-referenced from any other\n   * schemas. This collection, like `retainPathMethods`, is used in order to ensure that those\n   * schemas are retained with our resulting API definition. Not retaining them would result in an\n   * invalid OpenAPI definition.\n   */\n  private retainWebhookMethods: Set<`${string}|${string}`> = new Set();\n\n  /**\n   * An array of OpenAPI tags to reduce down to.\n   */\n  private tagsToReduceBy: string[] = [];\n\n  /**\n   * A collection of OpenAPI paths and operations to reduce down to.\n   */\n  private pathsToReduceBy: Record<string, '*' | string[]> = {};\n\n  /**\n   * A collection of OpenAPI webhooks to reduce down to.\n   */\n  private webhooksToReduceBy: Record<string, '*' | string[]> = {};\n\n  private hasTagsToReduceBy: boolean = false;\n  private hasPathsToReduceBy: boolean = false;\n  private hasWebhooksToReduceBy: boolean = false;\n\n  private constructor(definition: OASDocument) {\n    this.definition = structuredClone(definition);\n  }\n\n  /**\n   * Initialize a new instance of the `OpenAPIReducer`. The reducer allows you to reduce an OpenAPI\n   * definition down to only the information necessary to fulfill a specific set of tags, paths,\n   * operations, and webhooks.\n   *\n   * OpenAPI reduction can be helpful not only to isolate and troubleshoot issues with large API\n   * definitions, but also to compress a large API definition down to a manageable size containing\n   * a specific set of items.\n   *\n   * All OpenAPI definitions reduced will still be fully functional and valid OpenAPI definitions.\n   *\n   * @param definition An OpenAPI definition to reduce.\n   */\n  static init(definition: OASDocument): OpenAPIReducer {\n    return new OpenAPIReducer(definition);\n  }\n\n  /**\n   * Mark an OpenAPI tag to be included in our reduced API definition. Tag casing does not matter.\n   *\n   * @param tag The tag to mark for reduction.\n   */\n  byTag(tag: string): OpenAPIReducer {\n    this.tagsToReduceBy.push(tag.toLowerCase());\n    return this;\n  }\n\n  /**\n   * Mark an entire OpenAPI path, and all methods that it contains, to be included in your reduced\n   * API definition. Path casing does not matter.\n   *\n   * @param path The path to mark for reduction.\n   */\n  byPath(path: string): OpenAPIReducer {\n    this.pathsToReduceBy[path.toLowerCase()] = '*';\n    return this;\n  }\n\n  /**\n   * Mark a single OpenAPI operation to be included in your reduced API definition. If the path\n   * that this operation is a part of utilizes common parameters, those will be automatically\n   * included. Path and method casing does not matter.\n   *\n   * Note that if you previously called `.byPath()` to reduce an entire path down, calling\n   * `.byOperation()` will override that to just reduce this specific method (or this plus\n   * subsequent calls to `.byOperation()`).\n   *\n   * @param path The path that the operation is a part of.\n   * @param method The HTTP method of the operation to mark for reduction.\n   *\n   */\n  byOperation(path: string, method: string): OpenAPIReducer {\n    const pathLC = path.toLowerCase(); // Casing should not matter.\n    const methodLC = method.toLowerCase();\n\n    if (this.pathsToReduceBy[pathLC] && Array.isArray(this.pathsToReduceBy[pathLC])) {\n      this.pathsToReduceBy[pathLC].push(methodLC);\n    } else {\n      this.pathsToReduceBy[pathLC] = [methodLC];\n    }\n\n    return this;\n  }\n\n  /**\n   * Mark an OpenAPI webhook (and all of its operations) to be included in your reduced API\n   * definition. Casing does not matter.\n   *\n   * @param webhookName The webhook name to mark for reduction.\n   */\n  byWebhook(webhookName: string): OpenAPIReducer;\n\n  /**\n   * Mark a single OpenAPI webhook operation to be included in your reduced API definition.\n   * Casing does not matter.\n   *\n   * @param webhookName The webhook name that the operation belongs to.\n   * @param method The HTTP method of the webhook operation to mark for reduction.\n   */\n  byWebhook(webhookName: string, method: string): OpenAPIReducer;\n\n  byWebhook(webhookName: string, method?: string): OpenAPIReducer {\n    const nameLC = webhookName.toLowerCase();\n    if (!method) {\n      this.webhooksToReduceBy[nameLC] = '*';\n      return this;\n    }\n\n    const methodLC = method.toLowerCase();\n    if (this.webhooksToReduceBy[nameLC] && Array.isArray(this.webhooksToReduceBy[nameLC])) {\n      this.webhooksToReduceBy[nameLC].push(methodLC);\n    } else {\n      this.webhooksToReduceBy[nameLC] = [methodLC];\n    }\n\n    return this;\n  }\n\n  /**\n   * Reduce the current OpenAPI definition down to the configured filters.\n   *\n   */\n  reduce(): OASDocument {\n    if (!this.definition.openapi) {\n      throw new Error('Sorry, only OpenAPI definitions are supported.');\n    }\n\n    this.hasPathsToReduceBy = Boolean(Object.keys(this.pathsToReduceBy).length);\n    this.hasWebhooksToReduceBy = Boolean(Object.keys(this.webhooksToReduceBy).length);\n    this.hasTagsToReduceBy = Boolean(this.tagsToReduceBy.length);\n\n    // Retain any root-level security definitions, regardless if they're used or not on our reduced\n    // operations.\n    if ('security' in this.definition) {\n      Object.values(this.definition.security || {}).forEach(sec => {\n        Object.keys(sec).forEach(scheme => {\n          this.$refs.add(`#/components/securitySchemes/${scheme}`);\n        });\n      });\n    }\n\n    this.walkPaths();\n    this.walkWebhooks();\n\n    // Recursively accumulate any components that are in use.\n    this.$refs.forEach($ref => {\n      this.accumulateUsedRefs(this.definition, this.$refs, $ref);\n    });\n\n    this.$refs.forEach(ref => {\n      const usedPathRef = this.parsePathRef(ref);\n      if (usedPathRef) {\n        this.retainPathMethods.add(`${usedPathRef.path.toLowerCase()}|${usedPathRef.method.toLowerCase()}`);\n      }\n\n      const usedWebhookRef = this.parseWebhookRef(ref);\n      if (usedWebhookRef) {\n        this.retainWebhookMethods.add(`${usedWebhookRef.name.toLowerCase()}|${usedWebhookRef.method.toLowerCase()}`);\n      }\n    });\n\n    this.reducePaths();\n    this.reduceWebhooks();\n\n    // Require at least one path or one webhook in the result.\n    const hasPaths = Boolean(this.definition.paths && Object.keys(this.definition.paths).length);\n    const hasWebhooks = Boolean(\n      'webhooks' in this.definition && this.definition.webhooks && Object.keys(this.definition.webhooks).length,\n    );\n\n    if (!hasPaths && !hasWebhooks) {\n      throw new Error(\n        'All paths and webhooks in the API definition were removed. Did you supply the right path, operation, or webhook to reduce by?',\n      );\n    }\n\n    // Remove any unused components.\n    if ('components' in this.definition) {\n      Object.keys(this.definition.components || {}).forEach(componentType => {\n        Object.keys(this.definition.components?.[componentType as keyof ComponentsObject] || {}).forEach(component => {\n          // If our `$ref` either is a full, or deep match, then we should preserve it.\n          const refIsUsed =\n            this.$refs.has(`#/components/${componentType}/${component}`) ||\n            Array.from(this.$refs).some(ref => {\n              // Because you can have a `$ref` like `#/components/examples/event-min/value`, which\n              // would be accumulated via our `$refs` query, we want to make sure we account for them.\n              // If we don't look for these then we'll end up removing them from the overall reduced\n              // definition, resulting in data loss and schema corruption.\n              return ref.startsWith(`#/components/${componentType}/${component}/`);\n            });\n\n          if (!refIsUsed) {\n            delete this.definition.components?.[componentType as keyof ComponentsObject]?.[component];\n          }\n        });\n\n        // If this component group is now empty, delete it.\n        if (!Object.keys(this.definition.components?.[componentType as keyof ComponentsObject] || {}).length) {\n          delete this.definition.components?.[componentType as keyof ComponentsObject];\n        }\n      });\n\n      // If this path no longer has any components, delete it.\n      if (!Object.keys(this.definition.components || {}).length) {\n        delete this.definition.components;\n      }\n    }\n\n    // Remove any unused tags.\n    if ('tags' in this.definition) {\n      this.definition.tags = (this.definition.tags ?? []).filter((tag): tag is TagObject => {\n        return Boolean(tag) && this.usedTags.has(tag.name);\n      });\n\n      if (!this.definition.tags?.length) {\n        delete this.definition.tags;\n      }\n    }\n\n    return this.definition;\n  }\n\n  /**\n   * Recursively process a `$ref` pointer and accumulate any other `$ref` pointers that it or its\n   * children use. This handles circular references by skipping `$ref` pointers we have already seen.\n   * Additionally when a `$ref` points to `#/paths` we record the used path + method so we can\n   * retain cross-operation references within the reduced definition.\n   *\n   * @param schema JSON Schema object to look for and accumulate any `$ref` pointers that it may have.\n   * @param $refs Known set of `$ref` pointers.\n   * @param $ref `$ref` pointer to fetch a schema from out of the supplied schema.\n   */\n  private accumulateUsedRefs(schema: Record<string, unknown>, $refs: Set<string>, $ref: string): void {\n    // Record `$ref` pointers aimed at `#/paths` so we can retain any cross-operation references.\n    const pathRef = this.parsePathRef($ref);\n    if (pathRef) {\n      this.retainPathMethods.add(`${pathRef.path.toLowerCase()}|${pathRef.method.toLowerCase()}`);\n    }\n\n    const webhookRef = this.parseWebhookRef($ref);\n    if (webhookRef) {\n      this.retainWebhookMethods.add(`${webhookRef.name.toLowerCase()}|${webhookRef.method.toLowerCase()}`);\n    }\n\n    let $refSchema: unknown;\n    if (typeof $ref === 'string') $refSchema = jsonPointer.get(schema, $ref.substring(1));\n    if ($refSchema === undefined) {\n      // If the schema we have wasn't fully dereferenced or bundled for whatever reason and this\n      // `$ref` that we have doesn't exist here we shouldn't try to search for more `$ref` pointers\n      // in a schema that doesn't exist.\n      return;\n    }\n\n    this.queryForRefPointers($refSchema).forEach(({ value: currRef }) => {\n      // Because it's possible to have a schema property named `$ref` that is not a `$ref` pointer,\n      // which our JSONPath query would pick up as a false positive, we want to exclude that from\n      // `$ref` matching as it's not a reference pointer.\n      const foundRef = this.toRefString(currRef);\n      if (!foundRef) {\n        return;\n      }\n\n      // If we've already processed this `$ref` then don't send us into an infinite loop of processing\n      // circular references.\n      if ($refs.has(foundRef)) {\n        return;\n      }\n\n      $refs.add(foundRef);\n      this.accumulateUsedRefs(schema, $refs, foundRef);\n    });\n  }\n\n  /**\n   * Query a JSON Schema object for any `$ref` pointers using JSONPath and return any pointers that\n   * exist.\n   *\n   * @see {@link https://datatracker.ietf.org/doc/html/rfc9535}\n   * @param schema JSON Schema object to look for any `$ref` pointers within it.\n   */\n  private queryForRefPointers(schema: any) {\n    return query([\"$..['$ref']\"], schema);\n  }\n\n  /**\n   * Normalize a value from a `jsonpath-plus` `$ref` query to a `$ref` pointer because JSONPath\n   * queries may return the property value or the parent.\n   *\n   */\n  private toRefString(value: unknown): string | null {\n    if (typeof value === 'string') {\n      return value;\n    } else if (value && typeof value === 'object' && '$ref' in value && typeof value.$ref === 'string') {\n      return value.$ref;\n    }\n\n    return null;\n  }\n\n  /**\n   * If the given `$ref` points into a path (e.g. `#/paths/~1anything/post/...`), return the path\n   * and method so the reducer can ultimately retain cross-operation references.\n   *\n   */\n  private parsePathRef($ref: string): { path: string; method: string } | null {\n    if (typeof $ref !== 'string' || !$ref.startsWith('#/paths/')) {\n      return null;\n    }\n\n    // Extract path segment and method: `#/paths/<pathSegment>/<method>/...`\n    const match = $ref.match(/^#\\/paths\\/([^/]+)\\/([^/]+)(?:\\/|$)/);\n    if (match) {\n      const pathSegment = match[1];\n      const method = match[2];\n      if (pathSegment && method) {\n        return { path: decodePointer(pathSegment), method };\n      }\n    }\n\n    return null;\n  }\n\n  /**\n   * If the given `$ref` points into webhooks (e.g. `#/webhooks/newBooking/post/...`), return the\n   * webhook name and method so the reducer can retain cross-referenced webhook operations.\n   *\n   */\n  private parseWebhookRef($ref: string): { name: string; method: string } | null {\n    if (typeof $ref !== 'string' || !$ref.startsWith('#/webhooks/')) {\n      return null;\n    }\n\n    // Extract path segment and method: `#/webhooks/<webhookName>/<method>/...`\n    const match = $ref.match(/^#\\/webhooks\\/([^/]+)\\/([^/]+)(?:\\/|$)/);\n    if (match) {\n      const webhookName = match[1];\n      const method = match[2];\n      if (webhookName && method) {\n        return { name: decodePointer(webhookName), method };\n      }\n    }\n\n    return null;\n  }\n\n  /**\n   * Walk through the `paths` in our OpenAPI definition and reduce down any that we know we do not\n   * want to keep and accumulate any `$ref` pointers that we find that may be cross-referenced in\n   * paths, webhooks, operations, and schemas that we _do_ want to keep.\n   *\n   */\n  private walkPaths(): void {\n    if (!('paths' in this.definition) || !this.definition.paths) {\n      return;\n    }\n\n    Object.keys(this.definition.paths).forEach(path => {\n      const pathLC = path.toLowerCase();\n\n      // When only webhooks were requested (no path/operation filter), remove all paths.\n      if (this.hasWebhooksToReduceBy && !this.hasPathsToReduceBy) {\n        delete this.definition.paths?.[path];\n        return;\n      }\n\n      if (this.hasPathsToReduceBy) {\n        if (!(pathLC in this.pathsToReduceBy)) {\n          delete this.definition.paths?.[path];\n          return;\n        }\n      }\n\n      Object.keys(this.definition.paths?.[path] || {}).forEach(method => {\n        // Only process operations and retain any common path-level common properties like\n        // `parameters`, `servers`, `summary`, etc.\n        if (method === 'parameters' || !supportedMethods.includes(method.toLowerCase() as HttpMethods)) {\n          return;\n        }\n\n        if (this.hasPathsToReduceBy) {\n          // If we have paths we want to reduce but this isn't part of our filter set, then ignore.\n          // We'll remove it later.\n          if (\n            this.pathsToReduceBy[pathLC] !== '*' &&\n            Array.isArray(this.pathsToReduceBy[pathLC]) &&\n            !this.pathsToReduceBy[pathLC].includes(method.toLowerCase())\n          ) {\n            return;\n          }\n        }\n\n        const operation = this.definition.paths?.[path]?.[method as HttpMethods] as OperationObject;\n        if (!operation) {\n          throw new Error(`Operation \\`${method} ${path}\\` not found`);\n        }\n\n        if (this.hasTagsToReduceBy) {\n          // If this endpoint either has no tags or none that we want to preseve, then prune it.\n          if (!(operation.tags || []).filter(tag => this.tagsToReduceBy.includes(tag.toLowerCase())).length) {\n            return;\n          }\n        }\n\n        (operation.tags || []).forEach((tag: string) => {\n          this.usedTags.add(tag);\n        });\n\n        // Skipped by the `method === 'parameters'` guard above; accumulate here so refs are only\n        // retained when at least one operation on this path passes all filters.\n        const pathLevelParams = this.definition.paths?.[path]?.parameters;\n        if (pathLevelParams) {\n          this.queryForRefPointers(pathLevelParams).forEach(({ value: ref }) => {\n            const refStr = this.toRefString(ref);\n            if (!refStr) {\n              return;\n            }\n\n            this.$refs.add(refStr);\n            this.accumulateUsedRefs(this.definition, this.$refs, refStr);\n          });\n        }\n\n        this.queryForRefPointers(operation).forEach(({ value: ref }) => {\n          const refStr = this.toRefString(ref);\n          if (!refStr) {\n            return;\n          }\n\n          this.$refs.add(refStr);\n\n          // If this operation has a cross-operation `$ref` pointer then we need to track it so\n          // it's retained.\n          const pathRef = this.parsePathRef(refStr);\n          if (pathRef) {\n            this.retainPathMethods.add(`${pathRef.path.toLowerCase()}|${pathRef.method.toLowerCase()}`);\n          }\n\n          // Re-run through any `$ref` pointers that we found within this operation and search for\n          // any `$ref` pointers that they also may be using.\n          this.accumulateUsedRefs(this.definition, this.$refs, refStr);\n        });\n\n        Object.values(operation.security || {}).forEach(sec => {\n          Object.keys(sec).forEach(scheme => {\n            this.$refs.add(`#/components/securitySchemes/${scheme}`);\n          });\n        });\n      });\n    });\n  }\n\n  /**\n   * Walk through the `webhooks` in our OpenAPI definition and reduce down any that we know we do\n   * not want to keep and accumulate any `$ref` pointers that we find that may be cross-referenced\n   * in paths, operations, and schemas that we _do_ want to keep.\n   *\n   */\n  private walkWebhooks() {\n    if (!isOpenAPI31(this.definition)) {\n      return;\n    } else if (!('webhooks' in this.definition) || !this.definition.webhooks) {\n      return;\n    }\n\n    const definition = this.definition satisfies OpenAPIV3_1.Document;\n\n    Object.keys(definition.webhooks || {}).forEach(webhookName => {\n      const nameLC = webhookName.toLowerCase();\n      if (this.hasWebhooksToReduceBy && !(nameLC in this.webhooksToReduceBy)) {\n        return;\n      }\n\n      const webhook = definition.webhooks?.[webhookName];\n      if (!webhook || typeof webhook !== 'object') {\n        return;\n      }\n\n      Object.keys(webhook).forEach(method => {\n        // Only process operations and retain any common path-level common properties like\n        // `parameters`, `servers`, `summary`, etc.\n        if (method === 'parameters' || !supportedMethods.includes(method.toLowerCase() as HttpMethods)) {\n          return;\n        }\n\n        if (this.hasWebhooksToReduceBy) {\n          // If we have webhooks we want to reduce but this isn't part of our filter set, then\n          // ignore. We'll remove it later.\n          const methodFilter = this.webhooksToReduceBy[nameLC];\n          if (methodFilter !== '*' && Array.isArray(methodFilter) && !methodFilter.includes(method.toLowerCase())) {\n            return;\n          }\n        }\n\n        /**\n         * If this webhook path item is a `$ref` then ignore it.\n         * @fixme we should better support reducing this.\n         */\n        if (isRef(webhook)) {\n          return;\n        }\n\n        const operation = webhook[method as HttpMethods] as OperationObject;\n        if (!operation) {\n          return;\n        }\n\n        if (this.hasTagsToReduceBy) {\n          // If this operation either has no tags or none that we want to preseve, then prune it.\n          if (!(operation.tags || []).filter(tag => this.tagsToReduceBy.includes(tag.toLowerCase())).length) {\n            return;\n          }\n        }\n\n        (operation.tags || []).forEach((tag: string) => {\n          this.usedTags.add(tag);\n        });\n\n        // Skipped by the `method === 'parameters'` guard above; accumulate here so refs are only\n        // retained when at least one operation on this webhook passes all filters.\n        if (webhook.parameters) {\n          this.queryForRefPointers(webhook.parameters).forEach(({ value: ref }) => {\n            const refStr = this.toRefString(ref);\n            if (!refStr) {\n              return;\n            }\n\n            this.$refs.add(refStr);\n            this.accumulateUsedRefs(definition, this.$refs, refStr);\n          });\n        }\n\n        this.queryForRefPointers(operation).forEach(({ value: ref }) => {\n          const refStr = this.toRefString(ref);\n          if (!refStr) {\n            return;\n          }\n\n          this.$refs.add(refStr);\n          const pathRef = this.parsePathRef(refStr);\n          if (pathRef) {\n            this.retainPathMethods.add(`${pathRef.path.toLowerCase()}|${pathRef.method.toLowerCase()}`);\n          }\n\n          const webhookRef = this.parseWebhookRef(refStr);\n          if (webhookRef) {\n            this.retainWebhookMethods.add(`${webhookRef.name.toLowerCase()}|${webhookRef.method.toLowerCase()}`);\n          }\n\n          this.accumulateUsedRefs(definition, this.$refs, refStr);\n        });\n\n        Object.values(operation.security || {}).forEach(sec => {\n          Object.keys(sec).forEach(scheme => {\n            this.$refs.add(`#/components/securitySchemes/${scheme}`);\n          });\n        });\n      });\n    });\n  }\n\n  /**\n   * Prune back our `paths` object in the OpenAPI definition to only include paths that we want to\n   * preserve.\n   *\n   */\n  private reducePaths(): void {\n    if (!('paths' in this.definition) || !this.definition.paths) {\n      return;\n    }\n\n    Object.keys(this.definition.paths).forEach(path => {\n      const pathLC = path.toLowerCase();\n\n      if (this.hasPathsToReduceBy && !(pathLC in this.pathsToReduceBy)) {\n        delete this.definition.paths?.[path];\n        return;\n      }\n\n      Object.keys(this.definition.paths?.[path] || {}).forEach(method => {\n        const methodLC = method.toLowerCase();\n\n        // Only process operations and retain any common path-level common properties like\n        // `parameters`, `servers`, `summary`, etc.\n        if (method === 'parameters' || !supportedMethods.includes(methodLC as HttpMethods)) {\n          return;\n        }\n\n        const retainedByRef =\n          this.retainPathMethods.has(`${pathLC}|${methodLC}`) ||\n          Array.from(this.$refs).some(ref => {\n            const pathRef = this.parsePathRef(ref);\n            return pathRef?.path.toLowerCase() === pathLC && pathRef?.method.toLowerCase() === methodLC;\n          });\n\n        if (methodLC !== 'parameters') {\n          // If we're reducing paths and this operation isn't part of our filter set, and it's\n          // not a cross-referenced operation that we want to retain, then we should prune it.\n          if (this.hasPathsToReduceBy) {\n            if (\n              !retainedByRef &&\n              this.pathsToReduceBy[pathLC] !== '*' &&\n              Array.isArray(this.pathsToReduceBy[pathLC]) &&\n              !this.pathsToReduceBy[pathLC].includes(methodLC)\n            ) {\n              delete this.definition.paths?.[path]?.[method as HttpMethods];\n              return;\n            }\n          }\n        }\n\n        const operation = this.definition.paths?.[path]?.[method as HttpMethods];\n        if (!operation) {\n          throw new Error(`Operation \\`${method} ${path}\\` not found`);\n        }\n\n        // If we're reducing by tags and this operation doesn't live in one of those, remove it.\n        if (this.hasTagsToReduceBy) {\n          // If this operation doesn't have any tags that we want to preserve, and it isn't\n          // cross-referenced from an operation we _do_ want to preserve, then remove it.\n          if (!(operation.tags || []).filter(tag => this.tagsToReduceBy.includes(tag.toLowerCase())).length) {\n            if (!retainedByRef) {\n              delete this.definition.paths?.[path]?.[method as HttpMethods];\n            }\n\n            return;\n          }\n        }\n\n        // Accumulate a list of used tags so we can filter out any ones that we don't need later.\n        if ('tags' in operation) {\n          operation.tags?.forEach((tag: string) => {\n            this.usedTags.add(tag);\n          });\n        }\n\n        // Accumulate any used operation-level security schemas that we need to retain.\n        if ('security' in operation) {\n          Object.values(operation.security || {}).forEach(sec => {\n            Object.keys(sec).forEach(scheme => {\n              this.$refs.add(`#/components/securitySchemes/${scheme}`);\n            });\n          });\n        }\n      });\n\n      // If this path no longer has any methods, delete it.\n      if (!Object.keys(this.definition.paths?.[path] || {}).length) {\n        delete this.definition.paths?.[path];\n      }\n    });\n\n    // If we don't have any more paths after cleanup, and we don't have any webhooks, then throw\n    // an error because an OpenAPI definition must have at least one path.\n    if (!Object.keys(this.definition.paths || {}).length) {\n      if (!(this.definition.webhooks && Object.keys(this.definition.webhooks).length)) {\n        throw new Error(\n          'All paths in the API definition were removed. Did you supply the right path name to reduce by?',\n        );\n      }\n\n      delete this.definition.paths;\n    }\n  }\n\n  /**\n   * Prune back our `webhooks` object in the OpenAPI definition to only include webhooks that we\n   * want to preserve.\n   *\n   */\n  private reduceWebhooks(): void {\n    if (!isOpenAPI31(this.definition)) {\n      return;\n    } else if (!('webhooks' in this.definition) || !this.definition.webhooks) {\n      return;\n    }\n\n    const definition = this.definition satisfies OpenAPIV3_1.Document;\n\n    Object.keys(definition.webhooks || {}).forEach(webhookName => {\n      const nameLC = webhookName.toLowerCase();\n      if (this.hasWebhooksToReduceBy && !(nameLC in this.webhooksToReduceBy)) {\n        const retainedByRef = Array.from(this.retainWebhookMethods).some(\n          key => key.startsWith(`${nameLC}|`) || key === `${nameLC}|`,\n        );\n\n        if (!retainedByRef) {\n          delete definition.webhooks?.[webhookName];\n          return;\n        }\n      }\n\n      const webhook = definition.webhooks?.[webhookName];\n      if (!webhook || typeof webhook !== 'object') {\n        return;\n      }\n\n      /**\n       * If this webhook path item is a `$ref` then ignore it.\n       * @fixme we should better support reducing this.\n       */\n      if (isRef(webhook)) {\n        return;\n      }\n\n      Object.keys(webhook).forEach(method => {\n        const methodLC = method.toLowerCase();\n        if (method === 'parameters' || !supportedMethods.includes(methodLC as HttpMethods)) {\n          return;\n        }\n\n        const retainedByRef = this.retainWebhookMethods.has(`${nameLC}|${methodLC}`);\n        if (this.hasWebhooksToReduceBy && !retainedByRef) {\n          const methodFilter = this.webhooksToReduceBy[nameLC];\n          if (methodFilter !== '*' && Array.isArray(methodFilter) && !methodFilter.includes(methodLC)) {\n            /**\n             * If this webhook path item is a `$ref` then ignore and retain it.\n             * @fixme we should better support reducing this.\n             */\n            if (!definition.webhooks?.[webhookName] || isRef(definition.webhooks?.[webhookName])) {\n              return;\n            }\n\n            delete definition.webhooks?.[webhookName]?.[method as HttpMethods];\n          }\n        }\n      });\n\n      if (!Object.keys(definition.webhooks?.[webhookName] || {}).length) {\n        delete definition.webhooks?.[webhookName];\n      }\n    });\n\n    if (definition.webhooks && !Object.keys(definition.webhooks).length) {\n      delete definition.webhooks;\n    }\n  }\n}\n"]}
+{"version":3,"sources":["/Users/erunion/code/readme/oas/packages/oas/dist/reducer/index.cjs","../../src/reducer/index.ts"],"names":[],"mappings":"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","file":"/Users/erunion/code/readme/oas/packages/oas/dist/reducer/index.cjs","sourcesContent":[null,"import type { ComponentsObject, HttpMethods, OASDocument, OperationObject, TagObject } from '../types.js';\nimport type { OpenAPIV3_1 } from 'openapi-types';\n\nimport jsonPointer from 'jsonpointer';\n\nimport { query } from '../analyzer/util.js';\nimport { decodePointer } from '../lib/refs.js';\nimport { isOpenAPI31, isRef } from '../types.js';\nimport { supportedMethods } from '../utils.js';\n\nexport class OpenAPIReducer {\n  private definition: OASDocument;\n\n  /**\n   * A collection of `$ref` pointers that are used within our reduced API definition. This is used\n   * to ensure that all referenced schemas are retained in our resulting API definition. Not\n   * retaining them would result in an invalid OpenAPI definition.\n   */\n  private $refs: Set<string> = new Set();\n\n  /**\n   * A collection of OpenAPI tags that are used within our reduced API definition.\n   */\n  private usedTags: Set<string> = new Set();\n\n  /**\n   * A collection of OpenAPI paths and operations that are cross-referenced from any other paths\n   * and operations that we are reducing. This collection is used in order to ensure that those\n   * schemas are retained with our resulting API definition. Not retaining them would result in an\n   * invalid OpenAPI definition.\n   */\n  private retainPathMethods: Set<`${string}|${string}`> = new Set();\n\n  /**\n   * A collection of OpenAPI webhook names and methods that are cross-referenced from any other\n   * schemas. This collection, like `retainPathMethods`, is used in order to ensure that those\n   * schemas are retained with our resulting API definition. Not retaining them would result in an\n   * invalid OpenAPI definition.\n   */\n  private retainWebhookMethods: Set<`${string}|${string}`> = new Set();\n\n  /**\n   * An array of OpenAPI tags to reduce down to.\n   */\n  private tagsToReduceBy: string[] = [];\n\n  /**\n   * A collection of OpenAPI paths and operations to reduce down to.\n   */\n  private pathsToReduceBy: Record<string, '*' | string[]> = {};\n\n  /**\n   * A collection of OpenAPI webhooks to reduce down to.\n   */\n  private webhooksToReduceBy: Record<string, '*' | string[]> = {};\n\n  private hasTagsToReduceBy: boolean = false;\n  private hasPathsToReduceBy: boolean = false;\n  private hasWebhooksToReduceBy: boolean = false;\n\n  private constructor(definition: OASDocument) {\n    this.definition = structuredClone(definition);\n  }\n\n  /**\n   * Initialize a new instance of the `OpenAPIReducer`. The reducer allows you to reduce an OpenAPI\n   * definition down to only the information necessary to fulfill a specific set of tags, paths,\n   * operations, and webhooks.\n   *\n   * OpenAPI reduction can be helpful not only to isolate and troubleshoot issues with large API\n   * definitions, but also to compress a large API definition down to a manageable size containing\n   * a specific set of items.\n   *\n   * All OpenAPI definitions reduced will still be fully functional and valid OpenAPI definitions.\n   *\n   * @param definition An OpenAPI definition to reduce.\n   */\n  static init(definition: OASDocument): OpenAPIReducer {\n    return new OpenAPIReducer(definition);\n  }\n\n  /**\n   * Mark an OpenAPI tag to be included in our reduced API definition. Tag casing does not matter.\n   *\n   * @param tag The tag to mark for reduction.\n   */\n  byTag(tag: string): OpenAPIReducer {\n    this.tagsToReduceBy.push(tag.toLowerCase());\n    return this;\n  }\n\n  /**\n   * Mark an entire OpenAPI path, and all methods that it contains, to be included in your reduced\n   * API definition. Path casing does not matter.\n   *\n   * @param path The path to mark for reduction.\n   */\n  byPath(path: string): OpenAPIReducer {\n    this.pathsToReduceBy[path.toLowerCase()] = '*';\n    return this;\n  }\n\n  /**\n   * Mark a single OpenAPI operation to be included in your reduced API definition. If the path\n   * that this operation is a part of utilizes common parameters, those will be automatically\n   * included. Path and method casing does not matter.\n   *\n   * Note that if you previously called `.byPath()` to reduce an entire path down, calling\n   * `.byOperation()` will override that to just reduce this specific method (or this plus\n   * subsequent calls to `.byOperation()`).\n   *\n   * @param path The path that the operation is a part of.\n   * @param method The HTTP method of the operation to mark for reduction.\n   *\n   */\n  byOperation(path: string, method: string): OpenAPIReducer {\n    const pathLC = path.toLowerCase(); // Casing should not matter.\n    const methodLC = method.toLowerCase();\n\n    if (this.pathsToReduceBy[pathLC] && Array.isArray(this.pathsToReduceBy[pathLC])) {\n      this.pathsToReduceBy[pathLC].push(methodLC);\n    } else {\n      this.pathsToReduceBy[pathLC] = [methodLC];\n    }\n\n    return this;\n  }\n\n  /**\n   * Mark an OpenAPI webhook (and all of its operations) to be included in your reduced API\n   * definition. Casing does not matter.\n   *\n   * @param webhookName The webhook name to mark for reduction.\n   */\n  byWebhook(webhookName: string): OpenAPIReducer;\n\n  /**\n   * Mark a single OpenAPI webhook operation to be included in your reduced API definition.\n   * Casing does not matter.\n   *\n   * @param webhookName The webhook name that the operation belongs to.\n   * @param method The HTTP method of the webhook operation to mark for reduction.\n   */\n  byWebhook(webhookName: string, method: string): OpenAPIReducer;\n\n  byWebhook(webhookName: string, method?: string): OpenAPIReducer {\n    const nameLC = webhookName.toLowerCase();\n    if (!method) {\n      this.webhooksToReduceBy[nameLC] = '*';\n      return this;\n    }\n\n    const methodLC = method.toLowerCase();\n    if (this.webhooksToReduceBy[nameLC] && Array.isArray(this.webhooksToReduceBy[nameLC])) {\n      this.webhooksToReduceBy[nameLC].push(methodLC);\n    } else {\n      this.webhooksToReduceBy[nameLC] = [methodLC];\n    }\n\n    return this;\n  }\n\n  /**\n   * Reduce the current OpenAPI definition down to the configured filters.\n   *\n   */\n  reduce(): OASDocument {\n    if (!this.definition.openapi) {\n      throw new Error('Sorry, only OpenAPI definitions are supported.');\n    }\n\n    this.hasPathsToReduceBy = Boolean(Object.keys(this.pathsToReduceBy).length);\n    this.hasWebhooksToReduceBy = Boolean(Object.keys(this.webhooksToReduceBy).length);\n    this.hasTagsToReduceBy = Boolean(this.tagsToReduceBy.length);\n\n    // Retain any root-level security definitions, regardless if they're used or not on our reduced\n    // operations.\n    if ('security' in this.definition) {\n      Object.values(this.definition.security || {}).forEach(sec => {\n        Object.keys(sec).forEach(scheme => {\n          this.$refs.add(`#/components/securitySchemes/${scheme}`);\n        });\n      });\n    }\n\n    this.walkPaths();\n    this.walkWebhooks();\n\n    // Recursively accumulate any components that are in use.\n    this.$refs.forEach($ref => {\n      this.accumulateUsedRefs(this.definition, this.$refs, $ref);\n    });\n\n    this.$refs.forEach(ref => {\n      const usedPathRef = this.parsePathRef(ref);\n      if (usedPathRef) {\n        this.retainPathMethods.add(`${usedPathRef.path.toLowerCase()}|${usedPathRef.method.toLowerCase()}`);\n      }\n\n      const usedWebhookRef = this.parseWebhookRef(ref);\n      if (usedWebhookRef) {\n        this.retainWebhookMethods.add(`${usedWebhookRef.name.toLowerCase()}|${usedWebhookRef.method.toLowerCase()}`);\n      }\n    });\n\n    this.reducePaths();\n    this.reduceWebhooks();\n\n    // Require at least one path or one webhook in the result.\n    const hasPaths = Boolean(this.definition.paths && Object.keys(this.definition.paths).length);\n    const hasWebhooks = Boolean(\n      'webhooks' in this.definition && this.definition.webhooks && Object.keys(this.definition.webhooks).length,\n    );\n\n    if (!hasPaths && !hasWebhooks) {\n      throw new Error(\n        'All paths and webhooks in the API definition were removed. Did you supply the right path, operation, or webhook to reduce by?',\n      );\n    }\n\n    // Remove any unused components.\n    if ('components' in this.definition) {\n      Object.keys(this.definition.components || {}).forEach(componentType => {\n        Object.keys(this.definition.components?.[componentType as keyof ComponentsObject] || {}).forEach(component => {\n          // If our `$ref` either is a full, or deep match, then we should preserve it.\n          const refIsUsed =\n            this.$refs.has(`#/components/${componentType}/${component}`) ||\n            Array.from(this.$refs).some(ref => {\n              // Because you can have a `$ref` like `#/components/examples/event-min/value`, which\n              // would be accumulated via our `$refs` query, we want to make sure we account for them.\n              // If we don't look for these then we'll end up removing them from the overall reduced\n              // definition, resulting in data loss and schema corruption.\n              return ref.startsWith(`#/components/${componentType}/${component}/`);\n            });\n\n          if (!refIsUsed) {\n            delete this.definition.components?.[componentType as keyof ComponentsObject]?.[component];\n          }\n        });\n\n        // If this component group is now empty, delete it.\n        if (!Object.keys(this.definition.components?.[componentType as keyof ComponentsObject] || {}).length) {\n          delete this.definition.components?.[componentType as keyof ComponentsObject];\n        }\n      });\n\n      // If this path no longer has any components, delete it.\n      if (!Object.keys(this.definition.components || {}).length) {\n        delete this.definition.components;\n      }\n    }\n\n    // Remove any unused tags.\n    if ('tags' in this.definition) {\n      this.definition.tags = (this.definition.tags ?? []).filter((tag): tag is TagObject => {\n        return Boolean(tag) && this.usedTags.has(tag.name);\n      });\n\n      if (!this.definition.tags?.length) {\n        delete this.definition.tags;\n      }\n    }\n\n    return this.definition;\n  }\n\n  /**\n   * Recursively process a `$ref` pointer and accumulate any other `$ref` pointers that it or its\n   * children use. This handles circular references by skipping `$ref` pointers we have already seen.\n   * Additionally when a `$ref` points to `#/paths` we record the used path + method so we can\n   * retain cross-operation references within the reduced definition.\n   *\n   * @param schema JSON Schema object to look for and accumulate any `$ref` pointers that it may have.\n   * @param $refs Known set of `$ref` pointers.\n   * @param $ref `$ref` pointer to fetch a schema from out of the supplied schema.\n   */\n  private accumulateUsedRefs(schema: Record<string, unknown>, $refs: Set<string>, $ref: string): void {\n    // Record `$ref` pointers aimed at `#/paths` so we can retain any cross-operation references.\n    const pathRef = this.parsePathRef($ref);\n    if (pathRef) {\n      this.retainPathMethods.add(`${pathRef.path.toLowerCase()}|${pathRef.method.toLowerCase()}`);\n    }\n\n    const webhookRef = this.parseWebhookRef($ref);\n    if (webhookRef) {\n      this.retainWebhookMethods.add(`${webhookRef.name.toLowerCase()}|${webhookRef.method.toLowerCase()}`);\n    }\n\n    let $refSchema: unknown;\n    if (typeof $ref === 'string') $refSchema = jsonPointer.get(schema, $ref.substring(1));\n    if ($refSchema === undefined) {\n      // If the schema we have wasn't fully dereferenced or bundled for whatever reason and this\n      // `$ref` that we have doesn't exist here we shouldn't try to search for more `$ref` pointers\n      // in a schema that doesn't exist.\n      return;\n    }\n\n    this.queryForRefPointers($refSchema).forEach(({ value: currRef }) => {\n      // Because it's possible to have a schema property named `$ref` that is not a `$ref` pointer,\n      // which our JSONPath query would pick up as a false positive, we want to exclude that from\n      // `$ref` matching as it's not a reference pointer.\n      const foundRef = this.toRefString(currRef);\n      if (!foundRef) {\n        return;\n      }\n\n      // If we've already processed this `$ref` then don't send us into an infinite loop of processing\n      // circular references.\n      if ($refs.has(foundRef)) {\n        return;\n      }\n\n      $refs.add(foundRef);\n      this.accumulateUsedRefs(schema, $refs, foundRef);\n    });\n  }\n\n  /**\n   * Query a JSON Schema object for any `$ref` pointers using JSONPath and return any pointers that\n   * exist.\n   *\n   * @see {@link https://datatracker.ietf.org/doc/html/rfc9535}\n   * @param schema JSON Schema object to look for any `$ref` pointers within it.\n   */\n  private queryForRefPointers(schema: any) {\n    return query([\"$..['$ref']\"], schema);\n  }\n\n  /**\n   * Normalize a value from a `jsonpath-plus` `$ref` query to a `$ref` pointer because JSONPath\n   * queries may return the property value or the parent.\n   *\n   */\n  private toRefString(value: unknown): string | null {\n    if (typeof value === 'string') {\n      return value;\n    } else if (value && typeof value === 'object' && '$ref' in value && typeof value.$ref === 'string') {\n      return value.$ref;\n    }\n\n    return null;\n  }\n\n  /**\n   * If the given `$ref` points into a path (e.g. `#/paths/~1anything/post/...`), return the path\n   * and method so the reducer can ultimately retain cross-operation references.\n   *\n   */\n  private parsePathRef($ref: string): { path: string; method: string } | null {\n    if (typeof $ref !== 'string' || !$ref.startsWith('#/paths/')) {\n      return null;\n    }\n\n    // Extract path segment and method: `#/paths/<pathSegment>/<method>/...`\n    const match = $ref.match(/^#\\/paths\\/([^/]+)\\/([^/]+)(?:\\/|$)/);\n    if (match) {\n      const pathSegment = match[1];\n      const method = match[2];\n      if (pathSegment && method) {\n        return { path: decodePointer(pathSegment), method };\n      }\n    }\n\n    return null;\n  }\n\n  /**\n   * If the given `$ref` points into webhooks (e.g. `#/webhooks/newBooking/post/...`), return the\n   * webhook name and method so the reducer can retain cross-referenced webhook operations.\n   *\n   */\n  private parseWebhookRef($ref: string): { name: string; method: string } | null {\n    if (typeof $ref !== 'string' || !$ref.startsWith('#/webhooks/')) {\n      return null;\n    }\n\n    // Extract path segment and method: `#/webhooks/<webhookName>/<method>/...`\n    const match = $ref.match(/^#\\/webhooks\\/([^/]+)\\/([^/]+)(?:\\/|$)/);\n    if (match) {\n      const webhookName = match[1];\n      const method = match[2];\n      if (webhookName && method) {\n        return { name: decodePointer(webhookName), method };\n      }\n    }\n\n    return null;\n  }\n\n  /**\n   * Walk through the `paths` in our OpenAPI definition and reduce down any that we know we do not\n   * want to keep and accumulate any `$ref` pointers that we find that may be cross-referenced in\n   * paths, webhooks, operations, and schemas that we _do_ want to keep.\n   *\n   */\n  private walkPaths(): void {\n    if (!('paths' in this.definition) || !this.definition.paths) {\n      return;\n    }\n\n    Object.keys(this.definition.paths).forEach(path => {\n      const pathLC = path.toLowerCase();\n\n      // When only webhooks were requested (no path/operation filter), remove all paths.\n      if (this.hasWebhooksToReduceBy && !this.hasPathsToReduceBy) {\n        delete this.definition.paths?.[path];\n        return;\n      }\n\n      if (this.hasPathsToReduceBy) {\n        if (!(pathLC in this.pathsToReduceBy)) {\n          delete this.definition.paths?.[path];\n          return;\n        }\n      }\n\n      Object.keys(this.definition.paths?.[path] || {}).forEach(method => {\n        // Only process operations and retain any common path-level common properties like\n        // `parameters`, `servers`, `summary`, etc.\n        if (method === 'parameters' || !supportedMethods.includes(method.toLowerCase() as HttpMethods)) {\n          return;\n        }\n\n        if (this.hasPathsToReduceBy) {\n          // If we have paths we want to reduce but this isn't part of our filter set, then ignore.\n          // We'll remove it later.\n          if (\n            this.pathsToReduceBy[pathLC] !== '*' &&\n            Array.isArray(this.pathsToReduceBy[pathLC]) &&\n            !this.pathsToReduceBy[pathLC].includes(method.toLowerCase())\n          ) {\n            return;\n          }\n        }\n\n        const operation = this.definition.paths?.[path]?.[method as HttpMethods] as OperationObject;\n        if (!operation) {\n          throw new Error(`Operation \\`${method} ${path}\\` not found`);\n        }\n\n        if (this.hasTagsToReduceBy) {\n          // If this endpoint either has no tags or none that we want to preseve, then prune it.\n          if (!(operation.tags || []).filter(tag => this.tagsToReduceBy.includes(tag.toLowerCase())).length) {\n            return;\n          }\n        }\n\n        (operation.tags || []).forEach((tag: string) => {\n          this.usedTags.add(tag);\n        });\n\n        // Skipped by the `method === 'parameters'` guard above; accumulate here so refs are only\n        // retained when at least one operation on this path passes all filters.\n        const pathLevelParams = this.definition.paths?.[path]?.parameters;\n        if (pathLevelParams) {\n          this.queryForRefPointers(pathLevelParams).forEach(({ value: ref }) => {\n            const refStr = this.toRefString(ref);\n            if (!refStr) {\n              return;\n            }\n\n            this.$refs.add(refStr);\n            this.accumulateUsedRefs(this.definition, this.$refs, refStr);\n          });\n        }\n\n        this.queryForRefPointers(operation).forEach(({ value: ref }) => {\n          const refStr = this.toRefString(ref);\n          if (!refStr) {\n            return;\n          }\n\n          this.$refs.add(refStr);\n\n          // If this operation has a cross-operation `$ref` pointer then we need to track it so\n          // it's retained.\n          const pathRef = this.parsePathRef(refStr);\n          if (pathRef) {\n            this.retainPathMethods.add(`${pathRef.path.toLowerCase()}|${pathRef.method.toLowerCase()}`);\n          }\n\n          // Re-run through any `$ref` pointers that we found within this operation and search for\n          // any `$ref` pointers that they also may be using.\n          this.accumulateUsedRefs(this.definition, this.$refs, refStr);\n        });\n\n        Object.values(operation.security || {}).forEach(sec => {\n          Object.keys(sec).forEach(scheme => {\n            this.$refs.add(`#/components/securitySchemes/${scheme}`);\n          });\n        });\n      });\n    });\n  }\n\n  /**\n   * Walk through the `webhooks` in our OpenAPI definition and reduce down any that we know we do\n   * not want to keep and accumulate any `$ref` pointers that we find that may be cross-referenced\n   * in paths, operations, and schemas that we _do_ want to keep.\n   *\n   */\n  private walkWebhooks() {\n    if (!isOpenAPI31(this.definition)) {\n      return;\n    } else if (!('webhooks' in this.definition) || !this.definition.webhooks) {\n      return;\n    }\n\n    const definition = this.definition satisfies OpenAPIV3_1.Document;\n\n    Object.keys(definition.webhooks || {}).forEach(webhookName => {\n      const nameLC = webhookName.toLowerCase();\n      if (this.hasWebhooksToReduceBy && !(nameLC in this.webhooksToReduceBy)) {\n        return;\n      }\n\n      const webhook = definition.webhooks?.[webhookName];\n      if (!webhook || typeof webhook !== 'object') {\n        return;\n      }\n\n      Object.keys(webhook).forEach(method => {\n        // Only process operations and retain any common path-level common properties like\n        // `parameters`, `servers`, `summary`, etc.\n        if (method === 'parameters' || !supportedMethods.includes(method.toLowerCase() as HttpMethods)) {\n          return;\n        }\n\n        if (this.hasWebhooksToReduceBy) {\n          // If we have webhooks we want to reduce but this isn't part of our filter set, then\n          // ignore. We'll remove it later.\n          const methodFilter = this.webhooksToReduceBy[nameLC];\n          if (methodFilter !== '*' && Array.isArray(methodFilter) && !methodFilter.includes(method.toLowerCase())) {\n            return;\n          }\n        }\n\n        /**\n         * If this webhook path item is a `$ref` then ignore it.\n         * @fixme we should better support reducing this.\n         */\n        if (isRef(webhook)) {\n          return;\n        }\n\n        const operation = webhook[method as HttpMethods] as OperationObject;\n        if (!operation) {\n          return;\n        }\n\n        if (this.hasTagsToReduceBy) {\n          // If this operation either has no tags or none that we want to preseve, then prune it.\n          if (!(operation.tags || []).filter(tag => this.tagsToReduceBy.includes(tag.toLowerCase())).length) {\n            return;\n          }\n        }\n\n        (operation.tags || []).forEach((tag: string) => {\n          this.usedTags.add(tag);\n        });\n\n        // Skipped by the `method === 'parameters'` guard above; accumulate here so refs are only\n        // retained when at least one operation on this webhook passes all filters.\n        if (webhook.parameters) {\n          this.queryForRefPointers(webhook.parameters).forEach(({ value: ref }) => {\n            const refStr = this.toRefString(ref);\n            if (!refStr) {\n              return;\n            }\n\n            this.$refs.add(refStr);\n            this.accumulateUsedRefs(definition, this.$refs, refStr);\n          });\n        }\n\n        this.queryForRefPointers(operation).forEach(({ value: ref }) => {\n          const refStr = this.toRefString(ref);\n          if (!refStr) {\n            return;\n          }\n\n          this.$refs.add(refStr);\n          const pathRef = this.parsePathRef(refStr);\n          if (pathRef) {\n            this.retainPathMethods.add(`${pathRef.path.toLowerCase()}|${pathRef.method.toLowerCase()}`);\n          }\n\n          const webhookRef = this.parseWebhookRef(refStr);\n          if (webhookRef) {\n            this.retainWebhookMethods.add(`${webhookRef.name.toLowerCase()}|${webhookRef.method.toLowerCase()}`);\n          }\n\n          this.accumulateUsedRefs(definition, this.$refs, refStr);\n        });\n\n        Object.values(operation.security || {}).forEach(sec => {\n          Object.keys(sec).forEach(scheme => {\n            this.$refs.add(`#/components/securitySchemes/${scheme}`);\n          });\n        });\n      });\n    });\n  }\n\n  /**\n   * Prune back our `paths` object in the OpenAPI definition to only include paths that we want to\n   * preserve.\n   *\n   */\n  private reducePaths(): void {\n    if (!('paths' in this.definition) || !this.definition.paths) {\n      return;\n    }\n\n    Object.keys(this.definition.paths).forEach(path => {\n      const pathLC = path.toLowerCase();\n\n      if (this.hasPathsToReduceBy && !(pathLC in this.pathsToReduceBy)) {\n        delete this.definition.paths?.[path];\n        return;\n      }\n\n      Object.keys(this.definition.paths?.[path] || {}).forEach(method => {\n        const methodLC = method.toLowerCase();\n\n        // Only process operations and retain any common path-level common properties like\n        // `parameters`, `servers`, `summary`, etc.\n        if (method === 'parameters' || !supportedMethods.includes(methodLC as HttpMethods)) {\n          return;\n        }\n\n        const retainedByRef =\n          this.retainPathMethods.has(`${pathLC}|${methodLC}`) ||\n          Array.from(this.$refs).some(ref => {\n            const pathRef = this.parsePathRef(ref);\n            return pathRef?.path.toLowerCase() === pathLC && pathRef?.method.toLowerCase() === methodLC;\n          });\n\n        if (methodLC !== 'parameters') {\n          // If we're reducing paths and this operation isn't part of our filter set, and it's\n          // not a cross-referenced operation that we want to retain, then we should prune it.\n          if (this.hasPathsToReduceBy) {\n            if (\n              !retainedByRef &&\n              this.pathsToReduceBy[pathLC] !== '*' &&\n              Array.isArray(this.pathsToReduceBy[pathLC]) &&\n              !this.pathsToReduceBy[pathLC].includes(methodLC)\n            ) {\n              delete this.definition.paths?.[path]?.[method as HttpMethods];\n              return;\n            }\n          }\n        }\n\n        const operation = this.definition.paths?.[path]?.[method as HttpMethods];\n        if (!operation) {\n          throw new Error(`Operation \\`${method} ${path}\\` not found`);\n        }\n\n        // If we're reducing by tags and this operation doesn't live in one of those, remove it.\n        if (this.hasTagsToReduceBy) {\n          // If this operation doesn't have any tags that we want to preserve, and it isn't\n          // cross-referenced from an operation we _do_ want to preserve, then remove it.\n          if (!(operation.tags || []).filter(tag => this.tagsToReduceBy.includes(tag.toLowerCase())).length) {\n            if (!retainedByRef) {\n              delete this.definition.paths?.[path]?.[method as HttpMethods];\n            }\n\n            return;\n          }\n        }\n\n        // Accumulate a list of used tags so we can filter out any ones that we don't need later.\n        if ('tags' in operation) {\n          operation.tags?.forEach((tag: string) => {\n            this.usedTags.add(tag);\n          });\n        }\n\n        // Accumulate any used operation-level security schemas that we need to retain.\n        if ('security' in operation) {\n          Object.values(operation.security || {}).forEach(sec => {\n            Object.keys(sec).forEach(scheme => {\n              this.$refs.add(`#/components/securitySchemes/${scheme}`);\n            });\n          });\n        }\n      });\n\n      // If this path no longer has any methods, delete it.\n      if (!Object.keys(this.definition.paths?.[path] || {}).length) {\n        delete this.definition.paths?.[path];\n      }\n    });\n\n    // If we don't have any more paths after cleanup, and we don't have any webhooks, then throw\n    // an error because an OpenAPI definition must have at least one path.\n    if (!Object.keys(this.definition.paths || {}).length) {\n      if (!(this.definition.webhooks && Object.keys(this.definition.webhooks).length)) {\n        throw new Error(\n          'All paths in the API definition were removed. Did you supply the right path name to reduce by?',\n        );\n      }\n\n      delete this.definition.paths;\n    }\n  }\n\n  /**\n   * Prune back our `webhooks` object in the OpenAPI definition to only include webhooks that we\n   * want to preserve.\n   *\n   */\n  private reduceWebhooks(): void {\n    if (!isOpenAPI31(this.definition)) {\n      return;\n    } else if (!('webhooks' in this.definition) || !this.definition.webhooks) {\n      return;\n    }\n\n    const definition = this.definition satisfies OpenAPIV3_1.Document;\n\n    Object.keys(definition.webhooks || {}).forEach(webhookName => {\n      const nameLC = webhookName.toLowerCase();\n      if (this.hasWebhooksToReduceBy && !(nameLC in this.webhooksToReduceBy)) {\n        const retainedByRef = Array.from(this.retainWebhookMethods).some(\n          key => key.startsWith(`${nameLC}|`) || key === `${nameLC}|`,\n        );\n\n        if (!retainedByRef) {\n          delete definition.webhooks?.[webhookName];\n          return;\n        }\n      }\n\n      const webhook = definition.webhooks?.[webhookName];\n      if (!webhook || typeof webhook !== 'object') {\n        return;\n      }\n\n      /**\n       * If this webhook path item is a `$ref` then ignore it.\n       * @fixme we should better support reducing this.\n       */\n      if (isRef(webhook)) {\n        return;\n      }\n\n      Object.keys(webhook).forEach(method => {\n        const methodLC = method.toLowerCase();\n        if (method === 'parameters' || !supportedMethods.includes(methodLC as HttpMethods)) {\n          return;\n        }\n\n        const retainedByRef = this.retainWebhookMethods.has(`${nameLC}|${methodLC}`);\n        if (this.hasWebhooksToReduceBy && !retainedByRef) {\n          const methodFilter = this.webhooksToReduceBy[nameLC];\n          if (methodFilter !== '*' && Array.isArray(methodFilter) && !methodFilter.includes(methodLC)) {\n            /**\n             * If this webhook path item is a `$ref` then ignore and retain it.\n             * @fixme we should better support reducing this.\n             */\n            if (!definition.webhooks?.[webhookName] || isRef(definition.webhooks?.[webhookName])) {\n              return;\n            }\n\n            delete definition.webhooks?.[webhookName]?.[method as HttpMethods];\n          }\n        }\n      });\n\n      if (!Object.keys(definition.webhooks?.[webhookName] || {}).length) {\n        delete definition.webhooks?.[webhookName];\n      }\n    });\n\n    if (definition.webhooks && !Object.keys(definition.webhooks).length) {\n      delete definition.webhooks;\n    }\n  }\n}\n"]}

package/dist/reducer/index.js

@@ -4,7 +4,7 @@ import {
 import {
   decodePointer,
   supportedMethods
-} from "../chunk-QINBUHP2.js";
+} from "../chunk-K5WNB3M7.js";
 import "../chunk-S27IGTVG.js";
 import {
   isOpenAPI31,