zod-codegen 1.2.2 → 1.4.0

package/.claude/settings.local.json

@@ -0,0 +1,43 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(npm install:*)",
+      "Bash(npm uninstall:*)",
+      "Bash(npm run type-check:*)",
+      "Bash(npm run build:*)",
+      "Bash(./dist/src/cli.js --help)",
+      "Bash(./dist/src/cli.js --version)",
+      "Bash(npm run dev:*)",
+      "Bash(node:*)",
+      "Bash(npm run lint)",
+      "Bash(npx husky init:*)",
+      "Bash(chmod:*)",
+      "Bash(npm run validate:*)",
+      "Bash(npm run format:*)",
+      "Bash(npm run test:*)",
+      "Bash(npm test)",
+      "Bash(npm audit:*)",
+      "Bash(npx depcheck:*)",
+      "Bash(npm outdated)",
+      "Bash(npm update:*)",
+      "WebSearch",
+      "Bash(find:*)",
+      "Bash(npx zod-codegen:*)",
+      "Bash(DEBUG=1 node ./dist/src/cli.js --input ./samples/openapi.json --output ./test-generated)",
+      "Bash(rm:*)",
+      "Bash(npm outdated:*)",
+      "Bash(npm view:*)",
+      "Bash(git tag:*)",
+      "Bash(npm run release:*)",
+      "Bash(git log:*)",
+      "Bash(npx commitlint:*)",
+      "Bash(git rev-list:*)",
+      "Bash(./fix-commit-messages.sh:*)",
+      "Bash(git add:*)",
+      "Bash(git commit:*)",
+      "Bash(FILTER_BRANCH_SQUELCH_WARNING=1 ./fix-commit-messages.sh)"
+    ],
+    "deny": [],
+    "ask": []
+  }
+}

package/.github/workflows/ci.yml

@@ -21,7 +21,7 @@ jobs:
 
     steps:
       - name: Checkout code
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
         with:
           fetch-depth: 0
 
@@ -64,7 +64,7 @@ jobs:
 
     steps:
       - name: Checkout code
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
 
       - name: Setup Node.js
         uses: actions/setup-node@v5
@@ -85,7 +85,7 @@ jobs:
 
     steps:
       - name: Checkout code
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
 
       - name: Setup Node.js
         uses: actions/setup-node@v5
@@ -121,7 +121,7 @@ jobs:
 
     steps:
       - name: Checkout code
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
         with:
           fetch-depth: 0
 

package/.github/workflows/release.yml

@@ -20,7 +20,7 @@ jobs:
 
     steps:
       - name: Checkout code
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
         with:
           fetch-depth: 0
           token: ${{ secrets.GITHUB_TOKEN }}

package/CHANGELOG.md

@@ -1,3 +1,20 @@
+## 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)
+- Merge pull request #37 from julienandreu/dependabot/npm_and_yarn/production-dependencies-e947a059e9 ([25bfc2e](https://github.com/julienandreu/zod-codegen/commit/25bfc2e)), closes [#37](https://github.com/julienandreu/zod-codegen/issues/37)
+- Merge pull request #38 from julienandreu/dependabot/github_actions/actions/checkout-6 ([6377f8b](https://github.com/julienandreu/zod-codegen/commit/6377f8b)), closes [#38](https://github.com/julienandreu/zod-codegen/issues/38)
+- Merge pull request #39 from julienandreu/migrate-zod-string-api-v4 ([472d53f](https://github.com/julienandreu/zod-codegen/commit/472d53f)), closes [#39](https://github.com/julienandreu/zod-codegen/issues/39)
+- feat: migrate deprecated Zod string schema API to v4 ([b4461b4](https://github.com/julienandreu/zod-codegen/commit/b4461b4))
+- ci(deps): bump actions/checkout from 5 to 6 ([45d007c](https://github.com/julienandreu/zod-codegen/commit/45d007c))
+- chore(deps-dev): bump the dev-dependencies group with 3 updates ([644ecdc](https://github.com/julienandreu/zod-codegen/commit/644ecdc))
+- chore(deps): bump zod in the production-dependencies group ([69b5694](https://github.com/julienandreu/zod-codegen/commit/69b5694))
+
 ## <small>1.2.2 (2025-11-19)</small>
 
 - Merge pull request #35 from julienandreu/fix/generate-typescript-type-aliases ([b8d9250](https://github.com/julienandreu/zod-codegen/commit/b8d9250)), closes [#35](https://github.com/julienandreu/zod-codegen/issues/35)

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) {
@@ -981,20 +1018,20 @@ export class TypeScriptCodeGeneratorService {
                 if (prop['format']) {
                     switch (prop['format']) {
                         case 'email':
-                            stringSchema = ts.factory.createCallExpression(ts.factory.createPropertyAccessExpression(stringSchema, ts.factory.createIdentifier('email')), undefined, []);
+                            stringSchema = ts.factory.createCallExpression(ts.factory.createPropertyAccessExpression(ts.factory.createIdentifier('z'), ts.factory.createIdentifier('email')), undefined, []);
                             break;
                         case 'uri':
                         case 'url':
-                            stringSchema = ts.factory.createCallExpression(ts.factory.createPropertyAccessExpression(stringSchema, ts.factory.createIdentifier('url')), undefined, []);
+                            stringSchema = ts.factory.createCallExpression(ts.factory.createPropertyAccessExpression(ts.factory.createIdentifier('z'), ts.factory.createIdentifier('url')), undefined, []);
                             break;
                         case 'uuid':
-                            stringSchema = ts.factory.createCallExpression(ts.factory.createPropertyAccessExpression(stringSchema, ts.factory.createIdentifier('uuid')), undefined, []);
+                            stringSchema = ts.factory.createCallExpression(ts.factory.createPropertyAccessExpression(ts.factory.createIdentifier('z'), ts.factory.createIdentifier('uuid')), undefined, []);
                             break;
                         case 'date-time':
-                            stringSchema = ts.factory.createCallExpression(ts.factory.createPropertyAccessExpression(stringSchema, ts.factory.createIdentifier('datetime')), undefined, []);
+                            stringSchema = ts.factory.createCallExpression(ts.factory.createPropertyAccessExpression(ts.factory.createPropertyAccessExpression(ts.factory.createIdentifier('z'), ts.factory.createIdentifier('iso')), ts.factory.createIdentifier('datetime')), undefined, [this.buildDefaultValue({ local: true })]);
                             break;
                         case 'date':
-                            stringSchema = ts.factory.createCallExpression(ts.factory.createPropertyAccessExpression(stringSchema, ts.factory.createIdentifier('date')), undefined, []);
+                            stringSchema = ts.factory.createCallExpression(ts.factory.createPropertyAccessExpression(ts.factory.createPropertyAccessExpression(ts.factory.createIdentifier('z'), ts.factory.createIdentifier('iso')), ts.factory.createIdentifier('date')), undefined, []);
                             break;
                         case 'time':
                             stringSchema = ts.factory.createCallExpression(ts.factory.createPropertyAccessExpression(stringSchema, ts.factory.createIdentifier('time')), undefined, []);

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"}