zod-codegen 1.3.0 → 1.4.1

package/.github/workflows/ci.yml

@@ -29,25 +29,25 @@ jobs:
         uses: actions/setup-node@v5
         with:
           node-version: ${{ matrix.node-version }}
-          cache: 'yarn'
+          cache: 'npm'
 
       - name: Install dependencies
-        run: yarn install --frozen-lockfile
+        run: npm ci
 
       - name: Run type check
-        run: yarn type-check
+        run: npm run type-check
 
       - name: Run linter
-        run: yarn lint:check
+        run: npm run lint:check
 
       - name: Run formatter check
-        run: yarn format:check
+        run: npm run format:check
 
       - name: Build project
-        run: yarn build
+        run: npm run build
 
       - name: Run tests
-        run: yarn test:coverage
+        run: npm run test:coverage
 
       - name: Upload coverage to Codecov
         if: matrix.node-version == '24.11.1' && matrix.os == 'ubuntu-latest'
@@ -70,13 +70,13 @@ jobs:
         uses: actions/setup-node@v5
         with:
           node-version: '24.11.1'
-          cache: 'yarn'
+          cache: 'npm'
 
       - name: Install dependencies
-        run: yarn install --frozen-lockfile
+        run: npm ci
 
       - name: Run security audit
-        run: yarn audit --level high
+        run: npm audit --audit-level=high
 
   build:
     name: Build & Package
@@ -91,13 +91,13 @@ jobs:
         uses: actions/setup-node@v5
         with:
           node-version: '24.11.1'
-          cache: 'yarn'
+          cache: 'npm'
 
       - name: Install dependencies
-        run: yarn install --frozen-lockfile
+        run: npm ci
 
       - name: Build project
-        run: yarn build
+        run: npm run build
 
       - name: Test CLI
         run: |
@@ -129,15 +129,15 @@ jobs:
         uses: actions/setup-node@v5
         with:
           node-version: '24.11.1'
-          cache: 'yarn'
+          cache: 'npm'
 
       - name: Install dependencies
-        run: yarn install --frozen-lockfile
+        run: npm ci
 
       - name: Build project
-        run: yarn build
+        run: npm run build
 
       - name: Preview semantic-release
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        run: yarn release:dry
+        run: npm run release:dry

package/.github/workflows/release.yml

@@ -29,26 +29,26 @@ jobs:
         uses: actions/setup-node@v5
         with:
           node-version: '24.11.1'
-          cache: 'yarn'
+          cache: 'npm'
           registry-url: 'https://registry.npmjs.org'
 
       - name: Install dependencies
-        run: yarn install --frozen-lockfile
+        run: npm ci
 
       - name: Run type check
-        run: yarn type-check
+        run: npm run type-check
 
       - name: Run linter check
-        run: yarn lint:check
+        run: npm run lint:check
 
       - name: Run formatter check
-        run: yarn format:check
+        run: npm run format:check
 
       - name: Run tests with coverage
-        run: yarn test:coverage
+        run: npm run test:coverage
 
       - name: Build project
-        run: yarn build
+        run: npm run build
 
       - name: Test CLI functionality
         run: |
@@ -62,4 +62,4 @@ jobs:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
           NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
-        run: yarn release
+        run: npm run release

package/CHANGELOG.md

@@ -1,3 +1,20 @@
+## <small>1.4.1 (2025-12-08)</small>
+
+- Merge branch 'refactor/build-config-and-class-exports' of github.com:julienandreu/zod-codegen into r ([bdd9bc5](https://github.com/julienandreu/zod-codegen/commit/bdd9bc5))
+- Merge pull request #41 from julienandreu/dependabot/npm_and_yarn/tar-7.5.2 ([192cd47](https://github.com/julienandreu/zod-codegen/commit/192cd47)), closes [#41](https://github.com/julienandreu/zod-codegen/issues/41)
+- Merge pull request #43 from julienandreu/refactor/build-config-and-class-exports ([61de21b](https://github.com/julienandreu/zod-codegen/commit/61de21b)), closes [#43](https://github.com/julienandreu/zod-codegen/issues/43)
+- refactor: improve build configuration and class exports ([060f714](https://github.com/julienandreu/zod-codegen/commit/060f714))
+- refactor: improve build configuration and class exports ([b8771ad](https://github.com/julienandreu/zod-codegen/commit/b8771ad))
+- refactor: remove tsconfig.build.json and use tsconfig.json directly ([407c46a](https://github.com/julienandreu/zod-codegen/commit/407c46a))
+- chore: restore yarn.lock for yarn 4 with corepack ([a93f018](https://github.com/julienandreu/zod-codegen/commit/a93f018))
+- chore(deps): bump tar from 7.5.1 to 7.5.2 ([b867dce](https://github.com/julienandreu/zod-codegen/commit/b867dce))
+
+## 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/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;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;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(),
@@ -79,7 +86,7 @@ export class TypeScriptCodeGeneratorService {
     buildClientClass(openapi, schemas) {
         const clientName = this.generateClientName(openapi.info.title);
         const methods = this.buildClientMethods(openapi, schemas);
-        return ts.factory.createClassDeclaration([ts.factory.createToken(ts.SyntaxKind.ExportKeyword)], ts.factory.createIdentifier(clientName), undefined, undefined, [
+        return ts.factory.createClassDeclaration([ts.factory.createToken(ts.SyntaxKind.ExportKeyword), ts.factory.createToken(ts.SyntaxKind.DefaultKeyword)], ts.factory.createIdentifier(clientName), undefined, undefined, [
             this.typeBuilder.createProperty('#baseUrl', 'string', true),
             this.buildConstructor(openapi),
             this.buildGetBaseRequestOptionsMethod(),
@@ -125,7 +132,7 @@ export class TypeScriptCodeGeneratorService {
         ]), ts.factory.createBlock([ts.factory.createReturnStatement(ts.factory.createObjectLiteralExpression([], false))], true));
     }
     buildHttpRequestMethod() {
-        return ts.factory.createMethodDeclaration([ts.factory.createToken(ts.SyntaxKind.AsyncKeyword)], undefined, ts.factory.createPrivateIdentifier('#makeRequest'), undefined, [this.typeBuilder.createGenericType('T')], [
+        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'),
             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.createObjectLiteralExpression([], false), false),
@@ -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);
@@ -295,7 +331,7 @@ export class TypeScriptCodeGeneratorService {
         }
         const optionsExpression = ts.factory.createObjectLiteralExpression(optionsProps, false);
         // Call makeRequest
-        const makeRequestCall = ts.factory.createCallExpression(ts.factory.createPropertyAccessExpression(ts.factory.createThis(), ts.factory.createPrivateIdentifier('#makeRequest')), undefined, [ts.factory.createStringLiteral(method.toUpperCase(), true), pathExpression, optionsExpression]);
+        const makeRequestCall = ts.factory.createCallExpression(ts.factory.createPropertyAccessExpression(ts.factory.createThis(), ts.factory.createIdentifier('makeRequest')), undefined, [ts.factory.createStringLiteral(method.toUpperCase(), true), pathExpression, optionsExpression]);
         // Add Zod validation if we have a response schema
         if (responseSchema) {
             const validateCall = ts.factory.createCallExpression(ts.factory.createPropertyAccessExpression(responseSchema, ts.factory.createIdentifier('parse')), undefined, [ts.factory.createAwaitExpression(makeRequestCall)]);
@@ -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