klasik 1.0.26 → 1.0.28

package/.claude/settings.local.json

@@ -17,7 +17,9 @@
       "Bash(node test-programmatic-api.js:*)",
       "WebFetch(domain:www.schemastore.org)",
       "WebFetch(domain:json.schemastore.org)",
-      "Bash(node dist/cli.js:*)"
+      "Bash(node dist/cli.js:*)",
+      "Bash(curl:*)",
+      "Bash(node --input-type=module -e:*)"
     ]
   }
 }

package/README.md

@@ -78,9 +78,9 @@ npx klasik download \
 ### Programmatic Usage
 
 ```typescript
-import { K8sClientGenerator } from 'klasik';
+import { OpenAPIClientGenerator } from 'klasik';
 
-const generator = new K8sClientGenerator();
+const generator = new OpenAPIClientGenerator();
 
 await generator.generate({
   specUrl: 'https://raw.githubusercontent.com/kubernetes/kubernetes/master/api/openapi-spec/swagger.json',
@@ -502,6 +502,9 @@ Generate TypeScript models from Kubernetes CustomResourceDefinition (CRD) YAML f
 - `-H, --header <header...>` - Custom headers for HTTP requests (format: "Key: Value")
 - `-t, --template <dir>` - Custom template directory
 - `-k, --keep-spec` - Keep the generated OpenAPI spec files (for debugging)
+- `--crd-kind-snake-case` - Convert CRD kind names to snake_case for folder names (default: false)
+  - When enabled: `AppProject` → `app_project`
+  - When disabled (default): `AppProject` → `AppProject`
 - `--timeout <ms>` - Request timeout in milliseconds (default: 30000)
 
 **Examples:**
@@ -550,6 +553,18 @@ klasik generate-crd \
   --output ./generated \
   --include-status \
   --nestjs-swagger
+
+# Generate with snake_case folder names
+klasik generate-crd \
+  --url https://raw.githubusercontent.com/argoproj/argo-cd/master/manifests/crds/appproject-crd.yaml \
+  --output ./generated \
+  --crd-kind-snake-case
+# Output structure:
+# generated/
+# └── app_project/  # Instead of AppProject/
+#     └── v1alpha1/
+#         └── models/
+#             └── app-project.ts
 ```
 
 **Output Structure:**
@@ -566,7 +581,7 @@ output/
 └── index.ts
 ```
 
-For multiple CRDs:
+For multiple CRDs (default):
 ```
 output/
 ├── AppProject/
@@ -578,6 +593,18 @@ output/
 └── index.ts
 ```
 
+With `--crd-kind-snake-case`:
+```
+output/
+├── app_project/
+│   ├── v1alpha1/
+│   └── index.ts
+├── application/
+│   ├── v1alpha1/
+│   └── index.ts
+└── index.ts
+```
+
 ### `generate-jsonschema`
 
 Generate TypeScript models from JSON Schema files.
@@ -650,12 +677,12 @@ output/
 
 ## Programmatic API
 
-### K8sClientGenerator
+### OpenAPIClientGenerator
 
 ```typescript
-import { K8sClientGenerator } from 'klasik';
+import { OpenAPIClientGenerator } from 'klasik';
 
-const generator = new K8sClientGenerator();
+const generator = new OpenAPIClientGenerator();
 
 await generator.generate({
   specUrl: 'https://api.example.com/openapi.json',
@@ -946,9 +973,9 @@ npx klasik generate \
 ### Programmatic Example
 
 ```typescript
-import { K8sClientGenerator } from 'klasik';
+import { OpenAPIClientGenerator } from 'klasik';
 
-await new K8sClientGenerator().generate({
+await new OpenAPIClientGenerator().generate({
   specUrl: 'https://api.example.com/openapi.json',
   outputDir: './client',
   headers: { 'Authorization': 'Bearer token' },

package/USAGE_EXAMPLES.md

@@ -32,10 +32,10 @@ npx klasik download \
 ### Programmatic Examples
 
 ```typescript
-import { K8sClientGenerator } from 'klasik';
+import { OpenAPIClientGenerator } from 'klasik';
 
 // Works with both JSON and YAML
-await new K8sClientGenerator().generate({
+await new OpenAPIClientGenerator().generate({
   specUrl: 'https://api.example.com/openapi.yaml',
   outputDir: './client'
 });
@@ -89,9 +89,9 @@ npx klasik generate \
 ### Programmatic Example - Authorization Token
 
 ```typescript
-import { K8sClientGenerator } from 'klasik';
+import { OpenAPIClientGenerator } from 'klasik';
 
-const generator = new K8sClientGenerator();
+const generator = new OpenAPIClientGenerator();
 
 await generator.generate({
   specUrl: 'https://api.example.com/openapi.json',
@@ -126,9 +126,9 @@ npx klasik download \
 ### Programmatic Example - With Reference Resolution
 
 ```typescript
-import { K8sClientGenerator } from 'klasik';
+import { OpenAPIClientGenerator } from 'klasik';
 
-const generator = new K8sClientGenerator();
+const generator = new OpenAPIClientGenerator();
 
 await generator.generate({
   specUrl: 'https://api.example.com/openapi.json',

package/dist/cli.js

@@ -35,7 +35,7 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 const commander_1 = require("commander");
-const k8s_client_generator_1 = require("./k8s-client-generator");
+const openapi_client_generator_1 = require("./openapi-client-generator");
 const path = __importStar(require("path"));
 const program = new commander_1.Command();
 program
@@ -76,7 +76,7 @@ program
         }
         // Resolve output directory to absolute path
         const outputDir = path.resolve(options.output);
-        const generator = new k8s_client_generator_1.K8sClientGenerator();
+        const generator = new openapi_client_generator_1.OpenAPIClientGenerator();
         await generator.generate({
             specUrl: options.url,
             outputDir,
@@ -147,6 +147,7 @@ program
     .option('--timeout <ms>', 'Request timeout in milliseconds', '30000')
     .option('-t, --template <dir>', 'Custom template directory')
     .option('-k, --keep-spec', 'Keep the generated OpenAPI spec files', false)
+    .option('--crd-kind-snake-case', 'Convert CRD kind names to snake_case for folder names', false)
     .action(async (options) => {
     try {
         // Parse headers if provided
@@ -177,6 +178,7 @@ program
             classValidator: options.classValidator,
             templateDir: options.template,
             keepSpec: options.keepSpec,
+            crdKindSnakeCase: options.crdKindSnakeCase,
         });
         process.exit(0);
     }

package/dist/crd/crd-generator.d.ts

@@ -54,6 +54,11 @@ export interface CRDGeneratorOptions {
      * @default false
      */
     keepSpec?: boolean;
+    /**
+     * Convert CRD kind names to snake_case for folder names
+     * @default false
+     */
+    crdKindSnakeCase?: boolean;
 }
 /**
  * Main orchestrator for generating TypeScript models from Kubernetes CRDs
@@ -61,7 +66,7 @@ export interface CRDGeneratorOptions {
 export declare class CRDGenerator {
     private parser;
     private converter;
-    private k8sGenerator;
+    private openapiGenerator;
     constructor();
     /**
      * Main generation workflow
@@ -76,22 +81,38 @@ export declare class CRDGenerator {
      * @returns Array of version directory names
      */
     private processCRD;
+    /**
+     * Format CRD kind name for use as folder name
+     * @param kind The CRD kind name (e.g., "AppProject")
+     * @param useSnakeCase Whether to convert to snake_case
+     * @returns Formatted name (e.g., "app_project" if useSnakeCase, otherwise "AppProject")
+     */
+    private formatKindName;
     /**
      * Generate index file for a CRD (when multiple CRDs in one file)
      * @param crdDir CRD directory
      * @param versions Array of version names
+     * @param skipJsExtensions Whether to skip .js extensions
      */
     private generateCRDIndex;
+    /**
+     * Generate index file for a version directory (re-exports from models)
+     * @param versionDir Version directory path
+     * @param skipJsExtensions Whether to skip .js extensions in exports
+     */
+    private generateVersionIndexFile;
     /**
      * Generate main index file (when multiple CRDs in one file)
      * @param outputDir Output directory
      * @param crdNames Array of CRD kind names
+     * @param skipJsExtensions Whether to skip .js extensions
      */
     private generateMainIndex;
     /**
      * Generate version index file (for single CRD)
      * @param outputDir Output directory
      * @param versions Array of version names
+     * @param skipJsExtensions Whether to skip .js extensions
      */
     private generateVersionIndex;
     /**

package/dist/crd/crd-generator.js

@@ -39,7 +39,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.CRDGenerator = void 0;
 const crd_parser_1 = require("./crd-parser");
 const crd_to_openapi_1 = require("./crd-to-openapi");
-const k8s_client_generator_1 = require("../k8s-client-generator");
+const openapi_client_generator_1 = require("../openapi-client-generator");
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const axios_1 = __importDefault(require("axios"));
@@ -50,14 +50,14 @@ class CRDGenerator {
     constructor() {
         this.parser = new crd_parser_1.CRDParser();
         this.converter = new crd_to_openapi_1.CRDToOpenAPIConverter();
-        this.k8sGenerator = new k8s_client_generator_1.K8sClientGenerator();
+        this.openapiGenerator = new openapi_client_generator_1.OpenAPIClientGenerator();
     }
     /**
      * Main generation workflow
      * @param options Generation options
      */
     async generate(options) {
-        const { urls: urlsInput, outputDir, includeStatus = false, headers, timeout, fixEsmImports = false, nestJsSwagger = false, classValidator = false, skipJsExtensions = false, templateDir, keepSpec = false, } = options;
+        const { urls: urlsInput, outputDir, includeStatus = false, headers, timeout, fixEsmImports = false, nestJsSwagger = false, classValidator = false, skipJsExtensions = false, templateDir, keepSpec = false, crdKindSnakeCase = false, } = options;
         // Normalize to array
         const urls = Array.isArray(urlsInput) ? urlsInput : [urlsInput];
         try {
@@ -115,8 +115,9 @@ class CRDGenerator {
             for (const crd of allCRDs) {
                 console.log(`\nProcessing CRD: ${crd.spec.names.kind}`);
                 // Determine output directory structure
+                const formattedKind = this.formatKindName(crd.spec.names.kind, crdKindSnakeCase);
                 const crdOutputDir = allCRDs.length > 1
-                    ? path.join(outputDir, crd.spec.names.kind)
+                    ? path.join(outputDir, formattedKind)
                     : outputDir;
                 const versionDirs = await this.processCRD(crd, crdOutputDir, {
                     includeStatus,
@@ -131,18 +132,19 @@ class CRDGenerator {
                 });
                 // Generate index file for this CRD if multiple CRDs
                 if (allCRDs.length > 1) {
-                    this.generateCRDIndex(crdOutputDir, versionDirs);
+                    this.generateCRDIndex(crdOutputDir, versionDirs, skipJsExtensions);
                 }
             }
             // Step 4: Generate main index file
             console.log('\nGenerating index files...');
             if (allCRDs.length > 1) {
-                this.generateMainIndex(outputDir, allCRDs.map(c => c.spec.names.kind));
+                const formattedKindNames = allCRDs.map(c => this.formatKindName(c.spec.names.kind, crdKindSnakeCase));
+                this.generateMainIndex(outputDir, formattedKindNames, skipJsExtensions);
             }
             else {
                 // For single CRD, generate version index
                 const versionNames = allCRDs[0].spec.versions.map(v => v.name);
-                this.generateVersionIndex(outputDir, versionNames);
+                this.generateVersionIndex(outputDir, versionNames, skipJsExtensions);
             }
             console.log('\n✅ CRD client generation completed successfully!');
             console.log(`📁 Generated files location: ${outputDir}`);
@@ -183,8 +185,8 @@ class CRDGenerator {
             const specPath = path.resolve(versionDir, '.openapi-spec.json');
             fs.writeFileSync(specPath, JSON.stringify(openApiSpec, null, 2), 'utf-8');
             try {
-                // Generate TypeScript models using existing K8sClientGenerator
-                await this.k8sGenerator.generate({
+                // Generate TypeScript models using OpenAPIClientGenerator
+                await this.openapiGenerator.generate({
                     specUrl: specPath,
                     outputDir: versionDir,
                     mode: 'models-only',
@@ -195,6 +197,8 @@ class CRDGenerator {
                     templateDir: options.templateDir,
                     keepSpec: false, // Don't keep the OpenAPI spec in the final output
                 });
+                // Generate version-level index file
+                this.generateVersionIndexFile(versionDir, options.skipJsExtensions);
                 // Clean up temp spec file if not keeping it
                 if (!options.keepSpec) {
                     if (fs.existsSync(specPath)) {
@@ -209,27 +213,79 @@ class CRDGenerator {
         }
         return versionDirs;
     }
+    /**
+     * Format CRD kind name for use as folder name
+     * @param kind The CRD kind name (e.g., "AppProject")
+     * @param useSnakeCase Whether to convert to snake_case
+     * @returns Formatted name (e.g., "app_project" if useSnakeCase, otherwise "AppProject")
+     */
+    formatKindName(kind, useSnakeCase) {
+        if (!useSnakeCase) {
+            return kind;
+        }
+        // Convert PascalCase to snake_case
+        // AppProject -> app_project
+        // HTTPServer -> http_server
+        return kind
+            .replace(/([a-z0-9])([A-Z])/g, '$1_$2') // Add underscore between lowercase and uppercase
+            .replace(/([A-Z])([A-Z][a-z])/g, '$1_$2') // Handle consecutive capitals (HTTPServer -> HTTP_Server)
+            .toLowerCase();
+    }
     /**
      * Generate index file for a CRD (when multiple CRDs in one file)
      * @param crdDir CRD directory
      * @param versions Array of version names
+     * @param skipJsExtensions Whether to skip .js extensions
      */
-    generateCRDIndex(crdDir, versions) {
+    generateCRDIndex(crdDir, versions, skipJsExtensions = false) {
+        const extension = skipJsExtensions ? '' : '.js';
         const exports = versions
-            .map(version => `export * as ${version.replace(/\./g, '_')} from './${version}';`)
+            .map(version => `export * as ${version.replace(/\./g, '_')} from './${version}/index${extension}';`)
             .join('\n');
         const indexContent = `// Auto-generated index for CRD\n${exports}\n`;
         const indexPath = path.join(crdDir, 'index.ts');
         fs.writeFileSync(indexPath, indexContent, 'utf-8');
     }
+    /**
+     * Generate index file for a version directory (re-exports from models)
+     * @param versionDir Version directory path
+     * @param skipJsExtensions Whether to skip .js extensions in exports
+     */
+    generateVersionIndexFile(versionDir, skipJsExtensions = false) {
+        const extension = skipJsExtensions ? '' : '.js';
+        // First, create models/index.ts if it doesn't exist
+        // OpenAPI Generator in models-only mode doesn't create this file
+        const modelsDir = path.join(versionDir, 'models');
+        const modelsIndexPath = path.join(modelsDir, 'index.ts');
+        if (!fs.existsSync(modelsIndexPath)) {
+            // Get all .ts files in models directory (excluding index.ts itself)
+            const modelFiles = fs.readdirSync(modelsDir)
+                .filter(file => file.endsWith('.ts') && file !== 'index.ts')
+                .map(file => file.replace('.ts', ''));
+            // Generate exports for each model file
+            const exports = modelFiles
+                .map(file => `export * from './${file}${extension}';`)
+                .join('\n');
+            const modelsIndexContent = `// Auto-generated models index\n${exports}\n`;
+            fs.writeFileSync(modelsIndexPath, modelsIndexContent, 'utf-8');
+            console.log(`  Generated models index: ${modelsIndexPath}`);
+        }
+        // Now create version index that exports from models
+        const indexContent = `// Auto-generated version index\nexport * from './models/index${extension}';\n`;
+        const indexPath = path.join(versionDir, 'index.ts');
+        fs.writeFileSync(indexPath, indexContent, 'utf-8');
+        console.log(`  Generated version index: ${indexPath}`);
+    }
     /**
      * Generate main index file (when multiple CRDs in one file)
      * @param outputDir Output directory
      * @param crdNames Array of CRD kind names
+     * @param skipJsExtensions Whether to skip .js extensions
      */
-    generateMainIndex(outputDir, crdNames) {
+    generateMainIndex(outputDir, crdNames, skipJsExtensions = false) {
+        const extension = skipJsExtensions ? '' : '.js';
         const exports = crdNames
-            .map(name => `export * as ${name} from './${name}';`)
+            .map(name => `export * as ${name} from './${name}/index${extension}';`)
             .join('\n');
         const indexContent = `// Auto-generated main index\n${exports}\n`;
         const indexPath = path.join(outputDir, 'index.ts');
@@ -239,10 +295,12 @@ class CRDGenerator {
      * Generate version index file (for single CRD)
      * @param outputDir Output directory
      * @param versions Array of version names
+     * @param skipJsExtensions Whether to skip .js extensions
      */
-    generateVersionIndex(outputDir, versions) {
+    generateVersionIndex(outputDir, versions, skipJsExtensions = false) {
+        const extension = skipJsExtensions ? '' : '.js';
         const exports = versions
-            .map(version => `export * as ${version.replace(/\./g, '_')} from './${version}';`)
+            .map(version => `export * as ${version.replace(/\./g, '_')} from './${version}/index${extension}';`)
             .join('\n');
         const indexContent = `// Auto-generated version index\n${exports}\n`;
         const indexPath = path.join(outputDir, 'index.ts');

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { K8sClientGenerator, K8sClientGeneratorOptions, GenerationMode } from './k8s-client-generator';
+export { OpenAPIClientGenerator, OpenAPIClientGeneratorOptions, GenerationMode } from './openapi-client-generator';
 export { SpecDownloader, DownloadOptions } from './spec-downloader';
 export { EsmFixer } from './esm-fixer';
 export { CRDGenerator, CRDGeneratorOptions } from './crd/crd-generator';

package/dist/index.js

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.JSONSchemaToOpenAPIConverter = exports.JSONSchemaParser = exports.JSONSchemaGenerator = exports.CRDToOpenAPIConverter = exports.CRDParser = exports.CRDGenerator = exports.EsmFixer = exports.SpecDownloader = exports.K8sClientGenerator = void 0;
-var k8s_client_generator_1 = require("./k8s-client-generator");
-Object.defineProperty(exports, "K8sClientGenerator", { enumerable: true, get: function () { return k8s_client_generator_1.K8sClientGenerator; } });
+exports.JSONSchemaToOpenAPIConverter = exports.JSONSchemaParser = exports.JSONSchemaGenerator = exports.CRDToOpenAPIConverter = exports.CRDParser = exports.CRDGenerator = exports.EsmFixer = exports.SpecDownloader = exports.OpenAPIClientGenerator = void 0;
+var openapi_client_generator_1 = require("./openapi-client-generator");
+Object.defineProperty(exports, "OpenAPIClientGenerator", { enumerable: true, get: function () { return openapi_client_generator_1.OpenAPIClientGenerator; } });
 var spec_downloader_1 = require("./spec-downloader");
 Object.defineProperty(exports, "SpecDownloader", { enumerable: true, get: function () { return spec_downloader_1.SpecDownloader; } });
 var esm_fixer_1 = require("./esm-fixer");

package/dist/jsonschema/jsonschema-generator.d.ts

@@ -56,7 +56,7 @@ export interface JSONSchemaGeneratorOptions {
 export declare class JSONSchemaGenerator {
     private parser;
     private converter;
-    private k8sGenerator;
+    private openapiGenerator;
     constructor();
     /**
      * Main generation workflow

package/dist/jsonschema/jsonschema-generator.js

@@ -39,7 +39,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.JSONSchemaGenerator = void 0;
 const jsonschema_parser_1 = require("./jsonschema-parser");
 const jsonschema_to_openapi_1 = require("./jsonschema-to-openapi");
-const k8s_client_generator_1 = require("../k8s-client-generator");
+const openapi_client_generator_1 = require("../openapi-client-generator");
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const axios_1 = __importDefault(require("axios"));
@@ -50,7 +50,7 @@ class JSONSchemaGenerator {
     constructor() {
         this.parser = new jsonschema_parser_1.JSONSchemaParser();
         this.converter = new jsonschema_to_openapi_1.JSONSchemaToOpenAPIConverter();
-        this.k8sGenerator = new k8s_client_generator_1.K8sClientGenerator();
+        this.openapiGenerator = new openapi_client_generator_1.OpenAPIClientGenerator();
     }
     /**
      * Main generation workflow
@@ -122,9 +122,9 @@ class JSONSchemaGenerator {
                 const specPath = path.resolve(outputDir, '.openapi-spec.json');
                 fs.writeFileSync(specPath, JSON.stringify(openApiSpec, null, 2), 'utf-8');
                 try {
-                    // Generate TypeScript models using K8sClientGenerator
+                    // Generate TypeScript models using OpenAPIClientGenerator
                     console.log('  Generating TypeScript models...');
-                    await this.k8sGenerator.generate({
+                    await this.openapiGenerator.generate({
                         specUrl: specPath,
                         outputDir,
                         mode: 'models-only',
@@ -133,7 +133,7 @@ class JSONSchemaGenerator {
                         fixEsmImports,
                         skipJsExtensions,
                         templateDir,
-                        keepSpec: false, // Don't keep the OpenAPI spec in K8sClientGenerator
+                        keepSpec: false, // Don't keep the OpenAPI spec in OpenAPIClientGenerator
                     });
                     // Track definition names for index generation
                     allDefinitions.push(...Object.keys(schema.definitions));

package/dist/nestjs-type-fixer.d.ts

@@ -1,9 +1,15 @@
 /**
- * Fixes primitive type casing in NestJS @ApiProperty decorators
+ * Fixes multiple issues in NestJS @ApiProperty decorators
  *
  * When openapi-class-transformer generates files with @ApiProperty decorators,
- * it uses lowercase string literals for primitive types (type: 'string'), but
- * NestJS Swagger expects capitalized constructor references (type: String).
+ * several issues can occur:
+ *
+ * 1. Primitive type casing: Uses lowercase string literals (type: 'string')
+ *    instead of constructor references (type: String)
+ * 2. Unescaped backticks: Descriptions wrapped in backticks don't escape
+ *    backticks within the text
+ * 3. Undefined descriptions: Some decorators have description: undefined
+ *    instead of empty strings
  *
  * This utility transforms:
  * - type: 'string' -> type: String
@@ -12,9 +18,11 @@
  * - type: () => [string] -> type: [String]
  * - type: () => [number] -> type: [Number]
  * - type: () => [boolean] -> type: [Boolean]
+ * - description: `text `code` here` -> description: `text \`code\` here`
+ * - description: undefined -> description: ''
  *
  * IMPORTANT: Does NOT modify attributeTypeMap at the bottom of files - those
- * metadata strings must remain lowercase.
+ * metadata strings must remain unchanged.
  */
 export declare class NestJsTypeFixer {
     /**
@@ -32,9 +40,17 @@ export declare class NestJsTypeFixer {
      */
     private fixPrimitiveTypes;
     /**
-     * Apply type transformations to content
+     * Apply all transformations to content
      */
     private applyTransformations;
+    /**
+     * Escape backticks in description template literals
+     */
+    private escapeBackticksInDescriptions;
+    /**
+     * Replace undefined descriptions with empty strings
+     */
+    private fixUndefinedDescriptions;
     /**
      * Get all TypeScript files in a directory recursively
      */

package/dist/nestjs-type-fixer.js

@@ -37,11 +37,17 @@ exports.NestJsTypeFixer = void 0;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 /**
- * Fixes primitive type casing in NestJS @ApiProperty decorators
+ * Fixes multiple issues in NestJS @ApiProperty decorators
  *
  * When openapi-class-transformer generates files with @ApiProperty decorators,
- * it uses lowercase string literals for primitive types (type: 'string'), but
- * NestJS Swagger expects capitalized constructor references (type: String).
+ * several issues can occur:
+ *
+ * 1. Primitive type casing: Uses lowercase string literals (type: 'string')
+ *    instead of constructor references (type: String)
+ * 2. Unescaped backticks: Descriptions wrapped in backticks don't escape
+ *    backticks within the text
+ * 3. Undefined descriptions: Some decorators have description: undefined
+ *    instead of empty strings
  *
  * This utility transforms:
  * - type: 'string' -> type: String
@@ -50,16 +56,18 @@ const path = __importStar(require("path"));
  * - type: () => [string] -> type: [String]
  * - type: () => [number] -> type: [Number]
  * - type: () => [boolean] -> type: [Boolean]
+ * - description: `text `code` here` -> description: `text \`code\` here`
+ * - description: undefined -> description: ''
  *
  * IMPORTANT: Does NOT modify attributeTypeMap at the bottom of files - those
- * metadata strings must remain lowercase.
+ * metadata strings must remain unchanged.
  */
 class NestJsTypeFixer {
     /**
      * Fix all TypeScript files in a directory recursively
      */
     async fixDirectory(directory) {
-        console.log('Fixing primitive type casing in @ApiProperty decorators...');
+        console.log('Fixing @ApiProperty decorator issues...');
         const files = this.getAllTsFiles(directory);
         let fixedCount = 0;
         for (const file of files) {
@@ -68,7 +76,7 @@ class NestJsTypeFixer {
                 fixedCount++;
             }
         }
-        console.log(`✅ Fixed primitive types in ${fixedCount} file(s)`);
+        console.log(`✅ Fixed @ApiProperty issues in ${fixedCount} file(s)`);
     }
     /**
      * Fix primitive types in a single file
@@ -116,7 +124,7 @@ class NestJsTypeFixer {
         return fixedSafeZone + protectedZone;
     }
     /**
-     * Apply type transformations to content
+     * Apply all transformations to content
      */
     applyTransformations(content) {
         // Fix simple primitive types: type: 'string' -> type: String
@@ -129,8 +137,34 @@ class NestJsTypeFixer {
             const capitalized = primitive.charAt(0).toUpperCase() + primitive.slice(1);
             return `type: [${capitalized}]`;
         });
+        // Fix unescaped backticks in description strings
+        content = this.escapeBackticksInDescriptions(content);
+        // Fix undefined descriptions
+        content = this.fixUndefinedDescriptions(content);
         return content;
     }
+    /**
+     * Escape backticks in description template literals
+     */
+    escapeBackticksInDescriptions(content) {
+        // Match "description: `" followed by anything until "`,"
+        // Uses non-greedy match (.*?) with dotall flag (s) to handle multiline
+        // This works even if there are unescaped backticks inside
+        return content.replace(/(description:\s*`)(.*?)(`,)/gs, (fullMatch, prefix, description, suffix) => {
+            // Escape any unescaped backticks in the description
+            // Uses negative lookbehind to avoid double-escaping
+            const escaped = description.replace(/(?<!\\)`/g, '\\`');
+            return prefix + escaped + suffix;
+        });
+    }
+    /**
+     * Replace undefined descriptions with empty strings
+     */
+    fixUndefinedDescriptions(content) {
+        // Replace description: undefined with description: ''
+        // Only affects @ApiProperty decorators (split-point protects attributeTypeMap)
+        return content.replace(/description:\s*undefined/g, "description: ''");
+    }
     /**
      * Get all TypeScript files in a directory recursively
      */

package/dist/{k8s-client-generator.d.ts → openapi-client-generator.d.ts}

@@ -1,5 +1,5 @@
 export type GenerationMode = 'full' | 'models-only';
-export interface K8sClientGeneratorOptions {
+export interface OpenAPIClientGeneratorOptions {
     /**
      * Remote URL to download the OpenAPI spec from
      */
@@ -65,13 +65,13 @@ export interface K8sClientGeneratorOptions {
      */
     timeout?: number;
 }
-export declare class K8sClientGenerator {
+export declare class OpenAPIClientGenerator {
     private downloader;
     constructor();
     /**
      * Generate TypeScript client from a remote OpenAPI spec URL
      */
-    generate(options: K8sClientGeneratorOptions): Promise<void>;
+    generate(options: OpenAPIClientGeneratorOptions): Promise<void>;
     /**
      * Prepare the output directory
      */