@scalar/postman-to-openapi 0.6.1 → 0.6.3

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @scalar/postman-to-openapi
 
+## 0.6.3
+
+### Patch Changes
+
+- [#8903](https://github.com/scalar/scalar/pull/8903): fix: share Postman collection detection from postman-to-openapi
+- [#8902](https://github.com/scalar/scalar/pull/8902): Preserve merged Postman request variants by carrying request-specific examples for parameters and request bodies, unioning status-code responses derived from request names, and concatenating pre-request and post-response script extensions when operations collapse into one path/method.
+- [#8898](https://github.com/scalar/scalar/pull/8898): merge structurally equivalent paths that only differ by path parameter names and align path parameter definitions with the canonical path
+- [#8887](https://github.com/scalar/scalar/pull/8887): fix: invalid json body handling and add root document for bulk operation selection
+- [#8897](https://github.com/scalar/scalar/pull/8897): fix postman-to-openapi response descriptions to use status-aware defaults and parse named examples
+
+## 0.6.2
+
 ## 0.6.1
 
 ## 0.6.0

package/README.md

@@ -24,6 +24,21 @@ const result = await convert(myPostmanCollection)
 console.log(result)
 ```
 
+### Detect Postman collections
+
+Use `isPostmanCollection` to decide whether an input string should be parsed as a Postman collection before converting.
+
+```ts
+import { convert, isPostmanCollection } from '@scalar/postman-to-openapi'
+
+if (isPostmanCollection(input)) {
+  const openApiDocument = convert(input)
+  console.log(openApiDocument)
+}
+```
+
+`isPostmanCollection` accepts exported collections that do not include `info._postman_id` as long as they contain a valid Postman schema URL and an `item` tree.
+
 ## Community
 
 We are API nerds. You too? Let's chat on Discord: <https://discord.gg/scalar>

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;AAaxD,OAAO,KAAK,EAAgC,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAE9E;;;GAGG;AACH,MAAM,MAAM,uBAAuB,GAAG,SAAS,MAAM,EAAE,CAAA;AA4SvD,MAAM,MAAM,cAAc,GAAG;IAC3B;;;;;OAKG;IACH,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB;;;;;;OAMG;IACH,iBAAiB,CAAC,EAAE,SAAS,uBAAuB,EAAE,CAAA;IACtD;;;;OAIG;IACH,QAAQ,CAAC,EAAE,WAAW,CAAC,QAAQ,CAAA;CAChC,CAAA;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CACrB,iBAAiB,EAAE,iBAAiB,GAAG,MAAM,EAC7C,OAAO,GAAE,cAA0C,GAClD,WAAW,CAAC,QAAQ,CAwLtB"}
+{"version":3,"file":"convert.d.ts","sourceRoot":"","sources":["../src/convert.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAkBxD,OAAO,KAAK,EAAgC,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAE9E;;;GAGG;AACH,MAAM,MAAM,uBAAuB,GAAG,SAAS,MAAM,EAAE,CAAA;AA8iBvD,MAAM,MAAM,cAAc,GAAG;IAC3B;;;;;OAKG;IACH,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB;;;;;;OAMG;IACH,iBAAiB,CAAC,EAAE,SAAS,uBAAuB,EAAE,CAAA;IACtD;;;;OAIG;IACH,QAAQ,CAAC,EAAE,WAAW,CAAC,QAAQ,CAAA;CAChC,CAAA;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CACrB,iBAAiB,EAAE,iBAAiB,GAAG,MAAM,EAC7C,OAAO,GAAE,cAA0C,GAClD,WAAW,CAAC,QAAQ,CA4MtB"}

package/dist/convert.js

@@ -4,10 +4,10 @@ import { processExternalDocs } from './helpers/external-docs.js';
 import { processLicense } from './helpers/license.js';
 import { processLogo } from './helpers/logo.js';
 import { DEFAULT_EXAMPLE_NAME, OPERATION_KEYS, mergePathItem } from './helpers/merge-path-item.js';
-import { processItem } from './helpers/path-items.js';
+import { POSTMAN_EXAMPLE_NAME_EXTENSION, POSTMAN_POST_RESPONSE_SCRIPTS_EXTENSION, POSTMAN_PRE_REQUEST_SCRIPTS_EXTENSION, 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';
+import { getPathStructuralSignature, normalizePath } from './helpers/urls.js';
 const normalizeDescription = (description) => {
     if (typeof description === 'string') {
         return description;
@@ -237,9 +237,195 @@ const cleanupOperations = (paths) => {
             if (!operation.description) {
                 delete operation.description;
             }
+            // Internal merge bookkeeping should not leak in final OpenAPI output.
+            delete operation[POSTMAN_EXAMPLE_NAME_EXTENSION];
+            delete operation[POSTMAN_PRE_REQUEST_SCRIPTS_EXTENSION];
+            delete operation[POSTMAN_POST_RESPONSE_SCRIPTS_EXTENSION];
         });
     });
 };
+const getOrderedPathParameterNames = (path) => normalizePath(path)
+    .split('/')
+    .flatMap((segment) => {
+    const match = segment.match(/^\{([^{}]+)\}$/);
+    return match?.[1] ? [match[1]] : [];
+});
+const rewritePathParameterNames = (path, parameterNames) => {
+    const segments = normalizePath(path).split('/');
+    let parameterIndex = 0;
+    const rewrittenSegments = segments.map((segment) => {
+        if (!/^\{[^{}]+\}$/.test(segment)) {
+            return segment;
+        }
+        const canonicalName = parameterNames[parameterIndex];
+        parameterIndex += 1;
+        return canonicalName ? `{${canonicalName}}` : segment;
+    });
+    return rewrittenSegments.join('/');
+};
+const chooseMostCommonName = (names) => {
+    if (names.length === 0) {
+        return undefined;
+    }
+    const counts = new Map();
+    const firstIndex = new Map();
+    names.forEach((name, index) => {
+        counts.set(name, (counts.get(name) ?? 0) + 1);
+        if (!firstIndex.has(name)) {
+            firstIndex.set(name, index);
+        }
+    });
+    return [...counts.entries()].sort((a, b) => {
+        if (a[1] !== b[1]) {
+            return b[1] - a[1];
+        }
+        return (firstIndex.get(a[0]) ?? Number.POSITIVE_INFINITY) - (firstIndex.get(b[0]) ?? Number.POSITIVE_INFINITY);
+    })[0]?.[0];
+};
+const renameParameters = (parameters, renameMap) => {
+    if (!parameters || renameMap.size === 0) {
+        return parameters;
+    }
+    const mergedParameters = new Map();
+    parameters.forEach((parameter, index) => {
+        if (!parameter || '$ref' in parameter) {
+            mergedParameters.set(`$ref/${index}`, parameter);
+            return;
+        }
+        const nextName = parameter.in === 'path' ? (renameMap.get(parameter.name) ?? parameter.name) : parameter.name;
+        const renamedParameter = nextName === parameter.name ? parameter : { ...parameter, name: nextName };
+        const parameterKey = `${renamedParameter.name}/${renamedParameter.in}`;
+        const existingParameter = mergedParameters.get(parameterKey);
+        if (!existingParameter || '$ref' in existingParameter || '$ref' in renamedParameter) {
+            mergedParameters.set(parameterKey, renamedParameter);
+            return;
+        }
+        mergedParameters.set(parameterKey, {
+            ...existingParameter,
+            ...renamedParameter,
+            examples: {
+                ...(existingParameter.examples ?? {}),
+                ...(renamedParameter.examples ?? {}),
+            },
+        });
+    });
+    return [...mergedParameters.values()];
+};
+const renamePathParametersForOperation = (operation, renameMap) => {
+    if (!operation.parameters || renameMap.size === 0) {
+        return operation;
+    }
+    return {
+        ...operation,
+        parameters: renameParameters(operation.parameters, renameMap),
+    };
+};
+const renamePathItemParameterNames = (pathItem, sourceNames, targetNames) => {
+    const renameMap = new Map();
+    sourceNames.forEach((sourceName, index) => {
+        const targetName = targetNames[index];
+        if (sourceName && targetName && sourceName !== targetName) {
+            renameMap.set(sourceName, targetName);
+        }
+    });
+    if (renameMap.size === 0) {
+        return pathItem;
+    }
+    const renamedPathItem = {
+        ...pathItem,
+        parameters: renameParameters(pathItem.parameters, renameMap),
+    };
+    OPERATION_KEYS.forEach((operationKey) => {
+        const operation = pathItem[operationKey];
+        if (!operation) {
+            return;
+        }
+        renamedPathItem[operationKey] = renamePathParametersForOperation(operation, renameMap);
+    });
+    return renamedPathItem;
+};
+const findFolderTemplateHint = (pathItemGroup, signature) => {
+    for (const { pathItem, parameterNames } of pathItemGroup) {
+        for (const operationKey of OPERATION_KEYS) {
+            const operation = pathItem[operationKey];
+            if (!operation) {
+                continue;
+            }
+            for (const tag of operation.tags ?? []) {
+                const folderNames = tag.split(' > ').map((segment) => segment.trim());
+                for (const folderName of folderNames) {
+                    if (!folderName.startsWith('/')) {
+                        continue;
+                    }
+                    const normalizedFolderName = normalizePath(folderName);
+                    if (getPathStructuralSignature(normalizedFolderName) !== signature) {
+                        continue;
+                    }
+                    const folderParameterNames = getOrderedPathParameterNames(normalizedFolderName);
+                    if (folderParameterNames.length === parameterNames.length) {
+                        return folderParameterNames;
+                    }
+                }
+            }
+        }
+    }
+    return undefined;
+};
+const unifyEquivalentPathParameters = (paths) => {
+    const pathEntries = Object.entries(paths).filter((entry) => Boolean(entry[1]));
+    const groups = new Map();
+    pathEntries.forEach(([pathKey, pathItem]) => {
+        const signature = getPathStructuralSignature(pathKey);
+        if (!groups.has(signature)) {
+            groups.set(signature, []);
+        }
+        groups.get(signature)?.push({
+            pathKey,
+            pathItem,
+            parameterNames: getOrderedPathParameterNames(pathKey),
+        });
+    });
+    const unifiedPaths = {};
+    const canonicalPathByPath = new Map();
+    const processedPathKeys = new Set();
+    pathEntries.forEach(([pathKey]) => {
+        if (processedPathKeys.has(pathKey)) {
+            return;
+        }
+        const signature = getPathStructuralSignature(pathKey);
+        const group = groups.get(signature) ?? [];
+        if (group.length < 2) {
+            const pathItem = paths[pathKey];
+            if (pathItem) {
+                unifiedPaths[pathKey] = pathItem;
+                canonicalPathByPath.set(pathKey, pathKey);
+            }
+            processedPathKeys.add(pathKey);
+            return;
+        }
+        const firstGroupEntry = group[0];
+        if (!firstGroupEntry || firstGroupEntry.pathKey !== pathKey) {
+            return;
+        }
+        const parameterCount = firstGroupEntry.parameterNames.length;
+        const folderTemplateHint = findFolderTemplateHint(group, signature);
+        const canonicalParameterNames = folderTemplateHint ??
+            Array.from({ length: parameterCount }, (_, parameterIndex) => {
+                const namesInOrder = group
+                    .map((entry) => entry.parameterNames[parameterIndex])
+                    .filter((name) => Boolean(name));
+                return chooseMostCommonName(namesInOrder) ?? namesInOrder[0] ?? '';
+            });
+        const canonicalPath = rewritePathParameterNames(firstGroupEntry.pathKey, canonicalParameterNames);
+        group.forEach(({ pathKey: groupedPathKey, pathItem, parameterNames }) => {
+            const normalizedPathItem = renamePathItemParameterNames(pathItem, parameterNames, canonicalParameterNames);
+            mergePathItem(unifiedPaths, canonicalPath, normalizedPathItem, true);
+            canonicalPathByPath.set(groupedPathKey, canonicalPath);
+            processedPathKeys.add(groupedPathKey);
+        });
+    });
+    return { paths: unifiedPaths, canonicalPathByPath };
+};
 /**
  * Converts a Postman Collection to an OpenAPI 3.1.0 document.
  * This function processes the collection's information, servers, authentication,
@@ -306,7 +492,7 @@ export function convert(postmanCollection, options = { mergeOperation: false })
                     continue;
                 }
                 const parentTags = collectParentTagSegments(collection.item, path);
-                const { paths: itemPaths, components: itemComponents, serverUsage, } = processItem(node, DEFAULT_EXAMPLE_NAME, parentTags, '');
+                const { paths: itemPaths, components: itemComponents, serverUsage, } = processItem(node, DEFAULT_EXAMPLE_NAME, parentTags, '', mergeOperation);
                 allServerUsage.push(...serverUsage);
                 for (const [pathKey, pathItem] of Object.entries(itemPaths)) {
                     const normalizedPathKey = normalizePath(pathKey);
@@ -324,7 +510,7 @@ export function convert(postmanCollection, options = { mergeOperation: false })
             const tags = extractTags(collection.item);
             assignTagsFromPostman(openapi, tags, isMergingIntoBase);
             collection.item.forEach((item) => {
-                const { paths: itemPaths, components: itemComponents, serverUsage } = processItem(item, DEFAULT_EXAMPLE_NAME);
+                const { paths: itemPaths, components: itemComponents, serverUsage, } = processItem(item, DEFAULT_EXAMPLE_NAME, [], '', mergeOperation);
                 allServerUsage.push(...serverUsage);
                 openapi.paths = openapi.paths || {};
                 for (const [pathKey, pathItem] of Object.entries(itemPaths)) {
@@ -341,6 +527,20 @@ export function convert(postmanCollection, options = { mergeOperation: false })
         }
     }
     // Extract all unique paths from the document
+    let canonicalPathByPath = new Map();
+    if (openapi.paths) {
+        const unificationResult = unifyEquivalentPathParameters(openapi.paths);
+        openapi.paths = unificationResult.paths;
+        canonicalPathByPath = unificationResult.canonicalPathByPath;
+    }
+    const normalizedServerUsage = allServerUsage.map((usage) => {
+        const normalizedUsagePath = normalizePath(usage.path);
+        return {
+            ...usage,
+            path: canonicalPathByPath.get(normalizedUsagePath) ?? normalizedUsagePath,
+        };
+    });
+    // Extract all unique paths from the document
     const allUniquePaths = new Set();
     if (openapi.paths) {
         for (const pathKey of Object.keys(openapi.paths)) {
@@ -348,7 +548,7 @@ export function convert(postmanCollection, options = { mergeOperation: false })
         }
     }
     // Analyze server distribution and place servers at appropriate levels
-    const serverPlacement = analyzeServerDistribution(allServerUsage, allUniquePaths);
+    const serverPlacement = analyzeServerDistribution(normalizedServerUsage, allUniquePaths);
     // Add servers to document level
     if (serverPlacement.document.length > 0) {
         openapi.servers = isMergingIntoBase

package/dist/helpers/merge-operation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"merge-operation.d.ts","sourceRoot":"","sources":["../../src/helpers/merge-operation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAExD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,eAAO,MAAM,eAAe,GAC1B,YAAY,WAAW,CAAC,eAAe,EACvC,YAAY,WAAW,CAAC,eAAe,KACtC,WAAW,CAAC,eAiFd,CAAA"}
+{"version":3,"file":"merge-operation.d.ts","sourceRoot":"","sources":["../../src/helpers/merge-operation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAmBxD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,eAAO,MAAM,eAAe,GAC1B,YAAY,WAAW,CAAC,eAAe,EACvC,YAAY,WAAW,CAAC,eAAe,KACtC,WAAW,CAAC,eA0Gd,CAAA"}

package/dist/helpers/merge-operation.js

@@ -1,3 +1,14 @@
+import { POSTMAN_EXAMPLE_NAME_EXTENSION, POSTMAN_POST_RESPONSE_SCRIPTS_EXTENSION, POSTMAN_PRE_REQUEST_SCRIPTS_EXTENSION, } from './path-items.js';
+const SCRIPT_MERGE_CONFIG = [
+    {
+        extensionKey: POSTMAN_PRE_REQUEST_SCRIPTS_EXTENSION,
+        outputKey: 'x-pre-request',
+    },
+    {
+        extensionKey: POSTMAN_POST_RESPONSE_SCRIPTS_EXTENSION,
+        outputKey: 'x-post-response',
+    },
+];
 /**
  * Merges two OpenAPI OperationObject instances.
  * Assumes that all example names (keys in the 'examples' objects) are unique across both operations.
@@ -102,12 +113,20 @@ export const mergeOperations = (operation1, operation2) => {
             const mediaTypeObj = mediaType;
             if (contentMediaTypeMap.has(contentType)) {
                 const existingMediaType = contentMediaTypeMap.get(contentType);
-                if (existingMediaType && (existingMediaType.examples || mediaTypeObj.examples)) {
+                if (existingMediaType) {
+                    if (mediaTypeObj.schema) {
+                        existingMediaType.schema = mediaTypeObj.schema;
+                    }
+                    if (mediaTypeObj.example !== undefined && existingMediaType.example === undefined) {
+                        existingMediaType.example = mediaTypeObj.example;
+                    }
                     // Assumption: example names (keys) are unique, so this merge is safe
-                    existingMediaType.examples = {
-                        ...existingMediaType.examples,
-                        ...mediaTypeObj.examples,
-                    };
+                    if (existingMediaType.examples || mediaTypeObj.examples) {
+                        existingMediaType.examples = {
+                            ...existingMediaType.examples,
+                            ...mediaTypeObj.examples,
+                        };
+                    }
                 }
             }
             else {
@@ -121,5 +140,101 @@ export const mergeOperations = (operation1, operation2) => {
             content: Object.fromEntries(contentMediaTypeMap),
         };
     }
+    operation.responses = {
+        ...(operation1.responses ?? {}),
+        ...(operation.responses ?? {}),
+    };
+    operation.summary = mergeSummary(operation1.summary, operation.summary);
+    operation.description = mergeDescription(operation1.description, operation.description);
+    for (const config of SCRIPT_MERGE_CONFIG) {
+        const mergedScripts = mergeScriptsBySource(operation1, operation, config.extensionKey, config.outputKey);
+        if (mergedScripts) {
+            operation[config.extensionKey] = mergedScripts;
+        }
+        else {
+            delete operation[config.extensionKey];
+        }
+        updateRenderedScript(operation, config.extensionKey, config.outputKey);
+    }
     return operation;
 };
+const mergeSummary = (firstSummary, secondSummary) => {
+    const first = firstSummary?.trim();
+    const second = secondSummary?.trim();
+    if (!first && !second) {
+        return undefined;
+    }
+    if (!first) {
+        return second;
+    }
+    if (!second) {
+        return first;
+    }
+    if (first.length < second.length) {
+        return first;
+    }
+    return second;
+};
+const mergeDescription = (firstDescription, secondDescription) => {
+    const values = [firstDescription?.trim(), secondDescription?.trim()].filter((candidate) => Boolean(candidate && candidate.length > 0));
+    if (values.length === 0) {
+        return undefined;
+    }
+    const unique = Array.from(new Set(values));
+    return unique.join('\n\n');
+};
+const mergeScriptsBySource = (operation1, operation2, extensionKey, outputKey) => {
+    const scripts = new Map();
+    const operation1HasScriptMap = addScriptsToMap(scripts, operation1[extensionKey]);
+    if (!operation1HasScriptMap) {
+        addLegacyScriptToMap(scripts, operation1, outputKey);
+    }
+    const operation2HasScriptMap = addScriptsToMap(scripts, operation2[extensionKey]);
+    if (!operation2HasScriptMap) {
+        addLegacyScriptToMap(scripts, operation2, outputKey);
+    }
+    if (scripts.size === 0) {
+        return undefined;
+    }
+    return Object.fromEntries(scripts);
+};
+const addScriptsToMap = (target, source) => {
+    if (!source || typeof source !== 'object' || Array.isArray(source)) {
+        return false;
+    }
+    let hasScripts = false;
+    for (const [name, script] of Object.entries(source)) {
+        if (!name || typeof script !== 'string' || script.length === 0) {
+            continue;
+        }
+        target.set(name, script);
+        hasScripts = true;
+    }
+    return hasScripts;
+};
+const addLegacyScriptToMap = (target, operation, outputKey) => {
+    const legacyScript = operation[outputKey];
+    if (typeof legacyScript !== 'string' || legacyScript.length === 0) {
+        return;
+    }
+    const sourceName = typeof operation[POSTMAN_EXAMPLE_NAME_EXTENSION] === 'string' &&
+        operation[POSTMAN_EXAMPLE_NAME_EXTENSION].length > 0
+        ? operation[POSTMAN_EXAMPLE_NAME_EXTENSION]
+        : 'Default example';
+    target.set(sourceName, legacyScript);
+};
+const updateRenderedScript = (operation, extensionKey, scriptKey) => {
+    const scripts = operation[extensionKey];
+    if (!scripts || typeof scripts !== 'object' || Array.isArray(scripts)) {
+        delete operation[scriptKey];
+        return;
+    }
+    const sections = Object.entries(scripts)
+        .filter((entry) => typeof entry[0] === 'string' && typeof entry[1] === 'string')
+        .map(([sourceName, script]) => `// --- ${sourceName} ---\n${script}`);
+    if (sections.length === 0) {
+        delete operation[scriptKey];
+        return;
+    }
+    operation[scriptKey] = sections.join('\n\n');
+};

package/dist/helpers/merge-path-item.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"merge-path-item.d.ts","sourceRoot":"","sources":["../../src/helpers/merge-path-item.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAOxD,eAAO,MAAM,oBAAoB,oBAAoB,CAAA;AAErD,eAAO,MAAM,cAAc,EAAE,SAAS,CAAC,MAAM,WAAW,CAAC,cAAc,CAAC,EASvE,CAAA;AAED,eAAO,MAAM,aAAa,GACxB,OAAO,WAAW,CAAC,WAAW,EAC9B,mBAAmB,MAAM,EACzB,UAAU,WAAW,CAAC,cAAc,EACpC,iBAAgB,OAAe,KAC9B,IA8BF,CAAA"}
+{"version":3,"file":"merge-path-item.d.ts","sourceRoot":"","sources":["../../src/helpers/merge-path-item.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAYxD,eAAO,MAAM,oBAAoB,oBAAoB,CAAA;AAErD,eAAO,MAAM,cAAc,EAAE,SAAS,CAAC,MAAM,WAAW,CAAC,cAAc,CAAC,EASvE,CAAA;AAED,eAAO,MAAM,aAAa,GACxB,OAAO,WAAW,CAAC,WAAW,EAC9B,mBAAmB,MAAM,EACzB,UAAU,WAAW,CAAC,cAAc,EACpC,iBAAgB,OAAe,KAC9B,IAuCF,CAAA"}

package/dist/helpers/merge-path-item.js

@@ -1,6 +1,7 @@
 import { generateUniqueValue } from '../helpers/generate-unique-value.js';
 import { getOperationExamples } from '../helpers/get-operation-examples.js';
 import { mergeOperations } from '../helpers/merge-operation.js';
+import { POSTMAN_EXAMPLE_NAME_EXTENSION, POSTMAN_POST_RESPONSE_SCRIPTS_EXTENSION, POSTMAN_PRE_REQUEST_SCRIPTS_EXTENSION, } from '../helpers/path-items.js';
 import { renameOperationExamples } from '../helpers/rename-operation-example.js';
 export const DEFAULT_EXAMPLE_NAME = 'Default example';
 export const OPERATION_KEYS = [
@@ -21,17 +22,40 @@ export const mergePathItem = (paths, normalizedPathKey, pathItem, mergeOperation
         }
         const isOperationKey = OPERATION_KEYS.includes(key);
         if (isOperationKey && targetPath[key] && mergeOperation) {
+            const incomingOperation = pathItem[key];
+            const sourceName = typeof incomingOperation[POSTMAN_EXAMPLE_NAME_EXTENSION] === 'string'
+                ? incomingOperation[POSTMAN_EXAMPLE_NAME_EXTENSION]
+                : DEFAULT_EXAMPLE_NAME;
             // Get all example names from the target path
             const exampleNames = getOperationExamples(targetPath);
             // Generate a unique example name
-            const newExampleName = generateUniqueValue(DEFAULT_EXAMPLE_NAME, (value) => !exampleNames.has(value), '#');
-            // Rename operation examples from the new path item (we know it's gonna have only the default example)
-            renameOperationExamples(pathItem[key], DEFAULT_EXAMPLE_NAME, newExampleName);
+            const newExampleName = generateUniqueValue(sourceName, (value) => !exampleNames.has(value), '#');
+            // Rename operation examples from the new path item if this source name already exists
+            renameOperationExamples(incomingOperation, sourceName, newExampleName);
+            updateExtensionKey(incomingOperation, POSTMAN_PRE_REQUEST_SCRIPTS_EXTENSION, sourceName, newExampleName);
+            updateExtensionKey(incomingOperation, POSTMAN_POST_RESPONSE_SCRIPTS_EXTENSION, sourceName, newExampleName);
+            incomingOperation[POSTMAN_EXAMPLE_NAME_EXTENSION] = newExampleName;
             // Merge the operations
-            targetPath[key] = mergeOperations(targetPath[key], pathItem[key]);
+            targetPath[key] = mergeOperations(targetPath[key], incomingOperation);
             continue;
         }
         targetPath[key] = value;
     }
     paths[normalizedPathKey] = targetPath;
 };
+const updateExtensionKey = (operation, extensionKey, oldKey, newKey) => {
+    if (oldKey === newKey) {
+        return;
+    }
+    const map = operation[extensionKey];
+    if (!map || typeof map !== 'object' || Array.isArray(map)) {
+        return;
+    }
+    const castedMap = map;
+    const value = castedMap[oldKey];
+    if (value === undefined) {
+        return;
+    }
+    delete castedMap[oldKey];
+    castedMap[newKey] = value;
+};

package/dist/helpers/path-items.d.ts

@@ -1,6 +1,9 @@
 import type { OpenAPIV3_1 } from '@scalar/openapi-types';
 import type { Item, ItemGroup } from '../types.js';
 type HttpMethods = 'get' | 'put' | 'post' | 'delete' | 'options' | 'head' | 'patch' | 'trace';
+export declare const POSTMAN_EXAMPLE_NAME_EXTENSION = "x-postman-example-name";
+export declare const POSTMAN_PRE_REQUEST_SCRIPTS_EXTENSION = "x-postman-pre-request-scripts";
+export declare const POSTMAN_POST_RESPONSE_SCRIPTS_EXTENSION = "x-postman-post-response-scripts";
 /**
  * Information about server usage for an operation.
  */
@@ -15,10 +18,14 @@ export type ServerUsage = {
  * Handles nested item groups, extracts request details, and generates corresponding
  * OpenAPI path items and operations.
  */
-export declare function processItem(item: Item | ItemGroup, exampleName?: string, parentTags?: string[], parentPath?: string): {
+export declare function processItem(item: Item | ItemGroup, exampleName?: string, parentTags?: string[], parentPath?: string, preserveCollapsedVariants?: boolean): {
     paths: OpenAPIV3_1.PathsObject;
     components: OpenAPIV3_1.ComponentsObject;
     serverUsage: ServerUsage[];
 };
+export declare function parseStatusCodeFromRequestName(requestName: string | undefined): {
+    statusCode: string;
+    description: string;
+} | null;
 export {};
 //# sourceMappingURL=path-items.d.ts.map

package/dist/helpers/path-items.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"path-items.d.ts","sourceRoot":"","sources":["../../src/helpers/path-items.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAExD,OAAO,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAW9C,KAAK,WAAW,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAA;AAE7F;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,WAAW,CAAA;CACpB,CAAA;AAoBD;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,IAAI,GAAG,SAAS,EACtB,WAAW,GAAE,MAAkB,EAC/B,UAAU,GAAE,MAAM,EAAO,EACzB,UAAU,GAAE,MAAW,GACtB;IACD,KAAK,EAAE,WAAW,CAAC,WAAW,CAAA;IAC9B,UAAU,EAAE,WAAW,CAAC,gBAAgB,CAAA;IACxC,WAAW,EAAE,WAAW,EAAE,CAAA;CAC3B,CA2KA"}
+{"version":3,"file":"path-items.d.ts","sourceRoot":"","sources":["../../src/helpers/path-items.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAExD,OAAO,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAW9C,KAAK,WAAW,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAA;AAE7F,eAAO,MAAM,8BAA8B,2BAA2B,CAAA;AACtE,eAAO,MAAM,qCAAqC,kCAAkC,CAAA;AACpF,eAAO,MAAM,uCAAuC,oCAAoC,CAAA;AAExF;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,WAAW,CAAA;CACpB,CAAA;AAoBD;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,IAAI,GAAG,SAAS,EACtB,WAAW,GAAE,MAAkB,EAC/B,UAAU,GAAE,MAAM,EAAO,EACzB,UAAU,GAAE,MAAW,EACvB,yBAAyB,GAAE,OAAe,GACzC;IACD,KAAK,EAAE,WAAW,CAAC,WAAW,CAAA;IAC9B,UAAU,EAAE,WAAW,CAAC,gBAAgB,CAAA;IACxC,WAAW,EAAE,WAAW,EAAE,CAAA;CAC3B,CAoMA;AAED,wBAAgB,8BAA8B,CAC5C,WAAW,EAAE,MAAM,GAAG,SAAS,GAC9B;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAkCpD"}

package/dist/helpers/path-items.js

@@ -4,8 +4,11 @@ import { extractParameters } from './parameters.js';
 import { processPostResponseScripts } from './post-response-scripts.js';
 import { processPreRequestScripts } from './pre-request-scripts.js';
 import { extractRequestBody } from './request-body.js';
-import { extractResponses } from './responses.js';
+import { DEFAULT_RESPONSE_DESCRIPTIONS, extractResponses } from './responses.js';
 import { extractPathFromUrl, extractPathParameterNames, extractServerFromUrl, normalizePath } from './urls.js';
+export const POSTMAN_EXAMPLE_NAME_EXTENSION = 'x-postman-example-name';
+export const POSTMAN_PRE_REQUEST_SCRIPTS_EXTENSION = 'x-postman-pre-request-scripts';
+export const POSTMAN_POST_RESPONSE_SCRIPTS_EXTENSION = 'x-postman-post-response-scripts';
 function ensureRequestBodyContent(requestBody) {
     const content = requestBody.content ?? {};
     if (Object.keys(content).length === 0) {
@@ -27,14 +30,14 @@ function ensureRequestBodyContent(requestBody) {
  * Handles nested item groups, extracts request details, and generates corresponding
  * OpenAPI path items and operations.
  */
-export function processItem(item, exampleName = 'default', parentTags = [], parentPath = '') {
+export function processItem(item, exampleName = 'default', parentTags = [], parentPath = '', preserveCollapsedVariants = false) {
     const paths = {};
     const components = {};
     const serverUsage = [];
     if ('item' in item && Array.isArray(item.item)) {
         const newParentTags = item.name ? [...parentTags, item.name] : parentTags;
         item.item.forEach((childItem) => {
-            const childResult = processItem(childItem, exampleName, newParentTags, `${parentPath}/${item.name || ''}`);
+            const childResult = processItem(childItem, exampleName, newParentTags, `${parentPath}/${item.name || ''}`, preserveCollapsedVariants);
             // Merge child paths and components
             for (const [pathKey, pathItem] of Object.entries(childResult.paths)) {
                 if (!paths[pathKey]) {
@@ -63,6 +66,8 @@ export function processItem(item, exampleName = 'default', parentTags = [], pare
         return { paths, components, serverUsage };
     }
     const { request, name, response } = item;
+    const sourceRequestName = name?.trim() || exampleName;
+    const operationExampleName = preserveCollapsedVariants ? sourceRequestName : exampleName;
     const method = (typeof request === 'string' ? 'get' : request.method || 'get').toLowerCase();
     const requestUrl = typeof request === 'string' ? request : typeof request.url === 'string' ? request.url : (request.url?.raw ?? '');
     const path = extractPathFromUrl(requestUrl);
@@ -93,15 +98,28 @@ export function processItem(item, exampleName = 'default', parentTags = [], pare
         responses: extractResponses(response || [], item),
         parameters: [],
     };
+    if (preserveCollapsedVariants) {
+        operationObject[POSTMAN_EXAMPLE_NAME_EXTENSION] = sourceRequestName;
+    }
     // Add pre-request scripts if present
     const preRequestScript = processPreRequestScripts(item.event);
     if (preRequestScript) {
         operationObject['x-pre-request'] = preRequestScript;
+        if (preserveCollapsedVariants) {
+            operationObject[POSTMAN_PRE_REQUEST_SCRIPTS_EXTENSION] = {
+                [sourceRequestName]: preRequestScript,
+            };
+        }
     }
     // Add post-response scripts if present
     const postResponseScript = processPostResponseScripts(item.event);
     if (postResponseScript) {
         operationObject['x-post-response'] = postResponseScript;
+        if (preserveCollapsedVariants) {
+            operationObject[POSTMAN_POST_RESPONSE_SCRIPTS_EXTENSION] = {
+                [sourceRequestName]: postResponseScript,
+            };
+        }
     }
     // Only add operationId if it was explicitly provided
     if (operationId) {
@@ -109,7 +127,7 @@ export function processItem(item, exampleName = 'default', parentTags = [], pare
     }
     // Extract parameters from the request (query, path, header)
     // This should always happen, regardless of whether a description exists
-    const extractedParameters = extractParameters(request, exampleName);
+    const extractedParameters = extractParameters(request, operationExampleName);
     // Merge parameters, giving priority to those from the Markdown table if description exists
     const mergedParameters = new Map();
     // Add extracted parameters, filtering out path parameters not in the path
@@ -156,7 +174,7 @@ export function processItem(item, exampleName = 'default', parentTags = [], pare
     }
     // Allow request bodies for all methods (including GET) if body is present
     if (typeof request !== 'string' && request.body) {
-        const requestBody = extractRequestBody(request.body, exampleName);
+        const requestBody = extractRequestBody(request.body, operationExampleName);
         ensureRequestBodyContent(requestBody);
         // Only add requestBody if it has content
         if (requestBody.content && Object.keys(requestBody.content).length > 0) {
@@ -168,8 +186,40 @@ export function processItem(item, exampleName = 'default', parentTags = [], pare
     }
     const pathItem = paths[path];
     pathItem[method] = operationObject;
+    if (preserveCollapsedVariants) {
+        addResponseFromRequestName(pathItem[method], name);
+    }
     return { paths, components, serverUsage };
 }
+export function parseStatusCodeFromRequestName(requestName) {
+    if (!requestName) {
+        return null;
+    }
+    const trimmedStart = requestName.trimStart();
+    if (trimmedStart.length < 4) {
+        return null;
+    }
+    const statusCode = trimmedStart.slice(0, 3);
+    if (!isThreeDigitStatusCode(statusCode)) {
+        return null;
+    }
+    let separatorIndex = 3;
+    while (trimmedStart[separatorIndex] === ' ') {
+        separatorIndex += 1;
+    }
+    const separator = trimmedStart[separatorIndex];
+    if (separator !== '-' && separator !== ':') {
+        return null;
+    }
+    let descriptionIndex = separatorIndex + 1;
+    while (trimmedStart[descriptionIndex] === ' ') {
+        descriptionIndex += 1;
+    }
+    return {
+        statusCode,
+        description: trimmedStart.slice(descriptionIndex).trim() || 'Response',
+    };
+}
 /** OpenAPI 3.1 parameter schema types (ParameterObject uses OpenAPIV3_1). */
 const OPENAPI_PARAM_SCHEMA_TYPES = ['string', 'number', 'integer', 'boolean', 'object', 'array'];
 function toOpenApiParamSchemaType(s) {
@@ -259,3 +309,37 @@ function extractOperationInfo(name) {
     const summary = name.substring(0, lastBracketIndex).trim();
     return { operationId, summary };
 }
+function addResponseFromRequestName(operationObject, requestName) {
+    const parsedStatus = parseStatusCodeFromRequestName(requestName);
+    if (!parsedStatus) {
+        return;
+    }
+    operationObject.responses = operationObject.responses ?? {};
+    const existingResponse = operationObject.responses[parsedStatus.statusCode];
+    if (!existingResponse) {
+        operationObject.responses[parsedStatus.statusCode] = { description: parsedStatus.description };
+        return;
+    }
+    const defaultDescriptions = new Set([
+        'Successful response',
+        'Response',
+        ...Object.values(DEFAULT_RESPONSE_DESCRIPTIONS),
+    ]);
+    if (typeof existingResponse === 'object' &&
+        !('$ref' in existingResponse) &&
+        defaultDescriptions.has(existingResponse.description ?? '')) {
+        existingResponse.description = parsedStatus.description;
+    }
+}
+function isThreeDigitStatusCode(value) {
+    if (value.length !== 3) {
+        return false;
+    }
+    for (let index = 0; index < value.length; index += 1) {
+        const charCode = value.charCodeAt(index);
+        if (charCode < 48 || charCode > 57) {
+            return false;
+        }
+    }
+    return true;
+}

package/dist/helpers/request-body.js

@@ -25,21 +25,8 @@ export function extractRequestBody(body, exampleName) {
 function handleRawBody(body, requestBody, exampleName) {
     const rawBody = body.raw || '';
     const isJsonLanguage = body.options?.raw?.language === 'json';
-    // Check if body contains Postman variables (like {{bodyData}})
-    const hasVariables = /\{\{[\w-]+\}\}/.test(rawBody);
-    // Try parsing the raw body as JSON
-    // We use a boolean flag because `null` is a valid JSON value
-    let jsonBody;
-    let isJsonBody = false;
-    try {
-        jsonBody = JSON.parse(rawBody);
-        isJsonBody = true;
-    }
-    catch {
-        // Parsing failed - will handle below
-    }
     // If we have valid JSON, use it
-    if (isJsonBody) {
+    if (isJsonLanguage) {
         requestBody.content = {
             'application/json': {
                 schema: {
@@ -47,26 +34,13 @@ function handleRawBody(body, requestBody, exampleName) {
                 },
                 examples: {
                     [exampleName]: {
-                        value: jsonBody,
+                        value: rawBody,
                     },
                 },
             },
         };
         return;
     }
-    // If we have variables and JSON language but could not parse JSON,
-    // create a JSON schema placeholder
-    if (hasVariables && isJsonLanguage) {
-        requestBody.content = {
-            'application/json': {
-                schema: {
-                    type: 'object',
-                    description: 'Body data set via pre-request script',
-                },
-            },
-        };
-        return;
-    }
     // Fallback to text/plain
     requestBody.content = {
         'text/plain': {

package/dist/helpers/responses.d.ts

@@ -1,5 +1,6 @@
 import type { OpenAPIV3_1 } from '@scalar/openapi-types';
 import type { Item, Response } from '../types.js';
+export declare const DEFAULT_RESPONSE_DESCRIPTIONS: Record<string, string>;
 /**
  * Extracts and converts Postman response objects to OpenAPI response objects.
  * Processes response status codes, descriptions, headers, and body content,

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

@@ -1 +1 @@
-{"version":3,"file":"responses.d.ts","sourceRoot":"","sources":["../../src/helpers/responses.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAExD,OAAO,KAAK,EAAc,IAAI,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAKzD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,WAAW,CAAC,eAAe,GAAG,SAAS,CAwC5G"}
+{"version":3,"file":"responses.d.ts","sourceRoot":"","sources":["../../src/helpers/responses.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAExD,OAAO,KAAK,EAAc,IAAI,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAKzD,eAAO,MAAM,6BAA6B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAchE,CAAA;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,WAAW,CAAC,eAAe,GAAG,SAAS,CAwC5G"}

package/dist/helpers/responses.js

@@ -1,5 +1,20 @@
 import { inferSchemaFromExample } from './schemas.js';
 import { extractStatusCodesFromTests } from './status-codes.js';
+export const DEFAULT_RESPONSE_DESCRIPTIONS = {
+    200: 'OK',
+    201: 'Created',
+    202: 'Accepted',
+    204: 'No content',
+    301: 'Moved permanently',
+    400: 'Bad request',
+    401: 'Unauthorized',
+    403: 'Forbidden',
+    404: 'Not found',
+    409: 'Conflict',
+    422: 'Unprocessable entity',
+    500: 'Internal server error',
+    default: 'Default response',
+};
 /**
  * Extracts and converts Postman response objects to OpenAPI response objects.
  * Processes response status codes, descriptions, headers, and body content,
@@ -12,7 +27,7 @@ export function extractResponses(responses, item) {
     const responseMap = responses.reduce((acc, response) => {
         const statusCode = response.code?.toString() || 'default';
         acc[statusCode] = {
-            description: response.status || 'Successful response',
+            description: getResponseDescription(response, statusCode),
             headers: extractHeaders(response.header),
             content: {
                 'application/json': {
@@ -30,7 +45,7 @@ export function extractResponses(responses, item) {
         const codeStr = code.toString();
         if (!responseMap[codeStr]) {
             responseMap[codeStr] = {
-                description: 'Successful response',
+                description: getDefaultResponseDescription(codeStr),
                 content: {
                     'application/json': {},
                 },
@@ -42,6 +57,49 @@ export function extractResponses(responses, item) {
     }
     return responseMap;
 }
+function getResponseDescription(response, statusCode) {
+    const descriptionFromName = extractDescriptionFromName(response.name, statusCode);
+    if (descriptionFromName) {
+        return descriptionFromName;
+    }
+    if (response.status) {
+        return response.status;
+    }
+    return getDefaultResponseDescription(statusCode);
+}
+function extractDescriptionFromName(name, statusCode) {
+    if (!name) {
+        return undefined;
+    }
+    const trimmedName = name.trim();
+    const separatorIndex = trimmedName.indexOf('-');
+    if (separatorIndex < 0) {
+        return undefined;
+    }
+    const code = trimmedName.slice(0, separatorIndex).trim();
+    if (!isThreeDigitStatusCode(code) || code !== statusCode) {
+        return undefined;
+    }
+    const description = trimmedName.slice(separatorIndex + 1).trim();
+    if (!description) {
+        return undefined;
+    }
+    return description;
+}
+function getDefaultResponseDescription(statusCode) {
+    return DEFAULT_RESPONSE_DESCRIPTIONS[statusCode] ?? DEFAULT_RESPONSE_DESCRIPTIONS.default ?? 'Default response';
+}
+function isThreeDigitStatusCode(value) {
+    if (value.length !== 3) {
+        return false;
+    }
+    for (const character of value) {
+        if (character < '0' || character > '9') {
+            return false;
+        }
+    }
+    return true;
+}
 function extractHeaders(headers) {
     if (!headers || typeof headers === 'string') {
         return undefined;

package/dist/helpers/urls.d.ts

@@ -11,6 +11,11 @@ export declare function extractPathFromUrl(url: string | undefined): string;
  * e.g., '/users/:id' becomes '/users/{id}'
  */
 export declare const normalizePath: (path: string) => string;
+/**
+ * Generates a structural path signature by replacing parameter segments with `{*}`.
+ * Paths with the same signature are equivalent except for parameter names.
+ */
+export declare const getPathStructuralSignature: (path: string) => string;
 /**
  * Extracts parameter names from a path string.
  * Handles double curly braces {{param}}, single curly braces {param}, and colon format :param.

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

@@ -1 +1 @@
-{"version":3,"file":"urls.d.ts","sourceRoot":"","sources":["../../src/helpers/urls.ts"],"names":[],"mappings":"AAgBA;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAGpD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAYlE;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAI,MAAM,MAAM,KAAG,MAAyC,CAAA;AAEtF;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAahE;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAyBhF"}
+{"version":3,"file":"urls.d.ts","sourceRoot":"","sources":["../../src/helpers/urls.ts"],"names":[],"mappings":"AAgBA;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAGpD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAYlE;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAI,MAAM,MAAM,KAAG,MAAyC,CAAA;AAEtF;;;GAGG;AACH,eAAO,MAAM,0BAA0B,GAAI,MAAM,MAAM,KAAG,MAWzD,CAAA;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAahE;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAyBhF"}

package/dist/helpers/urls.js

@@ -35,6 +35,19 @@ export function extractPathFromUrl(url) {
  * e.g., '/users/:id' becomes '/users/{id}'
  */
 export const normalizePath = (path) => path.replace(/:(\w+)/g, '{$1}');
+/**
+ * Generates a structural path signature by replacing parameter segments with `{*}`.
+ * Paths with the same signature are equivalent except for parameter names.
+ */
+export const getPathStructuralSignature = (path) => {
+    const normalizedPath = normalizePath(path);
+    if (normalizedPath === '') {
+        return '';
+    }
+    const segments = normalizedPath.split('/');
+    const signatureSegments = segments.map((segment) => (/^\{[^{}]+\}$/.test(segment) ? '{*}' : segment));
+    return signatureSegments.join('/');
+};
 /**
  * Extracts parameter names from a path string.
  * Handles double curly braces {{param}}, single curly braces {param}, and colon format :param.

package/dist/index.d.ts

@@ -1,3 +1,4 @@
 export { type ConvertOptions, type PostmanRequestIndexPath, convert } from './convert.js';
+export { isPostmanCollection } from './is-postman-collection.js';
 export { extractPathFromUrl, normalizePath } from './helpers/urls.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,uBAAuB,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACtF,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,uBAAuB,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACtF,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAA;AAC7D,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/index.js

@@ -1,2 +1,3 @@
 export { convert } from './convert.js';
+export { isPostmanCollection } from './is-postman-collection.js';
 export { extractPathFromUrl, normalizePath } from './helpers/urls.js';

package/dist/is-postman-collection.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Checks whether a JSON string looks like a Postman collection.
+ *
+ * Exported collections are not guaranteed to include `_postman_id`,
+ * so we accept either `_postman_id` or a top-level `item` array,
+ * as long as the schema host matches Postman.
+ */
+export declare const isPostmanCollection: (content: string) => boolean;
+//# sourceMappingURL=is-postman-collection.d.ts.map

package/dist/is-postman-collection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-postman-collection.d.ts","sourceRoot":"","sources":["../src/is-postman-collection.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,GAAI,SAAS,MAAM,KAAG,OAiBrD,CAAA"}

package/dist/is-postman-collection.js

@@ -0,0 +1,23 @@
+/**
+ * Checks whether a JSON string looks like a Postman collection.
+ *
+ * Exported collections are not guaranteed to include `_postman_id`,
+ * so we accept either `_postman_id` or a top-level `item` array,
+ * as long as the schema host matches Postman.
+ */
+export const isPostmanCollection = (content) => {
+    try {
+        const parsed = JSON.parse(content);
+        if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+            return false;
+        }
+        const hasPostmanId = parsed.info?._postman_id !== undefined;
+        const hasItemTree = Array.isArray(parsed.item);
+        const schema = parsed.info?.schema;
+        const hasValidSchema = typeof schema === 'string' && new URL(schema).host === 'schema.getpostman.com';
+        return hasValidSchema && (hasPostmanId || hasItemTree);
+    }
+    catch {
+        return false;
+    }
+};

package/dist/types.d.ts

@@ -189,6 +189,7 @@ export type FormParameter = {
 };
 export type Response = {
     id?: string;
+    name?: string;
     originalRequest?: Request;
     responseTime?: string | number | null;
     timings?: object | null;

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,IAAI,CAAA;IACV,IAAI,EAAE,CAAC,IAAI,GAAG,SAAS,CAAC,EAAE,CAAA;IAC1B,KAAK,CAAC,EAAE,KAAK,EAAE,CAAA;IACf,QAAQ,CAAC,EAAE,QAAQ,EAAE,CAAA;IACrB,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAAA;IAClB,uBAAuB,CAAC,EAAE,uBAAuB,CAAA;CAClD,CAAA;AAED,KAAK,IAAI,GAAG;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED,MAAM,MAAM,WAAW,GACnB,MAAM,GACN;IACE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;CAC1B,CAAA;AAEL,KAAK,OAAO,GACR,MAAM,GACN;IACE,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAA;CACjD,CAAA;AAEL,MAAM,MAAM,IAAI,GAAG;IACjB,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB,QAAQ,CAAC,EAAE,QAAQ,EAAE,CAAA;IACrB,KAAK,CAAC,EAAE,KAAK,EAAE,CAAA;IACf,OAAO,EAAE,OAAO,CAAA;IAChB,QAAQ,CAAC,EAAE,QAAQ,EAAE,CAAA;IACrB,uBAAuB,CAAC,EAAE,uBAAuB,CAAA;IACjD,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAA;CACvB,CAAA;AAED,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB,QAAQ,CAAC,EAAE,QAAQ,EAAE,CAAA;IACrB,IAAI,EAAE,CAAC,IAAI,GAAG,SAAS,CAAC,EAAE,CAAA;IAC1B,KAAK,CAAC,EAAE,KAAK,EAAE,CAAA;IACf,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAAA;IAClB,uBAAuB,CAAC,EAAE,uBAAuB,CAAA;IACjD,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAA;CACvB,CAAA;AAED,MAAM,MAAM,KAAK,GAAG;IAClB,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CAAA;AAED,KAAK,MAAM,GAAG;IACZ,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAAA;IACxB,GAAG,CAAC,EAAE,GAAG,CAAA;IACT,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAED,KAAK,GAAG,GACJ,MAAM,GACN;IACE,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IACxB,IAAI,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,EAAE,CAAA;IAC5D,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,UAAU,EAAE,CAAA;IACpB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,QAAQ,EAAE,CAAA;CACtB,CAAA;AAEL,KAAK,UAAU,GAAG;IAChB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,WAAW,CAAC,EAAE,WAAW,CAAA;CAC1B,CAAA;AAED,MAAM,MAAM,QAAQ,GAAG;IACrB,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;IAChC,IAAI,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,aAAa,CAAA;IACtD,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CAAA;AAED,MAAM,MAAM,IAAI,GAAG;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,IAAI,CAAA;IACb,MAAM,CAAC,EAAE,aAAa,EAAE,CAAA;IACxB,KAAK,CAAC,EAAE,aAAa,EAAE,CAAA;IACvB,KAAK,CAAC,EAAE,aAAa,EAAE,CAAA;IACvB,MAAM,CAAC,EAAE,aAAa,EAAE,CAAA;IACxB,MAAM,CAAC,EAAE,aAAa,EAAE,CAAA;IACxB,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAA;IAC1B,IAAI,CAAC,EAAE,aAAa,EAAE,CAAA;IACtB,IAAI,CAAC,EAAE,aAAa,EAAE,CAAA;IACtB,MAAM,CAAC,EAAE,aAAa,EAAE,CAAA;IACxB,MAAM,CAAC,EAAE,aAAa,EAAE,CAAA;CACzB,CAAA;AAED,KAAK,aAAa,GAAG;IACnB,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;IACjC,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAED,MAAM,MAAM,OAAO,GACf,MAAM,GACN;IACE,GAAG,CAAC,EAAE,GAAG,CAAA;IACT,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAAA;IAClB,KAAK,CAAC,EAAE,WAAW,CAAA;IACnB,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB,MAAM,CAAC,EAAE,UAAU,GAAG,MAAM,CAAA;IAC5B,IAAI,CAAC,EAAE,WAAW,GAAG,IAAI,CAAA;CAC1B,CAAA;AAEL,KAAK,WAAW,GAAG;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CAAA;AAED,KAAK,WAAW,GAAG;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,GAAG,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IACtB,IAAI,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IACvB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB,CAAA;AAED,MAAM,MAAM,UAAU,GAAG,MAAM,EAAE,CAAA;AAEjC,MAAM,MAAM,MAAM,GAAG;IACnB,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,WAAW,CAAC,EAAE,WAAW,CAAA;CAC1B,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,CAAC,EAAE,KAAK,GAAG,YAAY,GAAG,UAAU,GAAG,MAAM,GAAG,SAAS,CAAA;IAC7D,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE;QACR,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,CAAA;KAC7D,CAAA;IACD,UAAU,CAAC,EAAE,mBAAmB,EAAE,CAAA;IAClC,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAA;IAC1B,IAAI,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAChD,OAAO,CAAC,EAAE;QACR,GAAG,CAAC,EAAE;YAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;QAC3B,UAAU,CAAC,EAAE;YAAE,WAAW,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;QACrC,QAAQ,CAAC,EAAE;YAAE,WAAW,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KACpC,CAAA;IACD,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,WAAW,CAAC,EAAE,WAAW,CAAA;CAC1B,CAAA;AAED,MAAM,MAAM,aAAa,GACrB;IACE,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE,WAAW,CAAA;CAC1B,GACD;IACE,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAAA;IAC9B,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE,WAAW,CAAA;CAC1B,CAAA;AAEL,MAAM,MAAM,QAAQ,GAAG;IACrB,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;IACrC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,MAAM,CAAC,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI,CAAA;IACnC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAED,KAAK,MAAM,GAAG;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,KAAK,CAAC;QACjB,GAAG,EAAE,MAAM,CAAA;QACX,KAAK,EAAE,MAAM,CAAA;KACd,CAAC,CAAA;CACH,CAAA;AAED,MAAM,MAAM,SAAS,GAAG;IACtB,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED,MAAM,MAAM,SAAS,GAAG;IACtB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;CACtB,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CACzB,CAAA;AAED,KAAK,uBAAuB,GAAG,EAE9B,CAAA"}

package/package.json

@@ -19,7 +19,7 @@
     "export",
     "scalar"
   ],
-  "version": "0.6.1",
+  "version": "0.6.3",
   "engines": {
     "node": ">=22"
   },
@@ -38,17 +38,19 @@
     "CHANGELOG.md"
   ],
   "dependencies": {
-    "@scalar/helpers": "0.4.3",
+    "@scalar/helpers": "0.5.1",
     "@scalar/openapi-types": "0.7.0"
   },
   "devDependencies": {
     "@types/node": "^24.1.0",
-    "vite": "8.0.0"
+    "vite": "8.0.0",
+    "@scalar/openapi-parser": "0.25.10"
   },
   "scripts": {
     "build": "tsc -p tsconfig.build.json && tsc-alias -p tsconfig.build.json",
+    "evaluate": "tsx ./scripts/evaluate/run.ts",
     "generate:textures": "tsx ./scripts/generate-textures.ts",
-    "test": "vitest",
+    "test": "vitest --run",
     "types:check": "tsc --noEmit"
   }
 }