oas 25.1.0 → 25.2.1

package/dist/operation/lib/get-parameters-as-json-schema.cjs

@@ -1,11 +1,11 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
 
-var _chunk3I4KH26Ecjs = require('../../chunk-3I4KH26E.cjs');
+var _chunkTG4VCYD4cjs = require('../../chunk-TG4VCYD4.cjs');
 require('../../chunk-YHO3AOX6.cjs');
-require('../../chunk-G6ASGSM5.cjs');
+require('../../chunk-4DQE5VZI.cjs');
 
 
 
-exports.getParametersAsJSONSchema = _chunk3I4KH26Ecjs.getParametersAsJSONSchema; exports.types = _chunk3I4KH26Ecjs.types;
+exports.getParametersAsJSONSchema = _chunkTG4VCYD4cjs.getParametersAsJSONSchema; exports.types = _chunkTG4VCYD4cjs.types;
 //# sourceMappingURL=get-parameters-as-json-schema.cjs.map

package/dist/operation/lib/get-parameters-as-json-schema.d.cts

@@ -1,4 +1,4 @@
 import '../../types.cjs';
-export { S as SchemaWrapper, a as getParametersAsJSONSchema, g as getParametersAsJSONSchemaOptions, t as types } from '../../extensions-B4_nMl6M.cjs';
+export { S as SchemaWrapper, a as getParametersAsJSONSchema, g as getParametersAsJSONSchemaOptions, t as types } from '../../extensions-CaiwqAu-.cjs';
 import 'json-schema';
 import 'openapi-types';

package/dist/operation/lib/get-parameters-as-json-schema.d.ts

@@ -1,4 +1,4 @@
 import '../../types.js';
-export { S as SchemaWrapper, a as getParametersAsJSONSchema, g as getParametersAsJSONSchemaOptions, t as types } from '../../extensions-BTG_yoHC.js';
+export { S as SchemaWrapper, a as getParametersAsJSONSchema, g as getParametersAsJSONSchemaOptions, t as types } from '../../extensions-DYrxWRh4.js';
 import 'json-schema';
 import 'openapi-types';

package/dist/operation/lib/get-parameters-as-json-schema.js

@@ -1,9 +1,9 @@
 import {
   getParametersAsJSONSchema,
   types
-} from "../../chunk-LH3S6NWD.js";
+} from "../../chunk-W7MR5CC7.js";
 import "../../chunk-P2SB77YR.js";
-import "../../chunk-U7Q7XPMY.js";
+import "../../chunk-QMLWI5HD.js";
 export {
   getParametersAsJSONSchema,
   types

package/dist/reducer/index.cjs

@@ -4,7 +4,6 @@ var _chunkW6GBV2JTcjs = require('../chunk-W6GBV2JT.cjs');
 
 // src/reducer/index.ts
 var _jsonpointer = require('jsonpointer'); var _jsonpointer2 = _interopRequireDefault(_jsonpointer);
-var _utils = require('oas-normalize/lib/utils');
 function getUsedRefs(schema) {
   return _chunkW6GBV2JTcjs.query.call(void 0, ["$..['$ref']"], schema);
 }
@@ -32,7 +31,7 @@ function reducer(definition, opts = {}) {
   }, {}) : {};
   const $refs = /* @__PURE__ */ new Set();
   const usedTags = /* @__PURE__ */ new Set();
-  if (_utils.getAPIDefinitionType.call(void 0, definition) !== "openapi") {
+  if (!definition.openapi) {
     throw new Error("Sorry, only OpenAPI definitions are supported.");
   }
   const reduced = JSON.parse(JSON.stringify(definition));

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 { ComponentsObject, HttpMethods, OASDocument, TagObject } from '../types.js';\n\nimport jsonPointer from 'jsonpointer';\nimport { getAPIDefinitionType } from 'oas-normalize/lib/utils';\n\nimport { query } from '../analyzer/util.js';\n\ninterface ReducerOptions {\n  /** A key-value object of path + method combinations to reduce by. */\n  paths?: Record<string, string[] | '*'>;\n  /** An array of tags in the OpenAPI definition to reduce by. */\n  tags?: string[];\n}\n\n/**\n * Query a JSON Schema object for any `$ref` pointers. Return any pointers that were found.\n *\n * @param schema JSON Schema object to look for any `$ref` pointers within it.\n */\nfunction getUsedRefs(schema: any) {\n  return query([\"$..['$ref']\"], schema);\n}\n\n/**\n * Recursively process a `$ref` pointer and accumulate any other `$ref` pointers that it or its\n * children use.\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 */\nfunction accumulateUsedRefs(schema: Record<string, unknown>, $refs: Set<string>, $ref: any): void {\n  let $refSchema;\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  getUsedRefs($refSchema).forEach(({ value: currRef }) => {\n    // If we've already processed this $ref don't send us into an infinite loop.\n    if ($refs.has(currRef)) {\n      return;\n    }\n\n    $refs.add(currRef);\n    accumulateUsedRefs(schema, $refs, currRef);\n  });\n}\n\n/**\n * With an array of tags or object of paths+method combinations, reduce an OpenAPI definition to a\n * new definition that just contains those tags or path + methods.\n *\n * @example <caption>Reduce by an array of tags only.</caption>\n * reducer(apiDefinition, { tags: ['pet'] })\n *\n * @example <caption>Reduce by a specific path and methods.</caption>\n * reducer(apiDefinition, { paths: { '/pet': ['get', 'post'] } })\n *\n * @example <caption>Reduce by a specific path and all methods it has.</caption>\n * reducer(apiDefinition, { paths: { '/pet': '*' } })\n *\n * @param definition A valid OpenAPI 3.x definition\n */\nexport default function reducer(definition: OASDocument, opts: ReducerOptions = {}) {\n  // Convert tags and paths to lowercase since casing should not matter.\n  const reduceTags = 'tags' in opts ? opts.tags.map(tag => tag.toLowerCase()) : [];\n  const reducePaths =\n    'paths' in opts\n      ? Object.entries(opts.paths).reduce((acc: Record<string, string[] | string>, [key, value]) => {\n          const newKey = key.toLowerCase();\n          const newValue = Array.isArray(value) ? value.map(v => v.toLowerCase()) : value.toLowerCase();\n          acc[newKey] = newValue;\n          return acc;\n        }, {})\n      : {};\n\n  const $refs: Set<string> = new Set();\n  const usedTags: Set<string> = new Set();\n\n  if (getAPIDefinitionType(definition) !== 'openapi') {\n    throw new Error('Sorry, only OpenAPI definitions are supported.');\n  }\n\n  // Stringify and parse so we get a full non-reference clone of the API definition to work with.\n  // eslint-disable-next-line try-catch-failsafe/json-parse\n  const reduced = JSON.parse(JSON.stringify(definition)) as OASDocument;\n\n  // Retain any root-level security definitions.\n  if ('security' in reduced) {\n    Object.values(reduced.security).forEach(sec => {\n      Object.keys(sec).forEach(scheme => {\n        $refs.add(`#/components/securitySchemes/${scheme}`);\n      });\n    });\n  }\n\n  if ('paths' in reduced) {\n    Object.keys(reduced.paths).forEach(path => {\n      const pathLC = path.toLowerCase();\n\n      if (Object.keys(reducePaths).length) {\n        if (!(pathLC in reducePaths)) {\n          delete reduced.paths[path];\n          return;\n        }\n      }\n\n      Object.keys(reduced.paths[path]).forEach((method: HttpMethods | 'parameters') => {\n        // If this method is `parameters` we should always retain it.\n        if (method !== 'parameters') {\n          if (Object.keys(reducePaths).length) {\n            if (\n              reducePaths[pathLC] !== '*' &&\n              Array.isArray(reducePaths[pathLC]) &&\n              !reducePaths[pathLC].includes(method)\n            ) {\n              delete reduced.paths[path][method];\n              return;\n            }\n          }\n        }\n\n        const operation = reduced.paths[path][method];\n\n        // If we're reducing by tags and this operation doesn't live in one of those, remove it.\n        if (reduceTags.length) {\n          if (!('tags' in operation)) {\n            delete reduced.paths[path][method];\n            return;\n          } else if (!operation.tags.filter(tag => reduceTags.includes(tag.toLowerCase())).length) {\n            delete reduced.paths[path][method];\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            usedTags.add(tag);\n          });\n        }\n\n        // Accumulate a list of $ref pointers that are used within this operation.\n        getUsedRefs(operation).forEach(({ value: ref }) => {\n          $refs.add(ref);\n        });\n\n        // Accumulate any used 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              $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(reduced.paths[path]).length) {\n        delete reduced.paths[path];\n      }\n    });\n\n    // If we don't have any more paths after cleanup, throw an error because an OpenAPI file must\n    // have at least one path.\n    if (!Object.keys(reduced.paths).length) {\n      throw new Error('All paths in the API definition were removed. Did you supply the right path name to reduce by?');\n    }\n  }\n\n  // Recursively accumulate any components that are in use.\n  $refs.forEach($ref => accumulateUsedRefs(reduced, $refs, $ref));\n\n  // Remove any unused components.\n  if ('components' in reduced) {\n    Object.keys(reduced.components).forEach((componentType: keyof ComponentsObject) => {\n      Object.keys(reduced.components[componentType]).forEach(component => {\n        if (!$refs.has(`#/components/${componentType}/${component}`)) {\n          delete reduced.components[componentType][component];\n        }\n      });\n\n      // If this component group is now empty, delete it.\n      if (!Object.keys(reduced.components[componentType]).length) {\n        delete reduced.components[componentType];\n      }\n    });\n\n    // If this path no longer has any components, delete it.\n    if (!Object.keys(reduced.components).length) {\n      delete reduced.components;\n    }\n  }\n\n  // Remove any unused tags.\n  if ('tags' in reduced) {\n    reduced.tags.forEach((tag: TagObject, k: number) => {\n      if (!usedTags.has(tag.name)) {\n        delete reduced.tags[k];\n      }\n    });\n\n    // Remove any now empty items from the tags array.\n    reduced.tags = reduced.tags.filter(Boolean);\n\n    if (!reduced.tags.length) {\n      delete reduced.tags;\n    }\n  }\n\n  return reduced;\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, TagObject } from '../types.js';\n\nimport jsonPointer from 'jsonpointer';\n\nimport { query } from '../analyzer/util.js';\n\ninterface ReducerOptions {\n  /** A key-value object of path + method combinations to reduce by. */\n  paths?: Record<string, string[] | '*'>;\n  /** An array of tags in the OpenAPI definition to reduce by. */\n  tags?: string[];\n}\n\n/**\n * Query a JSON Schema object for any `$ref` pointers. Return any pointers that were found.\n *\n * @param schema JSON Schema object to look for any `$ref` pointers within it.\n */\nfunction getUsedRefs(schema: any) {\n  return query([\"$..['$ref']\"], schema);\n}\n\n/**\n * Recursively process a `$ref` pointer and accumulate any other `$ref` pointers that it or its\n * children use.\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 */\nfunction accumulateUsedRefs(schema: Record<string, unknown>, $refs: Set<string>, $ref: any): void {\n  let $refSchema;\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  getUsedRefs($refSchema).forEach(({ value: currRef }) => {\n    // If we've already processed this $ref don't send us into an infinite loop.\n    if ($refs.has(currRef)) {\n      return;\n    }\n\n    $refs.add(currRef);\n    accumulateUsedRefs(schema, $refs, currRef);\n  });\n}\n\n/**\n * With an array of tags or object of paths+method combinations, reduce an OpenAPI definition to a\n * new definition that just contains those tags or path + methods.\n *\n * @example <caption>Reduce by an array of tags only.</caption>\n * reducer(apiDefinition, { tags: ['pet'] })\n *\n * @example <caption>Reduce by a specific path and methods.</caption>\n * reducer(apiDefinition, { paths: { '/pet': ['get', 'post'] } })\n *\n * @example <caption>Reduce by a specific path and all methods it has.</caption>\n * reducer(apiDefinition, { paths: { '/pet': '*' } })\n *\n * @param definition A valid OpenAPI 3.x definition\n */\nexport default function reducer(definition: OASDocument, opts: ReducerOptions = {}) {\n  // Convert tags and paths to lowercase since casing should not matter.\n  const reduceTags = 'tags' in opts ? opts.tags.map(tag => tag.toLowerCase()) : [];\n  const reducePaths =\n    'paths' in opts\n      ? Object.entries(opts.paths).reduce((acc: Record<string, string[] | string>, [key, value]) => {\n          const newKey = key.toLowerCase();\n          const newValue = Array.isArray(value) ? value.map(v => v.toLowerCase()) : value.toLowerCase();\n          acc[newKey] = newValue;\n          return acc;\n        }, {})\n      : {};\n\n  const $refs: Set<string> = new Set();\n  const usedTags: Set<string> = new Set();\n\n  if (!definition.openapi) {\n    throw new Error('Sorry, only OpenAPI definitions are supported.');\n  }\n\n  // Stringify and parse so we get a full non-reference clone of the API definition to work with.\n  // eslint-disable-next-line try-catch-failsafe/json-parse\n  const reduced = JSON.parse(JSON.stringify(definition)) as OASDocument;\n\n  // Retain any root-level security definitions.\n  if ('security' in reduced) {\n    Object.values(reduced.security).forEach(sec => {\n      Object.keys(sec).forEach(scheme => {\n        $refs.add(`#/components/securitySchemes/${scheme}`);\n      });\n    });\n  }\n\n  if ('paths' in reduced) {\n    Object.keys(reduced.paths).forEach(path => {\n      const pathLC = path.toLowerCase();\n\n      if (Object.keys(reducePaths).length) {\n        if (!(pathLC in reducePaths)) {\n          delete reduced.paths[path];\n          return;\n        }\n      }\n\n      Object.keys(reduced.paths[path]).forEach((method: HttpMethods | 'parameters') => {\n        // If this method is `parameters` we should always retain it.\n        if (method !== 'parameters') {\n          if (Object.keys(reducePaths).length) {\n            if (\n              reducePaths[pathLC] !== '*' &&\n              Array.isArray(reducePaths[pathLC]) &&\n              !reducePaths[pathLC].includes(method)\n            ) {\n              delete reduced.paths[path][method];\n              return;\n            }\n          }\n        }\n\n        const operation = reduced.paths[path][method];\n\n        // If we're reducing by tags and this operation doesn't live in one of those, remove it.\n        if (reduceTags.length) {\n          if (!('tags' in operation)) {\n            delete reduced.paths[path][method];\n            return;\n          } else if (!operation.tags.filter(tag => reduceTags.includes(tag.toLowerCase())).length) {\n            delete reduced.paths[path][method];\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            usedTags.add(tag);\n          });\n        }\n\n        // Accumulate a list of $ref pointers that are used within this operation.\n        getUsedRefs(operation).forEach(({ value: ref }) => {\n          $refs.add(ref);\n        });\n\n        // Accumulate any used 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              $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(reduced.paths[path]).length) {\n        delete reduced.paths[path];\n      }\n    });\n\n    // If we don't have any more paths after cleanup, throw an error because an OpenAPI file must\n    // have at least one path.\n    if (!Object.keys(reduced.paths).length) {\n      throw new Error('All paths in the API definition were removed. Did you supply the right path name to reduce by?');\n    }\n  }\n\n  // Recursively accumulate any components that are in use.\n  $refs.forEach($ref => accumulateUsedRefs(reduced, $refs, $ref));\n\n  // Remove any unused components.\n  if ('components' in reduced) {\n    Object.keys(reduced.components).forEach((componentType: keyof ComponentsObject) => {\n      Object.keys(reduced.components[componentType]).forEach(component => {\n        if (!$refs.has(`#/components/${componentType}/${component}`)) {\n          delete reduced.components[componentType][component];\n        }\n      });\n\n      // If this component group is now empty, delete it.\n      if (!Object.keys(reduced.components[componentType]).length) {\n        delete reduced.components[componentType];\n      }\n    });\n\n    // If this path no longer has any components, delete it.\n    if (!Object.keys(reduced.components).length) {\n      delete reduced.components;\n    }\n  }\n\n  // Remove any unused tags.\n  if ('tags' in reduced) {\n    reduced.tags.forEach((tag: TagObject, k: number) => {\n      if (!usedTags.has(tag.name)) {\n        delete reduced.tags[k];\n      }\n    });\n\n    // Remove any now empty items from the tags array.\n    reduced.tags = reduced.tags.filter(Boolean);\n\n    if (!reduced.tags.length) {\n      delete reduced.tags;\n    }\n  }\n\n  return reduced;\n}\n"]}

package/dist/reducer/index.js

@@ -4,7 +4,6 @@ import {
 
 // src/reducer/index.ts
 import jsonPointer from "jsonpointer";
-import { getAPIDefinitionType } from "oas-normalize/lib/utils";
 function getUsedRefs(schema) {
   return query(["$..['$ref']"], schema);
 }
@@ -32,7 +31,7 @@ function reducer(definition, opts = {}) {
   }, {}) : {};
   const $refs = /* @__PURE__ */ new Set();
   const usedTags = /* @__PURE__ */ new Set();
-  if (getAPIDefinitionType(definition) !== "openapi") {
+  if (!definition.openapi) {
     throw new Error("Sorry, only OpenAPI definitions are supported.");
   }
   const reduced = JSON.parse(JSON.stringify(definition));

package/dist/reducer/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/reducer/index.ts"],"sourcesContent":["import type { ComponentsObject, HttpMethods, OASDocument, TagObject } from '../types.js';\n\nimport jsonPointer from 'jsonpointer';\nimport { getAPIDefinitionType } from 'oas-normalize/lib/utils';\n\nimport { query } from '../analyzer/util.js';\n\ninterface ReducerOptions {\n  /** A key-value object of path + method combinations to reduce by. */\n  paths?: Record<string, string[] | '*'>;\n  /** An array of tags in the OpenAPI definition to reduce by. */\n  tags?: string[];\n}\n\n/**\n * Query a JSON Schema object for any `$ref` pointers. Return any pointers that were found.\n *\n * @param schema JSON Schema object to look for any `$ref` pointers within it.\n */\nfunction getUsedRefs(schema: any) {\n  return query([\"$..['$ref']\"], schema);\n}\n\n/**\n * Recursively process a `$ref` pointer and accumulate any other `$ref` pointers that it or its\n * children use.\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 */\nfunction accumulateUsedRefs(schema: Record<string, unknown>, $refs: Set<string>, $ref: any): void {\n  let $refSchema;\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  getUsedRefs($refSchema).forEach(({ value: currRef }) => {\n    // If we've already processed this $ref don't send us into an infinite loop.\n    if ($refs.has(currRef)) {\n      return;\n    }\n\n    $refs.add(currRef);\n    accumulateUsedRefs(schema, $refs, currRef);\n  });\n}\n\n/**\n * With an array of tags or object of paths+method combinations, reduce an OpenAPI definition to a\n * new definition that just contains those tags or path + methods.\n *\n * @example <caption>Reduce by an array of tags only.</caption>\n * reducer(apiDefinition, { tags: ['pet'] })\n *\n * @example <caption>Reduce by a specific path and methods.</caption>\n * reducer(apiDefinition, { paths: { '/pet': ['get', 'post'] } })\n *\n * @example <caption>Reduce by a specific path and all methods it has.</caption>\n * reducer(apiDefinition, { paths: { '/pet': '*' } })\n *\n * @param definition A valid OpenAPI 3.x definition\n */\nexport default function reducer(definition: OASDocument, opts: ReducerOptions = {}) {\n  // Convert tags and paths to lowercase since casing should not matter.\n  const reduceTags = 'tags' in opts ? opts.tags.map(tag => tag.toLowerCase()) : [];\n  const reducePaths =\n    'paths' in opts\n      ? Object.entries(opts.paths).reduce((acc: Record<string, string[] | string>, [key, value]) => {\n          const newKey = key.toLowerCase();\n          const newValue = Array.isArray(value) ? value.map(v => v.toLowerCase()) : value.toLowerCase();\n          acc[newKey] = newValue;\n          return acc;\n        }, {})\n      : {};\n\n  const $refs: Set<string> = new Set();\n  const usedTags: Set<string> = new Set();\n\n  if (getAPIDefinitionType(definition) !== 'openapi') {\n    throw new Error('Sorry, only OpenAPI definitions are supported.');\n  }\n\n  // Stringify and parse so we get a full non-reference clone of the API definition to work with.\n  // eslint-disable-next-line try-catch-failsafe/json-parse\n  const reduced = JSON.parse(JSON.stringify(definition)) as OASDocument;\n\n  // Retain any root-level security definitions.\n  if ('security' in reduced) {\n    Object.values(reduced.security).forEach(sec => {\n      Object.keys(sec).forEach(scheme => {\n        $refs.add(`#/components/securitySchemes/${scheme}`);\n      });\n    });\n  }\n\n  if ('paths' in reduced) {\n    Object.keys(reduced.paths).forEach(path => {\n      const pathLC = path.toLowerCase();\n\n      if (Object.keys(reducePaths).length) {\n        if (!(pathLC in reducePaths)) {\n          delete reduced.paths[path];\n          return;\n        }\n      }\n\n      Object.keys(reduced.paths[path]).forEach((method: HttpMethods | 'parameters') => {\n        // If this method is `parameters` we should always retain it.\n        if (method !== 'parameters') {\n          if (Object.keys(reducePaths).length) {\n            if (\n              reducePaths[pathLC] !== '*' &&\n              Array.isArray(reducePaths[pathLC]) &&\n              !reducePaths[pathLC].includes(method)\n            ) {\n              delete reduced.paths[path][method];\n              return;\n            }\n          }\n        }\n\n        const operation = reduced.paths[path][method];\n\n        // If we're reducing by tags and this operation doesn't live in one of those, remove it.\n        if (reduceTags.length) {\n          if (!('tags' in operation)) {\n            delete reduced.paths[path][method];\n            return;\n          } else if (!operation.tags.filter(tag => reduceTags.includes(tag.toLowerCase())).length) {\n            delete reduced.paths[path][method];\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            usedTags.add(tag);\n          });\n        }\n\n        // Accumulate a list of $ref pointers that are used within this operation.\n        getUsedRefs(operation).forEach(({ value: ref }) => {\n          $refs.add(ref);\n        });\n\n        // Accumulate any used 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              $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(reduced.paths[path]).length) {\n        delete reduced.paths[path];\n      }\n    });\n\n    // If we don't have any more paths after cleanup, throw an error because an OpenAPI file must\n    // have at least one path.\n    if (!Object.keys(reduced.paths).length) {\n      throw new Error('All paths in the API definition were removed. Did you supply the right path name to reduce by?');\n    }\n  }\n\n  // Recursively accumulate any components that are in use.\n  $refs.forEach($ref => accumulateUsedRefs(reduced, $refs, $ref));\n\n  // Remove any unused components.\n  if ('components' in reduced) {\n    Object.keys(reduced.components).forEach((componentType: keyof ComponentsObject) => {\n      Object.keys(reduced.components[componentType]).forEach(component => {\n        if (!$refs.has(`#/components/${componentType}/${component}`)) {\n          delete reduced.components[componentType][component];\n        }\n      });\n\n      // If this component group is now empty, delete it.\n      if (!Object.keys(reduced.components[componentType]).length) {\n        delete reduced.components[componentType];\n      }\n    });\n\n    // If this path no longer has any components, delete it.\n    if (!Object.keys(reduced.components).length) {\n      delete reduced.components;\n    }\n  }\n\n  // Remove any unused tags.\n  if ('tags' in reduced) {\n    reduced.tags.forEach((tag: TagObject, k: number) => {\n      if (!usedTags.has(tag.name)) {\n        delete reduced.tags[k];\n      }\n    });\n\n    // Remove any now empty items from the tags array.\n    reduced.tags = reduced.tags.filter(Boolean);\n\n    if (!reduced.tags.length) {\n      delete reduced.tags;\n    }\n  }\n\n  return reduced;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/reducer/index.ts"],"sourcesContent":["import type { ComponentsObject, HttpMethods, OASDocument, TagObject } from '../types.js';\n\nimport jsonPointer from 'jsonpointer';\n\nimport { query } from '../analyzer/util.js';\n\ninterface ReducerOptions {\n  /** A key-value object of path + method combinations to reduce by. */\n  paths?: Record<string, string[] | '*'>;\n  /** An array of tags in the OpenAPI definition to reduce by. */\n  tags?: string[];\n}\n\n/**\n * Query a JSON Schema object for any `$ref` pointers. Return any pointers that were found.\n *\n * @param schema JSON Schema object to look for any `$ref` pointers within it.\n */\nfunction getUsedRefs(schema: any) {\n  return query([\"$..['$ref']\"], schema);\n}\n\n/**\n * Recursively process a `$ref` pointer and accumulate any other `$ref` pointers that it or its\n * children use.\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 */\nfunction accumulateUsedRefs(schema: Record<string, unknown>, $refs: Set<string>, $ref: any): void {\n  let $refSchema;\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  getUsedRefs($refSchema).forEach(({ value: currRef }) => {\n    // If we've already processed this $ref don't send us into an infinite loop.\n    if ($refs.has(currRef)) {\n      return;\n    }\n\n    $refs.add(currRef);\n    accumulateUsedRefs(schema, $refs, currRef);\n  });\n}\n\n/**\n * With an array of tags or object of paths+method combinations, reduce an OpenAPI definition to a\n * new definition that just contains those tags or path + methods.\n *\n * @example <caption>Reduce by an array of tags only.</caption>\n * reducer(apiDefinition, { tags: ['pet'] })\n *\n * @example <caption>Reduce by a specific path and methods.</caption>\n * reducer(apiDefinition, { paths: { '/pet': ['get', 'post'] } })\n *\n * @example <caption>Reduce by a specific path and all methods it has.</caption>\n * reducer(apiDefinition, { paths: { '/pet': '*' } })\n *\n * @param definition A valid OpenAPI 3.x definition\n */\nexport default function reducer(definition: OASDocument, opts: ReducerOptions = {}) {\n  // Convert tags and paths to lowercase since casing should not matter.\n  const reduceTags = 'tags' in opts ? opts.tags.map(tag => tag.toLowerCase()) : [];\n  const reducePaths =\n    'paths' in opts\n      ? Object.entries(opts.paths).reduce((acc: Record<string, string[] | string>, [key, value]) => {\n          const newKey = key.toLowerCase();\n          const newValue = Array.isArray(value) ? value.map(v => v.toLowerCase()) : value.toLowerCase();\n          acc[newKey] = newValue;\n          return acc;\n        }, {})\n      : {};\n\n  const $refs: Set<string> = new Set();\n  const usedTags: Set<string> = new Set();\n\n  if (!definition.openapi) {\n    throw new Error('Sorry, only OpenAPI definitions are supported.');\n  }\n\n  // Stringify and parse so we get a full non-reference clone of the API definition to work with.\n  // eslint-disable-next-line try-catch-failsafe/json-parse\n  const reduced = JSON.parse(JSON.stringify(definition)) as OASDocument;\n\n  // Retain any root-level security definitions.\n  if ('security' in reduced) {\n    Object.values(reduced.security).forEach(sec => {\n      Object.keys(sec).forEach(scheme => {\n        $refs.add(`#/components/securitySchemes/${scheme}`);\n      });\n    });\n  }\n\n  if ('paths' in reduced) {\n    Object.keys(reduced.paths).forEach(path => {\n      const pathLC = path.toLowerCase();\n\n      if (Object.keys(reducePaths).length) {\n        if (!(pathLC in reducePaths)) {\n          delete reduced.paths[path];\n          return;\n        }\n      }\n\n      Object.keys(reduced.paths[path]).forEach((method: HttpMethods | 'parameters') => {\n        // If this method is `parameters` we should always retain it.\n        if (method !== 'parameters') {\n          if (Object.keys(reducePaths).length) {\n            if (\n              reducePaths[pathLC] !== '*' &&\n              Array.isArray(reducePaths[pathLC]) &&\n              !reducePaths[pathLC].includes(method)\n            ) {\n              delete reduced.paths[path][method];\n              return;\n            }\n          }\n        }\n\n        const operation = reduced.paths[path][method];\n\n        // If we're reducing by tags and this operation doesn't live in one of those, remove it.\n        if (reduceTags.length) {\n          if (!('tags' in operation)) {\n            delete reduced.paths[path][method];\n            return;\n          } else if (!operation.tags.filter(tag => reduceTags.includes(tag.toLowerCase())).length) {\n            delete reduced.paths[path][method];\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            usedTags.add(tag);\n          });\n        }\n\n        // Accumulate a list of $ref pointers that are used within this operation.\n        getUsedRefs(operation).forEach(({ value: ref }) => {\n          $refs.add(ref);\n        });\n\n        // Accumulate any used 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              $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(reduced.paths[path]).length) {\n        delete reduced.paths[path];\n      }\n    });\n\n    // If we don't have any more paths after cleanup, throw an error because an OpenAPI file must\n    // have at least one path.\n    if (!Object.keys(reduced.paths).length) {\n      throw new Error('All paths in the API definition were removed. Did you supply the right path name to reduce by?');\n    }\n  }\n\n  // Recursively accumulate any components that are in use.\n  $refs.forEach($ref => accumulateUsedRefs(reduced, $refs, $ref));\n\n  // Remove any unused components.\n  if ('components' in reduced) {\n    Object.keys(reduced.components).forEach((componentType: keyof ComponentsObject) => {\n      Object.keys(reduced.components[componentType]).forEach(component => {\n        if (!$refs.has(`#/components/${componentType}/${component}`)) {\n          delete reduced.components[componentType][component];\n        }\n      });\n\n      // If this component group is now empty, delete it.\n      if (!Object.keys(reduced.components[componentType]).length) {\n        delete reduced.components[componentType];\n      }\n    });\n\n    // If this path no longer has any components, delete it.\n    if (!Object.keys(reduced.components).length) {\n      delete reduced.components;\n    }\n  }\n\n  // Remove any unused tags.\n  if ('tags' in reduced) {\n    reduced.tags.forEach((tag: TagObject, k: number) => {\n      if (!usedTags.has(tag.name)) {\n        delete reduced.tags[k];\n      }\n    });\n\n    // Remove any now empty items from the tags array.\n    reduced.tags = reduced.tags.filter(Boolean);\n\n    if (!reduced.tags.length) {\n      delete reduced.tags;\n    }\n  }\n\n  return reduced;\n}\n"],"mappings":"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","names":[]}

package/dist/types.cjs

@@ -2,10 +2,10 @@
 
 
 
-var _chunkG6ASGSM5cjs = require('./chunk-G6ASGSM5.cjs');
+var _chunk4DQE5VZIcjs = require('./chunk-4DQE5VZI.cjs');
 
 
 
 
-exports.isOAS31 = _chunkG6ASGSM5cjs.isOAS31; exports.isRef = _chunkG6ASGSM5cjs.isRef; exports.isSchema = _chunkG6ASGSM5cjs.isSchema;
+exports.isOAS31 = _chunk4DQE5VZIcjs.isOAS31; exports.isRef = _chunk4DQE5VZIcjs.isRef; exports.isSchema = _chunk4DQE5VZIcjs.isSchema;
 //# sourceMappingURL=types.cjs.map

package/dist/types.d.cts

@@ -44,19 +44,19 @@ interface User {
 type SecurityType = 'apiKey' | 'Basic' | 'Bearer' | 'Cookie' | 'Header' | 'http' | 'OAuth2' | 'Query';
 type HttpMethods = OpenAPIV3_1.HttpMethods | OpenAPIV3.HttpMethods | 'delete' | 'get' | 'head' | 'options' | 'patch' | 'post' | 'put' | 'trace';
 /**
- * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#oasObject}
- * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#oasObject}
+ * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#openapi-object}
+ * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#openapi-object}
  */
 type OASDocument = (OpenAPIV3_1.Document | OpenAPIV3.Document) & Record<string, unknown>;
 type OAS31Document = OpenAPIV3_1.Document & Record<string, unknown>;
 /**
- * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#serverObject}
- * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#serverObject}
+ * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#server-object}
+ * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#server-object}
  */
 type ServerObject = OpenAPIV3_1.ServerObject | OpenAPIV3.ServerObject;
 /**
- * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#serverVariableObject}
- * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#serverVariableObject}
+ * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#server-variable-object}
+ * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#server-variable-object}
  */
 type ServerVariableObject = OpenAPIV3_1.ServerVariableObject | OpenAPIV3.ServerVariableObject;
 type ServerVariablesObject = Record<string, ServerVariableObject>;
@@ -70,70 +70,70 @@ interface Servers {
     variables: ServerVariable;
 }
 /**
- * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#componentsObject}
- * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#componentsObject}
+ * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#components-object}
+ * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#components-object}
  */
 type ComponentsObject = OpenAPIV3_1.ComponentsObject | OpenAPIV3.ComponentsObject;
 /**
- * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#pathsObject}
- * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#pathsObject}
+ * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#paths-object}
+ * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#paths-object}
  */
 type PathsObject = OpenAPIV3_1.PathsObject | OpenAPIV3.PathsObject;
 /**
- * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#pathItemObject}
- * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#pathItemObject}
+ * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#path-item-object}
+ * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#path-item-object}
  */
 type PathItemObject = OpenAPIV3_1.PathItemObject | OpenAPIV3.PathItemObject;
 /**
- * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#operationObject}
- * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#operationObject}
+ * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#operation-object}
+ * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#operation-object}
  */
 type OperationObject = (OpenAPIV3_1.OperationObject | OpenAPIV3.OperationObject) & Record<string, unknown>;
 /**
- * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#parameterObject}
- * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#parameterObject}
+ * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#parameter-object}
+ * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#parameter-object}
  */
 type ParameterObject = {
     in: 'cookie' | 'header' | 'path' | 'query';
 } & (OpenAPIV3_1.ParameterObject | OpenAPIV3.ParameterObject);
 /**
- * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#requestBodyObject}
- * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#requestBodyObject}
+ * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#request-body-object}
+ * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#request-body-object}
  */
 type RequestBodyObject = OpenAPIV3_1.RequestBodyObject | OpenAPIV3.RequestBodyObject;
 /**
- * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#mediaTypeObject}
- * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#mediaTypeObject}
+ * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#media-type-object}
+ * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#media-type-object}
  */
 type MediaTypeObject = OpenAPIV3_1.MediaTypeObject | OpenAPIV3.MediaTypeObject;
 /**
- * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#responseObject}
- * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#responseObject}
+ * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#response-object}
+ * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#response-object}
  */
 type ResponseObject = OpenAPIV3_1.ResponseObject | OpenAPIV3.ResponseObject;
 /**
- * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#callbackObject}
- * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#callbackObject}
+ * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#callback-object}
+ * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#callback-object}
  */
 type CallbackObject = OpenAPIV3_1.CallbackObject | OpenAPIV3.CallbackObject;
 /**
- * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#exampleObject}
- * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.3.md#exampleObject}
+ * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#example-object}
+ * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.3.md#example-object}
  */
 type ExampleObject = OpenAPIV3_1.ExampleObject | OpenAPIV3.ExampleObject;
 /**
- * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#tagObject}
- * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#tagObject}
+ * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#tag-object}
+ * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#tag-object}
  */
 type TagObject = OpenAPIV3_1.TagObject | OpenAPIV3.TagObject;
 /**
- * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#headerObject}
- * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#headerObject}
+ * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#header-object}
+ * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#header-object}
  */
 type HeaderObject = OpenAPIV3_1.HeaderObject | OpenAPIV3.HeaderObject;
 /**
- * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#schemaObject}
- * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#schemaObject}
+ * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#schema-object}
+ * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#schema-object}
  */
 type SchemaObject = {
     externalDocs?: unknown;
@@ -156,8 +156,8 @@ type SchemaObject = {
  */
 declare function isSchema(check: unknown, isPolymorphicAllOfChild?: boolean): check is SchemaObject;
 /**
- * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#securitySchemeObject}
- * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#securitySchemeObject}
+ * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#security-scheme-object}
+ * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#security-scheme-object}
  */
 type SecuritySchemeObject = OpenAPIV3_1.SecuritySchemeObject | OpenAPIV3.SecuritySchemeObject;
 type SecuritySchemesObject = Record<string, SecuritySchemeObject>;
@@ -174,8 +174,8 @@ type KeyedSecuritySchemeObject = SecuritySchemeObject & {
     'x-default'?: number | string;
 };
 /**
- * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#securityRequirementObject}
- * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#securityRequirementObject}
+ * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#security-requirement-object}
+ * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#security-requirement-object}
  */
 type SecurityRequirementObject = OpenAPIV3_1.SecurityRequirementObject | OpenAPIV3.SecurityRequirementObject;
 

package/dist/types.d.ts

@@ -44,19 +44,19 @@ interface User {
 type SecurityType = 'apiKey' | 'Basic' | 'Bearer' | 'Cookie' | 'Header' | 'http' | 'OAuth2' | 'Query';
 type HttpMethods = OpenAPIV3_1.HttpMethods | OpenAPIV3.HttpMethods | 'delete' | 'get' | 'head' | 'options' | 'patch' | 'post' | 'put' | 'trace';
 /**
- * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#oasObject}
- * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#oasObject}
+ * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#openapi-object}
+ * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#openapi-object}
  */
 type OASDocument = (OpenAPIV3_1.Document | OpenAPIV3.Document) & Record<string, unknown>;
 type OAS31Document = OpenAPIV3_1.Document & Record<string, unknown>;
 /**
- * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#serverObject}
- * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#serverObject}
+ * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#server-object}
+ * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#server-object}
  */
 type ServerObject = OpenAPIV3_1.ServerObject | OpenAPIV3.ServerObject;
 /**
- * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#serverVariableObject}
- * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#serverVariableObject}
+ * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#server-variable-object}
+ * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#server-variable-object}
  */
 type ServerVariableObject = OpenAPIV3_1.ServerVariableObject | OpenAPIV3.ServerVariableObject;
 type ServerVariablesObject = Record<string, ServerVariableObject>;
@@ -70,70 +70,70 @@ interface Servers {
     variables: ServerVariable;
 }
 /**
- * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#componentsObject}
- * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#componentsObject}
+ * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#components-object}
+ * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#components-object}
  */
 type ComponentsObject = OpenAPIV3_1.ComponentsObject | OpenAPIV3.ComponentsObject;
 /**
- * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#pathsObject}
- * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#pathsObject}
+ * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#paths-object}
+ * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#paths-object}
  */
 type PathsObject = OpenAPIV3_1.PathsObject | OpenAPIV3.PathsObject;
 /**
- * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#pathItemObject}
- * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#pathItemObject}
+ * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#path-item-object}
+ * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#path-item-object}
  */
 type PathItemObject = OpenAPIV3_1.PathItemObject | OpenAPIV3.PathItemObject;
 /**
- * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#operationObject}
- * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#operationObject}
+ * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#operation-object}
+ * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#operation-object}
  */
 type OperationObject = (OpenAPIV3_1.OperationObject | OpenAPIV3.OperationObject) & Record<string, unknown>;
 /**
- * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#parameterObject}
- * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#parameterObject}
+ * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#parameter-object}
+ * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#parameter-object}
  */
 type ParameterObject = {
     in: 'cookie' | 'header' | 'path' | 'query';
 } & (OpenAPIV3_1.ParameterObject | OpenAPIV3.ParameterObject);
 /**
- * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#requestBodyObject}
- * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#requestBodyObject}
+ * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#request-body-object}
+ * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#request-body-object}
  */
 type RequestBodyObject = OpenAPIV3_1.RequestBodyObject | OpenAPIV3.RequestBodyObject;
 /**
- * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#mediaTypeObject}
- * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#mediaTypeObject}
+ * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#media-type-object}
+ * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#media-type-object}
  */
 type MediaTypeObject = OpenAPIV3_1.MediaTypeObject | OpenAPIV3.MediaTypeObject;
 /**
- * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#responseObject}
- * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#responseObject}
+ * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#response-object}
+ * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#response-object}
  */
 type ResponseObject = OpenAPIV3_1.ResponseObject | OpenAPIV3.ResponseObject;
 /**
- * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#callbackObject}
- * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#callbackObject}
+ * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#callback-object}
+ * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#callback-object}
  */
 type CallbackObject = OpenAPIV3_1.CallbackObject | OpenAPIV3.CallbackObject;
 /**
- * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#exampleObject}
- * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.3.md#exampleObject}
+ * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#example-object}
+ * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.3.md#example-object}
  */
 type ExampleObject = OpenAPIV3_1.ExampleObject | OpenAPIV3.ExampleObject;
 /**
- * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#tagObject}
- * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#tagObject}
+ * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#tag-object}
+ * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#tag-object}
  */
 type TagObject = OpenAPIV3_1.TagObject | OpenAPIV3.TagObject;
 /**
- * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#headerObject}
- * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#headerObject}
+ * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#header-object}
+ * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#header-object}
  */
 type HeaderObject = OpenAPIV3_1.HeaderObject | OpenAPIV3.HeaderObject;
 /**
- * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#schemaObject}
- * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#schemaObject}
+ * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#schema-object}
+ * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#schema-object}
  */
 type SchemaObject = {
     externalDocs?: unknown;
@@ -156,8 +156,8 @@ type SchemaObject = {
  */
 declare function isSchema(check: unknown, isPolymorphicAllOfChild?: boolean): check is SchemaObject;
 /**
- * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#securitySchemeObject}
- * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#securitySchemeObject}
+ * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#security-scheme-object}
+ * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#security-scheme-object}
  */
 type SecuritySchemeObject = OpenAPIV3_1.SecuritySchemeObject | OpenAPIV3.SecuritySchemeObject;
 type SecuritySchemesObject = Record<string, SecuritySchemeObject>;
@@ -174,8 +174,8 @@ type KeyedSecuritySchemeObject = SecuritySchemeObject & {
     'x-default'?: number | string;
 };
 /**
- * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#securityRequirementObject}
- * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#securityRequirementObject}
+ * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#security-requirement-object}
+ * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#security-requirement-object}
  */
 type SecurityRequirementObject = OpenAPIV3_1.SecurityRequirementObject | OpenAPIV3.SecurityRequirementObject;
 

package/dist/types.js

@@ -2,7 +2,7 @@ import {
   isOAS31,
   isRef,
   isSchema
-} from "./chunk-U7Q7XPMY.js";
+} from "./chunk-QMLWI5HD.js";
 export {
   isOAS31,
   isRef,

package/dist/utils.cjs

@@ -5,13 +5,13 @@ var _chunkVIIXOUMHcjs = require('./chunk-VIIXOUMH.cjs');
 
 
 
-var _chunk3I4KH26Ecjs = require('./chunk-3I4KH26E.cjs');
+var _chunkTG4VCYD4cjs = require('./chunk-TG4VCYD4.cjs');
 require('./chunk-YHO3AOX6.cjs');
-require('./chunk-G6ASGSM5.cjs');
+require('./chunk-4DQE5VZI.cjs');
 
 
 
 
 
-exports.findSchemaDefinition = _chunkVIIXOUMHcjs.findSchemaDefinition; exports.jsonSchemaTypes = _chunk3I4KH26Ecjs.types; exports.matchesMimeType = _chunk3I4KH26Ecjs.matches_mimetype_default; exports.supportedMethods = _chunkVIIXOUMHcjs.supportedMethods;
+exports.findSchemaDefinition = _chunkVIIXOUMHcjs.findSchemaDefinition; exports.jsonSchemaTypes = _chunkTG4VCYD4cjs.types; exports.matchesMimeType = _chunkTG4VCYD4cjs.matches_mimetype_default; exports.supportedMethods = _chunkVIIXOUMHcjs.supportedMethods;
 //# sourceMappingURL=utils.cjs.map

package/dist/utils.d.cts

@@ -1,4 +1,4 @@
-export { t as jsonSchemaTypes } from './extensions-B4_nMl6M.cjs';
+export { t as jsonSchemaTypes } from './extensions-CaiwqAu-.cjs';
 import './types.cjs';
 import 'json-schema';
 import 'openapi-types';

package/dist/utils.d.ts

@@ -1,4 +1,4 @@
-export { t as jsonSchemaTypes } from './extensions-BTG_yoHC.js';
+export { t as jsonSchemaTypes } from './extensions-DYrxWRh4.js';
 import './types.js';
 import 'json-schema';
 import 'openapi-types';

package/dist/utils.js

@@ -5,9 +5,9 @@ import {
 import {
   matches_mimetype_default,
   types
-} from "./chunk-LH3S6NWD.js";
+} from "./chunk-W7MR5CC7.js";
 import "./chunk-P2SB77YR.js";
-import "./chunk-U7Q7XPMY.js";
+import "./chunk-QMLWI5HD.js";
 export {
   findSchemaDefinition,
   types as jsonSchemaTypes,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oas",
-  "version": "25.1.0",
+  "version": "25.2.1",
   "description": "Comprehensive tooling for working with OpenAPI definitions",
   "license": "MIT",
   "author": "ReadMe <support@readme.io> (https://readme.com)",
@@ -94,7 +94,6 @@
     "jsonpath-plus": "^10.0.0",
     "jsonpointer": "^5.0.0",
     "memoizee": "^0.4.16",
-    "oas-normalize": "^11.1.4",
     "openapi-types": "^12.1.1",
     "path-to-regexp": "^8.1.0",
     "remove-undefined-objects": "^5.0.0"
@@ -110,5 +109,5 @@
     "vitest": "^2.1.3"
   },
   "prettier": "@readme/eslint-config/prettier",
-  "gitHead": "1a67b475bde7bee51fd1bce64f3022180b50a128"
+  "gitHead": "5705800d43618a2dcaa5f32926eeff944a6ebbc2"
 }