@kattebak/openapi-generator-ts 1.0.0

package/dist/parser/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./openapi-parser.js";
+export * from "./operation-transformer.js";
+export * from "./schema-transformer.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/parser/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yBAAyB,CAAC"}

package/dist/parser/index.js

@@ -0,0 +1,4 @@
+export * from "./openapi-parser.js";
+export * from "./operation-transformer.js";
+export * from "./schema-transformer.js";
+//# sourceMappingURL=index.js.map

package/dist/parser/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/parser/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yBAAyB,CAAC"}

package/dist/parser/openapi-parser.d.ts

@@ -0,0 +1,71 @@
+import type { OpenAPI, OpenAPIV3, OpenAPIV3_1 } from "openapi-types";
+export type OpenAPIDocument = OpenAPI.Document;
+export type OpenAPIV3Document = OpenAPIV3.Document;
+export type OpenAPIV31Document = OpenAPIV3_1.Document;
+export interface ParseOptions {
+    /**
+     * Fully dereference all $refs (default: false)
+     * When false, uses bundle mode which preserves internal $refs
+     */
+    dereference?: boolean;
+    /**
+     * Validate the spec against the OpenAPI schema
+     */
+    validate?: boolean;
+    /**
+     * Allow circular references
+     */
+    allowCircular?: boolean;
+}
+export interface ParsedSpec {
+    document: OpenAPIDocument;
+    isOpenAPI3: boolean;
+    isOpenAPI31: boolean;
+    isSwagger2: boolean;
+    version: string;
+}
+/**
+ * Parse an OpenAPI specification from a file path or URL
+ */
+export declare function parseSpec(input: string, options?: ParseOptions): Promise<ParsedSpec>;
+/**
+ * Parse an OpenAPI specification from a string (JSON or YAML)
+ */
+export declare function parseSpecFromString(content: string, options?: ParseOptions): Promise<ParsedSpec>;
+/**
+ * Type guard for OpenAPI 3.x documents
+ */
+export declare function isOpenAPI3(document: OpenAPIDocument): document is OpenAPIV3Document;
+/**
+ * Type guard for OpenAPI 3.1 documents
+ */
+export declare function isOpenAPI31(document: OpenAPIDocument): document is OpenAPIV31Document;
+/**
+ * Get all schemas from the document
+ */
+export declare function getSchemas(document: OpenAPIDocument): Record<string, OpenAPIV3.SchemaObject | OpenAPIV3.ReferenceObject>;
+/**
+ * Get all paths/operations from the document
+ */
+export declare function getPaths(document: OpenAPIDocument): OpenAPIV3.PathsObject;
+/**
+ * Get security schemes from the document
+ */
+export declare function getSecuritySchemes(document: OpenAPIDocument): Record<string, OpenAPIV3.SecuritySchemeObject>;
+/**
+ * Get servers from the document
+ */
+export declare function getServers(document: OpenAPIDocument): OpenAPIV3.ServerObject[];
+/**
+ * Get external documentation from the document
+ */
+export declare function getExternalDocs(document: OpenAPIDocument): OpenAPIV3.ExternalDocumentationObject | undefined;
+/**
+ * Get tags from the document
+ */
+export declare function getTags(document: OpenAPIDocument): OpenAPIV3.TagObject[];
+/**
+ * Get info from the document
+ */
+export declare function getInfo(document: OpenAPIDocument): OpenAPIV3.InfoObject;
+//# sourceMappingURL=openapi-parser.d.ts.map

package/dist/parser/openapi-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi-parser.d.ts","sourceRoot":"","sources":["../../src/parser/openapi-parser.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAErE,MAAM,MAAM,eAAe,GAAG,OAAO,CAAC,QAAQ,CAAC;AAC/C,MAAM,MAAM,iBAAiB,GAAG,SAAS,CAAC,QAAQ,CAAC;AACnD,MAAM,MAAM,kBAAkB,GAAG,WAAW,CAAC,QAAQ,CAAC;AAEtD,MAAM,WAAW,YAAY;IAC5B;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IAC1B,QAAQ,EAAE,eAAe,CAAC;IAC1B,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAsB,SAAS,CAC9B,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,YAAiB,GACxB,OAAO,CAAC,UAAU,CAAC,CAkCrB;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACxC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,YAAiB,GACxB,OAAO,CAAC,UAAU,CAAC,CA4CrB;AAeD;;GAEG;AACH,wBAAgB,UAAU,CACzB,QAAQ,EAAE,eAAe,GACvB,QAAQ,IAAI,iBAAiB,CAE/B;AAED;;GAEG;AACH,wBAAgB,WAAW,CAC1B,QAAQ,EAAE,eAAe,GACvB,QAAQ,IAAI,kBAAkB,CAEhC;AAED;;GAEG;AACH,wBAAgB,UAAU,CACzB,QAAQ,EAAE,eAAe,GACvB,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,YAAY,GAAG,SAAS,CAAC,eAAe,CAAC,CASpE;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,eAAe,GAAG,SAAS,CAAC,WAAW,CASzE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CACjC,QAAQ,EAAE,eAAe,GACvB,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,oBAAoB,CAAC,CAehD;AAED;;GAEG;AACH,wBAAgB,UAAU,CACzB,QAAQ,EAAE,eAAe,GACvB,SAAS,CAAC,YAAY,EAAE,CAiB1B;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC9B,QAAQ,EAAE,eAAe,GACvB,SAAS,CAAC,2BAA2B,GAAG,SAAS,CAKnD;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,QAAQ,EAAE,eAAe,GAAG,SAAS,CAAC,SAAS,EAAE,CAKxE;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,QAAQ,EAAE,eAAe,GAAG,SAAS,CAAC,UAAU,CAEvE"}

package/dist/parser/openapi-parser.js

@@ -0,0 +1,195 @@
+/**
+ * OpenAPI specification parser
+ * Uses @apidevtools/swagger-parser to parse and dereference OpenAPI specs
+ */
+import SwaggerParser from "@apidevtools/swagger-parser";
+/**
+ * Parse an OpenAPI specification from a file path or URL
+ */
+export async function parseSpec(input, options = {}) {
+    const { dereference = false, validate = true } = options;
+    let document;
+    if (dereference) {
+        // Validate and dereference (validate() also dereferences)
+        if (validate) {
+            document = await SwaggerParser.validate(input);
+        }
+        else {
+            document = await SwaggerParser.dereference(input, {
+                dereference: {
+                    circular: options.allowCircular ?? "ignore",
+                },
+            });
+        }
+    }
+    else {
+        // Bundle mode: resolves external refs but preserves internal $refs
+        // Note: We skip validation here as validate() would dereference
+        document = await SwaggerParser.bundle(input);
+    }
+    const version = getSpecVersion(document);
+    const isOpenAPI3 = version.startsWith("3.");
+    const isOpenAPI31 = version.startsWith("3.1");
+    const isSwagger2 = version.startsWith("2.");
+    return {
+        document,
+        isOpenAPI3,
+        isOpenAPI31,
+        isSwagger2,
+        version,
+    };
+}
+/**
+ * Parse an OpenAPI specification from a string (JSON or YAML)
+ */
+export async function parseSpecFromString(content, options = {}) {
+    const { dereference = false, validate = true } = options;
+    // Parse the string content
+    let document;
+    // Try to parse as JSON first, then YAML
+    try {
+        document = JSON.parse(content);
+    }
+    catch {
+        // If JSON parsing fails, it might be YAML
+        const yaml = await import("js-yaml");
+        document = yaml.load(content);
+    }
+    if (dereference) {
+        // Validate and dereference (validate() also dereferences)
+        if (validate) {
+            document = await SwaggerParser.validate(document);
+        }
+        else {
+            document = await SwaggerParser.dereference(document, {
+                dereference: {
+                    circular: options.allowCircular ?? "ignore",
+                },
+            });
+        }
+    }
+    else {
+        // Bundle mode: resolves external refs but preserves internal $refs
+        // Note: We skip validation here as validate() would dereference
+        document = await SwaggerParser.bundle(document);
+    }
+    const version = getSpecVersion(document);
+    const isOpenAPI3 = version.startsWith("3.");
+    const isOpenAPI31 = version.startsWith("3.1");
+    const isSwagger2 = version.startsWith("2.");
+    return {
+        document,
+        isOpenAPI3,
+        isOpenAPI31,
+        isSwagger2,
+        version,
+    };
+}
+/**
+ * Get the OpenAPI/Swagger version from a document
+ */
+function getSpecVersion(document) {
+    if ("openapi" in document && document.openapi) {
+        return document.openapi;
+    }
+    if ("swagger" in document && document.swagger) {
+        return document.swagger;
+    }
+    return "unknown";
+}
+/**
+ * Type guard for OpenAPI 3.x documents
+ */
+export function isOpenAPI3(document) {
+    return "openapi" in document && document.openapi?.startsWith("3.");
+}
+/**
+ * Type guard for OpenAPI 3.1 documents
+ */
+export function isOpenAPI31(document) {
+    return "openapi" in document && document.openapi?.startsWith("3.1");
+}
+/**
+ * Get all schemas from the document
+ */
+export function getSchemas(document) {
+    if (isOpenAPI3(document)) {
+        return document.components?.schemas ?? {};
+    }
+    // Swagger 2.0
+    if ("definitions" in document && document.definitions) {
+        return document.definitions;
+    }
+    return {};
+}
+/**
+ * Get all paths/operations from the document
+ */
+export function getPaths(document) {
+    if (isOpenAPI3(document)) {
+        return document.paths ?? {};
+    }
+    // Swagger 2.0
+    if ("paths" in document && document.paths) {
+        return document.paths;
+    }
+    return {};
+}
+/**
+ * Get security schemes from the document
+ */
+export function getSecuritySchemes(document) {
+    if (isOpenAPI3(document)) {
+        return (document.components?.securitySchemes ?? {});
+    }
+    // Swagger 2.0
+    if ("securityDefinitions" in document && document.securityDefinitions) {
+        return document.securityDefinitions;
+    }
+    return {};
+}
+/**
+ * Get servers from the document
+ */
+export function getServers(document) {
+    if (isOpenAPI3(document)) {
+        return document.servers ?? [];
+    }
+    // Swagger 2.0 - construct from host, basePath, schemes
+    if ("host" in document) {
+        const host = document.host ?? "localhost";
+        const basePath = ("basePath" in document ? document.basePath : "") ?? "";
+        const schemes = ("schemes" in document ? document.schemes : ["https"]) ?? [
+            "https",
+        ];
+        return schemes.map((scheme) => ({
+            url: `${scheme}://${host}${basePath}`,
+        }));
+    }
+    return [];
+}
+/**
+ * Get external documentation from the document
+ */
+export function getExternalDocs(document) {
+    if ("externalDocs" in document) {
+        return document.externalDocs;
+    }
+    return undefined;
+}
+/**
+ * Get tags from the document
+ */
+export function getTags(document) {
+    if ("tags" in document && document.tags) {
+        return document.tags;
+    }
+    return [];
+}
+/**
+ * Get info from the document
+ */
+export function getInfo(document) {
+    return document.info;
+}
+//# sourceMappingURL=openapi-parser.js.map

package/dist/parser/openapi-parser.js.map

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

package/dist/parser/openapi-parser.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * OpenAPI Parser tests
+ * Tests for parsing and validating OpenAPI specifications
+ */
+export {};
+//# sourceMappingURL=openapi-parser.test.d.ts.map

package/dist/parser/openapi-parser.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi-parser.test.d.ts","sourceRoot":"","sources":["../../src/parser/openapi-parser.test.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/parser/openapi-parser.test.js

@@ -0,0 +1,238 @@
+/**
+ * OpenAPI Parser tests
+ * Tests for parsing and validating OpenAPI specifications
+ */
+import assert from "node:assert";
+import { describe, it } from "node:test";
+import { getPaths, getSchemas, getSecuritySchemes, getServers, isOpenAPI3, isOpenAPI31, parseSpecFromString, } from "./openapi-parser.js";
+// Sample petstore-like spec for testing
+const petstoreSpec = {
+    openapi: "3.0.0",
+    info: {
+        title: "Petstore API",
+        version: "1.0.0",
+    },
+    paths: {
+        "/pets": {
+            get: {
+                operationId: "listPets",
+                responses: {
+                    "200": {
+                        description: "List of pets",
+                        content: {
+                            "application/json": {
+                                schema: {
+                                    type: "array",
+                                    items: { $ref: "#/components/schemas/Pet" },
+                                },
+                            },
+                        },
+                    },
+                },
+            },
+        },
+    },
+    components: {
+        schemas: {
+            Pet: {
+                type: "object",
+                required: ["id", "name"],
+                properties: {
+                    id: { type: "integer", format: "int64" },
+                    name: { type: "string" },
+                    tag: { type: "string" },
+                },
+            },
+        },
+    },
+};
+describe("OpenAPI Parser", () => {
+    describe("parseSpecFromString", () => {
+        it("should parse inline spec object", async () => {
+            const spec = {
+                openapi: "3.0.0",
+                info: {
+                    title: "Test API",
+                    version: "1.0.0",
+                },
+                paths: {},
+            };
+            const result = await parseSpecFromString(JSON.stringify(spec));
+            assert.ok(result);
+            assert.ok(result.document);
+            assert.strictEqual(result.document.info.title, "Test API");
+            assert.strictEqual(result.document.info.version, "1.0.0");
+        });
+        it("should parse petstore-like spec", async () => {
+            const result = await parseSpecFromString(JSON.stringify(petstoreSpec));
+            assert.ok(result);
+            assert.ok(result.isOpenAPI3);
+            assert.strictEqual(result.version, "3.0.0");
+            assert.strictEqual(result.document.info.title, "Petstore API");
+        });
+        it("should extract paths from spec", async () => {
+            const result = await parseSpecFromString(JSON.stringify(petstoreSpec));
+            const paths = getPaths(result.document);
+            assert.ok(paths);
+            assert.ok(Object.keys(paths).length > 0);
+            assert.ok(paths["/pets"]);
+        });
+        it("should extract components/schemas from spec", async () => {
+            const result = await parseSpecFromString(JSON.stringify(petstoreSpec));
+            const schemas = getSchemas(result.document);
+            assert.ok(schemas);
+            assert.ok(schemas.Pet);
+        });
+        it("should dereference $ref", async () => {
+            const result = await parseSpecFromString(JSON.stringify(petstoreSpec), {
+                dereference: true,
+            });
+            // After dereferencing, the Pet schema should be resolved
+            const schemas = getSchemas(result.document);
+            const petSchema = schemas.Pet;
+            assert.ok(petSchema);
+            assert.ok("properties" in petSchema);
+            assert.ok(petSchema.properties?.id);
+            assert.ok(petSchema.properties?.name);
+        });
+        it("should detect OpenAPI version", async () => {
+            const result = await parseSpecFromString(JSON.stringify(petstoreSpec));
+            assert.strictEqual(result.isOpenAPI3, true);
+            assert.strictEqual(result.isOpenAPI31, false);
+            assert.strictEqual(result.isSwagger2, false);
+            assert.strictEqual(result.version, "3.0.0");
+        });
+    });
+    describe("validation", () => {
+        it("should validate a valid OpenAPI spec", async () => {
+            // parseSpecFromString with validate: true (default) should not throw
+            const result = await parseSpecFromString(JSON.stringify(petstoreSpec), {
+                validate: true,
+            });
+            assert.ok(result);
+            assert.ok(result.document);
+        });
+        it("should throw for invalid spec when validation enabled", async () => {
+            const invalidSpec = {
+                openapi: "3.0.0",
+                // Missing required 'info' field
+                paths: {},
+            };
+            await assert.rejects(async () => parseSpecFromString(JSON.stringify(invalidSpec), { validate: true }), 
+            // Swagger parser throws an error for invalid specs
+            (err) => err !== null);
+        });
+        it("should parse invalid spec when validation disabled", async () => {
+            const invalidSpec = {
+                openapi: "3.0.0",
+                info: { title: "Test", version: "1.0.0" },
+                paths: {},
+            };
+            const result = await parseSpecFromString(JSON.stringify(invalidSpec), {
+                validate: false,
+            });
+            assert.ok(result);
+        });
+    });
+    describe("type guards", () => {
+        it("should identify OpenAPI 3.x documents", async () => {
+            const result = await parseSpecFromString(JSON.stringify(petstoreSpec));
+            assert.strictEqual(isOpenAPI3(result.document), true);
+            assert.strictEqual(isOpenAPI31(result.document), false);
+        });
+        it("should identify OpenAPI 3.1 documents", async () => {
+            const spec31 = {
+                openapi: "3.1.0",
+                info: {
+                    title: "OpenAPI 3.1 API",
+                    version: "1.0.0",
+                },
+                paths: {},
+            };
+            const result = await parseSpecFromString(JSON.stringify(spec31), {
+                validate: false,
+            });
+            assert.strictEqual(isOpenAPI3(result.document), true);
+            assert.strictEqual(isOpenAPI31(result.document), true);
+        });
+    });
+    describe("Edge cases", () => {
+        it("should handle spec with no paths", async () => {
+            const spec = {
+                openapi: "3.0.0",
+                info: {
+                    title: "Empty API",
+                    version: "1.0.0",
+                },
+                paths: {},
+            };
+            const result = await parseSpecFromString(JSON.stringify(spec));
+            const paths = getPaths(result.document);
+            assert.ok(result);
+            assert.deepStrictEqual(paths, {});
+        });
+        it("should handle spec with components but no schemas", async () => {
+            const spec = {
+                openapi: "3.0.0",
+                info: {
+                    title: "No Schema API",
+                    version: "1.0.0",
+                },
+                paths: {},
+                components: {},
+            };
+            const result = await parseSpecFromString(JSON.stringify(spec));
+            const schemas = getSchemas(result.document);
+            assert.ok(result);
+            assert.deepStrictEqual(schemas, {});
+        });
+        it("should handle spec with servers", async () => {
+            const spec = {
+                openapi: "3.0.0",
+                info: {
+                    title: "Server API",
+                    version: "1.0.0",
+                },
+                servers: [
+                    { url: "https://api.example.com/v1" },
+                    { url: "https://staging.example.com/v1" },
+                ],
+                paths: {},
+            };
+            const result = await parseSpecFromString(JSON.stringify(spec));
+            const servers = getServers(result.document);
+            assert.ok(servers);
+            assert.strictEqual(servers.length, 2);
+            assert.strictEqual(servers[0].url, "https://api.example.com/v1");
+        });
+        it("should handle spec with security schemes", async () => {
+            const spec = {
+                openapi: "3.0.0",
+                info: {
+                    title: "Secure API",
+                    version: "1.0.0",
+                },
+                paths: {},
+                components: {
+                    securitySchemes: {
+                        bearerAuth: {
+                            type: "http",
+                            scheme: "bearer",
+                        },
+                        apiKey: {
+                            type: "apiKey",
+                            in: "header",
+                            name: "X-API-Key",
+                        },
+                    },
+                },
+            };
+            const result = await parseSpecFromString(JSON.stringify(spec));
+            const securitySchemes = getSecuritySchemes(result.document);
+            assert.ok(securitySchemes);
+            assert.ok(securitySchemes.bearerAuth);
+            assert.ok(securitySchemes.apiKey);
+        });
+    });
+});
+//# sourceMappingURL=openapi-parser.test.js.map

package/dist/parser/openapi-parser.test.js.map

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

package/dist/parser/operation-transformer.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Operation transformer
+ * Converts OpenAPI operations to CodegenOperation objects
+ */
+import type { OpenAPIV3 } from "openapi-types";
+import { type CodegenOperation } from "../models/index.js";
+export interface OperationTransformerOptions {
+    /**
+     * Type mappings from OpenAPI types to target language types
+     */
+    typeMappings?: Record<string, string>;
+    /**
+     * Reserved words for model renaming
+     */
+    reservedWords?: Set<string>;
+    /**
+     * Custom function to convert operation IDs for the target language.
+     */
+    toOperationId?: (name: string) => string;
+}
+declare const HTTP_METHODS: readonly ["get", "post", "put", "delete", "patch", "options", "head", "trace"];
+type HttpMethod = (typeof HTTP_METHODS)[number];
+export declare class OperationTransformer {
+    private schemaTransformer;
+    private options;
+    private schemas;
+    constructor(options?: OperationTransformerOptions);
+    /**
+     * Transform all operations in paths object
+     */
+    transformPaths(paths: OpenAPIV3.PathsObject, securitySchemes?: Record<string, OpenAPIV3.SecuritySchemeObject>, schemas?: Record<string, OpenAPIV3.SchemaObject | OpenAPIV3.ReferenceObject>): Map<string, CodegenOperation[]>;
+    /**
+     * Transform a single operation
+     */
+    transformOperation(path: string, method: HttpMethod, operation: OpenAPIV3.OperationObject, pathParameters: OpenAPIV3.ParameterObject[], securitySchemes?: Record<string, OpenAPIV3.SecuritySchemeObject>): CodegenOperation;
+    /**
+     * Transform a parameter
+     */
+    private transformParameter;
+    /**
+     * Transform request body
+     */
+    private transformRequestBody;
+    /**
+     * Transform a response
+     */
+    private transformResponse;
+    /**
+     * Transform a security scheme
+     */
+    private transformSecurityScheme;
+    /**
+     * Add parameter to operation and categorize it
+     */
+    private addParameter;
+    /**
+     * Convert a CodegenProperty to CodegenParameter
+     */
+    private propertyToParameter;
+    /**
+     * Parse content type string into ContentType object
+     */
+    private parseContentType;
+    /**
+     * Generate operation ID from path and method
+     */
+    private generateOperationId;
+    /**
+     * Type guard for reference objects
+     */
+    private isReferenceObject;
+    /**
+     * Extract ref name from $ref string
+     */
+    private getRefName;
+    /**
+     * Extract vendor extensions (x-*) from object
+     */
+    private extractVendorExtensions;
+    /**
+     * Resolve array alias to its element type
+     * Returns null if not an array alias
+     */
+    private resolveArrayAlias;
+    /**
+     * Convert a name to model naming convention (with reserved word handling)
+     */
+    private toModelName;
+}
+/**
+ * Create an operation transformer with default options
+ */
+export declare function createOperationTransformer(options?: OperationTransformerOptions): OperationTransformer;
+export {};
+//# sourceMappingURL=operation-transformer.d.ts.map

package/dist/parser/operation-transformer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-transformer.d.ts","sourceRoot":"","sources":["../../src/parser/operation-transformer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EACN,KAAK,gBAAgB,EAUrB,MAAM,oBAAoB,CAAC;AAG5B,MAAM,WAAW,2BAA2B;IAC3C;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEtC;;OAEG;IACH,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAE5B;;OAEG;IACH,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CACzC;AAED,QAAA,MAAM,YAAY,gFASR,CAAC;AAEX,KAAK,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhD,qBAAa,oBAAoB;IAChC,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,OAAO,CAA8B;IAC7C,OAAO,CAAC,OAAO,CAGR;gBAEK,OAAO,GAAE,2BAAgC;IAQrD;;OAEG;IACH,cAAc,CACb,KAAK,EAAE,SAAS,CAAC,WAAW,EAC5B,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,oBAAoB,CAAC,EAChE,OAAO,CAAC,EAAE,MAAM,CACf,MAAM,EACN,SAAS,CAAC,YAAY,GAAG,SAAS,CAAC,eAAe,CAClD,GACC,GAAG,CAAC,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAsClC;;OAEG;IACH,kBAAkB,CACjB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,UAAU,EAClB,SAAS,EAAE,SAAS,CAAC,eAAe,EACpC,cAAc,EAAE,SAAS,CAAC,eAAe,EAAE,EAC3C,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,oBAAoB,CAAC,GAC9D,gBAAgB;IAkLnB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA2F1B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAyF5B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAoGzB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAiE/B;;OAEG;IACH,OAAO,CAAC,YAAY;IA4BpB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAuC3B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAkBxB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAS3B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAIzB;;OAEG;IACH,OAAO,CAAC,UAAU;IAKlB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAc/B;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAsBzB;;OAEG;IACH,OAAO,CAAC,WAAW;CAUnB;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACzC,OAAO,CAAC,EAAE,2BAA2B,GACnC,oBAAoB,CAEtB"}