zod-codegen 1.3.0 → 1.4.0

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+## 1.4.0 (2025-12-01)
+
+- Merge pull request #40 from julienandreu/feat/naming-conventions-and-improvements ([d7c8146](https://github.com/julienandreu/zod-codegen/commit/d7c8146)), closes [#40](https://github.com/julienandreu/zod-codegen/issues/40)
+- feat: add naming convention support and code quality improvements ([3ec8824](https://github.com/julienandreu/zod-codegen/commit/3ec8824))
+- feat: add naming convention support for operation IDs ([0a52f14](https://github.com/julienandreu/zod-codegen/commit/0a52f14))
+
 ## 1.3.0 (2025-11-24)
 
 - Merge pull request #36 from julienandreu/dependabot/npm_and_yarn/dev-dependencies-16beb30ed0 ([3d85de4](https://github.com/julienandreu/zod-codegen/commit/3d85de4)), closes [#36](https://github.com/julienandreu/zod-codegen/issues/36)

package/README.md

@@ -1,7 +1,7 @@
 # zod-codegen
 
 [![npm version](https://img.shields.io/npm/v/zod-codegen.svg)](https://www.npmjs.com/package/zod-codegen)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![License: Apache 2.0](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
 [![TypeScript](https://img.shields.io/badge/TypeScript-007ACC?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
 [![CI](https://github.com/julienandreu/zod-codegen/workflows/CI/badge.svg)](https://github.com/julienandreu/zod-codegen/actions)
 [![Coverage](https://img.shields.io/codecov/c/github/julienandreu/zod-codegen)](https://codecov.io/gh/julienandreu/zod-codegen)
@@ -54,17 +54,42 @@ zod-codegen -i ./swagger.yaml -o ./src/generated
 
 #### CLI Options
 
-| Option      | Alias | Description                         | Default     |
-| ----------- | ----- | ----------------------------------- | ----------- |
-| `--input`   | `-i`  | Path or URL to OpenAPI file         | Required    |
-| `--output`  | `-o`  | Directory to output generated files | `generated` |
-| `--help`    | `-h`  | Show help                           |             |
-| `--version` | `-v`  | Show version                        |             |
+| Option                | Alias | Description                         | Default     |
+| --------------------- | ----- | ----------------------------------- | ----------- |
+| `--input`             | `-i`  | Path or URL to OpenAPI file         | Required    |
+| `--output`            | `-o`  | Directory to output generated files | `generated` |
+| `--naming-convention` | `-n`  | Naming convention for operation IDs | (none)      |
+| `--help`              | `-h`  | Show help                           |             |
+| `--version`           | `-v`  | Show version                        |             |
+
+#### Naming Conventions
+
+The `--naming-convention` option allows you to transform operation IDs according to common naming conventions. Supported conventions:
+
+- `camelCase` - e.g., `getUserById`
+- `PascalCase` - e.g., `GetUserById`
+- `snake_case` - e.g., `get_user_by_id`
+- `kebab-case` - e.g., `get-user-by-id`
+- `SCREAMING_SNAKE_CASE` - e.g., `GET_USER_BY_ID`
+- `SCREAMING-KEBAB-CASE` - e.g., `GET-USER-BY-ID`
+
+**Example:**
+
+```bash
+# Transform operation IDs to camelCase
+zod-codegen --input ./openapi.json --output ./generated --naming-convention camelCase
+
+# Transform operation IDs to snake_case
+zod-codegen -i ./openapi.json -o ./generated -n snake_case
+```
+
+This is particularly useful when OpenAPI specs have inconsistent or poorly named operation IDs.
 
 ### Programmatic Usage
 
 ```typescript
 import {Generator} from 'zod-codegen';
+import type {GeneratorOptions} from 'zod-codegen';
 
 // Create a simple reporter object
 const reporter = {
@@ -72,19 +97,46 @@ const reporter = {
   error: (...args: unknown[]) => console.error(...args),
 };
 
-// Create generator instance
+// Create generator instance with naming convention
 const generator = new Generator(
   'my-app',
   '1.0.0',
   reporter,
   './openapi.json', // Input path or URL
   './generated', // Output directory
+  {
+    namingConvention: 'camelCase', // Transform operation IDs to camelCase
+  },
 );
 
 // Run the generator
 const exitCode = await generator.run();
 ```
 
+#### Custom Operation Name Transformer
+
+For more advanced use cases, you can provide a custom transformer function that receives full operation details:
+
+```typescript
+import {Generator} from 'zod-codegen';
+import type {GeneratorOptions, OperationDetails} from 'zod-codegen';
+
+const customTransformer: GeneratorOptions['operationNameTransformer'] = (details: OperationDetails) => {
+  // details includes: operationId, method, path, tags, summary, description
+  const {operationId, method, tags} = details;
+
+  // Example: Prefix with HTTP method and tag
+  const tag = tags?.[0] || 'default';
+  return `${method.toUpperCase()}_${tag}_${operationId}`;
+};
+
+const generator = new Generator('my-app', '1.0.0', reporter, './openapi.json', './generated', {
+  operationNameTransformer: customTransformer,
+});
+```
+
+**Note:** Custom transformers take precedence over naming conventions if both are provided.
+
 ## 📁 Generated Output
 
 The generator creates a single TypeScript file (`type.ts`) containing:
@@ -458,7 +510,7 @@ We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) f
 
 ## 📝 License
 
-This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+This project is licensed under the Apache License 2.0 - see the [LICENSE](LICENCE) file for details.
 
 ## 🙏 Acknowledgments
 

package/dist/scripts/update-manifest.d.ts

@@ -0,0 +1,14 @@
+interface PackageJson {
+    name: string;
+    version: string;
+    description: string;
+}
+/**
+ * Type guard for the package.json object
+ *
+ * @param input Unknown input
+ * @returns true if the input is an event object
+ */
+export declare function isPackageJson(input: unknown): input is PackageJson;
+export {};
+//# sourceMappingURL=update-manifest.d.ts.map

package/dist/scripts/update-manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-manifest.d.ts","sourceRoot":"","sources":["../../scripts/update-manifest.ts"],"names":[],"mappings":"AAIA,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAclE"}

package/dist/src/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/src/cli.d.ts.map

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

package/dist/src/cli.js

@@ -58,14 +58,43 @@ const argv = yargs(hideBin(process.argv))
     type: 'string',
     description: 'Directory to output the generated files',
     default: 'generated',
+})
+    .option('naming-convention', {
+    alias: 'n',
+    type: 'string',
+    description: 'Naming convention to apply to operation IDs',
+    choices: ['camelCase', 'PascalCase', 'snake_case', 'kebab-case', 'SCREAMING_SNAKE_CASE', 'SCREAMING-KEBAB-CASE'],
+    default: undefined,
 })
     .strict()
     .help()
     .parseSync();
-const { input, output } = argv;
+const { input, output, namingConvention } = argv;
+/**
+ * Type guard to validate that a string is a valid naming convention.
+ * This ensures type safety when parsing CLI arguments.
+ *
+ * @param value - The value to check
+ * @returns True if the value is a valid NamingConvention
+ */
+function isValidNamingConvention(value) {
+    if (value === undefined) {
+        return false;
+    }
+    const validConventions = [
+        'camelCase',
+        'PascalCase',
+        'snake_case',
+        'kebab-case',
+        'SCREAMING_SNAKE_CASE',
+        'SCREAMING-KEBAB-CASE',
+    ];
+    return validConventions.includes(value);
+}
 void (async () => {
     try {
-        const generator = new Generator(name, version, reporter, input, output);
+        const options = isValidNamingConvention(namingConvention) ? { namingConvention } : {};
+        const generator = new Generator(name, version, reporter, input, output, options);
         const exitCode = await generator.run();
         process.exit(exitCode);
     }

package/dist/src/generator.d.ts

@@ -0,0 +1,23 @@
+import type { Reporter } from './utils/reporter.js';
+import type { GeneratorOptions } from './types/generator-options.js';
+export type { GeneratorOptions } from './types/generator-options.js';
+export type { NamingConvention, OperationDetails, OperationNameTransformer } from './utils/naming-convention.js';
+export declare class Generator {
+    private readonly _name;
+    private readonly _version;
+    private readonly reporter;
+    private readonly inputPath;
+    private readonly _outputDir;
+    private readonly fileReader;
+    private readonly fileParser;
+    private readonly codeGenerator;
+    private readonly fileWriter;
+    private readonly outputPath;
+    constructor(_name: string, _version: string, reporter: Reporter, inputPath: string, _outputDir: string, options?: GeneratorOptions);
+    run(): Promise<number>;
+    private readFile;
+    private parseFile;
+    private generateCode;
+    private writeFile;
+}
+//# sourceMappingURL=generator.d.ts.map

package/dist/src/generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,qBAAqB,CAAC;AAElD,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,8BAA8B,CAAC;AAMnE,YAAY,EAAC,gBAAgB,EAAC,MAAM,8BAA8B,CAAC;AACnE,YAAY,EAAC,gBAAgB,EAAE,gBAAgB,EAAE,wBAAwB,EAAC,MAAM,8BAA8B,CAAC;AAE/G,qBAAa,SAAS;IAQlB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAX7B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA+B;IAC1D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAkC;IAC7D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAiC;IAC/D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAwB;IACnD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAGjB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EACnC,OAAO,GAAE,gBAAqB;IAO1B,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC;YAqBd,QAAQ;IAItB,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,SAAS;CAGlB"}

package/dist/src/generator.js

@@ -9,10 +9,10 @@ export class Generator {
     _outputDir;
     fileReader = new SyncFileReaderService();
     fileParser = new OpenApiFileParserService();
-    codeGenerator = new TypeScriptCodeGeneratorService();
+    codeGenerator;
     fileWriter;
     outputPath;
-    constructor(_name, _version, reporter, inputPath, _outputDir) {
+    constructor(_name, _version, reporter, inputPath, _outputDir, options = {}) {
         this._name = _name;
         this._version = _version;
         this.reporter = reporter;
@@ -20,6 +20,7 @@ export class Generator {
         this._outputDir = _outputDir;
         this.fileWriter = new SyncFileWriterService(this._name, this._version, inputPath);
         this.outputPath = this.fileWriter.resolveOutputPath(this._outputDir);
+        this.codeGenerator = new TypeScriptCodeGeneratorService(options);
     }
     async run() {
         try {

package/dist/src/http/fetch-client.d.ts

@@ -0,0 +1,15 @@
+import type { HttpClient, HttpRequestConfig, HttpResponse } from '../types/http.js';
+export declare class FetchHttpClient implements HttpClient {
+    private readonly baseUrl;
+    private readonly defaultHeaders;
+    private readonly fetch;
+    private readonly Headers;
+    constructor(baseUrl?: string, defaultHeaders?: Record<string, string>);
+    request<TResponse = unknown, TRequest = unknown>(config: HttpRequestConfig<TRequest>): Promise<HttpResponse<TResponse>>;
+    private buildUrl;
+    private buildHeaders;
+    private buildBody;
+    private extractHeaders;
+    private parseResponse;
+}
+//# sourceMappingURL=fetch-client.d.ts.map

package/dist/src/http/fetch-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-client.d.ts","sourceRoot":"","sources":["../../../src/http/fetch-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,UAAU,EAAE,iBAAiB,EAAE,YAAY,EAAC,MAAM,kBAAkB,CAAC;AAclF,qBAAa,eAAgB,YAAW,UAAU;IAK9C,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,cAAc;IALjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;gBAG1B,OAAO,SAAK,EACZ,cAAc,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM;IAoBxD,OAAO,CAAC,SAAS,GAAG,OAAO,EAAE,QAAQ,GAAG,OAAO,EACnD,MAAM,EAAE,iBAAiB,CAAC,QAAQ,CAAC,GAClC,OAAO,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;IA4DnC,OAAO,CAAC,QAAQ;IAehB,OAAO,CAAC,YAAY;IAgBpB,OAAO,CAAC,SAAS;IAqBjB,OAAO,CAAC,cAAc;YAQR,aAAa;CAkB5B"}

package/dist/src/interfaces/code-generator.d.ts

@@ -0,0 +1,20 @@
+import type { OpenApiSpecType } from '../types/openapi.js';
+export interface CodeGenerator {
+    generate(spec: OpenApiSpecType): string;
+}
+export interface SchemaBuilder {
+    buildSchema(schema: unknown, required?: boolean): unknown;
+}
+export interface TypeBuilder {
+    buildType(type: string): unknown;
+}
+export interface ImportBuilder {
+    buildImports(): unknown[];
+}
+export interface ClassBuilder {
+    buildClass(spec: OpenApiSpecType): unknown;
+}
+export interface FileWriter {
+    writeFile(filePath: string, content: string): Promise<void> | void;
+}
+//# sourceMappingURL=code-generator.d.ts.map

package/dist/src/interfaces/code-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-generator.d.ts","sourceRoot":"","sources":["../../../src/interfaces/code-generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,qBAAqB,CAAC;AAEzD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAAC;CACzC;AAED,MAAM,WAAW,aAAa;IAC5B,WAAW,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;CAC3D;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;CAClC;AAED,MAAM,WAAW,aAAa;IAC5B,YAAY,IAAI,OAAO,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC;CAC5C;AAED,MAAM,WAAW,UAAU;IACzB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACpE"}

package/dist/src/interfaces/file-reader.d.ts

@@ -0,0 +1,13 @@
+export interface FileReader {
+    readFile(path: string): Promise<string> | string;
+}
+export interface FileParser<TInput, TOutput> {
+    parse(input: TInput): TOutput;
+}
+export interface OpenApiFileReader extends FileReader {
+    readFile(path: string): Promise<string> | string;
+}
+export interface OpenApiFileParser<TOutput> extends FileParser<unknown, TOutput> {
+    parse(input: unknown): TOutput;
+}
+//# sourceMappingURL=file-reader.d.ts.map

package/dist/src/interfaces/file-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-reader.d.ts","sourceRoot":"","sources":["../../../src/interfaces/file-reader.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;CAClD;AAED,MAAM,WAAW,UAAU,CAAC,MAAM,EAAE,OAAO;IACzC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,iBAAkB,SAAQ,UAAU;IACnD,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;CAClD;AAED,MAAM,WAAW,iBAAiB,CAAC,OAAO,CAAE,SAAQ,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC;IAC9E,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC;CAChC"}

package/dist/src/polyfills/fetch.d.ts

@@ -0,0 +1,5 @@
+export interface FetchPolyfillOptions {
+    enableNodejsPolyfill?: boolean;
+}
+export declare function setupFetchPolyfill(options?: FetchPolyfillOptions): Promise<void>;
+//# sourceMappingURL=fetch.d.ts.map

package/dist/src/polyfills/fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../../src/polyfills/fetch.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,oBAAoB;IACnC,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,wBAAsB,kBAAkB,CAAC,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqB1F"}

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

@@ -0,0 +1,57 @@
+import * as ts from 'typescript';
+import type { CodeGenerator, SchemaBuilder } from '../interfaces/code-generator.js';
+import type { OpenApiSpecType } from '../types/openapi.js';
+import type { GeneratorOptions } from '../types/generator-options.js';
+export declare class TypeScriptCodeGeneratorService implements CodeGenerator, SchemaBuilder {
+    private readonly typeBuilder;
+    private readonly importBuilder;
+    private readonly printer;
+    private readonly namingConvention;
+    private readonly operationNameTransformer;
+    constructor(options?: GeneratorOptions);
+    private readonly ZodAST;
+    generate(spec: OpenApiSpecType): string;
+    buildSchema(schema: unknown, required?: boolean): ts.CallExpression | ts.Identifier;
+    private buildAST;
+    private buildSchemas;
+    private buildSchemaTypeAliases;
+    private buildClientClass;
+    private buildConstructor;
+    private buildGetBaseRequestOptionsMethod;
+    private buildHttpRequestMethod;
+    private buildClientMethods;
+    /**
+     * Transforms operation ID according to the configured naming convention or transformer
+     * Ensures the result is a valid TypeScript identifier
+     */
+    private transformOperationName;
+    private buildEndpointMethod;
+    private buildPathExpression;
+    private buildMethodParameters;
+    private getParameterType;
+    private getSchemaTypeName;
+    private getResponseSchema;
+    private getResponseType;
+    private buildServerConfiguration;
+    private resolveServerUrl;
+    private buildResolveServerUrlFunction;
+    private generateClientName;
+    private createComment;
+    /**
+     * Builds a JSDoc comment string from operation metadata
+     */
+    private buildJSDocComment;
+    private buildZodAST;
+    private buildProperty;
+    private buildDefaultValue;
+    private handleLogicalOperator;
+    private buildLogicalOperator;
+    private buildSchemaFromLogicalOperator;
+    private buildBasicTypeFromSchema;
+    private buildObjectTypeFromSchema;
+    private buildArrayTypeFromSchema;
+    private isReference;
+    private buildFromReference;
+    private topologicalSort;
+}
+//# sourceMappingURL=code-generator.service.d.ts.map

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

@@ -0,0 +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;gBAEpE,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;IA8BpB,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;IAmH3B,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;IAM1B,OAAO,CAAC,eAAe;CAuCxB"}

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

@@ -4,10 +4,17 @@ import { z } from 'zod';
 import { MethodSchema, Reference, SchemaProperties } from '../types/openapi.js';
 import { TypeScriptImportBuilderService } from './import-builder.service.js';
 import { TypeScriptTypeBuilderService } from './type-builder.service.js';
+import { transformNamingConvention, } from '../utils/naming-convention.js';
 export class TypeScriptCodeGeneratorService {
     typeBuilder = new TypeScriptTypeBuilderService();
     importBuilder = new TypeScriptImportBuilderService();
     printer = ts.createPrinter({ newLine: ts.NewLineKind.LineFeed });
+    namingConvention;
+    operationNameTransformer;
+    constructor(options = {}) {
+        this.namingConvention = options.namingConvention;
+        this.operationNameTransformer = options.operationNameTransformer;
+    }
     ZodAST = z.object({
         type: z.enum(['string', 'number', 'boolean', 'object', 'array', 'unknown', 'record']),
         args: z.array(z.unknown()).optional(),
@@ -263,6 +270,35 @@ export class TypeScriptCodeGeneratorService {
             return [...endpoints, ...methods];
         }, []);
     }
+    /**
+     * Transforms operation ID according to the configured naming convention or transformer
+     * Ensures the result is a valid TypeScript identifier
+     */
+    transformOperationName(operationId, method, path, schema) {
+        let transformed;
+        // Custom transformer takes precedence
+        if (this.operationNameTransformer) {
+            const details = {
+                operationId,
+                method,
+                path,
+                ...(schema.tags !== undefined && { tags: schema.tags }),
+                ...(schema.summary !== undefined && { summary: schema.summary }),
+                ...(schema.description !== undefined && { description: schema.description }),
+            };
+            transformed = this.operationNameTransformer(details);
+        }
+        else if (this.namingConvention) {
+            // Apply naming convention if specified
+            transformed = transformNamingConvention(operationId, this.namingConvention);
+        }
+        else {
+            // Return original operationId if no transformation is configured
+            transformed = operationId;
+        }
+        // Sanitize to ensure valid TypeScript identifier (handles edge cases from custom transformers)
+        return this.typeBuilder.sanitizeIdentifier(transformed);
+    }
     buildEndpointMethod(method, path, schema, schemas) {
         const { parameters, pathParams, queryParams, hasRequestBody, contentType } = this.buildMethodParameters(schema, schemas);
         const responseType = this.getResponseType(schema, schemas);
@@ -304,7 +340,8 @@ export class TypeScriptCodeGeneratorService {
         else {
             statements.push(ts.factory.createReturnStatement(ts.factory.createAwaitExpression(makeRequestCall)));
         }
-        const methodDeclaration = ts.factory.createMethodDeclaration([ts.factory.createToken(ts.SyntaxKind.AsyncKeyword)], undefined, ts.factory.createIdentifier(String(schema.operationId)), undefined, undefined, parameters, responseType, ts.factory.createBlock(statements, true));
+        const transformedOperationId = this.transformOperationName(String(schema.operationId), method, path, schema);
+        const methodDeclaration = ts.factory.createMethodDeclaration([ts.factory.createToken(ts.SyntaxKind.AsyncKeyword)], undefined, ts.factory.createIdentifier(transformedOperationId), undefined, undefined, parameters, responseType, ts.factory.createBlock(statements, true));
         // Add JSDoc comment if summary or description exists
         const jsdocComment = this.buildJSDocComment(schema.summary, schema.description, schema, responseType);
         if (jsdocComment) {

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

@@ -0,0 +1,9 @@
+import type { OpenApiFileParser, OpenApiFileReader } from '../interfaces/file-reader.js';
+import type { OpenApiSpecType } from '../types/openapi.js';
+export declare class SyncFileReaderService implements OpenApiFileReader {
+    readFile(path: string): Promise<string>;
+}
+export declare class OpenApiFileParserService implements OpenApiFileParser<OpenApiSpecType> {
+    parse(input: unknown): OpenApiSpecType;
+}
+//# sourceMappingURL=file-reader.service.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,10 @@
+import type { FileWriter } from '../interfaces/code-generator.js';
+export declare class SyncFileWriterService implements FileWriter {
+    private readonly name;
+    private readonly version;
+    private readonly inputPath;
+    constructor(name: string, version: string, inputPath: string);
+    writeFile(filePath: string, content: string): void;
+    resolveOutputPath(outputDir: string, fileName?: string): string;
+}
+//# sourceMappingURL=file-writer.service.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,14 @@
+import * as ts from 'typescript';
+import { z } from 'zod';
+import type { ImportBuilder } from '../interfaces/code-generator.js';
+declare const ImportOptions: z.ZodObject<{
+    defaultImport: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodBoolean>>;
+    namedImports: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodBoolean>>;
+}, z.core.$strip>;
+type ImportOptionsType = z.infer<typeof ImportOptions>;
+export declare class TypeScriptImportBuilderService implements ImportBuilder {
+    buildImports(): ts.ImportDeclaration[];
+    createImport(target: string, options: ImportOptionsType): ts.ImportDeclaration;
+}
+export {};
+//# sourceMappingURL=import-builder.service.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,12 @@
+import * as ts from 'typescript';
+import type { TypeBuilder } from '../interfaces/code-generator.js';
+export declare class TypeScriptTypeBuilderService implements TypeBuilder {
+    buildType(type: string): ts.TypeNode;
+    createProperty(name: string, type: string, isReadonly?: boolean): ts.PropertyDeclaration;
+    createParameter(name: string, type?: string | ts.TypeNode, defaultValue?: ts.Expression, isOptional?: boolean): ts.ParameterDeclaration;
+    createGenericType(name: string): ts.TypeParameterDeclaration;
+    sanitizeIdentifier(name: string): string;
+    toCamelCase(word: string): string;
+    toPascalCase(word: string): string;
+}
+//# sourceMappingURL=type-builder.service.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,59 @@
+import type { NamingConvention, OperationNameTransformer } from '../utils/naming-convention.js';
+/**
+ * Configuration options for the Generator class.
+ *
+ * These options control how operation IDs are transformed during code generation.
+ * You can either use a predefined naming convention or provide a custom transformer function.
+ *
+ * @example
+ * ```typescript
+ * // Using a naming convention
+ * const generator = new Generator(..., {
+ *   namingConvention: 'camelCase'
+ * });
+ *
+ * // Using a custom transformer
+ * const generator = new Generator(..., {
+ *   operationNameTransformer: (details) => {
+ *     return `${details.method}_${details.operationId}`;
+ *   }
+ * });
+ * ```
+ */
+export interface GeneratorOptions {
+    /**
+     * Naming convention to apply to operation IDs.
+     *
+     * If provided, all operation IDs will be transformed according to the specified convention.
+     * This is useful when OpenAPI specs have inconsistent or poorly named operation IDs.
+     *
+     * **Note:** If `operationNameTransformer` is also provided, it takes precedence.
+     *
+     * @example
+     * ```typescript
+     * { namingConvention: 'camelCase' } // Transforms 'get_user_by_id' → 'getUserById'
+     * ```
+     */
+    namingConvention?: NamingConvention;
+    /**
+     * Custom transformer function for operation names.
+     *
+     * If provided, this function will be called for each operation with full operation details.
+     * This allows for advanced customization based on HTTP method, path, tags, etc.
+     *
+     * **Note:** This takes precedence over `namingConvention` if both are provided.
+     * The returned name will be sanitized to ensure it's a valid TypeScript identifier.
+     *
+     * @example
+     * ```typescript
+     * {
+     *   operationNameTransformer: (details) => {
+     *     const tag = details.tags?.[0] || 'default';
+     *     return `${details.method.toUpperCase()}_${tag}_${details.operationId}`;
+     *   }
+     * }
+     * ```
+     */
+    operationNameTransformer?: OperationNameTransformer;
+}
+//# sourceMappingURL=generator-options.d.ts.map

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

@@ -0,0 +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"}

package/dist/src/types/generator-options.js

@@ -0,0 +1 @@
+export {};

package/dist/src/types/http.d.ts

@@ -0,0 +1,25 @@
+export interface HttpRequestConfig<TData = unknown> {
+    readonly url: string;
+    readonly method: HttpMethod;
+    readonly headers?: Record<string, string>;
+    readonly params?: Record<string, string | number | boolean>;
+    readonly data?: TData;
+    readonly timeout?: number;
+}
+export interface HttpResponse<TData = unknown> {
+    readonly data: TData;
+    readonly status: number;
+    readonly statusText: string;
+    readonly headers: Record<string, string>;
+    readonly url: string;
+}
+export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD' | 'OPTIONS';
+export interface HttpClient {
+    request<TResponse = unknown, TRequest = unknown>(config: HttpRequestConfig<TRequest>): Promise<HttpResponse<TResponse>>;
+}
+export declare class HttpError extends Error {
+    readonly status: number;
+    readonly response?: HttpResponse | undefined;
+    constructor(message: string, status: number, response?: HttpResponse | undefined);
+}
+//# sourceMappingURL=http.d.ts.map

package/dist/src/types/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../src/types/http.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB,CAAC,KAAK,GAAG,OAAO;IAChD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;IAC5D,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,YAAY,CAAC,KAAK,GAAG,OAAO;IAC3C,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;AAE1F,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,SAAS,GAAG,OAAO,EAAE,QAAQ,GAAG,OAAO,EAC7C,MAAM,EAAE,iBAAiB,CAAC,QAAQ,CAAC,GAClC,OAAO,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC;CACrC;AAED,qBAAa,SAAU,SAAQ,KAAK;aAGhB,MAAM,EAAE,MAAM;aACd,QAAQ,CAAC,EAAE,YAAY;gBAFvC,OAAO,EAAE,MAAM,EACC,MAAM,EAAE,MAAM,EACd,QAAQ,CAAC,EAAE,YAAY,YAAA;CAK1C"}