@procedures/client 0.0.0-stage → 0.2.0

package/dist/client/errors/codes.js

@@ -0,0 +1,81 @@
+/**
+ * Error Code Enums
+ *
+ * Comprehensive enum of ALL error codes.
+ * NO MAGIC STRINGS - use these enums everywhere!
+ */
+/**
+ * Universal Error Codes
+ *
+ * Protocol-agnostic error codes that work across all transports.
+ */
+export var ErrorCode;
+(function (ErrorCode) {
+    // Network errors
+    ErrorCode["NETWORK_ERROR"] = "NETWORK_ERROR";
+    ErrorCode["CONNECTION_REFUSED"] = "CONNECTION_REFUSED";
+    ErrorCode["DNS_ERROR"] = "DNS_ERROR";
+    // Timeout errors
+    ErrorCode["TIMEOUT"] = "TIMEOUT";
+    ErrorCode["CONNECTION_TIMEOUT"] = "CONNECTION_TIMEOUT";
+    ErrorCode["READ_TIMEOUT"] = "READ_TIMEOUT";
+    ErrorCode["DEADLINE_EXCEEDED"] = "DEADLINE_EXCEEDED";
+    // Cancellation
+    ErrorCode["ABORTED"] = "ABORTED";
+    // Protocol/parsing errors
+    ErrorCode["PARSE_ERROR"] = "PARSE_ERROR";
+    ErrorCode["SERIALIZE_ERROR"] = "SERIALIZE_ERROR";
+    ErrorCode["INVALID_RESPONSE"] = "INVALID_RESPONSE";
+    ErrorCode["PROTOCOL_ERROR"] = "PROTOCOL_ERROR";
+    // Client errors (4xx equivalent)
+    ErrorCode["BAD_REQUEST"] = "BAD_REQUEST";
+    ErrorCode["UNAUTHORIZED"] = "UNAUTHORIZED";
+    ErrorCode["FORBIDDEN"] = "FORBIDDEN";
+    ErrorCode["NOT_FOUND"] = "NOT_FOUND";
+    ErrorCode["METHOD_NOT_ALLOWED"] = "METHOD_NOT_ALLOWED";
+    ErrorCode["NOT_ACCEPTABLE"] = "NOT_ACCEPTABLE";
+    ErrorCode["PROXY_AUTHENTICATION_REQUIRED"] = "PROXY_AUTHENTICATION_REQUIRED";
+    ErrorCode["CONFLICT"] = "CONFLICT";
+    ErrorCode["GONE"] = "GONE";
+    ErrorCode["LENGTH_REQUIRED"] = "LENGTH_REQUIRED";
+    ErrorCode["PRECONDITION_FAILED"] = "PRECONDITION_FAILED";
+    ErrorCode["PAYLOAD_TOO_LARGE"] = "PAYLOAD_TOO_LARGE";
+    ErrorCode["URI_TOO_LONG"] = "URI_TOO_LONG";
+    ErrorCode["UNSUPPORTED_MEDIA_TYPE"] = "UNSUPPORTED_MEDIA_TYPE";
+    ErrorCode["RANGE_NOT_SATISFIABLE"] = "RANGE_NOT_SATISFIABLE";
+    ErrorCode["EXPECTATION_FAILED"] = "EXPECTATION_FAILED";
+    ErrorCode["IM_A_TEAPOT"] = "IM_A_TEAPOT";
+    ErrorCode["MISDIRECTED_REQUEST"] = "MISDIRECTED_REQUEST";
+    ErrorCode["UNPROCESSABLE_ENTITY"] = "UNPROCESSABLE_ENTITY";
+    ErrorCode["LOCKED"] = "LOCKED";
+    ErrorCode["FAILED_DEPENDENCY"] = "FAILED_DEPENDENCY";
+    ErrorCode["TOO_EARLY"] = "TOO_EARLY";
+    ErrorCode["UPGRADE_REQUIRED"] = "UPGRADE_REQUIRED";
+    ErrorCode["PRECONDITION_REQUIRED"] = "PRECONDITION_REQUIRED";
+    ErrorCode["TOO_MANY_REQUESTS"] = "TOO_MANY_REQUESTS";
+    ErrorCode["REQUEST_HEADER_FIELDS_TOO_LARGE"] = "REQUEST_HEADER_FIELDS_TOO_LARGE";
+    ErrorCode["UNAVAILABLE_FOR_LEGAL_REASONS"] = "UNAVAILABLE_FOR_LEGAL_REASONS";
+    ErrorCode["CLIENT_CLOSED_REQUEST"] = "CLIENT_CLOSED_REQUEST";
+    // Server errors (5xx equivalent)
+    ErrorCode["INTERNAL_ERROR"] = "INTERNAL_ERROR";
+    ErrorCode["NOT_IMPLEMENTED"] = "NOT_IMPLEMENTED";
+    ErrorCode["BAD_GATEWAY"] = "BAD_GATEWAY";
+    ErrorCode["SERVICE_UNAVAILABLE"] = "SERVICE_UNAVAILABLE";
+    ErrorCode["GATEWAY_TIMEOUT"] = "GATEWAY_TIMEOUT";
+    ErrorCode["HTTP_VERSION_NOT_SUPPORTED"] = "HTTP_VERSION_NOT_SUPPORTED";
+    ErrorCode["VARIANT_ALSO_NEGOTIATES"] = "VARIANT_ALSO_NEGOTIATES";
+    ErrorCode["INSUFFICIENT_STORAGE"] = "INSUFFICIENT_STORAGE";
+    ErrorCode["LOOP_DETECTED"] = "LOOP_DETECTED";
+    ErrorCode["NOT_EXTENDED"] = "NOT_EXTENDED";
+    ErrorCode["NETWORK_AUTHENTICATION_REQUIRED"] = "NETWORK_AUTHENTICATION_REQUIRED";
+    ErrorCode["HTTP_NETWORK_CONNECT_TIMEOUT"] = "HTTP_NETWORK_CONNECT_TIMEOUT";
+    // Configuration errors
+    ErrorCode["INVALID_CONFIG"] = "INVALID_CONFIG";
+    ErrorCode["INVALID_URL"] = "INVALID_URL";
+    ErrorCode["INVALID_METHOD"] = "INVALID_METHOD";
+    // HTTP-specific
+    ErrorCode["HTTP_ERROR"] = "HTTP_ERROR";
+    // Unknown
+    ErrorCode["UNKNOWN"] = "UNKNOWN";
+})(ErrorCode || (ErrorCode = {}));
+//# sourceMappingURL=codes.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"codes.js","sourceRoot":"","sources":["../../../src/client/errors/codes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;GAIG;AACH,MAAM,CAAN,IAAY,SA2EX;AA3ED,WAAY,SAAS;IACnB,iBAAiB;IACjB,4CAA+B,CAAA;IAC/B,sDAAyC,CAAA;IACzC,oCAAuB,CAAA;IAEvB,iBAAiB;IACjB,gCAAmB,CAAA;IACnB,sDAAyC,CAAA;IACzC,0CAA6B,CAAA;IAC7B,oDAAuC,CAAA;IAEvC,eAAe;IACf,gCAAmB,CAAA;IAEnB,0BAA0B;IAC1B,wCAA2B,CAAA;IAC3B,gDAAmC,CAAA;IACnC,kDAAqC,CAAA;IACrC,8CAAiC,CAAA;IAEjC,iCAAiC;IACjC,wCAA2B,CAAA;IAC3B,0CAA6B,CAAA;IAC7B,oCAAuB,CAAA;IACvB,oCAAuB,CAAA;IACvB,sDAAyC,CAAA;IACzC,8CAAiC,CAAA;IACjC,4EAA+D,CAAA;IAC/D,kCAAqB,CAAA;IACrB,0BAAa,CAAA;IACb,gDAAmC,CAAA;IACnC,wDAA2C,CAAA;IAC3C,oDAAuC,CAAA;IACvC,0CAA6B,CAAA;IAC7B,8DAAiD,CAAA;IACjD,4DAA+C,CAAA;IAC/C,sDAAyC,CAAA;IACzC,wCAA2B,CAAA;IAC3B,wDAA2C,CAAA;IAC3C,0DAA6C,CAAA;IAC7C,8BAAiB,CAAA;IACjB,oDAAuC,CAAA;IACvC,oCAAuB,CAAA;IACvB,kDAAqC,CAAA;IACrC,4DAA+C,CAAA;IAC/C,oDAAuC,CAAA;IACvC,gFAAmE,CAAA;IACnE,4EAA+D,CAAA;IAC/D,4DAA+C,CAAA;IAE/C,iCAAiC;IACjC,8CAAiC,CAAA;IACjC,gDAAmC,CAAA;IACnC,wCAA2B,CAAA;IAC3B,wDAA2C,CAAA;IAC3C,gDAAmC,CAAA;IACnC,sEAAyD,CAAA;IACzD,gEAAmD,CAAA;IACnD,0DAA6C,CAAA;IAC7C,4CAA+B,CAAA;IAC/B,0CAA6B,CAAA;IAC7B,gFAAmE,CAAA;IACnE,0EAA6D,CAAA;IAE7D,uBAAuB;IACvB,8CAAiC,CAAA;IACjC,wCAA2B,CAAA;IAC3B,8CAAiC,CAAA;IAEjC,gBAAgB;IAChB,sCAAyB,CAAA;IAEzB,UAAU;IACV,gCAAmB,CAAA;AACrB,CAAC,EA3EW,SAAS,KAAT,SAAS,QA2EpB"}

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

@@ -0,0 +1,102 @@
+/**
+ * Error Factory Functions
+ *
+ * Create rich errors from error codes with full metadata.
+ * Zero magic strings - everything driven by registry.
+ */
+import { type RichError, type ErrorContext, type ErrorMetadata } from "./types.js";
+import { ErrorCode } from "./codes.js";
+/**
+ * Create a rich error from an error code.
+ *
+ * @param code - Error code from registry
+ * @param context - Runtime context (optional)
+ * @param cause - Underlying error cause (optional)
+ * @returns Rich error with full metadata
+ *
+ * @example
+ * ```typescript
+ * const error = createError("TIMEOUT", {
+ *   requestId: "req-123",
+ *   transport: "http",
+ * });
+ *
+ * console.log(error.metadata.summary); // "Request timed out"
+ * console.log(error.metadata.userMessage); // "The request took too long..."
+ * console.log(error.metadata.suggestions); // ["Try again with longer timeout", ...]
+ * ```
+ */
+export declare function createError(code: string, context?: Partial<ErrorContext>, cause?: Error): RichError;
+/**
+ * Create error from HTTP status code.
+ *
+ * Uses registry lookup - zero magic strings!
+ *
+ * @param status - HTTP status code
+ * @param context - Runtime context
+ * @returns Rich error with appropriate error code
+ *
+ * @example
+ * ```typescript
+ * const error = createErrorFromHTTPStatus(404, {
+ *   requestId: "req-123",
+ *   method: { service: "users", operation: "get" },
+ * });
+ * ```
+ */
+export declare function createErrorFromHTTPStatus(status: number, context?: Partial<ErrorContext>): RichError;
+export type ErrorPattern = {
+    code: ErrorCode;
+    detect: (name: string, message: string) => boolean;
+};
+/**
+ * Create error from native Error exception.
+ *
+ * Uses pattern matching - no scattered magic strings!
+ *
+ * @param error - Native Error object
+ * @param context - Runtime context
+ * @returns Rich error
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await fetch(...);
+ * } catch (err) {
+ *   const richError = createErrorFromException(err as Error, {
+ *     transport: "http",
+ *   });
+ * }
+ * ```
+ */
+export declare function createErrorFromException(error: Error, context?: Partial<ErrorContext>): RichError;
+/**
+ * Convert RichError to Status for universal client.
+ *
+ * @param error - Rich error
+ * @returns Status object
+ */
+export declare function richErrorToStatus(error: RichError): {
+    type: "error";
+    code: string;
+    message: string;
+    retryable: boolean;
+    metadata: ErrorMetadata;
+};
+/**
+ * Format error for logging.
+ *
+ * @param error - Rich error
+ * @param includeStack - Include stack trace if cause exists
+ * @returns Formatted error string
+ */
+export declare function formatError(error: RichError, includeStack?: boolean): string;
+/**
+ * Check if error is retryable.
+ */
+export declare function isRetryable(error: RichError): boolean;
+/**
+ * Check if error is in a specific category.
+ */
+export declare function isErrorCategory(error: RichError, category: string): boolean;
+//# sourceMappingURL=factory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/client/errors/factory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,KAAK,aAAa,EACnB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,EAC/B,KAAK,CAAC,EAAE,KAAK,GACZ,SAAS,CAcX;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAC9B,SAAS,CAIX;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;CACpD,CAAA;AAyDD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,KAAK,EACZ,OAAO,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAC9B,SAAS,CASX;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,GAAG;IACnD,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,aAAa,CAAC;CACzB,CAQA;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,YAAY,UAAQ,GAAG,MAAM,CAwC1E;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAErD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,SAAS,EAChB,QAAQ,EAAE,MAAM,GACf,OAAO,CAET"}

package/dist/client/errors/factory.js

@@ -0,0 +1,210 @@
+/**
+ * Error Factory Functions
+ *
+ * Create rich errors from error codes with full metadata.
+ * Zero magic strings - everything driven by registry.
+ */
+import {} from "./types.js";
+import { getErrorMetadata } from "./registry.js";
+import { httpStatusToErrorCode } from "./http-errors.js";
+import { ErrorCode } from "./codes.js";
+/**
+ * Create a rich error from an error code.
+ *
+ * @param code - Error code from registry
+ * @param context - Runtime context (optional)
+ * @param cause - Underlying error cause (optional)
+ * @returns Rich error with full metadata
+ *
+ * @example
+ * ```typescript
+ * const error = createError("TIMEOUT", {
+ *   requestId: "req-123",
+ *   transport: "http",
+ * });
+ *
+ * console.log(error.metadata.summary); // "Request timed out"
+ * console.log(error.metadata.userMessage); // "The request took too long..."
+ * console.log(error.metadata.suggestions); // ["Try again with longer timeout", ...]
+ * ```
+ */
+export function createError(code, context, cause) {
+    const metadata = getErrorMetadata(code);
+    const fullContext = {
+        timestamp: Date.now(),
+        ...context,
+    };
+    return {
+        code,
+        metadata,
+        context: fullContext,
+        ...(cause && { cause }),
+    };
+}
+/**
+ * Create error from HTTP status code.
+ *
+ * Uses registry lookup - zero magic strings!
+ *
+ * @param status - HTTP status code
+ * @param context - Runtime context
+ * @returns Rich error with appropriate error code
+ *
+ * @example
+ * ```typescript
+ * const error = createErrorFromHTTPStatus(404, {
+ *   requestId: "req-123",
+ *   method: { service: "users", operation: "get" },
+ * });
+ * ```
+ */
+export function createErrorFromHTTPStatus(status, context) {
+    // Use registry - no magic strings!
+    const code = httpStatusToErrorCode(status);
+    return createError(code, context);
+}
+/**
+ * Error detection patterns.
+ *
+ * Maps error characteristics to error codes.
+ * Uses ErrorCode enum - NO MAGIC STRINGS!
+ */
+const ERROR_PATTERNS = [
+    {
+        code: ErrorCode.ABORTED,
+        detect: (name, message) => name === "aborterror" || message.includes("abort"),
+    },
+    {
+        code: ErrorCode.TIMEOUT,
+        detect: (name, message) => name === "timeouterror" ||
+            message.includes("timeout") ||
+            message.includes("timed out"),
+    },
+    {
+        code: ErrorCode.DNS_ERROR,
+        detect: (_name, message) => message.includes("dns") ||
+            message.includes("enotfound") ||
+            message.includes("getaddrinfo"),
+    },
+    {
+        code: ErrorCode.CONNECTION_REFUSED,
+        detect: (_name, message) => message.includes("econnrefused") ||
+            message.includes("connection refused"),
+    },
+    {
+        code: ErrorCode.NETWORK_ERROR,
+        detect: (_name, message) => message.includes("fetch") ||
+            message.includes("network") ||
+            message.includes("connection"),
+    },
+    {
+        code: ErrorCode.PARSE_ERROR,
+        detect: (_name, message) => message.includes("parse") ||
+            message.includes("json") ||
+            message.includes("unexpected token"),
+    },
+    {
+        code: ErrorCode.SERIALIZE_ERROR,
+        detect: (_name, message) => message.includes("serialize") ||
+            message.includes("stringify") ||
+            message.includes("circular"),
+    },
+];
+/**
+ * Create error from native Error exception.
+ *
+ * Uses pattern matching - no scattered magic strings!
+ *
+ * @param error - Native Error object
+ * @param context - Runtime context
+ * @returns Rich error
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await fetch(...);
+ * } catch (err) {
+ *   const richError = createErrorFromException(err as Error, {
+ *     transport: "http",
+ *   });
+ * }
+ * ```
+ */
+export function createErrorFromException(error, context) {
+    const name = error.name?.toLowerCase() ?? "";
+    const message = error.message?.toLowerCase() ?? "";
+    // Use pattern matching - declarative, not imperative!
+    const pattern = ERROR_PATTERNS.find((p) => p.detect(name, message));
+    const code = pattern?.code ?? ErrorCode.UNKNOWN;
+    return createError(code, context, error);
+}
+/**
+ * Convert RichError to Status for universal client.
+ *
+ * @param error - Rich error
+ * @returns Status object
+ */
+export function richErrorToStatus(error) {
+    return {
+        type: "error",
+        code: error.code,
+        message: error.metadata.summary,
+        retryable: error.metadata.retryable,
+        metadata: error.metadata,
+    };
+}
+/**
+ * Format error for logging.
+ *
+ * @param error - Rich error
+ * @param includeStack - Include stack trace if cause exists
+ * @returns Formatted error string
+ */
+export function formatError(error, includeStack = false) {
+    const lines = [
+        `[${error.code}] ${error.metadata.summary}`,
+        `  Detail: ${error.metadata.detail}`,
+        `  Category: ${error.metadata.category}`,
+        `  Retryable: ${error.metadata.retryable}`,
+        `  Severity: ${error.metadata.severity}`,
+    ];
+    if (error.context.requestId) {
+        lines.push(`  Request ID: ${error.context.requestId}`);
+    }
+    if (error.context.transport) {
+        lines.push(`  Transport: ${error.context.transport}`);
+    }
+    if (error.context.method) {
+        const m = error.context.method;
+        const methodStr = m.version
+            ? `${m.version}:${m.service}.${m.operation}`
+            : `${m.service}.${m.operation}`;
+        lines.push(`  Method: ${methodStr}`);
+    }
+    if (error.metadata.suggestions && error.metadata.suggestions.length > 0) {
+        lines.push(`  Suggestions:`);
+        for (const suggestion of error.metadata.suggestions) {
+            lines.push(`    - ${suggestion}`);
+        }
+    }
+    if (error.cause) {
+        lines.push(`  Cause: ${error.cause.message}`);
+        if (includeStack && error.cause.stack) {
+            lines.push(`  Stack: ${error.cause.stack}`);
+        }
+    }
+    return lines.join("\n");
+}
+/**
+ * Check if error is retryable.
+ */
+export function isRetryable(error) {
+    return error.metadata.retryable;
+}
+/**
+ * Check if error is in a specific category.
+ */
+export function isErrorCategory(error, category) {
+    return error.metadata.category === category;
+}
+//# sourceMappingURL=factory.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../src/client/errors/factory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAIN,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,WAAW,CACzB,IAAY,EACZ,OAA+B,EAC/B,KAAa;IAEb,MAAM,QAAQ,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAExC,MAAM,WAAW,GAAiB;QAChC,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,GAAG,OAAO;KACX,CAAC;IAEF,OAAO;QACL,IAAI;QACJ,QAAQ;QACR,OAAO,EAAE,WAAW;QACpB,GAAG,CAAC,KAAK,IAAI,EAAE,KAAK,EAAE,CAAC;KACxB,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,yBAAyB,CACvC,MAAc,EACd,OAA+B;IAE/B,mCAAmC;IACnC,MAAM,IAAI,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC3C,OAAO,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACpC,CAAC;AAOD;;;;;GAKG;AACH,MAAM,cAAc,GAAoB;IACtC;QACE,IAAI,EAAE,SAAS,CAAC,OAAO;QACvB,MAAM,EAAE,CAAC,IAAY,EAAE,OAAe,EAAE,EAAE,CACxC,IAAI,KAAK,YAAY,IAAI,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;KACrD;IACD;QACE,IAAI,EAAE,SAAS,CAAC,OAAO;QACvB,MAAM,EAAE,CAAC,IAAY,EAAE,OAAe,EAAE,EAAE,CACxC,IAAI,KAAK,cAAc;YACvB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;YAC3B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC;KAChC;IACD;QACE,IAAI,EAAE,SAAS,CAAC,SAAS;QACzB,MAAM,EAAE,CAAC,KAAa,EAAE,OAAe,EAAE,EAAE,CACzC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;YACvB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC;YAC7B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC;KAClC;IACD;QACE,IAAI,EAAE,SAAS,CAAC,kBAAkB;QAClC,MAAM,EAAE,CAAC,KAAa,EAAE,OAAe,EAAE,EAAE,CACzC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC;YAChC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAC;KACzC;IACD;QACE,IAAI,EAAE,SAAS,CAAC,aAAa;QAC7B,MAAM,EAAE,CAAC,KAAa,EAAE,OAAe,EAAE,EAAE,CACzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;YACzB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;YAC3B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;KACjC;IACD;QACE,IAAI,EAAE,SAAS,CAAC,WAAW;QAC3B,MAAM,EAAE,CAAC,KAAa,EAAE,OAAe,EAAE,EAAE,CACzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;YACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;YACxB,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC;KACvC;IACD;QACE,IAAI,EAAE,SAAS,CAAC,eAAe;QAC/B,MAAM,EAAE,CAAC,KAAa,EAAE,OAAe,EAAE,EAAE,CACzC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC;YAC7B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC;YAC7B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;KAC/B;CACgC,CAAC;AAEpC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,wBAAwB,CACtC,KAAY,EACZ,OAA+B;IAE/B,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IAC7C,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IAEnD,sDAAsD;IACtD,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IACpE,MAAM,IAAI,GAAG,OAAO,EAAE,IAAI,IAAI,SAAS,CAAC,OAAO,CAAC;IAEhD,OAAO,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;AAC3C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAgB;IAOhD,OAAO;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,OAAO,EAAE,KAAK,CAAC,QAAQ,CAAC,OAAO;QAC/B,SAAS,EAAE,KAAK,CAAC,QAAQ,CAAC,SAAS;QACnC,QAAQ,EAAE,KAAK,CAAC,QAAQ;KACzB,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,KAAgB,EAAE,YAAY,GAAG,KAAK;IAChE,MAAM,KAAK,GAAa;QACtB,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,QAAQ,CAAC,OAAO,EAAE;QAC3C,aAAa,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE;QACpC,eAAe,KAAK,CAAC,QAAQ,CAAC,QAAQ,EAAE;QACxC,gBAAgB,KAAK,CAAC,QAAQ,CAAC,SAAS,EAAE;QAC1C,eAAe,KAAK,CAAC,QAAQ,CAAC,QAAQ,EAAE;KACzC,CAAC;IAEF,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,iBAAiB,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,gBAAgB,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IACxD,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QACzB,MAAM,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAC/B,MAAM,SAAS,GAAG,CAAC,CAAC,OAAO;YACzB,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,SAAS,EAAE;YAC5C,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC;QAClC,KAAK,CAAC,IAAI,CAAC,aAAa,SAAS,EAAE,CAAC,CAAC;IACvC,CAAC;IAED,IAAI,KAAK,CAAC,QAAQ,CAAC,WAAW,IAAI,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxE,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC7B,KAAK,MAAM,UAAU,IAAI,KAAK,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;YACpD,KAAK,CAAC,IAAI,CAAC,SAAS,UAAU,EAAE,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IAED,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAChB,KAAK,CAAC,IAAI,CAAC,YAAY,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAC9C,IAAI,YAAY,IAAI,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YACtC,KAAK,CAAC,IAAI,CAAC,YAAY,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,KAAgB;IAC1C,OAAO,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,KAAgB,EAChB,QAAgB;IAEhB,OAAO,KAAK,CAAC,QAAQ,CAAC,QAAQ,KAAK,QAAQ,CAAC;AAC9C,CAAC"}

package/dist/client/errors/http-errors.d.ts

@@ -0,0 +1,47 @@
+/**
+ * HTTP Error Registry Extension
+ *
+ * Comprehensive HTTP status code mappings with full metadata.
+ * Integrates with the universal error registry system.
+ */
+import { type ErrorMetadata } from "./types.js";
+import { ErrorCode } from "./codes.js";
+import { HTTPStatus } from "./http-status.js";
+/**
+ * HTTP Status Code Error Registry
+ *
+ * Complete mapping of all HTTP status codes to rich error metadata.
+ */
+export declare const HTTP_ERROR_REGISTRY: Record<string, ErrorMetadata>;
+/**
+ * Map HTTP status code to error code (client-side).
+ *
+ * Uses bidirectional mapping - NO MAGIC STRINGS OR NUMBERS!
+ *
+ * @param status - HTTP status number
+ * @returns Error code from enum
+ *
+ * @example
+ * ```typescript
+ * const code = httpStatusToErrorCode(404); // ErrorCode.NOT_FOUND
+ * const code2 = httpStatusToErrorCode(500); // ErrorCode.INTERNAL_ERROR
+ * ```
+ */
+export declare function httpStatusToErrorCode(status: number): ErrorCode;
+/**
+ * Map error code to HTTP status code (server-side).
+ *
+ * Used by servers to determine appropriate HTTP status for an error code.
+ * Uses bidirectional mapping - NO MAGIC STRINGS OR NUMBERS!
+ *
+ * @param code - Error code from enum
+ * @returns HTTP status number
+ *
+ * @example
+ * ```typescript
+ * const status = errorCodeToHTTPStatus(ErrorCode.NOT_FOUND); // 404
+ * const status2 = errorCodeToHTTPStatus(ErrorCode.INTERNAL_ERROR); // 500
+ * ```
+ */
+export declare function errorCodeToHTTPStatus(code: ErrorCode): HTTPStatus;
+//# sourceMappingURL=http-errors.d.ts.map

package/dist/client/errors/http-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-errors.d.ts","sourceRoot":"","sources":["../../../src/client/errors/http-errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAgC,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAC9E,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAgG9C;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAic7D,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAI/D;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,SAAS,GAAG,UAAU,CAIjE"}