@entro314labs/ai-changelog-generator 3.0.5 → 3.2.0

package/src/shared/utils/error-classes.js

@@ -4,23 +4,23 @@
  * Based on the original lib-old/utils/error-handler.js
  */
 
-import JsonUtils from './json-utils.js';
+import JsonUtils from './json-utils.js'
 
 /**
  * Base error class for domain-specific errors
  */
 export class AIChangelogError extends Error {
   constructor(message, type, context = {}, originalError = null) {
-    super(message);
-    this.name = this.constructor.name;
-    this.type = type;
-    this.context = context;
-    this.originalError = originalError;
-    this.timestamp = new Date().toISOString();
-    
+    super(message)
+    this.name = this.constructor.name
+    this.type = type
+    this.context = context
+    this.originalError = originalError
+    this.timestamp = new Date().toISOString()
+
     // Capture stack trace
     if (Error.captureStackTrace) {
-      Error.captureStackTrace(this, this.constructor);
+      Error.captureStackTrace(this, this.constructor)
     }
   }
 
@@ -32,23 +32,25 @@ export class AIChangelogError extends Error {
       context: this.context,
       timestamp: this.timestamp,
       stack: this.stack,
-      originalError: this.originalError ? {
-        name: this.originalError.name,
-        message: this.originalError.message,
-        stack: this.originalError.stack
-      } : null
-    };
+      originalError: this.originalError
+        ? {
+            name: this.originalError.name,
+            message: this.originalError.message,
+            stack: this.originalError.stack,
+          }
+        : null,
+    }
   }
 
   toString() {
-    let str = `${this.name}: ${this.message}`;
+    let str = `${this.name}: ${this.message}`
     if (Object.keys(this.context).length > 0) {
-      str += `\nContext: ${JsonUtils.stringifyCompact(this.context)}`;
+      str += `\nContext: ${JsonUtils.stringifyCompact(this.context)}`
     }
     if (this.originalError) {
-      str += `\nCaused by: ${this.originalError.name}: ${this.originalError.message}`;
+      str += `\nCaused by: ${this.originalError.name}: ${this.originalError.message}`
     }
-    return str;
+    return str
   }
 }
 
@@ -57,8 +59,8 @@ export class AIChangelogError extends Error {
  */
 export class GitError extends AIChangelogError {
   constructor(message, command, originalError = null, context = {}) {
-    super(message, 'git', { command, ...context }, originalError);
-    this.command = command;
+    super(message, 'git', { command, ...context }, originalError)
+    this.command = command
   }
 
   static fromCommandFailure(command, exitCode, stdout, stderr, originalError = null) {
@@ -66,41 +68,36 @@ export class GitError extends AIChangelogError {
       command,
       exitCode,
       stdout: stdout?.trim(),
-      stderr: stderr?.trim()
-    };
-    
-    let message = `Git command failed: ${command}`;
-    if (exitCode) message += ` (exit code: ${exitCode})`;
-    if (stderr) message += `\nError: ${stderr}`;
-    
-    return new GitError(message, command, originalError, context);
+      stderr: stderr?.trim(),
+    }
+
+    let message = `Git command failed: ${command}`
+    if (exitCode) {
+      message += ` (exit code: ${exitCode})`
+    }
+    if (stderr) {
+      message += `\nError: ${stderr}`
+    }
+
+    return new GitError(message, command, originalError, context)
   }
 
   static repositoryNotFound(path) {
-    return new GitError(
-      `Git repository not found at path: ${path}`,
-      'init',
-      null,
-      { path, reason: 'repository_not_found' }
-    );
+    return new GitError(`Git repository not found at path: ${path}`, 'init', null, {
+      path,
+      reason: 'repository_not_found',
+    })
   }
 
   static invalidReference(ref, reason = 'unknown') {
-    return new GitError(
-      `Invalid git reference: ${ref}`,
-      'show',
-      null,
-      { ref, reason }
-    );
+    return new GitError(`Invalid git reference: ${ref}`, 'show', null, { ref, reason })
   }
 
   static workingDirectoryDirty(files = []) {
-    return new GitError(
-      'Working directory has uncommitted changes',
-      'status',
-      null,
-      { dirtyFiles: files, reason: 'working_directory_dirty' }
-    );
+    return new GitError('Working directory has uncommitted changes', 'status', null, {
+      dirtyFiles: files,
+      reason: 'working_directory_dirty',
+    })
   }
 }
 
@@ -109,17 +106,15 @@ export class GitError extends AIChangelogError {
  */
 export class ConfigError extends AIChangelogError {
   constructor(message, configKey, originalError = null, context = {}) {
-    super(message, 'config', { configKey, ...context }, originalError);
-    this.configKey = configKey;
+    super(message, 'config', { configKey, ...context }, originalError)
+    this.configKey = configKey
   }
 
   static missingRequired(configKey, source = 'configuration') {
-    return new ConfigError(
-      `Required configuration missing: ${configKey}`,
-      configKey,
-      null,
-      { source, reason: 'missing_required' }
-    );
+    return new ConfigError(`Required configuration missing: ${configKey}`, configKey, null, {
+      source,
+      reason: 'missing_required',
+    })
   }
 
   static invalidValue(configKey, value, expectedType, source = 'configuration') {
@@ -128,16 +123,14 @@ export class ConfigError extends AIChangelogError {
       configKey,
       null,
       { value, expectedType, actualType: typeof value, source, reason: 'invalid_type' }
-    );
+    )
   }
 
   static fileNotFound(configPath) {
-    return new ConfigError(
-      `Configuration file not found: ${configPath}`,
-      'file',
-      null,
-      { configPath, reason: 'file_not_found' }
-    );
+    return new ConfigError(`Configuration file not found: ${configPath}`, 'file', null, {
+      configPath,
+      reason: 'file_not_found',
+    })
   }
 
   static parseError(configPath, originalError) {
@@ -146,7 +139,7 @@ export class ConfigError extends AIChangelogError {
       'file',
       originalError,
       { configPath, reason: 'parse_error' }
-    );
+    )
   }
 
   static providerNotConfigured(providerName) {
@@ -155,7 +148,7 @@ export class ConfigError extends AIChangelogError {
       `providers.${providerName}`,
       null,
       { providerName, reason: 'provider_not_configured' }
-    );
+    )
   }
 }
 
@@ -164,19 +157,15 @@ export class ConfigError extends AIChangelogError {
  */
 export class ValidationError extends AIChangelogError {
   constructor(message, field, value, originalError = null, context = {}) {
-    super(message, 'validation', { field, value, ...context }, originalError);
-    this.field = field;
-    this.value = value;
+    super(message, 'validation', { field, value, ...context }, originalError)
+    this.field = field
+    this.value = value
   }
 
   static required(field) {
-    return new ValidationError(
-      `Field '${field}' is required`,
-      field,
-      undefined,
-      null,
-      { reason: 'required_field' }
-    );
+    return new ValidationError(`Field '${field}' is required`, field, undefined, null, {
+      reason: 'required_field',
+    })
   }
 
   static invalidType(field, value, expectedType) {
@@ -186,7 +175,7 @@ export class ValidationError extends AIChangelogError {
       value,
       null,
       { expectedType, actualType: typeof value, reason: 'invalid_type' }
-    );
+    )
   }
 
   static outOfRange(field, value, min, max) {
@@ -196,30 +185,27 @@ export class ValidationError extends AIChangelogError {
       value,
       null,
       { min, max, reason: 'out_of_range' }
-    );
+    )
   }
 
   static invalidFormat(field, value, format, example = null) {
-    let message = `Field '${field}' has invalid format: expected ${format}`;
-    if (example) message += ` (example: ${example})`;
-    
-    return new ValidationError(
-      message,
-      field,
-      value,
-      null,
-      { format, example, reason: 'invalid_format' }
-    );
+    let message = `Field '${field}' has invalid format: expected ${format}`
+    if (example) {
+      message += ` (example: ${example})`
+    }
+
+    return new ValidationError(message, field, value, null, {
+      format,
+      example,
+      reason: 'invalid_format',
+    })
   }
 
   static custom(field, value, message, context = {}) {
-    return new ValidationError(
-      message,
-      field,
-      value,
-      null,
-      { ...context, reason: 'custom_validation' }
-    );
+    return new ValidationError(message, field, value, null, {
+      ...context,
+      reason: 'custom_validation',
+    })
   }
 }
 
@@ -228,9 +214,9 @@ export class ValidationError extends AIChangelogError {
  */
 export class ProviderError extends AIChangelogError {
   constructor(message, providerName, methodName, originalError = null, context = {}) {
-    super(message, 'provider', { providerName, methodName, ...context }, originalError);
-    this.providerName = providerName;
-    this.methodName = methodName;
+    super(message, 'provider', { providerName, methodName, ...context }, originalError)
+    this.providerName = providerName
+    this.methodName = methodName
   }
 
   static notAvailable(providerName, reason = 'unknown') {
@@ -240,7 +226,7 @@ export class ProviderError extends AIChangelogError {
       'availability',
       null,
       { reason }
-    );
+    )
   }
 
   static authenticationFailed(providerName, details = {}) {
@@ -250,7 +236,7 @@ export class ProviderError extends AIChangelogError {
       'authenticate',
       null,
       { ...details, reason: 'authentication_failed' }
-    );
+    )
   }
 
   static rateLimitExceeded(providerName, retryAfter = null) {
@@ -260,7 +246,7 @@ export class ProviderError extends AIChangelogError {
       'request',
       null,
       { retryAfter, reason: 'rate_limit_exceeded' }
-    );
+    )
   }
 
   static apiError(providerName, methodName, statusCode, response, originalError = null) {
@@ -270,7 +256,7 @@ export class ProviderError extends AIChangelogError {
       methodName,
       originalError,
       { statusCode, response, reason: 'api_error' }
-    );
+    )
   }
 
   static invalidResponse(providerName, methodName, response, expectedFormat) {
@@ -280,7 +266,7 @@ export class ProviderError extends AIChangelogError {
       methodName,
       null,
       { response, expectedFormat, reason: 'invalid_response' }
-    );
+    )
   }
 }
 
@@ -289,9 +275,9 @@ export class ProviderError extends AIChangelogError {
  */
 export class AbstractMethodError extends AIChangelogError {
   constructor(message, className, methodName, context = {}) {
-    super(message, 'abstract', { className, methodName, ...context });
-    this.className = className;
-    this.methodName = methodName;
+    super(message, 'abstract', { className, methodName, ...context })
+    this.className = className
+    this.methodName = methodName
   }
 
   static notImplemented(className, methodName) {
@@ -300,7 +286,7 @@ export class AbstractMethodError extends AIChangelogError {
       className,
       methodName,
       { reason: 'not_implemented' }
-    );
+    )
   }
 }
 
@@ -309,19 +295,15 @@ export class AbstractMethodError extends AIChangelogError {
  */
 export class FileSystemError extends AIChangelogError {
   constructor(message, operation, path, originalError = null, context = {}) {
-    super(message, 'filesystem', { operation, path, ...context }, originalError);
-    this.operation = operation;
-    this.path = path;
+    super(message, 'filesystem', { operation, path, ...context }, originalError)
+    this.operation = operation
+    this.path = path
   }
 
   static fileNotFound(path) {
-    return new FileSystemError(
-      `File not found: ${path}`,
-      'read',
-      path,
-      null,
-      { reason: 'file_not_found' }
-    );
+    return new FileSystemError(`File not found: ${path}`, 'read', path, null, {
+      reason: 'file_not_found',
+    })
   }
 
   static permissionDenied(operation, path) {
@@ -331,17 +313,13 @@ export class FileSystemError extends AIChangelogError {
       path,
       null,
       { reason: 'permission_denied' }
-    );
+    )
   }
 
   static directoryNotFound(path) {
-    return new FileSystemError(
-      `Directory not found: ${path}`,
-      'access',
-      path,
-      null,
-      { reason: 'directory_not_found' }
-    );
+    return new FileSystemError(`Directory not found: ${path}`, 'access', path, null, {
+      reason: 'directory_not_found',
+    })
   }
 }
 
@@ -350,39 +328,30 @@ export class FileSystemError extends AIChangelogError {
  */
 export class NetworkError extends AIChangelogError {
   constructor(message, url, operation, originalError = null, context = {}) {
-    super(message, 'network', { url, operation, ...context }, originalError);
-    this.url = url;
-    this.operation = operation;
+    super(message, 'network', { url, operation, ...context }, originalError)
+    this.url = url
+    this.operation = operation
   }
 
   static connectionFailed(url, originalError = null) {
-    return new NetworkError(
-      `Failed to connect to ${url}`,
-      url,
-      'connect',
-      originalError,
-      { reason: 'connection_failed' }
-    );
+    return new NetworkError(`Failed to connect to ${url}`, url, 'connect', originalError, {
+      reason: 'connection_failed',
+    })
   }
 
   static timeout(url, timeoutMs) {
-    return new NetworkError(
-      `Request timeout after ${timeoutMs}ms: ${url}`,
-      url,
-      'request',
-      null,
-      { timeoutMs, reason: 'timeout' }
-    );
+    return new NetworkError(`Request timeout after ${timeoutMs}ms: ${url}`, url, 'request', null, {
+      timeoutMs,
+      reason: 'timeout',
+    })
   }
 
   static httpError(url, statusCode, statusText) {
-    return new NetworkError(
-      `HTTP ${statusCode} ${statusText}: ${url}`,
-      url,
-      'request',
-      null,
-      { statusCode, statusText, reason: 'http_error' }
-    );
+    return new NetworkError(`HTTP ${statusCode} ${statusText}: ${url}`, url, 'request', null, {
+      statusCode,
+      statusText,
+      reason: 'http_error',
+    })
   }
 }
 
@@ -391,33 +360,33 @@ export class NetworkError extends AIChangelogError {
  */
 export class ErrorContext {
   constructor() {
-    this.data = {};
+    this.data = {}
   }
 
   add(key, value) {
-    this.data[key] = value;
-    return this;
+    this.data[key] = value
+    return this
   }
 
   addGitInfo(command, exitCode, stdout, stderr) {
-    return this.add('git', { command, exitCode, stdout, stderr });
+    return this.add('git', { command, exitCode, stdout, stderr })
   }
 
   addProviderInfo(name, model, endpoint) {
-    return this.add('provider', { name, model, endpoint });
+    return this.add('provider', { name, model, endpoint })
   }
 
   addFileInfo(path, size, mtime) {
-    return this.add('file', { path, size, mtime });
+    return this.add('file', { path, size, mtime })
   }
 
   addUserInfo(action, timestamp = new Date().toISOString()) {
-    return this.add('user', { action, timestamp });
+    return this.add('user', { action, timestamp })
   }
 
   build() {
-    return { ...this.data };
+    return { ...this.data }
   }
 }
 
-// All error classes are exported individually with their class declarations above
+// All error classes are exported individually with their class declarations above