nestjs-to-collection 1.0.0

package/dist/parsers/swagger.parser.js

@@ -0,0 +1,237 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SwaggerParser = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/**
+ * Parser for Swagger/OpenAPI specification files
+ */
+class SwaggerParser {
+    /**
+     * Parse a Swagger/OpenAPI file and return an ApiCollection
+     */
+    async parse(filePath) {
+        const absolutePath = path.resolve(process.cwd(), filePath);
+        if (!fs.existsSync(absolutePath)) {
+            throw new Error(`Swagger file not found: ${absolutePath}`);
+        }
+        const content = fs.readFileSync(absolutePath, 'utf-8');
+        let swagger;
+        try {
+            swagger = JSON.parse(content);
+        }
+        catch {
+            throw new Error('Invalid JSON in Swagger file');
+        }
+        return this.convertToApiCollection(swagger);
+    }
+    /**
+     * Parse Swagger document from URL
+     */
+    async parseFromUrl(url) {
+        const response = await fetch(url);
+        if (!response.ok) {
+            throw new Error(`Failed to fetch Swagger from URL: ${response.statusText}`);
+        }
+        const swagger = (await response.json());
+        return this.convertToApiCollection(swagger);
+    }
+    /**
+     * Parse Swagger document from object
+     */
+    parseFromObject(swagger) {
+        return this.convertToApiCollection(swagger);
+    }
+    convertToApiCollection(swagger) {
+        const baseUrl = this.extractBaseUrl(swagger);
+        const groups = this.extractGroups(swagger);
+        return {
+            name: swagger.info.title,
+            description: swagger.info.description,
+            version: swagger.info.version,
+            baseUrl,
+            groups,
+            variables: [
+                {
+                    key: 'baseUrl',
+                    value: baseUrl.replace('{{baseUrl}}', 'http://localhost:3000'),
+                    description: 'Base URL of the API',
+                },
+            ],
+        };
+    }
+    extractBaseUrl(swagger) {
+        // OpenAPI 3.x
+        if (swagger.servers && swagger.servers.length > 0) {
+            return swagger.servers[0].url;
+        }
+        // Swagger 2.x
+        if (swagger.host) {
+            const scheme = swagger.schemes?.[0] || 'https';
+            const basePath = swagger.basePath || '';
+            return `${scheme}://${swagger.host}${basePath}`;
+        }
+        return '{{baseUrl}}';
+    }
+    extractGroups(swagger) {
+        const tagGroups = new Map();
+        const defaultGroup = [];
+        // Process all paths
+        for (const [pathStr, pathItem] of Object.entries(swagger.paths)) {
+            const methods = [];
+            if (pathItem.get)
+                methods.push({ method: 'GET', operation: pathItem.get });
+            if (pathItem.post)
+                methods.push({ method: 'POST', operation: pathItem.post });
+            if (pathItem.put)
+                methods.push({ method: 'PUT', operation: pathItem.put });
+            if (pathItem.patch)
+                methods.push({ method: 'PATCH', operation: pathItem.patch });
+            if (pathItem.delete)
+                methods.push({ method: 'DELETE', operation: pathItem.delete });
+            if (pathItem.options)
+                methods.push({ method: 'OPTIONS', operation: pathItem.options });
+            if (pathItem.head)
+                methods.push({ method: 'HEAD', operation: pathItem.head });
+            for (const { method, operation } of methods) {
+                const endpoint = this.convertOperation(pathStr, method, operation, pathItem);
+                if (operation.tags && operation.tags.length > 0) {
+                    for (const tag of operation.tags) {
+                        if (!tagGroups.has(tag)) {
+                            tagGroups.set(tag, []);
+                        }
+                        tagGroups.get(tag).push(endpoint);
+                    }
+                }
+                else {
+                    defaultGroup.push(endpoint);
+                }
+            }
+        }
+        // Convert to ApiGroup array
+        const groups = [];
+        // Add tag-based groups with descriptions
+        for (const [tagName, endpoints] of tagGroups) {
+            const tagInfo = swagger.tags?.find((t) => t.name === tagName);
+            groups.push({
+                name: tagName,
+                description: tagInfo?.description,
+                endpoints,
+            });
+        }
+        // Add default group if there are untagged endpoints
+        if (defaultGroup.length > 0) {
+            groups.push({
+                name: 'Default',
+                description: 'Untagged endpoints',
+                endpoints: defaultGroup,
+            });
+        }
+        return groups;
+    }
+    convertOperation(pathStr, method, operation, pathItem) {
+        // Merge path-level and operation-level parameters
+        const allParameters = [...(pathItem.parameters || []), ...(operation.parameters || [])];
+        const parameters = allParameters.map((p) => this.convertParameter(p));
+        const requestBody = this.extractRequestBody(operation);
+        return {
+            path: pathStr,
+            method,
+            summary: operation.summary,
+            description: operation.description,
+            operationId: operation.operationId,
+            tags: operation.tags,
+            parameters,
+            requestBody,
+            responses: operation.responses
+                ? Object.fromEntries(Object.entries(operation.responses).map(([code, response]) => [
+                    code,
+                    {
+                        statusCode: code,
+                        description: response.description,
+                        contentType: response.content
+                            ? Object.keys(response.content)[0]
+                            : 'application/json',
+                        schema: response.content
+                            ? Object.values(response.content)[0]?.schema
+                            : response.schema,
+                    },
+                ]))
+                : undefined,
+            security: operation.security,
+        };
+    }
+    convertParameter(param) {
+        return {
+            name: param.name,
+            in: param.in,
+            required: param.required || false,
+            type: param.type || param.schema?.type?.toString() || 'string',
+            description: param.description,
+            example: param.example,
+            schema: param.schema,
+        };
+    }
+    extractRequestBody(operation) {
+        // OpenAPI 3.x requestBody
+        if (operation.requestBody) {
+            const content = operation.requestBody.content;
+            if (content) {
+                const contentType = Object.keys(content)[0] || 'application/json';
+                const mediaType = content[contentType];
+                return {
+                    contentType,
+                    schema: mediaType?.schema,
+                    example: mediaType?.example,
+                    required: operation.requestBody.required,
+                };
+            }
+        }
+        // Swagger 2.x body parameter
+        const bodyParam = operation.parameters?.find((p) => p.in === 'body');
+        if (bodyParam) {
+            return {
+                contentType: 'application/json',
+                schema: bodyParam.schema,
+                example: bodyParam.example,
+                required: bodyParam.required,
+            };
+        }
+        return undefined;
+    }
+}
+exports.SwaggerParser = SwaggerParser;
+//# sourceMappingURL=swagger.parser.js.map

package/dist/parsers/swagger.parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"swagger.parser.js","sourceRoot":"","sources":["../../src/parsers/swagger.parser.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,uCAAyB;AACzB,2CAA6B;AAe7B;;GAEG;AACH,MAAa,aAAa;IACxB;;OAEG;IACH,KAAK,CAAC,KAAK,CAAC,QAAgB;QAC1B,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,CAAC,CAAC;QAE3D,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,2BAA2B,YAAY,EAAE,CAAC,CAAC;QAC7D,CAAC;QAED,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QACvD,IAAI,OAAwB,CAAC;QAE7B,IAAI,CAAC;YACH,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAChC,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;QAClD,CAAC;QAED,OAAO,IAAI,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAC9C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,YAAY,CAAC,GAAW;QAC5B,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,qCAAqC,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;QAC9E,CAAC;QACD,MAAM,OAAO,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAoB,CAAC;QAC3D,OAAO,IAAI,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAC9C,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,OAAwB;QACtC,OAAO,IAAI,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAC9C,CAAC;IAEO,sBAAsB,CAAC,OAAwB;QACrD,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;QAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QAE3C,OAAO;YACL,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK;YACxB,WAAW,EAAE,OAAO,CAAC,IAAI,CAAC,WAAW;YACrC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,OAAO;YAC7B,OAAO;YACP,MAAM;YACN,SAAS,EAAE;gBACT;oBACE,GAAG,EAAE,SAAS;oBACd,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,aAAa,EAAE,uBAAuB,CAAC;oBAC9D,WAAW,EAAE,qBAAqB;iBACnC;aACF;SACF,CAAC;IACJ,CAAC;IAEO,cAAc,CAAC,OAAwB;QAC7C,cAAc;QACd,IAAI,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAClD,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QAChC,CAAC;QAED,cAAc;QACd,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC;YAC/C,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC;YACxC,OAAO,GAAG,MAAM,MAAM,OAAO,CAAC,IAAI,GAAG,QAAQ,EAAE,CAAC;QAClD,CAAC;QAED,OAAO,aAAa,CAAC;IACvB,CAAC;IAEO,aAAa,CAAC,OAAwB;QAC5C,MAAM,SAAS,GAA+B,IAAI,GAAG,EAAE,CAAC;QACxD,MAAM,YAAY,GAAkB,EAAE,CAAC;QAEvC,oBAAoB;QACpB,KAAK,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAChE,MAAM,OAAO,GAA+D,EAAE,CAAC;YAE/E,IAAI,QAAQ,CAAC,GAAG;gBAAE,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC;YAC3E,IAAI,QAAQ,CAAC,IAAI;gBAAE,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;YAC9E,IAAI,QAAQ,CAAC,GAAG;gBAAE,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC;YAC3E,IAAI,QAAQ,CAAC,KAAK;gBAAE,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;YACjF,IAAI,QAAQ,CAAC,MAAM;gBAAE,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;YACpF,IAAI,QAAQ,CAAC,OAAO;gBAAE,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;YACvF,IAAI,QAAQ,CAAC,IAAI;gBAAE,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;YAE9E,KAAK,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,OAAO,EAAE,CAAC;gBAC5C,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;gBAE7E,IAAI,SAAS,CAAC,IAAI,IAAI,SAAS,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAChD,KAAK,MAAM,GAAG,IAAI,SAAS,CAAC,IAAI,EAAE,CAAC;wBACjC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;4BACxB,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;wBACzB,CAAC;wBACD,SAAS,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;oBACrC,CAAC;gBACH,CAAC;qBAAM,CAAC;oBACN,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBAC9B,CAAC;YACH,CAAC;QACH,CAAC;QAED,4BAA4B;QAC5B,MAAM,MAAM,GAAe,EAAE,CAAC;QAE9B,yCAAyC;QACzC,KAAK,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,IAAI,SAAS,EAAE,CAAC;YAC7C,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC;YAC9D,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,OAAO;gBACb,WAAW,EAAE,OAAO,EAAE,WAAW;gBACjC,SAAS;aACV,CAAC,CAAC;QACL,CAAC;QAED,oDAAoD;QACpD,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5B,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,oBAAoB;gBACjC,SAAS,EAAE,YAAY;aACxB,CAAC,CAAC;QACL,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,gBAAgB,CACtB,OAAe,EACf,MAAkB,EAClB,SAA2B,EAC3B,QAAyB;QAEzB,kDAAkD;QAClD,MAAM,aAAa,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,UAAU,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,SAAS,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,CAAC;QAExF,MAAM,UAAU,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC;QACtE,MAAM,WAAW,GAAG,IAAI,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC;QAEvD,OAAO;YACL,IAAI,EAAE,OAAO;YACb,MAAM;YACN,OAAO,EAAE,SAAS,CAAC,OAAO;YAC1B,WAAW,EAAE,SAAS,CAAC,WAAW;YAClC,WAAW,EAAE,SAAS,CAAC,WAAW;YAClC,IAAI,EAAE,SAAS,CAAC,IAAI;YACpB,UAAU;YACV,WAAW;YACX,SAAS,EAAE,SAAS,CAAC,SAAS;gBAC5B,CAAC,CAAC,MAAM,CAAC,WAAW,CAChB,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC;oBAC5D,IAAI;oBACJ;wBACE,UAAU,EAAE,IAAI;wBAChB,WAAW,EAAE,QAAQ,CAAC,WAAW;wBACjC,WAAW,EAAE,QAAQ,CAAC,OAAO;4BAC3B,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;4BAClC,CAAC,CAAC,kBAAkB;wBACtB,MAAM,EAAE,QAAQ,CAAC,OAAO;4BACtB,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM;4BAC5C,CAAC,CAAC,QAAQ,CAAC,MAAM;qBACpB;iBACF,CAAC,CACH;gBACH,CAAC,CAAC,SAAS;YACb,QAAQ,EAAE,SAAS,CAAC,QAAQ;SAC7B,CAAC;IACJ,CAAC;IAEO,gBAAgB,CAAC,KAAuB;QAC9C,OAAO;YACL,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,EAAE,EAAE,KAAK,CAAC,EAAuB;YACjC,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,KAAK;YACjC,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,QAAQ;YAC9D,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,MAAM,EAAE,KAAK,CAAC,MAAM;SACrB,CAAC;IACJ,CAAC;IAEO,kBAAkB,CAAC,SAA2B;QACpD,0BAA0B;QAC1B,IAAI,SAAS,CAAC,WAAW,EAAE,CAAC;YAC1B,MAAM,OAAO,GAAG,SAAS,CAAC,WAAW,CAAC,OAAO,CAAC;YAC9C,IAAI,OAAO,EAAE,CAAC;gBACZ,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,kBAAkB,CAAC;gBAClE,MAAM,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;gBAEvC,OAAO;oBACL,WAAW;oBACX,MAAM,EAAE,SAAS,EAAE,MAAM;oBACzB,OAAO,EAAE,SAAS,EAAE,OAAO;oBAC3B,QAAQ,EAAE,SAAS,CAAC,WAAW,CAAC,QAAQ;iBACzC,CAAC;YACJ,CAAC;QACH,CAAC;QAED,6BAA6B;QAC7B,MAAM,SAAS,GAAG,SAAS,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC;QACrE,IAAI,SAAS,EAAE,CAAC;YACd,OAAO;gBACL,WAAW,EAAE,kBAAkB;gBAC/B,MAAM,EAAE,SAAS,CAAC,MAAM;gBACxB,OAAO,EAAE,SAAS,CAAC,OAAO;gBAC1B,QAAQ,EAAE,SAAS,CAAC,QAAQ;aAC7B,CAAC;QACJ,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;CACF;AA3ND,sCA2NC"}

package/dist/types/index.d.ts

@@ -0,0 +1,187 @@
+/**
+ * HTTP methods supported
+ */
+export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'OPTIONS' | 'HEAD';
+/**
+ * Output format for the collection
+ */
+export type OutputFormat = 'postman' | 'insomnia';
+/**
+ * Source type for endpoint extraction
+ */
+export type SourceType = 'swagger' | 'decorators';
+/**
+ * Parameter location
+ */
+export type ParameterLocation = 'query' | 'path' | 'header' | 'body';
+/**
+ * Represents a single API parameter
+ */
+export interface ApiParameter {
+    name: string;
+    in: ParameterLocation;
+    required: boolean;
+    type: string;
+    description?: string;
+    example?: unknown;
+    schema?: Record<string, unknown>;
+}
+/**
+ * Represents a request body
+ */
+export interface ApiRequestBody {
+    contentType: string;
+    schema?: Record<string, unknown>;
+    example?: unknown;
+    required?: boolean;
+}
+/**
+ * Represents a single API endpoint
+ */
+export interface ApiEndpoint {
+    path: string;
+    method: HttpMethod;
+    summary?: string;
+    description?: string;
+    operationId?: string;
+    tags?: string[];
+    parameters?: ApiParameter[];
+    requestBody?: ApiRequestBody;
+    responses?: Record<string, ApiResponse>;
+    security?: Record<string, string[]>[];
+}
+/**
+ * Represents an API response
+ */
+export interface ApiResponse {
+    statusCode: string;
+    description?: string;
+    contentType?: string;
+    schema?: Record<string, unknown>;
+    example?: unknown;
+}
+/**
+ * Represents a group of endpoints (usually a controller)
+ */
+export interface ApiGroup {
+    name: string;
+    description?: string;
+    endpoints: ApiEndpoint[];
+}
+/**
+ * Represents the entire API structure
+ */
+export interface ApiCollection {
+    name: string;
+    description?: string;
+    version?: string;
+    baseUrl?: string;
+    groups: ApiGroup[];
+    variables?: CollectionVariable[];
+}
+/**
+ * Represents a collection variable
+ */
+export interface CollectionVariable {
+    key: string;
+    value: string;
+    type?: string;
+    description?: string;
+}
+/**
+ * CLI Configuration options
+ */
+export interface CliOptions {
+    source: SourceType;
+    output: OutputFormat;
+    swaggerPath?: string;
+    srcPath?: string;
+    outputPath?: string;
+    baseUrl?: string;
+    collectionName?: string;
+}
+/**
+ * Swagger/OpenAPI document structure (simplified)
+ */
+export interface SwaggerDocument {
+    openapi?: string;
+    swagger?: string;
+    info: {
+        title: string;
+        description?: string;
+        version: string;
+    };
+    servers?: Array<{
+        url: string;
+        description?: string;
+    }>;
+    host?: string;
+    basePath?: string;
+    schemes?: string[];
+    paths: Record<string, SwaggerPathItem>;
+    tags?: Array<{
+        name: string;
+        description?: string;
+    }>;
+    components?: {
+        schemas?: Record<string, unknown>;
+        securitySchemes?: Record<string, unknown>;
+    };
+    definitions?: Record<string, unknown>;
+}
+/**
+ * Swagger path item
+ */
+export interface SwaggerPathItem {
+    get?: SwaggerOperation;
+    post?: SwaggerOperation;
+    put?: SwaggerOperation;
+    patch?: SwaggerOperation;
+    delete?: SwaggerOperation;
+    options?: SwaggerOperation;
+    head?: SwaggerOperation;
+    parameters?: SwaggerParameter[];
+}
+/**
+ * Swagger operation
+ */
+export interface SwaggerOperation {
+    summary?: string;
+    description?: string;
+    operationId?: string;
+    tags?: string[];
+    parameters?: SwaggerParameter[];
+    requestBody?: {
+        required?: boolean;
+        content?: Record<string, {
+            schema?: Record<string, unknown>;
+            example?: unknown;
+        }>;
+    };
+    responses?: Record<string, SwaggerResponse>;
+    security?: Record<string, string[]>[];
+}
+/**
+ * Swagger parameter
+ */
+export interface SwaggerParameter {
+    name: string;
+    in: string;
+    required?: boolean;
+    type?: string;
+    schema?: Record<string, unknown>;
+    description?: string;
+    example?: unknown;
+}
+/**
+ * Swagger response
+ */
+export interface SwaggerResponse {
+    description?: string;
+    content?: Record<string, {
+        schema?: Record<string, unknown>;
+        example?: unknown;
+    }>;
+    schema?: Record<string, unknown>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"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"}

package/dist/types/index.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "nestjs-to-collection",
+  "version": "1.0.0",
+  "description": "Transform NestJS endpoints into Postman and Insomnia collections via CLI",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "nest-to-collection": "dist/cli/index.js",
+    "ntc": "dist/cli/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run build",
+    "test": "jest",
+    "lint": "eslint src --ext .ts",
+    "format": "prettier --write \"src/**/*.ts\""
+  },
+  "keywords": [
+    "nestjs",
+    "postman",
+    "insomnia",
+    "collection",
+    "api",
+    "swagger",
+    "openapi",
+    "cli",
+    "generator"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": ""
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "glob": "^11.0.0",
+    "inquirer": "^9.3.7",
+    "ora": "^8.1.0",
+    "typescript": "^5.6.3",
+    "uuid": "^10.0.0"
+  },
+  "devDependencies": {
+    "@types/inquirer": "^9.0.7",
+    "@types/node": "^22.7.5",
+    "@types/uuid": "^10.0.0",
+    "@typescript-eslint/eslint-plugin": "^8.8.1",
+    "@typescript-eslint/parser": "^8.8.1",
+    "eslint": "^9.12.0",
+    "jest": "^29.7.0",
+    "prettier": "^3.3.3",
+    "ts-jest": "^29.2.5"
+  },
+  "peerDependencies": {
+    "@nestjs/common": ">=10.0.0",
+    "@nestjs/swagger": ">=7.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@nestjs/swagger": {
+      "optional": true
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ]
+}