@webpieces/http-client-core 0.4.790 → 0.4.792

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webpieces/http-client-core",
-  "version": "0.4.790",
+  "version": "0.4.792",
   "description": "Isomorphic core of the webpieces HTTP client: the decorator-driven ProxyClient, error translation, and the Proxy trap shared by http-client-node and http-client-browser",
   "type": "commonjs",
   "main": "./src/index.js",
@@ -21,6 +21,6 @@
     "access": "public"
   },
   "dependencies": {
-    "@webpieces/core-util": "0.4.790"
+    "@webpieces/core-util": "0.4.792"
   }
 }

package/src/ClientErrorTranslator.d.ts

@@ -1,11 +1,35 @@
 import { HttpResponseDto } from '@webpieces/core-util';
-import { TranslatedFailure } from './TranslatedFailure';
-/** Reconstructs transport-neutral API failures from an HTTP response. */
+/**
+ * The CLIENT half of the wire seam: hand every response to THE registered
+ * {@link ErrorTranslator}'s `fromWire`, and guarantee the one invariant a typed caller depends on.
+ *
+ * There is no "was a translator registered" question here — {@link ClientRegistry.getErrorTranslator}
+ * is non-optional — and no `TranslatedFailure` provenance record either. Provenance existed only to
+ * feed `ProxyClient.adaptDownstreamFailure`, and the uniform 4xx/5xx rule in
+ * {@link WebpiecesDefaultErrorTranslator} deleted that hook: an app that wants a downstream status
+ * relayed as its own type says so by THROWING it from its own `fromWire`.
+ */
 export declare class ClientErrorTranslator {
-    static translateError(response: HttpResponseDto): TranslatedFailure;
-    /** Semantic body kind is authoritative when it agrees with the HTTP adapter status. */
-    static builtInError(response: HttpResponseDto): Error;
-    /** Non-Webpieces responders: named statuses map to their class, any other 100-599 to ApiCodedError. */
-    private static fromStatus;
-    private static fallbackMessage;
+    /**
+     * Run `fromWire` over a response, and make it impossible for a FAILURE response to be handed to a
+     * typed caller as if it were data.
+     *
+     * Every response goes through here, 2xx included, so an app whose 200 body signals failure can
+     * turn it into a throw (see {@link ErrorTranslator.fromWire}).
+     *
+     * The second call is BUG CONTAINMENT, not a fallback branch: an app translator that returns
+     * normally for a non-2xx has a bug whose symptom would otherwise be `undefined` arriving where
+     * the contract promised a DTO. The webpieces default answers instead — and for a genuine 2xx it
+     * returns silently, so the normal path costs one predicate.
+     */
+    static throwIfFailure(response: HttpResponseDto): void;
+    /**
+     * {@link throwIfFailure} for a response the CALLER has already established is not an ordinary
+     * success (not 2xx, or a 266). Typed `never`, which is what lets `ProxyClient.readResponse` end on
+     * this call instead of on a `return undefined` the contract forbids.
+     *
+     * The trailing throw is NOT dead code standing in for a type: it fires exactly when this is
+     * called with an ordinary 2xx, which is a framework bug in the caller, and says so.
+     */
+    static throwFailure(response: HttpResponseDto): never;
 }

package/src/ClientErrorTranslator.js

@@ -2,88 +2,48 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ClientErrorTranslator = void 0;
 const core_util_1 = require("@webpieces/core-util");
-const TranslatedFailure_1 = require("./TranslatedFailure");
-const UnexpectedApiResponseError_1 = require("./UnexpectedApiResponseError");
-/** Reconstructs transport-neutral API failures from an HTTP response. */
+/**
+ * The CLIENT half of the wire seam: hand every response to THE registered
+ * {@link ErrorTranslator}'s `fromWire`, and guarantee the one invariant a typed caller depends on.
+ *
+ * There is no "was a translator registered" question here — {@link ClientRegistry.getErrorTranslator}
+ * is non-optional — and no `TranslatedFailure` provenance record either. Provenance existed only to
+ * feed `ProxyClient.adaptDownstreamFailure`, and the uniform 4xx/5xx rule in
+ * {@link WebpiecesDefaultErrorTranslator} deleted that hook: an app that wants a downstream status
+ * relayed as its own type says so by THROWING it from its own `fromWire`.
+ */
 class ClientErrorTranslator {
+    /**
+     * Run `fromWire` over a response, and make it impossible for a FAILURE response to be handed to a
+     * typed caller as if it were data.
+     *
+     * Every response goes through here, 2xx included, so an app whose 200 body signals failure can
+     * turn it into a throw (see {@link ErrorTranslator.fromWire}).
+     *
+     * The second call is BUG CONTAINMENT, not a fallback branch: an app translator that returns
+     * normally for a non-2xx has a bug whose symptom would otherwise be `undefined` arriving where
+     * the contract promised a DTO. The webpieces default answers instead — and for a genuine 2xx it
+     * returns silently, so the normal path costs one predicate.
+     */
     // webpieces-disable no-function-outside-class -- pure stateless mapping shared by browser and node
-    static translateError(response) {
-        // `undefined` here is PROVENANCE, not a fallback: `TranslatedFailure.appRegistered` is what
-        // `NodeProxyClient.adaptDownstreamFailure` reads to tell an app's deliberate claim on a
-        // status apart from the framework's generic default for it.
-        const custom = core_util_1.ClientRegistry.getErrorTranslators()?.fromWire(response);
-        if (custom !== undefined)
-            return new TranslatedFailure_1.TranslatedFailure(custom, true, response.status.code);
-        return new TranslatedFailure_1.TranslatedFailure(this.builtInError(response), false, response.status.code);
+    static throwIfFailure(response) {
+        core_util_1.ClientRegistry.getErrorTranslator().fromWire(response);
+        core_util_1.WEBPIECES_DEFAULT_ERROR_TRANSLATOR.fromWire(response);
     }
-    /** Semantic body kind is authoritative when it agrees with the HTTP adapter status. */
-    // webpieces-disable no-function-outside-class -- public delegable default mapping
-    static builtInError(response) {
-        if (core_util_1.ApiErrorCodec.isPayload(response.body)) {
-            const decoded = core_util_1.ApiErrorCodec.decode(response.body);
-            // `statusCode` is the 'coded' kind's own status, the one thing the shared table cannot
-            // know. This side legitimately holds an `ApiError` — it just decoded one — which is why
-            // `hasCode` stays: it narrows the kind to the published subset `codeFor` accepts.
-            const statusCode = decoded instanceof core_util_1.ApiCodedError ? decoded.statusCode : undefined;
-            if (core_util_1.ApiErrorHttpStatus.hasCode(decoded) &&
-                core_util_1.ApiErrorHttpStatus.codeFor(decoded.kind, statusCode) === response.status.code)
-                return decoded;
-            return new core_util_1.ApiImplementationError('Internal Error', undefined, true);
-        }
-        return this.fromStatus(response.status.code, this.fallbackMessage(response.body, response.status.reason));
-    }
-    /** Non-Webpieces responders: named statuses map to their class, any other 100-599 to ApiCodedError. */
-    // webpieces-disable no-function-outside-class -- fallback for non-Webpieces HTTP responders
-    static fromStatus(statusCode, message) {
-        switch (statusCode) {
-            case 266:
-                return new core_util_1.ApiEndUserError(message);
-            case 400:
-                return new core_util_1.ApiBadRequestError(message);
-            case 401:
-                return new core_util_1.ApiUnauthorizedError(message);
-            case 403:
-                return new core_util_1.ApiForbiddenError(message);
-            case 404:
-                return new core_util_1.ApiNotFoundError(message);
-            case 408:
-                return new core_util_1.ApiRequestTimeoutError(message);
-            case 409:
-                return new core_util_1.ApiConflictError(message);
-            case 412:
-                return new core_util_1.ApiPreconditionFailedError(message);
-            case 415:
-                return new core_util_1.ApiUnsupportedMediaTypeError(message);
-            case 422:
-                return new core_util_1.ApiUnprocessableError(message);
-            case 429:
-                return new core_util_1.ApiRateLimitedError(message);
-            case 500:
-                return new core_util_1.ApiImplementationError('Internal Error', undefined, true);
-            case 501:
-                return new core_util_1.ApiNotImplementedError(message);
-            case 502:
-                return new core_util_1.ApiDependencyError(message);
-            case 503:
-                return new core_util_1.ApiUnavailableError(message);
-            case 504:
-                return new core_util_1.ApiDependencyTimeoutError(message);
-            default:
-                // Any other real HTTP status keeps its code; only a value no HTTP status can hold is unexpected.
-                if (core_util_1.ApiCodedError.isStatusCode(statusCode))
-                    return new core_util_1.ApiCodedError(message, statusCode);
-                return new UnexpectedApiResponseError_1.UnexpectedApiResponseError(statusCode, message);
-        }
-    }
-    // webpieces-disable no-any-unknown -- HTTP response bodies are app-owned until this boundary safely inspects them
-    // webpieces-disable no-function-outside-class -- bounds diagnostic text from a foreign responder
-    static fallbackMessage(body, reason) {
-        if (typeof body === 'object' && body !== null) {
-            const message = Object.getOwnPropertyDescriptor(body, 'message')?.value;
-            if (typeof message === 'string' && message.length > 0)
-                return message.slice(0, 4096);
-        }
-        return reason || 'Request Failed';
+    /**
+     * {@link throwIfFailure} for a response the CALLER has already established is not an ordinary
+     * success (not 2xx, or a 266). Typed `never`, which is what lets `ProxyClient.readResponse` end on
+     * this call instead of on a `return undefined` the contract forbids.
+     *
+     * The trailing throw is NOT dead code standing in for a type: it fires exactly when this is
+     * called with an ordinary 2xx, which is a framework bug in the caller, and says so.
+     */
+    // webpieces-disable no-function-outside-class -- pure stateless mapping shared by browser and node
+    static throwFailure(response) {
+        ClientErrorTranslator.throwIfFailure(response);
+        throw new core_util_1.ApiImplementationError(`ClientErrorTranslator.throwFailure was called for HTTP ${response.status.code}, ` +
+            `which is an ordinary success. Only a non-2xx (or a 266) response reaches here; ` +
+            `use throwIfFailure for a response that may legitimately pass.`);
     }
 }
 exports.ClientErrorTranslator = ClientErrorTranslator;

package/src/ClientErrorTranslator.js.map

@@ -1 +1 @@
-{"version":3,"file":"ClientErrorTranslator.js","sourceRoot":"","sources":["../../../../../packages/http/http-client-core/src/ClientErrorTranslator.ts"],"names":[],"mappings":";;;AAAA,oDAsB8B;AAC9B,2DAAwD;AACxD,6EAA0E;AAE1E,yEAAyE;AACzE,MAAa,qBAAqB;IAC9B,mGAAmG;IACnG,MAAM,CAAC,cAAc,CAAC,QAAyB;QAC3C,4FAA4F;QAC5F,wFAAwF;QACxF,4DAA4D;QAC5D,MAAM,MAAM,GAAG,0BAAc,CAAC,mBAAmB,EAAE,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACxE,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,IAAI,qCAAiB,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC3F,OAAO,IAAI,qCAAiB,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC3F,CAAC;IAED,uFAAuF;IACvF,kFAAkF;IAClF,MAAM,CAAC,YAAY,CAAC,QAAyB;QACzC,IAAI,yBAAa,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACzC,MAAM,OAAO,GAAG,yBAAa,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YACpD,uFAAuF;YACvF,wFAAwF;YACxF,kFAAkF;YAClF,MAAM,UAAU,GAAG,OAAO,YAAY,yBAAa,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;YACrF,IACI,8BAAkB,CAAC,OAAO,CAAC,OAAO,CAAC;gBACnC,8BAAkB,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,UAAU,CAAC,KAAK,QAAQ,CAAC,MAAM,CAAC,IAAI;gBAE7E,OAAO,OAAO,CAAC;YACnB,OAAO,IAAI,kCAAsB,CAAC,gBAAgB,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;QACzE,CAAC;QACD,OAAO,IAAI,CAAC,UAAU,CAClB,QAAQ,CAAC,MAAM,CAAC,IAAI,EACpB,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAC9D,CAAC;IACN,CAAC;IAED,uGAAuG;IACvG,4FAA4F;IACpF,MAAM,CAAC,UAAU,CAAC,UAAkB,EAAE,OAAe;QACzD,QAAQ,UAAU,EAAE,CAAC;YACjB,KAAK,GAAG;gBACJ,OAAO,IAAI,2BAAe,CAAC,OAAO,CAAC,CAAC;YACxC,KAAK,GAAG;gBACJ,OAAO,IAAI,8BAAkB,CAAC,OAAO,CAAC,CAAC;YAC3C,KAAK,GAAG;gBACJ,OAAO,IAAI,gCAAoB,CAAC,OAAO,CAAC,CAAC;YAC7C,KAAK,GAAG;gBACJ,OAAO,IAAI,6BAAiB,CAAC,OAAO,CAAC,CAAC;YAC1C,KAAK,GAAG;gBACJ,OAAO,IAAI,4BAAgB,CAAC,OAAO,CAAC,CAAC;YACzC,KAAK,GAAG;gBACJ,OAAO,IAAI,kCAAsB,CAAC,OAAO,CAAC,CAAC;YAC/C,KAAK,GAAG;gBACJ,OAAO,IAAI,4BAAgB,CAAC,OAAO,CAAC,CAAC;YACzC,KAAK,GAAG;gBACJ,OAAO,IAAI,sCAA0B,CAAC,OAAO,CAAC,CAAC;YACnD,KAAK,GAAG;gBACJ,OAAO,IAAI,wCAA4B,CAAC,OAAO,CAAC,CAAC;YACrD,KAAK,GAAG;gBACJ,OAAO,IAAI,iCAAqB,CAAC,OAAO,CAAC,CAAC;YAC9C,KAAK,GAAG;gBACJ,OAAO,IAAI,+BAAmB,CAAC,OAAO,CAAC,CAAC;YAC5C,KAAK,GAAG;gBACJ,OAAO,IAAI,kCAAsB,CAAC,gBAAgB,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;YACzE,KAAK,GAAG;gBACJ,OAAO,IAAI,kCAAsB,CAAC,OAAO,CAAC,CAAC;YAC/C,KAAK,GAAG;gBACJ,OAAO,IAAI,8BAAkB,CAAC,OAAO,CAAC,CAAC;YAC3C,KAAK,GAAG;gBACJ,OAAO,IAAI,+BAAmB,CAAC,OAAO,CAAC,CAAC;YAC5C,KAAK,GAAG;gBACJ,OAAO,IAAI,qCAAyB,CAAC,OAAO,CAAC,CAAC;YAClD;gBACI,iGAAiG;gBACjG,IAAI,yBAAa,CAAC,YAAY,CAAC,UAAU,CAAC;oBACtC,OAAO,IAAI,yBAAa,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;gBAClD,OAAO,IAAI,uDAA0B,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QACnE,CAAC;IACL,CAAC;IAED,kHAAkH;IAClH,iGAAiG;IACzF,MAAM,CAAC,eAAe,CAAC,IAAa,EAAE,MAAc;QACxD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAC5C,MAAM,OAAO,GAAG,MAAM,CAAC,wBAAwB,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,KAAK,CAAC;YACxE,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;gBAAE,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;QACzF,CAAC;QACD,OAAO,MAAM,IAAI,gBAAgB,CAAC;IACtC,CAAC;CACJ;AAtFD,sDAsFC","sourcesContent":["import {\n    ApiBadRequestError,\n    ApiCodedError,\n    ApiConflictError,\n    ApiDependencyError,\n    ApiDependencyTimeoutError,\n    ApiEndUserError,\n    ApiErrorCodec,\n    ApiForbiddenError,\n    ApiImplementationError,\n    ApiNotFoundError,\n    ApiNotImplementedError,\n    ApiPreconditionFailedError,\n    ApiRateLimitedError,\n    ApiRequestTimeoutError,\n    ApiUnauthorizedError,\n    ApiUnavailableError,\n    ApiUnprocessableError,\n    ApiUnsupportedMediaTypeError,\n    ClientRegistry,\n    ApiErrorHttpStatus,\n    HttpResponseDto,\n} from '@webpieces/core-util';\nimport { TranslatedFailure } from './TranslatedFailure';\nimport { UnexpectedApiResponseError } from './UnexpectedApiResponseError';\n\n/** Reconstructs transport-neutral API failures from an HTTP response. */\nexport class ClientErrorTranslator {\n    // webpieces-disable no-function-outside-class -- pure stateless mapping shared by browser and node\n    static translateError(response: HttpResponseDto): TranslatedFailure {\n        // `undefined` here is PROVENANCE, not a fallback: `TranslatedFailure.appRegistered` is what\n        // `NodeProxyClient.adaptDownstreamFailure` reads to tell an app's deliberate claim on a\n        // status apart from the framework's generic default for it.\n        const custom = ClientRegistry.getErrorTranslators()?.fromWire(response);\n        if (custom !== undefined) return new TranslatedFailure(custom, true, response.status.code);\n        return new TranslatedFailure(this.builtInError(response), false, response.status.code);\n    }\n\n    /** Semantic body kind is authoritative when it agrees with the HTTP adapter status. */\n    // webpieces-disable no-function-outside-class -- public delegable default mapping\n    static builtInError(response: HttpResponseDto): Error {\n        if (ApiErrorCodec.isPayload(response.body)) {\n            const decoded = ApiErrorCodec.decode(response.body);\n            // `statusCode` is the 'coded' kind's own status, the one thing the shared table cannot\n            // know. This side legitimately holds an `ApiError` — it just decoded one — which is why\n            // `hasCode` stays: it narrows the kind to the published subset `codeFor` accepts.\n            const statusCode = decoded instanceof ApiCodedError ? decoded.statusCode : undefined;\n            if (\n                ApiErrorHttpStatus.hasCode(decoded) &&\n                ApiErrorHttpStatus.codeFor(decoded.kind, statusCode) === response.status.code\n            )\n                return decoded;\n            return new ApiImplementationError('Internal Error', undefined, true);\n        }\n        return this.fromStatus(\n            response.status.code,\n            this.fallbackMessage(response.body, response.status.reason),\n        );\n    }\n\n    /** Non-Webpieces responders: named statuses map to their class, any other 100-599 to ApiCodedError. */\n    // webpieces-disable no-function-outside-class -- fallback for non-Webpieces HTTP responders\n    private static fromStatus(statusCode: number, message: string): Error {\n        switch (statusCode) {\n            case 266:\n                return new ApiEndUserError(message);\n            case 400:\n                return new ApiBadRequestError(message);\n            case 401:\n                return new ApiUnauthorizedError(message);\n            case 403:\n                return new ApiForbiddenError(message);\n            case 404:\n                return new ApiNotFoundError(message);\n            case 408:\n                return new ApiRequestTimeoutError(message);\n            case 409:\n                return new ApiConflictError(message);\n            case 412:\n                return new ApiPreconditionFailedError(message);\n            case 415:\n                return new ApiUnsupportedMediaTypeError(message);\n            case 422:\n                return new ApiUnprocessableError(message);\n            case 429:\n                return new ApiRateLimitedError(message);\n            case 500:\n                return new ApiImplementationError('Internal Error', undefined, true);\n            case 501:\n                return new ApiNotImplementedError(message);\n            case 502:\n                return new ApiDependencyError(message);\n            case 503:\n                return new ApiUnavailableError(message);\n            case 504:\n                return new ApiDependencyTimeoutError(message);\n            default:\n                // Any other real HTTP status keeps its code; only a value no HTTP status can hold is unexpected.\n                if (ApiCodedError.isStatusCode(statusCode))\n                    return new ApiCodedError(message, statusCode);\n                return new UnexpectedApiResponseError(statusCode, message);\n        }\n    }\n\n    // webpieces-disable no-any-unknown -- HTTP response bodies are app-owned until this boundary safely inspects them\n    // webpieces-disable no-function-outside-class -- bounds diagnostic text from a foreign responder\n    private static fallbackMessage(body: unknown, reason: string): string {\n        if (typeof body === 'object' && body !== null) {\n            const message = Object.getOwnPropertyDescriptor(body, 'message')?.value;\n            if (typeof message === 'string' && message.length > 0) return message.slice(0, 4096);\n        }\n        return reason || 'Request Failed';\n    }\n}\n"]}
+{"version":3,"file":"ClientErrorTranslator.js","sourceRoot":"","sources":["../../../../../packages/http/http-client-core/src/ClientErrorTranslator.ts"],"names":[],"mappings":";;;AAAA,oDAK8B;AAE9B;;;;;;;;;GASG;AACH,MAAa,qBAAqB;IAC9B;;;;;;;;;;;OAWG;IACH,mGAAmG;IACnG,MAAM,CAAC,cAAc,CAAC,QAAyB;QAC3C,0BAAc,CAAC,kBAAkB,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACvD,8CAAkC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC1D,CAAC;IAED;;;;;;;OAOG;IACH,mGAAmG;IACnG,MAAM,CAAC,YAAY,CAAC,QAAyB;QACzC,qBAAqB,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;QAC/C,MAAM,IAAI,kCAAsB,CAC5B,0DAA0D,QAAQ,CAAC,MAAM,CAAC,IAAI,IAAI;YAC9E,iFAAiF;YACjF,+DAA+D,CACtE,CAAC;IACN,CAAC;CACJ;AApCD,sDAoCC","sourcesContent":["import {\n    ApiImplementationError,\n    ClientRegistry,\n    HttpResponseDto,\n    WEBPIECES_DEFAULT_ERROR_TRANSLATOR,\n} from '@webpieces/core-util';\n\n/**\n * The CLIENT half of the wire seam: hand every response to THE registered\n * {@link ErrorTranslator}'s `fromWire`, and guarantee the one invariant a typed caller depends on.\n *\n * There is no \"was a translator registered\" question here — {@link ClientRegistry.getErrorTranslator}\n * is non-optional — and no `TranslatedFailure` provenance record either. Provenance existed only to\n * feed `ProxyClient.adaptDownstreamFailure`, and the uniform 4xx/5xx rule in\n * {@link WebpiecesDefaultErrorTranslator} deleted that hook: an app that wants a downstream status\n * relayed as its own type says so by THROWING it from its own `fromWire`.\n */\nexport class ClientErrorTranslator {\n    /**\n     * Run `fromWire` over a response, and make it impossible for a FAILURE response to be handed to a\n     * typed caller as if it were data.\n     *\n     * Every response goes through here, 2xx included, so an app whose 200 body signals failure can\n     * turn it into a throw (see {@link ErrorTranslator.fromWire}).\n     *\n     * The second call is BUG CONTAINMENT, not a fallback branch: an app translator that returns\n     * normally for a non-2xx has a bug whose symptom would otherwise be `undefined` arriving where\n     * the contract promised a DTO. The webpieces default answers instead — and for a genuine 2xx it\n     * returns silently, so the normal path costs one predicate.\n     */\n    // webpieces-disable no-function-outside-class -- pure stateless mapping shared by browser and node\n    static throwIfFailure(response: HttpResponseDto): void {\n        ClientRegistry.getErrorTranslator().fromWire(response);\n        WEBPIECES_DEFAULT_ERROR_TRANSLATOR.fromWire(response);\n    }\n\n    /**\n     * {@link throwIfFailure} for a response the CALLER has already established is not an ordinary\n     * success (not 2xx, or a 266). Typed `never`, which is what lets `ProxyClient.readResponse` end on\n     * this call instead of on a `return undefined` the contract forbids.\n     *\n     * The trailing throw is NOT dead code standing in for a type: it fires exactly when this is\n     * called with an ordinary 2xx, which is a framework bug in the caller, and says so.\n     */\n    // webpieces-disable no-function-outside-class -- pure stateless mapping shared by browser and node\n    static throwFailure(response: HttpResponseDto): never {\n        ClientErrorTranslator.throwIfFailure(response);\n        throw new ApiImplementationError(\n            `ClientErrorTranslator.throwFailure was called for HTTP ${response.status.code}, ` +\n                `which is an ordinary success. Only a non-2xx (or a 266) response reaches here; ` +\n                `use throwIfFailure for a response that may legitimately pass.`,\n        );\n    }\n}\n"]}

package/src/HttpResponseDtoFactory.d.ts

@@ -4,7 +4,7 @@ import { HttpResponseDto } from '@webpieces/core-util';
  * form an app is allowed to see.
  *
  * A fetch `Response` and an express `res` model a response completely differently, and an app's
- * `ErrorTranslators` is written ONCE and serves both. So neither is handed to the app: the server
+ * `ErrorTranslator` is written ONCE and serves both. So neither is handed to the app: the server
  * writes an {@link HttpResponseDto} out (`ExpressWrapper`), and this reads one in. One form, both
  * transports, both directions — which is what makes `fromWire` receive the identical shape whether
  * the caller was `http-client-node` or `http-client-browser` (both share `ProxyClient`, and this is

package/src/HttpResponseDtoFactory.js

@@ -7,7 +7,7 @@ const core_util_1 = require("@webpieces/core-util");
  * form an app is allowed to see.
  *
  * A fetch `Response` and an express `res` model a response completely differently, and an app's
- * `ErrorTranslators` is written ONCE and serves both. So neither is handed to the app: the server
+ * `ErrorTranslator` is written ONCE and serves both. So neither is handed to the app: the server
  * writes an {@link HttpResponseDto} out (`ExpressWrapper`), and this reads one in. One form, both
  * transports, both directions — which is what makes `fromWire` receive the identical shape whether
  * the caller was `http-client-node` or `http-client-browser` (both share `ProxyClient`, and this is

package/src/HttpResponseDtoFactory.js.map

@@ -1 +1 @@
-{"version":3,"file":"HttpResponseDtoFactory.js","sourceRoot":"","sources":["../../../../../packages/http/http-client-core/src/HttpResponseDtoFactory.ts"],"names":[],"mappings":";;;AAAA,oDAAuF;AAWvF;;;;;;;;;;;;GAYG;AACH,MAAa,sBAAsB;IAC/B;;;;;;;;;;;OAWG;IACH,qIAAqI;IAC9H,SAAS,CAAC,QAAkB,EAAE,IAAa;QAC9C,MAAM,OAAO,GAAiB,EAAE,CAAC;QACjC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAa,EAAE,IAAY,EAAE,EAAE;YACrD,IAAI,IAAI,CAAC,WAAW,EAAE,KAAK,YAAY,EAAE,CAAC;gBACtC,OAAO,CAAC,IAAI,CAAC,IAAI,sBAAU,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;YAC9C,CAAC;QACL,CAAC,CAAC,CAAC;QACH,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7C,OAAO,CAAC,IAAI,CAAC,IAAI,sBAAU,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC;QACvD,CAAC;QACD,OAAO,IAAI,2BAAe,CACtB,IAAI,8BAAkB,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,EAC5D,OAAO,EACP,IAAI,CACP,CAAC;IACN,CAAC;IAED;;;;OAIG;IACK,UAAU,CAAC,QAAkB;QACjC,6FAA6F;QAC7F,MAAM,OAAO,GAAG,QAAQ,CAAC,OAA2C,CAAC;QACrE,OAAO,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9D,CAAC;CACJ;AAzCD,wDAyCC","sourcesContent":["import { HttpHeader, HttpResponseDto, HttpResponseStatus } from '@webpieces/core-util';\n\n/**\n * fetch `Headers` as it exists on runtimes that expose repeated `Set-Cookie` values. `getSetCookie`\n * is OPTIONAL because older browsers and older node do not have it at all — its absence is a fact\n * about the runtime, not an error.\n */\ninterface SetCookieAwareHeaders {\n    getSetCookie?: () => string[];\n}\n\n/**\n * HttpResponseDtoFactory - webpieces' CLIENT-side boundary between a transport and the one response\n * form an app is allowed to see.\n *\n * A fetch `Response` and an express `res` model a response completely differently, and an app's\n * `ErrorTranslators` is written ONCE and serves both. So neither is handed to the app: the server\n * writes an {@link HttpResponseDto} out (`ExpressWrapper`), and this reads one in. One form, both\n * transports, both directions — which is what makes `fromWire` receive the identical shape whether\n * the caller was `http-client-node` or `http-client-browser` (both share `ProxyClient`, and this is\n * the only place either builds a DTO).\n *\n * Stateless; one instance per client is fine.\n */\nexport class HttpResponseDtoFactory {\n    /**\n     * fetch `Response` + the already-parsed body -> the DTO.\n     *\n     * Headers come out as a LIST, and `getSetCookie()` is consulted where the runtime has it: fetch's\n     * `Headers` JOINS repeated headers into one comma-separated string for every name EXCEPT\n     * `set-cookie`, which it hides from iteration entirely. A Map-shaped response type would have\n     * lost them either way; the list keeps each cookie its own entry, which is the whole reason\n     * {@link HttpResponseDto.headers} is a list.\n     *\n     * `statusText` is the reason phrase as the server sent it; an empty one (HTTP/2 does not carry\n     * reason phrases at all) stays empty rather than being invented here.\n     */\n    // webpieces-disable no-any-unknown -- the already-parsed body is app-owned data, carried through verbatim (see HttpResponseDto.body)\n    public fromFetch(response: Response, body: unknown): HttpResponseDto {\n        const headers: HttpHeader[] = [];\n        response.headers.forEach((value: string, name: string) => {\n            if (name.toLowerCase() !== 'set-cookie') {\n                headers.push(new HttpHeader(name, value));\n            }\n        });\n        for (const cookie of this.setCookies(response)) {\n            headers.push(new HttpHeader('set-cookie', cookie));\n        }\n        return new HttpResponseDto(\n            new HttpResponseStatus(response.status, response.statusText),\n            headers,\n            body,\n        );\n    }\n\n    /**\n     * Every `Set-Cookie` as its own value, or none where the runtime predates `getSetCookie()`\n     * (older browsers, older node). Absent is not an error — it only means this runtime never\n     * exposed repeated cookies to script in the first place.\n     */\n    private setCookies(response: Response): string[] {\n        // webpieces-disable no-any-unknown -- getSetCookie() is absent on older lib.dom/node Headers\n        const headers = response.headers as unknown as SetCookieAwareHeaders;\n        return headers.getSetCookie ? headers.getSetCookie() : [];\n    }\n}\n"]}
+{"version":3,"file":"HttpResponseDtoFactory.js","sourceRoot":"","sources":["../../../../../packages/http/http-client-core/src/HttpResponseDtoFactory.ts"],"names":[],"mappings":";;;AAAA,oDAAuF;AAWvF;;;;;;;;;;;;GAYG;AACH,MAAa,sBAAsB;IAC/B;;;;;;;;;;;OAWG;IACH,qIAAqI;IAC9H,SAAS,CAAC,QAAkB,EAAE,IAAa;QAC9C,MAAM,OAAO,GAAiB,EAAE,CAAC;QACjC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAa,EAAE,IAAY,EAAE,EAAE;YACrD,IAAI,IAAI,CAAC,WAAW,EAAE,KAAK,YAAY,EAAE,CAAC;gBACtC,OAAO,CAAC,IAAI,CAAC,IAAI,sBAAU,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;YAC9C,CAAC;QACL,CAAC,CAAC,CAAC;QACH,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7C,OAAO,CAAC,IAAI,CAAC,IAAI,sBAAU,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC;QACvD,CAAC;QACD,OAAO,IAAI,2BAAe,CACtB,IAAI,8BAAkB,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,EAC5D,OAAO,EACP,IAAI,CACP,CAAC;IACN,CAAC;IAED;;;;OAIG;IACK,UAAU,CAAC,QAAkB;QACjC,6FAA6F;QAC7F,MAAM,OAAO,GAAG,QAAQ,CAAC,OAA2C,CAAC;QACrE,OAAO,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9D,CAAC;CACJ;AAzCD,wDAyCC","sourcesContent":["import { HttpHeader, HttpResponseDto, HttpResponseStatus } from '@webpieces/core-util';\n\n/**\n * fetch `Headers` as it exists on runtimes that expose repeated `Set-Cookie` values. `getSetCookie`\n * is OPTIONAL because older browsers and older node do not have it at all — its absence is a fact\n * about the runtime, not an error.\n */\ninterface SetCookieAwareHeaders {\n    getSetCookie?: () => string[];\n}\n\n/**\n * HttpResponseDtoFactory - webpieces' CLIENT-side boundary between a transport and the one response\n * form an app is allowed to see.\n *\n * A fetch `Response` and an express `res` model a response completely differently, and an app's\n * `ErrorTranslator` is written ONCE and serves both. So neither is handed to the app: the server\n * writes an {@link HttpResponseDto} out (`ExpressWrapper`), and this reads one in. One form, both\n * transports, both directions — which is what makes `fromWire` receive the identical shape whether\n * the caller was `http-client-node` or `http-client-browser` (both share `ProxyClient`, and this is\n * the only place either builds a DTO).\n *\n * Stateless; one instance per client is fine.\n */\nexport class HttpResponseDtoFactory {\n    /**\n     * fetch `Response` + the already-parsed body -> the DTO.\n     *\n     * Headers come out as a LIST, and `getSetCookie()` is consulted where the runtime has it: fetch's\n     * `Headers` JOINS repeated headers into one comma-separated string for every name EXCEPT\n     * `set-cookie`, which it hides from iteration entirely. A Map-shaped response type would have\n     * lost them either way; the list keeps each cookie its own entry, which is the whole reason\n     * {@link HttpResponseDto.headers} is a list.\n     *\n     * `statusText` is the reason phrase as the server sent it; an empty one (HTTP/2 does not carry\n     * reason phrases at all) stays empty rather than being invented here.\n     */\n    // webpieces-disable no-any-unknown -- the already-parsed body is app-owned data, carried through verbatim (see HttpResponseDto.body)\n    public fromFetch(response: Response, body: unknown): HttpResponseDto {\n        const headers: HttpHeader[] = [];\n        response.headers.forEach((value: string, name: string) => {\n            if (name.toLowerCase() !== 'set-cookie') {\n                headers.push(new HttpHeader(name, value));\n            }\n        });\n        for (const cookie of this.setCookies(response)) {\n            headers.push(new HttpHeader('set-cookie', cookie));\n        }\n        return new HttpResponseDto(\n            new HttpResponseStatus(response.status, response.statusText),\n            headers,\n            body,\n        );\n    }\n\n    /**\n     * Every `Set-Cookie` as its own value, or none where the runtime predates `getSetCookie()`\n     * (older browsers, older node). Absent is not an error — it only means this runtime never\n     * exposed repeated cookies to script in the first place.\n     */\n    private setCookies(response: Response): string[] {\n        // webpieces-disable no-any-unknown -- getSetCookie() is absent on older lib.dom/node Headers\n        const headers = response.headers as unknown as SetCookieAwareHeaders;\n        return headers.getSetCookie ? headers.getSetCookie() : [];\n    }\n}\n"]}

package/src/ProxyClient.d.ts

@@ -3,7 +3,6 @@ import { ApiPrototype } from './ApiPrototype';
 import { ClientFilterDefinition } from './ClientFilter';
 import { ClientRequest } from './ClientRequest';
 import { RequestOutcome } from './RequestOutcome';
-import { TranslatedFailure } from './TranslatedFailure';
 import { ByteReadableStream } from './ByteStream';
 /**
  * ProxyClient - the HTTP call engine behind one API contract's client proxy.
@@ -47,7 +46,7 @@ export declare abstract class ProxyClient {
     private readonly networkRejectClassifier;
     private readonly bodyReader;
     /**
-     * fetch `Response` -> the transport-neutral {@link HttpResponseDto} an app's `ErrorTranslators`
+     * fetch `Response` -> the transport-neutral {@link HttpResponseDto} the registered `ErrorTranslator`
      * sees. Normalising HERE is what makes `fromWire` receive the identical shape in node and in the
      * browser: both environments share this class, and this is the only place either builds a DTO.
      */
@@ -103,32 +102,6 @@ export declare abstract class ProxyClient {
      * an OIDC token are all things a browser bundle must never contain.
      */
     protected clientFilters(): ClientFilterDefinition[];
-    /**
-     * Adapt a translated downstream failure into the error THIS environment's caller should see.
-     *
-     * THE INVARIANT, and the reason this hook exists at all:
-     *
-     *   A status received from a downstream dependency describes OUR request to it. It is never the
-     *   status we return to OUR caller. The server that answered 404 is correct; the server that
-     *   asked for a route that does not exist is broken, and must say so as a 500.
-     *
-     * That invariant reads differently in the two environments, which is exactly why the ISOMORPHIC
-     * {@link ClientErrorTranslator} cannot settle it:
-     * - BROWSER: the client IS the end user's agent, so the downstream IS the answer. Pass it through
-     *   unchanged.
-     * - NODE: server-to-server. A 4xx from a dependency is a caller-side defect (wrong path, wrong
-     *   base URL, an undeployed dependency, bad service credentials), so the caller owns it as a 500.
-     *
-     * ABSTRACT, not a defaulted pass-through, for the same reason
-     * {@link outboundContextHeaders} takes a required `destination`: a permissive default puts the
-     * wrong answer one keystroke away. A new environment subclass must SAY which of the two it is,
-     * and there are exactly two subclasses in the repo, so the compile error is the migration.
-     *
-     * @param failure - the translated error, its provenance (app-registered vs built-in), and the
-     *                  downstream status
-     * @param callId  - `ApiName.methodName`, so a rewritten message can still name the call
-     */
-    protected abstract adaptDownstreamFailure(failure: TranslatedFailure, callId: string): Error;
     /** Whether fetch can read the response while its streaming request body remains open. */
     protected abstract supportsConcurrentDuplexFetch(): boolean;
     /** Environment-owned full-duplex transport after the shared filter chain has prepared it. */

package/src/ProxyClient.js

@@ -63,7 +63,7 @@ class ProxyClient {
     // Same shape and same reason: stateless, so it is constructed here rather than injected.
     bodyReader = new ResponseBodyReader_1.ResponseBodyReader();
     /**
-     * fetch `Response` -> the transport-neutral {@link HttpResponseDto} an app's `ErrorTranslators`
+     * fetch `Response` -> the transport-neutral {@link HttpResponseDto} the registered `ErrorTranslator`
      * sees. Normalising HERE is what makes `fromWire` receive the identical shape in node and in the
      * browser: both environments share this class, and this is the only place either builds a DTO.
      */
@@ -451,11 +451,19 @@ class ProxyClient {
             if (!this.bodyReader.isJson(response)) {
                 throw new Error(this.bodyReader.describeForeignBody(response, callId, await response.text()));
             }
-            return response.json();
+            // webpieces-disable no-any-unknown -- a success body is the caller's own DTO, erased here
+            const body = await response.json();
+            // EVERY response passes the seam, 2xx included: an app whose 200 body signals failure
+            // turns it into a throw here. The webpieces default returns silently, so the success
+            // path is unchanged — and the body is parsed ONCE, because a fetch body reads once.
+            ClientErrorTranslator_1.ClientErrorTranslator.throwIfFailure(this.responseDtoFactory.fromFetch(response, body));
+            return body;
         }
         const protocolError = await this.bodyReader.readErrorBody(response, callId);
-        const translated = ClientErrorTranslator_1.ClientErrorTranslator.translateError(this.responseDtoFactory.fromFetch(response, protocolError));
-        throw this.adaptDownstreamFailure(translated, callId);
+        // The mirror of what the SERVER's `toWire` wrote. `fromWire` throws, so this method cannot
+        // return for a failure response — `throwIfFailure` puts the webpieces default behind an app
+        // translator that forgets to, so the guarantee does not depend on app code being correct.
+        ClientErrorTranslator_1.ClientErrorTranslator.throwFailure(this.responseDtoFactory.fromFetch(response, protocolError));
     }
     /** Preserve empty, JSON, and protocol text bodies for caller-owned full responses. */
     // webpieces-disable no-any-unknown -- a full response deliberately preserves the caller-owned body

package/src/ProxyClient.js.map

@@ -1 +1 @@
-{"version":3,"file":"ProxyClient.js","sourceRoot":"","sources":["../../../../../packages/http/http-client-core/src/ProxyClient.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n    isApiPath,\n    getEndpoints,\n    AuthMeta,\n    DestinationTrust,\n    RouteMetadata,\n    LogApiCallImpl,\n    ApiMethodInfo,\n    toError,\n    NetworkRejectClassifier,\n    HttpContractMapper,\n    RouteMetadataFactory,\n    FilterChain,\n    CallRegistry,\n    CallDeadline,\n    CallContext,\n    DtoValue,\n    RequestStream,\n    ResponseStream,\n    StreamTransportError,\n} from '@webpieces/core-util';\nimport { ApiPrototype } from './ApiPrototype';\nimport { ClientFilterDefinition } from './ClientFilter';\nimport { ClientRequest } from './ClientRequest';\nimport { ClientErrorTranslator } from './ClientErrorTranslator';\nimport { HttpResponseDtoFactory } from './HttpResponseDtoFactory';\nimport { RequestOutcome } from './RequestOutcome';\nimport { ResponseBodyReader } from './ResponseBodyReader';\nimport { TranslatedFailure } from './TranslatedFailure';\nimport { NdjsonRequestStream } from './NdjsonRequestStream';\nimport { SseResponseStream } from './SseResponseStream';\nimport { StreamingCapabilityError } from './StreamingCapabilityError';\nimport { ByteReadableStream } from './ByteStream';\n\nclass OpenedStreamingTransport {\n    constructor(\n        readonly response: Response,\n        readonly upload: NdjsonRequestStream,\n    ) {}\n}\n\n/**\n * ProxyClient - the HTTP call engine behind one API contract's client proxy.\n *\n * Contains ONLY what a browser can run: the route map built from the contract's decorators, URL\n * assembly, `fetch`, error translation, and logging. It holds no context object, no credentials,\n * and no recorder — it ASKS ITSELF for those through the hooks below, and each subclass answers\n * from its own environment.\n *\n * That is why the class is abstract rather than parameterized by a collaborator: a shared\n * header-provider seam would drag Node's AsyncLocalStorage vocabulary into a browser bundle and the\n * browser's store vocabulary into a server, and neither has any use for the other.\n *\n *   NodeProxyClient    (@webpieces/http-client-node)    -> RequestContext, Secrets, mintIdToken, recording\n *   BrowserProxyClient (@webpieces/http-client-browser) -> an app-held store, no credentials, no recording\n *\n * TWO-PHASE: collaborators arrive on the subclass constructor (so a DI container can supply them),\n * while the per-client state — which contract, which target — arrives on the subclass's `init`,\n * which calls {@link initRoutes}. That is what lets a factory hold a `Provider<ProxyClient>` and\n * hand out a fresh, independently-configured client per contract.\n */\nexport abstract class ProxyClient {\n    // Assigned by initRoutes(), which every subclass's init() calls immediately after construction.\n    private routeMap!: Map<string, RouteMetadata>;\n    private apiName!: string;\n    private apiClass!: ApiPrototype<object>;\n\n    /**\n     * The OUTBOUND filter chain, built once at bind time from {@link clientFilters} and reused for\n     * every call. Built once rather than per call because a filter is STATELESS by contract (the\n     * per-call state is the {@link ClientRequest} the chain is handed), exactly as on the server.\n     */\n    private chain!: FilterChain<ClientRequest, Response>;\n\n    /**\n     * The app's own filters, as handed to `createRpcClient`. Set by {@link initRoutes} BEFORE it\n     * calls {@link clientFilters}, so an environment's built-ins may read the app's intent off them\n     * — @webpieces/http-client-node takes the SSRF policy from an installed `ContextBaseUrlFilter` / `ContextFullUrlFilter`\n     * that way, which keeps the one legitimate relaxation at the same construction site as the\n     * decision to be re-pointable at all.\n     */\n    protected appFilters: ClientFilterDefinition[] = [];\n\n    // Stateless + dependency-free, so the browser bundle keeps no DI on the fetch path.\n    private readonly networkRejectClassifier = new NetworkRejectClassifier();\n\n    // Same shape and same reason: stateless, so it is constructed here rather than injected.\n    private readonly bodyReader = new ResponseBodyReader();\n\n    /**\n     * fetch `Response` -> the transport-neutral {@link HttpResponseDto} an app's `ErrorTranslators`\n     * sees. Normalising HERE is what makes `fromWire` receive the identical shape in node and in the\n     * browser: both environments share this class, and this is the only place either builds a DTO.\n     */\n    private readonly responseDtoFactory = new HttpResponseDtoFactory();\n\n    /**\n     * @param logApiCall - built by the SUBCLASS's package around that environment's ApiCallContext\n     *   (node: RequestContextApiCallContext; browser: BrowserApiCallContext). REQUIRED, with no\n     *   default: core-util cannot construct either one, and a default here would have to reach for a\n     *   process-global — which is exactly the throw-on-first-call this parameter deleted.\n     */\n    constructor(protected readonly logApiCall: LogApiCallImpl) {}\n\n    // ---------------------------------------------------------------- environment hooks\n\n    /** The callee's base URL. Async because a server may derive it from container metadata. */\n    protected abstract resolveBaseUrl(): Promise<string>;\n\n    /**\n     * Context headers to put on the wire. Server reads RequestContext; browser reads its store.\n     *\n     * `destination` is derived from THIS route's auth mode and decides whether TRUSTED context keys\n     * (`x-user-id`, `x-org-id`, `x-webpieces-roles`) may ride along — see {@link DestinationTrust}.\n     * It is a required argument on purpose: a defaulted \"send everything\" would put the permissive\n     * answer one keystroke away and make the safe one opt-in.\n     *\n     * RENAMED from `outboundHeaders()` in the same change that added `destination`, and the rename IS\n     * the migration. TypeScript accepts an override that declares FEWER parameters than its base, so a\n     * downstream `protected override outboundHeaders(): Map<string, string>` would have kept compiling\n     * and silently ignored the gate — the permissive behaviour surviving as a second spelling. Against\n     * the NEW name that subclass fails twice over: `override` names a member the base no longer has,\n     * and this abstract member is left unimplemented.\n     */\n    protected abstract outboundContextHeaders(destination: DestinationTrust): Map<string, string>;\n\n    /**\n     * Run the call. The default just logs it. Test-case RECORDING is a server concept, so\n     * NodeProxyClient overrides this to capture the call when a recorder is in the context.\n     *\n     * Context fields are NOT passed in: a logging backend stamps them onto every record itself.\n     */\n    // webpieces-disable no-any-unknown -- DTO types are erased at the proxy boundary\n    protected async execute(\n        route: RouteMetadata,\n        requestDto: unknown,\n        // webpieces-disable no-any-unknown -- DTO types are erased at the proxy boundary\n        method: () => Promise<unknown>,\n        // webpieces-disable no-any-unknown -- DTO types are erased at the proxy boundary\n    ): Promise<unknown> {\n        // apiClass = the CONTRACT name (this.apiName, e.g. 'SaveApi') so this client log line MATCHES\n        // the server's for the same call. A client has no impl class, so controllerName is omitted.\n        const info = new ApiMethodInfo(\n            'client',\n            this.apiName,\n            route.methodName,\n            undefined,\n            route.mask,\n        );\n        return this.logApiCall.execute(info, requestDto, method);\n    }\n\n    /**\n     * Reject, at bind time, an endpoint this environment cannot satisfy — e.g. a browser cannot\n     * mint the OIDC token an @WpAuthOidc endpoint demands. Surfacing it here beats failing on the\n     * first call in production. The default accepts everything.\n     */\n    protected assertEndpointSupported(_authMeta: AuthMeta | undefined, _methodName: string): void {}\n\n    /**\n     * The FRAMEWORK filters this environment installs on every client it builds, BENEATH whatever\n     * the app passed to `createRpcClient`. The default installs none, so the browser runs the exact\n     * code path it ran before the chain existed.\n     *\n     * \"Beneath\" is not a priority — see {@link initRoutes}. These are the filters that must judge\n     * and sign what is ACTUALLY about to be sent, so no app priority may be allowed to get under\n     * them: @webpieces/http-client-node installs its SSRF guard and its outbound-auth minter here,\n     * and both would be defeated by an app filter that re-pointed the URL below them. Neither\n     * concept can live in this class, because reading a RequestContext, resolving DNS and minting\n     * an OIDC token are all things a browser bundle must never contain.\n     */\n    protected clientFilters(): ClientFilterDefinition[] {\n        return [];\n    }\n\n    /**\n     * Adapt a translated downstream failure into the error THIS environment's caller should see.\n     *\n     * THE INVARIANT, and the reason this hook exists at all:\n     *\n     *   A status received from a downstream dependency describes OUR request to it. It is never the\n     *   status we return to OUR caller. The server that answered 404 is correct; the server that\n     *   asked for a route that does not exist is broken, and must say so as a 500.\n     *\n     * That invariant reads differently in the two environments, which is exactly why the ISOMORPHIC\n     * {@link ClientErrorTranslator} cannot settle it:\n     * - BROWSER: the client IS the end user's agent, so the downstream IS the answer. Pass it through\n     *   unchanged.\n     * - NODE: server-to-server. A 4xx from a dependency is a caller-side defect (wrong path, wrong\n     *   base URL, an undeployed dependency, bad service credentials), so the caller owns it as a 500.\n     *\n     * ABSTRACT, not a defaulted pass-through, for the same reason\n     * {@link outboundContextHeaders} takes a required `destination`: a permissive default puts the\n     * wrong answer one keystroke away. A new environment subclass must SAY which of the two it is,\n     * and there are exactly two subclasses in the repo, so the compile error is the migration.\n     *\n     * @param failure - the translated error, its provenance (app-registered vs built-in), and the\n     *                  downstream status\n     * @param callId  - `ApiName.methodName`, so a rewritten message can still name the call\n     */\n    protected abstract adaptDownstreamFailure(failure: TranslatedFailure, callId: string): Error;\n\n    /** Whether fetch can read the response while its streaming request body remains open. */\n    protected abstract supportsConcurrentDuplexFetch(): boolean;\n\n    /** Environment-owned full-duplex transport after the shared filter chain has prepared it. */\n    protected abstract sendStreamingTransport(\n        request: ClientRequest,\n        signal: AbortSignal,\n        body: ByteReadableStream,\n    ): Promise<Response>;\n\n    /**\n     * Fires before the logical call's attempts, once per RPC — the progress \"start marker\". Symmetric with\n     * {@link onRequestEnd}: every start is followed by exactly one end, on every path, so a listener\n     * can drive a counter (bar on / bar off) without leaking a permanently-spinning bar.\n     *\n     * The default is a no-op, so every existing subclass is unaffected.\n     */\n    protected onRequestStart(_route: RouteMetadata): void {}\n\n    /**\n     * Fires exactly ONCE after the call settles, on EVERY path (2xx, HTTP error, network reject) —\n     * the \"stop marker\", carrying how it settled.\n     *\n     * Subsumes the older header-only hook: this is the ONLY place the `fetch` Response — and thus its\n     * `Headers` — exists, so an app that needs to read a response header (e.g. a server-version stamp\n     * for client↔server version matching) reads `outcome.headers` after settlement\n     * and on both the ok and error paths. `outcome.ok`/`outcome.error` add the success-or-error\n     * signal the header-only seam could not give.\n     *\n     * The default is a no-op, so every existing subclass is unaffected.\n     */\n    protected onRequestEnd(_route: RouteMetadata, _outcome: RequestOutcome): void {}\n\n    // ---------------------------------------------------------------- contract binding\n\n    /**\n     * Bind this client to one API contract: read @ApiPath/@Endpoint/@Auth* off the prototype and\n     * build the route map once. Each subclass's `init(api, config)` stores its own config, then\n     * calls this.\n     *\n     * @param appFilters the app's OUTBOUND filters for this client, from `createRpcClient`. They are\n     *        merged with {@link clientFilters} and sorted by priority, highest OUTERMOST.\n     * @throws Error if the prototype lacks @ApiPath, or declares an endpoint this environment\n     *         cannot satisfy (see {@link assertEndpointSupported}).\n     */\n    protected initRoutes(\n        apiPrototype: ApiPrototype<object>,\n        appFilters: ClientFilterDefinition[],\n    ): void {\n        this.appFilters = appFilters;\n        this.apiClass = apiPrototype;\n        if (!isApiPath(apiPrototype)) {\n            const className = apiPrototype.name || 'Unknown';\n            throw new Error(`Class ${className} must be decorated with @ApiPath()`);\n        }\n\n        const endpoints = getEndpoints(apiPrototype) || {};\n\n        // apiName as the class name so client logs read \"SaveApi.save\", not \"undefined.save\"\n        this.apiName = apiPrototype.name || 'UnknownApi';\n\n        // Two endpoints on one method + path would dial the same URL; refuse the contract up front.\n        RouteMetadataFactory.assertNoDuplicateRoutes(apiPrototype);\n\n        this.routeMap = new Map<string, RouteMetadata>();\n        for (const methodName of Object.keys(endpoints)) {\n            // One shared factory joins and validates method/path/query/body metadata for every\n            // transport, rather than letting each generated client reinterpret the decorators.\n            const route = RouteMetadataFactory.create(apiPrototype, methodName);\n            const authMeta = route.authMeta;\n            this.assertEndpointSupported(authMeta, methodName);\n            this.routeMap.set(methodName, route);\n        }\n\n        // APP filters first (highest priority OUTERMOST, matching the server's FilterMatcher), then\n        // the framework built-ins, ALWAYS innermost. Two separate sorts rather than one over the\n        // union, deliberately: an app priority orders app filters against each other and nothing\n        // else, so no number an app can type — however large — gets underneath the SSRF guard or the\n        // credential minter. A single sorted list would make \"displace the guard\" a matter of typing\n        // a bigger integer, and a security control an app can outrank by accident is not a control.\n        //\n        // Sorted here, once, so FilterChain itself never sorts — priority lives on the DEFINITION,\n        // not on the filter.\n        const byPriority = (a: ClientFilterDefinition, b: ClientFilterDefinition): number =>\n            b.priority - a.priority;\n        const ordered = [\n            ...[...this.appFilters].sort(byPriority),\n            ...[...this.clientFilters()].sort(byPriority),\n        ];\n        this.chain = new FilterChain<ClientRequest, Response>(\n            ordered.map((definition: ClientFilterDefinition) => definition.filter),\n        );\n    }\n\n    /** The contract's class name, for logs and recordings. */\n    protected contractName(): string {\n        return this.apiName;\n    }\n\n    /** Check if a route exists for the given method name. */\n    hasRoute(methodName: string): boolean {\n        return this.routeMap.has(methodName);\n    }\n\n    /**\n     * Get route metadata for a method name.\n     * @throws Error if no route found\n     */\n    getRoute(methodName: string): RouteMetadata {\n        const route = this.routeMap.get(methodName);\n        if (!route) {\n            throw new Error(`No route found for method ${methodName}`);\n        }\n        return route;\n    }\n\n    // ---------------------------------------------------------------- the call\n\n    /**\n     * FAIL FAST, PER METHOD, at call time: some endpoints exist for a caller that is not us, and this\n     * proxy could only ever build a request they are obliged to reject. Refusing here rather than at\n     * bind time means an api that MIXES such endpoints with normal ones still yields a working client\n     * for the normal ones; only calling the un-callable method throws.\n     *\n     * @throws Error naming the endpoint, what it declared, and who its real caller is.\n     */\n    private refuseEndpointNoClientCanCall(route: RouteMetadata): void {\n        const authMode = route.authMeta?.mode;\n        // @WpAuthApiKey: the credential is a CUSTOMER-held key, and the header carrying it is the app's\n        // ApiKeyHook's choice, so this client has nothing to send and the call is a guaranteed 401.\n        if (authMode?.kind === 'apikey') {\n            throw new Error(\n                `${this.apiName}.${route.methodName} is @WpAuthApiKey('${authMode.regime}') — only the partner ` +\n                    `holding that api key can call it, and the header carrying it is the app's ApiKeyHook's choice, ` +\n                    `so a webpieces client has no credential to send.`,\n            );\n        }\n        // @WpAuthWebhook is DELIBERATELY absent from this list. It used to be here, on the assumption\n        // that the vendor is always somebody else — but `@WpAuthWebhook(name)` names a signing SCHEME,\n        // not a direction, and for an OUTBOUND partner webhook WE are the vendor. The environment's\n        // outbound-auth filter asks its bound signer to produce the signature, which is the exact\n        // mirror of the inbound WebhookAuthCallback that verifies one.\n    }\n\n    /** One logical call: one lifecycle pair and log entry across all strategy attempts. */\n    // webpieces-disable no-any-unknown -- request and response DTOs are erased at the proxy boundary\n    async makeRequest(route: RouteMetadata, args: unknown[]): Promise<unknown> {\n        this.refuseEndpointNoClientCanCall(route);\n        if (route.streaming) return this.makeStreamingRequest(route, args);\n        const mapped = HttpContractMapper.toWire(\n            route.path,\n            route.parameterBindings,\n            route.bodyParameterIndex,\n            args,\n        );\n        const logValue = mapped.body === undefined ? args : mapped.body;\n        return this.execute(route, logValue, () => this.executeCall(route, args));\n    }\n\n    /** Open a typed stream without bypassing the ordinary context/auth/filter request pipeline. */\n    // webpieces-disable no-any-unknown -- generated proxy arguments are runtime-validated here\n    private async makeStreamingRequest(route: RouteMetadata, args: unknown[]): Promise<unknown> {\n        if (!this.supportsConcurrentDuplexFetch()) {\n            throw new StreamingCapabilityError(\n                'browser',\n                'Fetch request streaming is half-duplex and has no protocol-compatible full-duplex fallback.',\n            );\n        }\n        const destination = this.responseStream(args);\n        return this.execute(route, 'stream-open', () =>\n            this.executeStreamingCall(route, destination),\n        );\n    }\n\n    // webpieces-disable no-any-unknown -- generated proxy arguments are runtime-validated here\n    private responseStream(args: unknown[]): ResponseStream<DtoValue> {\n        const candidate = args[0];\n        if (args.length !== 1 || typeof candidate !== 'object' || candidate === null) {\n            throw new StreamTransportError(\n                `${this.apiName} streaming methods require exactly one ResponseStream argument.`,\n            );\n        }\n        // webpieces-disable no-any-unknown -- reflected method argument is narrowed by the method checks below\n        const record = candidate as Record<string, unknown>;\n        if (\n            typeof record['event'] !== 'function' ||\n            typeof record['fail'] !== 'function' ||\n            typeof record['complete'] !== 'function' ||\n            typeof record['onCancel'] !== 'function'\n        ) {\n            throw new StreamTransportError(\n                `${this.apiName} streaming method argument does not implement ResponseStream.`,\n            );\n        }\n        return candidate as ResponseStream<DtoValue>;\n    }\n\n    /** One streaming handshake. Subsequent events stay on this established transport. */\n    private async executeStreamingCall(\n        route: RouteMetadata,\n        destination: ResponseStream<DtoValue>,\n    ): Promise<RequestStream<DtoValue>> {\n        this.onRequestStart(route);\n        let response: Response | undefined;\n        // eslint-disable-next-line @webpieces/no-unmanaged-exceptions -- lifecycle reports the original handshake failure\n        try {\n            const requestStream = await CallRegistry.execute(\n                this.apiClass,\n                route.methodName,\n                (timeoutMs: number) =>\n                    CallDeadline.run(\n                        timeoutMs,\n                        new CallContext(this.apiName, route.methodName),\n                        async (deadlineSignal: AbortSignal) => {\n                            const result = await this.openStreamingTransport(\n                                route,\n                                destination,\n                                deadlineSignal,\n                            );\n                            response = result.response;\n                            return result.upload;\n                        },\n                    ),\n                30_000,\n            );\n            this.onRequestEnd(\n                route,\n                new RequestOutcome(true, response?.status ?? 0, response?.headers),\n            );\n            return requestStream;\n        } catch (err: unknown) {\n            const error = toError(err);\n            this.onRequestEnd(\n                route,\n                new RequestOutcome(false, response?.status ?? 0, response?.headers, error),\n            );\n            throw err;\n        }\n    }\n\n    private async openStreamingTransport(\n        route: RouteMetadata,\n        destination: ResponseStream<DtoValue>,\n        deadlineSignal: AbortSignal,\n    ): Promise<OpenedStreamingTransport> {\n        const metadata = route.streaming;\n        if (!metadata) throw new StreamTransportError('Streaming metadata disappeared.');\n        const request = await this.prepareStreamingRequest(route);\n        const controller = new AbortController();\n        deadlineSignal.addEventListener('abort', (): void => controller.abort(), { once: true });\n        const upload = new NdjsonRequestStream(\n            metadata,\n            // webpieces-disable no-any-unknown -- AbortController accepts a platform-defined cancellation reason\n            (reason?: unknown) => controller.abort(reason),\n        );\n        const response = await this.chain.execute(request, () =>\n            this.sendStreamingOnce(request, controller.signal, upload.body),\n        );\n        if (!response.ok) {\n            await upload.transportFailed(\n                new StreamTransportError(\n                    `Streaming handshake failed with HTTP ${response.status}.`,\n                ),\n            );\n            await this.readResponse(response, route);\n            throw new StreamTransportError('Streaming handshake was rejected.');\n        }\n        const contentType = response.headers.get('content-type') ?? '';\n        if (!contentType.toLowerCase().startsWith('text/event-stream')) {\n            const error = new StreamTransportError(\n                `Streaming response requires text/event-stream, received '${contentType || 'missing'}'.`,\n            );\n            await upload.transportFailed(error);\n            throw error;\n        }\n        void new SseResponseStream()\n            .consume(response, destination, metadata, upload)\n            .catch(() => undefined);\n        return new OpenedStreamingTransport(response, upload);\n    }\n\n    /** Fresh filter-visible request metadata; the live request body is transport-owned. */\n    private async prepareStreamingRequest(route: RouteMetadata): Promise<ClientRequest> {\n        const baseUrl = await this.resolveBaseUrl();\n        const headers = new Map<string, string>();\n        headers.set('Content-Type', 'application/x-ndjson');\n        headers.set('Accept', 'text/event-stream');\n        const context = this.outboundContextHeaders(\n            DestinationTrust.forAuthMode(route.authMeta?.mode),\n        );\n        for (const entry of context.entries()) headers.set(entry[0], entry[1]);\n        return new ClientRequest(route, this.apiName, baseUrl, headers, undefined, undefined);\n    }\n\n    // webpieces-disable no-any-unknown -- response DTO is erased at the proxy boundary\n    private async executeCall(route: RouteMetadata, args: unknown[]): Promise<unknown> {\n        this.onRequestStart(route);\n        let response: Response | undefined;\n        // webpieces-disable no-any-unknown -- response DTO is erased at the proxy boundary\n        let result: unknown;\n        // webpieces-disable no-unmanaged-exceptions -- report one logical END, preserving the original thrown value\n        // eslint-disable-next-line @webpieces/no-unmanaged-exceptions\n        try {\n            result = await CallRegistry.execute(\n                this.apiClass,\n                route.methodName,\n                (timeoutMs: number) => {\n                    response = undefined;\n                    return CallDeadline.run(\n                        timeoutMs,\n                        new CallContext(this.apiName, route.methodName),\n                        async (signal: AbortSignal) => {\n                            const request = await this.prepareRequest(route, args);\n                            CallDeadline.throwIfAborted(signal);\n                            const received = await this.chain.execute(request, () =>\n                                this.sendOnce(request, signal),\n                            );\n                            CallDeadline.throwIfAborted(signal);\n                            response = received;\n                            return this.readResponse(received, route);\n                        },\n                    );\n                },\n                30_000,\n            );\n        } catch (err: unknown) {\n            const error = toError(err);\n            this.onRequestEnd(\n                route,\n                new RequestOutcome(false, response?.status ?? 0, response?.headers, error),\n            );\n            throw err;\n        }\n        this.onRequestEnd(\n            route,\n            new RequestOutcome(true, response?.status ?? 0, response?.headers),\n        );\n        return result;\n    }\n\n    /** Fresh mutable request for every attempt, including URL, headers, auth and body. */\n    // webpieces-disable no-any-unknown -- request DTO is erased at the proxy boundary\n    private async prepareRequest(route: RouteMetadata, args: unknown[]): Promise<ClientRequest> {\n        const baseUrl = await this.resolveBaseUrl();\n        const mapped = HttpContractMapper.toWire(\n            route.path,\n            route.parameterBindings,\n            route.bodyParameterIndex,\n            args,\n        );\n        const headers = new Map<string, string>();\n        const body = this.serializeBody(route, mapped.body, headers);\n        const context = this.outboundContextHeaders(\n            DestinationTrust.forAuthMode(route.authMeta?.mode),\n        );\n        for (const entry of context.entries()) headers.set(entry[0], entry[1]);\n        return new ClientRequest(\n            route,\n            this.apiName,\n            baseUrl,\n            headers,\n            body,\n            mapped.body,\n            mapped.path,\n        );\n    }\n\n    /** Serialize exactly the encoding the endpoint declared; GET is always bodyless. */\n    // webpieces-disable no-any-unknown -- request DTO type is erased at the generated proxy boundary\n    private serializeBody(\n        route: RouteMetadata,\n        requestDto: unknown,\n        headers: Map<string, string>,\n    ): string | undefined {\n        if (route.httpMethod === 'GET' || requestDto === undefined) return undefined;\n        if (route.formPost) {\n            headers.set('Content-Type', 'application/x-www-form-urlencoded');\n            return this.serializeForm(requestDto, route);\n        }\n        headers.set('Content-Type', 'application/json');\n        return JSON.stringify(requestDto);\n    }\n\n    /** Flat form DTO -> deterministic urlencoded bytes, repeating array-valued fields. */\n    // webpieces-disable no-any-unknown -- form DTO fields are contract-owned and heterogeneous\n    private serializeForm(requestDto: unknown, route: RouteMetadata): string {\n        if (requestDto === null || typeof requestDto !== 'object' || Array.isArray(requestDto)) {\n            throw new Error(\n                `${this.apiName}.${route.methodName} declares formPost:true, so its body must be a flat object.`,\n            );\n        }\n        const params = new URLSearchParams();\n        // webpieces-disable no-any-unknown -- checked object is narrowed to its contract-owned field bag\n        for (const key of Object.keys(requestDto as Record<string, unknown>).sort()) {\n            // webpieces-disable no-any-unknown -- checked object is narrowed to its contract-owned field bag\n            const value = (requestDto as Record<string, unknown>)[key];\n            if (value === undefined || value === null) continue;\n            const values = Array.isArray(value) ? value : [value];\n            for (const item of values) {\n                if (item !== undefined && item !== null) params.append(key, String(item));\n            }\n        }\n        return params.toString();\n    }\n\n    /**\n     * ONE transmission — the bottom of the filter chain, and the only place `fetch` is called.\n     *\n     * Everything it sends comes off the {@link ClientRequest} as the chain left it, so a filter's\n     * edits to the url, the headers or the serialized body are exactly what goes on the wire. It may\n     * run more than once for a single RPC when a filter follows a redirect.\n     *\n     * A network reject (offline, DNS, CORS preflight) is classified into a typed ApiConnectionError here (a\n     * genuine bug passes through untouched) so that filters above see the same typed error the caller\n     * will, rather than a raw platform reject.\n     */\n    private async sendOnce(request: ClientRequest, signal: AbortSignal): Promise<Response> {\n        CallDeadline.throwIfAborted(signal);\n        const options: RequestInit = {\n            method: request.route.httpMethod,\n            signal,\n            headers: request.headersAsRecord(),\n            redirect:\n                request.route.responseType === 'full' || !request.followRedirects\n                    ? 'manual'\n                    : 'follow',\n        };\n        if (request.body !== undefined) {\n            options.body = request.body;\n        }\n        // webpieces-disable no-unmanaged-exceptions -- classify a network reject, then rethrow it typed\n        // eslint-disable-next-line @webpieces/no-unmanaged-exceptions\n        try {\n            // webpieces-disable no-fetch -- this IS the generated-client implementation the rule points everyone to\n            return await fetch(request.url, options);\n        } catch (err: unknown) {\n            const error = toError(err);\n            throw this.networkRejectClassifier.toNetworkError(error, request.url);\n        }\n    }\n\n    /** Node fetch's streaming upload option. Browser callers are refused before reaching here. */\n    private async sendStreamingOnce(\n        request: ClientRequest,\n        signal: AbortSignal,\n        body: ByteReadableStream,\n    ): Promise<Response> {\n        CallDeadline.throwIfAborted(signal);\n        // eslint-disable-next-line @webpieces/no-unmanaged-exceptions -- platform rejects are normalized below\n        try {\n            return await this.sendStreamingTransport(request, signal, body);\n        } catch (err: unknown) {\n            const error = toError(err);\n            throw this.networkRejectClassifier.toNetworkError(error, request.url);\n        }\n    }\n\n    /** Body consumption is inside the attempt deadline, including non-JSON error bodies. */\n    // webpieces-disable no-any-unknown -- response DTO is erased at the proxy boundary\n    private async readResponse(response: Response, route: RouteMetadata): Promise<unknown> {\n        const callId = `${this.apiName}.${route.methodName}`;\n        if (route.responseType === 'full') {\n            return this.responseDtoFactory.fromFetch(\n                response,\n                await this.readFullResponseBody(response),\n            );\n        }\n        // 266 is protocol success, but its body represents an expected user exception.\n        if (response.ok && response.status !== 266) {\n            if (!this.bodyReader.isJson(response)) {\n                throw new Error(\n                    this.bodyReader.describeForeignBody(response, callId, await response.text()),\n                );\n            }\n            return response.json();\n        }\n        const protocolError = await this.bodyReader.readErrorBody(response, callId);\n        const translated = ClientErrorTranslator.translateError(\n            this.responseDtoFactory.fromFetch(response, protocolError),\n        );\n        throw this.adaptDownstreamFailure(translated, callId);\n    }\n\n    /** Preserve empty, JSON, and protocol text bodies for caller-owned full responses. */\n    // webpieces-disable no-any-unknown -- a full response deliberately preserves the caller-owned body\n    private async readFullResponseBody(response: Response): Promise<unknown> {\n        if (response.status === 204 || response.status === 304) return undefined;\n        const text = await response.text();\n        if (text === '') return undefined;\n        if (!this.bodyReader.isJson(response)) return text;\n        // webpieces-disable no-any-unknown -- parsed JSON is returned untouched to the typed contract caller\n        return JSON.parse(text) as unknown;\n    }\n}\n"]}
+{"version":3,"file":"ProxyClient.js","sourceRoot":"","sources":["../../../../../packages/http/http-client-core/src/ProxyClient.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n    isApiPath,\n    getEndpoints,\n    AuthMeta,\n    DestinationTrust,\n    RouteMetadata,\n    LogApiCallImpl,\n    ApiMethodInfo,\n    toError,\n    NetworkRejectClassifier,\n    HttpContractMapper,\n    RouteMetadataFactory,\n    FilterChain,\n    CallRegistry,\n    CallDeadline,\n    CallContext,\n    DtoValue,\n    RequestStream,\n    ResponseStream,\n    StreamTransportError,\n} from '@webpieces/core-util';\nimport { ApiPrototype } from './ApiPrototype';\nimport { ClientFilterDefinition } from './ClientFilter';\nimport { ClientRequest } from './ClientRequest';\nimport { ClientErrorTranslator } from './ClientErrorTranslator';\nimport { HttpResponseDtoFactory } from './HttpResponseDtoFactory';\nimport { RequestOutcome } from './RequestOutcome';\nimport { ResponseBodyReader } from './ResponseBodyReader';\nimport { NdjsonRequestStream } from './NdjsonRequestStream';\nimport { SseResponseStream } from './SseResponseStream';\nimport { StreamingCapabilityError } from './StreamingCapabilityError';\nimport { ByteReadableStream } from './ByteStream';\n\nclass OpenedStreamingTransport {\n    constructor(\n        readonly response: Response,\n        readonly upload: NdjsonRequestStream,\n    ) {}\n}\n\n/**\n * ProxyClient - the HTTP call engine behind one API contract's client proxy.\n *\n * Contains ONLY what a browser can run: the route map built from the contract's decorators, URL\n * assembly, `fetch`, error translation, and logging. It holds no context object, no credentials,\n * and no recorder — it ASKS ITSELF for those through the hooks below, and each subclass answers\n * from its own environment.\n *\n * That is why the class is abstract rather than parameterized by a collaborator: a shared\n * header-provider seam would drag Node's AsyncLocalStorage vocabulary into a browser bundle and the\n * browser's store vocabulary into a server, and neither has any use for the other.\n *\n *   NodeProxyClient    (@webpieces/http-client-node)    -> RequestContext, Secrets, mintIdToken, recording\n *   BrowserProxyClient (@webpieces/http-client-browser) -> an app-held store, no credentials, no recording\n *\n * TWO-PHASE: collaborators arrive on the subclass constructor (so a DI container can supply them),\n * while the per-client state — which contract, which target — arrives on the subclass's `init`,\n * which calls {@link initRoutes}. That is what lets a factory hold a `Provider<ProxyClient>` and\n * hand out a fresh, independently-configured client per contract.\n */\nexport abstract class ProxyClient {\n    // Assigned by initRoutes(), which every subclass's init() calls immediately after construction.\n    private routeMap!: Map<string, RouteMetadata>;\n    private apiName!: string;\n    private apiClass!: ApiPrototype<object>;\n\n    /**\n     * The OUTBOUND filter chain, built once at bind time from {@link clientFilters} and reused for\n     * every call. Built once rather than per call because a filter is STATELESS by contract (the\n     * per-call state is the {@link ClientRequest} the chain is handed), exactly as on the server.\n     */\n    private chain!: FilterChain<ClientRequest, Response>;\n\n    /**\n     * The app's own filters, as handed to `createRpcClient`. Set by {@link initRoutes} BEFORE it\n     * calls {@link clientFilters}, so an environment's built-ins may read the app's intent off them\n     * — @webpieces/http-client-node takes the SSRF policy from an installed `ContextBaseUrlFilter` / `ContextFullUrlFilter`\n     * that way, which keeps the one legitimate relaxation at the same construction site as the\n     * decision to be re-pointable at all.\n     */\n    protected appFilters: ClientFilterDefinition[] = [];\n\n    // Stateless + dependency-free, so the browser bundle keeps no DI on the fetch path.\n    private readonly networkRejectClassifier = new NetworkRejectClassifier();\n\n    // Same shape and same reason: stateless, so it is constructed here rather than injected.\n    private readonly bodyReader = new ResponseBodyReader();\n\n    /**\n     * fetch `Response` -> the transport-neutral {@link HttpResponseDto} the registered `ErrorTranslator`\n     * sees. Normalising HERE is what makes `fromWire` receive the identical shape in node and in the\n     * browser: both environments share this class, and this is the only place either builds a DTO.\n     */\n    private readonly responseDtoFactory = new HttpResponseDtoFactory();\n\n    /**\n     * @param logApiCall - built by the SUBCLASS's package around that environment's ApiCallContext\n     *   (node: RequestContextApiCallContext; browser: BrowserApiCallContext). REQUIRED, with no\n     *   default: core-util cannot construct either one, and a default here would have to reach for a\n     *   process-global — which is exactly the throw-on-first-call this parameter deleted.\n     */\n    constructor(protected readonly logApiCall: LogApiCallImpl) {}\n\n    // ---------------------------------------------------------------- environment hooks\n\n    /** The callee's base URL. Async because a server may derive it from container metadata. */\n    protected abstract resolveBaseUrl(): Promise<string>;\n\n    /**\n     * Context headers to put on the wire. Server reads RequestContext; browser reads its store.\n     *\n     * `destination` is derived from THIS route's auth mode and decides whether TRUSTED context keys\n     * (`x-user-id`, `x-org-id`, `x-webpieces-roles`) may ride along — see {@link DestinationTrust}.\n     * It is a required argument on purpose: a defaulted \"send everything\" would put the permissive\n     * answer one keystroke away and make the safe one opt-in.\n     *\n     * RENAMED from `outboundHeaders()` in the same change that added `destination`, and the rename IS\n     * the migration. TypeScript accepts an override that declares FEWER parameters than its base, so a\n     * downstream `protected override outboundHeaders(): Map<string, string>` would have kept compiling\n     * and silently ignored the gate — the permissive behaviour surviving as a second spelling. Against\n     * the NEW name that subclass fails twice over: `override` names a member the base no longer has,\n     * and this abstract member is left unimplemented.\n     */\n    protected abstract outboundContextHeaders(destination: DestinationTrust): Map<string, string>;\n\n    /**\n     * Run the call. The default just logs it. Test-case RECORDING is a server concept, so\n     * NodeProxyClient overrides this to capture the call when a recorder is in the context.\n     *\n     * Context fields are NOT passed in: a logging backend stamps them onto every record itself.\n     */\n    // webpieces-disable no-any-unknown -- DTO types are erased at the proxy boundary\n    protected async execute(\n        route: RouteMetadata,\n        requestDto: unknown,\n        // webpieces-disable no-any-unknown -- DTO types are erased at the proxy boundary\n        method: () => Promise<unknown>,\n        // webpieces-disable no-any-unknown -- DTO types are erased at the proxy boundary\n    ): Promise<unknown> {\n        // apiClass = the CONTRACT name (this.apiName, e.g. 'SaveApi') so this client log line MATCHES\n        // the server's for the same call. A client has no impl class, so controllerName is omitted.\n        const info = new ApiMethodInfo(\n            'client',\n            this.apiName,\n            route.methodName,\n            undefined,\n            route.mask,\n        );\n        return this.logApiCall.execute(info, requestDto, method);\n    }\n\n    /**\n     * Reject, at bind time, an endpoint this environment cannot satisfy — e.g. a browser cannot\n     * mint the OIDC token an @WpAuthOidc endpoint demands. Surfacing it here beats failing on the\n     * first call in production. The default accepts everything.\n     */\n    protected assertEndpointSupported(_authMeta: AuthMeta | undefined, _methodName: string): void {}\n\n    /**\n     * The FRAMEWORK filters this environment installs on every client it builds, BENEATH whatever\n     * the app passed to `createRpcClient`. The default installs none, so the browser runs the exact\n     * code path it ran before the chain existed.\n     *\n     * \"Beneath\" is not a priority — see {@link initRoutes}. These are the filters that must judge\n     * and sign what is ACTUALLY about to be sent, so no app priority may be allowed to get under\n     * them: @webpieces/http-client-node installs its SSRF guard and its outbound-auth minter here,\n     * and both would be defeated by an app filter that re-pointed the URL below them. Neither\n     * concept can live in this class, because reading a RequestContext, resolving DNS and minting\n     * an OIDC token are all things a browser bundle must never contain.\n     */\n    protected clientFilters(): ClientFilterDefinition[] {\n        return [];\n    }\n\n    /** Whether fetch can read the response while its streaming request body remains open. */\n    protected abstract supportsConcurrentDuplexFetch(): boolean;\n\n    /** Environment-owned full-duplex transport after the shared filter chain has prepared it. */\n    protected abstract sendStreamingTransport(\n        request: ClientRequest,\n        signal: AbortSignal,\n        body: ByteReadableStream,\n    ): Promise<Response>;\n\n    /**\n     * Fires before the logical call's attempts, once per RPC — the progress \"start marker\". Symmetric with\n     * {@link onRequestEnd}: every start is followed by exactly one end, on every path, so a listener\n     * can drive a counter (bar on / bar off) without leaking a permanently-spinning bar.\n     *\n     * The default is a no-op, so every existing subclass is unaffected.\n     */\n    protected onRequestStart(_route: RouteMetadata): void {}\n\n    /**\n     * Fires exactly ONCE after the call settles, on EVERY path (2xx, HTTP error, network reject) —\n     * the \"stop marker\", carrying how it settled.\n     *\n     * Subsumes the older header-only hook: this is the ONLY place the `fetch` Response — and thus its\n     * `Headers` — exists, so an app that needs to read a response header (e.g. a server-version stamp\n     * for client↔server version matching) reads `outcome.headers` after settlement\n     * and on both the ok and error paths. `outcome.ok`/`outcome.error` add the success-or-error\n     * signal the header-only seam could not give.\n     *\n     * The default is a no-op, so every existing subclass is unaffected.\n     */\n    protected onRequestEnd(_route: RouteMetadata, _outcome: RequestOutcome): void {}\n\n    // ---------------------------------------------------------------- contract binding\n\n    /**\n     * Bind this client to one API contract: read @ApiPath/@Endpoint/@Auth* off the prototype and\n     * build the route map once. Each subclass's `init(api, config)` stores its own config, then\n     * calls this.\n     *\n     * @param appFilters the app's OUTBOUND filters for this client, from `createRpcClient`. They are\n     *        merged with {@link clientFilters} and sorted by priority, highest OUTERMOST.\n     * @throws Error if the prototype lacks @ApiPath, or declares an endpoint this environment\n     *         cannot satisfy (see {@link assertEndpointSupported}).\n     */\n    protected initRoutes(\n        apiPrototype: ApiPrototype<object>,\n        appFilters: ClientFilterDefinition[],\n    ): void {\n        this.appFilters = appFilters;\n        this.apiClass = apiPrototype;\n        if (!isApiPath(apiPrototype)) {\n            const className = apiPrototype.name || 'Unknown';\n            throw new Error(`Class ${className} must be decorated with @ApiPath()`);\n        }\n\n        const endpoints = getEndpoints(apiPrototype) || {};\n\n        // apiName as the class name so client logs read \"SaveApi.save\", not \"undefined.save\"\n        this.apiName = apiPrototype.name || 'UnknownApi';\n\n        // Two endpoints on one method + path would dial the same URL; refuse the contract up front.\n        RouteMetadataFactory.assertNoDuplicateRoutes(apiPrototype);\n\n        this.routeMap = new Map<string, RouteMetadata>();\n        for (const methodName of Object.keys(endpoints)) {\n            // One shared factory joins and validates method/path/query/body metadata for every\n            // transport, rather than letting each generated client reinterpret the decorators.\n            const route = RouteMetadataFactory.create(apiPrototype, methodName);\n            const authMeta = route.authMeta;\n            this.assertEndpointSupported(authMeta, methodName);\n            this.routeMap.set(methodName, route);\n        }\n\n        // APP filters first (highest priority OUTERMOST, matching the server's FilterMatcher), then\n        // the framework built-ins, ALWAYS innermost. Two separate sorts rather than one over the\n        // union, deliberately: an app priority orders app filters against each other and nothing\n        // else, so no number an app can type — however large — gets underneath the SSRF guard or the\n        // credential minter. A single sorted list would make \"displace the guard\" a matter of typing\n        // a bigger integer, and a security control an app can outrank by accident is not a control.\n        //\n        // Sorted here, once, so FilterChain itself never sorts — priority lives on the DEFINITION,\n        // not on the filter.\n        const byPriority = (a: ClientFilterDefinition, b: ClientFilterDefinition): number =>\n            b.priority - a.priority;\n        const ordered = [\n            ...[...this.appFilters].sort(byPriority),\n            ...[...this.clientFilters()].sort(byPriority),\n        ];\n        this.chain = new FilterChain<ClientRequest, Response>(\n            ordered.map((definition: ClientFilterDefinition) => definition.filter),\n        );\n    }\n\n    /** The contract's class name, for logs and recordings. */\n    protected contractName(): string {\n        return this.apiName;\n    }\n\n    /** Check if a route exists for the given method name. */\n    hasRoute(methodName: string): boolean {\n        return this.routeMap.has(methodName);\n    }\n\n    /**\n     * Get route metadata for a method name.\n     * @throws Error if no route found\n     */\n    getRoute(methodName: string): RouteMetadata {\n        const route = this.routeMap.get(methodName);\n        if (!route) {\n            throw new Error(`No route found for method ${methodName}`);\n        }\n        return route;\n    }\n\n    // ---------------------------------------------------------------- the call\n\n    /**\n     * FAIL FAST, PER METHOD, at call time: some endpoints exist for a caller that is not us, and this\n     * proxy could only ever build a request they are obliged to reject. Refusing here rather than at\n     * bind time means an api that MIXES such endpoints with normal ones still yields a working client\n     * for the normal ones; only calling the un-callable method throws.\n     *\n     * @throws Error naming the endpoint, what it declared, and who its real caller is.\n     */\n    private refuseEndpointNoClientCanCall(route: RouteMetadata): void {\n        const authMode = route.authMeta?.mode;\n        // @WpAuthApiKey: the credential is a CUSTOMER-held key, and the header carrying it is the app's\n        // ApiKeyHook's choice, so this client has nothing to send and the call is a guaranteed 401.\n        if (authMode?.kind === 'apikey') {\n            throw new Error(\n                `${this.apiName}.${route.methodName} is @WpAuthApiKey('${authMode.regime}') — only the partner ` +\n                    `holding that api key can call it, and the header carrying it is the app's ApiKeyHook's choice, ` +\n                    `so a webpieces client has no credential to send.`,\n            );\n        }\n        // @WpAuthWebhook is DELIBERATELY absent from this list. It used to be here, on the assumption\n        // that the vendor is always somebody else — but `@WpAuthWebhook(name)` names a signing SCHEME,\n        // not a direction, and for an OUTBOUND partner webhook WE are the vendor. The environment's\n        // outbound-auth filter asks its bound signer to produce the signature, which is the exact\n        // mirror of the inbound WebhookAuthCallback that verifies one.\n    }\n\n    /** One logical call: one lifecycle pair and log entry across all strategy attempts. */\n    // webpieces-disable no-any-unknown -- request and response DTOs are erased at the proxy boundary\n    async makeRequest(route: RouteMetadata, args: unknown[]): Promise<unknown> {\n        this.refuseEndpointNoClientCanCall(route);\n        if (route.streaming) return this.makeStreamingRequest(route, args);\n        const mapped = HttpContractMapper.toWire(\n            route.path,\n            route.parameterBindings,\n            route.bodyParameterIndex,\n            args,\n        );\n        const logValue = mapped.body === undefined ? args : mapped.body;\n        return this.execute(route, logValue, () => this.executeCall(route, args));\n    }\n\n    /** Open a typed stream without bypassing the ordinary context/auth/filter request pipeline. */\n    // webpieces-disable no-any-unknown -- generated proxy arguments are runtime-validated here\n    private async makeStreamingRequest(route: RouteMetadata, args: unknown[]): Promise<unknown> {\n        if (!this.supportsConcurrentDuplexFetch()) {\n            throw new StreamingCapabilityError(\n                'browser',\n                'Fetch request streaming is half-duplex and has no protocol-compatible full-duplex fallback.',\n            );\n        }\n        const destination = this.responseStream(args);\n        return this.execute(route, 'stream-open', () =>\n            this.executeStreamingCall(route, destination),\n        );\n    }\n\n    // webpieces-disable no-any-unknown -- generated proxy arguments are runtime-validated here\n    private responseStream(args: unknown[]): ResponseStream<DtoValue> {\n        const candidate = args[0];\n        if (args.length !== 1 || typeof candidate !== 'object' || candidate === null) {\n            throw new StreamTransportError(\n                `${this.apiName} streaming methods require exactly one ResponseStream argument.`,\n            );\n        }\n        // webpieces-disable no-any-unknown -- reflected method argument is narrowed by the method checks below\n        const record = candidate as Record<string, unknown>;\n        if (\n            typeof record['event'] !== 'function' ||\n            typeof record['fail'] !== 'function' ||\n            typeof record['complete'] !== 'function' ||\n            typeof record['onCancel'] !== 'function'\n        ) {\n            throw new StreamTransportError(\n                `${this.apiName} streaming method argument does not implement ResponseStream.`,\n            );\n        }\n        return candidate as ResponseStream<DtoValue>;\n    }\n\n    /** One streaming handshake. Subsequent events stay on this established transport. */\n    private async executeStreamingCall(\n        route: RouteMetadata,\n        destination: ResponseStream<DtoValue>,\n    ): Promise<RequestStream<DtoValue>> {\n        this.onRequestStart(route);\n        let response: Response | undefined;\n        // eslint-disable-next-line @webpieces/no-unmanaged-exceptions -- lifecycle reports the original handshake failure\n        try {\n            const requestStream = await CallRegistry.execute(\n                this.apiClass,\n                route.methodName,\n                (timeoutMs: number) =>\n                    CallDeadline.run(\n                        timeoutMs,\n                        new CallContext(this.apiName, route.methodName),\n                        async (deadlineSignal: AbortSignal) => {\n                            const result = await this.openStreamingTransport(\n                                route,\n                                destination,\n                                deadlineSignal,\n                            );\n                            response = result.response;\n                            return result.upload;\n                        },\n                    ),\n                30_000,\n            );\n            this.onRequestEnd(\n                route,\n                new RequestOutcome(true, response?.status ?? 0, response?.headers),\n            );\n            return requestStream;\n        } catch (err: unknown) {\n            const error = toError(err);\n            this.onRequestEnd(\n                route,\n                new RequestOutcome(false, response?.status ?? 0, response?.headers, error),\n            );\n            throw err;\n        }\n    }\n\n    private async openStreamingTransport(\n        route: RouteMetadata,\n        destination: ResponseStream<DtoValue>,\n        deadlineSignal: AbortSignal,\n    ): Promise<OpenedStreamingTransport> {\n        const metadata = route.streaming;\n        if (!metadata) throw new StreamTransportError('Streaming metadata disappeared.');\n        const request = await this.prepareStreamingRequest(route);\n        const controller = new AbortController();\n        deadlineSignal.addEventListener('abort', (): void => controller.abort(), { once: true });\n        const upload = new NdjsonRequestStream(\n            metadata,\n            // webpieces-disable no-any-unknown -- AbortController accepts a platform-defined cancellation reason\n            (reason?: unknown) => controller.abort(reason),\n        );\n        const response = await this.chain.execute(request, () =>\n            this.sendStreamingOnce(request, controller.signal, upload.body),\n        );\n        if (!response.ok) {\n            await upload.transportFailed(\n                new StreamTransportError(\n                    `Streaming handshake failed with HTTP ${response.status}.`,\n                ),\n            );\n            await this.readResponse(response, route);\n            throw new StreamTransportError('Streaming handshake was rejected.');\n        }\n        const contentType = response.headers.get('content-type') ?? '';\n        if (!contentType.toLowerCase().startsWith('text/event-stream')) {\n            const error = new StreamTransportError(\n                `Streaming response requires text/event-stream, received '${contentType || 'missing'}'.`,\n            );\n            await upload.transportFailed(error);\n            throw error;\n        }\n        void new SseResponseStream()\n            .consume(response, destination, metadata, upload)\n            .catch(() => undefined);\n        return new OpenedStreamingTransport(response, upload);\n    }\n\n    /** Fresh filter-visible request metadata; the live request body is transport-owned. */\n    private async prepareStreamingRequest(route: RouteMetadata): Promise<ClientRequest> {\n        const baseUrl = await this.resolveBaseUrl();\n        const headers = new Map<string, string>();\n        headers.set('Content-Type', 'application/x-ndjson');\n        headers.set('Accept', 'text/event-stream');\n        const context = this.outboundContextHeaders(\n            DestinationTrust.forAuthMode(route.authMeta?.mode),\n        );\n        for (const entry of context.entries()) headers.set(entry[0], entry[1]);\n        return new ClientRequest(route, this.apiName, baseUrl, headers, undefined, undefined);\n    }\n\n    // webpieces-disable no-any-unknown -- response DTO is erased at the proxy boundary\n    private async executeCall(route: RouteMetadata, args: unknown[]): Promise<unknown> {\n        this.onRequestStart(route);\n        let response: Response | undefined;\n        // webpieces-disable no-any-unknown -- response DTO is erased at the proxy boundary\n        let result: unknown;\n        // webpieces-disable no-unmanaged-exceptions -- report one logical END, preserving the original thrown value\n        // eslint-disable-next-line @webpieces/no-unmanaged-exceptions\n        try {\n            result = await CallRegistry.execute(\n                this.apiClass,\n                route.methodName,\n                (timeoutMs: number) => {\n                    response = undefined;\n                    return CallDeadline.run(\n                        timeoutMs,\n                        new CallContext(this.apiName, route.methodName),\n                        async (signal: AbortSignal) => {\n                            const request = await this.prepareRequest(route, args);\n                            CallDeadline.throwIfAborted(signal);\n                            const received = await this.chain.execute(request, () =>\n                                this.sendOnce(request, signal),\n                            );\n                            CallDeadline.throwIfAborted(signal);\n                            response = received;\n                            return this.readResponse(received, route);\n                        },\n                    );\n                },\n                30_000,\n            );\n        } catch (err: unknown) {\n            const error = toError(err);\n            this.onRequestEnd(\n                route,\n                new RequestOutcome(false, response?.status ?? 0, response?.headers, error),\n            );\n            throw err;\n        }\n        this.onRequestEnd(\n            route,\n            new RequestOutcome(true, response?.status ?? 0, response?.headers),\n        );\n        return result;\n    }\n\n    /** Fresh mutable request for every attempt, including URL, headers, auth and body. */\n    // webpieces-disable no-any-unknown -- request DTO is erased at the proxy boundary\n    private async prepareRequest(route: RouteMetadata, args: unknown[]): Promise<ClientRequest> {\n        const baseUrl = await this.resolveBaseUrl();\n        const mapped = HttpContractMapper.toWire(\n            route.path,\n            route.parameterBindings,\n            route.bodyParameterIndex,\n            args,\n        );\n        const headers = new Map<string, string>();\n        const body = this.serializeBody(route, mapped.body, headers);\n        const context = this.outboundContextHeaders(\n            DestinationTrust.forAuthMode(route.authMeta?.mode),\n        );\n        for (const entry of context.entries()) headers.set(entry[0], entry[1]);\n        return new ClientRequest(\n            route,\n            this.apiName,\n            baseUrl,\n            headers,\n            body,\n            mapped.body,\n            mapped.path,\n        );\n    }\n\n    /** Serialize exactly the encoding the endpoint declared; GET is always bodyless. */\n    // webpieces-disable no-any-unknown -- request DTO type is erased at the generated proxy boundary\n    private serializeBody(\n        route: RouteMetadata,\n        requestDto: unknown,\n        headers: Map<string, string>,\n    ): string | undefined {\n        if (route.httpMethod === 'GET' || requestDto === undefined) return undefined;\n        if (route.formPost) {\n            headers.set('Content-Type', 'application/x-www-form-urlencoded');\n            return this.serializeForm(requestDto, route);\n        }\n        headers.set('Content-Type', 'application/json');\n        return JSON.stringify(requestDto);\n    }\n\n    /** Flat form DTO -> deterministic urlencoded bytes, repeating array-valued fields. */\n    // webpieces-disable no-any-unknown -- form DTO fields are contract-owned and heterogeneous\n    private serializeForm(requestDto: unknown, route: RouteMetadata): string {\n        if (requestDto === null || typeof requestDto !== 'object' || Array.isArray(requestDto)) {\n            throw new Error(\n                `${this.apiName}.${route.methodName} declares formPost:true, so its body must be a flat object.`,\n            );\n        }\n        const params = new URLSearchParams();\n        // webpieces-disable no-any-unknown -- checked object is narrowed to its contract-owned field bag\n        for (const key of Object.keys(requestDto as Record<string, unknown>).sort()) {\n            // webpieces-disable no-any-unknown -- checked object is narrowed to its contract-owned field bag\n            const value = (requestDto as Record<string, unknown>)[key];\n            if (value === undefined || value === null) continue;\n            const values = Array.isArray(value) ? value : [value];\n            for (const item of values) {\n                if (item !== undefined && item !== null) params.append(key, String(item));\n            }\n        }\n        return params.toString();\n    }\n\n    /**\n     * ONE transmission — the bottom of the filter chain, and the only place `fetch` is called.\n     *\n     * Everything it sends comes off the {@link ClientRequest} as the chain left it, so a filter's\n     * edits to the url, the headers or the serialized body are exactly what goes on the wire. It may\n     * run more than once for a single RPC when a filter follows a redirect.\n     *\n     * A network reject (offline, DNS, CORS preflight) is classified into a typed ApiConnectionError here (a\n     * genuine bug passes through untouched) so that filters above see the same typed error the caller\n     * will, rather than a raw platform reject.\n     */\n    private async sendOnce(request: ClientRequest, signal: AbortSignal): Promise<Response> {\n        CallDeadline.throwIfAborted(signal);\n        const options: RequestInit = {\n            method: request.route.httpMethod,\n            signal,\n            headers: request.headersAsRecord(),\n            redirect:\n                request.route.responseType === 'full' || !request.followRedirects\n                    ? 'manual'\n                    : 'follow',\n        };\n        if (request.body !== undefined) {\n            options.body = request.body;\n        }\n        // webpieces-disable no-unmanaged-exceptions -- classify a network reject, then rethrow it typed\n        // eslint-disable-next-line @webpieces/no-unmanaged-exceptions\n        try {\n            // webpieces-disable no-fetch -- this IS the generated-client implementation the rule points everyone to\n            return await fetch(request.url, options);\n        } catch (err: unknown) {\n            const error = toError(err);\n            throw this.networkRejectClassifier.toNetworkError(error, request.url);\n        }\n    }\n\n    /** Node fetch's streaming upload option. Browser callers are refused before reaching here. */\n    private async sendStreamingOnce(\n        request: ClientRequest,\n        signal: AbortSignal,\n        body: ByteReadableStream,\n    ): Promise<Response> {\n        CallDeadline.throwIfAborted(signal);\n        // eslint-disable-next-line @webpieces/no-unmanaged-exceptions -- platform rejects are normalized below\n        try {\n            return await this.sendStreamingTransport(request, signal, body);\n        } catch (err: unknown) {\n            const error = toError(err);\n            throw this.networkRejectClassifier.toNetworkError(error, request.url);\n        }\n    }\n\n    /** Body consumption is inside the attempt deadline, including non-JSON error bodies. */\n    // webpieces-disable no-any-unknown -- response DTO is erased at the proxy boundary\n    private async readResponse(response: Response, route: RouteMetadata): Promise<unknown> {\n        const callId = `${this.apiName}.${route.methodName}`;\n        if (route.responseType === 'full') {\n            return this.responseDtoFactory.fromFetch(\n                response,\n                await this.readFullResponseBody(response),\n            );\n        }\n        // 266 is protocol success, but its body represents an expected user exception.\n        if (response.ok && response.status !== 266) {\n            if (!this.bodyReader.isJson(response)) {\n                throw new Error(\n                    this.bodyReader.describeForeignBody(response, callId, await response.text()),\n                );\n            }\n            // webpieces-disable no-any-unknown -- a success body is the caller's own DTO, erased here\n            const body: unknown = await response.json();\n            // EVERY response passes the seam, 2xx included: an app whose 200 body signals failure\n            // turns it into a throw here. The webpieces default returns silently, so the success\n            // path is unchanged — and the body is parsed ONCE, because a fetch body reads once.\n            ClientErrorTranslator.throwIfFailure(\n                this.responseDtoFactory.fromFetch(response, body),\n            );\n            return body;\n        }\n        const protocolError = await this.bodyReader.readErrorBody(response, callId);\n        // The mirror of what the SERVER's `toWire` wrote. `fromWire` throws, so this method cannot\n        // return for a failure response — `throwIfFailure` puts the webpieces default behind an app\n        // translator that forgets to, so the guarantee does not depend on app code being correct.\n        ClientErrorTranslator.throwFailure(\n            this.responseDtoFactory.fromFetch(response, protocolError),\n        );\n    }\n\n    /** Preserve empty, JSON, and protocol text bodies for caller-owned full responses. */\n    // webpieces-disable no-any-unknown -- a full response deliberately preserves the caller-owned body\n    private async readFullResponseBody(response: Response): Promise<unknown> {\n        if (response.status === 204 || response.status === 304) return undefined;\n        const text = await response.text();\n        if (text === '') return undefined;\n        if (!this.bodyReader.isJson(response)) return text;\n        // webpieces-disable no-any-unknown -- parsed JSON is returned untouched to the typed contract caller\n        return JSON.parse(text) as unknown;\n    }\n}\n"]}

package/src/RequestOutcome.d.ts

@@ -25,11 +25,11 @@ export declare class RequestOutcome {
     readonly headers?: Headers | undefined;
     /**
      * Set on every non-success path: for a non-2xx, the error the CALLER will see — i.e. what
-     * `ClientErrorTranslator` picked AFTER `ProxyClient.adaptDownstreamFailure` had its say, so a
+     * the registered `ErrorTranslator`'s `fromWire` threw, so a
      * listener never disagrees with the thrown exception (on a server that is the 500 wrapping a
      * downstream 4xx, with the original reachable as `cause`). Otherwise the network/parse
      * failure normalized through `toError`. Always a real `Error` — never `unknown`, because
-     * nothing here is untyped: `translateError` RETURNS a typed `TranslatedFailure`, and every
+     * nothing here is untyped: `fromWire` THROWS a typed error, and every
      * rejection reaching this class has been through `toError`.
      */
     readonly error?: Error | undefined;
@@ -46,11 +46,11 @@ export declare class RequestOutcome {
     headers?: Headers | undefined, 
     /**
      * Set on every non-success path: for a non-2xx, the error the CALLER will see — i.e. what
-     * `ClientErrorTranslator` picked AFTER `ProxyClient.adaptDownstreamFailure` had its say, so a
+     * the registered `ErrorTranslator`'s `fromWire` threw, so a
      * listener never disagrees with the thrown exception (on a server that is the 500 wrapping a
      * downstream 4xx, with the original reachable as `cause`). Otherwise the network/parse
      * failure normalized through `toError`. Always a real `Error` — never `unknown`, because
-     * nothing here is untyped: `translateError` RETURNS a typed `TranslatedFailure`, and every
+     * nothing here is untyped: `fromWire` THROWS a typed error, and every
      * rejection reaching this class has been through `toError`.
      */
     error?: Error | undefined);

package/src/RequestOutcome.js

@@ -33,11 +33,11 @@ class RequestOutcome {
     headers, 
     /**
      * Set on every non-success path: for a non-2xx, the error the CALLER will see — i.e. what
-     * `ClientErrorTranslator` picked AFTER `ProxyClient.adaptDownstreamFailure` had its say, so a
+     * the registered `ErrorTranslator`'s `fromWire` threw, so a
      * listener never disagrees with the thrown exception (on a server that is the 500 wrapping a
      * downstream 4xx, with the original reachable as `cause`). Otherwise the network/parse
      * failure normalized through `toError`. Always a real `Error` — never `unknown`, because
-     * nothing here is untyped: `translateError` RETURNS a typed `TranslatedFailure`, and every
+     * nothing here is untyped: `fromWire` THROWS a typed error, and every
      * rejection reaching this class has been through `toError`.
      */
     error) {

package/src/RequestOutcome.js.map

@@ -1 +1 @@
-{"version":3,"file":"RequestOutcome.js","sourceRoot":"","sources":["../../../../../packages/http/http-client-core/src/RequestOutcome.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;;GAaG;AACH,MAAa,cAAc;IAGH;IAEA;IAMA;IAUA;IApBpB;IACI,2FAA2F;IAC3E,EAAW;IAC3B,qEAAqE;IACrD,MAAc;IAC9B;;;;OAIG;IACa,OAAiB;IACjC;;;;;;;;OAQG;IACa,KAAa;QAlBb,OAAE,GAAF,EAAE,CAAS;QAEX,WAAM,GAAN,MAAM,CAAQ;QAMd,YAAO,GAAP,OAAO,CAAU;QAUjB,UAAK,GAAL,KAAK,CAAQ;IAC9B,CAAC;CACP;AAvBD,wCAuBC","sourcesContent":["/**\n * How one RPC call SETTLED — the payload of {@link ProxyClient.onRequestEnd}.\n *\n * DATA ONLY (no behavior), so it is a class with an explicit constructor rather than an interface:\n * `ProxyClient.executeCall` constructs it by name on settlement, and a reader\n * can see at the call site which path produced which shape.\n *\n * The three shapes, one per path:\n * - 2xx            `new RequestOutcome(true, status, headers)`          — no error\n * - HTTP error     `new RequestOutcome(false, status, headers, error)`  — the translated API error\n * - network reject `new RequestOutcome(false, 0, undefined, error)`     — no Response ever existed\n *\n * A timeout or body parse failure uses the failure shape, with headers/status if they arrived.\n */\nexport class RequestOutcome {\n    constructor(\n        /** True when the logical call succeeded, including a strategy recovering from an error. */\n        public readonly ok: boolean,\n        /** The last attempt's HTTP status, or 0 when no response arrived. */\n        public readonly status: number,\n        /**\n         * The Response headers, present whenever an HTTP Response existed (ok OR error) and absent\n         * when no response arrived. Available after settlement, which lets an app pull\n         * a server-version stamp off an error response.\n         */\n        public readonly headers?: Headers,\n        /**\n         * Set on every non-success path: for a non-2xx, the error the CALLER will see — i.e. what\n         * `ClientErrorTranslator` picked AFTER `ProxyClient.adaptDownstreamFailure` had its say, so a\n         * listener never disagrees with the thrown exception (on a server that is the 500 wrapping a\n         * downstream 4xx, with the original reachable as `cause`). Otherwise the network/parse\n         * failure normalized through `toError`. Always a real `Error` — never `unknown`, because\n         * nothing here is untyped: `translateError` RETURNS a typed `TranslatedFailure`, and every\n         * rejection reaching this class has been through `toError`.\n         */\n        public readonly error?: Error,\n    ) {}\n}\n"]}
+{"version":3,"file":"RequestOutcome.js","sourceRoot":"","sources":["../../../../../packages/http/http-client-core/src/RequestOutcome.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;;GAaG;AACH,MAAa,cAAc;IAGH;IAEA;IAMA;IAUA;IApBpB;IACI,2FAA2F;IAC3E,EAAW;IAC3B,qEAAqE;IACrD,MAAc;IAC9B;;;;OAIG;IACa,OAAiB;IACjC;;;;;;;;OAQG;IACa,KAAa;QAlBb,OAAE,GAAF,EAAE,CAAS;QAEX,WAAM,GAAN,MAAM,CAAQ;QAMd,YAAO,GAAP,OAAO,CAAU;QAUjB,UAAK,GAAL,KAAK,CAAQ;IAC9B,CAAC;CACP;AAvBD,wCAuBC","sourcesContent":["/**\n * How one RPC call SETTLED — the payload of {@link ProxyClient.onRequestEnd}.\n *\n * DATA ONLY (no behavior), so it is a class with an explicit constructor rather than an interface:\n * `ProxyClient.executeCall` constructs it by name on settlement, and a reader\n * can see at the call site which path produced which shape.\n *\n * The three shapes, one per path:\n * - 2xx            `new RequestOutcome(true, status, headers)`          — no error\n * - HTTP error     `new RequestOutcome(false, status, headers, error)`  — the translated API error\n * - network reject `new RequestOutcome(false, 0, undefined, error)`     — no Response ever existed\n *\n * A timeout or body parse failure uses the failure shape, with headers/status if they arrived.\n */\nexport class RequestOutcome {\n    constructor(\n        /** True when the logical call succeeded, including a strategy recovering from an error. */\n        public readonly ok: boolean,\n        /** The last attempt's HTTP status, or 0 when no response arrived. */\n        public readonly status: number,\n        /**\n         * The Response headers, present whenever an HTTP Response existed (ok OR error) and absent\n         * when no response arrived. Available after settlement, which lets an app pull\n         * a server-version stamp off an error response.\n         */\n        public readonly headers?: Headers,\n        /**\n         * Set on every non-success path: for a non-2xx, the error the CALLER will see — i.e. what\n         * the registered `ErrorTranslator`'s `fromWire` threw, so a\n         * listener never disagrees with the thrown exception (on a server that is the 500 wrapping a\n         * downstream 4xx, with the original reachable as `cause`). Otherwise the network/parse\n         * failure normalized through `toError`. Always a real `Error` — never `unknown`, because\n         * nothing here is untyped: `fromWire` THROWS a typed error, and every\n         * rejection reaching this class has been through `toError`.\n         */\n        public readonly error?: Error,\n    ) {}\n}\n"]}

package/src/index.d.ts

@@ -29,9 +29,7 @@ export { RequestOutcome } from './RequestOutcome';
 export type { ApiPrototype } from './ApiPrototype';
 export { buildClientProxy } from './buildClientProxy';
 export { ClientErrorTranslator } from './ClientErrorTranslator';
-export { UnexpectedApiResponseError } from './UnexpectedApiResponseError';
 export { HttpResponseDtoFactory } from './HttpResponseDtoFactory';
-export { TranslatedFailure } from './TranslatedFailure';
 export { ResponseBodyReader } from './ResponseBodyReader';
 export { ClientRequest } from './ClientRequest';
 export { ClientFilterDefinition } from './ClientFilter';

package/src/index.js

@@ -26,7 +26,7 @@
  * a browser bundle, and nothing browser-only (a ContextReader store) reaches a server.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Utf8Codec = exports.StreamingCapabilityError = exports.StreamEnvelopeCodec = exports.SseResponseStream = exports.SseEventParser = exports.SseEvent = exports.NdjsonRequestStream = exports.ClientFilterDefinition = exports.ClientRequest = exports.ResponseBodyReader = exports.TranslatedFailure = exports.HttpResponseDtoFactory = exports.UnexpectedApiResponseError = exports.ClientErrorTranslator = exports.buildClientProxy = exports.RequestOutcome = exports.ProxyClient = void 0;
+exports.Utf8Codec = exports.StreamingCapabilityError = exports.StreamEnvelopeCodec = exports.SseResponseStream = exports.SseEventParser = exports.SseEvent = exports.NdjsonRequestStream = exports.ClientFilterDefinition = exports.ClientRequest = exports.ResponseBodyReader = exports.HttpResponseDtoFactory = exports.ClientErrorTranslator = exports.buildClientProxy = exports.RequestOutcome = exports.ProxyClient = void 0;
 var ProxyClient_1 = require("./ProxyClient");
 Object.defineProperty(exports, "ProxyClient", { enumerable: true, get: function () { return ProxyClient_1.ProxyClient; } });
 var RequestOutcome_1 = require("./RequestOutcome");
@@ -35,14 +35,10 @@ var buildClientProxy_1 = require("./buildClientProxy");
 Object.defineProperty(exports, "buildClientProxy", { enumerable: true, get: function () { return buildClientProxy_1.buildClientProxy; } });
 var ClientErrorTranslator_1 = require("./ClientErrorTranslator");
 Object.defineProperty(exports, "ClientErrorTranslator", { enumerable: true, get: function () { return ClientErrorTranslator_1.ClientErrorTranslator; } });
-var UnexpectedApiResponseError_1 = require("./UnexpectedApiResponseError");
-Object.defineProperty(exports, "UnexpectedApiResponseError", { enumerable: true, get: function () { return UnexpectedApiResponseError_1.UnexpectedApiResponseError; } });
 // The CLIENT-side transport boundary: a fetch Response becomes the ONE HttpResponseDto an app's
-// ErrorTranslators sees, so node and browser hand `fromWire` the identical shape.
+// ErrorTranslator sees, so node and browser hand `fromWire` the identical shape.
 var HttpResponseDtoFactory_1 = require("./HttpResponseDtoFactory");
 Object.defineProperty(exports, "HttpResponseDtoFactory", { enumerable: true, get: function () { return HttpResponseDtoFactory_1.HttpResponseDtoFactory; } });
-var TranslatedFailure_1 = require("./TranslatedFailure");
-Object.defineProperty(exports, "TranslatedFailure", { enumerable: true, get: function () { return TranslatedFailure_1.TranslatedFailure; } });
 var ResponseBodyReader_1 = require("./ResponseBodyReader");
 Object.defineProperty(exports, "ResponseBodyReader", { enumerable: true, get: function () { return ResponseBodyReader_1.ResponseBodyReader; } });
 // The OUTBOUND filter chain: the mutable request a filter edits, and one registration of a filter

package/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/http/http-client-core/src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;;;AAEH,6CAA4C;AAAnC,0GAAA,WAAW,OAAA;AACpB,mDAAkD;AAAzC,gHAAA,cAAc,OAAA;AAEvB,uDAAsD;AAA7C,oHAAA,gBAAgB,OAAA;AACzB,iEAAgE;AAAvD,8HAAA,qBAAqB,OAAA;AAC9B,2EAA0E;AAAjE,wIAAA,0BAA0B,OAAA;AACnC,gGAAgG;AAChG,kFAAkF;AAClF,mEAAkE;AAAzD,gIAAA,sBAAsB,OAAA;AAC/B,yDAAwD;AAA/C,sHAAA,iBAAiB,OAAA;AAC1B,2DAA0D;AAAjD,wHAAA,kBAAkB,OAAA;AAC3B,kGAAkG;AAClG,kFAAkF;AAClF,gEAAgE;AAChE,iDAAgD;AAAvC,8GAAA,aAAa,OAAA;AACtB,+CAAwD;AAA/C,sHAAA,sBAAsB,OAAA;AAE/B,6FAA6F;AAC7F,+FAA+F;AAC/F,6DAA4D;AAAnD,0HAAA,mBAAmB,OAAA;AAC5B,mDAA4D;AAAnD,0GAAA,QAAQ,OAAA;AAAE,gHAAA,cAAc,OAAA;AACjC,yDAAwD;AAA/C,sHAAA,iBAAiB,OAAA;AAC1B,6DAA4D;AAAnD,0HAAA,mBAAmB,OAAA;AAC5B,uEAAsE;AAA7D,oIAAA,wBAAwB,OAAA;AACjC,yCAAwC;AAA/B,sGAAA,SAAS,OAAA","sourcesContent":["/**\n * @webpieces/http-client-core\n *\n * The ISOMORPHIC core of the webpieces HTTP client — everything that reads an API contract's\n * decorators and turns a method call into an HTTP request, with no opinion about where the\n * magic context comes from or whether a DI container exists.\n *\n * You almost certainly want one of its two environment packages instead:\n * - Server:  @webpieces/http-client-node    (inversify-wired, reads RequestContext, mints OIDC)\n * - Browser: @webpieces/http-client-browser (no DI — React or Angular, app-managed context store)\n *\n * Architecture:\n * ```\n * http-api (defines the contract)\n *    ^\n *    +-- http-routing (server: contract -> handlers)\n *    +-- http-client-core (contract -> HTTP requests)   <- YOU ARE HERE\n *          +-- http-client-node     (RequestContext + Secrets + OIDC + inversify factory)\n *          +-- http-client-browser  (app-held store + plain factory, no DI)\n * ```\n *\n * There is no context/credential/recording seam here at all: ProxyClient is ABSTRACT and asks its\n * subclass for the base URL, the context headers, the log map, the outbound credential, and the\n * recorder. Nothing server-only (RequestContext, Secrets, mintIdToken, TestCaseRecorder) can reach\n * a browser bundle, and nothing browser-only (a ContextReader store) reaches a server.\n */\n\nexport { ProxyClient } from './ProxyClient';\nexport { RequestOutcome } from './RequestOutcome';\nexport type { ApiPrototype } from './ApiPrototype';\nexport { buildClientProxy } from './buildClientProxy';\nexport { ClientErrorTranslator } from './ClientErrorTranslator';\nexport { UnexpectedApiResponseError } from './UnexpectedApiResponseError';\n// The CLIENT-side transport boundary: a fetch Response becomes the ONE HttpResponseDto an app's\n// ErrorTranslators sees, so node and browser hand `fromWire` the identical shape.\nexport { HttpResponseDtoFactory } from './HttpResponseDtoFactory';\nexport { TranslatedFailure } from './TranslatedFailure';\nexport { ResponseBodyReader } from './ResponseBodyReader';\n// The OUTBOUND filter chain: the mutable request a filter edits, and one registration of a filter\n// at a priority. The `Filter`/`Service`/`FilterChain` abstraction itself lives in\n// @webpieces/core-util, shared with the server's inbound chain.\nexport { ClientRequest } from './ClientRequest';\nexport { ClientFilterDefinition } from './ClientFilter';\nexport type { ClientFilter } from './ClientFilter';\n// Generic streaming wire adapters: NDJSON uploads, request-scoped SSE downloads, and a typed\n// capability failure for runtimes that cannot safely keep both fetch halves open concurrently.\nexport { NdjsonRequestStream } from './NdjsonRequestStream';\nexport { SseEvent, SseEventParser } from './SseEventParser';\nexport { SseResponseStream } from './SseResponseStream';\nexport { StreamEnvelopeCodec } from './StreamEnvelopeCodec';\nexport { StreamingCapabilityError } from './StreamingCapabilityError';\nexport { Utf8Codec } from './Utf8Codec';\nexport type { ByteReadableStream, ByteStreamReader, ByteReadResult } from './ByteStream';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/http/http-client-core/src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;;;AAEH,6CAA4C;AAAnC,0GAAA,WAAW,OAAA;AACpB,mDAAkD;AAAzC,gHAAA,cAAc,OAAA;AAEvB,uDAAsD;AAA7C,oHAAA,gBAAgB,OAAA;AACzB,iEAAgE;AAAvD,8HAAA,qBAAqB,OAAA;AAC9B,gGAAgG;AAChG,iFAAiF;AACjF,mEAAkE;AAAzD,gIAAA,sBAAsB,OAAA;AAC/B,2DAA0D;AAAjD,wHAAA,kBAAkB,OAAA;AAC3B,kGAAkG;AAClG,kFAAkF;AAClF,gEAAgE;AAChE,iDAAgD;AAAvC,8GAAA,aAAa,OAAA;AACtB,+CAAwD;AAA/C,sHAAA,sBAAsB,OAAA;AAE/B,6FAA6F;AAC7F,+FAA+F;AAC/F,6DAA4D;AAAnD,0HAAA,mBAAmB,OAAA;AAC5B,mDAA4D;AAAnD,0GAAA,QAAQ,OAAA;AAAE,gHAAA,cAAc,OAAA;AACjC,yDAAwD;AAA/C,sHAAA,iBAAiB,OAAA;AAC1B,6DAA4D;AAAnD,0HAAA,mBAAmB,OAAA;AAC5B,uEAAsE;AAA7D,oIAAA,wBAAwB,OAAA;AACjC,yCAAwC;AAA/B,sGAAA,SAAS,OAAA","sourcesContent":["/**\n * @webpieces/http-client-core\n *\n * The ISOMORPHIC core of the webpieces HTTP client — everything that reads an API contract's\n * decorators and turns a method call into an HTTP request, with no opinion about where the\n * magic context comes from or whether a DI container exists.\n *\n * You almost certainly want one of its two environment packages instead:\n * - Server:  @webpieces/http-client-node    (inversify-wired, reads RequestContext, mints OIDC)\n * - Browser: @webpieces/http-client-browser (no DI — React or Angular, app-managed context store)\n *\n * Architecture:\n * ```\n * http-api (defines the contract)\n *    ^\n *    +-- http-routing (server: contract -> handlers)\n *    +-- http-client-core (contract -> HTTP requests)   <- YOU ARE HERE\n *          +-- http-client-node     (RequestContext + Secrets + OIDC + inversify factory)\n *          +-- http-client-browser  (app-held store + plain factory, no DI)\n * ```\n *\n * There is no context/credential/recording seam here at all: ProxyClient is ABSTRACT and asks its\n * subclass for the base URL, the context headers, the log map, the outbound credential, and the\n * recorder. Nothing server-only (RequestContext, Secrets, mintIdToken, TestCaseRecorder) can reach\n * a browser bundle, and nothing browser-only (a ContextReader store) reaches a server.\n */\n\nexport { ProxyClient } from './ProxyClient';\nexport { RequestOutcome } from './RequestOutcome';\nexport type { ApiPrototype } from './ApiPrototype';\nexport { buildClientProxy } from './buildClientProxy';\nexport { ClientErrorTranslator } from './ClientErrorTranslator';\n// The CLIENT-side transport boundary: a fetch Response becomes the ONE HttpResponseDto an app's\n// ErrorTranslator sees, so node and browser hand `fromWire` the identical shape.\nexport { HttpResponseDtoFactory } from './HttpResponseDtoFactory';\nexport { ResponseBodyReader } from './ResponseBodyReader';\n// The OUTBOUND filter chain: the mutable request a filter edits, and one registration of a filter\n// at a priority. The `Filter`/`Service`/`FilterChain` abstraction itself lives in\n// @webpieces/core-util, shared with the server's inbound chain.\nexport { ClientRequest } from './ClientRequest';\nexport { ClientFilterDefinition } from './ClientFilter';\nexport type { ClientFilter } from './ClientFilter';\n// Generic streaming wire adapters: NDJSON uploads, request-scoped SSE downloads, and a typed\n// capability failure for runtimes that cannot safely keep both fetch halves open concurrently.\nexport { NdjsonRequestStream } from './NdjsonRequestStream';\nexport { SseEvent, SseEventParser } from './SseEventParser';\nexport { SseResponseStream } from './SseResponseStream';\nexport { StreamEnvelopeCodec } from './StreamEnvelopeCodec';\nexport { StreamingCapabilityError } from './StreamingCapabilityError';\nexport { Utf8Codec } from './Utf8Codec';\nexport type { ByteReadableStream, ByteStreamReader, ByteReadResult } from './ByteStream';\n"]}

package/src/TranslatedFailure.d.ts

@@ -1,50 +0,0 @@
-/**
- * What {@link ClientErrorTranslator.translateError} decided about ONE non-2xx downstream response —
- * the typed error, plus WHO decided it.
- *
- * DATA ONLY (no behavior), so it is a class with an explicit constructor rather than an interface,
- * exactly like {@link RequestOutcome}.
- *
- * WHY IT CARRIES `appRegistered` AT ALL: the translated error alone is not enough for an environment
- * hook to act on. `ApiNotFoundError` produced by the BUILT-IN 404 branch and `ApiNotFoundError`
- * produced by an app's own `ErrorTranslators` are indistinguishable as values, yet they mean opposite
- * things — the first is the framework's generic default, the second is the app saying out loud, at
- * startup and greppably, "relay this status as my own". `ProxyClient.adaptDownstreamFailure` must
- * honour the second and is free to replace the first, so the provenance has to travel WITH the error
- * rather than be re-derived by consulting `ClientRegistry` a second time.
- *
- * `statusCode` is the status the DOWNSTREAM answered — carried explicitly rather than read back off
- * `error.code`, because an app-registered translation may legitimately return an error whose `code`
- * is nothing like the status that produced it, and need not be a portable `ApiError` at all.
- */
-export declare class TranslatedFailure {
-    /** The typed error the translator picked for this response. Always a real `Error`. */
-    readonly error: Error;
-    /**
-     * True when an app-registered `ClientRegistry` translation claimed this status — i.e. the app
-     * chose this error type deliberately, at startup, in one greppable place. False when the
-     * framework's built-in status mapping produced it.
-     *
-     * This IS the caller's explicit opt-out from any environment-specific rewrite: see
-     * `NodeProxyClient.adaptDownstreamFailure`, where an app-registered 4xx wins over the
-     * server-to-server 4xx-to-500 wrap.
-     */
-    readonly appRegistered: boolean;
-    /** The HTTP status the downstream dependency actually answered with. */
-    readonly statusCode: number;
-    constructor(
-    /** The typed error the translator picked for this response. Always a real `Error`. */
-    error: Error, 
-    /**
-     * True when an app-registered `ClientRegistry` translation claimed this status — i.e. the app
-     * chose this error type deliberately, at startup, in one greppable place. False when the
-     * framework's built-in status mapping produced it.
-     *
-     * This IS the caller's explicit opt-out from any environment-specific rewrite: see
-     * `NodeProxyClient.adaptDownstreamFailure`, where an app-registered 4xx wins over the
-     * server-to-server 4xx-to-500 wrap.
-     */
-    appRegistered: boolean, 
-    /** The HTTP status the downstream dependency actually answered with. */
-    statusCode: number);
-}

package/src/TranslatedFailure.js

@@ -1,48 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.TranslatedFailure = void 0;
-/**
- * What {@link ClientErrorTranslator.translateError} decided about ONE non-2xx downstream response —
- * the typed error, plus WHO decided it.
- *
- * DATA ONLY (no behavior), so it is a class with an explicit constructor rather than an interface,
- * exactly like {@link RequestOutcome}.
- *
- * WHY IT CARRIES `appRegistered` AT ALL: the translated error alone is not enough for an environment
- * hook to act on. `ApiNotFoundError` produced by the BUILT-IN 404 branch and `ApiNotFoundError`
- * produced by an app's own `ErrorTranslators` are indistinguishable as values, yet they mean opposite
- * things — the first is the framework's generic default, the second is the app saying out loud, at
- * startup and greppably, "relay this status as my own". `ProxyClient.adaptDownstreamFailure` must
- * honour the second and is free to replace the first, so the provenance has to travel WITH the error
- * rather than be re-derived by consulting `ClientRegistry` a second time.
- *
- * `statusCode` is the status the DOWNSTREAM answered — carried explicitly rather than read back off
- * `error.code`, because an app-registered translation may legitimately return an error whose `code`
- * is nothing like the status that produced it, and need not be a portable `ApiError` at all.
- */
-class TranslatedFailure {
-    error;
-    appRegistered;
-    statusCode;
-    constructor(
-    /** The typed error the translator picked for this response. Always a real `Error`. */
-    error, 
-    /**
-     * True when an app-registered `ClientRegistry` translation claimed this status — i.e. the app
-     * chose this error type deliberately, at startup, in one greppable place. False when the
-     * framework's built-in status mapping produced it.
-     *
-     * This IS the caller's explicit opt-out from any environment-specific rewrite: see
-     * `NodeProxyClient.adaptDownstreamFailure`, where an app-registered 4xx wins over the
-     * server-to-server 4xx-to-500 wrap.
-     */
-    appRegistered, 
-    /** The HTTP status the downstream dependency actually answered with. */
-    statusCode) {
-        this.error = error;
-        this.appRegistered = appRegistered;
-        this.statusCode = statusCode;
-    }
-}
-exports.TranslatedFailure = TranslatedFailure;
-//# sourceMappingURL=TranslatedFailure.js.map

package/src/TranslatedFailure.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"TranslatedFailure.js","sourceRoot":"","sources":["../../../../../packages/http/http-client-core/src/TranslatedFailure.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAa,iBAAiB;IAGN;IAUA;IAEA;IAdpB;IACI,sFAAsF;IACtE,KAAY;IAC5B;;;;;;;;OAQG;IACa,aAAsB;IACtC,wEAAwE;IACxD,UAAkB;QAZlB,UAAK,GAAL,KAAK,CAAO;QAUZ,kBAAa,GAAb,aAAa,CAAS;QAEtB,eAAU,GAAV,UAAU,CAAQ;IACnC,CAAC;CACP;AAjBD,8CAiBC","sourcesContent":["/**\n * What {@link ClientErrorTranslator.translateError} decided about ONE non-2xx downstream response —\n * the typed error, plus WHO decided it.\n *\n * DATA ONLY (no behavior), so it is a class with an explicit constructor rather than an interface,\n * exactly like {@link RequestOutcome}.\n *\n * WHY IT CARRIES `appRegistered` AT ALL: the translated error alone is not enough for an environment\n * hook to act on. `ApiNotFoundError` produced by the BUILT-IN 404 branch and `ApiNotFoundError`\n * produced by an app's own `ErrorTranslators` are indistinguishable as values, yet they mean opposite\n * things — the first is the framework's generic default, the second is the app saying out loud, at\n * startup and greppably, \"relay this status as my own\". `ProxyClient.adaptDownstreamFailure` must\n * honour the second and is free to replace the first, so the provenance has to travel WITH the error\n * rather than be re-derived by consulting `ClientRegistry` a second time.\n *\n * `statusCode` is the status the DOWNSTREAM answered — carried explicitly rather than read back off\n * `error.code`, because an app-registered translation may legitimately return an error whose `code`\n * is nothing like the status that produced it, and need not be a portable `ApiError` at all.\n */\nexport class TranslatedFailure {\n    constructor(\n        /** The typed error the translator picked for this response. Always a real `Error`. */\n        public readonly error: Error,\n        /**\n         * True when an app-registered `ClientRegistry` translation claimed this status — i.e. the app\n         * chose this error type deliberately, at startup, in one greppable place. False when the\n         * framework's built-in status mapping produced it.\n         *\n         * This IS the caller's explicit opt-out from any environment-specific rewrite: see\n         * `NodeProxyClient.adaptDownstreamFailure`, where an app-registered 4xx wins over the\n         * server-to-server 4xx-to-500 wrap.\n         */\n        public readonly appRegistered: boolean,\n        /** The HTTP status the downstream dependency actually answered with. */\n        public readonly statusCode: number,\n    ) {}\n}\n"]}

package/src/UnexpectedApiResponseError.d.ts

@@ -1,5 +0,0 @@
-/** HTTP adapter failure for a status outside 100-599 (so not an ApiCodedError) not claimed by an app translator. */
-export declare class UnexpectedApiResponseError extends Error {
-    readonly statusCode: number;
-    constructor(statusCode: number, message: string);
-}

package/src/UnexpectedApiResponseError.js

@@ -1,14 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.UnexpectedApiResponseError = void 0;
-/** HTTP adapter failure for a status outside 100-599 (so not an ApiCodedError) not claimed by an app translator. */
-class UnexpectedApiResponseError extends Error {
-    statusCode;
-    constructor(statusCode, message) {
-        super(message);
-        this.statusCode = statusCode;
-        this.name = 'UnexpectedApiResponseError';
-    }
-}
-exports.UnexpectedApiResponseError = UnexpectedApiResponseError;
-//# sourceMappingURL=UnexpectedApiResponseError.js.map

package/src/UnexpectedApiResponseError.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"UnexpectedApiResponseError.js","sourceRoot":"","sources":["../../../../../packages/http/http-client-core/src/UnexpectedApiResponseError.ts"],"names":[],"mappings":";;;AAAA,oHAAoH;AACpH,MAAa,0BAA2B,SAAQ,KAAK;IAE7B;IADpB,YACoB,UAAkB,EAClC,OAAe;QAEf,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,eAAU,GAAV,UAAU,CAAQ;QAIlC,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;IAC7C,CAAC;CACJ;AARD,gEAQC","sourcesContent":["/** HTTP adapter failure for a status outside 100-599 (so not an ApiCodedError) not claimed by an app translator. */\nexport class UnexpectedApiResponseError extends Error {\n    constructor(\n        public readonly statusCode: number,\n        message: string,\n    ) {\n        super(message);\n        this.name = 'UnexpectedApiResponseError';\n    }\n}\n"]}