gitlab-auto-reviewers 2.0.0

package/dist/errors/error-handler.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Error Handler
+ *
+ * Provides consistent error handling with retry logic and clear error messages.
+ * Supports exponential backoff for transient failures.
+ */
+/**
+ * Custom error class for MCP server errors
+ */
+export declare class MCPError extends Error {
+    code: string;
+    details?: Record<string, unknown> | undefined;
+    cause?: Error | undefined;
+    /**
+     * Create a new MCP error
+     *
+     * @param message - Human-readable error message
+     * @param code - Error code for categorization (e.g., 'configuration', 'validation')
+     * @param details - Optional additional error details
+     * @param cause - Optional underlying error that caused this error
+     */
+    constructor(message: string, code: string, details?: Record<string, unknown> | undefined, cause?: Error | undefined);
+    /**
+     * Convert error to JSON for logging/serialization
+     */
+    toJSON(): Record<string, unknown>;
+}
+/**
+ * Error categories for classification
+ */
+export declare enum ErrorCategory {
+    CONFIGURATION = "configuration",
+    VALIDATION = "validation",
+    GIT_OPERATION = "git_operation",
+    API_CALL = "api_call",
+    NETWORK = "network",
+    PERMISSION = "permission",
+    NOT_FOUND = "not_found",
+    INTERNAL = "internal"
+}
+/**
+ * Retry options for operations
+ *
+ * @property maxRetries - Maximum number of retry attempts
+ * @property delayMs - Initial delay in milliseconds between retries
+ * @property backoffMultiplier - Multiplier for exponential backoff (e.g., 2 for doubling)
+ * @property onRetry - Optional callback function called on each retry attempt
+ */
+export interface RetryOptions {
+    maxRetries: number;
+    delayMs: number;
+    backoffMultiplier: number;
+    onRetry?: (attempt: number, error: Error) => void;
+}
+/**
+ * Default retry options
+ */
+export declare const DEFAULT_RETRY_OPTIONS: RetryOptions;
+/**
+ * Error Handler utility class
+ */
+export declare class ErrorHandler {
+    private static logger;
+    /**
+     * Execute an operation with retry logic
+     */
+    static withRetry<T>(operation: () => Promise<T>, options?: Partial<RetryOptions>): Promise<T>;
+    /**
+     * Check if an error is transient (retryable)
+     */
+    static isTransient(error: Error): boolean;
+    /**
+     * Format an error for display
+     */
+    static formatError(error: Error): string;
+    /**
+     * Create an MCPError from a generic error
+     */
+    static toMCPError(error: unknown, code: string, details?: Record<string, unknown>): MCPError;
+    /**
+     * Wrap an operation with error handling
+     */
+    static wrap<T>(operation: () => Promise<T>, errorCode: string, _errorMessage: string, details?: Record<string, unknown>): Promise<T>;
+    /**
+     * Delay execution for a specified time
+     */
+    private static delay;
+    /**
+     * Create a configuration error
+     */
+    static configurationError(message: string, details?: Record<string, unknown>): MCPError;
+    /**
+     * Create a validation error
+     */
+    static validationError(message: string, details?: Record<string, unknown>): MCPError;
+    /**
+     * Create a git operation error
+     */
+    static gitOperationError(message: string, details?: Record<string, unknown>, cause?: Error): MCPError;
+    /**
+     * Create an API call error
+     */
+    static apiCallError(message: string, details?: Record<string, unknown>, cause?: Error): MCPError;
+    /**
+     * Create a not found error
+     */
+    static notFoundError(message: string, details?: Record<string, unknown>): MCPError;
+    /**
+     * Create a permission error
+     */
+    static permissionError(message: string, details?: Record<string, unknown>): MCPError;
+}
+//# sourceMappingURL=error-handler.d.ts.map

package/dist/errors/error-handler.d.ts.map

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

package/dist/errors/error-handler.js

@@ -0,0 +1,230 @@
+/**
+ * Error Handler
+ *
+ * Provides consistent error handling with retry logic and clear error messages.
+ * Supports exponential backoff for transient failures.
+ */
+import { Logger } from '../logging/logger.service.js';
+/**
+ * Custom error class for MCP server errors
+ */
+export class MCPError extends Error {
+    code;
+    details;
+    cause;
+    /**
+     * Create a new MCP error
+     *
+     * @param message - Human-readable error message
+     * @param code - Error code for categorization (e.g., 'configuration', 'validation')
+     * @param details - Optional additional error details
+     * @param cause - Optional underlying error that caused this error
+     */
+    constructor(message, code, details, cause) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.cause = cause;
+        this.name = 'MCPError';
+        // Maintain proper stack trace for where our error was thrown (only available on V8)
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, MCPError);
+        }
+    }
+    /**
+     * Convert error to JSON for logging/serialization
+     */
+    toJSON() {
+        return {
+            name: this.name,
+            message: this.message,
+            code: this.code,
+            details: this.details,
+            cause: this.cause?.message,
+            stack: this.stack,
+        };
+    }
+}
+/**
+ * Error categories for classification
+ */
+export var ErrorCategory;
+(function (ErrorCategory) {
+    ErrorCategory["CONFIGURATION"] = "configuration";
+    ErrorCategory["VALIDATION"] = "validation";
+    ErrorCategory["GIT_OPERATION"] = "git_operation";
+    ErrorCategory["API_CALL"] = "api_call";
+    ErrorCategory["NETWORK"] = "network";
+    ErrorCategory["PERMISSION"] = "permission";
+    ErrorCategory["NOT_FOUND"] = "not_found";
+    ErrorCategory["INTERNAL"] = "internal";
+})(ErrorCategory || (ErrorCategory = {}));
+/**
+ * Default retry options
+ */
+export const DEFAULT_RETRY_OPTIONS = {
+    maxRetries: 3,
+    delayMs: 1000,
+    backoffMultiplier: 2,
+};
+/**
+ * Error Handler utility class
+ */
+export class ErrorHandler {
+    static logger = new Logger('ErrorHandler');
+    /**
+     * Execute an operation with retry logic
+     */
+    static async withRetry(operation, options = {}) {
+        const opts = { ...DEFAULT_RETRY_OPTIONS, ...options };
+        let lastError;
+        for (let attempt = 0; attempt <= opts.maxRetries; attempt++) {
+            try {
+                return await operation();
+            }
+            catch (error) {
+                lastError = error instanceof Error ? error : new Error(String(error));
+                // Check if error is transient and we should retry
+                if (attempt < opts.maxRetries && this.isTransient(lastError)) {
+                    const delay = opts.delayMs * Math.pow(opts.backoffMultiplier, attempt);
+                    this.logger.warn(`Operation failed, retrying (attempt ${attempt + 1}/${opts.maxRetries})`, {
+                        error: lastError.message,
+                        delay,
+                        attempt: attempt + 1,
+                        maxRetries: opts.maxRetries,
+                    });
+                    // Call retry callback if provided
+                    if (opts.onRetry) {
+                        opts.onRetry(attempt + 1, lastError);
+                    }
+                    // Wait before retrying
+                    await this.delay(delay);
+                }
+                else {
+                    // Non-transient error or max retries reached
+                    if (attempt >= opts.maxRetries) {
+                        this.logger.error(`Operation failed after ${opts.maxRetries} retries`, lastError);
+                    }
+                    throw lastError;
+                }
+            }
+        }
+        // Should never reach here, but TypeScript needs this
+        throw lastError || new Error('Operation failed with unknown error');
+    }
+    /**
+     * Check if an error is transient (retryable)
+     */
+    static isTransient(error) {
+        const message = error.message.toLowerCase();
+        // Network-related errors
+        const networkErrors = [
+            'econnrefused',
+            'econnreset',
+            'etimedout',
+            'enotfound',
+            'enetunreach',
+            'socket hang up',
+            'network error',
+            'fetch failed',
+        ];
+        // API rate limiting
+        const rateLimitErrors = ['rate limit', 'too many requests', '429'];
+        // Temporary server errors
+        const serverErrors = ['503', 'service unavailable', 'gateway timeout', '504'];
+        // Git-specific transient errors
+        const gitErrors = ['lock', 'unable to access', 'could not resolve host'];
+        const allTransientPatterns = [
+            ...networkErrors,
+            ...rateLimitErrors,
+            ...serverErrors,
+            ...gitErrors,
+        ];
+        return allTransientPatterns.some((pattern) => message.includes(pattern));
+    }
+    /**
+     * Format an error for display
+     */
+    static formatError(error) {
+        if (error instanceof MCPError) {
+            const parts = [`[${error.code}] ${error.message}`];
+            if (error.details && Object.keys(error.details).length > 0) {
+                parts.push(`Details: ${JSON.stringify(error.details, null, 2)}`);
+            }
+            if (error.cause) {
+                parts.push(`Caused by: ${error.cause.message}`);
+            }
+            return parts.join('\n');
+        }
+        return error.message;
+    }
+    /**
+     * Create an MCPError from a generic error
+     */
+    static toMCPError(error, code, details) {
+        if (error instanceof MCPError) {
+            return error;
+        }
+        if (error instanceof Error) {
+            return new MCPError(error.message, code, details, error);
+        }
+        return new MCPError(String(error), code, details);
+    }
+    /**
+     * Wrap an operation with error handling
+     */
+    static async wrap(operation, errorCode, _errorMessage, details) {
+        try {
+            return await operation();
+        }
+        catch (error) {
+            throw this.toMCPError(error, errorCode, {
+                ...details,
+                originalMessage: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    /**
+     * Delay execution for a specified time
+     */
+    static delay(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+    /**
+     * Create a configuration error
+     */
+    static configurationError(message, details) {
+        return new MCPError(message, ErrorCategory.CONFIGURATION, details);
+    }
+    /**
+     * Create a validation error
+     */
+    static validationError(message, details) {
+        return new MCPError(message, ErrorCategory.VALIDATION, details);
+    }
+    /**
+     * Create a git operation error
+     */
+    static gitOperationError(message, details, cause) {
+        return new MCPError(message, ErrorCategory.GIT_OPERATION, details, cause);
+    }
+    /**
+     * Create an API call error
+     */
+    static apiCallError(message, details, cause) {
+        return new MCPError(message, ErrorCategory.API_CALL, details, cause);
+    }
+    /**
+     * Create a not found error
+     */
+    static notFoundError(message, details) {
+        return new MCPError(message, ErrorCategory.NOT_FOUND, details);
+    }
+    /**
+     * Create a permission error
+     */
+    static permissionError(message, details) {
+        return new MCPError(message, ErrorCategory.PERMISSION, details);
+    }
+}
+//# sourceMappingURL=error-handler.js.map

package/dist/errors/error-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.js","sourceRoot":"","sources":["../../src/errors/error-handler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAEtD;;GAEG;AACH,MAAM,OAAO,QAAS,SAAQ,KAAK;IAWxB;IACA;IACA;IAZT;;;;;;;OAOG;IACH,YACE,OAAe,EACR,IAAY,EACZ,OAAiC,EACjC,KAAa;QAEpB,KAAK,CAAC,OAAO,CAAC,CAAC;QAJR,SAAI,GAAJ,IAAI,CAAQ;QACZ,YAAO,GAAP,OAAO,CAA0B;QACjC,UAAK,GAAL,KAAK,CAAQ;QAGpB,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QAEvB,oFAAoF;QACpF,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,OAAO;YAC1B,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC;IACJ,CAAC;CACF;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,aASX;AATD,WAAY,aAAa;IACvB,gDAA+B,CAAA;IAC/B,0CAAyB,CAAA;IACzB,gDAA+B,CAAA;IAC/B,sCAAqB,CAAA;IACrB,oCAAmB,CAAA;IACnB,0CAAyB,CAAA;IACzB,wCAAuB,CAAA;IACvB,sCAAqB,CAAA;AACvB,CAAC,EATW,aAAa,KAAb,aAAa,QASxB;AAiBD;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAiB;IACjD,UAAU,EAAE,CAAC;IACb,OAAO,EAAE,IAAI;IACb,iBAAiB,EAAE,CAAC;CACrB,CAAC;AAEF;;GAEG;AACH,MAAM,OAAO,YAAY;IACf,MAAM,CAAC,MAAM,GAAG,IAAI,MAAM,CAAC,cAAc,CAAC,CAAC;IAEnD;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,SAAS,CACpB,SAA2B,EAC3B,UAAiC,EAAE;QAEnC,MAAM,IAAI,GAAiB,EAAE,GAAG,qBAAqB,EAAE,GAAG,OAAO,EAAE,CAAC;QACpE,IAAI,SAA4B,CAAC;QAEjC,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,IAAI,CAAC,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;YAC5D,IAAI,CAAC;gBACH,OAAO,MAAM,SAAS,EAAE,CAAC;YAC3B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,SAAS,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;gBAEtE,kDAAkD;gBAClD,IAAI,OAAO,GAAG,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE,CAAC;oBAC7D,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAC;oBAEvE,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,uCAAuC,OAAO,GAAG,CAAC,IAAI,IAAI,CAAC,UAAU,GAAG,EACxE;wBACE,KAAK,EAAE,SAAS,CAAC,OAAO;wBACxB,KAAK;wBACL,OAAO,EAAE,OAAO,GAAG,CAAC;wBACpB,UAAU,EAAE,IAAI,CAAC,UAAU;qBAC5B,CACF,CAAC;oBAEF,kCAAkC;oBAClC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;wBACjB,IAAI,CAAC,OAAO,CAAC,OAAO,GAAG,CAAC,EAAE,SAAS,CAAC,CAAC;oBACvC,CAAC;oBAED,uBAAuB;oBACvB,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBAC1B,CAAC;qBAAM,CAAC;oBACN,6CAA6C;oBAC7C,IAAI,OAAO,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;wBAC/B,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,0BAA0B,IAAI,CAAC,UAAU,UAAU,EACnD,SAAS,CACV,CAAC;oBACJ,CAAC;oBACD,MAAM,SAAS,CAAC;gBAClB,CAAC;YACH,CAAC;QACH,CAAC;QAED,qDAAqD;QACrD,MAAM,SAAS,IAAI,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACtE,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,KAAY;QAC7B,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;QAE5C,yBAAyB;QACzB,MAAM,aAAa,GAAG;YACpB,cAAc;YACd,YAAY;YACZ,WAAW;YACX,WAAW;YACX,aAAa;YACb,gBAAgB;YAChB,eAAe;YACf,cAAc;SACf,CAAC;QAEF,oBAAoB;QACpB,MAAM,eAAe,GAAG,CAAC,YAAY,EAAE,mBAAmB,EAAE,KAAK,CAAC,CAAC;QAEnE,0BAA0B;QAC1B,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,KAAK,CAAC,CAAC;QAE9E,gCAAgC;QAChC,MAAM,SAAS,GAAG,CAAC,MAAM,EAAE,kBAAkB,EAAE,wBAAwB,CAAC,CAAC;QAEzE,MAAM,oBAAoB,GAAG;YAC3B,GAAG,aAAa;YAChB,GAAG,eAAe;YAClB,GAAG,YAAY;YACf,GAAG,SAAS;SACb,CAAC;QAEF,OAAO,oBAAoB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;IAC3E,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,KAAY;QAC7B,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;YAC9B,MAAM,KAAK,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YAEnD,IAAI,KAAK,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC3D,KAAK,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;YACnE,CAAC;YAED,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;gBAChB,KAAK,CAAC,IAAI,CAAC,cAAc,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YAClD,CAAC;YAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;QAED,OAAO,KAAK,CAAC,OAAO,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,UAAU,CACf,KAAc,EACd,IAAY,EACZ,OAAiC;QAEjC,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;YAC9B,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAC3B,OAAO,IAAI,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;QAC3D,CAAC;QAED,OAAO,IAAI,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACpD,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,IAAI,CACf,SAA2B,EAC3B,SAAiB,EACjB,aAAqB,EACrB,OAAiC;QAEjC,IAAI,CAAC;YACH,OAAO,MAAM,SAAS,EAAE,CAAC;QAC3B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE;gBACtC,GAAG,OAAO;gBACV,eAAe,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aACxE,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,KAAK,CAAC,EAAU;QAC7B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;IAC3D,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,kBAAkB,CACvB,OAAe,EACf,OAAiC;QAEjC,OAAO,IAAI,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IACrE,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,eAAe,CACpB,OAAe,EACf,OAAiC;QAEjC,OAAO,IAAI,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAClE,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,iBAAiB,CACtB,OAAe,EACf,OAAiC,EACjC,KAAa;QAEb,OAAO,IAAI,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,aAAa,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IAC5E,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,YAAY,CACjB,OAAe,EACf,OAAiC,EACjC,KAAa;QAEb,OAAO,IAAI,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IACvE,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,aAAa,CAClB,OAAe,EACf,OAAiC;QAEjC,OAAO,IAAI,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACjE,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,eAAe,CACpB,OAAe,EACf,OAAiC;QAEjC,OAAO,IAAI,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAClE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,139 @@
+/**
+ * GitLab Auto-Reviewers Shared Library
+ *
+ * A comprehensive library for intelligent GitLab merge request reviewer suggestions.
+ * Provides data sources, services, and utilities for analyzing git history, team
+ * membership, code ownership, and reviewer workload to suggest optimal reviewers.
+ *
+ * @module gitlab-auto-reviewers
+ * @packageDocumentation
+ */
+/**
+ * Core data source interface for accessing git and GitLab data
+ * @see {@link GitDataSource}
+ */
+export { GitDataSource } from './datasources/git-data-source.interface.js';
+/**
+ * GitLab API-based data source implementation
+ * Uses GitLab REST API for all operations (stateless, no local repository required)
+ * @see {@link GitLabAPIDataSource}
+ */
+export { GitLabAPIDataSource } from './datasources/gitlab-api-data-source.js';
+/**
+ * Local git repository data source implementation
+ * Uses local git commands for faster operations, falls back to API when needed
+ * @see {@link LocalGitDataSource}
+ */
+export { LocalGitDataSource } from './datasources/local-git-data-source.js';
+/**
+ * Main service for suggesting and managing merge request reviewers
+ * Orchestrates multiple analysis strategies (contributors, team members, code owners)
+ * @see {@link ReviewerService}
+ */
+export { ReviewerService } from './services/reviewer-service.js';
+/**
+ * Service for analyzing previous contributors to modified code
+ * Uses git blame to identify who has worked on the changed files
+ * @see {@link ContributorsService}
+ */
+export { ContributorsService } from './services/contributors.service.js';
+/**
+ * Service for managing code ownership rules from CODEOWNERS file
+ * Matches changed files to code owner patterns and applies approval requirements
+ * @see {@link CodeOwnersService}
+ */
+export { CodeOwnersService } from './services/codeowners.service.js';
+/**
+ * Service for managing team membership and FTE-aware load balancing
+ * Distributes review assignments fairly based on team member availability
+ * @see {@link TeamMembersService}
+ */
+export { TeamMembersService } from './services/team-members.service.js';
+/**
+ * Service for managing reviewer blacklist (exclusions)
+ * Filters out reviewers who should not be suggested (e.g., MR author, inactive users)
+ * @see {@link BlacklistService}
+ */
+export { BlacklistService } from './services/blacklist.service.js';
+/**
+ * Service for managing reviewer whitelist (eligible reviewers)
+ * Defines the pool of eligible reviewers with team membership and FTE information
+ * @see {@link WhitelistService}
+ */
+export { WhitelistService } from './services/whitelist.service.js';
+/**
+ * Service for building formatted reviewer suggestion comments
+ * Generates markdown comments for posting to GitLab merge requests
+ * @see {@link CommentBuilderService}
+ */
+export { CommentBuilderService } from './services/comment-builder.service.js';
+/**
+ * GitLab REST API client
+ * Handles HTTP communication with GitLab API including authentication and error handling
+ * @see {@link GitLabAPI}
+ */
+export { GitLabAPI } from './api/gitlab-api.js';
+/**
+ * Configuration service for managing application settings
+ * Handles environment variables, defaults, and configuration validation
+ * @see {@link ConfigService}
+ */
+export { ConfigService } from './config/config.service.js';
+/**
+ * Structured logging service with multiple log levels
+ * Provides contextual logging with child loggers and performance timing
+ * @see {@link Logger}
+ */
+export { Logger } from './logging/logger.service.js';
+/**
+ * Log level enumeration
+ * @see {@link LogLevel}
+ */
+export { LogLevel } from './logging/logger.service.js';
+/**
+ * In-memory caching service with TTL support
+ * Improves performance by caching API responses and git operations
+ * @see {@link CacheService}
+ */
+export { CacheService } from './cache/cache.service.js';
+/**
+ * Error handling utilities and custom error types
+ * Provides consistent error handling across the library
+ * @see {@link ErrorHandler}
+ */
+export { ErrorHandler } from './errors/error-handler.js';
+/**
+ * Custom error class for MCP-specific errors
+ * @see {@link MCPError}
+ */
+export { MCPError } from './errors/error-handler.js';
+/**
+ * Error category enumeration
+ * @see {@link ErrorCategory}
+ */
+export { ErrorCategory } from './errors/error-handler.js';
+/**
+ * GitLab API response types
+ */
+export type { GitLabUser, MergeRequest, DiffRefs, MergeRequestDiff, BlameLine, GitLabBranch, GitLabCommit, GitLabNote, } from './types/index.js';
+/**
+ * Reviewer suggestion types
+ */
+export type { ReviewerSuggestion, ContributorWithChanges, CodeOwnerGroup, TeamMember, TeamMemberWithScore, LoadBalancedTeam, CodeOwnerWithScores, ReviewerAnalysisResult, } from './types/index.js';
+/**
+ * Parameter types for service methods
+ */
+export type { PostCommentParams, InviteReviewersParams, } from './types/index.js';
+/**
+ * Type guards for runtime type checking
+ */
+export { isMergeRequest, isGitLabUser, isBlameLine, isGitLabBranch, isGitLabNote, isMergeRequestDiff, } from './types/index.js';
+/**
+ * MCP tool parameter and result types
+ */
+export type { AutoReviewerParams, AutoReviewerResult, ContributorAnalysisParams, WorkloadAnalysisParams, Contributor, } from './types.js';
+/**
+ * Default export provides the main ReviewerService for convenience
+ */
+export { ReviewerService as default } from './services/reviewer-service.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH;;;GAGG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,4CAA4C,CAAC;AAE3E;;;;GAIG;AACH,OAAO,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAE9E;;;;GAIG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AAM5E;;;;GAIG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEjE;;;;GAIG;AACH,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAEzE;;;;GAIG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAErE;;;;GAIG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAExE;;;;GAIG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAEnE;;;;GAIG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAEnE;;;;GAIG;AACH,OAAO,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAM9E;;;;GAIG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAMhD;;;;GAIG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAM3D;;;;GAIG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAErD;;;GAGG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAMvD;;;;GAIG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAMxD;;;;GAIG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzD;;;GAGG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAErD;;;GAGG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAM1D;;GAEG;AACH,YAAY,EACV,UAAU,EACV,YAAY,EACZ,QAAQ,EACR,gBAAgB,EAChB,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,UAAU,GACX,MAAM,kBAAkB,CAAC;AAE1B;;GAEG;AACH,YAAY,EACV,kBAAkB,EAClB,sBAAsB,EACtB,cAAc,EACd,UAAU,EACV,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,kBAAkB,CAAC;AAE1B;;GAEG;AACH,YAAY,EACV,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAE1B;;GAEG;AACH,OAAO,EACL,cAAc,EACd,YAAY,EACZ,WAAW,EACX,cAAc,EACd,YAAY,EACZ,kBAAkB,GACnB,MAAM,kBAAkB,CAAC;AAE1B;;GAEG;AACH,YAAY,EACV,kBAAkB,EAClB,kBAAkB,EAClB,yBAAyB,EACzB,sBAAsB,EACtB,WAAW,GACZ,MAAM,YAAY,CAAC;AAMpB;;GAEG;AACH,OAAO,EAAE,eAAe,IAAI,OAAO,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/index.js

@@ -0,0 +1,139 @@
+/**
+ * GitLab Auto-Reviewers Shared Library
+ *
+ * A comprehensive library for intelligent GitLab merge request reviewer suggestions.
+ * Provides data sources, services, and utilities for analyzing git history, team
+ * membership, code ownership, and reviewer workload to suggest optimal reviewers.
+ *
+ * @module gitlab-auto-reviewers
+ * @packageDocumentation
+ */
+/**
+ * GitLab API-based data source implementation
+ * Uses GitLab REST API for all operations (stateless, no local repository required)
+ * @see {@link GitLabAPIDataSource}
+ */
+export { GitLabAPIDataSource } from './datasources/gitlab-api-data-source.js';
+/**
+ * Local git repository data source implementation
+ * Uses local git commands for faster operations, falls back to API when needed
+ * @see {@link LocalGitDataSource}
+ */
+export { LocalGitDataSource } from './datasources/local-git-data-source.js';
+// ============================================================================
+// Services
+// ============================================================================
+/**
+ * Main service for suggesting and managing merge request reviewers
+ * Orchestrates multiple analysis strategies (contributors, team members, code owners)
+ * @see {@link ReviewerService}
+ */
+export { ReviewerService } from './services/reviewer-service.js';
+/**
+ * Service for analyzing previous contributors to modified code
+ * Uses git blame to identify who has worked on the changed files
+ * @see {@link ContributorsService}
+ */
+export { ContributorsService } from './services/contributors.service.js';
+/**
+ * Service for managing code ownership rules from CODEOWNERS file
+ * Matches changed files to code owner patterns and applies approval requirements
+ * @see {@link CodeOwnersService}
+ */
+export { CodeOwnersService } from './services/codeowners.service.js';
+/**
+ * Service for managing team membership and FTE-aware load balancing
+ * Distributes review assignments fairly based on team member availability
+ * @see {@link TeamMembersService}
+ */
+export { TeamMembersService } from './services/team-members.service.js';
+/**
+ * Service for managing reviewer blacklist (exclusions)
+ * Filters out reviewers who should not be suggested (e.g., MR author, inactive users)
+ * @see {@link BlacklistService}
+ */
+export { BlacklistService } from './services/blacklist.service.js';
+/**
+ * Service for managing reviewer whitelist (eligible reviewers)
+ * Defines the pool of eligible reviewers with team membership and FTE information
+ * @see {@link WhitelistService}
+ */
+export { WhitelistService } from './services/whitelist.service.js';
+/**
+ * Service for building formatted reviewer suggestion comments
+ * Generates markdown comments for posting to GitLab merge requests
+ * @see {@link CommentBuilderService}
+ */
+export { CommentBuilderService } from './services/comment-builder.service.js';
+// ============================================================================
+// API Client
+// ============================================================================
+/**
+ * GitLab REST API client
+ * Handles HTTP communication with GitLab API including authentication and error handling
+ * @see {@link GitLabAPI}
+ */
+export { GitLabAPI } from './api/gitlab-api.js';
+// ============================================================================
+// Configuration
+// ============================================================================
+/**
+ * Configuration service for managing application settings
+ * Handles environment variables, defaults, and configuration validation
+ * @see {@link ConfigService}
+ */
+export { ConfigService } from './config/config.service.js';
+// ============================================================================
+// Logging
+// ============================================================================
+/**
+ * Structured logging service with multiple log levels
+ * Provides contextual logging with child loggers and performance timing
+ * @see {@link Logger}
+ */
+export { Logger } from './logging/logger.service.js';
+/**
+ * Log level enumeration
+ * @see {@link LogLevel}
+ */
+export { LogLevel } from './logging/logger.service.js';
+// ============================================================================
+// Caching
+// ============================================================================
+/**
+ * In-memory caching service with TTL support
+ * Improves performance by caching API responses and git operations
+ * @see {@link CacheService}
+ */
+export { CacheService } from './cache/cache.service.js';
+// ============================================================================
+// Error Handling
+// ============================================================================
+/**
+ * Error handling utilities and custom error types
+ * Provides consistent error handling across the library
+ * @see {@link ErrorHandler}
+ */
+export { ErrorHandler } from './errors/error-handler.js';
+/**
+ * Custom error class for MCP-specific errors
+ * @see {@link MCPError}
+ */
+export { MCPError } from './errors/error-handler.js';
+/**
+ * Error category enumeration
+ * @see {@link ErrorCategory}
+ */
+export { ErrorCategory } from './errors/error-handler.js';
+/**
+ * Type guards for runtime type checking
+ */
+export { isMergeRequest, isGitLabUser, isBlameLine, isGitLabBranch, isGitLabNote, isMergeRequestDiff, } from './types/index.js';
+// ============================================================================
+// Default Export
+// ============================================================================
+/**
+ * Default export provides the main ReviewerService for convenience
+ */
+export { ReviewerService as default } from './services/reviewer-service.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAYH;;;;GAIG;AACH,OAAO,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAE9E;;;;GAIG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AAE5E,+EAA+E;AAC/E,WAAW;AACX,+EAA+E;AAE/E;;;;GAIG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEjE;;;;GAIG;AACH,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAEzE;;;;GAIG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAErE;;;;GAIG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAExE;;;;GAIG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAEnE;;;;GAIG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAEnE;;;;GAIG;AACH,OAAO,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAE9E,+EAA+E;AAC/E,aAAa;AACb,+EAA+E;AAE/E;;;;GAIG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhD,+EAA+E;AAC/E,gBAAgB;AAChB,+EAA+E;AAE/E;;;;GAIG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE3D,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E;;;;GAIG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAErD;;;GAGG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAEvD,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E;;;;GAIG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD,+EAA+E;AAC/E,iBAAiB;AACjB,+EAA+E;AAE/E;;;;GAIG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzD;;;GAGG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAErD;;;GAGG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AA0C1D;;GAEG;AACH,OAAO,EACL,cAAc,EACd,YAAY,EACZ,WAAW,EACX,cAAc,EACd,YAAY,EACZ,kBAAkB,GACnB,MAAM,kBAAkB,CAAC;AAa1B,+EAA+E;AAC/E,iBAAiB;AACjB,+EAA+E;AAE/E;;GAEG;AACH,OAAO,EAAE,eAAe,IAAI,OAAO,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/logging/example.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Logger Usage Examples
+ *
+ * This file demonstrates how to use the Logger service.
+ * It is not part of the production code.
+ */
+declare function basicLoggingExample(): void;
+declare function contextLoggingExample(): void;
+declare function performanceTimingExample(): Promise<void>;
+declare function childLoggerExample(): void;
+declare function errorLoggingExample(): void;
+declare function logLevelFilteringExample(): void;
+declare function parseLogLevelExample(): void;
+export { basicLoggingExample, contextLoggingExample, performanceTimingExample, childLoggerExample, errorLoggingExample, logLevelFilteringExample, parseLogLevelExample, };
+//# sourceMappingURL=example.d.ts.map

package/dist/logging/example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.d.ts","sourceRoot":"","sources":["../../src/logging/example.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,iBAAS,mBAAmB,IAAI,IAAI,CAOnC;AAGD,iBAAS,qBAAqB,IAAI,IAAI,CAerC;AAGD,iBAAe,wBAAwB,IAAI,OAAO,CAAC,IAAI,CAAC,CASvD;AAGD,iBAAS,kBAAkB,IAAI,IAAI,CAQlC;AAGD,iBAAS,mBAAmB,IAAI,IAAI,CAYnC;AAGD,iBAAS,wBAAwB,IAAI,IAAI,CAQxC;AAGD,iBAAS,oBAAoB,IAAI,IAAI,CAMpC;AAED,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,wBAAwB,EACxB,kBAAkB,EAClB,mBAAmB,EACnB,wBAAwB,EACxB,oBAAoB,GACrB,CAAC"}