@xopcai/xopcbot 0.1.0

package/dist/errors/__tests__/index.test.js

@@ -0,0 +1,301 @@
+import { describe, it, expect } from 'vitest';
+import { XopcbotError, UserError, ConfigError, SystemError, NetworkError, ProviderError, isXopcbotError, isUserError, isConfigError, isProviderError, isRetryable, wrapError, formatErrorForUser, formatErrorForLog, } from '../index.js';
+describe('XopcbotError', () => {
+    it('should create base error with all properties', () => {
+        const error = new XopcbotError({
+            code: 'TEST_001',
+            category: 'system',
+            message: 'Test error',
+            suggestion: 'Try again',
+            retryable: true,
+        });
+        expect(error.code).toBe('TEST_001');
+        expect(error.category).toBe('system');
+        expect(error.message).toBe('Test error');
+        expect(error.suggestion).toBe('Try again');
+        expect(error.retryable).toBe(true);
+    });
+    it('should format user message', () => {
+        const error = new XopcbotError({
+            code: 'TEST',
+            category: 'user',
+            message: 'Something went wrong',
+            suggestion: 'Fix it',
+        });
+        const msg = error.toUserMessage();
+        expect(msg).toContain('❌');
+        expect(msg).toContain('Something went wrong');
+        expect(msg).toContain('💡');
+        expect(msg).toContain('Fix it');
+    });
+    it('should format log object', () => {
+        const error = new XopcbotError({
+            code: 'TEST',
+            category: 'system',
+            message: 'Error',
+        });
+        const log = error.toLogObject();
+        expect(log.code).toBe('TEST');
+        expect(log.category).toBe('system');
+        expect(log.message).toBe('Error');
+    });
+});
+describe('UserError', () => {
+    it('should create user error', () => {
+        const error = new UserError('INVALID', 'Invalid input', 'Try again');
+        expect(error.code).toBe('USER_INVALID');
+        expect(error.category).toBe('user');
+        expect(error.retryable).toBe(false);
+    });
+    it('should create invalidCommand error', () => {
+        const error = UserError.invalidCommand('/unknown');
+        expect(error.code).toBe('USER_INVALID_COMMAND');
+        expect(error.message).toContain('/unknown');
+        expect(error.suggestion).toContain('/help');
+    });
+    it('should create invalidInput error', () => {
+        const error = UserError.invalidInput('Missing field', 'Add the field');
+        expect(error.code).toBe('USER_INVALID_INPUT');
+        expect(error.message).toBe('Missing field');
+        expect(error.suggestion).toBe('Add the field');
+    });
+    it('should create unauthorized error', () => {
+        const error = UserError.unauthorized();
+        expect(error.code).toBe('USER_UNAUTHORIZED');
+        expect(error.message).toContain('not authorized');
+    });
+});
+describe('ConfigError', () => {
+    it('should create config error', () => {
+        const error = new ConfigError('INVALID', 'Invalid config', 'Fix it');
+        expect(error.code).toBe('CONFIG_INVALID');
+        expect(error.category).toBe('config');
+    });
+    it('should create missingApiKey error', () => {
+        const error = ConfigError.missingApiKey('openai');
+        expect(error.code).toBe('CONFIG_MISSING_API_KEY');
+        expect(error.message).toContain('openai');
+        expect(error.message).toContain('API key');
+        expect(error.suggestion).toContain('OPENAI_API_KEY');
+    });
+    it('should create invalidConfig error', () => {
+        const error = ConfigError.invalidConfig('providers.openai', 'missing baseUrl');
+        expect(error.code).toBe('CONFIG_INVALID_CONFIG');
+        expect(error.message).toContain('providers.openai');
+    });
+    it('should create missingConfig error', () => {
+        const error = ConfigError.missingConfig('model');
+        expect(error.code).toBe('CONFIG_MISSING_CONFIG');
+        expect(error.message).toContain('model');
+    });
+});
+describe('SystemError', () => {
+    it('should create system error', () => {
+        const error = new SystemError('FAILURE', 'System failed', true, 'Retry');
+        expect(error.code).toBe('SYSTEM_FAILURE');
+        expect(error.category).toBe('system');
+        expect(error.retryable).toBe(true);
+    });
+    it('should create internal error', () => {
+        const cause = new Error('Original');
+        const error = SystemError.internal('Something broke', cause);
+        expect(error.code).toBe('SYSTEM_INTERNAL');
+        expect(error.retryable).toBe(false);
+        expect(error.cause).toBe(cause);
+    });
+    it('should create filesystem error', () => {
+        const cause = new Error('Permission denied');
+        const error = SystemError.filesystem('/path', 'read', cause);
+        expect(error.code).toBe('SYSTEM_FILESYSTEM');
+        expect(error.retryable).toBe(true);
+        expect(error.message).toContain('/path');
+        expect(error.message).toContain('read');
+    });
+    it('should create outOfMemory error', () => {
+        const error = SystemError.outOfMemory();
+        expect(error.code).toBe('SYSTEM_OUT_OF_MEMORY');
+        expect(error.retryable).toBe(true);
+    });
+});
+describe('NetworkError', () => {
+    it('should create network error', () => {
+        const error = new NetworkError('FAILURE', 'Network failed');
+        expect(error.code).toBe('NET_FAILURE');
+        expect(error.category).toBe('network');
+        expect(error.retryable).toBe(true);
+    });
+    it('should create timeout error', () => {
+        const error = NetworkError.timeout('api.example.com', 5000);
+        expect(error.code).toBe('NET_TIMEOUT');
+        expect(error.message).toContain('api.example.com');
+        expect(error.message).toContain('5000ms');
+    });
+    it('should create connectionFailed error', () => {
+        const error = NetworkError.connectionFailed('api.example.com');
+        expect(error.code).toBe('NET_CONNECTION_FAILED');
+        expect(error.message).toContain('api.example.com');
+    });
+});
+describe('ProviderError', () => {
+    it('should create provider error', () => {
+        const error = new ProviderError('openai', 'ERROR', 'Something wrong');
+        expect(error.code).toBe('PROVIDER_OPENAI_ERROR');
+        expect(error.provider).toBe('openai');
+    });
+    it('should create rateLimit error', () => {
+        const error = ProviderError.rateLimit('openai', 60, 'gpt-4');
+        expect(error.code).toBe('PROVIDER_OPENAI_RATE_LIMIT');
+        expect(error.statusCode).toBe(429);
+        expect(error.model).toBe('gpt-4');
+        expect(error.suggestion).toContain('60');
+    });
+    it('should create rateLimit error without retryAfter', () => {
+        const error = ProviderError.rateLimit('openai');
+        expect(error.suggestion).toContain('Retry');
+        expect(error.suggestion).not.toContain('seconds');
+    });
+    it('should create authFailed error', () => {
+        const cause = new Error('401');
+        const error = ProviderError.authFailed('anthropic', cause);
+        expect(error.code).toBe('PROVIDER_ANTHROPIC_AUTH_FAILED');
+        expect(error.statusCode).toBe(401);
+        expect(error.cause).toBe(cause);
+    });
+    it('should create modelNotFound error', () => {
+        const error = ProviderError.modelNotFound('google', 'gemini-100');
+        expect(error.code).toBe('PROVIDER_GOOGLE_MODEL_NOT_FOUND');
+        expect(error.message).toContain('gemini-100');
+    });
+    it('should create overloaded error', () => {
+        const error = ProviderError.overloaded('openai', 'gpt-4');
+        expect(error.code).toBe('PROVIDER_OPENAI_OVERLOADED');
+        expect(error.statusCode).toBe(503);
+        expect(error.retryable).toBe(true);
+    });
+    it('should create insufficientFunds error', () => {
+        const error = ProviderError.insufficientFunds('openai');
+        expect(error.code).toBe('PROVIDER_OPENAI_INSUFFICIENT_FUNDS');
+        expect(error.retryable).toBe(false);
+    });
+});
+describe('Type guards', () => {
+    it('isXopcbotError should return true for XopcbotError', () => {
+        expect(isXopcbotError(new UserError('TEST', 'test'))).toBe(true);
+        expect(isXopcbotError(new Error())).toBe(false);
+        expect(isXopcbotError('string')).toBe(false);
+        expect(isXopcbotError(null)).toBe(false);
+    });
+    it('isUserError should return true only for UserError', () => {
+        expect(isUserError(new UserError('TEST', 'test'))).toBe(true);
+        expect(isUserError(new ConfigError('TEST', 'test'))).toBe(false);
+        expect(isUserError(new Error())).toBe(false);
+    });
+    it('isConfigError should return true only for ConfigError', () => {
+        expect(isConfigError(new ConfigError('TEST', 'test'))).toBe(true);
+        expect(isConfigError(new UserError('TEST', 'test'))).toBe(false);
+    });
+    it('isProviderError should return true only for ProviderError', () => {
+        expect(isProviderError(new ProviderError('test', 'CODE', 'msg'))).toBe(true);
+        expect(isProviderError(new SystemError('CODE', 'msg'))).toBe(false);
+    });
+});
+describe('isRetryable', () => {
+    it('should return retryable for XopcbotError', () => {
+        const retryable = new SystemError('TEST', 'test', true);
+        const notRetryable = new UserError('TEST', 'test');
+        expect(isRetryable(retryable)).toBe(true);
+        expect(isRetryable(notRetryable)).toBe(false);
+    });
+    it('should detect retryable from error message', () => {
+        expect(isRetryable(new Error('Connection timeout'))).toBe(true);
+        expect(isRetryable(new Error('ECONNRESET'))).toBe(true);
+        expect(isRetryable(new Error('ENOTFOUND'))).toBe(true);
+        expect(isRetryable(new Error('ECONNREFUSED'))).toBe(true);
+    });
+    it('should return false for unknown errors', () => {
+        expect(isRetryable('string')).toBe(false);
+        expect(isRetryable(null)).toBe(false);
+        expect(isRetryable(new Error('Some random error'))).toBe(false);
+    });
+});
+describe('wrapError', () => {
+    it('should return XopcbotError as-is', () => {
+        const original = new UserError('TEST', 'test');
+        const wrapped = wrapError(original);
+        expect(wrapped).toBe(original);
+    });
+    it('should wrap api key errors as ProviderError', () => {
+        const error = new Error('Invalid API key provided');
+        const wrapped = wrapError(error);
+        expect(isProviderError(wrapped)).toBe(true);
+        expect(wrapped.code).toContain('AUTH_FAILED');
+    });
+    it('should wrap timeout errors as NetworkError', () => {
+        const error = new Error('Request ETIMEDOUT');
+        const wrapped = wrapError(error);
+        expect(wrapped.code).toBe('NET_TIMEOUT');
+    });
+    it('should wrap rate limit errors as ProviderError', () => {
+        const error = new Error('429 rate limit exceeded');
+        const wrapped = wrapError(error);
+        expect(isProviderError(wrapped)).toBe(true);
+    });
+    it('should wrap unknown errors as SystemError', () => {
+        const error = new Error('Something weird');
+        const wrapped = wrapError(error, 'Context');
+        expect(wrapped.code).toBe('SYSTEM_INTERNAL');
+        expect(wrapped.message).toContain('Context');
+        expect(wrapped.cause).toBe(error);
+    });
+    it('should handle string errors', () => {
+        const wrapped = wrapError('something broke');
+        expect(wrapped.code).toBe('SYSTEM_INTERNAL');
+        expect(wrapped.message).toContain('something broke');
+    });
+    it('should handle null errors', () => {
+        const wrapped = wrapError(null);
+        expect(wrapped.code).toBe('SYSTEM_INTERNAL');
+    });
+});
+describe('formatErrorForUser', () => {
+    it('should format XopcbotError with suggestion', () => {
+        const error = new UserError('TEST', 'Something wrong', 'Do this');
+        const formatted = formatErrorForUser(error);
+        expect(formatted).toContain('❌');
+        expect(formatted).toContain('Something wrong');
+        expect(formatted).toContain('💡');
+        expect(formatted).toContain('Do this');
+    });
+    it('should format regular Error', () => {
+        const error = new Error('Regular error');
+        const formatted = formatErrorForUser(error);
+        expect(formatted).toContain('❌');
+        expect(formatted).toContain('Regular error');
+    });
+    it('should handle unknown errors', () => {
+        const formatted = formatErrorForUser(12345);
+        expect(formatted).toContain('❌');
+        expect(formatted).toContain('12345');
+    });
+});
+describe('formatErrorForLog', () => {
+    it('should format XopcbotError', () => {
+        const error = new UserError('TEST', 'message');
+        const formatted = formatErrorForLog(error);
+        expect(formatted.code).toBe('USER_TEST');
+        expect(formatted.category).toBe('user');
+    });
+    it('should format regular Error', () => {
+        const error = new Error('test');
+        error.stack = 'stack trace';
+        const formatted = formatErrorForLog(error);
+        expect(formatted.name).toBe('Error');
+        expect(formatted.message).toBe('test');
+        expect(formatted.stack).toBe('stack trace');
+    });
+    it('should handle primitives', () => {
+        const formatted = formatErrorForLog('string error');
+        expect(formatted.error).toBe('string error');
+    });
+});
+//# sourceMappingURL=index.test.js.map

package/dist/errors/__tests__/index.test.js.map

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

package/dist/errors/index.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Error classification system for xopcbot
+ *
+ * Provides structured error types for better handling and user feedback.
+ */
+export type ErrorCategory = 'user' | 'config' | 'system' | 'network' | 'provider';
+declare const XOPCBOT_ERROR_MARKER: unique symbol;
+declare const USER_ERROR_MARKER: unique symbol;
+declare const CONFIG_ERROR_MARKER: unique symbol;
+declare const SYSTEM_ERROR_MARKER: unique symbol;
+declare const NETWORK_ERROR_MARKER: unique symbol;
+declare const PROVIDER_ERROR_MARKER: unique symbol;
+export interface ErrorDetails {
+    code: string;
+    category: ErrorCategory;
+    message: string;
+    suggestion?: string;
+    retryable?: boolean;
+}
+/**
+ * Base error class for all xopcbot errors
+ */
+export declare class XopcbotError extends Error {
+    readonly [XOPCBOT_ERROR_MARKER] = true;
+    readonly code: string;
+    readonly category: ErrorCategory;
+    readonly retryable: boolean;
+    readonly suggestion?: string;
+    readonly cause?: Error;
+    constructor(details: ErrorDetails, cause?: Error);
+    /**
+     * Format error for user display
+     */
+    toUserMessage(): string;
+    /**
+     * Format error for logging
+     */
+    toLogObject(): Record<string, unknown>;
+}
+/**
+ * User input/operation errors - caused by user actions
+ */
+export declare class UserError extends XopcbotError {
+    readonly [USER_ERROR_MARKER] = true;
+    constructor(code: string, message: string, suggestion?: string, cause?: Error);
+    static invalidCommand(command: string): UserError;
+    static invalidInput(message: string, suggestion?: string): UserError;
+    static unauthorized(message?: string): UserError;
+}
+/**
+ * Configuration errors - caused by invalid/missing config
+ */
+export declare class ConfigError extends XopcbotError {
+    readonly [CONFIG_ERROR_MARKER] = true;
+    constructor(code: string, message: string, suggestion?: string, cause?: Error);
+    static missingApiKey(provider: string): ConfigError;
+    static invalidConfig(path: string, reason: string): ConfigError;
+    static missingConfig(key: string): ConfigError;
+}
+/**
+ * System errors - internal/system-level failures
+ */
+export declare class SystemError extends XopcbotError {
+    readonly [SYSTEM_ERROR_MARKER] = true;
+    constructor(code: string, message: string, retryable?: boolean, suggestion?: string, cause?: Error);
+    static internal(message: string, cause?: Error): SystemError;
+    static filesystem(path: string, operation: string, cause?: Error): SystemError;
+    static outOfMemory(): SystemError;
+}
+/**
+ * Network errors - connectivity/timeout issues
+ */
+export declare class NetworkError extends XopcbotError {
+    readonly [NETWORK_ERROR_MARKER] = true;
+    constructor(code: string, message: string, retryable?: boolean, suggestion?: string, cause?: Error);
+    static timeout(url: string, timeoutMs: number, cause?: Error): NetworkError;
+    static connectionFailed(url: string, cause?: Error): NetworkError;
+}
+/**
+ * LLM Provider errors - model/API failures
+ */
+export declare class ProviderError extends XopcbotError {
+    readonly [PROVIDER_ERROR_MARKER] = true;
+    readonly provider: string;
+    readonly model?: string;
+    readonly statusCode?: number;
+    constructor(provider: string, code: string, message: string, retryable?: boolean, suggestion?: string, cause?: Error, statusCode?: number, model?: string);
+    static rateLimit(provider: string, retryAfter?: number, model?: string): ProviderError;
+    static authFailed(provider: string, cause?: Error): ProviderError;
+    static modelNotFound(provider: string, model: string): ProviderError;
+    static overloaded(provider: string, model?: string): ProviderError;
+    static insufficientFunds(provider: string): ProviderError;
+}
+/**
+ * Error handling utilities
+ */
+export declare function isXopcbotError(error: unknown): error is XopcbotError;
+export declare function isUserError(error: unknown): error is UserError;
+export declare function isConfigError(error: unknown): error is ConfigError;
+export declare function isProviderError(error: unknown): error is ProviderError;
+export declare function isRetryable(error: unknown): boolean;
+/**
+ * Wrap unknown error into XopcbotError
+ */
+export declare function wrapError(error: unknown, context?: string): XopcbotError;
+/**
+ * Format error for user display
+ */
+export declare function formatErrorForUser(error: unknown): string;
+/**
+ * Format error for logging
+ */
+export declare function formatErrorForLog(error: unknown): Record<string, unknown>;
+export {};