@scalar/postman-to-openapi 0.3.58 → 0.4.0

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # @scalar/postman-to-openapi
 
+## 0.4.0
+
+### Minor Changes
+
+- [#7571](https://github.com/scalar/scalar/pull/7571): feat: major refactor, improves everything, keeps all the data now
+
+## 0.3.60
+
+### Patch Changes
+
+#### Updated Dependencies
+
+- **@scalar/helpers@0.2.8**
+  - [#7751](https://github.com/scalar/scalar/pull/7751): fix: auth persistence
+
+## 0.3.59
+
+### Patch Changes
+
+- [#7626](https://github.com/scalar/scalar/pull/7626): fix: remove `@scalar/oas-utils` unused dependency
+
 ## 0.3.58
 
 ### Patch Changes

package/dist/convert.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"convert.d.ts","sourceRoot":"","sources":["../src/convert.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AASxD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AA2BhD;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,iBAAiB,EAAE,iBAAiB,GAAG,MAAM,GAAG,WAAW,CAAC,QAAQ,CA+J3F"}
+{"version":3,"file":"convert.d.ts","sourceRoot":"","sources":["../src/convert.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAYxD,OAAO,KAAK,EAAgC,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAkL9E;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,iBAAiB,EAAE,iBAAiB,GAAG,MAAM,GAAG,WAAW,CAAC,QAAQ,CA6I3F"}

package/dist/convert.js

@@ -1,168 +1,233 @@
-import { processAuth } from './helpers/authHelpers.js';
-import { processExternalDocs } from './helpers/externalDocsHelper.js';
-import { processItem } from './helpers/itemHelpers.js';
-import { processLicenseAndContact } from './helpers/licenseContactHelper.js';
-import { processLogo } from './helpers/logoHelper.js';
-import { parseServers } from './helpers/serverHelpers.js';
-import { normalizePath } from './helpers/urlHelpers.js';
-/**
- * Extracts tags from Postman collection folders
- */
-function extractTags(items) {
-    const tags = [];
-    function processTagItem(item, parentPath = '') {
-        if (item.item) {
-            const currentPath = parentPath ? `${parentPath} > ${item.name}` : item.name;
-            // Add tag for the current folder
-            tags.push({
-                name: currentPath,
-                ...(item.description && { description: item.description }),
-            });
-            // Process nested folders
-            item.item.forEach((subItem) => processTagItem(subItem, currentPath));
-        }
+import { processAuth } from "./helpers/auth.js";
+import { processContact } from "./helpers/contact.js";
+import { processExternalDocs } from "./helpers/external-docs.js";
+import { processLicense } from "./helpers/license.js";
+import { processLogo } from "./helpers/logo.js";
+import { processItem } from "./helpers/path-items.js";
+import { pruneDocument } from "./helpers/prune-document.js";
+import { analyzeServerDistribution } from "./helpers/servers.js";
+import { normalizePath } from "./helpers/urls.js";
+const OPERATION_KEYS = [
+  "get",
+  "put",
+  "post",
+  "delete",
+  "options",
+  "head",
+  "patch",
+  "trace"
+];
+const normalizeDescription = (description) => {
+  if (typeof description === "string") {
+    return description;
+  }
+  return description?.content;
+};
+const parseCollectionInput = (postmanCollection) => {
+  if (typeof postmanCollection !== "string") {
+    return postmanCollection;
+  }
+  try {
+    return JSON.parse(postmanCollection);
+  } catch (error) {
+    const details = error instanceof Error ? error.message : "Unknown parse error";
+    const parseError = new Error(`Invalid Postman collection JSON: ${details}`);
+    parseError.name = "PostmanCollectionParseError";
+    throw parseError;
+  }
+};
+const validateCollectionShape = (collection) => {
+  if (!collection || typeof collection !== "object") {
+    throw new Error("Invalid Postman collection: expected an object");
+  }
+  const candidate = collection;
+  if (!candidate.info) {
+    throw new Error("Missing required info on Postman collection");
+  }
+  if (!candidate.item || !Array.isArray(candidate.item)) {
+    throw new Error("Invalid Postman collection: item must be an array");
+  }
+  if (typeof candidate.info !== "object") {
+    throw new Error("Invalid Postman collection: info must be an object");
+  }
+  if (!candidate.info.name) {
+    throw new Error("Missing required info.name on Postman collection");
+  }
+  if (!candidate.info.schema) {
+    throw new Error("Invalid Postman collection: missing info.schema");
+  }
+  if (candidate.variable && !Array.isArray(candidate.variable)) {
+    throw new Error("Invalid Postman collection: variable must be an array when provided");
+  }
+  return candidate;
+};
+const isItemGroup = (item) => "item" in item && Array.isArray(item.item);
+const extractTags = (items) => {
+  const collectTags = (item, parentPath = "") => {
+    if (!isItemGroup(item)) {
+      return [];
     }
-    items.forEach((item) => processTagItem(item));
-    return tags;
-}
-/**
- * Converts a Postman Collection to an OpenAPI 3.1.0 document.
- * This function processes the collection's information, servers, authentication,
- * and items to create a corresponding OpenAPI structure.
- */
-export function convert(postmanCollection) {
-    // Parse string input if provided
-    const collection = typeof postmanCollection === 'string' ? JSON.parse(postmanCollection) : postmanCollection;
-    // Extract title from collection info, fallback to 'API' if not provided
-    const title = collection.info.name || 'API';
-    // Look for version in collection variables, default to '1.0.0'
-    const version = collection.variable?.find((v) => v.key === 'version')?.value || '1.0.0';
-    // Handle different description formats in Postman
-    const description = typeof collection.info.description === 'string'
-        ? collection.info.description
-        : collection.info.description?.content || '';
-    // Process license and contact information
-    const { license, contact } = processLicenseAndContact(collection);
-    // Process logo information
-    const logo = processLogo(collection);
-    // Initialize the OpenAPI document with required fields
-    const openapi = {
-        openapi: '3.1.0',
-        info: {
-            title,
-            version,
-            ...(description && { description }),
-            ...(license && { license }),
-            ...(contact && { contact }),
-            ...(logo && { 'x-logo': logo }),
-        },
-        servers: parseServers(collection),
-        paths: {},
-    };
-    // Process external docs
-    const externalDocs = processExternalDocs(collection);
-    if (externalDocs) {
-        openapi.externalDocs = externalDocs;
+    const nextPath = item.name ? parentPath ? `${parentPath} > ${item.name}` : item.name : parentPath;
+    const description = normalizeDescription(item.description);
+    const currentTag = item.name?.length ? [
+      {
+        name: nextPath,
+        ...description && { description }
+      }
+    ] : [];
+    return [...currentTag, ...item.item.flatMap((subItem) => collectTags(subItem, nextPath))];
+  };
+  return items.flatMap((item) => collectTags(item));
+};
+const mergeSecuritySchemes = (openapi, securitySchemes) => {
+  if (!securitySchemes || Object.keys(securitySchemes).length === 0) {
+    return;
+  }
+  openapi.components = openapi.components || {};
+  openapi.components.securitySchemes = {
+    ...openapi.components.securitySchemes ?? {},
+    ...securitySchemes
+  };
+};
+const mergePathItem = (paths, normalizedPathKey, pathItem) => {
+  const targetPath = paths[normalizedPathKey] ?? {};
+  for (const [key, value] of Object.entries(pathItem)) {
+    if (value === void 0) {
+      continue;
+    }
+    const isOperationKey = OPERATION_KEYS.includes(key);
+    if (isOperationKey && targetPath[key]) {
+      const operationName = typeof key === "string" ? key.toUpperCase() : String(key);
+      console.warn(
+        `Duplicate operation detected for ${operationName} ${normalizedPathKey}. Last operation will overwrite previous.`
+      );
     }
-    // Process authentication if present in the collection
-    if (collection.auth) {
-        const { securitySchemes, security } = processAuth(collection.auth);
-        openapi.components = openapi.components || {};
-        openapi.components.securitySchemes = {
-            ...openapi.components.securitySchemes,
-            ...securitySchemes,
-        };
-        openapi.security = security;
+    targetPath[key] = value;
+  }
+  paths[normalizedPathKey] = targetPath;
+};
+const cleanupOperations = (paths) => {
+  Object.values(paths).forEach((pathItem) => {
+    if (!pathItem) {
+      return;
     }
-    // Process each item in the collection and merge into OpenAPI spec
-    if (collection.item) {
-        // Extract tags from folders
-        const tags = extractTags(collection.item);
-        if (tags.length > 0) {
-            openapi.tags = tags;
+    OPERATION_KEYS.forEach((operationKey) => {
+      const operation = pathItem[operationKey];
+      if (!operation) {
+        return;
+      }
+      if ("parameters" in operation && operation.parameters?.length === 0) {
+        delete operation.parameters;
+      }
+      if ("requestBody" in operation && operation.requestBody && "content" in operation.requestBody) {
+        const content = operation.requestBody.content;
+        if (content && "text/plain" in content) {
+          const text = content["text/plain"];
+          if (!text?.schema || text.schema && Object.keys(text.schema).length === 0) {
+            content["text/plain"] = {};
+          }
         }
-        collection.item.forEach((item) => {
-            const { paths: itemPaths, components: itemComponents } = processItem(item);
-            // Merge paths from the current item
-            openapi.paths = openapi.paths || {};
-            for (const [pathKey, pathItem] of Object.entries(itemPaths)) {
-                // Convert colon-style params to curly brace style
-                const normalizedPathKey = normalizePath(pathKey);
-                if (!pathItem) {
-                    continue;
-                }
-                if (!openapi.paths[normalizedPathKey]) {
-                    openapi.paths[normalizedPathKey] = pathItem;
-                }
-                else {
-                    openapi.paths[normalizedPathKey] = {
-                        ...openapi.paths[normalizedPathKey],
-                        ...pathItem,
-                    };
-                }
-            }
-            // Merge security schemes from the current item
-            if (itemComponents?.securitySchemes) {
-                openapi.components = openapi.components || {};
-                openapi.components.securitySchemes = {
-                    ...openapi.components.securitySchemes,
-                    ...itemComponents.securitySchemes,
-                };
-            }
-        });
+      }
+      if (!operation.description) {
+        delete operation.description;
+      }
+    });
+  });
+};
+function convert(postmanCollection) {
+  const collection = validateCollectionShape(parseCollectionInput(postmanCollection));
+  const title = collection.info.name || "API";
+  const version = collection.variable?.find((v) => v.key === "version")?.value || "1.0.0";
+  const description = normalizeDescription(collection.info.description) || "";
+  const license = processLicense(collection);
+  const contact = processContact(collection);
+  const logo = processLogo(collection);
+  const openapi = {
+    openapi: "3.1.0",
+    info: {
+      title,
+      version,
+      ...description && { description },
+      ...license && { license },
+      ...contact && { contact },
+      ...logo && { "x-logo": logo }
+    },
+    paths: {}
+  };
+  const externalDocs = processExternalDocs(collection);
+  if (externalDocs) {
+    openapi.externalDocs = externalDocs;
+  }
+  if (collection.auth) {
+    const { securitySchemes, security } = processAuth(collection.auth);
+    mergeSecuritySchemes(openapi, securitySchemes);
+    openapi.security = security;
+  }
+  const allServerUsage = [];
+  if (collection.item) {
+    const tags = extractTags(collection.item);
+    if (tags.length > 0) {
+      openapi.tags = tags;
     }
-    // Clean up the generated paths
-    if (openapi.paths) {
-        Object.values(openapi.paths).forEach((path) => {
-            if (path) {
-                Object.values(path).forEach((method) => {
-                    if (method && 'parameters' in method) {
-                        // Remove empty parameters array to keep spec clean
-                        if (method.parameters?.length === 0) {
-                            delete method.parameters;
-                        }
-                        // Handle request bodies
-                        if (method.requestBody?.content) {
-                            const content = method.requestBody.content;
-                            if (Object.keys(content).length === 0) {
-                                // Keep an empty requestBody with text/plain content
-                                method.requestBody = {
-                                    content: {
-                                        'text/plain': {},
-                                    },
-                                };
-                            }
-                            else if ('text/plain' in content) {
-                                // Preserve schema if it exists, otherwise keep an empty object
-                                if (!content['text/plain'].schema || Object.keys(content['text/plain'].schema).length === 0) {
-                                    content['text/plain'] = {};
-                                }
-                            }
-                        }
-                        // Ensure all methods have a description, but don't add an empty one if it doesn't exist
-                        if (!method.description) {
-                            delete method.description;
-                        }
-                    }
-                });
-            }
-        });
+    collection.item.forEach((item) => {
+      const { paths: itemPaths, components: itemComponents, serverUsage } = processItem(item);
+      allServerUsage.push(...serverUsage);
+      openapi.paths = openapi.paths || {};
+      for (const [pathKey, pathItem] of Object.entries(itemPaths)) {
+        const normalizedPathKey = normalizePath(pathKey);
+        if (!pathItem) {
+          continue;
+        }
+        mergePathItem(openapi.paths, normalizedPathKey, pathItem);
+      }
+      if (itemComponents?.securitySchemes) {
+        mergeSecuritySchemes(openapi, itemComponents.securitySchemes);
+      }
+    });
+  }
+  const allUniquePaths = /* @__PURE__ */ new Set();
+  if (openapi.paths) {
+    for (const pathKey of Object.keys(openapi.paths)) {
+      allUniquePaths.add(pathKey);
     }
-    // Remove empty components object
-    if (Object.keys(openapi.components || {}).length === 0) {
-        delete openapi.components;
+  }
+  const serverPlacement = analyzeServerDistribution(allServerUsage, allUniquePaths);
+  if (serverPlacement.document.length > 0) {
+    openapi.servers = serverPlacement.document;
+  }
+  if (openapi.paths) {
+    for (const [path, servers] of serverPlacement.pathItems.entries()) {
+      const normalizedPathKey = normalizePath(path);
+      const pathItem = openapi.paths[normalizedPathKey];
+      if (pathItem) {
+        pathItem.servers = servers;
+      }
     }
-    // Remove undefined properties recursively
-    const removeUndefined = (obj) => {
-        if (Array.isArray(obj)) {
-            return obj.map(removeUndefined).filter((item) => item !== undefined);
-        }
-        if (obj && typeof obj === 'object') {
-            return Object.fromEntries(Object.entries(obj)
-                .map(([key, value]) => [key, removeUndefined(value)])
-                .filter(([_, value]) => value !== undefined));
+    for (const [path, methods] of serverPlacement.operations.entries()) {
+      const normalizedPathKey = normalizePath(path);
+      const pathItem = openapi.paths[normalizedPathKey];
+      if (!pathItem) {
+        continue;
+      }
+      for (const [method, servers] of methods.entries()) {
+        if (method in pathItem) {
+          const operation = pathItem[method];
+          if (operation && typeof operation === "object" && "responses" in operation) {
+            operation.servers = servers;
+          }
         }
-        return obj;
-    };
-    return removeUndefined(openapi);
+      }
+    }
+  }
+  if (openapi.paths) {
+    cleanupOperations(openapi.paths);
+  }
+  if (Object.keys(openapi.components || {}).length === 0) {
+    delete openapi.components;
+  }
+  return pruneDocument(openapi);
 }
+export {
+  convert
+};
+//# sourceMappingURL=convert.js.map

package/dist/convert.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/convert.ts"],
-  "sourcesContent": ["import type { OpenAPIV3_1 } from '@scalar/openapi-types'\n\nimport { processAuth } from './helpers/authHelpers'\nimport { processExternalDocs } from './helpers/externalDocsHelper'\nimport { processItem } from './helpers/itemHelpers'\nimport { processLicenseAndContact } from './helpers/licenseContactHelper'\nimport { processLogo } from './helpers/logoHelper'\nimport { parseServers } from './helpers/serverHelpers'\nimport { normalizePath } from './helpers/urlHelpers'\nimport type { PostmanCollection } from './types'\n\n/**\n * Extracts tags from Postman collection folders\n */\nfunction extractTags(items: PostmanCollection['item']): OpenAPIV3_1.TagObject[] {\n  const tags: OpenAPIV3_1.TagObject[] = []\n\n  function processTagItem(item: any, parentPath: string = '') {\n    if (item.item) {\n      const currentPath = parentPath ? `${parentPath} > ${item.name}` : item.name\n\n      // Add tag for the current folder\n      tags.push({\n        name: currentPath,\n        ...(item.description && { description: item.description }),\n      })\n\n      // Process nested folders\n      item.item.forEach((subItem: any) => processTagItem(subItem, currentPath))\n    }\n  }\n\n  items.forEach((item) => processTagItem(item))\n  return tags\n}\n\n/**\n * Converts a Postman Collection to an OpenAPI 3.1.0 document.\n * This function processes the collection's information, servers, authentication,\n * and items to create a corresponding OpenAPI structure.\n */\nexport function convert(postmanCollection: PostmanCollection | string): OpenAPIV3_1.Document {\n  // Parse string input if provided\n  const collection: PostmanCollection =\n    typeof postmanCollection === 'string' ? JSON.parse(postmanCollection) : postmanCollection\n\n  // Extract title from collection info, fallback to 'API' if not provided\n  const title = collection.info.name || 'API'\n\n  // Look for version in collection variables, default to '1.0.0'\n  const version = (collection.variable?.find((v) => v.key === 'version')?.value as string) || '1.0.0'\n\n  // Handle different description formats in Postman\n  const description =\n    typeof collection.info.description === 'string'\n      ? collection.info.description\n      : collection.info.description?.content || ''\n\n  // Process license and contact information\n  const { license, contact } = processLicenseAndContact(collection)\n\n  // Process logo information\n  const logo = processLogo(collection)\n\n  // Initialize the OpenAPI document with required fields\n  const openapi: OpenAPIV3_1.Document = {\n    openapi: '3.1.0',\n    info: {\n      title,\n      version,\n      ...(description && { description }),\n      ...(license && { license }),\n      ...(contact && { contact }),\n      ...(logo && { 'x-logo': logo }),\n    },\n    servers: parseServers(collection),\n    paths: {},\n  }\n\n  // Process external docs\n  const externalDocs = processExternalDocs(collection)\n  if (externalDocs) {\n    openapi.externalDocs = externalDocs\n  }\n\n  // Process authentication if present in the collection\n  if (collection.auth) {\n    const { securitySchemes, security } = processAuth(collection.auth)\n    openapi.components = openapi.components || {}\n    openapi.components.securitySchemes = {\n      ...openapi.components.securitySchemes,\n      ...securitySchemes,\n    }\n    openapi.security = security\n  }\n\n  // Process each item in the collection and merge into OpenAPI spec\n  if (collection.item) {\n    // Extract tags from folders\n    const tags = extractTags(collection.item)\n    if (tags.length > 0) {\n      openapi.tags = tags\n    }\n\n    collection.item.forEach((item) => {\n      const { paths: itemPaths, components: itemComponents } = processItem(item)\n\n      // Merge paths from the current item\n      openapi.paths = openapi.paths || {}\n      for (const [pathKey, pathItem] of Object.entries(itemPaths)) {\n        // Convert colon-style params to curly brace style\n        const normalizedPathKey = normalizePath(pathKey)\n\n        if (!pathItem) {\n          continue\n        }\n\n        if (!openapi.paths[normalizedPathKey]) {\n          openapi.paths[normalizedPathKey] = pathItem\n        } else {\n          openapi.paths[normalizedPathKey] = {\n            ...openapi.paths[normalizedPathKey],\n            ...pathItem,\n          }\n        }\n      }\n\n      // Merge security schemes from the current item\n      if (itemComponents?.securitySchemes) {\n        openapi.components = openapi.components || {}\n        openapi.components.securitySchemes = {\n          ...openapi.components.securitySchemes,\n          ...itemComponents.securitySchemes,\n        }\n      }\n    })\n  }\n\n  // Clean up the generated paths\n  if (openapi.paths) {\n    Object.values(openapi.paths).forEach((path) => {\n      if (path) {\n        Object.values(path).forEach((method) => {\n          if (method && 'parameters' in method) {\n            // Remove empty parameters array to keep spec clean\n            if (method.parameters?.length === 0) {\n              delete method.parameters\n            }\n\n            // Handle request bodies\n            if (method.requestBody?.content) {\n              const content = method.requestBody.content\n              if (Object.keys(content).length === 0) {\n                // Keep an empty requestBody with text/plain content\n                method.requestBody = {\n                  content: {\n                    'text/plain': {},\n                  },\n                }\n              } else if ('text/plain' in content) {\n                // Preserve schema if it exists, otherwise keep an empty object\n                if (!content['text/plain'].schema || Object.keys(content['text/plain'].schema).length === 0) {\n                  content['text/plain'] = {}\n                }\n              }\n            }\n\n            // Ensure all methods have a description, but don't add an empty one if it doesn't exist\n            if (!method.description) {\n              delete method.description\n            }\n          }\n        })\n      }\n    })\n  }\n\n  // Remove empty components object\n  if (Object.keys(openapi.components || {}).length === 0) {\n    delete openapi.components\n  }\n\n  // Remove undefined properties recursively\n  const removeUndefined = (obj: any): any => {\n    if (Array.isArray(obj)) {\n      return obj.map(removeUndefined).filter((item) => item !== undefined)\n    }\n\n    if (obj && typeof obj === 'object') {\n      return Object.fromEntries(\n        Object.entries(obj)\n          .map(([key, value]) => [key, removeUndefined(value)])\n          .filter(([_, value]) => value !== undefined),\n      )\n    }\n\n    return obj\n  }\n\n  return removeUndefined(openapi)\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import type { OpenAPIV3_1 } from '@scalar/openapi-types'\n\nimport { processAuth } from '@/helpers/auth'\nimport { processContact } from '@/helpers/contact'\nimport { processExternalDocs } from '@/helpers/external-docs'\nimport { processLicense } from '@/helpers/license'\nimport { processLogo } from '@/helpers/logo'\nimport { processItem } from '@/helpers/path-items'\nimport { pruneDocument } from '@/helpers/prune-document'\nimport { analyzeServerDistribution } from '@/helpers/servers'\nimport { normalizePath } from '@/helpers/urls'\n\nimport type { Description, Item, ItemGroup, PostmanCollection } from './types'\n\nconst OPERATION_KEYS: readonly (keyof OpenAPIV3_1.PathItemObject)[] = [\n  'get',\n  'put',\n  'post',\n  'delete',\n  'options',\n  'head',\n  'patch',\n  'trace',\n]\n\nconst normalizeDescription = (description?: Description): string | undefined => {\n  if (typeof description === 'string') {\n    return description\n  }\n\n  return description?.content\n}\n\nconst parseCollectionInput = (postmanCollection: PostmanCollection | string): unknown => {\n  if (typeof postmanCollection !== 'string') {\n    return postmanCollection\n  }\n\n  try {\n    return JSON.parse(postmanCollection) as PostmanCollection\n  } catch (error) {\n    const details = error instanceof Error ? error.message : 'Unknown parse error'\n    const parseError = new Error(`Invalid Postman collection JSON: ${details}`)\n    parseError.name = 'PostmanCollectionParseError'\n    throw parseError\n  }\n}\n\nconst validateCollectionShape = (collection: unknown): PostmanCollection => {\n  if (!collection || typeof collection !== 'object') {\n    throw new Error('Invalid Postman collection: expected an object')\n  }\n\n  const candidate = collection as Partial<PostmanCollection>\n\n  if (!candidate.info) {\n    throw new Error('Missing required info on Postman collection')\n  }\n\n  if (!candidate.item || !Array.isArray(candidate.item)) {\n    throw new Error('Invalid Postman collection: item must be an array')\n  }\n\n  if (typeof candidate.info !== 'object') {\n    throw new Error('Invalid Postman collection: info must be an object')\n  }\n\n  if (!candidate.info.name) {\n    throw new Error('Missing required info.name on Postman collection')\n  }\n\n  if (!candidate.info.schema) {\n    throw new Error('Invalid Postman collection: missing info.schema')\n  }\n\n  if (candidate.variable && !Array.isArray(candidate.variable)) {\n    throw new Error('Invalid Postman collection: variable must be an array when provided')\n  }\n\n  return candidate as PostmanCollection\n}\n\n/**\n * Extracts tags from Postman collection folders.\n * We keep folder nesting using \" > \" so tag names stay readable while preserving hierarchy.\n * Requests do not produce tags; only folders are reflected as tags.\n */\nconst isItemGroup = (item: Item | ItemGroup): item is ItemGroup => 'item' in item && Array.isArray(item.item)\n\nconst extractTags = (items: PostmanCollection['item']): OpenAPIV3_1.TagObject[] => {\n  const collectTags = (item: Item | ItemGroup, parentPath: string = ''): OpenAPIV3_1.TagObject[] => {\n    if (!isItemGroup(item)) {\n      return []\n    }\n\n    const nextPath = item.name ? (parentPath ? `${parentPath} > ${item.name}` : item.name) : parentPath\n    const description = normalizeDescription(item.description)\n    const currentTag: OpenAPIV3_1.TagObject[] = item.name?.length\n      ? [\n          {\n            name: nextPath,\n            ...(description && { description }),\n          },\n        ]\n      : []\n\n    return [...currentTag, ...item.item.flatMap((subItem) => collectTags(subItem, nextPath))]\n  }\n\n  return items.flatMap((item) => collectTags(item))\n}\n\nconst mergeSecuritySchemes = (\n  openapi: OpenAPIV3_1.Document,\n  securitySchemes?: OpenAPIV3_1.ComponentsObject['securitySchemes'],\n): void => {\n  if (!securitySchemes || Object.keys(securitySchemes).length === 0) {\n    return\n  }\n\n  openapi.components = openapi.components || {}\n  openapi.components.securitySchemes = {\n    ...(openapi.components.securitySchemes ?? {}),\n    ...securitySchemes,\n  }\n}\n\nconst mergePathItem = (\n  paths: OpenAPIV3_1.PathsObject,\n  normalizedPathKey: string,\n  pathItem: OpenAPIV3_1.PathItemObject,\n): void => {\n  const targetPath = (paths[normalizedPathKey] ?? {}) as OpenAPIV3_1.PathItemObject\n\n  for (const [key, value] of Object.entries(pathItem) as [\n    keyof OpenAPIV3_1.PathItemObject,\n    OpenAPIV3_1.PathItemObject[keyof OpenAPIV3_1.PathItemObject],\n  ][]) {\n    if (value === undefined) {\n      continue\n    }\n\n    const isOperationKey = OPERATION_KEYS.includes(key)\n\n    if (isOperationKey && targetPath[key]) {\n      const operationName = typeof key === 'string' ? key.toUpperCase() : String(key)\n      console.warn(\n        `Duplicate operation detected for ${operationName} ${normalizedPathKey}. Last operation will overwrite previous.`,\n      )\n    }\n\n    targetPath[key] = value\n  }\n\n  paths[normalizedPathKey] = targetPath\n}\n\nconst cleanupOperations = (paths: OpenAPIV3_1.PathsObject): void => {\n  Object.values(paths).forEach((pathItem) => {\n    if (!pathItem) {\n      return\n    }\n\n    OPERATION_KEYS.forEach((operationKey) => {\n      const operation = pathItem[operationKey]\n      if (!operation) {\n        return\n      }\n\n      if ('parameters' in operation && operation.parameters?.length === 0) {\n        delete operation.parameters\n      }\n\n      if ('requestBody' in operation && operation.requestBody && 'content' in operation.requestBody) {\n        const content = operation.requestBody.content\n        if (content && 'text/plain' in content) {\n          const text = content['text/plain']\n          if (!text?.schema || (text.schema && Object.keys(text.schema).length === 0)) {\n            content['text/plain'] = {}\n          }\n        }\n      }\n\n      if (!operation.description) {\n        delete operation.description\n      }\n    })\n  })\n}\n\n/**\n * Converts a Postman Collection to an OpenAPI 3.1.0 document.\n * This function processes the collection's information, servers, authentication,\n * and items to create a corresponding OpenAPI structure.\n */\nexport function convert(postmanCollection: PostmanCollection | string): OpenAPIV3_1.Document {\n  const collection = validateCollectionShape(parseCollectionInput(postmanCollection))\n\n  // Extract title from collection info, fallback to 'API' if not provided\n  const title = collection.info.name || 'API'\n\n  // Look for version in collection variables, default to '1.0.0'\n  const version = (collection.variable?.find((v) => v.key === 'version')?.value as string) || '1.0.0'\n\n  // Handle different description formats in Postman\n  const description = normalizeDescription(collection.info.description) || ''\n\n  // Process license and contact information\n  const license = processLicense(collection)\n  const contact = processContact(collection)\n\n  // Process logo information\n  const logo = processLogo(collection)\n\n  // Initialize the OpenAPI document with required fields\n  const openapi: OpenAPIV3_1.Document = {\n    openapi: '3.1.0',\n    info: {\n      title,\n      version,\n      ...(description && { description }),\n      ...(license && { license }),\n      ...(contact && { contact }),\n      ...(logo && { 'x-logo': logo }),\n    },\n    paths: {},\n  }\n\n  // Process external docs\n  const externalDocs = processExternalDocs(collection)\n  if (externalDocs) {\n    openapi.externalDocs = externalDocs\n  }\n\n  // Process authentication if present in the collection\n  if (collection.auth) {\n    const { securitySchemes, security } = processAuth(collection.auth)\n    mergeSecuritySchemes(openapi, securitySchemes)\n    openapi.security = security\n  }\n\n  // Process each item in the collection and merge into OpenAPI spec\n  const allServerUsage: Array<{\n    serverUrl: string\n    path: string\n    method: 'get' | 'put' | 'post' | 'delete' | 'options' | 'head' | 'patch' | 'trace'\n  }> = []\n\n  if (collection.item) {\n    // Extract tags from folders\n    const tags = extractTags(collection.item)\n    if (tags.length > 0) {\n      openapi.tags = tags\n    }\n\n    collection.item.forEach((item) => {\n      const { paths: itemPaths, components: itemComponents, serverUsage } = processItem(item)\n\n      // Collect server usage information\n      allServerUsage.push(...serverUsage)\n\n      // Merge paths from the current item\n      openapi.paths = openapi.paths || {}\n      for (const [pathKey, pathItem] of Object.entries(itemPaths)) {\n        // Convert colon-style params to curly brace style\n        const normalizedPathKey = normalizePath(pathKey)\n\n        if (!pathItem) {\n          continue\n        }\n\n        mergePathItem(openapi.paths, normalizedPathKey, pathItem)\n      }\n\n      // Merge security schemes from the current item\n      if (itemComponents?.securitySchemes) {\n        mergeSecuritySchemes(openapi, itemComponents.securitySchemes)\n      }\n    })\n  }\n\n  // Extract all unique paths from the document\n  const allUniquePaths = new Set<string>()\n  if (openapi.paths) {\n    for (const pathKey of Object.keys(openapi.paths)) {\n      allUniquePaths.add(pathKey)\n    }\n  }\n\n  // Analyze server distribution and place servers at appropriate levels\n  const serverPlacement = analyzeServerDistribution(allServerUsage, allUniquePaths)\n\n  // Add servers to document level\n  if (serverPlacement.document.length > 0) {\n    openapi.servers = serverPlacement.document\n  }\n\n  // Add servers to path items\n  if (openapi.paths) {\n    for (const [path, servers] of serverPlacement.pathItems.entries()) {\n      const normalizedPathKey = normalizePath(path)\n      const pathItem = openapi.paths[normalizedPathKey]\n      if (pathItem) {\n        pathItem.servers = servers\n      }\n    }\n\n    // Add servers to operations\n    for (const [path, methods] of serverPlacement.operations.entries()) {\n      const normalizedPathKey = normalizePath(path)\n      const pathItem = openapi.paths[normalizedPathKey]\n      if (!pathItem) {\n        continue\n      }\n      for (const [method, servers] of methods.entries()) {\n        if (method in pathItem) {\n          const operation = pathItem[method as keyof typeof pathItem]\n          if (operation && typeof operation === 'object' && 'responses' in operation) {\n            operation.servers = servers\n          }\n        }\n      }\n    }\n  }\n\n  // Clean up the generated paths\n  if (openapi.paths) {\n    cleanupOperations(openapi.paths)\n  }\n\n  // Remove empty components object\n  if (Object.keys(openapi.components || {}).length === 0) {\n    delete openapi.components\n  }\n\n  return pruneDocument(openapi)\n}\n"],
+  "mappings": "AAEA,SAAS,mBAAmB;AAC5B,SAAS,sBAAsB;AAC/B,SAAS,2BAA2B;AACpC,SAAS,sBAAsB;AAC/B,SAAS,mBAAmB;AAC5B,SAAS,mBAAmB;AAC5B,SAAS,qBAAqB;AAC9B,SAAS,iCAAiC;AAC1C,SAAS,qBAAqB;AAI9B,MAAM,iBAAgE;AAAA,EACpE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEA,MAAM,uBAAuB,CAAC,gBAAkD;AAC9E,MAAI,OAAO,gBAAgB,UAAU;AACnC,WAAO;AAAA,EACT;AAEA,SAAO,aAAa;AACtB;AAEA,MAAM,uBAAuB,CAAC,sBAA2D;AACvF,MAAI,OAAO,sBAAsB,UAAU;AACzC,WAAO;AAAA,EACT;AAEA,MAAI;AACF,WAAO,KAAK,MAAM,iBAAiB;AAAA,EACrC,SAAS,OAAO;AACd,UAAM,UAAU,iBAAiB,QAAQ,MAAM,UAAU;AACzD,UAAM,aAAa,IAAI,MAAM,oCAAoC,OAAO,EAAE;AAC1E,eAAW,OAAO;AAClB,UAAM;AAAA,EACR;AACF;AAEA,MAAM,0BAA0B,CAAC,eAA2C;AAC1E,MAAI,CAAC,cAAc,OAAO,eAAe,UAAU;AACjD,UAAM,IAAI,MAAM,gDAAgD;AAAA,EAClE;AAEA,QAAM,YAAY;AAElB,MAAI,CAAC,UAAU,MAAM;AACnB,UAAM,IAAI,MAAM,6CAA6C;AAAA,EAC/D;AAEA,MAAI,CAAC,UAAU,QAAQ,CAAC,MAAM,QAAQ,UAAU,IAAI,GAAG;AACrD,UAAM,IAAI,MAAM,mDAAmD;AAAA,EACrE;AAEA,MAAI,OAAO,UAAU,SAAS,UAAU;AACtC,UAAM,IAAI,MAAM,oDAAoD;AAAA,EACtE;AAEA,MAAI,CAAC,UAAU,KAAK,MAAM;AACxB,UAAM,IAAI,MAAM,kDAAkD;AAAA,EACpE;AAEA,MAAI,CAAC,UAAU,KAAK,QAAQ;AAC1B,UAAM,IAAI,MAAM,iDAAiD;AAAA,EACnE;AAEA,MAAI,UAAU,YAAY,CAAC,MAAM,QAAQ,UAAU,QAAQ,GAAG;AAC5D,UAAM,IAAI,MAAM,qEAAqE;AAAA,EACvF;AAEA,SAAO;AACT;AAOA,MAAM,cAAc,CAAC,SAA8C,UAAU,QAAQ,MAAM,QAAQ,KAAK,IAAI;AAE5G,MAAM,cAAc,CAAC,UAA8D;AACjF,QAAM,cAAc,CAAC,MAAwB,aAAqB,OAAgC;AAChG,QAAI,CAAC,YAAY,IAAI,GAAG;AACtB,aAAO,CAAC;AAAA,IACV;AAEA,UAAM,WAAW,KAAK,OAAQ,aAAa,GAAG,UAAU,MAAM,KAAK,IAAI,KAAK,KAAK,OAAQ;AACzF,UAAM,cAAc,qBAAqB,KAAK,WAAW;AACzD,UAAM,aAAsC,KAAK,MAAM,SACnD;AAAA,MACE;AAAA,QACE,MAAM;AAAA,QACN,GAAI,eAAe,EAAE,YAAY;AAAA,MACnC;AAAA,IACF,IACA,CAAC;AAEL,WAAO,CAAC,GAAG,YAAY,GAAG,KAAK,KAAK,QAAQ,CAAC,YAAY,YAAY,SAAS,QAAQ,CAAC,CAAC;AAAA,EAC1F;AAEA,SAAO,MAAM,QAAQ,CAAC,SAAS,YAAY,IAAI,CAAC;AAClD;AAEA,MAAM,uBAAuB,CAC3B,SACA,oBACS;AACT,MAAI,CAAC,mBAAmB,OAAO,KAAK,eAAe,EAAE,WAAW,GAAG;AACjE;AAAA,EACF;AAEA,UAAQ,aAAa,QAAQ,cAAc,CAAC;AAC5C,UAAQ,WAAW,kBAAkB;AAAA,IACnC,GAAI,QAAQ,WAAW,mBAAmB,CAAC;AAAA,IAC3C,GAAG;AAAA,EACL;AACF;AAEA,MAAM,gBAAgB,CACpB,OACA,mBACA,aACS;AACT,QAAM,aAAc,MAAM,iBAAiB,KAAK,CAAC;AAEjD,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,QAAQ,GAG7C;AACH,QAAI,UAAU,QAAW;AACvB;AAAA,IACF;AAEA,UAAM,iBAAiB,eAAe,SAAS,GAAG;AAElD,QAAI,kBAAkB,WAAW,GAAG,GAAG;AACrC,YAAM,gBAAgB,OAAO,QAAQ,WAAW,IAAI,YAAY,IAAI,OAAO,GAAG;AAC9E,cAAQ;AAAA,QACN,oCAAoC,aAAa,IAAI,iBAAiB;AAAA,MACxE;AAAA,IACF;AAEA,eAAW,GAAG,IAAI;AAAA,EACpB;AAEA,QAAM,iBAAiB,IAAI;AAC7B;AAEA,MAAM,oBAAoB,CAAC,UAAyC;AAClE,SAAO,OAAO,KAAK,EAAE,QAAQ,CAAC,aAAa;AACzC,QAAI,CAAC,UAAU;AACb;AAAA,IACF;AAEA,mBAAe,QAAQ,CAAC,iBAAiB;AACvC,YAAM,YAAY,SAAS,YAAY;AACvC,UAAI,CAAC,WAAW;AACd;AAAA,MACF;AAEA,UAAI,gBAAgB,aAAa,UAAU,YAAY,WAAW,GAAG;AACnE,eAAO,UAAU;AAAA,MACnB;AAEA,UAAI,iBAAiB,aAAa,UAAU,eAAe,aAAa,UAAU,aAAa;AAC7F,cAAM,UAAU,UAAU,YAAY;AACtC,YAAI,WAAW,gBAAgB,SAAS;AACtC,gBAAM,OAAO,QAAQ,YAAY;AACjC,cAAI,CAAC,MAAM,UAAW,KAAK,UAAU,OAAO,KAAK,KAAK,MAAM,EAAE,WAAW,GAAI;AAC3E,oBAAQ,YAAY,IAAI,CAAC;AAAA,UAC3B;AAAA,QACF;AAAA,MACF;AAEA,UAAI,CAAC,UAAU,aAAa;AAC1B,eAAO,UAAU;AAAA,MACnB;AAAA,IACF,CAAC;AAAA,EACH,CAAC;AACH;AAOO,SAAS,QAAQ,mBAAqE;AAC3F,QAAM,aAAa,wBAAwB,qBAAqB,iBAAiB,CAAC;AAGlF,QAAM,QAAQ,WAAW,KAAK,QAAQ;AAGtC,QAAM,UAAW,WAAW,UAAU,KAAK,CAAC,MAAM,EAAE,QAAQ,SAAS,GAAG,SAAoB;AAG5F,QAAM,cAAc,qBAAqB,WAAW,KAAK,WAAW,KAAK;AAGzE,QAAM,UAAU,eAAe,UAAU;AACzC,QAAM,UAAU,eAAe,UAAU;AAGzC,QAAM,OAAO,YAAY,UAAU;AAGnC,QAAM,UAAgC;AAAA,IACpC,SAAS;AAAA,IACT,MAAM;AAAA,MACJ;AAAA,MACA;AAAA,MACA,GAAI,eAAe,EAAE,YAAY;AAAA,MACjC,GAAI,WAAW,EAAE,QAAQ;AAAA,MACzB,GAAI,WAAW,EAAE,QAAQ;AAAA,MACzB,GAAI,QAAQ,EAAE,UAAU,KAAK;AAAA,IAC/B;AAAA,IACA,OAAO,CAAC;AAAA,EACV;AAGA,QAAM,eAAe,oBAAoB,UAAU;AACnD,MAAI,cAAc;AAChB,YAAQ,eAAe;AAAA,EACzB;AAGA,MAAI,WAAW,MAAM;AACnB,UAAM,EAAE,iBAAiB,SAAS,IAAI,YAAY,WAAW,IAAI;AACjE,yBAAqB,SAAS,eAAe;AAC7C,YAAQ,WAAW;AAAA,EACrB;AAGA,QAAM,iBAID,CAAC;AAEN,MAAI,WAAW,MAAM;AAEnB,UAAM,OAAO,YAAY,WAAW,IAAI;AACxC,QAAI,KAAK,SAAS,GAAG;AACnB,cAAQ,OAAO;AAAA,IACjB;AAEA,eAAW,KAAK,QAAQ,CAAC,SAAS;AAChC,YAAM,EAAE,OAAO,WAAW,YAAY,gBAAgB,YAAY,IAAI,YAAY,IAAI;AAGtF,qBAAe,KAAK,GAAG,WAAW;AAGlC,cAAQ,QAAQ,QAAQ,SAAS,CAAC;AAClC,iBAAW,CAAC,SAAS,QAAQ,KAAK,OAAO,QAAQ,SAAS,GAAG;AAE3D,cAAM,oBAAoB,cAAc,OAAO;AAE/C,YAAI,CAAC,UAAU;AACb;AAAA,QACF;AAEA,sBAAc,QAAQ,OAAO,mBAAmB,QAAQ;AAAA,MAC1D;AAGA,UAAI,gBAAgB,iBAAiB;AACnC,6BAAqB,SAAS,eAAe,eAAe;AAAA,MAC9D;AAAA,IACF,CAAC;AAAA,EACH;AAGA,QAAM,iBAAiB,oBAAI,IAAY;AACvC,MAAI,QAAQ,OAAO;AACjB,eAAW,WAAW,OAAO,KAAK,QAAQ,KAAK,GAAG;AAChD,qBAAe,IAAI,OAAO;AAAA,IAC5B;AAAA,EACF;AAGA,QAAM,kBAAkB,0BAA0B,gBAAgB,cAAc;AAGhF,MAAI,gBAAgB,SAAS,SAAS,GAAG;AACvC,YAAQ,UAAU,gBAAgB;AAAA,EACpC;AAGA,MAAI,QAAQ,OAAO;AACjB,eAAW,CAAC,MAAM,OAAO,KAAK,gBAAgB,UAAU,QAAQ,GAAG;AACjE,YAAM,oBAAoB,cAAc,IAAI;AAC5C,YAAM,WAAW,QAAQ,MAAM,iBAAiB;AAChD,UAAI,UAAU;AACZ,iBAAS,UAAU;AAAA,MACrB;AAAA,IACF;AAGA,eAAW,CAAC,MAAM,OAAO,KAAK,gBAAgB,WAAW,QAAQ,GAAG;AAClE,YAAM,oBAAoB,cAAc,IAAI;AAC5C,YAAM,WAAW,QAAQ,MAAM,iBAAiB;AAChD,UAAI,CAAC,UAAU;AACb;AAAA,MACF;AACA,iBAAW,CAAC,QAAQ,OAAO,KAAK,QAAQ,QAAQ,GAAG;AACjD,YAAI,UAAU,UAAU;AACtB,gBAAM,YAAY,SAAS,MAA+B;AAC1D,cAAI,aAAa,OAAO,cAAc,YAAY,eAAe,WAAW;AAC1E,sBAAU,UAAU;AAAA,UACtB;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAGA,MAAI,QAAQ,OAAO;AACjB,sBAAkB,QAAQ,KAAK;AAAA,EACjC;AAGA,MAAI,OAAO,KAAK,QAAQ,cAAc,CAAC,CAAC,EAAE,WAAW,GAAG;AACtD,WAAO,QAAQ;AAAA,EACjB;AAEA,SAAO,cAAc,OAAO;AAC9B;",
   "names": []
 }

package/dist/helpers/{authHelpers.d.ts → auth.d.ts}

@@ -9,4 +9,4 @@ export declare function processAuth(auth: Auth): {
     securitySchemes: Record<string, OpenAPIV3_1.SecuritySchemeObject>;
     security: OpenAPIV3_1.SecurityRequirementObject[];
 };
-//# sourceMappingURL=authHelpers.d.ts.map
+//# sourceMappingURL=auth.d.ts.map

package/dist/helpers/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/helpers/auth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAExD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,SAAS,CAAA;AAkInC;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG;IACvC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,oBAAoB,CAAC,CAAA;IACjE,QAAQ,EAAE,WAAW,CAAC,yBAAyB,EAAE,CAAA;CAClD,CAwBA"}

package/dist/helpers/auth.js

@@ -0,0 +1,113 @@
+const AUTH_SCHEMES = {
+  API_KEY: "apikeyAuth",
+  BASIC: "basicAuth",
+  BEARER: "bearerAuth",
+  OAUTH2: "oauth2Auth"
+};
+const OAUTH2_DEFAULTS = {
+  AUTHORIZE_URL: "/oauth/authorize",
+  TOKEN_URL: "/oauth/token"
+};
+function createApiKeyConfig() {
+  return {
+    scheme: {
+      type: "apiKey",
+      name: "api_key",
+      in: "header"
+    },
+    requirement: { [AUTH_SCHEMES.API_KEY]: [] }
+  };
+}
+function createBasicConfig() {
+  return {
+    scheme: {
+      type: "http",
+      scheme: "basic"
+    },
+    requirement: { [AUTH_SCHEMES.BASIC]: [] }
+  };
+}
+function createBearerConfig() {
+  return {
+    scheme: {
+      type: "http",
+      scheme: "bearer"
+    },
+    requirement: { [AUTH_SCHEMES.BEARER]: [] }
+  };
+}
+function createOAuth2Config(auth) {
+  if (!auth) {
+    return {
+      scheme: {},
+      requirement: {}
+    };
+  }
+  const oauth2Attrs = auth.oauth2 || [];
+  const attrMap = /* @__PURE__ */ new Map();
+  oauth2Attrs.forEach((attr) => {
+    if (attr.key && attr.value !== void 0) {
+      attrMap.set(attr.key, String(attr.value));
+    }
+  });
+  const authUrl = attrMap.get("authUrl") || attrMap.get("authorizationUrl") || OAUTH2_DEFAULTS.AUTHORIZE_URL;
+  const tokenUrl = attrMap.get("accessTokenUrl") || attrMap.get("tokenUrl") || OAUTH2_DEFAULTS.TOKEN_URL;
+  const scopeValue = attrMap.get("scope") || "";
+  const scopes = {};
+  if (scopeValue) {
+    const scopeList = scopeValue.split(/[,\s]+/).filter(Boolean);
+    scopeList.forEach((scope) => {
+      scopes[scope] = scope;
+    });
+  }
+  return {
+    scheme: {
+      type: "oauth2",
+      flows: {
+        authorizationCode: {
+          authorizationUrl: authUrl,
+          tokenUrl,
+          scopes
+        }
+      }
+    },
+    requirement: { [AUTH_SCHEMES.OAUTH2]: Object.keys(scopes) }
+  };
+}
+function createNoAuthConfig() {
+  return {
+    scheme: {},
+    requirement: {}
+  };
+}
+const AUTH_TYPE_HANDLERS = {
+  apikey: createApiKeyConfig,
+  basic: createBasicConfig,
+  bearer: createBearerConfig,
+  oauth2: createOAuth2Config,
+  noauth: createNoAuthConfig
+};
+function processAuth(auth) {
+  const securitySchemes = {};
+  const security = [];
+  try {
+    const handler = AUTH_TYPE_HANDLERS[auth.type];
+    if (!handler) {
+      throw new Error(`Unsupported authentication type: ${auth.type}`);
+    }
+    const { scheme, requirement } = handler(auth);
+    if (Object.keys(scheme).length > 0) {
+      const schemeKey = `${auth.type}Auth`;
+      securitySchemes[schemeKey] = scheme;
+      security.push(requirement);
+    }
+  } catch (error) {
+    console.error("Error processing authentication:", error);
+    throw error;
+  }
+  return { securitySchemes, security };
+}
+export {
+  processAuth
+};
+//# sourceMappingURL=auth.js.map