@beethovn/errors 1.0.0

package/dist/base/BeethovnError.js

@@ -0,0 +1,79 @@
+/**
+ * Base error class for all Beethovn errors
+ *
+ * Provides structured error information for logging, monitoring, and debugging.
+ * All custom errors in the Beethovn platform should extend this class.
+ *
+ * @example
+ * ```typescript
+ * class MyCustomError extends BeethovnError {
+ *   constructor(message: string) {
+ *     super(message, 'MY_CUSTOM_ERROR', 400, { custom: 'metadata' });
+ *   }
+ * }
+ * ```
+ */
+export class BeethovnError extends Error {
+    /** Unique error code for categorization and monitoring */
+    code;
+    /** HTTP status code (for API errors) */
+    statusCode;
+    /** Additional contextual metadata for debugging */
+    metadata;
+    /** Timestamp when error occurred */
+    timestamp;
+    /** Is this error recoverable with retry logic? */
+    recoverable;
+    /**
+     * Create a new BeethovnError
+     *
+     * @param message - Human-readable error message
+     * @param code - Unique error code (e.g., 'VALIDATION_ERROR')
+     * @param statusCode - HTTP status code (default: 500)
+     * @param metadata - Additional context for debugging
+     * @param recoverable - Can this error be retried? (default: false)
+     */
+    constructor(message, code, statusCode = 500, metadata = {}, recoverable = false) {
+        super(message);
+        this.name = this.constructor.name;
+        this.code = code;
+        this.statusCode = statusCode;
+        this.metadata = metadata;
+        this.timestamp = new Date();
+        this.recoverable = recoverable;
+        // Maintains proper stack trace for where error was thrown
+        Error.captureStackTrace(this, this.constructor);
+    }
+    /**
+     * Serialize error for logging and monitoring
+     *
+     * @returns Plain object representation of the error
+     */
+    toJSON() {
+        return {
+            name: this.name,
+            code: this.code,
+            message: this.message,
+            statusCode: this.statusCode,
+            metadata: this.metadata,
+            timestamp: this.timestamp.toISOString(),
+            recoverable: this.recoverable,
+            stack: this.stack,
+        };
+    }
+    /**
+     * Get a sanitized version of the error for client responses
+     * (Excludes stack traces and sensitive metadata)
+     *
+     * @returns Sanitized error object safe for API responses
+     */
+    toClient() {
+        return {
+            code: this.code,
+            message: this.message,
+            statusCode: this.statusCode,
+            timestamp: this.timestamp.toISOString(),
+        };
+    }
+}
+//# sourceMappingURL=BeethovnError.js.map

package/dist/base/BeethovnError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BeethovnError.js","sourceRoot":"","sources":["../../src/base/BeethovnError.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAgB,aAAc,SAAQ,KAAK;IAC/C,0DAA0D;IAC1C,IAAI,CAAS;IAE7B,wCAAwC;IACxB,UAAU,CAAS;IAEnC,mDAAmD;IACnC,QAAQ,CAA0B;IAElD,oCAAoC;IACpB,SAAS,CAAO;IAEhC,kDAAkD;IAClC,WAAW,CAAU;IAErC;;;;;;;;OAQG;IACH,YACE,OAAe,EACf,IAAY,EACZ,aAAqB,GAAG,EACxB,WAAoC,EAAE,EACtC,cAAuB,KAAK;QAE5B,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAE/B,0DAA0D;QAC1D,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IAClD,CAAC;IAED;;;;OAIG;IACH,MAAM;QACJ,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE;YACvC,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,QAAQ;QACN,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE;SACxC,CAAC;IACJ,CAAC;CACF"}

package/dist/domain/DomainError.d.ts

@@ -0,0 +1,88 @@
+import { BeethovnError } from '../base/BeethovnError.js';
+/**
+ * Base class for domain/business logic errors
+ *
+ * Domain errors represent business rule violations, validation failures,
+ * and other application-level issues. These are typically user-fixable.
+ */
+export declare abstract class DomainError extends BeethovnError {
+    constructor(message: string, code: string, metadata?: Record<string, unknown>);
+}
+/**
+ * Validation error - input doesn't meet requirements
+ *
+ * @example
+ * ```typescript
+ * if (!email.includes('@')) {
+ *   throw new ValidationError('Invalid email format', 'email');
+ * }
+ * ```
+ */
+export declare class ValidationError extends DomainError {
+    constructor(message: string, field?: string, metadata?: Record<string, unknown>);
+}
+/**
+ * Business rule violation
+ *
+ * @example
+ * ```typescript
+ * if (balance < amount) {
+ *   throw new BusinessRuleError(
+ *     'Insufficient balance',
+ *     'MINIMUM_BALANCE',
+ *     { balance, required: amount }
+ *   );
+ * }
+ * ```
+ */
+export declare class BusinessRuleError extends DomainError {
+    constructor(message: string, rule: string, metadata?: Record<string, unknown>);
+}
+/**
+ * Resource not found
+ *
+ * @example
+ * ```typescript
+ * const user = await db.getUser(id);
+ * if (!user) {
+ *   throw new NotFoundError('User', id, { tenantId });
+ * }
+ * ```
+ */
+export declare class NotFoundError extends BeethovnError {
+    constructor(resource: string, id: string, metadata?: Record<string, unknown>);
+}
+/**
+ * Resource already exists (conflict)
+ *
+ * @example
+ * ```typescript
+ * if (existingUser) {
+ *   throw new ConflictError(
+ *     'User with this email already exists',
+ *     { email }
+ *   );
+ * }
+ * ```
+ */
+export declare class ConflictError extends BeethovnError {
+    constructor(message: string, metadata?: Record<string, unknown>);
+}
+/**
+ * Invalid state transition
+ *
+ * @example
+ * ```typescript
+ * if (order.status === 'cancelled') {
+ *   throw new InvalidStateError(
+ *     'Cannot modify cancelled order',
+ *     'cancelled',
+ *     'modify'
+ *   );
+ * }
+ * ```
+ */
+export declare class InvalidStateError extends DomainError {
+    constructor(message: string, currentState: string, attemptedAction: string, metadata?: Record<string, unknown>);
+}
+//# sourceMappingURL=DomainError.d.ts.map

package/dist/domain/DomainError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DomainError.d.ts","sourceRoot":"","sources":["../../src/domain/DomainError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzD;;;;;GAKG;AACH,8BAAsB,WAAY,SAAQ,aAAa;gBAEnD,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;CAIzC;AAED;;;;;;;;;GASG;AACH,qBAAa,eAAgB,SAAQ,WAAW;gBAE5C,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,MAAM,EACd,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;CAQzC;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,iBAAkB,SAAQ,WAAW;gBAE9C,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;CAIzC;AAED;;;;;;;;;;GAUG;AACH,qBAAa,aAAc,SAAQ,aAAa;gBAE5C,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,MAAM,EACV,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;CAUzC;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,aAAc,SAAQ,aAAa;gBAE5C,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;CAIzC;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,iBAAkB,SAAQ,WAAW;gBAE9C,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,eAAe,EAAE,MAAM,EACvB,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;CAQzC"}

package/dist/domain/DomainError.js

@@ -0,0 +1,100 @@
+import { BeethovnError } from '../base/BeethovnError.js';
+/**
+ * Base class for domain/business logic errors
+ *
+ * Domain errors represent business rule violations, validation failures,
+ * and other application-level issues. These are typically user-fixable.
+ */
+export class DomainError extends BeethovnError {
+    constructor(message, code, metadata = {}) {
+        super(message, code, 400, metadata, false);
+    }
+}
+/**
+ * Validation error - input doesn't meet requirements
+ *
+ * @example
+ * ```typescript
+ * if (!email.includes('@')) {
+ *   throw new ValidationError('Invalid email format', 'email');
+ * }
+ * ```
+ */
+export class ValidationError extends DomainError {
+    constructor(message, field, metadata = {}) {
+        super(message, 'VALIDATION_ERROR', field ? { ...metadata, field } : metadata);
+    }
+}
+/**
+ * Business rule violation
+ *
+ * @example
+ * ```typescript
+ * if (balance < amount) {
+ *   throw new BusinessRuleError(
+ *     'Insufficient balance',
+ *     'MINIMUM_BALANCE',
+ *     { balance, required: amount }
+ *   );
+ * }
+ * ```
+ */
+export class BusinessRuleError extends DomainError {
+    constructor(message, rule, metadata = {}) {
+        super(message, 'BUSINESS_RULE_VIOLATION', { ...metadata, rule });
+    }
+}
+/**
+ * Resource not found
+ *
+ * @example
+ * ```typescript
+ * const user = await db.getUser(id);
+ * if (!user) {
+ *   throw new NotFoundError('User', id, { tenantId });
+ * }
+ * ```
+ */
+export class NotFoundError extends BeethovnError {
+    constructor(resource, id, metadata = {}) {
+        super(`${resource} not found: ${id}`, 'NOT_FOUND', 404, { ...metadata, resource, id }, false);
+    }
+}
+/**
+ * Resource already exists (conflict)
+ *
+ * @example
+ * ```typescript
+ * if (existingUser) {
+ *   throw new ConflictError(
+ *     'User with this email already exists',
+ *     { email }
+ *   );
+ * }
+ * ```
+ */
+export class ConflictError extends BeethovnError {
+    constructor(message, metadata = {}) {
+        super(message, 'CONFLICT', 409, metadata, false);
+    }
+}
+/**
+ * Invalid state transition
+ *
+ * @example
+ * ```typescript
+ * if (order.status === 'cancelled') {
+ *   throw new InvalidStateError(
+ *     'Cannot modify cancelled order',
+ *     'cancelled',
+ *     'modify'
+ *   );
+ * }
+ * ```
+ */
+export class InvalidStateError extends DomainError {
+    constructor(message, currentState, attemptedAction, metadata = {}) {
+        super(message, 'INVALID_STATE', { ...metadata, currentState, attemptedAction });
+    }
+}
+//# sourceMappingURL=DomainError.js.map

package/dist/domain/DomainError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DomainError.js","sourceRoot":"","sources":["../../src/domain/DomainError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzD;;;;;GAKG;AACH,MAAM,OAAgB,WAAY,SAAQ,aAAa;IACrD,YACE,OAAe,EACf,IAAY,EACZ,WAAoC,EAAE;QAEtC,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC7C,CAAC;CACF;AAED;;;;;;;;;GASG;AACH,MAAM,OAAO,eAAgB,SAAQ,WAAW;IAC9C,YACE,OAAe,EACf,KAAc,EACd,WAAoC,EAAE;QAEtC,KAAK,CACH,OAAO,EACP,kBAAkB,EAClB,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,QAAQ,CAC1C,CAAC;IACJ,CAAC;CACF;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,iBAAkB,SAAQ,WAAW;IAChD,YACE,OAAe,EACf,IAAY,EACZ,WAAoC,EAAE;QAEtC,KAAK,CAAC,OAAO,EAAE,yBAAyB,EAAE,EAAE,GAAG,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IACnE,CAAC;CACF;AAED;;;;;;;;;;GAUG;AACH,MAAM,OAAO,aAAc,SAAQ,aAAa;IAC9C,YACE,QAAgB,EAChB,EAAU,EACV,WAAoC,EAAE;QAEtC,KAAK,CACH,GAAG,QAAQ,eAAe,EAAE,EAAE,EAC9B,WAAW,EACX,GAAG,EACH,EAAE,GAAG,QAAQ,EAAE,QAAQ,EAAE,EAAE,EAAE,EAC7B,KAAK,CACN,CAAC;IACJ,CAAC;CACF;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,aAAc,SAAQ,aAAa;IAC9C,YACE,OAAe,EACf,WAAoC,EAAE;QAEtC,KAAK,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;IACnD,CAAC;CACF;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,iBAAkB,SAAQ,WAAW;IAChD,YACE,OAAe,EACf,YAAoB,EACpB,eAAuB,EACvB,WAAoC,EAAE;QAEtC,KAAK,CACH,OAAO,EACP,eAAe,EACf,EAAE,GAAG,QAAQ,EAAE,YAAY,EAAE,eAAe,EAAE,CAC/C,CAAC;IACJ,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @beethovn/errors
+ *
+ * Standardized error types for the Beethovn platform.
+ * Provides structured, typed errors with rich metadata for better
+ * debugging, logging, and monitoring.
+ */
+export { BeethovnError } from './base/BeethovnError.js';
+export { DomainError, ValidationError, BusinessRuleError, NotFoundError, ConflictError, InvalidStateError, } from './domain/DomainError.js';
+export { InfrastructureError, DatabaseError, NetworkError, ExternalServiceError, TimeoutError, RateLimitError, UnknownError, } from './infrastructure/InfrastructureError.js';
+export { AuthError, InvalidCredentialsError, TokenExpiredError, InvalidTokenError, PermissionDeniedError, ForbiddenError, UnauthenticatedError, } from './auth/AuthError.js';
+export { IntegrationError, EventPublishError, MessageQueueError, WebSocketError, EventSubscriptionError, } from './integration/IntegrationError.js';
+export { ErrorFactory } from './utils/errorFactory.js';
+export { isBeethovnError, isDomainError, isInfrastructureError, isAuthError, isIntegrationError, isRecoverableError, isClientSafeError, getErrorStatusCode, } from './utils/errorGuards.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;;;;;;GAMG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAGxD,OAAO,EACL,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,iBAAiB,GAClB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EACL,mBAAmB,EACnB,aAAa,EACb,YAAY,EACZ,oBAAoB,EACpB,YAAY,EACZ,cAAc,EACd,YAAY,GACb,MAAM,yCAAyC,CAAC;AAGjD,OAAO,EACL,SAAS,EACT,uBAAuB,EACvB,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,EACrB,cAAc,EACd,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,sBAAsB,GACvB,MAAM,mCAAmC,CAAC;AAG3C,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EACL,eAAe,EACf,aAAa,EACb,qBAAqB,EACrB,WAAW,EACX,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,wBAAwB,CAAC"}

package/dist/index.js

@@ -0,0 +1,21 @@
+/**
+ * @beethovn/errors
+ *
+ * Standardized error types for the Beethovn platform.
+ * Provides structured, typed errors with rich metadata for better
+ * debugging, logging, and monitoring.
+ */
+// Base error
+export { BeethovnError } from './base/BeethovnError.js';
+// Domain errors
+export { DomainError, ValidationError, BusinessRuleError, NotFoundError, ConflictError, InvalidStateError, } from './domain/DomainError.js';
+// Infrastructure errors
+export { InfrastructureError, DatabaseError, NetworkError, ExternalServiceError, TimeoutError, RateLimitError, UnknownError, } from './infrastructure/InfrastructureError.js';
+// Auth errors
+export { AuthError, InvalidCredentialsError, TokenExpiredError, InvalidTokenError, PermissionDeniedError, ForbiddenError, UnauthenticatedError, } from './auth/AuthError.js';
+// Integration errors
+export { IntegrationError, EventPublishError, MessageQueueError, WebSocketError, EventSubscriptionError, } from './integration/IntegrationError.js';
+// Utilities
+export { ErrorFactory } from './utils/errorFactory.js';
+export { isBeethovnError, isDomainError, isInfrastructureError, isAuthError, isIntegrationError, isRecoverableError, isClientSafeError, getErrorStatusCode, } from './utils/errorGuards.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;;;;;;GAMG;AAEH,aAAa;AACb,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAExD,gBAAgB;AAChB,OAAO,EACL,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,iBAAiB,GAClB,MAAM,yBAAyB,CAAC;AAEjC,wBAAwB;AACxB,OAAO,EACL,mBAAmB,EACnB,aAAa,EACb,YAAY,EACZ,oBAAoB,EACpB,YAAY,EACZ,cAAc,EACd,YAAY,GACb,MAAM,yCAAyC,CAAC;AAEjD,cAAc;AACd,OAAO,EACL,SAAS,EACT,uBAAuB,EACvB,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,EACrB,cAAc,EACd,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAE7B,qBAAqB;AACrB,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,sBAAsB,GACvB,MAAM,mCAAmC,CAAC;AAE3C,YAAY;AACZ,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EACL,eAAe,EACf,aAAa,EACb,qBAAqB,EACrB,WAAW,EACX,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,wBAAwB,CAAC"}

package/dist/infrastructure/InfrastructureError.d.ts

@@ -0,0 +1,98 @@
+import { BeethovnError } from '../base/BeethovnError.js';
+/**
+ * Base class for infrastructure/technical errors
+ *
+ * Infrastructure errors represent technical failures like database issues,
+ * network problems, or external service failures. These are typically recoverable.
+ */
+export declare abstract class InfrastructureError extends BeethovnError {
+    constructor(message: string, code: string, metadata?: Record<string, unknown>, recoverable?: boolean);
+}
+/**
+ * Database operation error
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await db.query(sql, params);
+ * } catch (error: unknown) {
+ *   throw new DatabaseError('saveUser', error);
+ * }
+ * ```
+ */
+export declare class DatabaseError extends InfrastructureError {
+    constructor(operation: string, originalError?: unknown, metadata?: Record<string, unknown>);
+}
+/**
+ * Network/connectivity error
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await fetch(url);
+ * } catch (error: unknown) {
+ *   throw new NetworkError('Failed to fetch user data', { url });
+ * }
+ * ```
+ */
+export declare class NetworkError extends InfrastructureError {
+    constructor(message: string, metadata?: Record<string, unknown>);
+}
+/**
+ * External service error
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await stripeClient.charge(amount);
+ * } catch (error: unknown) {
+ *   throw new ExternalServiceError(
+ *     'Stripe',
+ *     'createCharge',
+ *     error,
+ *     { amount, currency }
+ *   );
+ * }
+ * ```
+ */
+export declare class ExternalServiceError extends InfrastructureError {
+    constructor(service: string, operation: string, originalError?: unknown, metadata?: Record<string, unknown>);
+}
+/**
+ * Timeout error
+ *
+ * @example
+ * ```typescript
+ * throw new TimeoutError('Database query', 5000, { query: 'SELECT ...' });
+ * ```
+ */
+export declare class TimeoutError extends InfrastructureError {
+    constructor(operation: string, timeoutMs: number, metadata?: Record<string, unknown>);
+}
+/**
+ * Rate limit exceeded error
+ *
+ * @example
+ * ```typescript
+ * if (requestCount > limit) {
+ *   throw new RateLimitError(limit, requestCount, 60);
+ * }
+ * ```
+ */
+export declare class RateLimitError extends BeethovnError {
+    constructor(limit: number, current: number, retryAfterSeconds?: number, metadata?: Record<string, unknown>);
+}
+/**
+ * Unknown error - for errors that don't fit other categories
+ *
+ * @example
+ * ```typescript
+ * catch (error: unknown) {
+ *   throw new UnknownError(error, 'processPayment');
+ * }
+ * ```
+ */
+export declare class UnknownError extends InfrastructureError {
+    constructor(originalError: unknown, context?: string, metadata?: Record<string, unknown>);
+}
+//# sourceMappingURL=InfrastructureError.d.ts.map

package/dist/infrastructure/InfrastructureError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InfrastructureError.d.ts","sourceRoot":"","sources":["../../src/infrastructure/InfrastructureError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzD;;;;;GAKG;AACH,8BAAsB,mBAAoB,SAAQ,aAAa;gBAE3D,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EACtC,WAAW,GAAE,OAAc;CAI9B;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,aAAc,SAAQ,mBAAmB;gBAElD,SAAS,EAAE,MAAM,EACjB,aAAa,CAAC,EAAE,OAAO,EACvB,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;CAiBzC;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,YAAa,SAAQ,mBAAmB;gBAEjD,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;CAIzC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,oBAAqB,SAAQ,mBAAmB;gBAEzD,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,aAAa,CAAC,EAAE,OAAO,EACvB,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;CAkBzC;AAED;;;;;;;GAOG;AACH,qBAAa,YAAa,SAAQ,mBAAmB;gBAEjD,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;CASzC;AAED;;;;;;;;;GASG;AACH,qBAAa,cAAe,SAAQ,aAAa;gBAE7C,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,iBAAiB,CAAC,EAAE,MAAM,EAC1B,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;CAezC;AAED;;;;;;;;;GASG;AACH,qBAAa,YAAa,SAAQ,mBAAmB;gBAEjD,aAAa,EAAE,OAAO,EACtB,OAAO,CAAC,EAAE,MAAM,EAChB,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;CAuBzC"}

package/dist/infrastructure/InfrastructureError.js

@@ -0,0 +1,144 @@
+import { BeethovnError } from '../base/BeethovnError.js';
+/**
+ * Base class for infrastructure/technical errors
+ *
+ * Infrastructure errors represent technical failures like database issues,
+ * network problems, or external service failures. These are typically recoverable.
+ */
+export class InfrastructureError extends BeethovnError {
+    constructor(message, code, metadata = {}, recoverable = true) {
+        super(message, code, 503, metadata, recoverable);
+    }
+}
+/**
+ * Database operation error
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await db.query(sql, params);
+ * } catch (error: unknown) {
+ *   throw new DatabaseError('saveUser', error);
+ * }
+ * ```
+ */
+export class DatabaseError extends InfrastructureError {
+    constructor(operation, originalError, metadata = {}) {
+        const errorMessage = originalError instanceof Error
+            ? originalError.message
+            : String(originalError);
+        super(`Database ${operation} failed: ${errorMessage}`, 'DATABASE_ERROR', {
+            ...metadata,
+            operation,
+            originalError: errorMessage,
+        }, true);
+    }
+}
+/**
+ * Network/connectivity error
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await fetch(url);
+ * } catch (error: unknown) {
+ *   throw new NetworkError('Failed to fetch user data', { url });
+ * }
+ * ```
+ */
+export class NetworkError extends InfrastructureError {
+    constructor(message, metadata = {}) {
+        super(message, 'NETWORK_ERROR', metadata, true);
+    }
+}
+/**
+ * External service error
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await stripeClient.charge(amount);
+ * } catch (error: unknown) {
+ *   throw new ExternalServiceError(
+ *     'Stripe',
+ *     'createCharge',
+ *     error,
+ *     { amount, currency }
+ *   );
+ * }
+ * ```
+ */
+export class ExternalServiceError extends InfrastructureError {
+    constructor(service, operation, originalError, metadata = {}) {
+        const errorMessage = originalError instanceof Error
+            ? originalError.message
+            : String(originalError);
+        super(`${service} ${operation} failed: ${errorMessage}`, 'EXTERNAL_SERVICE_ERROR', {
+            ...metadata,
+            service,
+            operation,
+            originalError: errorMessage,
+        }, true);
+    }
+}
+/**
+ * Timeout error
+ *
+ * @example
+ * ```typescript
+ * throw new TimeoutError('Database query', 5000, { query: 'SELECT ...' });
+ * ```
+ */
+export class TimeoutError extends InfrastructureError {
+    constructor(operation, timeoutMs, metadata = {}) {
+        super(`${operation} timed out after ${timeoutMs}ms`, 'TIMEOUT_ERROR', { ...metadata, operation, timeoutMs }, true);
+    }
+}
+/**
+ * Rate limit exceeded error
+ *
+ * @example
+ * ```typescript
+ * if (requestCount > limit) {
+ *   throw new RateLimitError(limit, requestCount, 60);
+ * }
+ * ```
+ */
+export class RateLimitError extends BeethovnError {
+    constructor(limit, current, retryAfterSeconds, metadata = {}) {
+        super(`Rate limit exceeded: ${current}/${limit} requests`, 'RATE_LIMIT_ERROR', 429, {
+            ...metadata,
+            limit,
+            current,
+            retryAfterSeconds,
+        }, true);
+    }
+}
+/**
+ * Unknown error - for errors that don't fit other categories
+ *
+ * @example
+ * ```typescript
+ * catch (error: unknown) {
+ *   throw new UnknownError(error, 'processPayment');
+ * }
+ * ```
+ */
+export class UnknownError extends InfrastructureError {
+    constructor(originalError, context, metadata = {}) {
+        const message = originalError instanceof Error
+            ? originalError.message
+            : String(originalError);
+        const stack = originalError instanceof Error
+            ? originalError.stack
+            : undefined;
+        super(message || 'An unknown error occurred', 'UNKNOWN_ERROR', {
+            ...metadata,
+            originalError: message,
+            errorType: typeof originalError,
+            context,
+            stack,
+        }, false);
+    }
+}
+//# sourceMappingURL=InfrastructureError.js.map

package/dist/infrastructure/InfrastructureError.js.map

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

package/dist/integration/IntegrationError.d.ts

@@ -0,0 +1,71 @@
+import { BeethovnError } from '../base/BeethovnError.js';
+/**
+ * Base class for integration errors
+ *
+ * Integration errors represent failures in event publishing, message queues,
+ * and other inter-service communication mechanisms.
+ */
+export declare abstract class IntegrationError extends BeethovnError {
+    constructor(message: string, code: string, metadata?: Record<string, unknown>, recoverable?: boolean);
+}
+/**
+ * Event publishing error
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await eventBus.publish(event);
+ * } catch (error: unknown) {
+ *   throw new EventPublishError(event.type, error, { eventId: event.id });
+ * }
+ * ```
+ */
+export declare class EventPublishError extends IntegrationError {
+    constructor(eventType: string, originalError?: unknown, metadata?: Record<string, unknown>);
+}
+/**
+ * Message queue error
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await messageQueue.send(message);
+ * } catch (error: unknown) {
+ *   throw new MessageQueueError('send', 'payment-queue', error);
+ * }
+ * ```
+ */
+export declare class MessageQueueError extends IntegrationError {
+    constructor(operation: string, queue: string, originalError?: unknown, metadata?: Record<string, unknown>);
+}
+/**
+ * WebSocket connection error
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await ws.connect();
+ * } catch (error: unknown) {
+ *   throw new WebSocketError('connect', error, { url });
+ * }
+ * ```
+ */
+export declare class WebSocketError extends IntegrationError {
+    constructor(operation: string, originalError?: unknown, metadata?: Record<string, unknown>);
+}
+/**
+ * Event subscription error
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   eventBus.subscribe('OrderCreated', handler);
+ * } catch (error: unknown) {
+ *   throw new EventSubscriptionError('OrderCreated', error);
+ * }
+ * ```
+ */
+export declare class EventSubscriptionError extends IntegrationError {
+    constructor(eventType: string, originalError?: unknown, metadata?: Record<string, unknown>);
+}
+//# sourceMappingURL=IntegrationError.d.ts.map

package/dist/integration/IntegrationError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IntegrationError.d.ts","sourceRoot":"","sources":["../../src/integration/IntegrationError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzD;;;;;GAKG;AACH,8BAAsB,gBAAiB,SAAQ,aAAa;gBAExD,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EACtC,WAAW,GAAE,OAAc;CAI9B;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,iBAAkB,SAAQ,gBAAgB;gBAEnD,SAAS,EAAE,MAAM,EACjB,aAAa,CAAC,EAAE,OAAO,EACvB,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;CAiBzC;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,iBAAkB,SAAQ,gBAAgB;gBAEnD,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,aAAa,CAAC,EAAE,OAAO,EACvB,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;CAkBzC;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,cAAe,SAAQ,gBAAgB;gBAEhD,SAAS,EAAE,MAAM,EACjB,aAAa,CAAC,EAAE,OAAO,EACvB,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;CAiBzC;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,sBAAuB,SAAQ,gBAAgB;gBAExD,SAAS,EAAE,MAAM,EACjB,aAAa,CAAC,EAAE,OAAO,EACvB,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;CAiBzC"}