zod-codegen 1.5.1 → 1.6.1

package/dist/src/services/code-generator.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"code-generator.service.d.ts","sourceRoot":"","sources":["../../../src/services/code-generator.service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AAEjC,OAAO,KAAK,EAAC,aAAa,EAAE,aAAa,EAAC,MAAM,iCAAiC,CAAC;AAClF,OAAO,KAAK,EAAmB,eAAe,EAAgB,MAAM,qBAAqB,CAAC;AAC1F,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,+BAA+B,CAAC;AAWpE,qBAAa,8BAA+B,YAAW,aAAa,EAAE,aAAa;IACjF,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAsC;IAClE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAwC;IACtE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwD;IAChF,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA+B;IAChE,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAAuC;IAGhF,OAAO,CAAC,eAAe,CAAqB;IAC5C,OAAO,CAAC,iBAAiB,CAAuB;gBAEpC,OAAO,GAAE,gBAAqB;IAK1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAGpB;IAEH,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM;IAMvC,WAAW,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,UAAO,GAAG,EAAE,CAAC,cAAc,GAAG,EAAE,CAAC,UAAU;IA2BhF,OAAO,CAAC,QAAQ;IAmBhB,OAAO,CAAC,YAAY;IA2CpB,OAAO,CAAC,sBAAsB;IAe9B,OAAO,CAAC,gBAAgB;IAsBxB,OAAO,CAAC,gBAAgB;IAmGxB,OAAO,CAAC,gCAAgC;IAwBxC,OAAO,CAAC,sBAAsB;IAqmB9B,OAAO,CAAC,kBAAkB;IAsB1B;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IA0B9B,OAAO,CAAC,mBAAmB;IAgH3B,OAAO,CAAC,mBAAmB;IA6D3B,OAAO,CAAC,qBAAqB;IAwF7B,OAAO,CAAC,gBAAgB;IA0CxB,OAAO,CAAC,iBAAiB;IAmCzB,OAAO,CAAC,iBAAiB;IA8BzB,OAAO,CAAC,eAAe;IAuDvB,OAAO,CAAC,wBAAwB;IA4IhC,OAAO,CAAC,gBAAgB;IAqBxB,OAAO,CAAC,6BAA6B;IAkPrC,OAAO,CAAC,kBAAkB;IAO1B,OAAO,CAAC,aAAa;IAMrB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAuFzB,OAAO,CAAC,WAAW;IA0CnB,OAAO,CAAC,aAAa;IAmjBrB,OAAO,CAAC,iBAAiB;IAuCzB,OAAO,CAAC,qBAAqB;IAe7B,OAAO,CAAC,oBAAoB;IAyE5B,OAAO,CAAC,8BAA8B;IActC,OAAO,CAAC,wBAAwB;IAyBhC,OAAO,CAAC,yBAAyB;IA8BjC,OAAO,CAAC,wBAAwB;IAYhC,OAAO,CAAC,WAAW;IAQnB,OAAO,CAAC,kBAAkB;IA8B1B;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IAmB3B;;;;OAIG;IACH,OAAO,CAAC,0BAA0B;IAiFlC,OAAO,CAAC,eAAe;CAuCxB"}
+{"version":3,"file":"code-generator.service.d.ts","sourceRoot":"","sources":["../../../src/services/code-generator.service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AAEjC,OAAO,KAAK,EAAC,aAAa,EAAE,aAAa,EAAC,MAAM,8BAA8B,CAAC;AAC/E,OAAO,KAAK,EAAmB,eAAe,EAAgB,MAAM,kBAAkB,CAAC;AACvF,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,4BAA4B,CAAC;AAWjE,qBAAa,8BAA+B,YAAW,aAAa,EAAE,aAAa;IACjF,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAsC;IAClE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAwC;IACtE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwD;IAChF,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA+B;IAChE,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAAuC;IAGhF,OAAO,CAAC,eAAe,CAAqB;IAC5C,OAAO,CAAC,iBAAiB,CAAuB;gBAEpC,OAAO,GAAE,gBAAqB;IAK1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAGpB;IAEH,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM;IAMvC,WAAW,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,UAAO,GAAG,EAAE,CAAC,cAAc,GAAG,EAAE,CAAC,UAAU;IA2BhF,OAAO,CAAC,QAAQ;IAmBhB,OAAO,CAAC,YAAY;IA2CpB,OAAO,CAAC,sBAAsB;IAe9B,OAAO,CAAC,gBAAgB;IAuBxB,OAAO,CAAC,gBAAgB;IAmGxB,OAAO,CAAC,gCAAgC;IAwBxC,OAAO,CAAC,yBAAyB;IAuBjC,OAAO,CAAC,sBAAsB;IAkoB9B,OAAO,CAAC,kBAAkB;IAgE1B;;;;OAIG;IACH,OAAO,CAAC,sBAAsB;IAoC9B,OAAO,CAAC,mBAAmB;IAgH3B,OAAO,CAAC,mBAAmB;IA6D3B,OAAO,CAAC,qBAAqB;IAwF7B,OAAO,CAAC,gBAAgB;IA0CxB,OAAO,CAAC,iBAAiB;IAmCzB,OAAO,CAAC,iBAAiB;IA8BzB,OAAO,CAAC,eAAe;IAuDvB,OAAO,CAAC,wBAAwB;IA4IhC,OAAO,CAAC,gBAAgB;IAqBxB,OAAO,CAAC,6BAA6B;IAkPrC,OAAO,CAAC,kBAAkB;IAO1B,OAAO,CAAC,aAAa;IAMrB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAuFzB,OAAO,CAAC,WAAW;IA0CnB,OAAO,CAAC,aAAa;IAmjBrB,OAAO,CAAC,iBAAiB;IAuCzB,OAAO,CAAC,qBAAqB;IAe7B,OAAO,CAAC,oBAAoB;IAyE5B,OAAO,CAAC,8BAA8B;IActC,OAAO,CAAC,wBAAwB;IAyBhC,OAAO,CAAC,yBAAyB;IA8BjC,OAAO,CAAC,wBAAwB;IAYhC,OAAO,CAAC,WAAW;IAQnB,OAAO,CAAC,kBAAkB;IA8B1B;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IAmB3B;;;;OAIG;IACH,OAAO,CAAC,0BAA0B;IAiFlC,OAAO,CAAC,eAAe;CAuCxB"}

package/dist/src/services/code-generator.service.js

@@ -101,6 +101,7 @@ export class TypeScriptCodeGeneratorService {
             this.typeBuilder.createProperty('#baseUrl', 'string', true),
             this.buildConstructor(openapi),
             this.buildGetBaseRequestOptionsMethod(),
+            this.buildHandleResponseMethod(),
             this.buildHttpRequestMethod(),
             ...methods,
         ]);
@@ -142,6 +143,16 @@ export class TypeScriptCodeGeneratorService {
             ]),
         ]), ts.factory.createBlock([ts.factory.createReturnStatement(ts.factory.createObjectLiteralExpression([], false))], true));
     }
+    buildHandleResponseMethod() {
+        return ts.factory.createMethodDeclaration([ts.factory.createToken(ts.SyntaxKind.ProtectedKeyword), ts.factory.createToken(ts.SyntaxKind.AsyncKeyword)], undefined, ts.factory.createIdentifier('handleResponse'), undefined, [this.typeBuilder.createGenericType('T')], [
+            this.typeBuilder.createParameter('response', 'Response'),
+            this.typeBuilder.createParameter('method', 'string'),
+            this.typeBuilder.createParameter('path', 'string'),
+            this.typeBuilder.createParameter('options', '{params?: Record<string, string | number | boolean>; data?: unknown; contentType?: string; headers?: Record<string, string>}'),
+        ], ts.factory.createTypeReferenceNode(ts.factory.createIdentifier('Promise'), [
+            ts.factory.createTypeReferenceNode(ts.factory.createIdentifier('Response'), undefined),
+        ]), ts.factory.createBlock([ts.factory.createReturnStatement(ts.factory.createIdentifier('response'))], true));
+    }
     buildHttpRequestMethod() {
         return ts.factory.createMethodDeclaration([ts.factory.createToken(ts.SyntaxKind.ProtectedKeyword), ts.factory.createToken(ts.SyntaxKind.AsyncKeyword)], undefined, ts.factory.createIdentifier('makeRequest'), undefined, [this.typeBuilder.createGenericType('T')], [
             this.typeBuilder.createParameter('method', 'string'),
@@ -242,7 +253,7 @@ export class TypeScriptCodeGeneratorService {
             ], ts.NodeFlags.Const)),
             // Make fetch request: merge base options with method, headers, and body
             ts.factory.createVariableStatement(undefined, ts.factory.createVariableDeclarationList([
-                ts.factory.createVariableDeclaration(ts.factory.createIdentifier('response'), undefined, undefined, ts.factory.createAwaitExpression(ts.factory.createCallExpression(ts.factory.createIdentifier('fetch'), undefined, [
+                ts.factory.createVariableDeclaration(ts.factory.createIdentifier('rawResponse'), undefined, undefined, ts.factory.createAwaitExpression(ts.factory.createCallExpression(ts.factory.createIdentifier('fetch'), undefined, [
                     ts.factory.createIdentifier('url'),
                     ts.factory.createCallExpression(ts.factory.createPropertyAccessExpression(ts.factory.createIdentifier('Object'), ts.factory.createIdentifier('assign')), undefined, [
                         ts.factory.createObjectLiteralExpression([], false),
@@ -255,6 +266,15 @@ export class TypeScriptCodeGeneratorService {
                     ]),
                 ]))),
             ], ts.NodeFlags.Const)),
+            // Handle response through hook (allows subclasses to intercept and modify response)
+            ts.factory.createVariableStatement(undefined, ts.factory.createVariableDeclarationList([
+                ts.factory.createVariableDeclaration(ts.factory.createIdentifier('response'), undefined, undefined, ts.factory.createAwaitExpression(ts.factory.createCallExpression(ts.factory.createPropertyAccessExpression(ts.factory.createThis(), ts.factory.createIdentifier('handleResponse')), [ts.factory.createTypeReferenceNode(ts.factory.createIdentifier('T'), undefined)], [
+                    ts.factory.createIdentifier('rawResponse'),
+                    ts.factory.createIdentifier('method'),
+                    ts.factory.createIdentifier('path'),
+                    ts.factory.createIdentifier('options'),
+                ]))),
+            ], ts.NodeFlags.Const)),
             // Check response status
             ts.factory.createIfStatement(ts.factory.createPrefixUnaryExpression(ts.SyntaxKind.ExclamationToken, ts.factory.createPropertyAccessExpression(ts.factory.createIdentifier('response'), ts.factory.createIdentifier('ok'))), ts.factory.createThrowStatement(ts.factory.createNewExpression(ts.factory.createIdentifier('Error'), undefined, [
                 ts.factory.createTemplateExpression(ts.factory.createTemplateHead('HTTP ', 'HTTP '), [
@@ -267,6 +287,27 @@ export class TypeScriptCodeGeneratorService {
         ], true));
     }
     buildClientMethods(openapi, schemas) {
+        // Track operation IDs to detect duplicates
+        const operationIdMap = new Map();
+        // First pass: collect all operation IDs and their methods/paths
+        Object.entries(openapi.paths).forEach(([path, pathItem]) => {
+            Object.entries(pathItem)
+                .filter(([method]) => ['get', 'post', 'put', 'patch', 'delete', 'head', 'options'].includes(method))
+                .forEach(([method, methodSchema]) => {
+                const safeMethodSchema = MethodSchema.parse(methodSchema);
+                if (safeMethodSchema.operationId) {
+                    const operationId = safeMethodSchema.operationId;
+                    const existing = operationIdMap.get(operationId);
+                    if (existing) {
+                        existing.push({ method, path });
+                    }
+                    else {
+                        operationIdMap.set(operationId, [{ method, path }]);
+                    }
+                }
+            });
+        });
+        // Second pass: build methods, appending method name for HEAD/OPTIONS or when duplicates exist
         return Object.entries(openapi.paths).reduce((endpoints, [path, pathItem]) => {
             const methods = Object.entries(pathItem)
                 .filter(([method]) => ['get', 'post', 'put', 'patch', 'delete', 'head', 'options'].includes(method))
@@ -275,6 +316,23 @@ export class TypeScriptCodeGeneratorService {
                 if (!safeMethodSchema.operationId) {
                     return null;
                 }
+                const operationId = safeMethodSchema.operationId;
+                const methodLower = method.toLowerCase();
+                // Check if this operationId is used by multiple methods
+                const operations = operationIdMap.get(operationId);
+                const hasDuplicates = operations !== undefined && operations.length > 1;
+                // For HEAD/OPTIONS or when duplicates exist, we need to ensure uniqueness
+                // We'll handle this in transformOperationName by appending the method
+                // But we need to mark it here so transformOperationName knows to append
+                if (hasDuplicates || methodLower === 'head' || methodLower === 'options') {
+                    // Temporarily modify the operationId to include method for uniqueness
+                    // This will be handled in transformOperationName
+                    const modifiedSchema = {
+                        ...safeMethodSchema,
+                        operationId: `${operationId}_${methodLower}`,
+                    };
+                    return this.buildEndpointMethod(method, path, modifiedSchema, schemas);
+                }
                 return this.buildEndpointMethod(method, path, safeMethodSchema, schemas);
             })
                 .filter((method) => method !== null);
@@ -284,6 +342,7 @@ export class TypeScriptCodeGeneratorService {
     /**
      * Transforms operation ID according to the configured naming convention or transformer
      * Ensures the result is a valid TypeScript identifier
+     * For HEAD and OPTIONS methods, appends the method name to ensure uniqueness when same operationId is used
      */
     transformOperationName(operationId, method, path, schema) {
         let transformed;
@@ -307,6 +366,15 @@ export class TypeScriptCodeGeneratorService {
             // Return original operationId if no transformation is configured
             transformed = operationId;
         }
+        // For HEAD and OPTIONS methods, append method name to ensure uniqueness
+        // This prevents duplicate method names when GET and HEAD share the same operationId
+        const methodLower = method.toLowerCase();
+        if (methodLower === 'head' || methodLower === 'options') {
+            // Only append if not already present to avoid double-appending
+            if (!transformed.toLowerCase().endsWith(`_${methodLower}`)) {
+                transformed = `${transformed}_${methodLower}`;
+            }
+        }
         // Sanitize to ensure valid TypeScript identifier (handles edge cases from custom transformers)
         return this.typeBuilder.sanitizeIdentifier(transformed);
     }

package/dist/src/services/file-reader.service.d.ts

@@ -1,5 +1,5 @@
-import type { OpenApiFileParser, OpenApiFileReader } from '../interfaces/file-reader.js';
-import type { OpenApiSpecType } from '../types/openapi.js';
+import type { OpenApiFileParser, OpenApiFileReader } from '../interfaces/file-reader';
+import type { OpenApiSpecType } from '../types/openapi';
 export declare class SyncFileReaderService implements OpenApiFileReader {
     readFile(path: string): Promise<string>;
 }

package/dist/src/services/file-reader.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-reader.service.d.ts","sourceRoot":"","sources":["../../../src/services/file-reader.service.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAC,iBAAiB,EAAE,iBAAiB,EAAC,MAAM,8BAA8B,CAAC;AACvF,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,qBAAqB,CAAC;AAGzD,qBAAa,qBAAsB,YAAW,iBAAiB;IACvD,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAe9C;AAED,qBAAa,wBAAyB,YAAW,iBAAiB,CAAC,eAAe,CAAC;IACjF,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe;CAgBvC"}
+{"version":3,"file":"file-reader.service.d.ts","sourceRoot":"","sources":["../../../src/services/file-reader.service.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAC,iBAAiB,EAAE,iBAAiB,EAAC,MAAM,2BAA2B,CAAC;AACpF,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,kBAAkB,CAAC;AAGtD,qBAAa,qBAAsB,YAAW,iBAAiB;IACvD,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAe9C;AAED,qBAAa,wBAAyB,YAAW,iBAAiB,CAAC,eAAe,CAAC;IACjF,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe;CAgBvC"}

package/dist/src/services/file-writer.service.d.ts

@@ -1,4 +1,4 @@
-import type { FileWriter } from '../interfaces/code-generator.js';
+import type { FileWriter } from '../interfaces/code-generator';
 export declare class SyncFileWriterService implements FileWriter {
     private readonly name;
     private readonly version;

package/dist/src/services/file-writer.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-writer.service.d.ts","sourceRoot":"","sources":["../../../src/services/file-writer.service.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,iCAAiC,CAAC;AAEhE,qBAAa,qBAAsB,YAAW,UAAU;IAEpD,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAFT,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM;IAGpC,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAqBlD,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,SAAY,GAAG,MAAM;CAGnE"}
+{"version":3,"file":"file-writer.service.d.ts","sourceRoot":"","sources":["../../../src/services/file-writer.service.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,8BAA8B,CAAC;AAE7D,qBAAa,qBAAsB,YAAW,UAAU;IAEpD,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAFT,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM;IAGpC,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAqBlD,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,SAAY,GAAG,MAAM;CAGnE"}

package/dist/src/services/import-builder.service.d.ts

@@ -1,6 +1,6 @@
 import * as ts from 'typescript';
 import { z } from 'zod';
-import type { ImportBuilder } from '../interfaces/code-generator.js';
+import type { ImportBuilder } from '../interfaces/code-generator';
 declare const ImportOptions: z.ZodObject<{
     defaultImport: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodBoolean>>;
     namedImports: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodBoolean>>;

package/dist/src/services/import-builder.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"import-builder.service.d.ts","sourceRoot":"","sources":["../../../src/services/import-builder.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AACjC,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AACtB,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,iCAAiC,CAAC;AAKnE,QAAA,MAAM,aAAa;;;iBAGjB,CAAC;AAEH,KAAK,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAEvD,qBAAa,8BAA+B,YAAW,aAAa;IAClE,YAAY,IAAI,EAAE,CAAC,iBAAiB,EAAE;IAQtC,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,EAAE,CAAC,iBAAiB;CAqC/E"}
+{"version":3,"file":"import-builder.service.d.ts","sourceRoot":"","sources":["../../../src/services/import-builder.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AACjC,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AACtB,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,8BAA8B,CAAC;AAKhE,QAAA,MAAM,aAAa;;;iBAGjB,CAAC;AAEH,KAAK,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAEvD,qBAAa,8BAA+B,YAAW,aAAa;IAClE,YAAY,IAAI,EAAE,CAAC,iBAAiB,EAAE;IAQtC,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,EAAE,CAAC,iBAAiB;CAqC/E"}

package/dist/src/services/type-builder.service.d.ts

@@ -1,5 +1,5 @@
 import * as ts from 'typescript';
-import type { TypeBuilder } from '../interfaces/code-generator.js';
+import type { TypeBuilder } from '../interfaces/code-generator';
 export declare class TypeScriptTypeBuilderService implements TypeBuilder {
     buildType(type: string): ts.TypeNode;
     createProperty(name: string, type: string, isReadonly?: boolean): ts.PropertyDeclaration;

package/dist/src/services/type-builder.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"type-builder.service.d.ts","sourceRoot":"","sources":["../../../src/services/type-builder.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AACjC,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,iCAAiC,CAAC;AAEjE,qBAAa,4BAA6B,YAAW,WAAW;IAC9D,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,EAAE,CAAC,QAAQ;IA6BpC,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,UAAQ,GAAG,EAAE,CAAC,mBAAmB;IAYtF,eAAe,CACb,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,GAAG,EAAE,CAAC,QAAQ,EAC3B,YAAY,CAAC,EAAE,EAAE,CAAC,UAAU,EAC5B,UAAU,UAAQ,GACjB,EAAE,CAAC,oBAAoB;IAW1B,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,EAAE,CAAC,wBAAwB;IAS5D,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAMxC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAIjC,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;CAGnC"}
+{"version":3,"file":"type-builder.service.d.ts","sourceRoot":"","sources":["../../../src/services/type-builder.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AACjC,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,8BAA8B,CAAC;AAE9D,qBAAa,4BAA6B,YAAW,WAAW;IAC9D,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,EAAE,CAAC,QAAQ;IA6BpC,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,UAAQ,GAAG,EAAE,CAAC,mBAAmB;IAYtF,eAAe,CACb,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,GAAG,EAAE,CAAC,QAAQ,EAC3B,YAAY,CAAC,EAAE,EAAE,CAAC,UAAU,EAC5B,UAAU,UAAQ,GACjB,EAAE,CAAC,oBAAoB;IAW1B,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,EAAE,CAAC,wBAAwB;IAS5D,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAMxC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAIjC,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;CAGnC"}

package/dist/src/types/generator-options.d.ts

@@ -1,4 +1,4 @@
-import type { NamingConvention, OperationNameTransformer } from '../utils/naming-convention.js';
+import type { NamingConvention, OperationNameTransformer } from '../utils/naming-convention';
 /**
  * Configuration options for the Generator class.
  *

package/dist/src/types/generator-options.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generator-options.d.ts","sourceRoot":"","sources":["../../../src/types/generator-options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,gBAAgB,EAAE,wBAAwB,EAAC,MAAM,+BAA+B,CAAC;AAE9F;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;;;;;;;;OAYG;IACH,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IAEpC;;;;;;;;;;;;;;;;;;OAkBG;IACH,wBAAwB,CAAC,EAAE,wBAAwB,CAAC;CACrD"}
+{"version":3,"file":"generator-options.d.ts","sourceRoot":"","sources":["../../../src/types/generator-options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,gBAAgB,EAAE,wBAAwB,EAAC,MAAM,4BAA4B,CAAC;AAE3F;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;;;;;;;;OAYG;IACH,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IAEpC;;;;;;;;;;;;;;;;;;OAkBG;IACH,wBAAwB,CAAC,EAAE,wBAAwB,CAAC;CACrD"}

package/dist/src/utils/error-handler.d.ts

@@ -1,3 +1,4 @@
-export declare const errorReceived: (process: NodeJS.Process, startTime: bigint) => () => void;
-export declare const handleErrors: (process: NodeJS.Process, startTime: bigint) => void;
+import type { Reporter } from './reporter';
+export declare const errorReceived: (process: NodeJS.Process, startTime: bigint, reporter: Reporter) => () => void;
+export declare const handleErrors: (process: NodeJS.Process, startTime: bigint, reporter: Reporter) => void;
 //# sourceMappingURL=error-handler.d.ts.map

package/dist/src/utils/error-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../../src/utils/error-handler.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,aAAa,GAAI,SAAS,MAAM,CAAC,OAAO,EAAE,WAAW,MAAM,WAAS,IAGhF,CAAC;AAEF,eAAO,MAAM,YAAY,GAAI,SAAS,MAAM,CAAC,OAAO,EAAE,WAAW,MAAM,KAAG,IAKzE,CAAC"}
+{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../../src/utils/error-handler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,YAAY,CAAC;AAEzC,eAAO,MAAM,aAAa,GAAI,SAAS,MAAM,CAAC,OAAO,EAAE,WAAW,MAAM,EAAE,UAAU,QAAQ,WAAS,IAGpG,CAAC;AAEF,eAAO,MAAM,YAAY,GAAI,SAAS,MAAM,CAAC,OAAO,EAAE,WAAW,MAAM,EAAE,UAAU,QAAQ,KAAG,IAK7F,CAAC"}

package/dist/src/utils/error-handler.js

@@ -1,11 +1,11 @@
 import { getExecutionTime } from './execution-time.js';
-export const errorReceived = (process, startTime) => () => {
-    console.log(`Done after ${String(getExecutionTime(startTime))}s`);
+export const errorReceived = (process, startTime, reporter) => () => {
+    reporter.log(`Done after ${String(getExecutionTime(startTime))}s`);
     process.exit(1);
 };
-export const handleErrors = (process, startTime) => {
+export const handleErrors = (process, startTime, reporter) => {
     const catchErrors = ['unhandledRejection', 'uncaughtException'];
     catchErrors.forEach((event) => {
-        process.on(event, errorReceived(process, startTime));
+        process.on(event, errorReceived(process, startTime, reporter));
     });
 };

package/dist/src/utils/reporter.d.ts

@@ -1,6 +1,7 @@
 export declare class Reporter {
-    private readonly _stdout;
-    constructor(_stdout: NodeJS.WriteStream);
+    private readonly stdout;
+    private readonly stderr;
+    constructor(stdout: NodeJS.WriteStream, stderr?: NodeJS.WriteStream);
     log(...args: readonly unknown[]): void;
     error(...args: readonly unknown[]): void;
 }

package/dist/src/utils/reporter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reporter.d.ts","sourceRoot":"","sources":["../../../src/utils/reporter.ts"],"names":[],"mappings":"AAEA,qBAAa,QAAQ;IACP,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,MAAM,CAAC,WAAW;IAKxD,GAAG,CAAC,GAAG,IAAI,EAAE,SAAS,OAAO,EAAE,GAAG,IAAI;IAItC,KAAK,CAAC,GAAG,IAAI,EAAE,SAAS,OAAO,EAAE,GAAG,IAAI;CAGzC"}
+{"version":3,"file":"reporter.d.ts","sourceRoot":"","sources":["../../../src/utils/reporter.ts"],"names":[],"mappings":"AAEA,qBAAa,QAAQ;IAEjB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADN,MAAM,EAAE,MAAM,CAAC,WAAW,EAC1B,MAAM,GAAE,MAAM,CAAC,WAAoB;IAMtD,GAAG,CAAC,GAAG,IAAI,EAAE,SAAS,OAAO,EAAE,GAAG,IAAI;IAItC,KAAK,CAAC,GAAG,IAAI,EAAE,SAAS,OAAO,EAAE,GAAG,IAAI;CAGzC"}

package/dist/src/utils/reporter.js

@@ -1,15 +1,17 @@
 import { format } from 'node:util';
 export class Reporter {
-    _stdout;
-    constructor(_stdout) {
-        this._stdout = _stdout;
+    stdout;
+    stderr;
+    constructor(stdout, stderr = stdout) {
+        this.stdout = stdout;
+        this.stderr = stderr;
         this.log = this.log.bind(this);
         this.error = this.error.bind(this);
     }
     log(...args) {
-        this._stdout.write(format(...args) + '\n');
+        this.stdout.write(format(...args) + '\n');
     }
     error(...args) {
-        this._stdout.write(format(...args) + '\n');
+        this.stderr.write(format(...args) + '\n');
     }
 }

package/dist/src/utils/signal-handler.d.ts

@@ -1,3 +1,4 @@
-export declare const signalReceived: (process: NodeJS.Process, startTime: bigint, event: NodeJS.Signals) => () => void;
-export declare const handleSignals: (process: NodeJS.Process, startTime: bigint) => void;
+import type { Reporter } from './reporter';
+export declare const signalReceived: (process: NodeJS.Process, startTime: bigint, event: NodeJS.Signals, reporter: Reporter) => () => void;
+export declare const handleSignals: (process: NodeJS.Process, startTime: bigint, reporter: Reporter) => void;
 //# sourceMappingURL=signal-handler.d.ts.map

package/dist/src/utils/signal-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"signal-handler.d.ts","sourceRoot":"","sources":["../../../src/utils/signal-handler.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,cAAc,GAAI,SAAS,MAAM,CAAC,OAAO,EAAE,WAAW,MAAM,EAAE,OAAO,MAAM,CAAC,OAAO,WAAS,IAIxG,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,SAAS,MAAM,CAAC,OAAO,EAAE,WAAW,MAAM,KAAG,IAK1E,CAAC"}
+{"version":3,"file":"signal-handler.d.ts","sourceRoot":"","sources":["../../../src/utils/signal-handler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,YAAY,CAAC;AAEzC,eAAO,MAAM,cAAc,GACxB,SAAS,MAAM,CAAC,OAAO,EAAE,WAAW,MAAM,EAAE,OAAO,MAAM,CAAC,OAAO,EAAE,UAAU,QAAQ,WAAS,IAI9F,CAAC;AAEJ,eAAO,MAAM,aAAa,GAAI,SAAS,MAAM,CAAC,OAAO,EAAE,WAAW,MAAM,EAAE,UAAU,QAAQ,KAAG,IAK9F,CAAC"}

package/dist/src/utils/signal-handler.js

@@ -1,12 +1,12 @@
 import { getExecutionTime } from './execution-time.js';
-export const signalReceived = (process, startTime, event) => () => {
-    console.log(`Done after ${String(getExecutionTime(startTime))}s`);
+export const signalReceived = (process, startTime, event, reporter) => () => {
+    reporter.log(`Done after ${String(getExecutionTime(startTime))}s`);
     process.kill(process.pid, event);
     process.exit(1);
 };
-export const handleSignals = (process, startTime) => {
+export const handleSignals = (process, startTime, reporter) => {
     const catchSignals = ['SIGTERM', 'SIGINT', 'SIGUSR2'];
     catchSignals.forEach((event) => {
-        process.once(event, signalReceived(process, startTime, event));
+        process.once(event, signalReceived(process, startTime, event, reporter));
     });
 };

package/examples/README.md

@@ -24,8 +24,15 @@ zod-codegen --input ./samples/swagger-petstore.yaml --output ./examples/petstore
 ```bash
 npx ts-node examples/petstore/basic-usage.ts
 npx ts-node examples/petstore/authenticated-usage.ts
+npx ts-node examples/petstore/server-variables-usage.ts
+npx ts-node examples/petstore/retry-handler-usage.ts
 ```
 
+**Additional examples:**
+
+- `server-variables-usage.ts` - Using server variables for different environments
+- `retry-handler-usage.ts` - Custom retry handler implementation
+
 ### ⚡ [PokéAPI](./pokeapi/)
 
 PokéAPI is a public RESTful API that provides data about Pokémon. This example demonstrates:
@@ -37,9 +44,11 @@ PokéAPI is a public RESTful API that provides data about Pokémon. This example
 **Generate the client:**
 
 ```bash
-zod-codegen --input https://pokeapi.co/api/v2/openapi.json --output ./examples/pokeapi
+zod-codegen --input ./samples/pokeapi-openapi.json --output ./examples/pokeapi
 ```
 
+**Note**: PokéAPI doesn't provide an official OpenAPI specification, so we use a simplified OpenAPI spec based on their API structure.
+
 ## Structure
 
 Each example directory contains:

package/examples/petstore/README.md

@@ -11,7 +11,7 @@ After running `zod-codegen`, you'll get:
 ## Basic Usage
 
 ```typescript
-import {SwaggerPetstoreOpenAPI30} from './type.js';
+import {SwaggerPetstoreOpenAPI30} from './type';
 
 // Create a client instance using default server from OpenAPI spec
 const client = new SwaggerPetstoreOpenAPI30({});
@@ -26,7 +26,7 @@ console.log('Available pets:', pets);
 The generated client supports flexible server configuration:
 
 ```typescript
-import {SwaggerPetstoreOpenAPI30, ClientOptions} from './type.js';
+import {SwaggerPetstoreOpenAPI30, ClientOptions} from './type';
 
 // Option 1: Use default server (first server from OpenAPI spec)
 const defaultClient = new SwaggerPetstoreOpenAPI30({});
@@ -56,10 +56,10 @@ const variableClient = new SwaggerPetstoreOpenAPI30({
 ## Example: Finding Pets
 
 ```typescript
-import {SwaggerPetstoreOpenAPI30, defaultBaseUrl} from './type.js';
+import {SwaggerPetstoreOpenAPI30} from './type';
 
 async function findAvailablePets() {
-  const client = new SwaggerPetstoreOpenAPI30(defaultBaseUrl);
+  const client = new SwaggerPetstoreOpenAPI30({});
 
   try {
     // Find pets by status
@@ -84,11 +84,11 @@ findAvailablePets();
 ## Example: Adding a Pet
 
 ```typescript
-import {SwaggerPetstoreOpenAPI30, Pet, PetStatus, defaultBaseUrl} from './type.js';
+import {SwaggerPetstoreOpenAPI30, Pet, PetStatus} from './type';
 import {z} from 'zod';
 
 async function addNewPet() {
-  const client = new SwaggerPetstoreOpenAPI30(defaultBaseUrl);
+  const client = new SwaggerPetstoreOpenAPI30({});
 
   const newPet: z.infer<typeof Pet> = {
     id: 12345,

package/examples/petstore/authenticated-usage.ts

@@ -4,7 +4,7 @@
  * Run with: npx ts-node examples/petstore/authenticated-usage.ts
  */
 
-import {SwaggerPetstoreOpenAPI30, ClientOptions} from './type.js';
+import {SwaggerPetstoreOpenAPI30, ClientOptions} from './type';
 
 class AuthenticatedPetstoreAPI extends SwaggerPetstoreOpenAPI30 {
   private apiKey: string | null = null;

package/examples/petstore/basic-usage.ts

@@ -4,7 +4,7 @@
  * Run with: npx ts-node examples/petstore/basic-usage.ts
  */
 
-import {SwaggerPetstoreOpenAPI30} from './type.js';
+import {SwaggerPetstoreOpenAPI30} from './type';
 
 async function main() {
   // Use default server (first server from OpenAPI spec)

package/examples/petstore/retry-handler-usage.ts

@@ -0,0 +1,173 @@
+/**
+ * Example showing how to handle special HTTP response cases (e.g., 429 retry logic)
+ * by extending the generated client and overriding the handleResponse method
+ *
+ * Run with: npx ts-node examples/petstore/retry-handler-usage.ts
+ */
+
+import {SwaggerPetstoreOpenAPI30} from './type';
+
+class PetstoreClientWithRetry extends SwaggerPetstoreOpenAPI30 {
+  private maxRetries = 3;
+  private retryDelay = 1000; // 1 second base delay
+  private retrying = false; // Track if we're currently in a retry to avoid infinite loops
+
+  /**
+   * Override handleResponse to intercept responses and handle special cases
+   * This method is called before error checking, allowing you to:
+   * - Retry requests on specific status codes (e.g., 429 Too Many Requests)
+   * - Modify responses before they're processed
+   * - Implement custom error handling logic
+   */
+  protected async handleResponse<T>(
+    response: Response,
+    method: string,
+    path: string,
+    options: {
+      params?: Record<string, string | number | boolean>;
+      data?: unknown;
+      contentType?: string;
+      headers?: Record<string, string>;
+    },
+  ): Promise<Response> {
+    // Skip retry logic if we're already retrying to avoid infinite loops
+    if (this.retrying) {
+      return response;
+    }
+
+    // Handle 429 Too Many Requests with exponential backoff retry
+    if (response.status === 429) {
+      const retryAfter = response.headers.get('Retry-After');
+      const delay = retryAfter ? parseInt(retryAfter, 10) * 1000 : this.retryDelay;
+
+      for (let attempt = 0; attempt < this.maxRetries; attempt++) {
+        console.log(
+          `⚠️  Rate limited (429). Retrying in ${delay * (attempt + 1)}ms... (Attempt ${attempt + 1}/${this.maxRetries})`,
+        );
+
+        // Wait before retrying with exponential backoff
+        await new Promise((resolve) => setTimeout(resolve, delay * (attempt + 1)));
+
+        // Retry the request
+        // We use retryRequest helper to avoid going through handleResponse again
+        // (which would cause infinite loops). Alternatively, if makeRequest is protected,
+        // you could call it directly, but you'd need to ensure handleResponse doesn't
+        // retry again by checking the retrying flag.
+        try {
+          this.retrying = true;
+          const retryResponse = await this.retryRequest(method, path, options);
+          this.retrying = false;
+
+          if (retryResponse.ok) {
+            console.log(`✅ Retry successful after ${attempt + 1} attempt(s)`);
+            return retryResponse;
+          }
+          // If still rate limited, continue to next retry
+          if (retryResponse.status === 429 && attempt < this.maxRetries - 1) {
+            continue;
+          }
+          // Return the response even if it's an error (will be handled by normal error flow)
+          return retryResponse;
+        } catch (error) {
+          this.retrying = false;
+          // If retry fails and we're out of attempts, throw
+          if (attempt === this.maxRetries - 1) {
+            throw error;
+          }
+        }
+      }
+    }
+
+    // Handle other status codes if needed
+    // For example, you could handle 503 Service Unavailable similarly
+    if (response.status === 503) {
+      console.log('⚠️  Service unavailable (503). You could implement retry logic here too.');
+    }
+
+    // For all other responses, return as-is
+    return response;
+  }
+
+  /**
+   * Helper method to retry a request
+   * This reconstructs the request using the same parameters
+   * Note: If makeRequest is protected (not private), you could call it directly instead
+   */
+  private async retryRequest(
+    method: string,
+    path: string,
+    options: {
+      params?: Record<string, string | number | boolean>;
+      data?: unknown;
+      contentType?: string;
+      headers?: Record<string, string>;
+    },
+  ): Promise<Response> {
+    // Reconstruct the request - this duplicates logic from makeRequest
+    // but allows us to retry without going through handleResponse again
+    const baseUrl = `${(this as any)['#baseUrl']}${path}`;
+    const url =
+      options.params && Object.keys(options.params).length > 0
+        ? (() => {
+            const urlObj = new URL(baseUrl);
+            Object.entries(options.params).forEach(([key, value]) => {
+              urlObj.searchParams.set(key, String(value));
+            });
+            return urlObj.toString();
+          })()
+        : baseUrl;
+
+    const baseOptions = this.getBaseRequestOptions();
+    const contentType =
+      options.contentType === 'application/x-www-form-urlencoded'
+        ? 'application/x-www-form-urlencoded'
+        : 'application/json';
+    const baseHeaders = baseOptions.headers !== undefined ? baseOptions.headers : {};
+    const headers = Object.assign(
+      {},
+      baseHeaders,
+      {'Content-Type': contentType},
+      options.headers !== undefined ? options.headers : {},
+    );
+    const body =
+      options.data !== undefined
+        ? options.contentType === 'application/x-www-form-urlencoded'
+          ? (() => {
+              const params = new URLSearchParams();
+              Object.entries(options.data as Record<string, unknown>).forEach(([key, value]) => {
+                params.set(key, String(value));
+              });
+              return params.toString();
+            })()
+          : JSON.stringify(options.data)
+        : null;
+
+    return await fetch(url, Object.assign({}, baseOptions, {method, headers: headers, body: body}));
+  }
+}
+
+async function main() {
+  const client = new PetstoreClientWithRetry({});
+
+  try {
+    console.log('🔍 Fetching pets with retry handler...\n');
+
+    // This will use the handleResponse hook if a 429 is encountered
+    const availablePets = await client.findPetsByStatus('available');
+    console.log(`✅ Found ${availablePets.length} available pets`);
+
+    if (availablePets.length > 0) {
+      console.log('\n📋 First pet details:');
+      console.log(JSON.stringify(availablePets[0], null, 2));
+    }
+  } catch (error) {
+    if (error instanceof Error) {
+      console.error('❌ Error:', error.message);
+    } else {
+      console.error('❌ Unknown error:', error);
+    }
+    process.exit(1);
+  }
+}
+
+void main();

package/examples/petstore/server-variables-usage.ts

@@ -7,7 +7,7 @@
  * For a real example, generate a client from an OpenAPI spec with server variables.
  */
 
-import {SwaggerPetstoreOpenAPI30, ClientOptions} from './type.js';
+import {SwaggerPetstoreOpenAPI30, ClientOptions} from './type';
 
 async function main() {
   // Example 1: Use default server (first server from OpenAPI spec)