@procedures/client 0.0.0-stage → 0.1.0

package/dist/client/errors/registry.js

@@ -0,0 +1,535 @@
+/**
+ * Universal Error Registry
+ *
+ * Central source of truth for all error codes across all transports.
+ * Each error code has rich metadata including summary, detail, category, etc.
+ *
+ * NO MAGIC STRINGS - everything is defined in the registry!
+ */
+import { ErrorCategory, ErrorSeverity, } from "./types.js";
+import { HTTP_ERROR_REGISTRY } from "./http-errors.js";
+import { ErrorCode } from "./codes.js";
+/**
+ * Create error metadata with defaults.
+ */
+function defineError(code, meta) {
+    const result = {
+        code,
+        summary: meta.summary,
+        detail: meta.detail,
+        category: meta.category,
+        retryable: meta.retryable,
+        severity: meta.severity,
+        userMessage: meta.userMessage,
+        devMessage: meta.devMessage,
+    };
+    if (meta.httpStatus !== undefined) {
+        result.httpStatus = meta.httpStatus;
+    }
+    if (meta.suggestions !== undefined) {
+        result.suggestions = meta.suggestions;
+    }
+    if (meta.docsUrl !== undefined) {
+        result.docsUrl = meta.docsUrl;
+    }
+    return result;
+}
+/**
+ * Universal Error Registry
+ *
+ * Protocol-agnostic error codes with rich metadata.
+ */
+export const ERROR_REGISTRY = {
+    //
+    // ═══ Network Errors ═══
+    //
+    [ErrorCode.NETWORK_ERROR]: defineError(ErrorCode.NETWORK_ERROR, {
+        summary: "Network error occurred",
+        detail: "Failed to establish or maintain network connection. This typically indicates connectivity issues, DNS resolution failures, or network infrastructure problems.",
+        category: ErrorCategory.NETWORK,
+        retryable: true,
+        severity: ErrorSeverity.ERROR,
+        userMessage: "Unable to connect to the server. Please check your internet connection.",
+        devMessage: "Network-level failure during request execution. Check connectivity, DNS, proxies.",
+        suggestions: [
+            "Check your internet connection",
+            "Verify the server is accessible",
+            "Check for proxy or firewall issues",
+        ],
+    }),
+    CONNECTION_REFUSED: defineError(ErrorCode.CONNECTION_REFUSED, {
+        summary: "Connection refused by server",
+        detail: "The server actively refused the connection. This typically means the server is not running, the port is blocked, or a firewall is rejecting the connection.",
+        category: ErrorCategory.NETWORK,
+        retryable: true,
+        severity: ErrorSeverity.ERROR,
+        userMessage: "The server refused the connection. Please try again later.",
+        devMessage: "Server refused TCP connection. Verify server is running and port is accessible.",
+        suggestions: [
+            "Verify the server is running",
+            "Check the port number is correct",
+            "Check firewall rules",
+        ],
+    }),
+    DNS_ERROR: defineError(ErrorCode.DNS_ERROR, {
+        summary: "DNS resolution failed",
+        detail: "Failed to resolve the hostname to an IP address. This indicates DNS server issues or invalid hostname.",
+        category: ErrorCategory.NETWORK,
+        retryable: true,
+        severity: ErrorSeverity.ERROR,
+        userMessage: "Unable to find the server. Please check the server address.",
+        devMessage: "DNS lookup failed. Check hostname and DNS server configuration.",
+        suggestions: [
+            "Verify the hostname is correct",
+            "Check DNS server settings",
+            "Try using an IP address directly",
+        ],
+    }),
+    //
+    // ═══ Timeout Errors ═══
+    //
+    TIMEOUT: defineError(ErrorCode.TIMEOUT, {
+        summary: "Request timed out",
+        detail: "The request exceeded the configured timeout duration. This may indicate slow server response, network congestion, or overly aggressive timeout settings.",
+        category: ErrorCategory.TIMEOUT,
+        retryable: true,
+        severity: ErrorSeverity.WARNING,
+        userMessage: "The request took too long to complete. Please try again.",
+        devMessage: "Request exceeded timeout threshold. Consider increasing timeout or optimizing server response time.",
+        httpStatus: 408,
+        suggestions: [
+            "Try again with a longer timeout",
+            "Check server performance",
+            "Verify network latency",
+        ],
+    }),
+    CONNECTION_TIMEOUT: defineError(ErrorCode.CONNECTION_TIMEOUT, {
+        summary: "Connection timeout",
+        detail: "Failed to establish connection within the timeout period. This indicates slow network or unresponsive server.",
+        category: ErrorCategory.TIMEOUT,
+        retryable: true,
+        severity: ErrorSeverity.WARNING,
+        userMessage: "Unable to connect to the server in time. Please try again.",
+        devMessage: "TCP connection handshake timed out. Check network latency and server responsiveness.",
+        suggestions: [
+            "Increase connection timeout",
+            "Check network latency",
+            "Verify server is responding",
+        ],
+    }),
+    READ_TIMEOUT: defineError(ErrorCode.READ_TIMEOUT, {
+        summary: "Read timeout",
+        detail: "Server accepted the connection but failed to send response within timeout period.",
+        category: ErrorCategory.TIMEOUT,
+        retryable: true,
+        severity: ErrorSeverity.WARNING,
+        userMessage: "The server is taking too long to respond. Please try again.",
+        devMessage: "Server accepted request but response timed out. Check server processing time.",
+        suggestions: [
+            "Increase read timeout",
+            "Check server performance",
+            "Verify request isn't causing long processing",
+        ],
+    }),
+    //
+    // ═══ Cancellation Errors ═══
+    //
+    ABORTED: defineError(ErrorCode.ABORTED, {
+        summary: "Request was aborted",
+        detail: "The request was explicitly cancelled by the client via AbortSignal. This is user-initiated.",
+        category: ErrorCategory.CANCELLED,
+        retryable: false,
+        severity: ErrorSeverity.INFO,
+        userMessage: "The request was cancelled.",
+        devMessage: "Request aborted via AbortSignal. This is expected and not an error condition.",
+        suggestions: ["This is intentional - no action needed"],
+    }),
+    DEADLINE_EXCEEDED: defineError(ErrorCode.DEADLINE_EXCEEDED, {
+        summary: "Deadline exceeded",
+        detail: "The overall deadline for the operation (including retries) was exceeded.",
+        category: ErrorCategory.TIMEOUT,
+        retryable: false,
+        severity: ErrorSeverity.ERROR,
+        userMessage: "The operation took too long to complete.",
+        devMessage: "Overall deadline exceeded across all retry attempts. Consider increasing overall timeout.",
+        suggestions: [
+            "Increase overall deadline",
+            "Reduce per-attempt timeout to allow more retries",
+            "Optimize operation to complete faster",
+        ],
+    }),
+    //
+    // ═══ Protocol/Parsing Errors ═══
+    //
+    PARSE_ERROR: defineError(ErrorCode.PARSE_ERROR, {
+        summary: "Failed to parse response",
+        detail: "The response body could not be parsed. This typically indicates invalid JSON, corrupted data, or protocol mismatch.",
+        category: ErrorCategory.PROTOCOL,
+        retryable: false,
+        severity: ErrorSeverity.ERROR,
+        userMessage: "Received invalid response from server. Please contact support.",
+        devMessage: "Failed to parse response body. Check content-type and response format match expectations.",
+        suggestions: [
+            "Verify response content-type header",
+            "Check server is returning expected format",
+            "Inspect raw response body for corruption",
+        ],
+    }),
+    SERIALIZE_ERROR: defineError(ErrorCode.SERIALIZE_ERROR, {
+        summary: "Failed to serialize request",
+        detail: "The request payload could not be serialized. This indicates invalid data structure or circular references.",
+        category: ErrorCategory.PROTOCOL,
+        retryable: false,
+        severity: ErrorSeverity.ERROR,
+        userMessage: "Failed to send request. Please contact support.",
+        devMessage: "Failed to serialize request payload. Check for circular references or unsupported types.",
+        suggestions: [
+            "Check payload for circular references",
+            "Verify all values are serializable",
+            "Review payload structure",
+        ],
+    }),
+    INVALID_RESPONSE: defineError(ErrorCode.INVALID_RESPONSE, {
+        summary: "Invalid response format",
+        detail: "The response format doesn't match the expected schema. This indicates API version mismatch or protocol violation.",
+        category: ErrorCategory.PROTOCOL,
+        retryable: false,
+        severity: ErrorSeverity.ERROR,
+        userMessage: "Received unexpected response from server. Please contact support.",
+        devMessage: "Response schema doesn't match expected format. Check API version compatibility.",
+        suggestions: [
+            "Verify API version compatibility",
+            "Check response schema matches expectations",
+            "Review API documentation",
+        ],
+    }),
+    PROTOCOL_ERROR: defineError(ErrorCode.PROTOCOL_ERROR, {
+        summary: "Protocol violation",
+        detail: "A violation of the transport protocol occurred. This indicates implementation bugs or version mismatch.",
+        category: ErrorCategory.PROTOCOL,
+        retryable: false,
+        severity: ErrorSeverity.ERROR,
+        userMessage: "Communication error with server. Please contact support.",
+        devMessage: "Transport protocol violation detected. Check client/server version compatibility.",
+        suggestions: [
+            "Verify client and server versions are compatible",
+            "Check protocol implementation",
+            "Review transport adapter code",
+        ],
+    }),
+    //
+    // ═══ Client Errors (4xx) ═══
+    //
+    BAD_REQUEST: defineError(ErrorCode.BAD_REQUEST, {
+        summary: "Bad request",
+        detail: "The request is malformed or contains invalid data. Server cannot process it.",
+        category: ErrorCategory.CLIENT,
+        retryable: false,
+        severity: ErrorSeverity.ERROR,
+        userMessage: "The request is invalid. Please check your input and try again.",
+        devMessage: "Request validation failed. Check payload structure and required fields.",
+        httpStatus: 400,
+        suggestions: [
+            "Validate request payload",
+            "Check required fields are present",
+            "Verify data types match expectations",
+        ],
+    }),
+    UNAUTHORIZED: defineError(ErrorCode.UNAUTHORIZED, {
+        summary: "Unauthorized",
+        detail: "Authentication is required but was not provided or is invalid.",
+        category: ErrorCategory.AUTH,
+        retryable: false,
+        severity: ErrorSeverity.ERROR,
+        userMessage: "Authentication required. Please sign in.",
+        devMessage: "Missing or invalid authentication credentials. Check auth token/API key.",
+        httpStatus: 401,
+        suggestions: [
+            "Provide valid authentication credentials",
+            "Check token hasn't expired",
+            "Verify API key is correct",
+        ],
+    }),
+    FORBIDDEN: defineError(ErrorCode.FORBIDDEN, {
+        summary: "Forbidden",
+        detail: "The authenticated user doesn't have permission to access this resource.",
+        category: ErrorCategory.AUTH,
+        retryable: false,
+        severity: ErrorSeverity.ERROR,
+        userMessage: "You don't have permission to access this resource.",
+        devMessage: "Insufficient permissions. Check user roles and resource ACLs.",
+        httpStatus: 403,
+        suggestions: [
+            "Verify user has required permissions",
+            "Check resource access control lists",
+            "Contact administrator for access",
+        ],
+    }),
+    NOT_FOUND: defineError(ErrorCode.NOT_FOUND, {
+        summary: "Not found",
+        detail: "The requested resource does not exist.",
+        category: ErrorCategory.CLIENT,
+        retryable: false,
+        severity: ErrorSeverity.ERROR,
+        userMessage: "The requested item was not found.",
+        devMessage: "Resource not found. Verify ID/path is correct and resource exists.",
+        httpStatus: 404,
+        suggestions: [
+            "Verify the resource ID is correct",
+            "Check the resource hasn't been deleted",
+            "Review API endpoint path",
+        ],
+    }),
+    METHOD_NOT_ALLOWED: defineError(ErrorCode.METHOD_NOT_ALLOWED, {
+        summary: "Method not allowed",
+        detail: "The HTTP method is not supported for this endpoint.",
+        category: ErrorCategory.CLIENT,
+        retryable: false,
+        severity: ErrorSeverity.ERROR,
+        userMessage: "This operation is not supported.",
+        devMessage: "HTTP method not allowed for this endpoint. Check API documentation for supported methods.",
+        httpStatus: 405,
+        suggestions: [
+            "Check the correct HTTP method for this operation",
+            "Review API documentation",
+            "Verify endpoint path is correct",
+        ],
+    }),
+    CONFLICT: defineError(ErrorCode.CONFLICT, {
+        summary: "Conflict",
+        detail: "The request conflicts with the current state of the resource.",
+        category: ErrorCategory.CLIENT,
+        retryable: false,
+        severity: ErrorSeverity.ERROR,
+        userMessage: "This operation conflicts with the current state. Please refresh and try again.",
+        devMessage: "State conflict detected. Check for concurrent modifications or constraint violations.",
+        httpStatus: 409,
+        suggestions: [
+            "Refresh resource state",
+            "Check for concurrent modifications",
+            "Verify resource constraints",
+        ],
+    }),
+    PAYLOAD_TOO_LARGE: defineError(ErrorCode.PAYLOAD_TOO_LARGE, {
+        summary: "Payload too large",
+        detail: "The request payload exceeds the maximum allowed size.",
+        category: ErrorCategory.CLIENT,
+        retryable: false,
+        severity: ErrorSeverity.ERROR,
+        userMessage: "The request is too large. Please reduce the amount of data and try again.",
+        devMessage: "Request exceeds maximum payload size. Check server limits and reduce payload.",
+        httpStatus: 413,
+        suggestions: [
+            "Reduce payload size",
+            "Split request into multiple smaller requests",
+            "Check server payload size limits",
+        ],
+    }),
+    UNPROCESSABLE_ENTITY: defineError(ErrorCode.UNPROCESSABLE_ENTITY, {
+        summary: "Unprocessable entity",
+        detail: "The request is well-formed but contains semantic errors.",
+        category: ErrorCategory.CLIENT,
+        retryable: false,
+        severity: ErrorSeverity.ERROR,
+        userMessage: "The request contains invalid data. Please check your input.",
+        devMessage: "Semantic validation failed. Check business logic constraints and data relationships.",
+        httpStatus: 422,
+        suggestions: [
+            "Validate business logic constraints",
+            "Check data relationships",
+            "Review validation error details",
+        ],
+    }),
+    TOO_MANY_REQUESTS: defineError(ErrorCode.TOO_MANY_REQUESTS, {
+        summary: "Too many requests",
+        detail: "Rate limit exceeded. Too many requests in a given timeframe.",
+        category: ErrorCategory.RATE_LIMIT,
+        retryable: true,
+        severity: ErrorSeverity.WARNING,
+        userMessage: "Too many requests. Please wait and try again.",
+        devMessage: "Rate limit exceeded. Implement backoff and check rate limit headers.",
+        httpStatus: 429,
+        suggestions: [
+            "Implement exponential backoff",
+            "Check Retry-After header",
+            "Reduce request rate",
+            "Consider request batching",
+        ],
+    }),
+    //
+    // ═══ Server Errors (5xx) ═══
+    //
+    INTERNAL_ERROR: defineError(ErrorCode.INTERNAL_ERROR, {
+        summary: "Internal server error",
+        detail: "The server encountered an unexpected condition. This is a server-side bug.",
+        category: ErrorCategory.SERVER,
+        retryable: true,
+        severity: ErrorSeverity.CRITICAL,
+        userMessage: "Server error occurred. Please try again later.",
+        devMessage: "Internal server error. Check server logs for details.",
+        httpStatus: 500,
+        suggestions: [
+            "Retry the request",
+            "Check server logs",
+            "Contact server team",
+        ],
+    }),
+    NOT_IMPLEMENTED: defineError(ErrorCode.NOT_IMPLEMENTED, {
+        summary: "Not implemented",
+        detail: "The server doesn't support this operation yet.",
+        category: ErrorCategory.SERVER,
+        retryable: false,
+        severity: ErrorSeverity.ERROR,
+        userMessage: "This feature is not available yet.",
+        devMessage: "Operation not implemented on server. Check API version and feature availability.",
+        httpStatus: 501,
+        suggestions: [
+            "Check API version",
+            "Review feature availability",
+            "Use alternative endpoint if available",
+        ],
+    }),
+    BAD_GATEWAY: defineError(ErrorCode.BAD_GATEWAY, {
+        summary: "Bad gateway",
+        detail: "The gateway or proxy received an invalid response from upstream server.",
+        category: ErrorCategory.SERVER,
+        retryable: true,
+        severity: ErrorSeverity.ERROR,
+        userMessage: "Server communication error. Please try again.",
+        devMessage: "Gateway received invalid upstream response. Check proxy/gateway logs.",
+        httpStatus: 502,
+        suggestions: [
+            "Retry the request",
+            "Check gateway/proxy health",
+            "Verify upstream server is functioning",
+        ],
+    }),
+    SERVICE_UNAVAILABLE: defineError(ErrorCode.SERVICE_UNAVAILABLE, {
+        summary: "Service unavailable",
+        detail: "The server is temporarily unable to handle requests. May be overloaded or under maintenance.",
+        category: ErrorCategory.SERVER,
+        retryable: true,
+        severity: ErrorSeverity.WARNING,
+        userMessage: "Service temporarily unavailable. Please try again later.",
+        devMessage: "Server temporarily unavailable. Check Retry-After header and server status.",
+        httpStatus: 503,
+        suggestions: [
+            "Check Retry-After header",
+            "Implement exponential backoff",
+            "Check service status page",
+        ],
+    }),
+    GATEWAY_TIMEOUT: defineError(ErrorCode.GATEWAY_TIMEOUT, {
+        summary: "Gateway timeout",
+        detail: "The gateway or proxy timed out waiting for upstream server response.",
+        category: ErrorCategory.TIMEOUT,
+        retryable: true,
+        severity: ErrorSeverity.ERROR,
+        userMessage: "Server timeout. Please try again.",
+        devMessage: "Gateway timeout waiting for upstream. Check upstream server response time.",
+        httpStatus: 504,
+        suggestions: [
+            "Retry the request",
+            "Check upstream server performance",
+            "Increase gateway timeout if reasonable",
+        ],
+    }),
+    //
+    // ═══ Configuration Errors ═══
+    //
+    INVALID_CONFIG: defineError(ErrorCode.INVALID_CONFIG, {
+        summary: "Invalid configuration",
+        detail: "The client or transport configuration is invalid.",
+        category: ErrorCategory.CLIENT,
+        retryable: false,
+        severity: ErrorSeverity.CRITICAL,
+        userMessage: "Configuration error. Please contact support.",
+        devMessage: "Invalid client/transport configuration. Review initialization parameters.",
+        suggestions: [
+            "Review configuration parameters",
+            "Check required fields are provided",
+            "Verify configuration schema",
+        ],
+    }),
+    INVALID_URL: defineError(ErrorCode.INVALID_URL, {
+        summary: "Invalid URL",
+        detail: "The provided URL is malformed or invalid.",
+        category: ErrorCategory.CLIENT,
+        retryable: false,
+        severity: ErrorSeverity.ERROR,
+        userMessage: "Invalid server address.",
+        devMessage: "URL parsing failed. Check URL format and components.",
+        suggestions: [
+            "Verify URL format is correct",
+            "Check protocol (http/https)",
+            "Verify hostname is valid",
+        ],
+    }),
+    INVALID_METHOD: defineError(ErrorCode.INVALID_METHOD, {
+        summary: "Invalid method",
+        detail: "The method specification is invalid or malformed.",
+        category: ErrorCategory.CLIENT,
+        retryable: false,
+        severity: ErrorSeverity.ERROR,
+        userMessage: "Invalid operation.",
+        devMessage: "Method specification is invalid. Check service/operation names.",
+        suggestions: [
+            "Verify method structure is correct",
+            "Check service and operation names",
+            "Review Method type definition",
+        ],
+    }),
+    //
+    // ═══ Unknown ═══
+    //
+    UNKNOWN: defineError(ErrorCode.UNKNOWN, {
+        summary: "Unknown error",
+        detail: "An unexpected error occurred that couldn't be categorized.",
+        category: ErrorCategory.UNKNOWN,
+        retryable: false,
+        severity: ErrorSeverity.ERROR,
+        userMessage: "An unexpected error occurred. Please try again or contact support.",
+        devMessage: "Uncategorized error. Check error details and logs for more information.",
+        suggestions: [
+            "Check error message for details",
+            "Review logs",
+            "Contact support if error persists",
+        ],
+    }),
+    // Merge HTTP-specific errors
+    ...HTTP_ERROR_REGISTRY,
+};
+/**
+ * Get error metadata by code.
+ *
+ * Returns UNKNOWN metadata if code not found in registry.
+ */
+export function getErrorMetadata(code) {
+    return ERROR_REGISTRY[code] ?? ERROR_REGISTRY["UNKNOWN"];
+}
+/**
+ * Check if an error code exists in the registry.
+ */
+export function isKnownError(code) {
+    return code in ERROR_REGISTRY;
+}
+/**
+ * Get all error codes by category.
+ */
+export function getErrorsByCategory(category) {
+    return Object.values(ERROR_REGISTRY).filter((meta) => meta.category === category);
+}
+/**
+ * Get all retryable error codes.
+ */
+export function getRetryableErrors() {
+    return Object.values(ERROR_REGISTRY).filter((meta) => meta.retryable);
+}
+/**
+ * Map HTTP status code to error code.
+ */
+export function httpStatusToErrorCode(status) {
+    const match = Object.values(ERROR_REGISTRY).find((meta) => meta.httpStatus === status);
+    return match?.code ?? "UNKNOWN";
+}
+//# sourceMappingURL=registry.js.map

package/dist/client/errors/registry.js.map

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

package/dist/client/errors/types.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Universal Error System - Type Definitions
+ *
+ * Protocol-agnostic error metadata system.
+ * Works across HTTP, WebSocket, gRPC, Local transports.
+ */
+/**
+ * Error severity levels.
+ */
+export declare enum ErrorSeverity {
+    /** Informational - not an actual error */
+    INFO = "info",
+    /** Warning - degraded but functional */
+    WARNING = "warning",
+    /** Error - operation failed */
+    ERROR = "error",
+    /** Critical - system-level failure */
+    CRITICAL = "critical"
+}
+/**
+ * Error categories for classification.
+ */
+export declare enum ErrorCategory {
+    /** Network-level errors (connectivity, DNS, etc.) */
+    NETWORK = "network",
+    /** Client-side errors (validation, configuration) */
+    CLIENT = "client",
+    /** Server-side errors (5xx, internal errors) */
+    SERVER = "server",
+    /** Protocol-level errors (parsing, encoding) */
+    PROTOCOL = "protocol",
+    /** Authentication/authorization errors */
+    AUTH = "auth",
+    /** Rate limiting and throttling */
+    RATE_LIMIT = "rate_limit",
+    /** Timeout errors */
+    TIMEOUT = "timeout",
+    /** Cancellation errors */
+    CANCELLED = "cancelled",
+    /** Unknown/uncategorized errors */
+    UNKNOWN = "unknown"
+}
+/**
+ * Complete error metadata for an error code.
+ *
+ * Central registry entry containing all information about an error.
+ */
+export interface ErrorMetadata {
+    /** Unique error code identifier */
+    code: string;
+    /** Short human-readable summary (1 line) */
+    summary: string;
+    /** Detailed explanation of what this error means */
+    detail: string;
+    /** Error category for classification */
+    category: ErrorCategory;
+    /** Whether this error is retryable */
+    retryable: boolean;
+    /** Severity level */
+    severity: ErrorSeverity;
+    /** End-user friendly message (non-technical) */
+    userMessage: string;
+    /** Developer-facing diagnostic message */
+    devMessage: string;
+    /** HTTP status code (if applicable) */
+    httpStatus?: number;
+    /** Suggested user actions */
+    suggestions?: string[];
+    /** Related documentation URL */
+    docsUrl?: string;
+}
+/**
+ * Error registry - maps error codes to metadata.
+ */
+export type ErrorRegistry = Record<string, ErrorMetadata>;
+/**
+ * Error context - runtime information attached to an error.
+ */
+export interface ErrorContext {
+    /** Timestamp when error occurred */
+    timestamp: number;
+    /** Request ID for correlation */
+    requestId?: string;
+    /** Transport that generated the error */
+    transport?: string;
+    /** Method that was being called */
+    method?: {
+        service: string;
+        operation: string;
+        version?: string;
+    };
+    /** Additional runtime context */
+    [key: string]: unknown;
+}
+/**
+ * Rich error details combining metadata and context.
+ */
+export interface RichError {
+    /** Error code from registry */
+    code: string;
+    /** Error metadata (summary, detail, etc.) */
+    metadata: ErrorMetadata;
+    /** Runtime context */
+    context: ErrorContext;
+    /** Original cause (if wrapped) */
+    cause?: Error;
+}
+/**
+ * Error factory function type.
+ */
+export type ErrorFactory = (code: string, context?: Partial<ErrorContext>, cause?: Error) => RichError;
+//# sourceMappingURL=types.d.ts.map

package/dist/client/errors/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/client/errors/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,oBAAY,aAAa;IACvB,0CAA0C;IAC1C,IAAI,SAAS;IACb,wCAAwC;IACxC,OAAO,YAAY;IACnB,+BAA+B;IAC/B,KAAK,UAAU;IACf,sCAAsC;IACtC,QAAQ,aAAa;CACtB;AAED;;GAEG;AACH,oBAAY,aAAa;IACvB,qDAAqD;IACrD,OAAO,YAAY;IACnB,qDAAqD;IACrD,MAAM,WAAW;IACjB,gDAAgD;IAChD,MAAM,WAAW;IACjB,gDAAgD;IAChD,QAAQ,aAAa;IACrB,0CAA0C;IAC1C,IAAI,SAAS;IACb,mCAAmC;IACnC,UAAU,eAAe;IACzB,qBAAqB;IACrB,OAAO,YAAY;IACnB,0BAA0B;IAC1B,SAAS,cAAc;IACvB,mCAAmC;IACnC,OAAO,YAAY;CACpB;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IAEb,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;IAEhB,oDAAoD;IACpD,MAAM,EAAE,MAAM,CAAC;IAEf,wCAAwC;IACxC,QAAQ,EAAE,aAAa,CAAC;IAExB,sCAAsC;IACtC,SAAS,EAAE,OAAO,CAAC;IAEnB,qBAAqB;IACrB,QAAQ,EAAE,aAAa,CAAC;IAExB,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;IAEpB,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC;IAEnB,uCAAuC;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,6BAA6B;IAC7B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IAEvB,gCAAgC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;IAElB,iCAAiC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,mCAAmC;IACnC,MAAM,CAAC,EAAE;QACP,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IAEF,iCAAiC;IACjC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;IAEb,6CAA6C;IAC7C,QAAQ,EAAE,aAAa,CAAC;IAExB,sBAAsB;IACtB,OAAO,EAAE,YAAY,CAAC;IAEtB,kCAAkC;IAClC,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,CACzB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,EAC/B,KAAK,CAAC,EAAE,KAAK,KACV,SAAS,CAAC"}