codereview-aia 0.1.3 → 0.2.0

package/dist/utils/PathGenerator.js

@@ -0,0 +1,82 @@
+"use strict";
+/**
+ * @fileoverview Path generation utilities.
+ *
+ * This module provides utilities for generating file and directory paths,
+ * including versioned output paths for review results.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateVersionedOutputPath = generateVersionedOutputPath;
+exports.generateUniqueOutputPath = generateUniqueOutputPath;
+exports.generateTempFilePath = generateTempFilePath;
+const node_path_1 = __importDefault(require("node:path"));
+const FileWriter_1 = require("./FileWriter");
+const pathValidator_1 = require("./pathValidator");
+/**
+ * Generate a versioned output path for a file
+ * @param baseDir Base directory for the output
+ * @param prefix Prefix for the filename
+ * @param extension File extension (including the dot)
+ * @param modelName Name of the model used for the review
+ * @param targetName Name of the target file or directory
+ * @returns Promise resolving to the generated path
+ */
+async function generateVersionedOutputPath(baseDir, prefix, extension, modelName, targetName) {
+    // Ensure the output directory exists
+    await (0, FileWriter_1.ensureDirectoryExists)(baseDir);
+    // Generate a timestamp for the filename
+    const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+    // Clean up the model name for use in a filename
+    const cleanModelName = modelName.replace(/[^a-zA-Z0-9-]/g, '-');
+    // Clean up the target name for use in a filename
+    let cleanTargetName = targetName.replace(/[^a-zA-Z0-9-]/g, '-');
+    // Handle special cases for target names
+    if (targetName === '.' || cleanTargetName === '-' || cleanTargetName === '') {
+        cleanTargetName = 'current-dir';
+    }
+    // Remove any sequential dashes
+    cleanTargetName = cleanTargetName.replace(/-+/g, '-').replace(/^-|-$/g, '');
+    // Generate the filename
+    const filename = `${prefix}-${cleanTargetName}-${cleanModelName}-${timestamp}${extension}`;
+    // Return the full path
+    return node_path_1.default.join(baseDir, filename);
+}
+/**
+ * Generate an output path for a file with a unique name
+ * @param baseDir Base directory for the output
+ * @param filename Desired filename
+ * @returns Promise resolving to the generated path
+ */
+async function generateUniqueOutputPath(baseDir, filename) {
+    // Ensure the output directory exists
+    await (0, FileWriter_1.ensureDirectoryExists)(baseDir);
+    // Generate the initial path
+    let outputPath = node_path_1.default.join(baseDir, filename);
+    // If the file already exists, add a number to the filename
+    if (await (0, pathValidator_1.pathExists)(outputPath)) {
+        const extension = node_path_1.default.extname(filename);
+        const nameWithoutExtension = node_path_1.default.basename(filename, extension);
+        let counter = 1;
+        // Try different numbers until we find an available filename
+        while (await (0, pathValidator_1.pathExists)(outputPath)) {
+            outputPath = node_path_1.default.join(baseDir, `${nameWithoutExtension}-${counter}${extension}`);
+            counter++;
+        }
+    }
+    return outputPath;
+}
+/**
+ * Generate a temporary file path
+ * @param prefix Prefix for the filename
+ * @param extension File extension (including the dot)
+ * @returns Generated temporary file path
+ */
+function generateTempFilePath(prefix, extension) {
+    const timestamp = Date.now();
+    const randomPart = Math.floor(Math.random() * 10000);
+    return node_path_1.default.join(process.env.TEMP || process.env.TMP || '/tmp', `${prefix}-${timestamp}-${randomPart}${extension}`);
+}
+//# sourceMappingURL=PathGenerator.js.map

package/dist/utils/PathGenerator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PathGenerator.js","sourceRoot":"","sources":["../../src/utils/PathGenerator.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;AAeH,kEAgCC;AAQD,4DAqBC;AAQD,oDAOC;AAzFD,0DAA6B;AAC7B,6CAAqD;AACrD,mDAA6C;AAE7C;;;;;;;;GAQG;AACI,KAAK,UAAU,2BAA2B,CAC/C,OAAe,EACf,MAAc,EACd,SAAiB,EACjB,SAAiB,EACjB,UAAkB;IAElB,qCAAqC;IACrC,MAAM,IAAA,kCAAqB,EAAC,OAAO,CAAC,CAAC;IAErC,wCAAwC;IACxC,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAEjE,gDAAgD;IAChD,MAAM,cAAc,GAAG,SAAS,CAAC,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC;IAEhE,iDAAiD;IACjD,IAAI,eAAe,GAAG,UAAU,CAAC,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC;IAEhE,wCAAwC;IACxC,IAAI,UAAU,KAAK,GAAG,IAAI,eAAe,KAAK,GAAG,IAAI,eAAe,KAAK,EAAE,EAAE,CAAC;QAC5E,eAAe,GAAG,aAAa,CAAC;IAClC,CAAC;IAED,+BAA+B;IAC/B,eAAe,GAAG,eAAe,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAE5E,wBAAwB;IACxB,MAAM,QAAQ,GAAG,GAAG,MAAM,IAAI,eAAe,IAAI,cAAc,IAAI,SAAS,GAAG,SAAS,EAAE,CAAC;IAE3F,uBAAuB;IACvB,OAAO,mBAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;AACtC,CAAC;AAED;;;;;GAKG;AACI,KAAK,UAAU,wBAAwB,CAAC,OAAe,EAAE,QAAgB;IAC9E,qCAAqC;IACrC,MAAM,IAAA,kCAAqB,EAAC,OAAO,CAAC,CAAC;IAErC,4BAA4B;IAC5B,IAAI,UAAU,GAAG,mBAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAE9C,2DAA2D;IAC3D,IAAI,MAAM,IAAA,0BAAU,EAAC,UAAU,CAAC,EAAE,CAAC;QACjC,MAAM,SAAS,GAAG,mBAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACzC,MAAM,oBAAoB,GAAG,mBAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QAChE,IAAI,OAAO,GAAG,CAAC,CAAC;QAEhB,4DAA4D;QAC5D,OAAO,MAAM,IAAA,0BAAU,EAAC,UAAU,CAAC,EAAE,CAAC;YACpC,UAAU,GAAG,mBAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,oBAAoB,IAAI,OAAO,GAAG,SAAS,EAAE,CAAC,CAAC;YAClF,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;;;GAKG;AACH,SAAgB,oBAAoB,CAAC,MAAc,EAAE,SAAiB;IACpE,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC;IACrD,OAAO,mBAAI,CAAC,IAAI,CACd,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,MAAM,EAC7C,GAAG,MAAM,IAAI,SAAS,IAAI,UAAU,GAAG,SAAS,EAAE,CACnD,CAAC;AACJ,CAAC"}

package/dist/utils/api/apiUtils.d.ts

@@ -0,0 +1,3 @@
+export declare function hasApiKey(provider: string): boolean;
+export declare function getApiKeyType(): 'OpenRouter' | null;
+export declare function getApiKeyTypeLowerCase(): 'openrouter' | 'none';

package/dist/utils/api/apiUtils.js

@@ -0,0 +1,20 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hasApiKey = hasApiKey;
+exports.getApiKeyType = getApiKeyType;
+exports.getApiKeyTypeLowerCase = getApiKeyTypeLowerCase;
+const logger_1 = __importDefault(require("../logger"));
+function hasApiKey(provider) {
+    return provider.toLowerCase() === 'openrouter';
+}
+function getApiKeyType() {
+    logger_1.default.debug('getApiKeyType: defaulting to OpenRouter proxy');
+    return 'OpenRouter';
+}
+function getApiKeyTypeLowerCase() {
+    return 'openrouter';
+}
+//# sourceMappingURL=apiUtils.js.map

package/dist/utils/api/apiUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiUtils.js","sourceRoot":"","sources":["../../../src/utils/api/apiUtils.ts"],"names":[],"mappings":";;;;;AAEA,8BAEC;AAED,sCAGC;AAED,wDAEC;AAbD,uDAA+B;AAE/B,SAAgB,SAAS,CAAC,QAAgB;IACxC,OAAO,QAAQ,CAAC,WAAW,EAAE,KAAK,YAAY,CAAC;AACjD,CAAC;AAED,SAAgB,aAAa;IAC3B,gBAAM,CAAC,KAAK,CAAC,+CAA+C,CAAC,CAAC;IAC9D,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,SAAgB,sBAAsB;IACpC,OAAO,YAAY,CAAC;AACtB,CAAC"}

package/dist/utils/api/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./apiUtils"), exports);
+//# sourceMappingURL=index.js.map

package/dist/utils/api/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/api/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6CAA2B"}

package/dist/utils/apiErrorHandler.d.ts

@@ -0,0 +1,130 @@
+/**
+ * @fileoverview API error handling utilities.
+ *
+ * This module provides standardized error handling for API calls,
+ * including custom error classes for different types of API errors,
+ * utility functions for handling fetch responses, and logging helpers.
+ */
+/**
+ * Base class for API errors
+ *
+ * This class extends the standard Error class to provide additional context
+ * for API-related errors. It includes properties for the HTTP status code
+ * and additional error details from the API response.
+ *
+ * All specific API error types (like AuthenticationError, RateLimitError, etc.)
+ * extend this base class to provide a consistent error handling interface.
+ */
+export declare class ApiError extends Error {
+    statusCode?: number | undefined;
+    details?: unknown | undefined;
+    constructor(message: string, statusCode?: number | undefined, details?: unknown | undefined);
+}
+/**
+ * Error thrown when API rate limits are exceeded
+ */
+export declare class RateLimitError extends ApiError {
+    retryAfter?: number | undefined;
+    constructor(message: string, retryAfter?: number | undefined, statusCode?: number, details?: unknown);
+}
+/**
+ * Error thrown when authentication fails
+ */
+export declare class AuthenticationError extends ApiError {
+    constructor(message: string, statusCode?: number, details?: unknown);
+}
+/**
+ * Error thrown when a resource is not found
+ */
+export declare class NotFoundError extends ApiError {
+    constructor(message: string, statusCode?: number, details?: unknown);
+}
+/**
+ * Error thrown when the API returns an invalid response format
+ */
+export declare class InvalidResponseError extends ApiError {
+    constructor(message: string, statusCode?: number, details?: unknown);
+}
+/**
+ * Error thrown when token limit is exceeded
+ */
+export declare class TokenLimitError extends ApiError {
+    tokenCount?: number | undefined;
+    tokenLimit?: number | undefined;
+    constructor(message: string, tokenCount?: number | undefined, tokenLimit?: number | undefined, statusCode?: number, details?: unknown);
+}
+/**
+ * Handle a fetch response and throw appropriate errors if needed
+ *
+ * This function processes a fetch response and throws appropriate error types
+ * based on the HTTP status code and response body. It handles common API error
+ * scenarios like authentication failures, rate limiting, and resource not found.
+ *
+ * The function attempts to parse the response body as JSON if possible, or falls
+ * back to text if not. It then constructs an appropriate error object with
+ * detailed information about what went wrong.
+ *
+ * @param response The fetch response object from an API call
+ * @param apiName The name of the API being called (for logging and error messages)
+ * @returns The original response object if the response is ok (status 200-299)
+ * @throws AuthenticationError for 401/403 status codes (authentication/authorization issues)
+ * @throws NotFoundError for 404 status codes (resource not found)
+ * @throws RateLimitError for 429 status codes (rate limit exceeded)
+ * @throws ApiError for all other error status codes
+ * @example
+ * try {
+ *   const response = await fetch('https://api.example.com/data');
+ *   await handleFetchResponse(response, 'ExampleAPI');
+ *   // Process successful response
+ * } catch (error) {
+ *   // Error is already logged and has the appropriate type
+ *   if (error instanceof RateLimitError) {
+ *     // Handle rate limiting specifically
+ *   }
+ * }
+ */
+export declare function handleFetchResponse(response: Response, apiName: string): Promise<Response>;
+/**
+ * Safely parse JSON from a response
+ * @param response The fetch response object
+ * @param apiName The name of the API being called (for logging)
+ * @returns The parsed JSON data
+ * @throws InvalidResponseError if the response cannot be parsed as JSON
+ */
+export declare function safeJsonParse<T>(response: Response | any, apiName: string): Promise<T>;
+/**
+ * Log an API error with appropriate context and formatting
+ *
+ * This function logs API errors with rich context information to help with debugging
+ * and troubleshooting. It detects the specific type of error and formats the log
+ * message accordingly, providing different information based on the error type.
+ *
+ * The function handles various error types including:
+ * - Rate limit errors (with retry information)
+ * - Authentication errors
+ * - Resource not found errors
+ * - Invalid response errors
+ * - General API errors
+ * - Unexpected errors
+ *
+ * @param error The error object that was thrown
+ * @param context Object containing context information:
+ *   - apiName: The name of the API service (e.g., 'OpenAI', 'Anthropic')
+ *   - operation: The operation being performed (e.g., 'generating review')
+ *   - url: Optional URL for the request that failed
+ * @example
+ * try {
+ *   // API call that might fail
+ * } catch (error) {
+ *   logApiError(error, {
+ *     apiName: 'OpenAI',
+ *     operation: 'generating code review',
+ *     url: 'https://api.openai.com/v1/chat/completions'
+ *   });
+ * }
+ */
+export declare function logApiError(error: unknown, context: {
+    operation: string;
+    url?: string;
+    apiName: string;
+}): void;

package/dist/utils/apiErrorHandler.js

@@ -0,0 +1,256 @@
+"use strict";
+/**
+ * @fileoverview API error handling utilities.
+ *
+ * This module provides standardized error handling for API calls,
+ * including custom error classes for different types of API errors,
+ * utility functions for handling fetch responses, and logging helpers.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TokenLimitError = exports.InvalidResponseError = exports.NotFoundError = exports.AuthenticationError = exports.RateLimitError = exports.ApiError = void 0;
+exports.handleFetchResponse = handleFetchResponse;
+exports.safeJsonParse = safeJsonParse;
+exports.logApiError = logApiError;
+const logger_1 = __importDefault(require("./logger"));
+/**
+ * Base class for API errors
+ *
+ * This class extends the standard Error class to provide additional context
+ * for API-related errors. It includes properties for the HTTP status code
+ * and additional error details from the API response.
+ *
+ * All specific API error types (like AuthenticationError, RateLimitError, etc.)
+ * extend this base class to provide a consistent error handling interface.
+ */
+class ApiError extends Error {
+    statusCode;
+    details;
+    constructor(message, statusCode, details) {
+        super(message);
+        this.statusCode = statusCode;
+        this.details = details;
+        this.name = 'ApiError';
+        // Ensure instanceof works correctly in ES5
+        Object.setPrototypeOf(this, ApiError.prototype);
+    }
+}
+exports.ApiError = ApiError;
+/**
+ * Error thrown when API rate limits are exceeded
+ */
+class RateLimitError extends ApiError {
+    retryAfter;
+    constructor(message, retryAfter, statusCode, details) {
+        super(message, statusCode, details);
+        this.retryAfter = retryAfter;
+        this.name = 'RateLimitError';
+        // Ensure instanceof works correctly in ES5
+        Object.setPrototypeOf(this, RateLimitError.prototype);
+    }
+}
+exports.RateLimitError = RateLimitError;
+/**
+ * Error thrown when authentication fails
+ */
+class AuthenticationError extends ApiError {
+    constructor(message, statusCode, details) {
+        super(message, statusCode, details);
+        this.name = 'AuthenticationError';
+        // Ensure instanceof works correctly in ES5
+        Object.setPrototypeOf(this, AuthenticationError.prototype);
+    }
+}
+exports.AuthenticationError = AuthenticationError;
+/**
+ * Error thrown when a resource is not found
+ */
+class NotFoundError extends ApiError {
+    constructor(message, statusCode, details) {
+        super(message, statusCode, details);
+        this.name = 'NotFoundError';
+        // Ensure instanceof works correctly in ES5
+        Object.setPrototypeOf(this, NotFoundError.prototype);
+    }
+}
+exports.NotFoundError = NotFoundError;
+/**
+ * Error thrown when the API returns an invalid response format
+ */
+class InvalidResponseError extends ApiError {
+    constructor(message, statusCode, details) {
+        super(message, statusCode, details);
+        this.name = 'InvalidResponseError';
+        // Ensure instanceof works correctly in ES5
+        Object.setPrototypeOf(this, InvalidResponseError.prototype);
+    }
+}
+exports.InvalidResponseError = InvalidResponseError;
+/**
+ * Error thrown when token limit is exceeded
+ */
+class TokenLimitError extends ApiError {
+    tokenCount;
+    tokenLimit;
+    constructor(message, tokenCount, tokenLimit, statusCode, details) {
+        super(message, statusCode, details);
+        this.tokenCount = tokenCount;
+        this.tokenLimit = tokenLimit;
+        this.name = 'TokenLimitError';
+        // Ensure instanceof works correctly in ES5
+        Object.setPrototypeOf(this, TokenLimitError.prototype);
+    }
+}
+exports.TokenLimitError = TokenLimitError;
+/**
+ * Handle a fetch response and throw appropriate errors if needed
+ *
+ * This function processes a fetch response and throws appropriate error types
+ * based on the HTTP status code and response body. It handles common API error
+ * scenarios like authentication failures, rate limiting, and resource not found.
+ *
+ * The function attempts to parse the response body as JSON if possible, or falls
+ * back to text if not. It then constructs an appropriate error object with
+ * detailed information about what went wrong.
+ *
+ * @param response The fetch response object from an API call
+ * @param apiName The name of the API being called (for logging and error messages)
+ * @returns The original response object if the response is ok (status 200-299)
+ * @throws AuthenticationError for 401/403 status codes (authentication/authorization issues)
+ * @throws NotFoundError for 404 status codes (resource not found)
+ * @throws RateLimitError for 429 status codes (rate limit exceeded)
+ * @throws ApiError for all other error status codes
+ * @example
+ * try {
+ *   const response = await fetch('https://api.example.com/data');
+ *   await handleFetchResponse(response, 'ExampleAPI');
+ *   // Process successful response
+ * } catch (error) {
+ *   // Error is already logged and has the appropriate type
+ *   if (error instanceof RateLimitError) {
+ *     // Handle rate limiting specifically
+ *   }
+ * }
+ */
+async function handleFetchResponse(response, apiName) {
+    if (!response.ok) {
+        // Try to get the error body
+        let errorBody = 'Unknown error';
+        try {
+            // Clone the response so we can read it multiple times if needed
+            // const clonedResponse = response.clone();
+            // Log all headers for debugging
+            console.log(`[DEBUG] ${apiName} API response headers:`);
+            response.headers.forEach((value, name) => {
+                console.log(`[DEBUG] ${name}: ${value}`);
+            });
+            // Try to parse as JSON first
+            const contentType = response.headers.get('content-type');
+            console.log(`[DEBUG] Content-Type: ${contentType}`);
+            if (contentType?.includes('application/json')) {
+                errorBody = await response.json();
+                console.log(`[DEBUG] JSON error body: ${JSON.stringify(errorBody)}`);
+            }
+            else {
+                errorBody = await response.text();
+                console.log(`[DEBUG] Text error body: ${errorBody}`);
+            }
+        }
+        catch (e) {
+            // Log body read errors
+            console.log(`[DEBUG] Failed to read error body: ${e instanceof Error ? e.message : String(e)}`);
+            logger_1.default.debug(`Failed to read error body: ${e instanceof Error ? e.message : String(e)}`);
+        }
+        // Create appropriate error based on status code
+        const errorMessage = `${apiName} API error! Status: ${response.status}, Response: ${typeof errorBody === 'string' ? errorBody : JSON.stringify(errorBody)}`;
+        // Log the error
+        logger_1.default.error(errorMessage);
+        // Throw appropriate error based on status code
+        if (response.status === 401 || response.status === 403) {
+            throw new AuthenticationError(errorMessage, response.status, errorBody);
+        }
+        if (response.status === 404) {
+            throw new NotFoundError(errorMessage, response.status, errorBody);
+        }
+        if (response.status === 429) {
+            // Check for retry-after header
+            const retryAfter = response.headers.get('retry-after');
+            const retryAfterSeconds = retryAfter ? parseInt(retryAfter, 10) : undefined;
+            throw new RateLimitError(errorMessage, retryAfterSeconds, response.status, errorBody);
+        }
+        throw new ApiError(errorMessage, response.status, errorBody);
+    }
+    return response;
+}
+/**
+ * Safely parse JSON from a response
+ * @param response The fetch response object
+ * @param apiName The name of the API being called (for logging)
+ * @returns The parsed JSON data
+ * @throws InvalidResponseError if the response cannot be parsed as JSON
+ */
+async function safeJsonParse(response, apiName) {
+    try {
+        return (await response.json());
+    }
+    catch (error) {
+        const errorMessage = `Failed to parse ${apiName} API response as JSON: ${error instanceof Error ? error.message : String(error)}`;
+        logger_1.default.error(errorMessage);
+        throw new InvalidResponseError(errorMessage);
+    }
+}
+/**
+ * Log an API error with appropriate context and formatting
+ *
+ * This function logs API errors with rich context information to help with debugging
+ * and troubleshooting. It detects the specific type of error and formats the log
+ * message accordingly, providing different information based on the error type.
+ *
+ * The function handles various error types including:
+ * - Rate limit errors (with retry information)
+ * - Authentication errors
+ * - Resource not found errors
+ * - Invalid response errors
+ * - General API errors
+ * - Unexpected errors
+ *
+ * @param error The error object that was thrown
+ * @param context Object containing context information:
+ *   - apiName: The name of the API service (e.g., 'OpenAI', 'Anthropic')
+ *   - operation: The operation being performed (e.g., 'generating review')
+ *   - url: Optional URL for the request that failed
+ * @example
+ * try {
+ *   // API call that might fail
+ * } catch (error) {
+ *   logApiError(error, {
+ *     apiName: 'OpenAI',
+ *     operation: 'generating code review',
+ *     url: 'https://api.openai.com/v1/chat/completions'
+ *   });
+ * }
+ */
+function logApiError(error, context) {
+    const { operation, url, apiName } = context;
+    if (error instanceof RateLimitError) {
+        logger_1.default.warn(`Rate limit exceeded for ${apiName} API during ${operation}${url ? ` (${url})` : ''}. Retry after: ${error.retryAfter || 'unknown'} seconds.`);
+    }
+    else if (error instanceof AuthenticationError) {
+        logger_1.default.error(`Authentication failed for ${apiName} API during ${operation}${url ? ` (${url})` : ''}. Check your API key.`);
+    }
+    else if (error instanceof NotFoundError) {
+        logger_1.default.error(`Resource not found on ${apiName} API during ${operation}${url ? ` (${url})` : ''}. Check your request parameters.`);
+    }
+    else if (error instanceof InvalidResponseError) {
+        logger_1.default.error(`Invalid response from ${apiName} API during ${operation}${url ? ` (${url})` : ''}. The API may have changed or returned an unexpected format.`);
+    }
+    else if (error instanceof ApiError) {
+        logger_1.default.error(`API error from ${apiName} during ${operation}${url ? ` (${url})` : ''}: ${error.message}`);
+    }
+    else {
+        logger_1.default.error(`Unexpected error during ${apiName} API ${operation}${url ? ` (${url})` : ''}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+//# sourceMappingURL=apiErrorHandler.js.map

package/dist/utils/apiErrorHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiErrorHandler.js","sourceRoot":"","sources":["../../src/utils/apiErrorHandler.ts"],"names":[],"mappings":"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"}

package/dist/utils/ciDataCollector.d.ts

@@ -0,0 +1,51 @@
+/**
+ * @fileoverview CI/CD data collector utility.
+ *
+ * This module collects CI/CD data (type check errors, lint errors) to include
+ * in code reviews. It supports both project-wide and per-file analysis.
+ */
+/**
+ * CI data structure
+ */
+export interface CIData {
+    /**
+     * Number of type check errors
+     */
+    typeCheckErrors?: number;
+    /**
+     * Number of lint errors
+     */
+    lintErrors?: number;
+    /**
+     * Raw type check output
+     */
+    typeCheckOutput?: string;
+    /**
+     * Raw lint output
+     */
+    lintOutput?: string;
+    /**
+     * Per-file error counts
+     */
+    fileErrors?: {
+        [filePath: string]: {
+            typeCheckErrors: number;
+            lintErrors: number;
+            typeCheckMessages?: string[];
+            lintMessages?: string[];
+        };
+    };
+}
+/**
+ * Collect CI/CD data for the current project
+ * @param projectPath Path to the project root
+ * @returns Promise resolving to CI data
+ */
+export declare function collectCIData(projectPath: string): Promise<CIData>;
+/**
+ * Format CI data for inclusion in prompts
+ * @param ciData CI data to format
+ * @param specificFile Optional specific file to focus on
+ * @returns Formatted string for prompt inclusion
+ */
+export declare function formatCIDataForPrompt(ciData: CIData, specificFile?: string): string;