@procedures/client 0.0.0-stage → 0.2.0

package/dist/client/errors/http-status.js

@@ -0,0 +1,79 @@
+/**
+ * HTTP Status Code Constants
+ *
+ * Comprehensive enum of HTTP status codes.
+ * NO MAGIC NUMBERS - use these constants everywhere!
+ */
+export var HTTPStatus;
+(function (HTTPStatus) {
+    // 1xx Informational
+    HTTPStatus[HTTPStatus["CONTINUE"] = 100] = "CONTINUE";
+    HTTPStatus[HTTPStatus["SWITCHING_PROTOCOLS"] = 101] = "SWITCHING_PROTOCOLS";
+    HTTPStatus[HTTPStatus["PROCESSING"] = 102] = "PROCESSING";
+    HTTPStatus[HTTPStatus["EARLY_HINTS"] = 103] = "EARLY_HINTS";
+    // 2xx Success
+    HTTPStatus[HTTPStatus["OK"] = 200] = "OK";
+    HTTPStatus[HTTPStatus["CREATED"] = 201] = "CREATED";
+    HTTPStatus[HTTPStatus["ACCEPTED"] = 202] = "ACCEPTED";
+    HTTPStatus[HTTPStatus["NON_AUTHORITATIVE_INFORMATION"] = 203] = "NON_AUTHORITATIVE_INFORMATION";
+    HTTPStatus[HTTPStatus["NO_CONTENT"] = 204] = "NO_CONTENT";
+    HTTPStatus[HTTPStatus["RESET_CONTENT"] = 205] = "RESET_CONTENT";
+    HTTPStatus[HTTPStatus["PARTIAL_CONTENT"] = 206] = "PARTIAL_CONTENT";
+    HTTPStatus[HTTPStatus["MULTI_STATUS"] = 207] = "MULTI_STATUS";
+    HTTPStatus[HTTPStatus["ALREADY_REPORTED"] = 208] = "ALREADY_REPORTED";
+    HTTPStatus[HTTPStatus["IM_USED"] = 226] = "IM_USED";
+    // 3xx Redirection
+    HTTPStatus[HTTPStatus["MULTIPLE_CHOICES"] = 300] = "MULTIPLE_CHOICES";
+    HTTPStatus[HTTPStatus["MOVED_PERMANENTLY"] = 301] = "MOVED_PERMANENTLY";
+    HTTPStatus[HTTPStatus["FOUND"] = 302] = "FOUND";
+    HTTPStatus[HTTPStatus["SEE_OTHER"] = 303] = "SEE_OTHER";
+    HTTPStatus[HTTPStatus["NOT_MODIFIED"] = 304] = "NOT_MODIFIED";
+    HTTPStatus[HTTPStatus["USE_PROXY"] = 305] = "USE_PROXY";
+    HTTPStatus[HTTPStatus["TEMPORARY_REDIRECT"] = 307] = "TEMPORARY_REDIRECT";
+    HTTPStatus[HTTPStatus["PERMANENT_REDIRECT"] = 308] = "PERMANENT_REDIRECT";
+    // 4xx Client Errors
+    HTTPStatus[HTTPStatus["BAD_REQUEST"] = 400] = "BAD_REQUEST";
+    HTTPStatus[HTTPStatus["UNAUTHORIZED"] = 401] = "UNAUTHORIZED";
+    HTTPStatus[HTTPStatus["PAYMENT_REQUIRED"] = 402] = "PAYMENT_REQUIRED";
+    HTTPStatus[HTTPStatus["FORBIDDEN"] = 403] = "FORBIDDEN";
+    HTTPStatus[HTTPStatus["NOT_FOUND"] = 404] = "NOT_FOUND";
+    HTTPStatus[HTTPStatus["METHOD_NOT_ALLOWED"] = 405] = "METHOD_NOT_ALLOWED";
+    HTTPStatus[HTTPStatus["NOT_ACCEPTABLE"] = 406] = "NOT_ACCEPTABLE";
+    HTTPStatus[HTTPStatus["PROXY_AUTHENTICATION_REQUIRED"] = 407] = "PROXY_AUTHENTICATION_REQUIRED";
+    HTTPStatus[HTTPStatus["REQUEST_TIMEOUT"] = 408] = "REQUEST_TIMEOUT";
+    HTTPStatus[HTTPStatus["CONFLICT"] = 409] = "CONFLICT";
+    HTTPStatus[HTTPStatus["GONE"] = 410] = "GONE";
+    HTTPStatus[HTTPStatus["LENGTH_REQUIRED"] = 411] = "LENGTH_REQUIRED";
+    HTTPStatus[HTTPStatus["PRECONDITION_FAILED"] = 412] = "PRECONDITION_FAILED";
+    HTTPStatus[HTTPStatus["PAYLOAD_TOO_LARGE"] = 413] = "PAYLOAD_TOO_LARGE";
+    HTTPStatus[HTTPStatus["URI_TOO_LONG"] = 414] = "URI_TOO_LONG";
+    HTTPStatus[HTTPStatus["UNSUPPORTED_MEDIA_TYPE"] = 415] = "UNSUPPORTED_MEDIA_TYPE";
+    HTTPStatus[HTTPStatus["RANGE_NOT_SATISFIABLE"] = 416] = "RANGE_NOT_SATISFIABLE";
+    HTTPStatus[HTTPStatus["EXPECTATION_FAILED"] = 417] = "EXPECTATION_FAILED";
+    HTTPStatus[HTTPStatus["IM_A_TEAPOT"] = 418] = "IM_A_TEAPOT";
+    HTTPStatus[HTTPStatus["MISDIRECTED_REQUEST"] = 421] = "MISDIRECTED_REQUEST";
+    HTTPStatus[HTTPStatus["UNPROCESSABLE_ENTITY"] = 422] = "UNPROCESSABLE_ENTITY";
+    HTTPStatus[HTTPStatus["LOCKED"] = 423] = "LOCKED";
+    HTTPStatus[HTTPStatus["FAILED_DEPENDENCY"] = 424] = "FAILED_DEPENDENCY";
+    HTTPStatus[HTTPStatus["TOO_EARLY"] = 425] = "TOO_EARLY";
+    HTTPStatus[HTTPStatus["UPGRADE_REQUIRED"] = 426] = "UPGRADE_REQUIRED";
+    HTTPStatus[HTTPStatus["PRECONDITION_REQUIRED"] = 428] = "PRECONDITION_REQUIRED";
+    HTTPStatus[HTTPStatus["TOO_MANY_REQUESTS"] = 429] = "TOO_MANY_REQUESTS";
+    HTTPStatus[HTTPStatus["REQUEST_HEADER_FIELDS_TOO_LARGE"] = 431] = "REQUEST_HEADER_FIELDS_TOO_LARGE";
+    HTTPStatus[HTTPStatus["UNAVAILABLE_FOR_LEGAL_REASONS"] = 451] = "UNAVAILABLE_FOR_LEGAL_REASONS";
+    HTTPStatus[HTTPStatus["CLIENT_CLOSED_REQUEST"] = 499] = "CLIENT_CLOSED_REQUEST";
+    // 5xx Server Errors
+    HTTPStatus[HTTPStatus["INTERNAL_SERVER_ERROR"] = 500] = "INTERNAL_SERVER_ERROR";
+    HTTPStatus[HTTPStatus["NOT_IMPLEMENTED"] = 501] = "NOT_IMPLEMENTED";
+    HTTPStatus[HTTPStatus["BAD_GATEWAY"] = 502] = "BAD_GATEWAY";
+    HTTPStatus[HTTPStatus["SERVICE_UNAVAILABLE"] = 503] = "SERVICE_UNAVAILABLE";
+    HTTPStatus[HTTPStatus["GATEWAY_TIMEOUT"] = 504] = "GATEWAY_TIMEOUT";
+    HTTPStatus[HTTPStatus["HTTP_VERSION_NOT_SUPPORTED"] = 505] = "HTTP_VERSION_NOT_SUPPORTED";
+    HTTPStatus[HTTPStatus["VARIANT_ALSO_NEGOTIATES"] = 506] = "VARIANT_ALSO_NEGOTIATES";
+    HTTPStatus[HTTPStatus["INSUFFICIENT_STORAGE"] = 507] = "INSUFFICIENT_STORAGE";
+    HTTPStatus[HTTPStatus["LOOP_DETECTED"] = 508] = "LOOP_DETECTED";
+    HTTPStatus[HTTPStatus["NOT_EXTENDED"] = 510] = "NOT_EXTENDED";
+    HTTPStatus[HTTPStatus["NETWORK_AUTHENTICATION_REQUIRED"] = 511] = "NETWORK_AUTHENTICATION_REQUIRED";
+    HTTPStatus[HTTPStatus["NETWORK_CONNECT_TIMEOUT"] = 599] = "NETWORK_CONNECT_TIMEOUT";
+})(HTTPStatus || (HTTPStatus = {}));
+//# sourceMappingURL=http-status.js.map

package/dist/client/errors/http-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-status.js","sourceRoot":"","sources":["../../../src/client/errors/http-status.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,CAAN,IAAY,UA0EX;AA1ED,WAAY,UAAU;IACpB,oBAAoB;IACpB,qDAAc,CAAA;IACd,2EAAyB,CAAA;IACzB,yDAAgB,CAAA;IAChB,2DAAiB,CAAA;IAEjB,cAAc;IACd,yCAAQ,CAAA;IACR,mDAAa,CAAA;IACb,qDAAc,CAAA;IACd,+FAAmC,CAAA;IACnC,yDAAgB,CAAA;IAChB,+DAAmB,CAAA;IACnB,mEAAqB,CAAA;IACrB,6DAAkB,CAAA;IAClB,qEAAsB,CAAA;IACtB,mDAAa,CAAA;IAEb,kBAAkB;IAClB,qEAAsB,CAAA;IACtB,uEAAuB,CAAA;IACvB,+CAAW,CAAA;IACX,uDAAe,CAAA;IACf,6DAAkB,CAAA;IAClB,uDAAe,CAAA;IACf,yEAAwB,CAAA;IACxB,yEAAwB,CAAA;IAExB,oBAAoB;IACpB,2DAAiB,CAAA;IACjB,6DAAkB,CAAA;IAClB,qEAAsB,CAAA;IACtB,uDAAe,CAAA;IACf,uDAAe,CAAA;IACf,yEAAwB,CAAA;IACxB,iEAAoB,CAAA;IACpB,+FAAmC,CAAA;IACnC,mEAAqB,CAAA;IACrB,qDAAc,CAAA;IACd,6CAAU,CAAA;IACV,mEAAqB,CAAA;IACrB,2EAAyB,CAAA;IACzB,uEAAuB,CAAA;IACvB,6DAAkB,CAAA;IAClB,iFAA4B,CAAA;IAC5B,+EAA2B,CAAA;IAC3B,yEAAwB,CAAA;IACxB,2DAAiB,CAAA;IACjB,2EAAyB,CAAA;IACzB,6EAA0B,CAAA;IAC1B,iDAAY,CAAA;IACZ,uEAAuB,CAAA;IACvB,uDAAe,CAAA;IACf,qEAAsB,CAAA;IACtB,+EAA2B,CAAA;IAC3B,uEAAuB,CAAA;IACvB,mGAAqC,CAAA;IACrC,+FAAmC,CAAA;IACnC,+EAA2B,CAAA;IAE3B,oBAAoB;IACpB,+EAA2B,CAAA;IAC3B,mEAAqB,CAAA;IACrB,2DAAiB,CAAA;IACjB,2EAAyB,CAAA;IACzB,mEAAqB,CAAA;IACrB,yFAAgC,CAAA;IAChC,mFAA6B,CAAA;IAC7B,6EAA0B,CAAA;IAC1B,+DAAmB,CAAA;IACnB,6DAAkB,CAAA;IAClB,mGAAqC,CAAA;IACrC,mFAA6B,CAAA;AAC/B,CAAC,EA1EW,UAAU,KAAV,UAAU,QA0ErB"}

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

@@ -0,0 +1,36 @@
+/**
+ * Universal Error System
+ *
+ * Protocol-agnostic error handling with rich metadata.
+ *
+ * @example
+ * ```typescript
+ * import { createError, formatError } from "@common/client/errors";
+ *
+ * // Create rich error
+ * const error = createError("TIMEOUT", {
+ *   requestId: "req-123",
+ *   transport: "http",
+ *   method: { service: "users", operation: "get" },
+ * });
+ *
+ * // Access metadata
+ * console.log(error.metadata.summary);      // "Request timed out"
+ * console.log(error.metadata.detail);       // Full explanation
+ * console.log(error.metadata.userMessage);  // User-friendly message
+ * console.log(error.metadata.devMessage);   // Developer diagnostic
+ * console.log(error.metadata.suggestions);  // Suggested actions
+ * console.log(error.metadata.retryable);    // true
+ *
+ * // Format for logging
+ * console.log(formatError(error));
+ * ```
+ */
+export type { ErrorMetadata, ErrorRegistry, ErrorContext, RichError, ErrorFactory, } from "./types.js";
+export { ErrorSeverity, ErrorCategory } from "./types.js";
+export { ErrorCode } from "./codes.js";
+export { ERROR_REGISTRY, getErrorMetadata, isKnownError, getErrorsByCategory, getRetryableErrors, } from "./registry.js";
+export { createError, createErrorFromHTTPStatus, createErrorFromException, richErrorToStatus, formatError, isRetryable, isErrorCategory, } from "./factory.js";
+export { HTTPStatus } from "./http-status.js";
+export { HTTP_ERROR_REGISTRY, httpStatusToErrorCode, errorCodeToHTTPStatus, } from "./http-errors.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/client/errors/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAGH,YAAY,EACV,aAAa,EACb,aAAa,EACb,YAAY,EACZ,SAAS,EACT,YAAY,GACb,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAG1D,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAGvC,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,WAAW,EACX,yBAAyB,EACzB,wBAAwB,EACxB,iBAAiB,EACjB,WAAW,EACX,WAAW,EACX,eAAe,GAChB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG9C,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,kBAAkB,CAAC"}

package/dist/client/errors/index.js

@@ -0,0 +1,40 @@
+/**
+ * Universal Error System
+ *
+ * Protocol-agnostic error handling with rich metadata.
+ *
+ * @example
+ * ```typescript
+ * import { createError, formatError } from "@common/client/errors";
+ *
+ * // Create rich error
+ * const error = createError("TIMEOUT", {
+ *   requestId: "req-123",
+ *   transport: "http",
+ *   method: { service: "users", operation: "get" },
+ * });
+ *
+ * // Access metadata
+ * console.log(error.metadata.summary);      // "Request timed out"
+ * console.log(error.metadata.detail);       // Full explanation
+ * console.log(error.metadata.userMessage);  // User-friendly message
+ * console.log(error.metadata.devMessage);   // Developer diagnostic
+ * console.log(error.metadata.suggestions);  // Suggested actions
+ * console.log(error.metadata.retryable);    // true
+ *
+ * // Format for logging
+ * console.log(formatError(error));
+ * ```
+ */
+export { ErrorSeverity, ErrorCategory } from "./types.js";
+// Error Codes Enum
+export { ErrorCode } from "./codes.js";
+// Registry
+export { ERROR_REGISTRY, getErrorMetadata, isKnownError, getErrorsByCategory, getRetryableErrors, } from "./registry.js";
+// Factory
+export { createError, createErrorFromHTTPStatus, createErrorFromException, richErrorToStatus, formatError, isRetryable, isErrorCategory, } from "./factory.js";
+// HTTP Status Constants
+export { HTTPStatus } from "./http-status.js";
+// HTTP Errors
+export { HTTP_ERROR_REGISTRY, httpStatusToErrorCode, errorCodeToHTTPStatus, } from "./http-errors.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/client/errors/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAWH,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE1D,mBAAmB;AACnB,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC,WAAW;AACX,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,eAAe,CAAC;AAEvB,UAAU;AACV,OAAO,EACL,WAAW,EACX,yBAAyB,EACzB,wBAAwB,EACxB,iBAAiB,EACjB,WAAW,EACX,WAAW,EACX,eAAe,GAChB,MAAM,cAAc,CAAC;AAEtB,wBAAwB;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,cAAc;AACd,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,kBAAkB,CAAC"}

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

@@ -0,0 +1,38 @@
+/**
+ * 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, type ErrorRegistry, type ErrorMetadata } from "./types.js";
+/**
+ * Universal Error Registry
+ *
+ * Protocol-agnostic error codes with rich metadata.
+ */
+export declare const ERROR_REGISTRY: ErrorRegistry;
+/**
+ * Get error metadata by code.
+ *
+ * Returns UNKNOWN metadata if code not found in registry.
+ */
+export declare function getErrorMetadata(code: string): ErrorMetadata;
+/**
+ * Check if an error code exists in the registry.
+ */
+export declare function isKnownError(code: string): boolean;
+/**
+ * Get all error codes by category.
+ */
+export declare function getErrorsByCategory(category: ErrorCategory): ErrorMetadata[];
+/**
+ * Get all retryable error codes.
+ */
+export declare function getRetryableErrors(): ErrorMetadata[];
+/**
+ * Map HTTP status code to error code.
+ */
+export declare function httpStatusToErrorCode(status: number): string;
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/client/errors/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,aAAa,EAEb,KAAK,aAAa,EAClB,KAAK,aAAa,EACnB,MAAM,YAAY,CAAC;AAmCpB;;;;GAIG;AACH,eAAO,MAAM,cAAc,EAAE,aAofK,CAAC;AAEnC;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAE5D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAElD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,aAAa,GAAG,aAAa,EAAE,CAE5E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,aAAa,EAAE,CAEpD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAK5D"}