@stackmemoryai/stackmemory 0.2.4 → 0.2.7

package/dist/src/core/errors/__tests__/error-handling.test.js

@@ -0,0 +1,239 @@
+/**
+ * Tests for error handling system
+ */
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { StackMemoryError, DatabaseError, FrameError, ValidationError, ErrorCode, isRetryableError, getErrorMessage, wrapError, } from '../index.js';
+import { retry, CircuitBreaker, withFallback, calculateBackoff, CircuitState, withTimeout, gracefulDegrade, } from '../recovery.js';
+describe('Error Classes', () => {
+    describe('StackMemoryError', () => {
+        it('should create error with all properties', () => {
+            const error = new StackMemoryError({
+                code: ErrorCode.INTERNAL_ERROR,
+                message: 'Test error',
+                context: { key: 'value' },
+                isRetryable: true,
+                httpStatus: 500,
+            });
+            expect(error.code).toBe(ErrorCode.INTERNAL_ERROR);
+            expect(error.message).toBe('Test error');
+            expect(error.context).toEqual({ key: 'value' });
+            expect(error.isRetryable).toBe(true);
+            expect(error.httpStatus).toBe(500);
+            expect(error.timestamp).toBeInstanceOf(Date);
+        });
+        it('should serialize to JSON correctly', () => {
+            const error = new StackMemoryError({
+                code: ErrorCode.DB_CONNECTION_FAILED,
+                message: 'Connection failed',
+            });
+            const json = error.toJSON();
+            expect(json.code).toBe(ErrorCode.DB_CONNECTION_FAILED);
+            expect(json.message).toBe('Connection failed');
+            expect(json.timestamp).toBeDefined();
+        });
+    });
+    describe('DatabaseError', () => {
+        it('should be retryable for connection failures', () => {
+            const error = new DatabaseError('Connection lost', ErrorCode.DB_CONNECTION_FAILED);
+            expect(error.isRetryable).toBe(true);
+        });
+        it('should not be retryable for query failures', () => {
+            const error = new DatabaseError('Invalid SQL', ErrorCode.DB_QUERY_FAILED);
+            expect(error.isRetryable).toBe(false);
+        });
+    });
+    describe('Error Helpers', () => {
+        it('should identify retryable errors', () => {
+            const retryable = new DatabaseError('Connection lost', ErrorCode.DB_CONNECTION_FAILED);
+            const nonRetryable = new ValidationError('Invalid input');
+            expect(isRetryableError(retryable)).toBe(true);
+            expect(isRetryableError(nonRetryable)).toBe(false);
+        });
+        it('should identify retryable network errors', () => {
+            const networkError = new Error('ECONNREFUSED');
+            const timeoutError = new Error('Request timeout');
+            expect(isRetryableError(networkError)).toBe(true);
+            expect(isRetryableError(timeoutError)).toBe(true);
+        });
+        it('should extract error messages safely', () => {
+            expect(getErrorMessage(new Error('Test'))).toBe('Test');
+            expect(getErrorMessage('String error')).toBe('String error');
+            expect(getErrorMessage({ message: 'Object error' })).toBe('Object error');
+            expect(getErrorMessage(null)).toBe('An unknown error occurred');
+            expect(getErrorMessage(undefined)).toBe('An unknown error occurred');
+        });
+        it('should wrap errors correctly', () => {
+            const originalError = new Error('Original');
+            const wrapped = wrapError(originalError, 'Wrapped message', ErrorCode.INTERNAL_ERROR, { extra: 'context' });
+            expect(wrapped).toBeInstanceOf(StackMemoryError);
+            expect(wrapped.cause).toBe(originalError);
+            expect(wrapped.context).toEqual({ extra: 'context' });
+        });
+        it('should not double-wrap StackMemoryErrors', () => {
+            const stackError = new FrameError('Frame error');
+            const wrapped = wrapError(stackError, 'Default');
+            expect(wrapped).toBe(stackError);
+        });
+    });
+});
+describe('Recovery Utilities', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    describe('Retry Logic', () => {
+        it('should retry on failure', async () => {
+            let attempts = 0;
+            const fn = vi.fn(async () => {
+                attempts++;
+                if (attempts < 3) {
+                    throw new DatabaseError('Connection lost', ErrorCode.DB_CONNECTION_FAILED);
+                }
+                return 'success';
+            });
+            const result = await retry(fn, {
+                maxAttempts: 3,
+                initialDelay: 10,
+            });
+            expect(result).toBe('success');
+            expect(fn).toHaveBeenCalledTimes(3);
+        });
+        it('should not retry non-retryable errors', async () => {
+            const fn = vi.fn(async () => {
+                throw new ValidationError('Invalid data');
+            });
+            await expect(retry(fn, { maxAttempts: 3 })).rejects.toThrow('Invalid data');
+            expect(fn).toHaveBeenCalledTimes(1);
+        });
+        it('should respect timeout', async () => {
+            const fn = vi.fn(async () => {
+                await new Promise(resolve => setTimeout(resolve, 1000));
+                return 'slow';
+            });
+            await expect(retry(fn, { timeout: 50 })).rejects.toThrow('Operation timed out');
+        });
+        it('should calculate backoff correctly', () => {
+            const delay1 = calculateBackoff(1, 100, 10000, 2);
+            const delay2 = calculateBackoff(2, 100, 10000, 2);
+            const delay3 = calculateBackoff(3, 100, 10000, 2);
+            // Base delays without jitter
+            expect(delay1).toBeGreaterThanOrEqual(100);
+            expect(delay1).toBeLessThanOrEqual(125); // With max 25% jitter
+            expect(delay2).toBeGreaterThanOrEqual(200);
+            expect(delay2).toBeLessThanOrEqual(250);
+            expect(delay3).toBeGreaterThanOrEqual(400);
+            expect(delay3).toBeLessThanOrEqual(500);
+        });
+    });
+    describe('Circuit Breaker', () => {
+        it('should open after threshold failures', async () => {
+            const breaker = new CircuitBreaker('test', {
+                failureThreshold: 2,
+                resetTimeout: 100,
+            });
+            const failingFn = vi.fn(async () => {
+                throw new Error('Failed');
+            });
+            // First two failures
+            await expect(breaker.execute(failingFn)).rejects.toThrow('Failed');
+            await expect(breaker.execute(failingFn)).rejects.toThrow('Failed');
+            // Circuit should be open
+            expect(breaker.getState()).toBe(CircuitState.OPEN);
+            // Next call should fail immediately
+            await expect(breaker.execute(failingFn)).rejects.toThrow('Circuit breaker test is OPEN');
+            expect(failingFn).toHaveBeenCalledTimes(2); // Not called on open circuit
+        });
+        it('should transition to half-open after timeout', async () => {
+            const breaker = new CircuitBreaker('test', {
+                failureThreshold: 1,
+                resetTimeout: 50,
+                halfOpenRequests: 1,
+            });
+            const fn = vi.fn(async () => {
+                throw new Error('Failed');
+            });
+            // Open the circuit
+            await expect(breaker.execute(fn)).rejects.toThrow();
+            expect(breaker.getState()).toBe(CircuitState.OPEN);
+            // Wait for reset timeout
+            await new Promise(resolve => setTimeout(resolve, 60));
+            // Should allow one request in half-open
+            const successFn = vi.fn(async () => 'success');
+            const result = await breaker.execute(successFn);
+            expect(result).toBe('success');
+            expect(breaker.getState()).toBe(CircuitState.CLOSED);
+        });
+        it('should reset manually', () => {
+            const breaker = new CircuitBreaker('test', {
+                failureThreshold: 1,
+            });
+            breaker.reset();
+            expect(breaker.getState()).toBe(CircuitState.CLOSED);
+        });
+    });
+    describe('Fallback Mechanism', () => {
+        it('should use fallback on primary failure', async () => {
+            const primary = vi.fn(async () => {
+                throw new Error('Primary failed');
+            });
+            const fallback1 = vi.fn(async () => 'fallback result');
+            const result = await withFallback(primary, [fallback1]);
+            expect(result).toBe('fallback result');
+            expect(primary).toHaveBeenCalledTimes(1);
+            expect(fallback1).toHaveBeenCalledTimes(1);
+        });
+        it('should try multiple fallbacks', async () => {
+            const primary = vi.fn(async () => {
+                throw new Error('Primary failed');
+            });
+            const fallback1 = vi.fn(async () => {
+                throw new Error('Fallback1 failed');
+            });
+            const fallback2 = vi.fn(async () => 'fallback2 result');
+            const result = await withFallback(primary, [fallback1, fallback2]);
+            expect(result).toBe('fallback2 result');
+            expect(fallback1).toHaveBeenCalledTimes(1);
+            expect(fallback2).toHaveBeenCalledTimes(1);
+        });
+        it('should throw if all attempts fail', async () => {
+            const primary = vi.fn(async () => {
+                throw new Error('Primary');
+            });
+            const fallback = vi.fn(async () => {
+                throw new Error('Fallback');
+            });
+            await expect(withFallback(primary, [fallback])).rejects.toThrow('All attempts failed');
+        });
+    });
+    describe('Timeout Wrapper', () => {
+        it('should timeout long operations', async () => {
+            const slowFn = async () => {
+                await new Promise(resolve => setTimeout(resolve, 1000));
+                return 'slow';
+            };
+            await expect(withTimeout(slowFn, 50, 'Custom timeout')).rejects.toThrow('Custom timeout');
+        });
+        it('should complete fast operations', async () => {
+            const fastFn = async () => {
+                await new Promise(resolve => setTimeout(resolve, 10));
+                return 'fast';
+            };
+            const result = await withTimeout(fastFn, 100);
+            expect(result).toBe('fast');
+        });
+    });
+    describe('Graceful Degradation', () => {
+        it('should return default on failure', async () => {
+            const failingFn = vi.fn(async () => {
+                throw new Error('Failed');
+            });
+            const result = await gracefulDegrade(failingFn, 'default');
+            expect(result).toBe('default');
+        });
+        it('should return result on success', async () => {
+            const successFn = vi.fn(async () => 'success');
+            const result = await gracefulDegrade(successFn, 'default');
+            expect(result).toBe('success');
+        });
+    });
+});
+//# sourceMappingURL=error-handling.test.js.map

package/dist/src/core/errors/__tests__/error-handling.test.js.map

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

package/dist/src/core/errors/index.d.ts

@@ -0,0 +1,135 @@
+/**
+ * Custom error classes for StackMemory
+ * Provides a hierarchy of error types for better error handling and debugging
+ */
+export declare enum ErrorCode {
+    DB_CONNECTION_FAILED = "DB_001",
+    DB_QUERY_FAILED = "DB_002",
+    DB_TRANSACTION_FAILED = "DB_003",
+    DB_MIGRATION_FAILED = "DB_004",
+    DB_CONSTRAINT_VIOLATION = "DB_005",
+    FRAME_NOT_FOUND = "FRAME_001",
+    FRAME_INVALID_STATE = "FRAME_002",
+    FRAME_PARENT_NOT_FOUND = "FRAME_003",
+    FRAME_CYCLE_DETECTED = "FRAME_004",
+    FRAME_ALREADY_CLOSED = "FRAME_005",
+    TASK_NOT_FOUND = "TASK_001",
+    TASK_INVALID_STATE = "TASK_002",
+    TASK_DEPENDENCY_CONFLICT = "TASK_003",
+    TASK_CIRCULAR_DEPENDENCY = "TASK_004",
+    LINEAR_AUTH_FAILED = "LINEAR_001",
+    LINEAR_API_ERROR = "LINEAR_002",
+    LINEAR_SYNC_FAILED = "LINEAR_003",
+    LINEAR_WEBHOOK_FAILED = "LINEAR_004",
+    MCP_TOOL_NOT_FOUND = "MCP_001",
+    MCP_INVALID_PARAMS = "MCP_002",
+    MCP_EXECUTION_FAILED = "MCP_003",
+    MCP_RATE_LIMITED = "MCP_004",
+    PROJECT_NOT_FOUND = "PROJECT_001",
+    PROJECT_INVALID_PATH = "PROJECT_002",
+    PROJECT_GIT_ERROR = "PROJECT_003",
+    VALIDATION_FAILED = "VAL_001",
+    INVALID_INPUT = "VAL_002",
+    MISSING_REQUIRED_FIELD = "VAL_003",
+    TYPE_MISMATCH = "VAL_004",
+    INITIALIZATION_ERROR = "SYS_001",
+    NOT_FOUND = "SYS_002",
+    INTERNAL_ERROR = "SYS_001",
+    CONFIGURATION_ERROR = "SYS_002",
+    PERMISSION_DENIED = "SYS_003",
+    RESOURCE_EXHAUSTED = "SYS_004",
+    SERVICE_UNAVAILABLE = "SYS_005"
+}
+export interface ErrorContext {
+    [key: string]: unknown;
+}
+export interface StackMemoryErrorOptions {
+    code: ErrorCode;
+    message: string;
+    context?: ErrorContext;
+    cause?: Error;
+    isRetryable?: boolean;
+    httpStatus?: number;
+}
+/**
+ * Base error class for all StackMemory errors
+ */
+export declare class StackMemoryError extends Error {
+    readonly code: ErrorCode;
+    readonly context?: ErrorContext;
+    readonly cause?: Error;
+    readonly isRetryable: boolean;
+    readonly httpStatus: number;
+    readonly timestamp: Date;
+    constructor(options: StackMemoryErrorOptions);
+    toJSON(): Record<string, unknown>;
+}
+/**
+ * Database-related errors
+ */
+export declare class DatabaseError extends StackMemoryError {
+    constructor(message: string, code?: ErrorCode, context?: ErrorContext, cause?: Error);
+}
+/**
+ * Frame-related errors
+ */
+export declare class FrameError extends StackMemoryError {
+    constructor(message: string, code?: ErrorCode, context?: ErrorContext);
+}
+/**
+ * Task-related errors
+ */
+export declare class TaskError extends StackMemoryError {
+    constructor(message: string, code?: ErrorCode, context?: ErrorContext);
+}
+/**
+ * Integration errors (Linear, etc.)
+ */
+export declare class IntegrationError extends StackMemoryError {
+    constructor(message: string, code?: ErrorCode, context?: ErrorContext, cause?: Error);
+}
+/**
+ * MCP-related errors
+ */
+export declare class MCPError extends StackMemoryError {
+    constructor(message: string, code?: ErrorCode, context?: ErrorContext);
+}
+/**
+ * Validation errors
+ */
+export declare class ValidationError extends StackMemoryError {
+    constructor(message: string, code?: ErrorCode, context?: ErrorContext);
+}
+/**
+ * Project-related errors
+ */
+export declare class ProjectError extends StackMemoryError {
+    constructor(message: string, code?: ErrorCode, context?: ErrorContext);
+}
+/**
+ * System/Internal errors
+ */
+export declare class SystemError extends StackMemoryError {
+    constructor(message: string, code?: ErrorCode, context?: ErrorContext, cause?: Error);
+}
+/**
+ * Helper function to determine if an error is retryable
+ */
+export declare function isRetryableError(error: unknown): boolean;
+/**
+ * Helper function to safely extract error message
+ */
+export declare function getErrorMessage(error: unknown): string;
+/**
+ * Helper function to wrap unknown errors in StackMemoryError
+ */
+export declare function wrapError(error: unknown, defaultMessage: string, code?: ErrorCode, context?: ErrorContext): StackMemoryError;
+/**
+ * Type guard to check if error is a StackMemoryError
+ */
+export declare function isStackMemoryError(error: unknown): error is StackMemoryError;
+/**
+ * Create context-aware error handler
+ */
+export declare function createErrorHandler(defaultContext: ErrorContext): (error: unknown, additionalContext?: ErrorContext) => StackMemoryError;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/core/errors/index.d.ts.map

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

package/dist/src/core/errors/index.js

@@ -0,0 +1,274 @@
+/**
+ * Custom error classes for StackMemory
+ * Provides a hierarchy of error types for better error handling and debugging
+ */
+export var ErrorCode;
+(function (ErrorCode) {
+    // Database errors (1000-1999)
+    ErrorCode["DB_CONNECTION_FAILED"] = "DB_001";
+    ErrorCode["DB_QUERY_FAILED"] = "DB_002";
+    ErrorCode["DB_TRANSACTION_FAILED"] = "DB_003";
+    ErrorCode["DB_MIGRATION_FAILED"] = "DB_004";
+    ErrorCode["DB_CONSTRAINT_VIOLATION"] = "DB_005";
+    // Frame errors (2000-2999)
+    ErrorCode["FRAME_NOT_FOUND"] = "FRAME_001";
+    ErrorCode["FRAME_INVALID_STATE"] = "FRAME_002";
+    ErrorCode["FRAME_PARENT_NOT_FOUND"] = "FRAME_003";
+    ErrorCode["FRAME_CYCLE_DETECTED"] = "FRAME_004";
+    ErrorCode["FRAME_ALREADY_CLOSED"] = "FRAME_005";
+    // Task errors (3000-3999)
+    ErrorCode["TASK_NOT_FOUND"] = "TASK_001";
+    ErrorCode["TASK_INVALID_STATE"] = "TASK_002";
+    ErrorCode["TASK_DEPENDENCY_CONFLICT"] = "TASK_003";
+    ErrorCode["TASK_CIRCULAR_DEPENDENCY"] = "TASK_004";
+    // Integration errors (4000-4999)
+    ErrorCode["LINEAR_AUTH_FAILED"] = "LINEAR_001";
+    ErrorCode["LINEAR_API_ERROR"] = "LINEAR_002";
+    ErrorCode["LINEAR_SYNC_FAILED"] = "LINEAR_003";
+    ErrorCode["LINEAR_WEBHOOK_FAILED"] = "LINEAR_004";
+    // MCP errors (5000-5999)
+    ErrorCode["MCP_TOOL_NOT_FOUND"] = "MCP_001";
+    ErrorCode["MCP_INVALID_PARAMS"] = "MCP_002";
+    ErrorCode["MCP_EXECUTION_FAILED"] = "MCP_003";
+    ErrorCode["MCP_RATE_LIMITED"] = "MCP_004";
+    // Project errors (6000-6999)
+    ErrorCode["PROJECT_NOT_FOUND"] = "PROJECT_001";
+    ErrorCode["PROJECT_INVALID_PATH"] = "PROJECT_002";
+    ErrorCode["PROJECT_GIT_ERROR"] = "PROJECT_003";
+    // Validation errors (7000-7999)
+    ErrorCode["VALIDATION_FAILED"] = "VAL_001";
+    ErrorCode["INVALID_INPUT"] = "VAL_002";
+    ErrorCode["MISSING_REQUIRED_FIELD"] = "VAL_003";
+    ErrorCode["TYPE_MISMATCH"] = "VAL_004";
+    // System errors (8000-8999)
+    ErrorCode["INITIALIZATION_ERROR"] = "SYS_001";
+    ErrorCode["NOT_FOUND"] = "SYS_002";
+    ErrorCode["INTERNAL_ERROR"] = "SYS_001";
+    ErrorCode["CONFIGURATION_ERROR"] = "SYS_002";
+    ErrorCode["PERMISSION_DENIED"] = "SYS_003";
+    ErrorCode["RESOURCE_EXHAUSTED"] = "SYS_004";
+    ErrorCode["SERVICE_UNAVAILABLE"] = "SYS_005";
+})(ErrorCode || (ErrorCode = {}));
+/**
+ * Base error class for all StackMemory errors
+ */
+export class StackMemoryError extends Error {
+    code;
+    context;
+    cause;
+    isRetryable;
+    httpStatus;
+    timestamp;
+    constructor(options) {
+        super(options.message);
+        this.name = this.constructor.name;
+        this.code = options.code;
+        this.context = options.context;
+        this.cause = options.cause;
+        this.isRetryable = options.isRetryable ?? false;
+        this.httpStatus = options.httpStatus ?? 500;
+        this.timestamp = new Date();
+        // Maintains proper stack trace for where our error was thrown
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+    }
+    toJSON() {
+        return {
+            name: this.name,
+            code: this.code,
+            message: this.message,
+            context: this.context,
+            isRetryable: this.isRetryable,
+            httpStatus: this.httpStatus,
+            timestamp: this.timestamp.toISOString(),
+            stack: this.stack,
+            cause: this.cause?.message,
+        };
+    }
+}
+/**
+ * Database-related errors
+ */
+export class DatabaseError extends StackMemoryError {
+    constructor(message, code = ErrorCode.DB_QUERY_FAILED, context, cause) {
+        super({
+            code,
+            message,
+            context,
+            cause,
+            isRetryable: code === ErrorCode.DB_CONNECTION_FAILED,
+            httpStatus: 503,
+        });
+    }
+}
+/**
+ * Frame-related errors
+ */
+export class FrameError extends StackMemoryError {
+    constructor(message, code = ErrorCode.FRAME_INVALID_STATE, context) {
+        super({
+            code,
+            message,
+            context,
+            isRetryable: false,
+            httpStatus: 400,
+        });
+    }
+}
+/**
+ * Task-related errors
+ */
+export class TaskError extends StackMemoryError {
+    constructor(message, code = ErrorCode.TASK_INVALID_STATE, context) {
+        super({
+            code,
+            message,
+            context,
+            isRetryable: false,
+            httpStatus: 400,
+        });
+    }
+}
+/**
+ * Integration errors (Linear, etc.)
+ */
+export class IntegrationError extends StackMemoryError {
+    constructor(message, code = ErrorCode.LINEAR_API_ERROR, context, cause) {
+        super({
+            code,
+            message,
+            context,
+            cause,
+            isRetryable: true,
+            httpStatus: 502,
+        });
+    }
+}
+/**
+ * MCP-related errors
+ */
+export class MCPError extends StackMemoryError {
+    constructor(message, code = ErrorCode.MCP_EXECUTION_FAILED, context) {
+        super({
+            code,
+            message,
+            context,
+            isRetryable: code === ErrorCode.MCP_RATE_LIMITED,
+            httpStatus: code === ErrorCode.MCP_RATE_LIMITED ? 429 : 400,
+        });
+    }
+}
+/**
+ * Validation errors
+ */
+export class ValidationError extends StackMemoryError {
+    constructor(message, code = ErrorCode.VALIDATION_FAILED, context) {
+        super({
+            code,
+            message,
+            context,
+            isRetryable: false,
+            httpStatus: 400,
+        });
+    }
+}
+/**
+ * Project-related errors
+ */
+export class ProjectError extends StackMemoryError {
+    constructor(message, code = ErrorCode.PROJECT_NOT_FOUND, context) {
+        super({
+            code,
+            message,
+            context,
+            isRetryable: false,
+            httpStatus: 404,
+        });
+    }
+}
+/**
+ * System/Internal errors
+ */
+export class SystemError extends StackMemoryError {
+    constructor(message, code = ErrorCode.INTERNAL_ERROR, context, cause) {
+        super({
+            code,
+            message,
+            context,
+            cause,
+            isRetryable: code === ErrorCode.SERVICE_UNAVAILABLE,
+            httpStatus: 500,
+        });
+    }
+}
+/**
+ * Helper function to determine if an error is retryable
+ */
+export function isRetryableError(error) {
+    if (error instanceof StackMemoryError) {
+        return error.isRetryable;
+    }
+    // Check for common retryable error patterns
+    if (error instanceof Error) {
+        const message = error.message.toLowerCase();
+        return (message.includes('econnrefused') ||
+            message.includes('timeout') ||
+            message.includes('enotfound') ||
+            message.includes('socket hang up'));
+    }
+    return false;
+}
+/**
+ * Helper function to safely extract error message
+ */
+export function getErrorMessage(error) {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    if (typeof error === 'string') {
+        return error;
+    }
+    if (error && typeof error === 'object' && 'message' in error) {
+        return String(error.message);
+    }
+    return 'An unknown error occurred';
+}
+/**
+ * Helper function to wrap unknown errors in StackMemoryError
+ */
+export function wrapError(error, defaultMessage, code = ErrorCode.INTERNAL_ERROR, context) {
+    if (error instanceof StackMemoryError) {
+        return error;
+    }
+    const cause = error instanceof Error ? error : undefined;
+    const message = error instanceof Error ? error.message : defaultMessage;
+    return new SystemError(message, code, context, cause);
+}
+/**
+ * Type guard to check if error is a StackMemoryError
+ */
+export function isStackMemoryError(error) {
+    return error instanceof StackMemoryError;
+}
+/**
+ * Create context-aware error handler
+ */
+export function createErrorHandler(defaultContext) {
+    return (error, additionalContext) => {
+        const context = { ...defaultContext, ...additionalContext };
+        if (error instanceof StackMemoryError) {
+            // Create a new error with merged context since context is readonly
+            return new StackMemoryError({
+                code: error.code,
+                message: error.message,
+                context: { ...error.context, ...context },
+                cause: error.cause,
+                isRetryable: error.isRetryable,
+                httpStatus: error.httpStatus,
+            });
+        }
+        return wrapError(error, getErrorMessage(error), ErrorCode.INTERNAL_ERROR, context);
+    };
+}
+//# sourceMappingURL=index.js.map