@procedures/client 0.0.0-stage → 0.2.0

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

@@ -0,0 +1,216 @@
+/**
+ * HTTP Header Utilities
+ *
+ * Provides constants for standard HTTP headers and utilities for
+ * converting between universal metadata and HTTP headers.
+ */
+/**
+ * Standard HTTP Header Names
+ *
+ * Type-safe constants for commonly used HTTP headers.
+ * No more magic strings!
+ */
+export const HTTPHeaders = {
+    // Standard HTTP headers
+    CONTENT_TYPE: "Content-Type",
+    CONTENT_LENGTH: "Content-Length",
+    AUTHORIZATION: "Authorization",
+    USER_AGENT: "User-Agent",
+    ACCEPT: "Accept",
+    ACCEPT_ENCODING: "Accept-Encoding",
+    ACCEPT_LANGUAGE: "Accept-Language",
+    CACHE_CONTROL: "Cache-Control",
+    CONNECTION: "Connection",
+    HOST: "Host",
+    ORIGIN: "Origin",
+    REFERER: "Referer",
+    // Custom RPC headers
+    REQUEST_ID: "X-Request-Id",
+    // Authentication headers
+    API_KEY: "X-API-Key",
+    // Tracing headers (OpenTelemetry/Jaeger compatible)
+    TRACE_ID: "X-Trace-Id",
+    SPAN_ID: "X-Span-Id",
+    PARENT_SPAN_ID: "X-Parent-Span-Id",
+    // Timeout headers
+    TIMEOUT: "X-Timeout",
+    // The custom metadata of a request, as URI-encoded JSON (deep dive TRN-11)
+    METADATA: "X-Metadata",
+    // Server timing
+    SERVER_TIMING: "Server-Timing",
+};
+/**
+ * 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 class DefaultHeaderConverter {
+    /**
+     * 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) {
+        const headers = {};
+        // Authentication
+        if (metadata.auth?.token) {
+            headers[HTTPHeaders.AUTHORIZATION] = `Bearer ${metadata.auth.token}`;
+        }
+        if (metadata.auth?.apiKey) {
+            headers[HTTPHeaders.API_KEY] = metadata.auth.apiKey;
+        }
+        // Distributed Tracing
+        if (metadata.tracing?.traceId) {
+            headers[HTTPHeaders.TRACE_ID] = metadata.tracing.traceId;
+        }
+        if (metadata.tracing?.spanId) {
+            headers[HTTPHeaders.SPAN_ID] = metadata.tracing.spanId;
+        }
+        if (metadata.tracing?.parentSpanId) {
+            headers[HTTPHeaders.PARENT_SPAN_ID] = metadata.tracing.parentSpanId;
+        }
+        // Timeouts
+        if (metadata.timeout?.overall) {
+            headers[HTTPHeaders.TIMEOUT] = String(metadata.timeout.overall);
+        }
+        const custom = {};
+        for (const [key, value] of Object.entries(metadata)) {
+            // Skip known structured fields and the internal keys
+            if (STRUCTURED_FIELDS.has(key) || key.startsWith("__") || value === undefined) {
+                continue;
+            }
+            custom[key] = value;
+            if (typeof value === "string" && HEADER_TOKEN.test(key) && LATIN1.test(value)) {
+                headers[key] = value;
+            }
+        }
+        if (Object.keys(custom).length > 0) {
+            const encoded = encodeURIComponent(JSON.stringify(custom));
+            if (encoded.length > METADATA_HEADER_LIMIT) {
+                throw Object.assign(new Error(`The request metadata is too large for a header (${encoded.length} > ${METADATA_HEADER_LIMIT} characters)`), { code: "METADATA_TOO_LARGE" });
+            }
+            headers[HTTPHeaders.METADATA] = encoded;
+        }
+        return headers;
+    }
+    headersToMetadata(headers) {
+        const metadata = {};
+        // Normalize to getter function
+        const get = (name) => {
+            if (headers instanceof Headers) {
+                return headers.get(name);
+            }
+            return headers[name] ?? headers[name.toLowerCase()] ?? null;
+        };
+        // Extract tracing headers
+        const traceId = get(HTTPHeaders.TRACE_ID);
+        const spanId = get(HTTPHeaders.SPAN_ID);
+        const parentSpanId = get(HTTPHeaders.PARENT_SPAN_ID);
+        if (traceId || spanId) {
+            metadata.tracing = {
+                traceId: traceId || "",
+                spanId: spanId || "",
+                ...(parentSpanId && { parentSpanId }),
+            };
+        }
+        // Extract timing headers
+        const serverTiming = get(HTTPHeaders.SERVER_TIMING);
+        if (serverTiming) {
+            metadata["timing"] = serverTiming;
+        }
+        // Extract timeout
+        const timeout = get(HTTPHeaders.TIMEOUT);
+        if (timeout) {
+            const timeoutMs = parseInt(timeout, 10);
+            if (!isNaN(timeoutMs)) {
+                metadata.timeout = { overall: timeoutMs };
+            }
+        }
+        // Extract API key (but not Authorization - that's sensitive)
+        const apiKey = get(HTTPHeaders.API_KEY);
+        if (apiKey) {
+            metadata.auth = { apiKey };
+        }
+        return metadata;
+    }
+}
+/** The metadata fields that have their own headers, and the middleware state: not custom fields. */
+const STRUCTURED_FIELDS = new Set(["tracing", "auth", "timeout", "retry"]);
+/** A header name: the "token" characters of RFC 9110. */
+const HEADER_TOKEN = /^[!#$%&'*+.^_`|~0-9A-Za-z-]+$/;
+/** A header value that fetch accepts: Latin-1, with no control characters but tab. */
+const LATIN1 = /^[\t\x20-\x7e\x80-\xff]*$/;
+/** The longest `X-Metadata` value, in characters. */
+export 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 function decodeMetadataHeader(value) {
+    if (!value || value.length > METADATA_HEADER_LIMIT)
+        return undefined;
+    try {
+        const decoded = JSON.parse(decodeURIComponent(value));
+        if (decoded === null || typeof decoded !== "object" || Array.isArray(decoded))
+            return undefined;
+        return decoded;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Create a default header converter instance
+ */
+export function createDefaultHeaderConverter() {
+    return new DefaultHeaderConverter();
+}
+/**
+ * Utility: Check if headers contain authentication
+ */
+export function hasAuthHeaders(headers) {
+    const get = (name) => {
+        if (headers instanceof Headers) {
+            return headers.get(name);
+        }
+        return headers[name] ?? headers[name.toLowerCase()] ?? null;
+    };
+    return !!(get(HTTPHeaders.AUTHORIZATION) || get(HTTPHeaders.API_KEY));
+}
+/**
+ * Utility: Check if headers contain tracing information
+ */
+export function hasTracingHeaders(headers) {
+    const get = (name) => {
+        if (headers instanceof Headers) {
+            return headers.get(name);
+        }
+        return headers[name] ?? headers[name.toLowerCase()] ?? null;
+    };
+    return !!(get(HTTPHeaders.TRACE_ID) || get(HTTPHeaders.SPAN_ID));
+}
+/**
+ * Utility: Extract request ID from headers
+ */
+export function getRequestId(headers) {
+    if (headers instanceof Headers) {
+        return headers.get(HTTPHeaders.REQUEST_ID);
+    }
+    return headers[HTTPHeaders.REQUEST_ID] ?? headers[HTTPHeaders.REQUEST_ID.toLowerCase()] ?? null;
+}
+/**
+ * Utility: Set request ID in headers
+ */
+export function setRequestId(headers, requestId) {
+    headers[HTTPHeaders.REQUEST_ID] = requestId;
+}
+//# sourceMappingURL=headers.js.map

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

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

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

@@ -0,0 +1,12 @@
+/**
+ * Shared HTTP Utilities
+ *
+ * Common constants, types, and utilities shared between
+ * client and server HTTP adapters.
+ */
+export * from "./constants.js";
+export * from "./status-codes.js";
+export * from "./headers.js";
+export * from "./strategies.js";
+export * from "./errors.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/adapters/http/shared/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,cAAc,gBAAgB,CAAC;AAG/B,cAAc,mBAAmB,CAAC;AAGlC,cAAc,cAAc,CAAC;AAG7B,cAAc,iBAAiB,CAAC;AAGhC,cAAc,aAAa,CAAC"}

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

@@ -0,0 +1,17 @@
+/**
+ * Shared HTTP Utilities
+ *
+ * Common constants, types, and utilities shared between
+ * client and server HTTP adapters.
+ */
+// Constants
+export * from "./constants.js";
+// Status Codes
+export * from "./status-codes.js";
+// Headers
+export * from "./headers.js";
+// Strategies
+export * from "./strategies.js";
+// Errors
+export * from "./errors.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/adapters/http/shared/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,YAAY;AACZ,cAAc,gBAAgB,CAAC;AAE/B,eAAe;AACf,cAAc,mBAAmB,CAAC;AAElC,UAAU;AACV,cAAc,cAAc,CAAC;AAE7B,aAAa;AACb,cAAc,iBAAiB,CAAC;AAEhC,SAAS;AACT,cAAc,aAAa,CAAC"}

package/dist/adapters/http/shared/status-codes.d.ts

@@ -0,0 +1,92 @@
+/**
+ * HTTP Status Code Utilities
+ *
+ * Utilities for working with HTTP status codes, including mappings
+ * and classification helpers.
+ */
+import { HTTPStatus } from "./constants.js";
+/**
+ * HTTP Status Code to String Code Mapping
+ *
+ * Maps numeric status codes to semantic string codes.
+ */
+export declare const HTTPStatusToCode: Record<HTTPStatus, string>;
+/**
+ * Legacy alias for backwards compatibility
+ * @deprecated Use HTTPStatusToCode instead
+ */
+export declare const HTTPCodeMap: typeof HTTPStatusToCode;
+/**
+ * String Code to HTTP Status Mapping (Reverse of HTTPStatusToCode)
+ *
+ * Maps semantic string codes back to numeric status codes.
+ */
+export declare const CodeToHTTPStatus: Record<string, HTTPStatus>;
+/**
+ * Check if status code represents success (2xx)
+ */
+export declare function isSuccessStatus(status: HTTPStatus): boolean;
+/**
+ * Check if status code represents informational response (1xx)
+ */
+export declare function isInformationalStatus(status: HTTPStatus): boolean;
+/**
+ * Check if status code represents redirection (3xx)
+ */
+export declare function isRedirectStatus(status: HTTPStatus): boolean;
+/**
+ * Check if status code represents client error (4xx)
+ */
+export declare function isClientErrorStatus(status: HTTPStatus): boolean;
+/**
+ * Check if status code represents server error (5xx)
+ */
+export declare function isServerErrorStatus(status: HTTPStatus): boolean;
+/**
+ * Check if status code represents any error (4xx or 5xx)
+ */
+export declare function isErrorStatus(status: HTTPStatus): boolean;
+/**
+ * Check if status code is typically retryable
+ *
+ * Default policy: server errors and specific client errors (timeout, rate limit) are retryable.
+ * Can be overridden via retry middleware configuration.
+ */
+export declare function isRetryableStatus(status: HTTPStatus): boolean;
+/**
+ * Get semantic code string for a status
+ *
+ * @example
+ * ```typescript
+ * getStatusCode(HTTPStatus.OK) // "OK"
+ * getStatusCode(404) // "NOT_FOUND"
+ * getStatusCode(999) // "UNKNOWN"
+ * ```
+ */
+export declare function getStatusCode(status: HTTPStatus): string;
+/**
+ * Get HTTP status from semantic code string
+ *
+ * @example
+ * ```typescript
+ * getStatusFromCode("OK") // HTTPStatus.OK (200)
+ * getStatusFromCode("NOT_FOUND") // HTTPStatus.NOT_FOUND (404)
+ * getStatusFromCode("INVALID") // HTTPStatus.UNKNOWN (0)
+ * ```
+ */
+export declare function getStatusFromCode(code: string): HTTPStatus;
+/**
+ * Format HTTP error message
+ *
+ * @example
+ * ```typescript
+ * formatHTTPError(HTTPStatus.NOT_FOUND) // "HTTP 404"
+ * formatHTTPError(500) // "HTTP 500"
+ * ```
+ */
+export declare function formatHTTPError(status: HTTPStatus): string;
+/**
+ * Validate if a number is a valid HTTP status code
+ */
+export declare function isValidHTTPStatus(status: number): status is HTTPStatus;
+//# sourceMappingURL=status-codes.d.ts.map

package/dist/adapters/http/shared/status-codes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-codes.d.ts","sourceRoot":"","sources":["../../../../src/adapters/http/shared/status-codes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAQ,MAAM,gBAAgB,CAAC;AAElD;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAqET,CAAC;AAEhD;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,OAAO,gBAAmC,CAAC;AAErE;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAEzB,CAAC;AAEhC;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAE3D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAEjE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAE5D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAE/D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAE/D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAEzD;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAe7D;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAExD;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAE1D;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAE1D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,IAAI,UAAU,CAEtE"}

package/dist/adapters/http/shared/status-codes.js

@@ -0,0 +1,189 @@
+/**
+ * HTTP Status Code Utilities
+ *
+ * Utilities for working with HTTP status codes, including mappings
+ * and classification helpers.
+ */
+import { HTTPStatus, HTTP } from "./constants.js";
+/**
+ * HTTP Status Code to String Code Mapping
+ *
+ * Maps numeric status codes to semantic string codes.
+ */
+export const HTTPStatusToCode = {
+    [HTTPStatus.UNKNOWN]: "UNKNOWN",
+    [HTTPStatus.CONTINUE]: "CONTINUE",
+    [HTTPStatus.SWITCHING_PROTOCOLS]: "SWITCHING_PROTOCOLS",
+    [HTTPStatus.PROCESSING]: "PROCESSING",
+    [HTTPStatus.EARLY_HINTS]: "EARLY_HINTS",
+    [HTTPStatus.RESPONSE_IS_TOO_LARGE]: "RESPONSE_IS_TOO_LARGE",
+    [HTTPStatus.OK]: "OK",
+    [HTTPStatus.CREATED]: "CREATED",
+    [HTTPStatus.ACCEPTED]: "ACCEPTED",
+    [HTTPStatus.NON_AUTHORITATIVE_INFORMATION]: "NON_AUTHORITATIVE_INFORMATION",
+    [HTTPStatus.NO_CONTENT]: "NO_CONTENT",
+    [HTTPStatus.RESET_CONTENT]: "RESET_CONTENT",
+    [HTTPStatus.PARTIAL_CONTENT]: "PARTIAL_CONTENT",
+    [HTTPStatus.MULTI_STATUS]: "MULTI_STATUS",
+    [HTTPStatus.ALREADY_REPORTED]: "ALREADY_REPORTED",
+    [HTTPStatus.IM_USED]: "IM_USED",
+    [HTTPStatus.MULTIPLE_CHOICES]: "MULTIPLE_CHOICES",
+    [HTTPStatus.MOVED_PERMANENTLY]: "MOVED_PERMANENTLY",
+    [HTTPStatus.FOUND]: "FOUND",
+    [HTTPStatus.SEE_OTHER]: "SEE_OTHER",
+    [HTTPStatus.NOT_MODIFIED]: "NOT_MODIFIED",
+    [HTTPStatus.USE_PROXY]: "USE_PROXY",
+    [HTTPStatus.TEMPORARY_REDIRECT]: "TEMPORARY_REDIRECT",
+    [HTTPStatus.PERMANENT_REDIRECT]: "PERMANENT_REDIRECT",
+    [HTTPStatus.BAD_REQUEST]: "BAD_REQUEST",
+    [HTTPStatus.UNAUTHORIZED]: "UNAUTHORIZED",
+    [HTTPStatus.FORBIDDEN]: "FORBIDDEN",
+    [HTTPStatus.NOT_FOUND]: "NOT_FOUND",
+    [HTTPStatus.METHOD_NOT_ALLOWED]: "METHOD_NOT_ALLOWED",
+    [HTTPStatus.NOT_ACCEPTABLE]: "NOT_ACCEPTABLE",
+    [HTTPStatus.PROXY_AUTHENTICATION_REQUIRED]: "PROXY_AUTHENTICATION_REQUIRED",
+    [HTTPStatus.REQUEST_TIMEOUT]: "REQUEST_TIMEOUT",
+    [HTTPStatus.CONFLICT]: "CONFLICT",
+    [HTTPStatus.GONE]: "GONE",
+    [HTTPStatus.LENGTH_REQUIRED]: "LENGTH_REQUIRED",
+    [HTTPStatus.PRECONDITION_FAILED]: "PRECONDITION_FAILED",
+    [HTTPStatus.PAYLOAD_TOO_LARGE]: "PAYLOAD_TOO_LARGE",
+    [HTTPStatus.URI_TOO_LONG]: "URI_TOO_LONG",
+    [HTTPStatus.UNSUPPORTED_MEDIA_TYPE]: "UNSUPPORTED_MEDIA_TYPE",
+    [HTTPStatus.RANGE_NOT_SATISFIABLE]: "RANGE_NOT_SATISFIABLE",
+    [HTTPStatus.EXPECTATION_FAILED]: "EXPECTATION_FAILED",
+    [HTTPStatus.IM_A_TEAPOT]: "IM_A_TEAPOT",
+    [HTTPStatus.MISDIRECTED_REQUEST]: "MISDIRECTED_REQUEST",
+    [HTTPStatus.UNPROCESSABLE_ENTITY]: "UNPROCESSABLE_ENTITY",
+    [HTTPStatus.LOCKED]: "LOCKED",
+    [HTTPStatus.FAILED_DEPENDENCY]: "FAILED_DEPENDENCY",
+    [HTTPStatus.TOO_EARLY]: "TOO_EARLY",
+    [HTTPStatus.UPGRADE_REQUIRED]: "UPGRADE_REQUIRED",
+    [HTTPStatus.PRECONDITION_REQUIRED]: "PRECONDITION_REQUIRED",
+    [HTTPStatus.TOO_MANY_REQUESTS]: "TOO_MANY_REQUESTS",
+    [HTTPStatus.REQUEST_HEADER_FIELDS_TOO_LARGE]: "REQUEST_HEADER_FIELDS_TOO_LARGE",
+    [HTTPStatus.UNAVAILABLE_FOR_LEGAL_REASONS]: "UNAVAILABLE_FOR_LEGAL_REASONS",
+    [HTTPStatus.CLIENT_CLOSED_REQUEST]: "CLIENT_CLOSED_REQUEST",
+    [HTTPStatus.INTERNAL_SERVER_ERROR]: "INTERNAL_SERVER_ERROR",
+    [HTTPStatus.NOT_IMPLEMENTED]: "NOT_IMPLEMENTED",
+    [HTTPStatus.BAD_GATEWAY]: "BAD_GATEWAY",
+    [HTTPStatus.SERVICE_UNAVAILABLE]: "SERVICE_UNAVAILABLE",
+    [HTTPStatus.GATEWAY_TIMEOUT]: "GATEWAY_TIMEOUT",
+    [HTTPStatus.HTTP_VERSION_NOT_SUPPORTED]: "HTTP_VERSION_NOT_SUPPORTED",
+    [HTTPStatus.VARIANT_ALSO_NEGOTIATES]: "VARIANT_ALSO_NEGOTIATES",
+    [HTTPStatus.INSUFFICIENT_STORAGE]: "INSUFFICIENT_STORAGE",
+    [HTTPStatus.LOOP_DETECTED]: "LOOP_DETECTED",
+    [HTTPStatus.NOT_EXTENDED]: "NOT_EXTENDED",
+    [HTTPStatus.NETWORK_AUTHENTICATION_REQUIRED]: "NETWORK_AUTHENTICATION_REQUIRED",
+    [HTTPStatus.HTTP_NETWORK_CONNECT_TIMEOUT_ERROR]: "HTTP_NETWORK_CONNECT_TIMEOUT_ERROR",
+};
+/**
+ * Legacy alias for backwards compatibility
+ * @deprecated Use HTTPStatusToCode instead
+ */
+export const HTTPCodeMap = HTTPStatusToCode;
+/**
+ * String Code to HTTP Status Mapping (Reverse of HTTPStatusToCode)
+ *
+ * Maps semantic string codes back to numeric status codes.
+ */
+export const CodeToHTTPStatus = Object.fromEntries(Object.entries(HTTPStatusToCode).map(([status, code]) => [code, Number(status)]));
+/**
+ * Check if status code represents success (2xx)
+ */
+export function isSuccessStatus(status) {
+    return status >= HTTPStatus.OK && status < HTTPStatus.MULTIPLE_CHOICES;
+}
+/**
+ * Check if status code represents informational response (1xx)
+ */
+export function isInformationalStatus(status) {
+    return status >= HTTPStatus.CONTINUE && status < HTTPStatus.OK;
+}
+/**
+ * Check if status code represents redirection (3xx)
+ */
+export function isRedirectStatus(status) {
+    return status >= HTTPStatus.MULTIPLE_CHOICES && status < HTTPStatus.BAD_REQUEST;
+}
+/**
+ * Check if status code represents client error (4xx)
+ */
+export function isClientErrorStatus(status) {
+    return status >= HTTPStatus.BAD_REQUEST && status < HTTPStatus.INTERNAL_SERVER_ERROR;
+}
+/**
+ * Check if status code represents server error (5xx)
+ */
+export function isServerErrorStatus(status) {
+    return status >= HTTPStatus.INTERNAL_SERVER_ERROR && status < 600;
+}
+/**
+ * Check if status code represents any error (4xx or 5xx)
+ */
+export function isErrorStatus(status) {
+    return isClientErrorStatus(status) || isServerErrorStatus(status);
+}
+/**
+ * Check if status code is typically retryable
+ *
+ * Default policy: server errors and specific client errors (timeout, rate limit) are retryable.
+ * Can be overridden via retry middleware configuration.
+ */
+export function isRetryableStatus(status) {
+    // Server errors are generally retryable
+    if (isServerErrorStatus(status)) {
+        return true;
+    }
+    // Specific client errors that are retryable
+    if (status === HTTPStatus.REQUEST_TIMEOUT ||
+        status === HTTPStatus.TOO_MANY_REQUESTS) {
+        return true;
+    }
+    return false;
+}
+/**
+ * Get semantic code string for a status
+ *
+ * @example
+ * ```typescript
+ * getStatusCode(HTTPStatus.OK) // "OK"
+ * getStatusCode(404) // "NOT_FOUND"
+ * getStatusCode(999) // "UNKNOWN"
+ * ```
+ */
+export function getStatusCode(status) {
+    return HTTPStatusToCode[status] ?? HTTPStatusToCode[HTTPStatus.UNKNOWN];
+}
+/**
+ * Get HTTP status from semantic code string
+ *
+ * @example
+ * ```typescript
+ * getStatusFromCode("OK") // HTTPStatus.OK (200)
+ * getStatusFromCode("NOT_FOUND") // HTTPStatus.NOT_FOUND (404)
+ * getStatusFromCode("INVALID") // HTTPStatus.UNKNOWN (0)
+ * ```
+ */
+export function getStatusFromCode(code) {
+    return CodeToHTTPStatus[code] ?? HTTPStatus.UNKNOWN;
+}
+/**
+ * Format HTTP error message
+ *
+ * @example
+ * ```typescript
+ * formatHTTPError(HTTPStatus.NOT_FOUND) // "HTTP 404"
+ * formatHTTPError(500) // "HTTP 500"
+ * ```
+ */
+export function formatHTTPError(status) {
+    return `${HTTP} ${status}`;
+}
+/**
+ * Validate if a number is a valid HTTP status code
+ */
+export function isValidHTTPStatus(status) {
+    return status in HTTPStatusToCode;
+}
+//# sourceMappingURL=status-codes.js.map

package/dist/adapters/http/shared/status-codes.js.map

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

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

@@ -0,0 +1,90 @@
+/**
+ * HTTP Strategy Interfaces
+ *
+ * Defines extensible, bidirectional strategies for URL mapping
+ * and HTTP method selection. These strategies ensure client
+ * and server use consistent, inverse operations.
+ */
+import type { Method } from "../../../client/types.js";
+import { HTTPMethod } from "./constants.js";
+/**
+ * URL Strategy (Client-side)
+ *
+ * Converts Method → URL
+ */
+export type UrlStrategy = (method: Method, baseUrl: string) => string;
+/**
+ * URL Parser Strategy (Server-side)
+ *
+ * Converts URL → Method (inverse of UrlStrategy)
+ */
+export type UrlParserStrategy = (url: string, httpMethod: HTTPMethod) => Method | null;
+/**
+ * HTTP Method Strategy (Client-side)
+ *
+ * Converts Method → HTTP method verb
+ */
+export type HttpMethodStrategy = (method: Method) => HTTPMethod;
+/**
+ * HTTP Method Parser Strategy (Server-side)
+ *
+ * Converts HTTP method verb → operation hints (inverse of HttpMethodStrategy)
+ */
+export type HttpMethodParserStrategy = (httpMethod: HTTPMethod) => Partial<Method>;
+/**
+ * Bidirectional URL Pattern
+ *
+ * Encapsulates both URL generation (client) and parsing (server)
+ * to ensure they remain algorithmic inverses.
+ */
+export interface UrlPattern {
+    /** Template pattern (e.g., "/{version?}/{service}/{operation}") */
+    readonly template: string;
+    /** Generate URL from Method (client-side) */
+    format(method: Method, baseUrl: string): string;
+    /** Parse URL back to Method (server-side) */
+    parse(url: string, httpMethod: HTTPMethod): Method | null;
+}
+/**
+ * Default URL Pattern: /{version?}/{service}/{operation}
+ *
+ * Examples:
+ * - { service: "users", operation: "get" } → "/users/get"
+ * - { service: "users", operation: "get", version: "v2" } → "/v2/users/get"
+ */
+export declare const defaultUrlPattern: UrlPattern;
+/**
+ * RESTful URL Pattern: /{version?}/{service}/{id?}
+ *
+ * Infers operation from HTTP method and presence of ID:
+ * - GET /users → list
+ * - GET /users/123 → get
+ * - POST /users → create
+ * - PUT /users/123 → update
+ * - PATCH /users/123 → patch
+ * - DELETE /users/123 → delete
+ */
+export declare const restfulUrlPattern: UrlPattern;
+/**
+ * RESTful HTTP Method Strategy
+ *
+ * Maps operation names to HTTP methods:
+ * - get/list/find/watch → GET
+ * - create → POST
+ * - update → PUT
+ * - patch → PATCH
+ * - delete/remove → DELETE
+ * - default → POST
+ */
+export declare const restfulHttpMethodStrategy: HttpMethodStrategy;
+/**
+ * POST-only HTTP Method Strategy
+ *
+ * All operations use POST (simple RPC style).
+ */
+export declare const postOnlyStrategy: HttpMethodStrategy;
+/**
+ * Validate payload can be JSON stringified
+ */
+export declare function isValidJSONPayload(payload: unknown): boolean;
+//# sourceMappingURL=strategies.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"strategies.d.ts","sourceRoot":"","sources":["../../../../src/adapters/http/shared/strategies.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;AAEtE;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,KAAK,MAAM,GAAG,IAAI,CAAC;AAEvF;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,UAAU,CAAC;AAEhE;;;;GAIG;AACH,MAAM,MAAM,wBAAwB,GAAG,CAAC,UAAU,EAAE,UAAU,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAEnF;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,mEAAmE;IACnE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B,6CAA6C;IAC7C,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IAEhD,6CAA6C;IAC7C,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI,CAAC;CAC3D;AAED;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,EAAE,UA2C/B,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,iBAAiB,EAAE,UA+D/B,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,yBAAyB,EAAE,kBAyBvC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,EAAE,kBAA0C,CAAC;AAsB1E;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAE5D"}