@procedures/client 0.0.0-stage → 0.1.0

package/dist/adapters/http/shared/constants.d.ts

@@ -0,0 +1,95 @@
+/**
+ * HTTP Constants
+ *
+ * Shared HTTP enums and constants used by both client and server adapters.
+ */
+/**
+ * HTTP Methods
+ */
+export declare enum HTTPMethod {
+    GET = "GET",
+    POST = "POST",
+    PUT = "PUT",
+    PATCH = "PATCH",
+    DELETE = "DELETE",
+    OPTIONS = "OPTIONS",
+    HEAD = "HEAD"
+}
+/**
+ * HTTP Status Codes
+ *
+ * Comprehensive enum of all standard HTTP status codes.
+ */
+export declare enum HTTPStatus {
+    UNKNOWN = 0,
+    CONTINUE = 100,
+    SWITCHING_PROTOCOLS = 101,
+    PROCESSING = 102,
+    EARLY_HINTS = 103,
+    RESPONSE_IS_TOO_LARGE = 104,
+    OK = 200,
+    CREATED = 201,
+    ACCEPTED = 202,
+    NON_AUTHORITATIVE_INFORMATION = 203,
+    NO_CONTENT = 204,
+    RESET_CONTENT = 205,
+    PARTIAL_CONTENT = 206,
+    MULTI_STATUS = 207,
+    ALREADY_REPORTED = 208,
+    IM_USED = 226,
+    MULTIPLE_CHOICES = 300,
+    MOVED_PERMANENTLY = 301,
+    FOUND = 302,
+    SEE_OTHER = 303,
+    NOT_MODIFIED = 304,
+    USE_PROXY = 305,
+    TEMPORARY_REDIRECT = 307,
+    PERMANENT_REDIRECT = 308,
+    BAD_REQUEST = 400,
+    UNAUTHORIZED = 401,
+    FORBIDDEN = 403,
+    NOT_FOUND = 404,
+    METHOD_NOT_ALLOWED = 405,
+    NOT_ACCEPTABLE = 406,
+    PROXY_AUTHENTICATION_REQUIRED = 407,
+    REQUEST_TIMEOUT = 408,
+    CONFLICT = 409,
+    GONE = 410,
+    LENGTH_REQUIRED = 411,
+    PRECONDITION_FAILED = 412,
+    PAYLOAD_TOO_LARGE = 413,
+    URI_TOO_LONG = 414,
+    UNSUPPORTED_MEDIA_TYPE = 415,
+    RANGE_NOT_SATISFIABLE = 416,
+    EXPECTATION_FAILED = 417,
+    IM_A_TEAPOT = 418,
+    MISDIRECTED_REQUEST = 421,
+    UNPROCESSABLE_ENTITY = 422,
+    LOCKED = 423,
+    FAILED_DEPENDENCY = 424,
+    TOO_EARLY = 425,
+    UPGRADE_REQUIRED = 426,
+    PRECONDITION_REQUIRED = 428,
+    TOO_MANY_REQUESTS = 429,
+    REQUEST_HEADER_FIELDS_TOO_LARGE = 431,
+    UNAVAILABLE_FOR_LEGAL_REASONS = 451,
+    CLIENT_CLOSED_REQUEST = 499,
+    INTERNAL_SERVER_ERROR = 500,
+    NOT_IMPLEMENTED = 501,
+    BAD_GATEWAY = 502,
+    SERVICE_UNAVAILABLE = 503,
+    GATEWAY_TIMEOUT = 504,
+    HTTP_VERSION_NOT_SUPPORTED = 505,
+    VARIANT_ALSO_NEGOTIATES = 506,
+    INSUFFICIENT_STORAGE = 507,
+    LOOP_DETECTED = 508,
+    NOT_EXTENDED = 510,
+    NETWORK_AUTHENTICATION_REQUIRED = 511,
+    HTTP_NETWORK_CONNECT_TIMEOUT_ERROR = 599
+}
+/**
+ * HTTP Transport Protocol Name
+ */
+export declare const HTTP: "HTTP";
+export type HTTP = typeof HTTP;
+//# sourceMappingURL=constants.d.ts.map

package/dist/adapters/http/shared/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/adapters/http/shared/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,oBAAY,UAAU;IACpB,GAAG,QAAQ;IACX,IAAI,SAAS;IACb,GAAG,QAAQ;IACX,KAAK,UAAU;IACf,MAAM,WAAW;IACjB,OAAO,YAAY;IACnB,IAAI,SAAS;CACd;AAED;;;;GAIG;AACH,oBAAY,UAAU;IAEpB,OAAO,IAAI;IAGX,QAAQ,MAAM;IACd,mBAAmB,MAAM;IACzB,UAAU,MAAM;IAChB,WAAW,MAAM;IACjB,qBAAqB,MAAM;IAG3B,EAAE,MAAM;IACR,OAAO,MAAM;IACb,QAAQ,MAAM;IACd,6BAA6B,MAAM;IACnC,UAAU,MAAM;IAChB,aAAa,MAAM;IACnB,eAAe,MAAM;IACrB,YAAY,MAAM;IAClB,gBAAgB,MAAM;IACtB,OAAO,MAAM;IAGb,gBAAgB,MAAM;IACtB,iBAAiB,MAAM;IACvB,KAAK,MAAM;IACX,SAAS,MAAM;IACf,YAAY,MAAM;IAClB,SAAS,MAAM;IACf,kBAAkB,MAAM;IACxB,kBAAkB,MAAM;IAGxB,WAAW,MAAM;IACjB,YAAY,MAAM;IAClB,SAAS,MAAM;IACf,SAAS,MAAM;IACf,kBAAkB,MAAM;IACxB,cAAc,MAAM;IACpB,6BAA6B,MAAM;IACnC,eAAe,MAAM;IACrB,QAAQ,MAAM;IACd,IAAI,MAAM;IACV,eAAe,MAAM;IACrB,mBAAmB,MAAM;IACzB,iBAAiB,MAAM;IACvB,YAAY,MAAM;IAClB,sBAAsB,MAAM;IAC5B,qBAAqB,MAAM;IAC3B,kBAAkB,MAAM;IACxB,WAAW,MAAM;IACjB,mBAAmB,MAAM;IACzB,oBAAoB,MAAM;IAC1B,MAAM,MAAM;IACZ,iBAAiB,MAAM;IACvB,SAAS,MAAM;IACf,gBAAgB,MAAM;IACtB,qBAAqB,MAAM;IAC3B,iBAAiB,MAAM;IACvB,+BAA+B,MAAM;IACrC,6BAA6B,MAAM;IACnC,qBAAqB,MAAM;IAG3B,qBAAqB,MAAM;IAC3B,eAAe,MAAM;IACrB,WAAW,MAAM;IACjB,mBAAmB,MAAM;IACzB,eAAe,MAAM;IACrB,0BAA0B,MAAM;IAChC,uBAAuB,MAAM;IAC7B,oBAAoB,MAAM;IAC1B,aAAa,MAAM;IACnB,YAAY,MAAM;IAClB,+BAA+B,MAAM;IACrC,kCAAkC,MAAM;CACzC;AAED;;GAEG;AACH,eAAO,MAAM,IAAI,EAAG,MAAe,CAAC;AACpC,MAAM,MAAM,IAAI,GAAG,OAAO,IAAI,CAAC"}

package/dist/adapters/http/shared/constants.js

@@ -0,0 +1,102 @@
+/**
+ * HTTP Constants
+ *
+ * Shared HTTP enums and constants used by both client and server adapters.
+ */
+/**
+ * HTTP Methods
+ */
+export var HTTPMethod;
+(function (HTTPMethod) {
+    HTTPMethod["GET"] = "GET";
+    HTTPMethod["POST"] = "POST";
+    HTTPMethod["PUT"] = "PUT";
+    HTTPMethod["PATCH"] = "PATCH";
+    HTTPMethod["DELETE"] = "DELETE";
+    HTTPMethod["OPTIONS"] = "OPTIONS";
+    HTTPMethod["HEAD"] = "HEAD";
+})(HTTPMethod || (HTTPMethod = {}));
+/**
+ * HTTP Status Codes
+ *
+ * Comprehensive enum of all standard HTTP status codes.
+ */
+export var HTTPStatus;
+(function (HTTPStatus) {
+    // Unknown
+    HTTPStatus[HTTPStatus["UNKNOWN"] = 0] = "UNKNOWN";
+    // 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";
+    HTTPStatus[HTTPStatus["RESPONSE_IS_TOO_LARGE"] = 104] = "RESPONSE_IS_TOO_LARGE";
+    // 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["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["HTTP_NETWORK_CONNECT_TIMEOUT_ERROR"] = 599] = "HTTP_NETWORK_CONNECT_TIMEOUT_ERROR";
+})(HTTPStatus || (HTTPStatus = {}));
+/**
+ * HTTP Transport Protocol Name
+ */
+export const HTTP = "HTTP";
+//# sourceMappingURL=constants.js.map

package/dist/adapters/http/shared/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../src/adapters/http/shared/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,CAAN,IAAY,UAQX;AARD,WAAY,UAAU;IACpB,yBAAW,CAAA;IACX,2BAAa,CAAA;IACb,yBAAW,CAAA;IACX,6BAAe,CAAA;IACf,+BAAiB,CAAA;IACjB,iCAAmB,CAAA;IACnB,2BAAa,CAAA;AACf,CAAC,EARW,UAAU,KAAV,UAAU,QAQrB;AAED;;;;GAIG;AACH,MAAM,CAAN,IAAY,UA6EX;AA7ED,WAAY,UAAU;IACpB,UAAU;IACV,iDAAW,CAAA;IAEX,oBAAoB;IACpB,qDAAc,CAAA;IACd,2EAAyB,CAAA;IACzB,yDAAgB,CAAA;IAChB,2DAAiB,CAAA;IACjB,+EAA2B,CAAA;IAE3B,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,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,yGAAwC,CAAA;AAC1C,CAAC,EA7EW,UAAU,KAAV,UAAU,QA6ErB;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,MAAe,CAAC"}

package/dist/adapters/http/shared/errors.d.ts

@@ -0,0 +1,78 @@
+/**
+ * HTTP Error Types
+ *
+ * Type-safe error codes and utilities for HTTP adapter errors.
+ * No more magic strings!
+ */
+import { HTTPStatus } from "./constants.js";
+/**
+ * HTTP Error Codes (Type-safe)
+ *
+ * Categorizes errors into semantic codes instead of magic strings.
+ */
+export declare enum HTTPErrorCode {
+    NETWORK_ERROR = "NETWORK_ERROR",
+    CONNECTION_REFUSED = "CONNECTION_REFUSED",
+    TIMEOUT = "TIMEOUT",
+    ABORTED = "ABORTED",
+    HTTP_ERROR = "HTTP_ERROR",
+    INVALID_RESPONSE = "INVALID_RESPONSE",
+    PARSE_ERROR = "PARSE_ERROR",
+    SERIALIZE_ERROR = "SERIALIZE_ERROR",
+    INVALID_URL = "INVALID_URL",
+    INVALID_METHOD = "INVALID_METHOD",
+    UNKNOWN = "UNKNOWN"
+}
+export declare const HTTPErrorMessage: Record<HTTPErrorCode, string>;
+/**
+ * HTTP Error Details
+ *
+ * Structured error information for HTTP transport errors.
+ */
+export interface HTTPErrorDetails {
+    /** Semantic error code */
+    code: HTTPErrorCode | string;
+    /** Human-readable error message */
+    message: string;
+    /** Whether this error is retryable */
+    retryable: boolean;
+    /** Optional HTTP status code (if applicable) */
+    status?: HTTPStatus;
+    /** Optional underlying cause */
+    cause?: Error | undefined;
+}
+/**
+ * Create HTTP error details from status code
+ */
+export declare function createHTTPStatusError(status: HTTPStatus): HTTPErrorDetails;
+/**
+ * Create network error details
+ */
+export declare function createNetworkError(message: string, cause?: Error): HTTPErrorDetails;
+/**
+ * Create timeout error details
+ */
+export declare function createTimeoutError(timeoutMs: number): HTTPErrorDetails;
+/**
+ * Create abort error details: the caller aborted the request, so a retry must not repeat it.
+ * Before, an abort was a non-retryable HTTP_ERROR (deep dive TRN-7).
+ */
+export declare function createAbortError(): HTTPErrorDetails;
+export declare function createHTTPError(cause?: Error): HTTPErrorDetails;
+/**
+ * Detect error type from Error object
+ *
+ * Inspects error name/message to categorize fetch errors.
+ *
+ * needs fixing
+ */
+export declare function categorizeError(error: Error): HTTPErrorCode;
+/**
+ * Create error details from generic Error
+ */
+export declare function createErrorFromException(error: Error): HTTPErrorDetails;
+/**
+ * Check if error code represents a retryable error
+ */
+export declare function isRetryableError(code: HTTPErrorCode | string): boolean;
+//# sourceMappingURL=errors.d.ts.map

package/dist/adapters/http/shared/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../../src/adapters/http/shared/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAG5C;;;;GAIG;AACH,oBAAY,aAAa;IAEvB,aAAa,kBAAkB;IAC/B,kBAAkB,uBAAuB;IACzC,OAAO,YAAY;IACnB,OAAO,YAAY;IAGnB,UAAU,eAAe;IAGzB,gBAAgB,qBAAqB;IACrC,WAAW,gBAAgB;IAC3B,eAAe,oBAAoB;IAGnC,WAAW,gBAAgB;IAC3B,cAAc,mBAAmB;IAGjC,OAAO,YAAY;CACpB;AAED,eAAO,MAAM,gBAAgB,EAAG,MAAM,CAAC,aAAa,EAAE,MAAM,CAYV,CAAC;AAEnD;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,0BAA0B;IAC1B,IAAI,EAAE,aAAa,GAAG,MAAM,CAAC;IAE7B,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;IAEhB,sCAAsC;IACtC,SAAS,EAAE,OAAO,CAAC;IAEnB,gDAAgD;IAChD,MAAM,CAAC,EAAE,UAAU,CAAC;IAEpB,gCAAgC;IAChC,KAAK,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC;CAC3B;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,UAAU,GAAG,gBAAgB,CAO1E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,KAAK,GACZ,gBAAgB,CAOlB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,CAMtE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,gBAAgB,CAMnD;AAGD,wBAAgB,eAAe,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,gBAAgB,CAO/D;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,aAAa,CA6B3D;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,KAAK,GAAG,gBAAgB,CASvE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,GAAG,OAAO,CAStE"}

package/dist/adapters/http/shared/errors.js

@@ -0,0 +1,151 @@
+/**
+ * HTTP Error Types
+ *
+ * Type-safe error codes and utilities for HTTP adapter errors.
+ * No more magic strings!
+ */
+import { HTTPStatus } from "./constants.js";
+import { formatHTTPError, getStatusCode, isRetryableStatus } from "./status-codes.js";
+/**
+ * HTTP Error Codes (Type-safe)
+ *
+ * Categorizes errors into semantic codes instead of magic strings.
+ */
+export var HTTPErrorCode;
+(function (HTTPErrorCode) {
+    // Network errors
+    HTTPErrorCode["NETWORK_ERROR"] = "NETWORK_ERROR";
+    HTTPErrorCode["CONNECTION_REFUSED"] = "CONNECTION_REFUSED";
+    HTTPErrorCode["TIMEOUT"] = "TIMEOUT";
+    HTTPErrorCode["ABORTED"] = "ABORTED";
+    // HTTP errors (mapped from status codes)
+    HTTPErrorCode["HTTP_ERROR"] = "HTTP_ERROR";
+    // Parse/serialization errors
+    HTTPErrorCode["INVALID_RESPONSE"] = "INVALID_RESPONSE";
+    HTTPErrorCode["PARSE_ERROR"] = "PARSE_ERROR";
+    HTTPErrorCode["SERIALIZE_ERROR"] = "SERIALIZE_ERROR";
+    // Configuration errors
+    HTTPErrorCode["INVALID_URL"] = "INVALID_URL";
+    HTTPErrorCode["INVALID_METHOD"] = "INVALID_METHOD";
+    // Unknown
+    HTTPErrorCode["UNKNOWN"] = "UNKNOWN";
+})(HTTPErrorCode || (HTTPErrorCode = {}));
+export const HTTPErrorMessage = {
+    [HTTPErrorCode.PARSE_ERROR]: "Failed to parse response",
+    [HTTPErrorCode.SERIALIZE_ERROR]: "Failed to serialize request",
+    [HTTPErrorCode.NETWORK_ERROR]: "Network error occurred",
+    [HTTPErrorCode.CONNECTION_REFUSED]: "Connection was refused by the server",
+    [HTTPErrorCode.TIMEOUT]: "Request timed out",
+    [HTTPErrorCode.ABORTED]: "Request was aborted",
+    [HTTPErrorCode.HTTP_ERROR]: "HTTP error occurred",
+    [HTTPErrorCode.INVALID_RESPONSE]: "Received invalid response from server",
+    [HTTPErrorCode.INVALID_URL]: "The provided URL is invalid",
+    [HTTPErrorCode.INVALID_METHOD]: "The provided HTTP method is invalid",
+    [HTTPErrorCode.UNKNOWN]: "An unknown error occurred",
+};
+/**
+ * Create HTTP error details from status code
+ */
+export function createHTTPStatusError(status) {
+    return {
+        code: getStatusCode(status),
+        message: formatHTTPError(status),
+        retryable: isRetryableStatus(status),
+        status,
+    };
+}
+/**
+ * Create network error details
+ */
+export function createNetworkError(message, cause) {
+    return {
+        code: HTTPErrorCode.NETWORK_ERROR,
+        message,
+        retryable: true,
+        ...(cause && { cause }),
+    };
+}
+/**
+ * Create timeout error details
+ */
+export function createTimeoutError(timeoutMs) {
+    return {
+        code: HTTPErrorCode.TIMEOUT,
+        message: `Request timed out after ${timeoutMs}ms`,
+        retryable: true,
+    };
+}
+/**
+ * Create abort error details: the caller aborted the request, so a retry must not repeat it.
+ * Before, an abort was a non-retryable HTTP_ERROR (deep dive TRN-7).
+ */
+export function createAbortError() {
+    return {
+        code: HTTPErrorCode.ABORTED,
+        message: HTTPErrorMessage[HTTPErrorCode.ABORTED],
+        retryable: false,
+    };
+}
+// needs fixing
+export function createHTTPError(cause) {
+    return {
+        code: HTTPErrorCode.HTTP_ERROR,
+        message: cause?.message ?? HTTPErrorMessage[HTTPErrorCode.HTTP_ERROR],
+        retryable: false,
+        cause
+    };
+}
+/**
+ * Detect error type from Error object
+ *
+ * Inspects error name/message to categorize fetch errors.
+ *
+ * needs fixing
+ */
+export function categorizeError(error) {
+    const name = error.name?.toLowerCase() || "";
+    const message = error.message?.toLowerCase() || "";
+    if (name === "aborterror" || message.includes("abort")) {
+        return HTTPErrorCode.ABORTED;
+    }
+    if (name === "timeouterror" ||
+        message.includes("timeout") ||
+        message.includes("timed out")) {
+        return HTTPErrorCode.TIMEOUT;
+    }
+    if (message.includes("fetch") ||
+        message.includes("network") ||
+        message.includes("connection")) {
+        return HTTPErrorCode.NETWORK_ERROR;
+    }
+    if (message.includes("parse") || message.includes("json")) {
+        return HTTPErrorCode.PARSE_ERROR;
+    }
+    return HTTPErrorCode.UNKNOWN;
+}
+/**
+ * Create error details from generic Error
+ */
+export function createErrorFromException(error) {
+    const code = categorizeError(error);
+    return {
+        code,
+        message: error.message,
+        retryable: code === HTTPErrorCode.NETWORK_ERROR || code === HTTPErrorCode.TIMEOUT,
+        cause: error,
+    };
+}
+/**
+ * Check if error code represents a retryable error
+ */
+export function isRetryableError(code) {
+    switch (code) {
+        case HTTPErrorCode.NETWORK_ERROR:
+        case HTTPErrorCode.CONNECTION_REFUSED:
+        case HTTPErrorCode.TIMEOUT:
+            return true;
+        default:
+            return false;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/adapters/http/shared/errors.js.map

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

package/dist/adapters/http/shared/headers.d.ts

@@ -0,0 +1,122 @@
+/**
+ * HTTP Header Utilities
+ *
+ * Provides constants for standard HTTP headers and utilities for
+ * converting between universal metadata and HTTP headers.
+ */
+import type { Metadata } from "../../../client/types.js";
+/**
+ * Standard HTTP Header Names
+ *
+ * Type-safe constants for commonly used HTTP headers.
+ * No more magic strings!
+ */
+export declare const HTTPHeaders: {
+    readonly CONTENT_TYPE: "Content-Type";
+    readonly CONTENT_LENGTH: "Content-Length";
+    readonly AUTHORIZATION: "Authorization";
+    readonly USER_AGENT: "User-Agent";
+    readonly ACCEPT: "Accept";
+    readonly ACCEPT_ENCODING: "Accept-Encoding";
+    readonly ACCEPT_LANGUAGE: "Accept-Language";
+    readonly CACHE_CONTROL: "Cache-Control";
+    readonly CONNECTION: "Connection";
+    readonly HOST: "Host";
+    readonly ORIGIN: "Origin";
+    readonly REFERER: "Referer";
+    readonly REQUEST_ID: "X-Request-Id";
+    readonly API_KEY: "X-API-Key";
+    readonly TRACE_ID: "X-Trace-Id";
+    readonly SPAN_ID: "X-Span-Id";
+    readonly PARENT_SPAN_ID: "X-Parent-Span-Id";
+    readonly TIMEOUT: "X-Timeout";
+    readonly METADATA: "X-Metadata";
+    readonly SERVER_TIMING: "Server-Timing";
+};
+/**
+ * Type for HTTP header names
+ */
+export type HTTPHeader = (typeof HTTPHeaders)[keyof typeof HTTPHeaders];
+/**
+ * Type for HTTP headers object
+ */
+export type HTTPHeadersMap = Record<string, string>;
+/**
+ * Header Converter Interface
+ *
+ * Defines the contract for converting between universal Metadata
+ * and protocol-specific HTTP headers.
+ *
+ * This abstraction allows:
+ * - Custom header naming conventions
+ * - Different authentication schemes
+ * - Multiple tracing formats
+ * - Extensible serialization strategies
+ */
+export interface HeaderConverter {
+    /**
+     * Convert universal metadata to HTTP headers
+     *
+     * @param metadata - Universal metadata
+     * @returns HTTP headers map
+     */
+    metadataToHeaders(metadata: Metadata): HTTPHeadersMap;
+    /**
+     * Convert HTTP headers to universal metadata
+     *
+     * @param headers - HTTP headers (Headers or plain object)
+     * @returns Universal metadata
+     */
+    headersToMetadata(headers: Headers | HTTPHeadersMap): Metadata;
+}
+/**
+ * Default Header Converter Implementation
+ *
+ * Implements standard conventions for converting metadata to headers:
+ * - Auth: Bearer token, API key
+ * - Tracing: X-Trace-Id, X-Span-Id format
+ * - Timeouts: X-Timeout header
+ * - Custom fields: Pass through as-is
+ */
+export declare class DefaultHeaderConverter implements HeaderConverter {
+    /**
+     * Custom fields: a string value with a header-safe key and a Latin-1 value also goes as its
+     * own header (for servers that read headers). Every custom field, of any JSON type, goes in
+     * the `X-Metadata` header. Before, only string values got through, and a non-Latin-1 value
+     * or a key with a space failed the call (deep dive TRN-11). Keys that start with "__" are
+     * internal to the process and never go.
+     *
+     * @throws an error with code METADATA_TOO_LARGE when `X-Metadata` is longer than
+     *   METADATA_HEADER_LIMIT characters
+     */
+    metadataToHeaders(metadata: Metadata): HTTPHeadersMap;
+    headersToMetadata(headers: Headers | HTTPHeadersMap): Metadata;
+}
+/** The longest `X-Metadata` value, in characters. */
+export declare const METADATA_HEADER_LIMIT = 8192;
+/**
+ * This function reads the `X-Metadata` header: the custom metadata as an object, or undefined
+ * when the value is not URI-encoded JSON of an object.
+ */
+export declare function decodeMetadataHeader(value: string | undefined | null): Record<string, unknown> | undefined;
+/**
+ * Create a default header converter instance
+ */
+export declare function createDefaultHeaderConverter(): HeaderConverter;
+/**
+ * Utility: Check if headers contain authentication
+ */
+export declare function hasAuthHeaders(headers: Headers | HTTPHeadersMap): boolean;
+/**
+ * Utility: Check if headers contain tracing information
+ */
+export declare function hasTracingHeaders(headers: Headers | HTTPHeadersMap): boolean;
+/**
+ * Utility: Extract request ID from headers
+ */
+export declare function getRequestId(headers: Headers | HTTPHeadersMap): string | null;
+/**
+ * Utility: Set request ID in headers
+ */
+export declare function setRequestId(headers: HTTPHeadersMap, requestId: string): void;
+//# sourceMappingURL=headers.d.ts.map

package/dist/adapters/http/shared/headers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"headers.d.ts","sourceRoot":"","sources":["../../../../src/adapters/http/shared/headers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEzD;;;;;GAKG;AACH,eAAO,MAAM,WAAW;aAEtB,YAAY,EAAE,cAAc;aAC5B,cAAc,EAAE,gBAAgB;aAChC,aAAa,EAAE,eAAe;aAC9B,UAAU,EAAE,YAAY;aACxB,MAAM,EAAE,QAAQ;aAChB,eAAe,EAAE,iBAAiB;aAClC,eAAe,EAAE,iBAAiB;aAClC,aAAa,EAAE,eAAe;aAC9B,UAAU,EAAE,YAAY;aACxB,IAAI,EAAE,MAAM;aACZ,MAAM,EAAE,QAAQ;aAChB,OAAO,EAAE,SAAS;aAGlB,UAAU,EAAE,cAAc;aAG1B,OAAO,EAAE,WAAW;aAGpB,QAAQ,EAAE,YAAY;aACtB,OAAO,EAAE,WAAW;aACpB,cAAc,EAAE,kBAAkB;aAGlC,OAAO,EAAE,WAAW;aAGpB,QAAQ,EAAE,YAAY;aAGtB,aAAa,EAAE,eAAe;CACtB,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,OAAO,WAAW,CAAC,CAAC;AAExE;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEpD;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;OAKG;IACH,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,GAAG,cAAc,CAAC;IAEtD;;;;;OAKG;IACH,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,cAAc,GAAG,QAAQ,CAAC;CAChE;AAED;;;;;;;;GAQG;AACH,qBAAa,sBAAuB,YAAW,eAAe;IAC5D;;;;;;;;;OASG;IACH,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,GAAG,cAAc,CAmDpD;IAED,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,cAAc,GAAG,QAAQ,CA8C7D;CACF;AAWD,qDAAqD;AACrD,eAAO,MAAM,qBAAqB,OAAO,CAAC;AAE1C;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAS1G;AAED;;GAEG;AACH,wBAAgB,4BAA4B,IAAI,eAAe,CAE9D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,cAAc,GAAG,OAAO,CASzE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,cAAc,GAAG,OAAO,CAS5E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,cAAc,GAAG,MAAM,GAAG,IAAI,CAK7E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAE7E"}