@devlearning/swagger-generator 1.1.21 → 1.1.22

package/src/utils/logger.ts

@@ -1,73 +1,73 @@
-/**
- * Centralized logging utility for the Swagger Generator
- * Provides consistent logging with levels and formatting
- */
-
-export enum LogLevel {
-  DEBUG = 0,
-  INFO = 1,
-  WARN = 2,
-  ERROR = 3,
-  SILENT = 4,
-}
-
-export class Logger {
-  private static instance: Logger;
-  private logLevel: LogLevel = LogLevel.INFO;
-
-  private constructor() {}
-
-  static getInstance(): Logger {
-    if (!Logger.instance) {
-      Logger.instance = new Logger();
-    }
-    return Logger.instance;
-  }
-
-  setLogLevel(level: LogLevel) {
-    this.logLevel = level;
-  }
-
-  debug(message: string, ...args: any[]) {
-    if (this.logLevel <= LogLevel.DEBUG) {
-      console.debug(`[DEBUG] ${message}`, ...args);
-    }
-  }
-
-  info(message: string, ...args: any[]) {
-    if (this.logLevel <= LogLevel.INFO) {
-      console.info(`[INFO] ${message}`, ...args);
-    }
-  }
-
-  warn(message: string, ...args: any[]) {
-    if (this.logLevel <= LogLevel.WARN) {
-      console.warn(`[WARN] ${message}`, ...args);
-    }
-  }
-
-  error(message: string, error?: any) {
-    if (this.logLevel <= LogLevel.ERROR) {
-      if (error) {
-        console.error(`[ERROR] ${message}`, error);
-      } else {
-        console.error(`[ERROR] ${message}`);
-      }
-    }
-  }
-
-  success(message: string) {
-    if (this.logLevel <= LogLevel.INFO) {
-      console.info(`✓ ${message}`);
-    }
-  }
-
-  progress(message: string) {
-    if (this.logLevel <= LogLevel.INFO) {
-      console.info(`→ ${message}`);
-    }
-  }
-}
-
-// Export singleton instance
-export const logger = Logger.getInstance();
+/**
+ * Centralized logging utility for the Swagger Generator
+ * Provides consistent logging with levels and formatting
+ */
+
+export enum LogLevel {
+  DEBUG = 0,
+  INFO = 1,
+  WARN = 2,
+  ERROR = 3,
+  SILENT = 4,
+}
+
+export class Logger {
+  private static instance: Logger;
+  private logLevel: LogLevel = LogLevel.INFO;
+
+  private constructor() {}
+
+  static getInstance(): Logger {
+    if (!Logger.instance) {
+      Logger.instance = new Logger();
+    }
+    return Logger.instance;
+  }
+
+  setLogLevel(level: LogLevel) {
+    this.logLevel = level;
+  }
+
+  debug(message: string, ...args: any[]) {
+    if (this.logLevel <= LogLevel.DEBUG) {
+      console.debug(`[DEBUG] ${message}`, ...args);
+    }
+  }
+
+  info(message: string, ...args: any[]) {
+    if (this.logLevel <= LogLevel.INFO) {
+      console.info(`[INFO] ${message}`, ...args);
+    }
+  }
+
+  warn(message: string, ...args: any[]) {
+    if (this.logLevel <= LogLevel.WARN) {
+      console.warn(`[WARN] ${message}`, ...args);
+    }
+  }
+
+  error(message: string, error?: any) {
+    if (this.logLevel <= LogLevel.ERROR) {
+      if (error) {
+        console.error(`[ERROR] ${message}`, error);
+      } else {
+        console.error(`[ERROR] ${message}`);
+      }
+    }
+  }
+
+  success(message: string) {
+    if (this.logLevel <= LogLevel.INFO) {
+      console.info(`✓ ${message}`);
+    }
+  }
+
+  progress(message: string) {
+    if (this.logLevel <= LogLevel.INFO) {
+      console.info(`→ ${message}`);
+    }
+  }
+}
+
+// Export singleton instance
+export const logger = Logger.getInstance();

package/src/utils/swagger-validator.ts

@@ -1,89 +1,89 @@
-import { Swagger } from '../models/swagger/swagger.js';
-import { logger } from './logger.js';
-
-/**
- * Validates Swagger/OpenAPI specification
- * Ensures the document has required fields before processing
- */
-export class SwaggerValidator {
-  
-  /**
-   * Validates a Swagger document structure
-   * @param swagger - The Swagger document to validate
-   * @throws Error if validation fails
-   */
-  static validate(swagger: any): void {
-    const errors: string[] = [];
-
-    // Check required top-level fields (support both openapi and openApi)
-    const version = swagger.openapi || swagger.swagger || swagger.openApi;
-    if (!version) {
-      errors.push('Missing openapi/swagger version field');
-    }
-
-    if (!swagger.paths || Object.keys(swagger.paths).length === 0) {
-      errors.push('Missing or empty paths object');
-    }
-
-    if (!swagger.info) {
-      errors.push('Missing info object');
-    } else {
-      if (!swagger.info.title) {
-        errors.push('Missing info.title');
-      }
-      if (!swagger.info.version) {
-        errors.push('Missing info.version');
-      }
-    }
-
-    // Check components
-    if (!swagger.components && !swagger.definitions) {
-      logger.warn('No components/definitions found - model generation may be limited');
-    }
-
-    // Validate paths structure
-    if (swagger.paths) {
-      for (const [path, methods] of Object.entries(swagger.paths)) {
-        if (!methods || typeof methods !== 'object') {
-          errors.push(`Invalid path definition for: ${path}`);
-          continue;
-        }
-
-        const validMethods = ['get', 'post', 'put', 'delete', 'patch', 'options', 'head'];
-        const pathMethods = Object.keys(methods);
-        
-        if (pathMethods.length === 0) {
-          errors.push(`No HTTP methods defined for path: ${path}`);
-        }
-
-        for (const method of pathMethods) {
-          if (!validMethods.includes(method.toLowerCase())) {
-            logger.warn(`Unexpected HTTP method '${method}' in path: ${path}`);
-          }
-        }
-      }
-    }
-
-    // If there are errors, throw
-    if (errors.length > 0) {
-      const errorMessage = `Swagger validation failed:\n${errors.map(e => `  - ${e}`).join('\n')}`;
-      logger.error(errorMessage);
-      throw new Error(errorMessage);
-    }
-
-    logger.success('Swagger document validation passed');
-  }
-
-  /**
-   * Checks if the Swagger document is likely valid without throwing
-   * @param obj - Object to check
-   * @returns true if it looks like a valid Swagger document
-   */
-  static isValidSwaggerDocument(obj: any): obj is Swagger {
-    return obj &&
-           typeof obj === 'object' &&
-           (obj.openApi || obj.openapi || obj.swagger) &&
-           obj.paths &&
-           typeof obj.paths === 'object';
-  }
-}
+import { Swagger } from '../models/swagger/swagger.js';
+import { logger } from './logger.js';
+
+/**
+ * Validates Swagger/OpenAPI specification
+ * Ensures the document has required fields before processing
+ */
+export class SwaggerValidator {
+  
+  /**
+   * Validates a Swagger document structure
+   * @param swagger - The Swagger document to validate
+   * @throws Error if validation fails
+   */
+  static validate(swagger: any): void {
+    const errors: string[] = [];
+
+    // Check required top-level fields (support both openapi and openApi)
+    const version = swagger.openapi || swagger.swagger || swagger.openApi;
+    if (!version) {
+      errors.push('Missing openapi/swagger version field');
+    }
+
+    if (!swagger.paths || Object.keys(swagger.paths).length === 0) {
+      errors.push('Missing or empty paths object');
+    }
+
+    if (!swagger.info) {
+      errors.push('Missing info object');
+    } else {
+      if (!swagger.info.title) {
+        errors.push('Missing info.title');
+      }
+      if (!swagger.info.version) {
+        errors.push('Missing info.version');
+      }
+    }
+
+    // Check components
+    if (!swagger.components && !swagger.definitions) {
+      logger.warn('No components/definitions found - model generation may be limited');
+    }
+
+    // Validate paths structure
+    if (swagger.paths) {
+      for (const [path, methods] of Object.entries(swagger.paths)) {
+        if (!methods || typeof methods !== 'object') {
+          errors.push(`Invalid path definition for: ${path}`);
+          continue;
+        }
+
+        const validMethods = ['get', 'post', 'put', 'delete', 'patch', 'options', 'head'];
+        const pathMethods = Object.keys(methods);
+        
+        if (pathMethods.length === 0) {
+          errors.push(`No HTTP methods defined for path: ${path}`);
+        }
+
+        for (const method of pathMethods) {
+          if (!validMethods.includes(method.toLowerCase())) {
+            logger.warn(`Unexpected HTTP method '${method}' in path: ${path}`);
+          }
+        }
+      }
+    }
+
+    // If there are errors, throw
+    if (errors.length > 0) {
+      const errorMessage = `Swagger validation failed:\n${errors.map(e => `  - ${e}`).join('\n')}`;
+      logger.error(errorMessage);
+      throw new Error(errorMessage);
+    }
+
+    logger.success('Swagger document validation passed');
+  }
+
+  /**
+   * Checks if the Swagger document is likely valid without throwing
+   * @param obj - Object to check
+   * @returns true if it looks like a valid Swagger document
+   */
+  static isValidSwaggerDocument(obj: any): obj is Swagger {
+    return obj &&
+           typeof obj === 'object' &&
+           (obj.openApi || obj.openapi || obj.swagger) &&
+           obj.paths &&
+           typeof obj.paths === 'object';
+  }
+}

package/tsconfig.json

@@ -1,34 +1,34 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "ESNext",
-    "lib": ["ES2022"],
-    "baseUrl": "./src",
-    "moduleResolution": "node",
-    "paths": {
-      "@src/*": [
-        "*"
-      ]
-    },
-    "outDir": "./dist",
-    "esModuleInterop": true,
-    "allowSyntheticDefaultImports": true,
-    "forceConsistentCasingInFileNames": true,
-    "strict": true,
-    "skipLibCheck": true,
-    "declaration": true,
-    "skipDefaultLibCheck": true
-  },
-  "include": [
-    "src/**/*.ts"
-  ],
-  "exclude": [
-    "node_modules",
-    "dist"
-  ],
-  "ts-node": {
-    "require": [
-      "tsconfig-paths/register"
-    ]
-  }
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "lib": ["ES2022"],
+    "baseUrl": "./src",
+    "moduleResolution": "node",
+    "paths": {
+      "@src/*": [
+        "*"
+      ]
+    },
+    "outDir": "./dist",
+    "esModuleInterop": true,
+    "allowSyntheticDefaultImports": true,
+    "forceConsistentCasingInFileNames": true,
+    "strict": true,
+    "skipLibCheck": true,
+    "declaration": true,
+    "skipDefaultLibCheck": true
+  },
+  "include": [
+    "src/**/*.ts"
+  ],
+  "exclude": [
+    "node_modules",
+    "dist"
+  ],
+  "ts-node": {
+    "require": [
+      "tsconfig-paths/register"
+    ]
+  }
 }