oas 38.3.0 → 38.4.0

package/dist/chunk-Z2WDQGCU.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/erunion/code/readme/oas/packages/oas/dist/chunk-Z2WDQGCU.cjs","../src/lib/transformer/index.ts","../src/lib/transformer/operation-selection.ts"],"names":[],"mappings":"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","file":"/Users/erunion/code/readme/oas/packages/oas/dist/chunk-Z2WDQGCU.cjs","sourcesContent":[null,"import type {\n  ComponentsObject,\n  HttpMethods,\n  OASDocument,\n  OperationObject,\n  PathItemObject,\n  TagObject,\n} from '../../types.js';\nimport type { OpenAPIV3_1 } from 'openapi-types';\n\nimport jsonPointer from 'jsonpointer';\n\nimport { query } from '../../analyzer/util.js';\nimport { Operation } from '../../operation/index.js';\nimport { isOpenAPI31, isRef } from '../../types.js';\nimport { supportedMethods } from '../../utils.js';\nimport { decodePointer } from '../refs.js';\n\nimport { OperationSelection } from './operation-selection.js';\n\ninterface OpenAPITransformerOptions {\n  /** Whether selected paths, operations, and webhooks should be retained or removed. */\n  mode: 'prune' | 'reduce';\n}\n\n/**\n * Internal engine for selecting operations and transforming an OpenAPI definition down to its\n * reachable paths, webhooks, components, and tags.\n */\nexport class OpenAPITransformer {\n  private definition: OASDocument;\n\n  private readonly mode: 'prune' | 'reduce';\n\n  /**\n   * A collection of `$ref` pointers that are used within our transformed API definition. This is\n   * used 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 the transformed 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're retaining. This collection is used to ensure that those operations\n   * are retained in our resulting API definition. Not retaining them would result in an invalid\n   * 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 to ensure that those operations are\n   * retained in our resulting API definition. Not retaining them would result in an invalid\n   * OpenAPI definition.\n   */\n  private retainWebhookMethods: Set<`${string}|${string}`> = new Set();\n\n  /** An array of OpenAPI tags selected for the current transformation. */\n  private tagSelection: string[] = [];\n\n  /** A collection of operation IDs selected for the current transformation. */\n  private operationIdSelection = new Set<string>();\n\n  /** A collection of OpenAPI paths and operations selected for the current transformation. */\n  private pathSelection = new OperationSelection();\n\n  /** A collection of OpenAPI webhooks selected for the current transformation. */\n  private webhookSelection = new OperationSelection();\n\n  private hasTagSelection: boolean = false;\n  private hasOperationIdSelection: boolean = false;\n  private hasPathSelection: boolean = false;\n  private hasWebhookSelection: boolean = false;\n\n  /**\n   * @param definition OpenAPI definition to transform.\n   * @param options Transformation mode.\n   */\n  protected constructor(definition: OASDocument, options: OpenAPITransformerOptions) {\n    this.definition = structuredClone(definition);\n    this.mode = options.mode;\n  }\n\n  /**\n   * Select an OpenAPI tag. Operations with this tag are retained when reducing and removed when\n   * pruning. Tag casing does not matter.\n   *\n   * @param tag Tag to select.\n   */\n  protected selectTag(tag: string): void {\n    this.tagSelection.push(tag.toLowerCase());\n  }\n\n  /**\n   * Select an entire OpenAPI path and all operations that it contains. Selected paths are retained\n   * when reducing and removed when pruning. Path casing does not matter.\n   *\n   * @param path Path to select.\n   */\n  protected selectPath(path: string): void {\n    this.pathSelection.addAll(path);\n  }\n\n  /**\n   * Select a single OpenAPI operation. Selected operations are retained when reducing and removed\n   * when pruning. Path and method casing does not matter.\n   *\n   * In reduce mode, selecting an operation after its entire path replaces the all-operation\n   * selection with that operation and any operations selected afterward. Prune mode keeps the\n   * entire path selected.\n   *\n   * @param path Path containing the operation.\n   * @param method HTTP method of the operation to select.\n   */\n  protected selectOperation(path: string, method: string): void {\n    if (this.mode === 'reduce' && this.pathSelection.matchesAll(path)) {\n      this.pathSelection.clear(path);\n    }\n\n    this.pathSelection.addOperation(path, method);\n  }\n\n  /**\n   * Select an OpenAPI operation by its operation ID. IDs are matched exactly and are generated\n   * from the operation path and method when one is not authored in the definition.\n   *\n   * @param operationId Operation ID to select.\n   */\n  protected selectOperationId(operationId: string): void {\n    this.operationIdSelection.add(operationId);\n  }\n\n  /**\n   * Select an OpenAPI webhook or one of its operations. Selected webhooks are retained when\n   * reducing and removed when pruning. Webhook and method casing does not matter.\n   *\n   * @param webhookName Webhook to select.\n   * @param method Optional HTTP method of an individual webhook operation to select.\n   */\n  protected selectWebhook(webhookName: string, method?: string): void {\n    if (!method) {\n      this.webhookSelection.addAll(webhookName);\n      return;\n    }\n\n    if (this.mode === 'reduce' && this.webhookSelection.matchesAll(webhookName)) {\n      this.webhookSelection.clear(webhookName);\n    }\n\n    this.webhookSelection.addOperation(webhookName, method);\n  }\n\n  /** Transform the OpenAPI definition according to the configured mode and selections. */\n  protected transform(): OASDocument {\n    if (!this.definition.openapi) {\n      throw new Error('Sorry, only OpenAPI definitions are supported.');\n    }\n\n    this.hasTagSelection = Boolean(this.tagSelection.length);\n    this.hasOperationIdSelection = this.operationIdSelection.size > 0;\n    this.hasPathSelection = this.pathSelection.hasSelections;\n    this.hasWebhookSelection = this.webhookSelection.hasSelections;\n\n    // Retain any root-level security definitions, regardless if they're used or not on operations\n    // that we're retaining.\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    /**\n     * @fixme Resolve referenced Path Items and expand the complete dependency set of operations and\n     * Path Items retained transitively through cross-operation references before mutating paths or\n     * webhooks.\n     */\n    this.transformPaths();\n    this.transformWebhooks();\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 we don't have any paths or webhooks left, retain the reducer's no-match error to help catch\n    // invalid selections. An empty definition is valid OpenAPI so we allow it when pruning.\n    if (this.mode === 'reduce' && !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 transformed\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 transformed 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 transformer can 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 transformer 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  /** Determine whether a path or webhook is excluded in the current transformation mode. */\n  private isContainerExcluded(selection: OperationSelection, key: string): boolean {\n    if (this.mode === 'prune') {\n      return selection.matchesAll(key);\n    }\n\n    return !selection.has(key);\n  }\n\n  /**\n   * Determine whether an operation passes the configured filters before cross-operation references\n   * are considered.\n   */\n  private shouldRetainOperation(\n    selection: OperationSelection,\n    key: string,\n    method: string,\n    operation: OperationObject,\n  ): boolean {\n    if (this.mode === 'reduce') {\n      // Reduction filters intersect, so an operation must match every configured filter.\n      if (selection.hasSelections && !selection.matches(key, method)) return false;\n      if (\n        this.hasOperationIdSelection &&\n        !this.operationIdSelection.has(Operation.getOperationId(key, method, operation))\n      ) {\n        return false;\n      }\n      if (this.hasTagSelection && !(operation.tags || []).some(tag => this.tagSelection.includes(tag.toLowerCase()))) {\n        return false;\n      }\n    } else {\n      // Pruning filters are additive, so matching any configured filter removes an operation.\n      if (selection.hasSelections && selection.matches(key, method)) return false;\n      if (\n        this.hasOperationIdSelection &&\n        this.operationIdSelection.has(Operation.getOperationId(key, method, operation))\n      ) {\n        return false;\n      }\n      if (this.hasTagSelection && (operation.tags || []).some(tag => this.tagSelection.includes(tag.toLowerCase()))) {\n        return false;\n      }\n    }\n\n    // No configured filter excluded this operation, so retain it in the transformed definition.\n    return true;\n  }\n\n  /** Determine whether a path item contains at least one HTTP operation. */\n  private hasOperations(pathItem: PathItemObject | undefined): boolean {\n    return Boolean(pathItem && supportedMethods.some(method => method in pathItem));\n  }\n\n  /**\n   * Accumulate any `$ref` pointers that are used by common Path Item parameters.\n   *\n   * @param parameters Common Path Item parameters to inspect for `$ref` pointers.\n   */\n  private accumulateParameterRefs(parameters: PathItemObject['parameters'] | undefined): void {\n    if (!parameters) {\n      return;\n    }\n\n    this.queryForRefPointers(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(this.definition, this.$refs, refStr);\n    });\n  }\n\n  /**\n   * Walk through the `paths` in our OpenAPI definition and determine which operations we want to\n   * retain. Accumulate any `$ref` pointers that they use so their referenced schemas can also be\n   * retained in our resulting API definition.\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      // When only webhooks were requested (no path/operation filter), ignore all paths, but don't\n      // delete them yet because a selected webhook may reference one of their operations. We'll\n      // remove any that aren't referenced later.\n      if (this.mode === 'reduce' && this.hasWebhookSelection && !this.hasPathSelection) {\n        return;\n      } else if (this.hasPathSelection && this.isContainerExcluded(this.pathSelection, path)) {\n        return;\n      }\n\n      const pathItem = this.definition.paths?.[path];\n\n      /**\n       * Referenced Path Items that remain in the result are preserved intact rather than partially\n       * transformed. Retain the target and continue walking any local sibling fields so that we\n       * retain their dependencies too.\n       * @fixme Resolve referenced Path Items so their operations can be transformed individually.\n       */\n      if (isRef(pathItem)) {\n        this.$refs.add(pathItem.$ref);\n        this.accumulateUsedRefs(this.definition, this.$refs, pathItem.$ref);\n      }\n\n      // If this Path Item has no operations then it will remain in our resulting API definition,\n      // so we need to retain any components referenced by its common parameters.\n      if (!this.hasOperations(pathItem)) {\n        this.accumulateParameterRefs(pathItem?.parameters);\n      }\n\n      Object.keys(pathItem || {}).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        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 operation isn't part of our resulting API definition then ignore it. We'll\n        // remove it later.\n        if (!this.shouldRetainOperation(this.pathSelection, path, method, operation)) {\n          return;\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        this.accumulateParameterRefs(pathItem?.parameters);\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 determine which operations we want\n   * to retain. Accumulate any `$ref` pointers that they use so their referenced schemas can also be\n   * retained in our resulting API definition.\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      if (this.hasWebhookSelection && this.isContainerExcluded(this.webhookSelection, webhookName)) {\n        return;\n      }\n\n      const webhook: PathItemObject | undefined = definition.webhooks?.[webhookName];\n      if (!webhook || typeof webhook !== 'object') {\n        return;\n      }\n\n      /**\n       * Referenced webhook Path Items that remain in the result are preserved intact rather than\n       * partially transformed. Retain the target and continue walking any local sibling fields so\n       * that we retain their dependencies too.\n       * @fixme Resolve referenced Path Items so their operations can be transformed individually.\n       */\n      if (typeof webhook.$ref === 'string') {\n        this.$refs.add(webhook.$ref);\n        this.accumulateUsedRefs(definition, this.$refs, webhook.$ref);\n      }\n\n      // If this webhook has no operations then it will remain in our resulting API definition, so\n      // we need to retain any components referenced by its common parameters.\n      if (!this.hasOperations(webhook)) {\n        this.accumulateParameterRefs(webhook.parameters);\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        const operation = webhook[method as HttpMethods] as OperationObject;\n        if (!operation) {\n          throw new Error(`Webhook operation \\`${method} ${webhookName}\\` not found`);\n        }\n\n        // If this operation isn't part of our resulting API definition then ignore it. We'll\n        // remove it later.\n        if (!this.shouldRetainOperation(this.webhookSelection, webhookName, method, operation)) {\n          return;\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        this.accumulateParameterRefs(webhook.parameters);\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   * Transform our `paths` object according to the paths and operations that we've selected.\n   */\n  private transformPaths(): 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      const excludePathItem =\n        (this.hasPathSelection && this.isContainerExcluded(this.pathSelection, path)) ||\n        (this.mode === 'reduce' && this.hasWebhookSelection && !this.hasPathSelection);\n\n      if (this.mode === 'prune' && excludePathItem) {\n        if (Array.from(this.retainPathMethods).some(key => key.startsWith(`${pathLC}|`))) {\n          throw new Error(`Cannot remove path \\`${path}\\` because one of its operations is referenced.`);\n        }\n\n        delete this.definition.paths?.[path];\n        return;\n      }\n\n      const pathItem = this.definition.paths?.[path];\n\n      /**\n       * Referenced Path Items are preserved intact during operation-level filtering. If the whole\n       * Path Item is excluded, remove it unless a surviving operation references it.\n       * @fixme Resolve referenced Path Items so their operations can be transformed individually.\n       */\n      if (isRef(pathItem)) {\n        if (excludePathItem) {\n          const retainedByRef = Array.from(this.retainPathMethods).some(key => key.startsWith(`${pathLC}|`));\n          if (!retainedByRef) {\n            delete this.definition.paths?.[path];\n          }\n        }\n\n        return;\n      }\n\n      let removedOperation = false;\n      Object.keys(pathItem || {}).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        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 (excludePathItem || !this.shouldRetainOperation(this.pathSelection, path, method, operation)) {\n          if (this.mode === 'prune' && retainedByRef) {\n            throw new Error(`Cannot remove operation \\`${method.toUpperCase()} ${path}\\` because it is referenced.`);\n          }\n\n          if (!retainedByRef) {\n            delete this.definition.paths?.[path]?.[method as HttpMethods];\n            removedOperation = true;\n            return;\n          }\n        }\n\n        // This operation remains in the transformed definition, so retain any components\n        // referenced by its common Path Item parameters.\n        this.accumulateParameterRefs(pathItem?.parameters);\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 filtering removed every operation from this path then remove its path-level properties\n      // as well. We leave path items that were authored without operations untouched.\n      if (\n        ((removedOperation || (this.mode === 'reduce' && excludePathItem)) && !this.hasOperations(pathItem)) ||\n        (this.mode === 'reduce' && !Object.keys(this.definition.paths?.[path] || {}).length)\n      ) {\n        delete this.definition.paths?.[path];\n      }\n    });\n\n    // If we don't have any paths left then retain the reducer's no-match error. An empty Paths\n    // Object is valid OpenAPI so we allow it when pruning.\n    if (!Object.keys(this.definition.paths || {}).length) {\n      if (this.mode === 'reduce' && !(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      if (this.definition.webhooks && Object.keys(this.definition.webhooks).length) {\n        delete this.definition.paths;\n      }\n    }\n  }\n\n  /**\n   * Transform our `webhooks` object according to the webhooks and operations that we've selected.\n   */\n  private transformWebhooks(): 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      const excludeWebhook = this.hasWebhookSelection && this.isContainerExcluded(this.webhookSelection, webhookName);\n\n      if (this.mode === 'prune' && excludeWebhook) {\n        const retainedByRef = Array.from(this.retainWebhookMethods).some(key => key.startsWith(`${nameLC}|`));\n\n        if (retainedByRef) {\n          throw new Error(`Cannot remove webhook \\`${webhookName}\\` because one of its operations is referenced.`);\n        }\n\n        delete definition.webhooks?.[webhookName];\n        return;\n      }\n\n      const webhook = definition.webhooks?.[webhookName];\n      if (!webhook || typeof webhook !== 'object') {\n        return;\n      }\n\n      /**\n       * Referenced webhook Path Items are preserved intact during operation-level filtering. If\n       * the whole webhook is excluded, remove it unless a surviving operation references it.\n       * @fixme Resolve referenced Path Items so their operations can be transformed individually.\n       */\n      if (isRef(webhook)) {\n        if (excludeWebhook) {\n          const retainedByRef = Array.from(this.retainWebhookMethods).some(key => key.startsWith(`${nameLC}|`));\n          if (!retainedByRef) {\n            delete definition.webhooks?.[webhookName];\n          }\n        }\n\n        return;\n      }\n\n      let removedOperation = false;\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 operation = webhook[method as HttpMethods];\n        if (!operation) {\n          throw new Error(`Webhook operation \\`${method} ${webhookName}\\` not found`);\n        }\n\n        const retainedByRef = this.retainWebhookMethods.has(`${nameLC}|${methodLC}`);\n        if (excludeWebhook || !this.shouldRetainOperation(this.webhookSelection, webhookName, method, operation)) {\n          if (this.mode === 'prune' && retainedByRef) {\n            throw new Error(\n              `Cannot remove operation \\`${method.toUpperCase()} ${webhookName}\\` because it is referenced.`,\n            );\n          }\n\n          if (!retainedByRef) {\n            delete webhook[method as HttpMethods];\n            removedOperation = true;\n            return;\n          }\n        }\n\n        // This operation remains in the transformed definition, so retain any components\n        // referenced by its common Path Item parameters.\n        this.accumulateParameterRefs(webhook.parameters);\n\n        (operation.tags || []).forEach((tag: string) => {\n          this.usedTags.add(tag);\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      if (\n        ((removedOperation || (this.mode === 'reduce' && excludeWebhook)) && !this.hasOperations(webhook)) ||\n        (this.mode === 'reduce' && !Object.keys(definition.webhooks?.[webhookName] || {}).length)\n      ) {\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","/**\n * Track selected HTTP operations within OpenAPI paths or webhooks. Container keys and HTTP methods\n * are matched without regard to casing.\n */\nexport class OperationSelection {\n  private selections: Map<string, '*' | Set<string>> = new Map();\n\n  /** Whether any paths or webhooks have been selected. */\n  get hasSelections(): boolean {\n    return this.selections.size > 0;\n  }\n\n  /**\n   * Select every operation within a path or webhook.\n   *\n   * @param key Path or webhook key whose operations should be selected.\n   */\n  addAll(key: string): void {\n    this.selections.set(this.normalize(key), '*');\n  }\n\n  /**\n   * Add an operation to the selection for a path or webhook. If every operation for the key is\n   * already selected, that selection remains unchanged.\n   *\n   * @param key Path or webhook key that contains the operation.\n   * @param method HTTP method of the operation to select.\n   */\n  addOperation(key: string, method: string): void {\n    const normalizedKey = this.normalize(key);\n    const normalizedMethod = this.normalize(method);\n    const selection = this.selections.get(normalizedKey);\n\n    if (selection === '*') {\n      return;\n    }\n\n    if (selection instanceof Set) {\n      selection.add(normalizedMethod);\n      return;\n    }\n\n    this.selections.set(normalizedKey, new Set([normalizedMethod]));\n  }\n\n  /**\n   * Clear every operation selection for a path or webhook.\n   *\n   * @param key Path or webhook key to clear.\n   */\n  clear(key: string): void {\n    this.selections.delete(this.normalize(key));\n  }\n\n  /**\n   * Determine whether a path or webhook has any selected operations.\n   *\n   * @param key Path or webhook key to check.\n   */\n  has(key: string): boolean {\n    return this.selections.has(this.normalize(key));\n  }\n\n  /**\n   * Determine whether every operation within a path or webhook is selected.\n   *\n   * @param key Path or webhook key to check.\n   */\n  matchesAll(key: string): boolean {\n    return this.selections.get(this.normalize(key)) === '*';\n  }\n\n  /**\n   * Determine whether an operation is selected.\n   *\n   * @param key Path or webhook key that contains the operation.\n   * @param method HTTP method of the operation to check.\n   */\n  matches(key: string, method: string): boolean {\n    const selection = this.selections.get(this.normalize(key));\n    return selection === '*' || Boolean(selection?.has(this.normalize(method)));\n  }\n\n  /** Normalize path, webhook, and method casing for comparisons. */\n  private normalize(value: string): string {\n    return value.toLowerCase();\n  }\n}\n"]}

package/dist/index-Borb1VXh.d.cts

@@ -0,0 +1,174 @@
+import { OASDocument } from './types.cjs';
+
+interface OpenAPITransformerOptions {
+    /** Whether selected paths, operations, and webhooks should be retained or removed. */
+    mode: 'prune' | 'reduce';
+}
+/**
+ * Internal engine for selecting operations and transforming an OpenAPI definition down to its
+ * reachable paths, webhooks, components, and tags.
+ */
+declare class OpenAPITransformer {
+    private definition;
+    private readonly mode;
+    /**
+     * A collection of `$ref` pointers that are used within our transformed API definition. This is
+     * used to ensure that all referenced schemas are retained in our resulting API definition. Not
+     * retaining them would result in an invalid OpenAPI definition.
+     */
+    private $refs;
+    /**
+     * A collection of OpenAPI tags that are used within the transformed API definition.
+     */
+    private usedTags;
+    /**
+     * A collection of OpenAPI paths and operations that are cross-referenced from any other paths
+     * and operations that we're retaining. This collection is used to ensure that those operations
+     * are retained in our resulting API definition. Not retaining them would result in an invalid
+     * OpenAPI definition.
+     */
+    private retainPathMethods;
+    /**
+     * A collection of OpenAPI webhook names and methods that are cross-referenced from any other
+     * schemas. This collection, like `retainPathMethods`, is used to ensure that those operations are
+     * retained in our resulting API definition. Not retaining them would result in an invalid
+     * OpenAPI definition.
+     */
+    private retainWebhookMethods;
+    /** An array of OpenAPI tags selected for the current transformation. */
+    private tagSelection;
+    /** A collection of operation IDs selected for the current transformation. */
+    private operationIdSelection;
+    /** A collection of OpenAPI paths and operations selected for the current transformation. */
+    private pathSelection;
+    /** A collection of OpenAPI webhooks selected for the current transformation. */
+    private webhookSelection;
+    private hasTagSelection;
+    private hasOperationIdSelection;
+    private hasPathSelection;
+    private hasWebhookSelection;
+    /**
+     * @param definition OpenAPI definition to transform.
+     * @param options Transformation mode.
+     */
+    protected constructor(definition: OASDocument, options: OpenAPITransformerOptions);
+    /**
+     * Select an OpenAPI tag. Operations with this tag are retained when reducing and removed when
+     * pruning. Tag casing does not matter.
+     *
+     * @param tag Tag to select.
+     */
+    protected selectTag(tag: string): void;
+    /**
+     * Select an entire OpenAPI path and all operations that it contains. Selected paths are retained
+     * when reducing and removed when pruning. Path casing does not matter.
+     *
+     * @param path Path to select.
+     */
+    protected selectPath(path: string): void;
+    /**
+     * Select a single OpenAPI operation. Selected operations are retained when reducing and removed
+     * when pruning. Path and method casing does not matter.
+     *
+     * In reduce mode, selecting an operation after its entire path replaces the all-operation
+     * selection with that operation and any operations selected afterward. Prune mode keeps the
+     * entire path selected.
+     *
+     * @param path Path containing the operation.
+     * @param method HTTP method of the operation to select.
+     */
+    protected selectOperation(path: string, method: string): void;
+    /**
+     * Select an OpenAPI operation by its operation ID. IDs are matched exactly and are generated
+     * from the operation path and method when one is not authored in the definition.
+     *
+     * @param operationId Operation ID to select.
+     */
+    protected selectOperationId(operationId: string): void;
+    /**
+     * Select an OpenAPI webhook or one of its operations. Selected webhooks are retained when
+     * reducing and removed when pruning. Webhook and method casing does not matter.
+     *
+     * @param webhookName Webhook to select.
+     * @param method Optional HTTP method of an individual webhook operation to select.
+     */
+    protected selectWebhook(webhookName: string, method?: string): void;
+    /** Transform the OpenAPI definition according to the configured mode and selections. */
+    protected transform(): OASDocument;
+    /**
+     * Recursively process a `$ref` pointer and accumulate any other `$ref` pointers that it or its
+     * children use. This handles circular references by skipping `$ref` pointers we have already seen.
+     * Additionally when a `$ref` points to `#/paths` we record the used path + method so we can
+     * retain cross-operation references within the transformed definition.
+     *
+     * @param schema JSON Schema object to look for and accumulate any `$ref` pointers that it may have.
+     * @param $refs Known set of `$ref` pointers.
+     * @param $ref `$ref` pointer to fetch a schema from out of the supplied schema.
+     */
+    private accumulateUsedRefs;
+    /**
+     * Query a JSON Schema object for any `$ref` pointers using JSONPath and return any pointers that
+     * exist.
+     *
+     * @see {@link https://datatracker.ietf.org/doc/html/rfc9535}
+     * @param schema JSON Schema object to look for any `$ref` pointers within it.
+     */
+    private queryForRefPointers;
+    /**
+     * Normalize a value from a `jsonpath-plus` `$ref` query to a `$ref` pointer because JSONPath
+     * queries may return the property value or the parent.
+     *
+     */
+    private toRefString;
+    /**
+     * If the given `$ref` points into a path (e.g. `#/paths/~1anything/post/...`), return the path
+     * and method so the transformer can retain cross-operation references.
+     *
+     */
+    private parsePathRef;
+    /**
+     * If the given `$ref` points into webhooks (e.g. `#/webhooks/newBooking/post/...`), return the
+     * webhook name and method so the transformer can retain cross-referenced webhook operations.
+     *
+     */
+    private parseWebhookRef;
+    /** Determine whether a path or webhook is excluded in the current transformation mode. */
+    private isContainerExcluded;
+    /**
+     * Determine whether an operation passes the configured filters before cross-operation references
+     * are considered.
+     */
+    private shouldRetainOperation;
+    /** Determine whether a path item contains at least one HTTP operation. */
+    private hasOperations;
+    /**
+     * Accumulate any `$ref` pointers that are used by common Path Item parameters.
+     *
+     * @param parameters Common Path Item parameters to inspect for `$ref` pointers.
+     */
+    private accumulateParameterRefs;
+    /**
+     * Walk through the `paths` in our OpenAPI definition and determine which operations we want to
+     * retain. Accumulate any `$ref` pointers that they use so their referenced schemas can also be
+     * retained in our resulting API definition.
+     *
+     */
+    private walkPaths;
+    /**
+     * Walk through the `webhooks` in our OpenAPI definition and determine which operations we want
+     * to retain. Accumulate any `$ref` pointers that they use so their referenced schemas can also be
+     * retained in our resulting API definition.
+     *
+     */
+    private walkWebhooks;
+    /**
+     * Transform our `paths` object according to the paths and operations that we've selected.
+     */
+    private transformPaths;
+    /**
+     * Transform our `webhooks` object according to the webhooks and operations that we've selected.
+     */
+    private transformWebhooks;
+}
+
+export { OpenAPITransformer as O };

package/dist/index-Br-eJMCh.d.ts

@@ -0,0 +1,174 @@
+import { OASDocument } from './types.js';
+
+interface OpenAPITransformerOptions {
+    /** Whether selected paths, operations, and webhooks should be retained or removed. */
+    mode: 'prune' | 'reduce';
+}
+/**
+ * Internal engine for selecting operations and transforming an OpenAPI definition down to its
+ * reachable paths, webhooks, components, and tags.
+ */
+declare class OpenAPITransformer {
+    private definition;
+    private readonly mode;
+    /**
+     * A collection of `$ref` pointers that are used within our transformed API definition. This is
+     * used to ensure that all referenced schemas are retained in our resulting API definition. Not
+     * retaining them would result in an invalid OpenAPI definition.
+     */
+    private $refs;
+    /**
+     * A collection of OpenAPI tags that are used within the transformed API definition.
+     */
+    private usedTags;
+    /**
+     * A collection of OpenAPI paths and operations that are cross-referenced from any other paths
+     * and operations that we're retaining. This collection is used to ensure that those operations
+     * are retained in our resulting API definition. Not retaining them would result in an invalid
+     * OpenAPI definition.
+     */
+    private retainPathMethods;
+    /**
+     * A collection of OpenAPI webhook names and methods that are cross-referenced from any other
+     * schemas. This collection, like `retainPathMethods`, is used to ensure that those operations are
+     * retained in our resulting API definition. Not retaining them would result in an invalid
+     * OpenAPI definition.
+     */
+    private retainWebhookMethods;
+    /** An array of OpenAPI tags selected for the current transformation. */
+    private tagSelection;
+    /** A collection of operation IDs selected for the current transformation. */
+    private operationIdSelection;
+    /** A collection of OpenAPI paths and operations selected for the current transformation. */
+    private pathSelection;
+    /** A collection of OpenAPI webhooks selected for the current transformation. */
+    private webhookSelection;
+    private hasTagSelection;
+    private hasOperationIdSelection;
+    private hasPathSelection;
+    private hasWebhookSelection;
+    /**
+     * @param definition OpenAPI definition to transform.
+     * @param options Transformation mode.
+     */
+    protected constructor(definition: OASDocument, options: OpenAPITransformerOptions);
+    /**
+     * Select an OpenAPI tag. Operations with this tag are retained when reducing and removed when
+     * pruning. Tag casing does not matter.
+     *
+     * @param tag Tag to select.
+     */
+    protected selectTag(tag: string): void;
+    /**
+     * Select an entire OpenAPI path and all operations that it contains. Selected paths are retained
+     * when reducing and removed when pruning. Path casing does not matter.
+     *
+     * @param path Path to select.
+     */
+    protected selectPath(path: string): void;
+    /**
+     * Select a single OpenAPI operation. Selected operations are retained when reducing and removed
+     * when pruning. Path and method casing does not matter.
+     *
+     * In reduce mode, selecting an operation after its entire path replaces the all-operation
+     * selection with that operation and any operations selected afterward. Prune mode keeps the
+     * entire path selected.
+     *
+     * @param path Path containing the operation.
+     * @param method HTTP method of the operation to select.
+     */
+    protected selectOperation(path: string, method: string): void;
+    /**
+     * Select an OpenAPI operation by its operation ID. IDs are matched exactly and are generated
+     * from the operation path and method when one is not authored in the definition.
+     *
+     * @param operationId Operation ID to select.
+     */
+    protected selectOperationId(operationId: string): void;
+    /**
+     * Select an OpenAPI webhook or one of its operations. Selected webhooks are retained when
+     * reducing and removed when pruning. Webhook and method casing does not matter.
+     *
+     * @param webhookName Webhook to select.
+     * @param method Optional HTTP method of an individual webhook operation to select.
+     */
+    protected selectWebhook(webhookName: string, method?: string): void;
+    /** Transform the OpenAPI definition according to the configured mode and selections. */
+    protected transform(): OASDocument;
+    /**
+     * Recursively process a `$ref` pointer and accumulate any other `$ref` pointers that it or its
+     * children use. This handles circular references by skipping `$ref` pointers we have already seen.
+     * Additionally when a `$ref` points to `#/paths` we record the used path + method so we can
+     * retain cross-operation references within the transformed definition.
+     *
+     * @param schema JSON Schema object to look for and accumulate any `$ref` pointers that it may have.
+     * @param $refs Known set of `$ref` pointers.
+     * @param $ref `$ref` pointer to fetch a schema from out of the supplied schema.
+     */
+    private accumulateUsedRefs;
+    /**
+     * Query a JSON Schema object for any `$ref` pointers using JSONPath and return any pointers that
+     * exist.
+     *
+     * @see {@link https://datatracker.ietf.org/doc/html/rfc9535}
+     * @param schema JSON Schema object to look for any `$ref` pointers within it.
+     */
+    private queryForRefPointers;
+    /**
+     * Normalize a value from a `jsonpath-plus` `$ref` query to a `$ref` pointer because JSONPath
+     * queries may return the property value or the parent.
+     *
+     */
+    private toRefString;
+    /**
+     * If the given `$ref` points into a path (e.g. `#/paths/~1anything/post/...`), return the path
+     * and method so the transformer can retain cross-operation references.
+     *
+     */
+    private parsePathRef;
+    /**
+     * If the given `$ref` points into webhooks (e.g. `#/webhooks/newBooking/post/...`), return the
+     * webhook name and method so the transformer can retain cross-referenced webhook operations.
+     *
+     */
+    private parseWebhookRef;
+    /** Determine whether a path or webhook is excluded in the current transformation mode. */
+    private isContainerExcluded;
+    /**
+     * Determine whether an operation passes the configured filters before cross-operation references
+     * are considered.
+     */
+    private shouldRetainOperation;
+    /** Determine whether a path item contains at least one HTTP operation. */
+    private hasOperations;
+    /**
+     * Accumulate any `$ref` pointers that are used by common Path Item parameters.
+     *
+     * @param parameters Common Path Item parameters to inspect for `$ref` pointers.
+     */
+    private accumulateParameterRefs;
+    /**
+     * Walk through the `paths` in our OpenAPI definition and determine which operations we want to
+     * retain. Accumulate any `$ref` pointers that they use so their referenced schemas can also be
+     * retained in our resulting API definition.
+     *
+     */
+    private walkPaths;
+    /**
+     * Walk through the `webhooks` in our OpenAPI definition and determine which operations we want
+     * to retain. Accumulate any `$ref` pointers that they use so their referenced schemas can also be
+     * retained in our resulting API definition.
+     *
+     */
+    private walkWebhooks;
+    /**
+     * Transform our `paths` object according to the paths and operations that we've selected.
+     */
+    private transformPaths;
+    /**
+     * Transform our `webhooks` object according to the webhooks and operations that we've selected.
+     */
+    private transformWebhooks;
+}
+
+export { OpenAPITransformer as O };

package/dist/index.cjs

@@ -11,7 +11,8 @@
 
 
 
-var _chunk3ZXZMZXTcjs = require('./chunk-3ZXZMZXT.cjs');
+
+var _chunkY64TRECNcjs = require('./chunk-Y64TRECN.cjs');
 
 
 
@@ -145,16 +146,16 @@ var Oas = class _Oas {
   url(selected = 0, variables) {
     const url = _optionalChain([this, 'access', _8 => _8.api, 'access', _9 => _9.servers, 'optionalAccess', _10 => _10[selected], 'optionalAccess', _11 => _11.url]);
     const resolvedUrl = url ? this.replaceUrl(url, variables || this.defaultVariables(selected)) : void 0;
-    return _chunk3ZXZMZXTcjs.normalizeURL.call(void 0, resolvedUrl).trim();
+    return _chunkY64TRECNcjs.normalizeURL.call(void 0, resolvedUrl).trim();
   }
   variables(selected = 0) {
-    return _chunk3ZXZMZXTcjs.variablesFromServers.call(void 0, this.api.servers, selected);
+    return _chunkY64TRECNcjs.variablesFromServers.call(void 0, this.api.servers, selected);
   }
   defaultVariables(selected = 0) {
-    return _chunk3ZXZMZXTcjs.defaultVariablesFromServers.call(void 0, this.api.servers, selected, this.user);
+    return _chunkY64TRECNcjs.defaultVariablesFromServers.call(void 0, this.api.servers, selected, this.user);
   }
   splitUrl(selected = 0) {
-    return _chunk3ZXZMZXTcjs.splitUrlFromServers.call(void 0, this.api.servers, selected);
+    return _chunkY64TRECNcjs.splitUrlFromServers.call(void 0, this.api.servers, selected);
   }
   /**
    * With a fully composed server URL, run through our list of known OAS servers and return back
@@ -172,7 +173,7 @@ var Oas = class _Oas {
    */
   splitVariables(baseUrl) {
     const matchedServer = (this.api.servers || []).map((server, i) => {
-      const rgx = _chunk3ZXZMZXTcjs.transformURLIntoRegex.call(void 0, server.url);
+      const rgx = _chunkY64TRECNcjs.transformURLIntoRegex.call(void 0, server.url);
       const found = new RegExp(rgx).exec(baseUrl);
       if (!found) {
         return false;
@@ -208,7 +209,7 @@ var Oas = class _Oas {
    * @param variables An object containing variables to swap into the URL.
    */
   replaceUrl(url, variables = {}) {
-    return _chunk3ZXZMZXTcjs.stripTrailingSlash.call(void 0, 
+    return _chunkY64TRECNcjs.stripTrailingSlash.call(void 0, 
       url.replace(_chunk7WBPPWYIcjs.SERVER_VARIABLE_REGEX, (original, key) => {
         if (key in variables) {
           const data = variables[key];
@@ -220,7 +221,7 @@ var Oas = class _Oas {
             return String(data);
           }
         }
-        const userVariable = _chunk3ZXZMZXTcjs.getUserVariable.call(void 0, this.user, key);
+        const userVariable = _chunkY64TRECNcjs.getUserVariable.call(void 0, this.user, key);
         if (userVariable) {
           return String(userVariable);
         }
@@ -244,7 +245,7 @@ var Oas = class _Oas {
         if (webhookPath && !_chunk7PWF3F2Wcjs.isRef.call(void 0, webhookPath)) {
           if (_optionalChain([webhookPath, 'optionalAccess', _15 => _15[method]])) {
             operation = webhookPath[method];
-            return new (0, _chunk3ZXZMZXTcjs.Webhook)(this, path, method, operation);
+            return new (0, _chunkY64TRECNcjs.Webhook)(this, path, method, operation);
           }
         }
       }
@@ -255,7 +256,7 @@ var Oas = class _Oas {
         operation = _chunk7WBPPWYIcjs.dereferenceRef.call(void 0, pathItem[method], this.api);
       }
     }
-    return new (0, _chunk3ZXZMZXTcjs.Operation)(this, path, method, operation);
+    return new (0, _chunkY64TRECNcjs.Operation)(this, path, method, operation);
   }
   findOperationMatches(url) {
     const annotatedPaths = [
@@ -269,8 +270,14 @@ var Oas = class _Oas {
    * Find matches for a URL against paths as they are served by the root-level `servers`.
    */
   findRootServerOperationMatches(url) {
-    const { origin, hostname } = new URL(url);
-    const originRegExp = new RegExp(origin, "i");
+    let origin;
+    let hostname;
+    try {
+      ({ origin, hostname } = new URL(url));
+    } catch (e) {
+      return void 0;
+    }
+    const originRegExp = new RegExp(_chunkY64TRECNcjs.escapeRegExp.call(void 0, origin), "i");
     const { servers, paths } = this.api;
     let matchedServer;
     if (!servers || !servers.length) {
@@ -280,7 +287,7 @@ var Oas = class _Oas {
     } else {
       matchedServer = servers.find((s) => originRegExp.exec(this.replaceUrl(s.url, s.variables || {})));
       if (!matchedServer) {
-        const hostnameRegExp = new RegExp(hostname);
+        const hostnameRegExp = new RegExp(_chunkY64TRECNcjs.escapeRegExp.call(void 0, hostname));
         matchedServer = servers.find((s) => hostnameRegExp.exec(this.replaceUrl(s.url, s.variables || {})));
       }
     }
@@ -293,7 +300,7 @@ var Oas = class _Oas {
       }
     }
     if (!target || !paths) return void 0;
-    const annotatedPaths = _chunk3ZXZMZXTcjs.generatePathMatches.call(void 0, paths, target.pathName || "/", target.origin);
+    const annotatedPaths = _chunkY64TRECNcjs.generatePathMatches.call(void 0, paths, target.pathName || "/", target.origin);
     if (!annotatedPaths.length) return void 0;
     return annotatedPaths;
   }
@@ -341,7 +348,7 @@ var Oas = class _Oas {
         for (const server of servers) {
           const target = this.splitURLIntoOriginAndPathName(url, server);
           if (!target) continue;
-          const annotatedPaths = _chunk3ZXZMZXTcjs.generatePathMatches.call(void 0, 
+          const annotatedPaths = _chunkY64TRECNcjs.generatePathMatches.call(void 0, 
             { [path]: operations },
             target.pathName || "/",
             target.origin
@@ -368,11 +375,11 @@ var Oas = class _Oas {
   splitURLOnSubstitutedServer(url, server) {
     try {
       const substitutedUrl = this.replaceUrl(server.url, server.variables || {});
-      const [, pathName] = url.split(new RegExp(substitutedUrl, "i"));
+      const [, pathName] = url.split(new RegExp(_chunkY64TRECNcjs.escapeRegExp.call(void 0, substitutedUrl), "i"));
       if (pathName !== void 0) {
         return { origin: substitutedUrl, pathName };
       }
-    } catch (e) {
+    } catch (e2) {
     }
     return void 0;
   }
@@ -382,11 +389,11 @@ var Oas = class _Oas {
    */
   splitURLOnServerRegex(url, server) {
     try {
-      const regex = _chunk3ZXZMZXTcjs.transformURLIntoRegex.call(void 0, server.url);
+      const regex = _chunkY64TRECNcjs.transformURLIntoRegex.call(void 0, server.url);
       if (new RegExp(regex).exec(url)) {
         return { origin: server.url, pathName: url.split(new RegExp(regex)).slice(-1).pop() || "" };
       }
-    } catch (e2) {
+    } catch (e3) {
     }
     return void 0;
   }
@@ -403,9 +410,9 @@ var Oas = class _Oas {
     if (!annotatedPaths) {
       return void 0;
     }
-    const matches = _chunk3ZXZMZXTcjs.filterPathMethods.call(void 0, annotatedPaths, method);
+    const matches = _chunkY64TRECNcjs.filterPathMethods.call(void 0, annotatedPaths, method);
     if (!matches.length) return void 0;
-    return _chunk3ZXZMZXTcjs.findTargetPath.call(void 0, matches);
+    return _chunkY64TRECNcjs.findTargetPath.call(void 0, matches);
   }
   /**
    * Discover an operation in an OAS from a fully-formed URL without an HTTP method. Will return an
@@ -418,7 +425,7 @@ var Oas = class _Oas {
     if (!annotatedPaths) {
       return void 0;
     }
-    return _chunk3ZXZMZXTcjs.findTargetPath.call(void 0, annotatedPaths);
+    return _chunkY64TRECNcjs.findTargetPath.call(void 0, annotatedPaths);
   }
   /**
    * Retrieve an operation in an OAS from a fully-formed URL and HTTP method. Differs from