wrekenfile-converter 2.0.4 → 2.0.7

package/dist/openapi-v2-to-wrekenfile.js

@@ -427,8 +427,8 @@ function extractInterfaces(spec) {
             const returns = extractResponses(op, operationId, method, pathStr);
             interfaces[alias] = {
                 SUMMARY: op.summary || '',
-                DESCRIPTION: op.description || '',
                 DESC: generateDesc(op, method, pathStr),
+                TAGS: Array.isArray(op.tags) ? op.tags : [],
                 ENDPOINT: endpoint,
                 VISIBILITY: visibility,
                 HTTP: {

package/dist/postman-to-wrekenfile.js

@@ -70,11 +70,23 @@ function mapType(value) {
         return 'ANY';
     return 'ANY';
 }
+function getItemDescription(item) {
+    var _a, _b, _c, _d, _e;
+    let description = (_c = (_a = item === null || item === void 0 ? void 0 : item.description) !== null && _a !== void 0 ? _a : (_b = item === null || item === void 0 ? void 0 : item.request) === null || _b === void 0 ? void 0 : _b.description) !== null && _c !== void 0 ? _c : (_e = (_d = item === null || item === void 0 ? void 0 : item.request) === null || _d === void 0 ? void 0 : _d.body) === null || _e === void 0 ? void 0 : _e.description;
+    if (!description)
+        return '';
+    // Postman can store description as an object with { content: string }
+    if (typeof description === 'object' && typeof description.content === 'string') {
+        description = description.content;
+    }
+    if (typeof description !== 'string')
+        return '';
+    return description.replace(/<[^>]*>/g, '').replace(/\n+/g, ' ').trim();
+}
 function generateDesc(item, method, path) {
-    if (item.description) {
-        // Remove HTML tags and clean up description
-        return item.description.replace(/<[^>]*>/g, '').replace(/\n+/g, ' ').trim();
-    }
+    const cleaned = getItemDescription(item);
+    if (cleaned)
+        return cleaned;
     return `${method.toUpperCase()} ${path}`;
 }
 function generateStructName(itemName, method, path, suffix) {
@@ -423,12 +435,13 @@ function extractOperations(collection, variables) {
             return `${name} ${operationNameCount[name]}`;
         }
     }
-    function processItem(item) {
+    function processItem(item, parentName = null) {
         if (item.request) {
             const method = item.request.method || 'GET';
             const url = item.request.url;
             const path = extractPathFromUrl(url, variables);
             const itemName = item.name || 'unknown';
+            const immediateParentName = parentName || null;
             // Generate operation ID
             let operationId = itemName.toLowerCase().replace(/[^a-z0-9]/g, '-');
             operationId = getUniqueOperationName(operationId);
@@ -444,8 +457,8 @@ function extractOperations(collection, variables) {
             operations.push({
                 name: operationId,
                 SUMMARY: itemName || '',
-                DESCRIPTION: item.description ? item.description.replace(/<[^>]*>/g, '').replace(/\n+/g, ' ').trim() : '',
                 DESC: generateDesc(item, method, path),
+                TAGS: immediateParentName ? [immediateParentName] : (itemName ? [itemName] : []),
                 ENDPOINT: `"/${path}"`,
                 VISIBILITY: 'PUBLIC',
                 HTTP: {
@@ -459,12 +472,12 @@ function extractOperations(collection, variables) {
         }
         if (item.item) {
             for (const subItem of item.item) {
-                processItem(subItem);
+                processItem(subItem, item.name || parentName || null);
             }
         }
     }
     for (const item of collection.item) {
-        processItem(item);
+        processItem(item, null);
     }
     return operations;
 }
@@ -501,7 +514,6 @@ function validateYaml(yamlString) {
     }
 }
 function generateWrekenfile(collection, variables) {
-    var _a;
     if (!collection || typeof collection !== 'object') {
         throw new Error("Argument 'collection' is required and must be an object");
     }
@@ -531,13 +543,22 @@ function generateWrekenfile(collection, variables) {
     wrekenfile += `INTERFACES:\n`;
     for (const operation of operations) {
         wrekenfile += `  ${operation.name}:\n`;
-        // Quote SUMMARY and DESCRIPTION if they contain special characters
-        const summary = operation.SUMMARY.includes(':') || operation.SUMMARY.includes('"') ? `"${operation.SUMMARY.replace(/"/g, '\\"')}"` : operation.SUMMARY;
-        const description = operation.DESCRIPTION.includes(':') || operation.DESCRIPTION.includes('"') ? `"${operation.DESCRIPTION.replace(/"/g, '\\"')}"` : operation.DESCRIPTION;
-        const desc = operation.DESC.includes(':') || operation.DESC.includes('"') ? `"${operation.DESC.replace(/"/g, '\\"')}"` : operation.DESC;
+        // Always quote SUMMARY and DESC to avoid YAML parse issues
+        const summary = `"${String(operation.SUMMARY || '').replace(/"/g, '\\"')}"`;
+        const desc = `"${String(operation.DESC || '').replace(/"/g, '\\"')}"`;
         wrekenfile += `    SUMMARY: ${summary}\n`;
-        wrekenfile += `    DESCRIPTION: ${description}\n`;
         wrekenfile += `    DESC: ${desc}\n`;
+        // TAGS
+        if (!operation.TAGS || operation.TAGS.length === 0) {
+            wrekenfile += `    TAGS: []\n`;
+        }
+        else {
+            wrekenfile += `    TAGS:\n`;
+            for (const tag of operation.TAGS) {
+                const tagVal = `"${String(tag).replace(/"/g, '\\"')}"`;
+                wrekenfile += `      - ${tagVal}\n`;
+            }
+        }
         wrekenfile += `    ENDPOINT: ${operation.ENDPOINT}\n`;
         wrekenfile += `    VISIBILITY: ${operation.VISIBILITY}\n`;
         wrekenfile += `    HTTP:\n`;
@@ -557,7 +578,7 @@ function generateWrekenfile(collection, variables) {
             wrekenfile += `    INPUTS:\n`;
             for (const input of operation.INPUTS) {
                 wrekenfile += `      - name: ${input.name}\n`;
-                wrekenfile += `        type: ${input.type}\n`;
+                wrekenfile += `        type: "${String(input.type).replace(/"/g, '\\"')}"\n`;
                 wrekenfile += `        required: '${input.required}'\n`;
                 if (input.location) {
                     wrekenfile += `        location: ${input.location}\n`;
@@ -567,7 +588,7 @@ function generateWrekenfile(collection, variables) {
         // RETURNS
         wrekenfile += `    RETURNS:\n`;
         for (const ret of operation.RETURNS) {
-            wrekenfile += `      - RETURNTYPE: ${ret.RETURNTYPE}\n`;
+            wrekenfile += `      - RETURNTYPE: "${String(ret.RETURNTYPE).replace(/"/g, '\\"')}"\n`;
             wrekenfile += `        RETURNNAME: ${ret.RETURNNAME}\n`;
             wrekenfile += `        CODE: '${ret.CODE}'\n`;
         }
@@ -581,22 +602,13 @@ function generateWrekenfile(collection, variables) {
             wrekenfile += `  ${structName}:\n`;
             for (const field of fields) {
                 wrekenfile += '    - name: ' + field.name + '\n';
-                // Quote type if it contains non-alphanumeric characters (except underscore)
-                let typeValue = field.type;
-                if (/[^a-zA-Z0-9_]/.test(typeValue)) {
-                    typeValue = '"' + typeValue.replace(/"/g, '\"') + '"';
-                }
+                const typeValue = '"' + String(field.type).replace(/"/g, '\\"') + '"';
                 wrekenfile += '      type: ' + typeValue + '\n';
                 wrekenfile += "      required: '" + field.required + "'\n";
             }
         }
     }
     // Debug print: show first 20 lines of STRUCTS block
-    const structsBlock = (_a = wrekenfile.split('STRUCTS:')[1]) === null || _a === void 0 ? void 0 : _a.split('\n').slice(0, 20).join('\n');
-    if (structsBlock) {
-        console.log('--- STRUCTS block preview ---');
-        console.log(structsBlock);
-    }
     wrekenfile = cleanYaml(wrekenfile);
     checkYamlForHiddenChars(wrekenfile);
     validateYaml(wrekenfile);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wrekenfile-converter",
-  "version": "2.0.4",
+  "version": "2.0.7",
   "description": "Convert OpenAPI and Postman specs to Wrekenfile format with mini-chunking for vector DB storage",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",