@kubb/agent 4.33.1 → 4.33.3

package/.output/server/node_modules/oas/dist/{chunk-SH63AK3O.js → chunk-5EP6HY2E.js}

@@ -1,12 +1,12 @@
 import {
   PARAMETER_ORDERING,
   getExtension
-} from "./chunk-TTCGKV5E.js";
+} from "./chunk-S27IGTVG.js";
 import {
   isOpenAPI30,
   isRef,
   isSchema
-} from "./chunk-L3V5TF63.js";
+} from "./chunk-7MARUOFZ.js";
 
 // src/lib/clone-object.ts
 function cloneObject(obj) {
@@ -87,17 +87,91 @@ function isPrimitive(val) {
 
 // src/lib/openapi-to-json-schema.ts
 import mergeJSONSchemaAllOf from "json-schema-merge-allof";
-import jsonpointer from "jsonpointer";
+import jsonpointer2 from "jsonpointer";
 import removeUndefinedObjects from "remove-undefined-objects";
+
+// src/lib/refs.ts
+import jsonpointer from "jsonpointer";
+function encodePointer(str) {
+  return str.replaceAll("~", "~0").replaceAll("/", "~1");
+}
+function decodePointer(str) {
+  return str.replace(/~([01])/g, (_, digit) => digit === "0" ? "~" : "/");
+}
+function findRef($ref, definition) {
+  let currRef = $ref.trim();
+  if (currRef === "") {
+    return false;
+  }
+  if (currRef.startsWith("#")) {
+    currRef = decodeURIComponent(currRef.substring(1));
+  } else {
+    throw new Error(`Could not find a definition for ${$ref}.`);
+  }
+  const current = jsonpointer.get(definition, currRef);
+  if (current === void 0) {
+    throw new Error(`Could not find a definition for ${$ref}.`);
+  }
+  return current;
+}
+function dereferenceRef(value, definition, seenRefs) {
+  if (value === void 0) {
+    return void 0;
+  }
+  if (isRef(value)) {
+    if (!definition) {
+      return value;
+    }
+    const ref = value.$ref;
+    if (seenRefs?.has(ref)) {
+      return value;
+    }
+    const localSeenRefs = seenRefs || /* @__PURE__ */ new Set();
+    localSeenRefs.add(ref);
+    try {
+      const dereferenced = findRef(ref, definition);
+      if (isRef(dereferenced)) {
+        return dereferenceRef(dereferenced, definition, localSeenRefs);
+      }
+      const refName = ref.split("/").pop();
+      return {
+        ...dereferenced,
+        // Because dereferencing will eliminate any lineage back to the original `$ref`,
+        // information that we might need at some point, we should preserve the original schema
+        // name through a custom extension.
+        "x-readme-ref-name": refName
+      };
+    } catch {
+      return value;
+    }
+  }
+  return value;
+}
+function getDereferencingOptions(circularRefs) {
+  return {
+    resolve: {
+      // We shouldn't be resolving external pointers at this point so just ignore them.
+      external: false
+    },
+    dereference: {
+      // If circular `$refs` are ignored they'll remain in the schema as `$ref: String`, otherwise
+      // `$ref` just won't exist. This, in tandem with `onCircular`, allows us to do easy and
+      // accumulate a list of circular references.
+      circular: "ignore",
+      onCircular: (path) => {
+        circularRefs.add(`#${path.split("#")[1]}`);
+      }
+    }
+  };
+}
+
+// src/lib/openapi-to-json-schema.ts
 var UNSUPPORTED_SCHEMA_PROPS = [
   "example",
   // OpenAPI supports `example` but we're mapping it to `examples` in this library.
   "externalDocs",
   "xml"
 ];
-function encodePointer(str) {
-  return str.replace("~", "~0").replace("/", "~1");
-}
 function getSchemaVersionString(schema, api) {
   if (isOpenAPI30(api)) {
     return "http://json-schema.org/draft-04/schema#";
@@ -145,7 +219,7 @@ function searchForValueByPropAndPointer(property, pointer, schemas = []) {
         schema = schema.default;
       }
       try {
-        foundValue = jsonpointer.get(schema, pointers[i]);
+        foundValue = jsonpointer2.get(schema, pointers[i]);
       } catch {
       }
       if (foundValue !== void 0) {
@@ -168,8 +242,8 @@ function toJSONSchema(data, opts = {}) {
     hideReadOnlyProperties,
     hideWriteOnlyProperties,
     isPolymorphicAllOfChild,
-    prevDefaultSchemas,
-    prevExampleSchemas,
+    prevDefaultSchemas = [],
+    prevExampleSchemas = [],
     refLogger,
     transformer
   } = {
@@ -187,9 +261,7 @@ function toJSONSchema(data, opts = {}) {
   };
   if (isRef(schema)) {
     refLogger(schema.$ref, "ref");
-    return transformer({
-      $ref: schema.$ref
-    });
+    return transformer(schema);
   }
   if (isSchema(schema, isPolymorphicAllOfChild)) {
     if ("allOf" in schema && Array.isArray(schema.allOf)) {
@@ -207,6 +279,9 @@ function toJSONSchema(data, opts = {}) {
             // `merge-json-schema-allof` doesn't support merging enum arrays but since that's a
             // safe and simple operation as enums always contain primitives we can handle it
             // ourselves with a custom resolver.
+            //
+            // We unfortunately need to cast our return value as `any[]` because the internal types
+            // of `merge-json-schema-allof`'s `enum` resolver are not portable.
             enum: (obj) => {
               let arr = [];
               obj.forEach((e) => {
@@ -228,15 +303,16 @@ function toJSONSchema(data, opts = {}) {
       }
       if (isRef(schema)) {
         refLogger(schema.$ref, "ref");
-        return transformer({
-          $ref: schema.$ref
-        });
+        return transformer(schema);
       }
     }
     ["anyOf", "oneOf"].forEach((polyType) => {
       if (polyType in schema && Array.isArray(schema[polyType])) {
         const discriminatorPropertyName = "discriminator" in schema && schema.discriminator && isObject(schema.discriminator) ? schema.discriminator.propertyName : void 0;
         schema[polyType].forEach((item, idx) => {
+          if (!schema[polyType]?.[idx]) {
+            return;
+          }
           const polyOptions = {
             addEnumsToDescriptions,
             currentLocation: `${currentLocation}/${idx}`,
@@ -297,7 +373,7 @@ function toJSONSchema(data, opts = {}) {
     } else {
     }
   }
-  if ("type" in schema) {
+  if ("type" in schema && schema.type !== void 0) {
     if ("nullable" in schema) {
       if (schema.nullable) {
         if (Array.isArray(schema.type)) {
@@ -351,7 +427,7 @@ function toJSONSchema(data, opts = {}) {
               "required"
             ]
           }).forEach(([typeKey, keywords]) => {
-            if (!schema.type.includes(typeKey)) {
+            if (!schema.type?.includes(typeKey)) {
               return;
             }
             const reducedSchema = removeUndefinedObjects({
@@ -363,10 +439,10 @@ function toJSONSchema(data, opts = {}) {
               title: schema.title ?? void 0,
               writeOnly: schema.writeOnly ?? void 0
             });
-            keywords.forEach((t) => {
-              if (t in schema) {
-                reducedSchema[t] = schema[t];
-                delete schema[t];
+            keywords.forEach((keyword) => {
+              if (keyword in schema) {
+                reducedSchema[keyword] = schema[keyword];
+                delete schema[keyword];
               }
             });
             nonPrimitives.push(reducedSchema);
@@ -375,7 +451,7 @@ function toJSONSchema(data, opts = {}) {
           if (schema.type.length === 1) {
             schema.type = schema.type.shift();
           }
-          if (schema.type.length > 1) {
+          if (schema.type && schema.type.length > 1) {
             schema = { oneOf: [schema, ...nonPrimitives] };
           } else {
             schema = { oneOf: nonPrimitives };
@@ -402,10 +478,10 @@ function toJSONSchema(data, opts = {}) {
       delete schema.example;
     } else if ("examples" in schema) {
       let reshapedExamples = false;
-      if (typeof schema.examples === "object" && !Array.isArray(schema.examples)) {
+      if (typeof schema.examples === "object" && schema.examples !== null && !Array.isArray(schema.examples)) {
         const examples = [];
         Object.keys(schema.examples).forEach((name) => {
-          const example = schema.examples[name];
+          const example = schema.examples?.[name];
           if ("$ref" in example) {
             refLogger(example.$ref, "ref");
           } else if ("value" in example) {
@@ -442,7 +518,7 @@ function toJSONSchema(data, opts = {}) {
       }
     }
     if (hasSchemaType(schema, "array")) {
-      if ("items" in schema) {
+      if ("items" in schema && schema.items !== void 0) {
         if (!Array.isArray(schema.items) && Object.keys(schema.items).length === 1 && isRef(schema.items)) {
           refLogger(schema.items.$ref, "ref");
         } else if (schema.items !== true) {
@@ -466,9 +542,9 @@ function toJSONSchema(data, opts = {}) {
         schema.items = {};
       }
     } else if (hasSchemaType(schema, "object")) {
-      if ("properties" in schema) {
+      if ("properties" in schema && schema.properties !== void 0) {
         Object.keys(schema.properties).forEach((prop) => {
-          if (Array.isArray(schema.properties[prop]) || typeof schema.properties[prop] === "object" && schema.properties[prop] !== null) {
+          if (Array.isArray(schema.properties?.[prop]) || typeof schema.properties?.[prop] === "object" && schema.properties?.[prop] !== null) {
             const newPropSchema = toJSONSchema(schema.properties[prop], {
               addEnumsToDescriptions,
               currentLocation: `${currentLocation}/${encodePointer(prop)}`,
@@ -531,7 +607,7 @@ function toJSONSchema(data, opts = {}) {
   }
   if (isSchema(schema, isPolymorphicAllOfChild) && globalDefaults && Object.keys(globalDefaults).length > 0 && currentLocation) {
     try {
-      const userJwtDefault = jsonpointer.get(globalDefaults, currentLocation);
+      const userJwtDefault = jsonpointer2.get(globalDefaults, currentLocation);
       if (userJwtDefault) {
         schema.default = userJwtDefault;
       }
@@ -607,34 +683,34 @@ function getParametersAsJSONSchema(operation, api, opts) {
     }
   }
   function getDeprecated(schema, type) {
-    if (opts.retainDeprecatedProperties) {
+    if (opts?.retainDeprecatedProperties) {
       return null;
     }
     if (!schema || !schema.properties) return null;
     const deprecatedBody = cloneObject(schema);
     const requiredParams = schema.required || [];
     const allDeprecatedProps = {};
-    Object.keys(deprecatedBody.properties).forEach((key) => {
-      const deprecatedProp = deprecatedBody.properties[key];
+    Object.keys(deprecatedBody.properties || {}).forEach((key) => {
+      const deprecatedProp = deprecatedBody.properties?.[key];
       if (deprecatedProp.deprecated && !requiredParams.includes(key) && !deprecatedProp.readOnly) {
         allDeprecatedProps[key] = deprecatedProp;
       }
     });
     deprecatedBody.properties = allDeprecatedProps;
     const deprecatedSchema = toJSONSchema(deprecatedBody, {
-      globalDefaults: opts.globalDefaults,
-      hideReadOnlyProperties: opts.hideReadOnlyProperties,
-      hideWriteOnlyProperties: opts.hideWriteOnlyProperties,
+      globalDefaults: opts?.globalDefaults,
+      hideReadOnlyProperties: opts?.hideReadOnlyProperties,
+      hideWriteOnlyProperties: opts?.hideWriteOnlyProperties,
       prevExampleSchemas: [],
       refLogger,
-      transformer: opts.transformer
+      transformer: opts?.transformer
     });
-    if (Object.keys(deprecatedSchema).length === 0 || Object.keys(deprecatedSchema.properties).length === 0) {
+    if (Object.keys(deprecatedSchema).length === 0 || Object.keys(deprecatedSchema.properties || {}).length === 0) {
       return null;
     }
     Object.keys(schema.properties).forEach((key) => {
-      if (schema.properties[key].deprecated && !requiredParams.includes(key)) {
-        delete schema.properties[key];
+      if ((schema.properties?.[key]).deprecated && !requiredParams.includes(key)) {
+        delete schema.properties?.[key];
       }
     });
     return {
@@ -658,17 +734,22 @@ function getParametersAsJSONSchema(operation, api, opts) {
       prevExampleSchemas.push({ example: mediaTypeObject.example });
     } else if ("examples" in mediaTypeObject) {
       prevExampleSchemas.push({
-        examples: Object.values(mediaTypeObject.examples).map((example) => example.value).filter((val) => val !== void 0)
+        examples: Object.values(mediaTypeObject.examples || {}).map((example) => {
+          if (isRef(example)) {
+            return void 0;
+          }
+          return example.value;
+        }).filter((item) => item !== void 0)
       });
     }
     const requestSchema = cloneObject(mediaTypeObject.schema);
     const cleanedSchema = toJSONSchema(requestSchema, {
-      globalDefaults: opts.globalDefaults,
-      hideReadOnlyProperties: opts.hideReadOnlyProperties,
-      hideWriteOnlyProperties: opts.hideWriteOnlyProperties,
+      globalDefaults: opts?.globalDefaults,
+      hideReadOnlyProperties: opts?.hideReadOnlyProperties,
+      hideWriteOnlyProperties: opts?.hideWriteOnlyProperties,
       prevExampleSchemas,
       refLogger,
-      transformer: opts.transformer
+      transformer: opts?.transformer
     });
     if (!Object.keys(cleanedSchema).length) {
       return null;
@@ -680,34 +761,39 @@ function getParametersAsJSONSchema(operation, api, opts) {
         ...cleanedSchema,
         $schema: getSchemaVersionString(cleanedSchema, api)
       },
-      deprecatedProps: getDeprecated(cleanedSchema, type),
+      deprecatedProps: getDeprecated(cleanedSchema, type) ?? void 0,
       ...description ? { description } : {}
     };
   }
   function transformComponents() {
-    if (!("components" in api)) {
+    if (!("components" in api) || !api.components) {
       return false;
     }
     const components2 = {
       ...Object.keys(api.components).map((componentType) => ({ [componentType]: {} })).reduce((prev, next) => Object.assign(prev, next), {})
     };
     Object.keys(api.components).forEach((componentType) => {
-      if (typeof api.components[componentType] === "object" && !Array.isArray(api.components[componentType])) {
-        Object.keys(api.components[componentType]).forEach((schemaName) => {
-          const componentSchema = cloneObject(api.components[componentType][schemaName]);
-          components2[componentType][schemaName] = toJSONSchema(componentSchema, {
-            globalDefaults: opts.globalDefaults,
-            hideReadOnlyProperties: opts.hideReadOnlyProperties,
-            hideWriteOnlyProperties: opts.hideWriteOnlyProperties,
+      const cType = componentType;
+      if (typeof api.components?.[cType] === "object" && !Array.isArray(api.components[cType])) {
+        Object.keys(api.components?.[cType] || {}).forEach((schemaName) => {
+          const componentSchema = cloneObject(api.components?.[cType]?.[schemaName]);
+          if (!components2[cType]) {
+            components2[cType] = {};
+          }
+          components2[cType][schemaName] = toJSONSchema(componentSchema, {
+            globalDefaults: opts?.globalDefaults,
+            hideReadOnlyProperties: opts?.hideReadOnlyProperties,
+            hideWriteOnlyProperties: opts?.hideWriteOnlyProperties,
             refLogger,
-            transformer: opts.transformer
+            transformer: opts?.transformer
           });
         });
       }
     });
     Object.keys(components2).forEach((componentType) => {
-      if (!Object.keys(components2[componentType]).length) {
-        delete components2[componentType];
+      const cType = componentType;
+      if (!Object.keys(components2?.[cType] || {}).length) {
+        delete components2?.[cType];
       }
     });
     return components2;
@@ -732,11 +818,11 @@ function getParametersAsJSONSchema(operation, api, opts) {
           if (current.deprecated) currentSchema.deprecated = current.deprecated;
           const interimSchema = toJSONSchema(currentSchema, {
             currentLocation: `/${current.name}`,
-            globalDefaults: opts.globalDefaults,
-            hideReadOnlyProperties: opts.hideReadOnlyProperties,
-            hideWriteOnlyProperties: opts.hideWriteOnlyProperties,
+            globalDefaults: opts?.globalDefaults,
+            hideReadOnlyProperties: opts?.hideReadOnlyProperties,
+            hideWriteOnlyProperties: opts?.hideWriteOnlyProperties,
             refLogger,
-            transformer: opts.transformer
+            transformer: opts?.transformer
           });
           schema2 = isPrimitive(interimSchema) ? interimSchema : {
             ...interimSchema,
@@ -759,11 +845,11 @@ function getParametersAsJSONSchema(operation, api, opts) {
               if (current.deprecated) currentSchema.deprecated = current.deprecated;
               const interimSchema = toJSONSchema(currentSchema, {
                 currentLocation: `/${current.name}`,
-                globalDefaults: opts.globalDefaults,
-                hideReadOnlyProperties: opts.hideReadOnlyProperties,
-                hideWriteOnlyProperties: opts.hideWriteOnlyProperties,
+                globalDefaults: opts?.globalDefaults,
+                hideReadOnlyProperties: opts?.hideReadOnlyProperties,
+                hideWriteOnlyProperties: opts?.hideWriteOnlyProperties,
                 refLogger,
-                transformer: opts.transformer
+                transformer: opts?.transformer
               });
               schema2 = isPrimitive(interimSchema) ? interimSchema : {
                 ...interimSchema,
@@ -795,10 +881,10 @@ function getParametersAsJSONSchema(operation, api, opts) {
         type,
         label: types[type],
         schema,
-        deprecatedProps: getDeprecated(schema, type)
+        deprecatedProps: getDeprecated(schema, type) ?? void 0
       };
-    }).filter(Boolean);
-    if (!opts.mergeIntoBodyAndMetadata) {
+    }).filter((item) => item !== null);
+    if (!opts?.mergeIntoBodyAndMetadata) {
       return transformed;
     } else if (!transformed.length) {
       return [];
@@ -816,7 +902,7 @@ function getParametersAsJSONSchema(operation, api, opts) {
           schema: {
             allOf: deprecatedProps
           }
-        } : null
+        } : void 0
       }
     ];
   }
@@ -826,8 +912,8 @@ function getParametersAsJSONSchema(operation, api, opts) {
   const typeKeys = getExtension(PARAMETER_ORDERING, api, operation).map((k) => k.toLowerCase());
   typeKeys[typeKeys.indexOf("form")] = "formData";
   typeKeys.push("metadata");
-  const jsonSchema = [transformRequestBody()].concat(...transformParameters()).filter(Boolean);
-  const shouldIncludeComponents = hasCircularRefs || hasDiscriminatorMappingRefs && opts.includeDiscriminatorMappingRefs;
+  const jsonSchema = [transformRequestBody()].concat(...transformParameters()).filter((item) => item !== null);
+  const shouldIncludeComponents = hasCircularRefs || hasDiscriminatorMappingRefs && opts?.includeDiscriminatorMappingRefs;
   const components = shouldIncludeComponents ? transformComponents() : false;
   return jsonSchema.map((group) => {
     if (components && shouldIncludeComponents) {
@@ -842,6 +928,9 @@ function getParametersAsJSONSchema(operation, api, opts) {
 
 export {
   cloneObject,
+  decodePointer,
+  dereferenceRef,
+  getDereferencingOptions,
   isObject,
   isPrimitive,
   matches_mimetype_default,
@@ -851,4 +940,4 @@ export {
   types,
   getParametersAsJSONSchema
 };
-//# sourceMappingURL=chunk-SH63AK3O.js.map
+//# sourceMappingURL=chunk-5EP6HY2E.js.map

package/.output/server/node_modules/oas/dist/{chunk-L3V5TF63.js → chunk-7MARUOFZ.js}

@@ -9,13 +9,7 @@ function isRef(check) {
 }
 var isSwagger = assertSwagger;
 var isOpenAPI30 = assertOpenAPI30;
-function isOAS30(check) {
-  return "openapi" in check && check.openapi !== void 0 && check.openapi.startsWith("3.0");
-}
 var isOpenAPI31 = assertOpenAPI31;
-function isOAS31(check) {
-  return "openapi" in check && check.openapi !== void 0 && check.openapi.startsWith("3.1");
-}
 function isSchema(check, isPolymorphicAllOfChild = false) {
   return check.type !== void 0 || check.allOf !== void 0 || check.anyOf !== void 0 || check.oneOf !== void 0 || isPolymorphicAllOfChild;
 }
@@ -24,9 +18,7 @@ export {
   isRef,
   isSwagger,
   isOpenAPI30,
-  isOAS30,
   isOpenAPI31,
-  isOAS31,
   isSchema
 };
-//# sourceMappingURL=chunk-L3V5TF63.js.map
+//# sourceMappingURL=chunk-7MARUOFZ.js.map