@webpieces/http-client-core 0.4.772 → 0.4.774

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webpieces/http-client-core",
-  "version": "0.4.772",
+  "version": "0.4.774",
   "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.772"
+    "@webpieces/core-util": "0.4.774"
   }
 }

package/src/ByteStream.d.ts

@@ -0,0 +1,12 @@
+/** Minimal structural byte-stream types that do not force DOM streams into React Native .d.ts files. */
+export interface ByteReadResult {
+    readonly done: boolean;
+    readonly value?: Uint8Array;
+}
+export interface ByteStreamReader {
+    read(): Promise<ByteReadResult>;
+    releaseLock(): void;
+}
+export interface ByteReadableStream {
+    getReader(): ByteStreamReader;
+}

package/src/ByteStream.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ByteStream.js.map

package/src/ByteStream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ByteStream.js","sourceRoot":"","sources":["../../../../../packages/http/http-client-core/src/ByteStream.ts"],"names":[],"mappings":"","sourcesContent":["/** Minimal structural byte-stream types that do not force DOM streams into React Native .d.ts files. */\nexport interface ByteReadResult {\n    readonly done: boolean;\n    readonly value?: Uint8Array;\n}\n\nexport interface ByteStreamReader {\n    read(): Promise<ByteReadResult>;\n    releaseLock(): void;\n}\n\nexport interface ByteReadableStream {\n    getReader(): ByteStreamReader;\n}\n"]}

package/src/NdjsonRequestStream.d.ts

@@ -0,0 +1,23 @@
+import { ApiError, DtoValue, RequestStream, StreamCorrelation, StreamFailureOptions, StreamingEndpointMetadata } from '@webpieces/core-util';
+import { ByteReadableStream } from './ByteStream';
+/** NDJSON upload half: exactly one JSON envelope plus LF per acknowledged write. */
+export declare class NdjsonRequestStream implements RequestStream<DtoValue> {
+    private readonly metadata;
+    private readonly abort;
+    readonly body: ByteReadableStream;
+    private readonly writer;
+    private readonly encoder;
+    private readonly validator;
+    private readonly ready;
+    private terminal;
+    private cancelled;
+    constructor(metadata: StreamingEndpointMetadata, abort: (reason?: unknown) => void);
+    event(value: DtoValue, correlation?: StreamCorrelation): Promise<void>;
+    fail(error: ApiError, correlation?: StreamCorrelation, options?: StreamFailureOptions): Promise<void>;
+    complete(): Promise<void>;
+    cancel(reason?: unknown): Promise<void>;
+    transportFailed(reason: unknown): Promise<void>;
+    private write;
+    private closeWriter;
+    private requireWritable;
+}

package/src/NdjsonRequestStream.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NdjsonRequestStream = void 0;
+const core_util_1 = require("@webpieces/core-util");
+const StreamEnvelopeCodec_1 = require("./StreamEnvelopeCodec");
+const Utf8Codec_1 = require("./Utf8Codec");
+/** NDJSON upload half: exactly one JSON envelope plus LF per acknowledged write. */
+class NdjsonRequestStream {
+    metadata;
+    abort;
+    body;
+    writer;
+    encoder = new Utf8Codec_1.Utf8Codec();
+    validator = new core_util_1.StreamEventValidator();
+    ready;
+    terminal = false;
+    cancelled = false;
+    constructor(metadata, 
+    // webpieces-disable no-any-unknown -- AbortSignal reasons are platform-defined
+    abort) {
+        this.metadata = metadata;
+        this.abort = abort;
+        const transport = new TransformStream();
+        this.body = transport.readable;
+        this.writer = transport.writable.getWriter();
+        // A blank NDJSON line is a transport preamble. It makes Node/undici send request headers so
+        // the server can establish the SSE response before the caller has its request writer.
+        this.ready = this.writer.write(this.encoder.encode('\n'));
+    }
+    async event(value, correlation) {
+        this.requireWritable();
+        this.validator.validate(this.metadata.requestEventClass, value, 'request');
+        await this.write(new core_util_1.StreamEnvelope('event', value, undefined, correlation));
+    }
+    async fail(error, correlation, options) {
+        this.requireWritable();
+        const terminal = options?.terminal ?? true;
+        await this.write(new core_util_1.StreamEnvelope('failure', undefined, core_util_1.ApiErrorCodec.encode(error), correlation, terminal));
+        if (terminal)
+            await this.closeWriter();
+    }
+    async complete() {
+        this.requireWritable();
+        await this.write(new core_util_1.StreamEnvelope('complete'));
+        await this.closeWriter();
+    }
+    // webpieces-disable no-any-unknown -- AbortSignal reasons are platform-defined
+    async cancel(reason) {
+        if (this.terminal || this.cancelled)
+            return;
+        this.cancelled = true;
+        this.terminal = true;
+        this.abort(reason);
+        // eslint-disable-next-line @webpieces/no-unmanaged-exceptions -- abort may race a fetch-owned stream close
+        try {
+            await this.writer.abort(reason);
+        }
+        catch (err) {
+            const error = (0, core_util_1.toError)(err);
+            void error;
+        }
+    }
+    // webpieces-disable no-any-unknown -- a transport failure carries the platform cause
+    async transportFailed(reason) {
+        await this.cancel(reason);
+    }
+    async write(envelope) {
+        await this.ready;
+        const line = `${StreamEnvelopeCodec_1.StreamEnvelopeCodec.encode(envelope)}\n`;
+        // WritableStream.write resolves only when the fetch consumer accepts the chunk.
+        await this.writer.write(this.encoder.encode(line));
+    }
+    async closeWriter() {
+        this.terminal = true;
+        await this.ready;
+        await this.writer.close();
+    }
+    requireWritable() {
+        if (this.terminal || this.cancelled) {
+            throw new core_util_1.StreamTransportError('Cannot write after stream termination.');
+        }
+    }
+}
+exports.NdjsonRequestStream = NdjsonRequestStream;
+//# sourceMappingURL=NdjsonRequestStream.js.map

package/src/NdjsonRequestStream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NdjsonRequestStream.js","sourceRoot":"","sources":["../../../../../packages/http/http-client-core/src/NdjsonRequestStream.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n    ApiError,\n    ApiErrorCodec,\n    DtoValue,\n    RequestStream,\n    StreamCorrelation,\n    StreamEnvelope,\n    StreamEventValidator,\n    StreamFailureOptions,\n    StreamingEndpointMetadata,\n    StreamTransportError,\n    toError,\n} from '@webpieces/core-util';\nimport { StreamEnvelopeCodec } from './StreamEnvelopeCodec';\nimport { Utf8Codec } from './Utf8Codec';\nimport { ByteReadableStream } from './ByteStream';\n\n/** NDJSON upload half: exactly one JSON envelope plus LF per acknowledged write. */\nexport class NdjsonRequestStream implements RequestStream<DtoValue> {\n    readonly body: ByteReadableStream;\n    private readonly writer: WritableStreamDefaultWriter<Uint8Array>;\n    private readonly encoder = new Utf8Codec();\n    private readonly validator = new StreamEventValidator();\n    private readonly ready: Promise<void>;\n    private terminal = false;\n    private cancelled = false;\n\n    constructor(\n        private readonly metadata: StreamingEndpointMetadata,\n        // webpieces-disable no-any-unknown -- AbortSignal reasons are platform-defined\n        private readonly abort: (reason?: unknown) => void,\n    ) {\n        const transport = new TransformStream<Uint8Array, Uint8Array>();\n        this.body = transport.readable;\n        this.writer = transport.writable.getWriter();\n        // A blank NDJSON line is a transport preamble. It makes Node/undici send request headers so\n        // the server can establish the SSE response before the caller has its request writer.\n        this.ready = this.writer.write(this.encoder.encode('\\n'));\n    }\n\n    async event(value: DtoValue, correlation?: StreamCorrelation): Promise<void> {\n        this.requireWritable();\n        this.validator.validate(this.metadata.requestEventClass, value, 'request');\n        await this.write(new StreamEnvelope('event', value, undefined, correlation));\n    }\n\n    async fail(\n        error: ApiError,\n        correlation?: StreamCorrelation,\n        options?: StreamFailureOptions,\n    ): Promise<void> {\n        this.requireWritable();\n        const terminal = options?.terminal ?? true;\n        await this.write(\n            new StreamEnvelope<DtoValue>(\n                'failure',\n                undefined,\n                ApiErrorCodec.encode(error),\n                correlation,\n                terminal,\n            ),\n        );\n        if (terminal) await this.closeWriter();\n    }\n\n    async complete(): Promise<void> {\n        this.requireWritable();\n        await this.write(new StreamEnvelope<DtoValue>('complete'));\n        await this.closeWriter();\n    }\n\n    // webpieces-disable no-any-unknown -- AbortSignal reasons are platform-defined\n    async cancel(reason?: unknown): Promise<void> {\n        if (this.terminal || this.cancelled) return;\n        this.cancelled = true;\n        this.terminal = true;\n        this.abort(reason);\n        // eslint-disable-next-line @webpieces/no-unmanaged-exceptions -- abort may race a fetch-owned stream close\n        try {\n            await this.writer.abort(reason);\n        } catch (err: unknown) {\n            const error = toError(err);\n            void error;\n        }\n    }\n\n    // webpieces-disable no-any-unknown -- a transport failure carries the platform cause\n    async transportFailed(reason: unknown): Promise<void> {\n        await this.cancel(reason);\n    }\n\n    private async write(envelope: StreamEnvelope<DtoValue>): Promise<void> {\n        await this.ready;\n        const line = `${StreamEnvelopeCodec.encode(envelope)}\\n`;\n        // WritableStream.write resolves only when the fetch consumer accepts the chunk.\n        await this.writer.write(this.encoder.encode(line));\n    }\n\n    private async closeWriter(): Promise<void> {\n        this.terminal = true;\n        await this.ready;\n        await this.writer.close();\n    }\n\n    private requireWritable(): void {\n        if (this.terminal || this.cancelled) {\n            throw new StreamTransportError('Cannot write after stream termination.');\n        }\n    }\n}\n"]}

package/src/ProxyClient.d.ts

@@ -1,8 +1,10 @@
 import { AuthMeta, DestinationTrust, RouteMetadata, LogApiCallImpl } from '@webpieces/core-util';
 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.
  *
@@ -127,6 +129,10 @@ export declare abstract class ProxyClient {
      * @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. */
+    protected abstract sendStreamingTransport(request: ClientRequest, signal: AbortSignal, body: ByteReadableStream): Promise<Response>;
     /**
      * Fires before the logical call's attempts, once per RPC — the progress "start marker". Symmetric with
      * {@link onRequestEnd}: every start is followed by exactly one end, on every path, so a listener
@@ -179,6 +185,14 @@ export declare abstract class ProxyClient {
     private refuseEndpointNoClientCanCall;
     /** One logical call: one lifecycle pair and log entry across all strategy attempts. */
     makeRequest(route: RouteMetadata, args: unknown[]): Promise<unknown>;
+    /** Open a typed stream without bypassing the ordinary context/auth/filter request pipeline. */
+    private makeStreamingRequest;
+    private responseStream;
+    /** One streaming handshake. Subsequent events stay on this established transport. */
+    private executeStreamingCall;
+    private openStreamingTransport;
+    /** Fresh filter-visible request metadata; the live request body is transport-owned. */
+    private prepareStreamingRequest;
     private executeCall;
     /** Fresh mutable request for every attempt, including URL, headers, auth and body. */
     private prepareRequest;
@@ -198,6 +212,8 @@ export declare abstract class ProxyClient {
      * will, rather than a raw platform reject.
      */
     private sendOnce;
+    /** Node fetch's streaming upload option. Browser callers are refused before reaching here. */
+    private sendStreamingOnce;
     /** Body consumption is inside the attempt deadline, including non-JSON error bodies. */
     private readResponse;
     /** Preserve empty, JSON, and protocol text bodies for caller-owned full responses. */

package/src/ProxyClient.js

@@ -7,6 +7,17 @@ const ClientErrorTranslator_1 = require("./ClientErrorTranslator");
 const HttpResponseDtoFactory_1 = require("./HttpResponseDtoFactory");
 const RequestOutcome_1 = require("./RequestOutcome");
 const ResponseBodyReader_1 = require("./ResponseBodyReader");
+const NdjsonRequestStream_1 = require("./NdjsonRequestStream");
+const SseResponseStream_1 = require("./SseResponseStream");
+const StreamingCapabilityError_1 = require("./StreamingCapabilityError");
+class OpenedStreamingTransport {
+    response;
+    upload;
+    constructor(response, upload) {
+        this.response = response;
+        this.upload = upload;
+    }
+}
 /**
  * ProxyClient - the HTTP call engine behind one API contract's client proxy.
  *
@@ -216,10 +227,95 @@ class ProxyClient {
     // webpieces-disable no-any-unknown -- request and response DTOs are erased at the proxy boundary
     async makeRequest(route, args) {
         this.refuseEndpointNoClientCanCall(route);
+        if (route.streaming)
+            return this.makeStreamingRequest(route, args);
         const mapped = core_util_1.HttpContractMapper.toWire(route.path, route.parameterBindings, route.bodyParameterIndex, args);
         const logValue = mapped.body === undefined ? args : mapped.body;
         return this.execute(route, logValue, () => this.executeCall(route, args));
     }
+    /** Open a typed stream without bypassing the ordinary context/auth/filter request pipeline. */
+    // webpieces-disable no-any-unknown -- generated proxy arguments are runtime-validated here
+    async makeStreamingRequest(route, args) {
+        if (!this.supportsConcurrentDuplexFetch()) {
+            throw new StreamingCapabilityError_1.StreamingCapabilityError('browser', 'Fetch request streaming is half-duplex and has no protocol-compatible full-duplex fallback.');
+        }
+        const destination = this.responseStream(args);
+        return this.execute(route, 'stream-open', () => this.executeStreamingCall(route, destination));
+    }
+    // webpieces-disable no-any-unknown -- generated proxy arguments are runtime-validated here
+    responseStream(args) {
+        const candidate = args[0];
+        if (args.length !== 1 || typeof candidate !== 'object' || candidate === null) {
+            throw new core_util_1.StreamTransportError(`${this.apiName} streaming methods require exactly one ResponseStream argument.`);
+        }
+        // webpieces-disable no-any-unknown -- reflected method argument is narrowed by the method checks below
+        const record = candidate;
+        if (typeof record['event'] !== 'function' ||
+            typeof record['fail'] !== 'function' ||
+            typeof record['complete'] !== 'function' ||
+            typeof record['onCancel'] !== 'function') {
+            throw new core_util_1.StreamTransportError(`${this.apiName} streaming method argument does not implement ResponseStream.`);
+        }
+        return candidate;
+    }
+    /** One streaming handshake. Subsequent events stay on this established transport. */
+    async executeStreamingCall(route, destination) {
+        this.onRequestStart(route);
+        let response;
+        // eslint-disable-next-line @webpieces/no-unmanaged-exceptions -- lifecycle reports the original handshake failure
+        try {
+            const requestStream = await core_util_1.CallRegistry.execute(this.apiClass, route.methodName, (timeoutMs) => core_util_1.CallDeadline.run(timeoutMs, new core_util_1.CallContext(this.apiName, route.methodName), async (deadlineSignal) => {
+                const result = await this.openStreamingTransport(route, destination, deadlineSignal);
+                response = result.response;
+                return result.upload;
+            }), 30_000);
+            this.onRequestEnd(route, new RequestOutcome_1.RequestOutcome(true, response?.status ?? 0, response?.headers));
+            return requestStream;
+        }
+        catch (err) {
+            const error = (0, core_util_1.toError)(err);
+            this.onRequestEnd(route, new RequestOutcome_1.RequestOutcome(false, response?.status ?? 0, response?.headers, error));
+            throw err;
+        }
+    }
+    async openStreamingTransport(route, destination, deadlineSignal) {
+        const metadata = route.streaming;
+        if (!metadata)
+            throw new core_util_1.StreamTransportError('Streaming metadata disappeared.');
+        const request = await this.prepareStreamingRequest(route);
+        const controller = new AbortController();
+        deadlineSignal.addEventListener('abort', () => controller.abort(), { once: true });
+        const upload = new NdjsonRequestStream_1.NdjsonRequestStream(metadata, 
+        // webpieces-disable no-any-unknown -- AbortController accepts a platform-defined cancellation reason
+        (reason) => controller.abort(reason));
+        const response = await this.chain.execute(request, () => this.sendStreamingOnce(request, controller.signal, upload.body));
+        if (!response.ok) {
+            await upload.transportFailed(new core_util_1.StreamTransportError(`Streaming handshake failed with HTTP ${response.status}.`));
+            await this.readResponse(response, route);
+            throw new core_util_1.StreamTransportError('Streaming handshake was rejected.');
+        }
+        const contentType = response.headers.get('content-type') ?? '';
+        if (!contentType.toLowerCase().startsWith('text/event-stream')) {
+            const error = new core_util_1.StreamTransportError(`Streaming response requires text/event-stream, received '${contentType || 'missing'}'.`);
+            await upload.transportFailed(error);
+            throw error;
+        }
+        void new SseResponseStream_1.SseResponseStream()
+            .consume(response, destination, metadata, upload)
+            .catch(() => undefined);
+        return new OpenedStreamingTransport(response, upload);
+    }
+    /** Fresh filter-visible request metadata; the live request body is transport-owned. */
+    async prepareStreamingRequest(route) {
+        const baseUrl = await this.resolveBaseUrl();
+        const headers = new Map();
+        headers.set('Content-Type', 'application/x-ndjson');
+        headers.set('Accept', 'text/event-stream');
+        const context = this.outboundContextHeaders(core_util_1.DestinationTrust.forAuthMode(route.authMeta?.mode));
+        for (const entry of context.entries())
+            headers.set(entry[0], entry[1]);
+        return new ClientRequest_1.ClientRequest(route, this.apiName, baseUrl, headers, undefined, undefined);
+    }
     // webpieces-disable no-any-unknown -- response DTO is erased at the proxy boundary
     async executeCall(route, args) {
         this.onRequestStart(route);
@@ -329,6 +425,18 @@ class ProxyClient {
             throw this.networkRejectClassifier.toNetworkError(error, request.url);
         }
     }
+    /** Node fetch's streaming upload option. Browser callers are refused before reaching here. */
+    async sendStreamingOnce(request, signal, body) {
+        core_util_1.CallDeadline.throwIfAborted(signal);
+        // eslint-disable-next-line @webpieces/no-unmanaged-exceptions -- platform rejects are normalized below
+        try {
+            return await this.sendStreamingTransport(request, signal, body);
+        }
+        catch (err) {
+            const error = (0, core_util_1.toError)(err);
+            throw this.networkRejectClassifier.toNetworkError(error, request.url);
+        }
+    }
     /** Body consumption is inside the attempt deadline, including non-JSON error bodies. */
     // webpieces-disable no-any-unknown -- response DTO is erased at the proxy boundary
     async readResponse(response, route) {

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} 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';\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`\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    /**\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        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        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    // 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    /** 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 { 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`\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        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"]}

package/src/SseEventParser.d.ts

@@ -0,0 +1,17 @@
+/** One fully delimited Server-Sent Event. `data:` fields are joined with a newline. */
+export declare class SseEvent {
+    readonly data: string;
+    readonly event?: string | undefined;
+    constructor(data: string, event?: string | undefined);
+}
+/** Incremental SSE parser. It deliberately ignores comments, id, retry and unknown fields. */
+export declare class SseEventParser {
+    private readonly decoder;
+    private buffered;
+    private eventName;
+    private dataLines;
+    feed(bytes: Uint8Array | string): SseEvent[];
+    finish(): SseEvent[];
+    private drainLines;
+    private acceptLine;
+}

package/src/SseEventParser.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SseEventParser = exports.SseEvent = void 0;
+const core_util_1 = require("@webpieces/core-util");
+const Utf8Codec_1 = require("./Utf8Codec");
+/** One fully delimited Server-Sent Event. `data:` fields are joined with a newline. */
+class SseEvent {
+    data;
+    event;
+    constructor(data, event) {
+        this.data = data;
+        this.event = event;
+    }
+}
+exports.SseEvent = SseEvent;
+/** Incremental SSE parser. It deliberately ignores comments, id, retry and unknown fields. */
+class SseEventParser {
+    decoder = new Utf8Codec_1.Utf8Codec();
+    buffered = '';
+    eventName;
+    dataLines = [];
+    feed(bytes) {
+        this.buffered += typeof bytes === 'string' ? bytes : this.decoder.decode(bytes, true);
+        return this.drainLines(false);
+    }
+    finish() {
+        this.buffered += this.decoder.decode(undefined, false);
+        return this.drainLines(true);
+    }
+    drainLines(finished) {
+        const events = [];
+        let newline = this.buffered.indexOf('\n');
+        while (newline >= 0) {
+            const rawLine = this.buffered.slice(0, newline);
+            this.buffered = this.buffered.slice(newline + 1);
+            this.acceptLine(rawLine.endsWith('\r') ? rawLine.slice(0, -1) : rawLine, events);
+            newline = this.buffered.indexOf('\n');
+        }
+        if (finished && this.buffered !== '') {
+            const rawLine = this.buffered;
+            this.buffered = '';
+            this.acceptLine(rawLine.endsWith('\r') ? rawLine.slice(0, -1) : rawLine, events);
+        }
+        if (finished && this.dataLines.length > 0) {
+            throw new core_util_1.StreamTransportError('SSE response ended in the middle of an event.');
+        }
+        return events;
+    }
+    acceptLine(line, events) {
+        if (line === '') {
+            if (this.dataLines.length > 0) {
+                events.push(new SseEvent(this.dataLines.join('\n'), this.eventName));
+            }
+            this.dataLines = [];
+            this.eventName = undefined;
+            return;
+        }
+        if (line.startsWith(':'))
+            return;
+        const separator = line.indexOf(':');
+        const field = separator < 0 ? line : line.slice(0, separator);
+        let value = separator < 0 ? '' : line.slice(separator + 1);
+        if (value.startsWith(' '))
+            value = value.slice(1);
+        if (field === 'data')
+            this.dataLines.push(value);
+        if (field === 'event')
+            this.eventName = value;
+    }
+}
+exports.SseEventParser = SseEventParser;
+//# sourceMappingURL=SseEventParser.js.map

package/src/SseEventParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SseEventParser.js","sourceRoot":"","sources":["../../../../../packages/http/http-client-core/src/SseEventParser.ts"],"names":[],"mappings":"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","sourcesContent":["import { StreamTransportError } from '@webpieces/core-util';\nimport { Utf8Codec } from './Utf8Codec';\n\n/** One fully delimited Server-Sent Event. `data:` fields are joined with a newline. */\nexport class SseEvent {\n    constructor(\n        public readonly data: string,\n        public readonly event?: string,\n    ) {}\n}\n\n/** Incremental SSE parser. It deliberately ignores comments, id, retry and unknown fields. */\nexport class SseEventParser {\n    private readonly decoder = new Utf8Codec();\n    private buffered = '';\n    private eventName: string | undefined;\n    private dataLines: string[] = [];\n\n    feed(bytes: Uint8Array | string): SseEvent[] {\n        this.buffered += typeof bytes === 'string' ? bytes : this.decoder.decode(bytes, true);\n        return this.drainLines(false);\n    }\n\n    finish(): SseEvent[] {\n        this.buffered += this.decoder.decode(undefined, false);\n        return this.drainLines(true);\n    }\n\n    private drainLines(finished: boolean): SseEvent[] {\n        const events: SseEvent[] = [];\n        let newline = this.buffered.indexOf('\\n');\n        while (newline >= 0) {\n            const rawLine = this.buffered.slice(0, newline);\n            this.buffered = this.buffered.slice(newline + 1);\n            this.acceptLine(rawLine.endsWith('\\r') ? rawLine.slice(0, -1) : rawLine, events);\n            newline = this.buffered.indexOf('\\n');\n        }\n        if (finished && this.buffered !== '') {\n            const rawLine = this.buffered;\n            this.buffered = '';\n            this.acceptLine(rawLine.endsWith('\\r') ? rawLine.slice(0, -1) : rawLine, events);\n        }\n        if (finished && this.dataLines.length > 0) {\n            throw new StreamTransportError('SSE response ended in the middle of an event.');\n        }\n        return events;\n    }\n\n    private acceptLine(line: string, events: SseEvent[]): void {\n        if (line === '') {\n            if (this.dataLines.length > 0) {\n                events.push(new SseEvent(this.dataLines.join('\\n'), this.eventName));\n            }\n            this.dataLines = [];\n            this.eventName = undefined;\n            return;\n        }\n        if (line.startsWith(':')) return;\n        const separator = line.indexOf(':');\n        const field = separator < 0 ? line : line.slice(0, separator);\n        let value = separator < 0 ? '' : line.slice(separator + 1);\n        if (value.startsWith(' ')) value = value.slice(1);\n        if (field === 'data') this.dataLines.push(value);\n        if (field === 'event') this.eventName = value;\n    }\n}\n"]}

package/src/SseResponseStream.d.ts

@@ -0,0 +1,9 @@
+import { DtoValue, ResponseStream, StreamingEndpointMetadata } from '@webpieces/core-util';
+import { NdjsonRequestStream } from './NdjsonRequestStream';
+/** Consumes generic Webpieces stream envelopes from one request-scoped SSE response. */
+export declare class SseResponseStream {
+    private readonly validator;
+    consume(response: Response, destination: ResponseStream<DtoValue>, metadata: StreamingEndpointMetadata, requestStream: NdjsonRequestStream): Promise<void>;
+    private dispatchAll;
+    private transportFailure;
+}

package/src/SseResponseStream.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SseResponseStream = void 0;
+const core_util_1 = require("@webpieces/core-util");
+const SseEventParser_1 = require("./SseEventParser");
+const StreamEnvelopeCodec_1 = require("./StreamEnvelopeCodec");
+/** Consumes generic Webpieces stream envelopes from one request-scoped SSE response. */
+class SseResponseStream {
+    validator = new core_util_1.StreamEventValidator();
+    async consume(response, destination, metadata, requestStream) {
+        const body = response.body;
+        if (!body) {
+            await this.transportFailure(new core_util_1.StreamTransportError('Streaming response has no readable body.'), destination, requestStream);
+            return;
+        }
+        const parser = new SseEventParser_1.SseEventParser();
+        const reader = body.getReader();
+        let terminated = false;
+        // eslint-disable-next-line @webpieces/no-unmanaged-exceptions -- all wire/reader failures are translated below
+        try {
+            while (!terminated) {
+                const part = await reader.read();
+                if (part.done)
+                    break;
+                terminated = await this.dispatchAll(parser.feed(part.value), destination, metadata);
+            }
+            if (!terminated) {
+                terminated = await this.dispatchAll(parser.finish(), destination, metadata);
+            }
+            if (!terminated) {
+                throw new core_util_1.StreamTransportError('SSE response closed before a terminal failure or complete envelope.');
+            }
+        }
+        catch (err) {
+            const error = (0, core_util_1.toError)(err);
+            const transportError = error instanceof core_util_1.StreamTransportError
+                ? error
+                : new core_util_1.StreamTransportError('SSE response transport failed.', undefined, undefined, error);
+            await this.transportFailure(transportError, destination, requestStream);
+        }
+        finally {
+            reader.releaseLock();
+        }
+    }
+    async dispatchAll(events, destination, metadata) {
+        for (const event of events) {
+            if (event.event !== undefined && event.event !== 'message')
+                continue;
+            const envelope = StreamEnvelopeCodec_1.StreamEnvelopeCodec.decode(event.data);
+            if (envelope.kind === 'event') {
+                this.validator.validate(metadata.responseEventClass, envelope.value, 'response');
+                await destination.event(envelope.value, envelope.correlation);
+                continue;
+            }
+            if (envelope.kind === 'failure') {
+                const error = core_util_1.ApiErrorCodec.decode(envelope.error);
+                await destination.fail(error, envelope.correlation, {
+                    terminal: envelope.terminal,
+                });
+                if (envelope.terminal)
+                    return true;
+                continue;
+            }
+            await destination.complete();
+            return true;
+        }
+        return false;
+    }
+    async transportFailure(error, destination, requestStream) {
+        await requestStream.transportFailed(error);
+        await destination.fail(error, error.correlation, { terminal: true });
+    }
+}
+exports.SseResponseStream = SseResponseStream;
+//# sourceMappingURL=SseResponseStream.js.map

package/src/SseResponseStream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SseResponseStream.js","sourceRoot":"","sources":["../../../../../packages/http/http-client-core/src/SseResponseStream.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n    ApiErrorCodec,\n    DtoValue,\n    ResponseStream,\n    StreamEventValidator,\n    StreamingEndpointMetadata,\n    StreamTransportError,\n    toError,\n} from '@webpieces/core-util';\nimport { NdjsonRequestStream } from './NdjsonRequestStream';\nimport { SseEvent, SseEventParser } from './SseEventParser';\nimport { StreamEnvelopeCodec } from './StreamEnvelopeCodec';\n\n/** Consumes generic Webpieces stream envelopes from one request-scoped SSE response. */\nexport class SseResponseStream {\n    private readonly validator = new StreamEventValidator();\n\n    async consume(\n        response: Response,\n        destination: ResponseStream<DtoValue>,\n        metadata: StreamingEndpointMetadata,\n        requestStream: NdjsonRequestStream,\n    ): Promise<void> {\n        const body = response.body;\n        if (!body) {\n            await this.transportFailure(\n                new StreamTransportError('Streaming response has no readable body.'),\n                destination,\n                requestStream,\n            );\n            return;\n        }\n        const parser = new SseEventParser();\n        const reader = body.getReader();\n        let terminated = false;\n        // eslint-disable-next-line @webpieces/no-unmanaged-exceptions -- all wire/reader failures are translated below\n        try {\n            while (!terminated) {\n                const part = await reader.read();\n                if (part.done) break;\n                terminated = await this.dispatchAll(parser.feed(part.value), destination, metadata);\n            }\n            if (!terminated) {\n                terminated = await this.dispatchAll(parser.finish(), destination, metadata);\n            }\n            if (!terminated) {\n                throw new StreamTransportError(\n                    'SSE response closed before a terminal failure or complete envelope.',\n                );\n            }\n        } catch (err: unknown) {\n            const error = toError(err);\n            const transportError =\n                error instanceof StreamTransportError\n                    ? error\n                    : new StreamTransportError(\n                          'SSE response transport failed.',\n                          undefined,\n                          undefined,\n                          error,\n                      );\n            await this.transportFailure(transportError, destination, requestStream);\n        } finally {\n            reader.releaseLock();\n        }\n    }\n\n    private async dispatchAll(\n        events: readonly SseEvent[],\n        destination: ResponseStream<DtoValue>,\n        metadata: StreamingEndpointMetadata,\n    ): Promise<boolean> {\n        for (const event of events) {\n            if (event.event !== undefined && event.event !== 'message') continue;\n            const envelope = StreamEnvelopeCodec.decode(event.data);\n            if (envelope.kind === 'event') {\n                this.validator.validate(metadata.responseEventClass, envelope.value, 'response');\n                await destination.event(envelope.value as DtoValue, envelope.correlation);\n                continue;\n            }\n            if (envelope.kind === 'failure') {\n                const error = ApiErrorCodec.decode(envelope.error);\n                await destination.fail(error, envelope.correlation, {\n                    terminal: envelope.terminal,\n                });\n                if (envelope.terminal) return true;\n                continue;\n            }\n            await destination.complete();\n            return true;\n        }\n        return false;\n    }\n\n    private async transportFailure(\n        error: StreamTransportError,\n        destination: ResponseStream<DtoValue>,\n        requestStream: NdjsonRequestStream,\n    ): Promise<void> {\n        await requestStream.transportFailed(error);\n        await destination.fail(error, error.correlation, { terminal: true });\n    }\n}\n"]}

package/src/StreamEnvelopeCodec.d.ts

@@ -0,0 +1,7 @@
+import { DtoValue, StreamEnvelope } from '@webpieces/core-util';
+/** Strict JSON codec shared by the NDJSON request writer and SSE response reader. */
+export declare class StreamEnvelopeCodec {
+    static encode(envelope: StreamEnvelope<DtoValue>): string;
+    static decode(json: string): StreamEnvelope<DtoValue>;
+    private static correlation;
+}

package/src/StreamEnvelopeCodec.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StreamEnvelopeCodec = void 0;
+const core_util_1 = require("@webpieces/core-util");
+/** Strict JSON codec shared by the NDJSON request writer and SSE response reader. */
+class StreamEnvelopeCodec {
+    // webpieces-disable no-function-outside-class -- stateless wire codec shared by client transports
+    static encode(envelope) {
+        return JSON.stringify(envelope);
+    }
+    // webpieces-disable no-function-outside-class -- stateless public wire codec; webpieces-disable no-any-unknown -- JSON.parse is narrowed below before it crosses the boundary
+    static decode(json) {
+        let value;
+        // eslint-disable-next-line @webpieces/no-unmanaged-exceptions -- malformed wire data is translated to a typed transport error
+        try {
+            // webpieces-disable no-any-unknown -- JSON.parse result is narrowed immediately below
+            value = JSON.parse(json);
+        }
+        catch (err) {
+            const error = (0, core_util_1.toError)(err);
+            throw new core_util_1.StreamTransportError('Stream frame is not valid JSON.', undefined, undefined, error);
+        }
+        if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+            throw new core_util_1.StreamTransportError('Stream frame must be a JSON object.');
+        }
+        // webpieces-disable no-any-unknown -- validated object remains an untrusted field bag until each field check
+        const record = value;
+        const kind = record['kind'];
+        if (kind !== 'event' && kind !== 'failure' && kind !== 'complete') {
+            throw new core_util_1.StreamTransportError('Stream frame has an invalid kind.');
+        }
+        const correlation = this.correlation(record['correlation']);
+        if (kind === 'event') {
+            return new core_util_1.StreamEnvelope('event', record['value'], undefined, correlation);
+        }
+        if (kind === 'complete')
+            return new core_util_1.StreamEnvelope('complete');
+        if (!core_util_1.ApiErrorCodec.isPayload(record['error'])) {
+            throw new core_util_1.StreamTransportError('Failure stream frame has no valid Webpieces error payload.', correlation);
+        }
+        if (typeof record['terminal'] !== 'boolean') {
+            throw new core_util_1.StreamTransportError('Failure stream frame must declare its terminal disposition.', correlation);
+        }
+        return new core_util_1.StreamEnvelope('failure', undefined, record['error'], correlation, record['terminal']);
+    }
+    // webpieces-disable no-function-outside-class -- private stateless wire-field validator; webpieces-disable no-any-unknown -- correlation is untrusted until narrowed here
+    static correlation(value) {
+        if (value === undefined)
+            return undefined;
+        if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+            throw new core_util_1.StreamTransportError('Stream correlation must be an object.');
+        }
+        // webpieces-disable no-any-unknown -- validated object remains untrusted until both fields are checked
+        const record = value;
+        const key = record['key'];
+        const requestId = record['requestId'];
+        if (typeof key !== 'string' && typeof key !== 'number') {
+            throw new core_util_1.StreamTransportError('Stream correlation key must be a string or number.');
+        }
+        if (requestId !== undefined && typeof requestId !== 'string') {
+            throw new core_util_1.StreamTransportError('Stream correlation requestId must be a string.');
+        }
+        return new core_util_1.StreamCorrelation(key, requestId);
+    }
+}
+exports.StreamEnvelopeCodec = StreamEnvelopeCodec;
+//# sourceMappingURL=StreamEnvelopeCodec.js.map

package/src/StreamEnvelopeCodec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StreamEnvelopeCodec.js","sourceRoot":"","sources":["../../../../../packages/http/http-client-core/src/StreamEnvelopeCodec.ts"],"names":[],"mappings":";;;AAAA,oDAQ8B;AAE9B,qFAAqF;AACrF,MAAa,mBAAmB;IAC5B,kGAAkG;IAClG,MAAM,CAAC,MAAM,CAAC,QAAkC;QAC5C,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC;IAED,8KAA8K;IAC9K,MAAM,CAAC,MAAM,CAAC,IAAY;QACtB,IAAI,KAAc,CAAC;QACnB,8HAA8H;QAC9H,IAAI,CAAC;YACD,sFAAsF;YACtF,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAY,CAAC;QACxC,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACpB,MAAM,KAAK,GAAG,IAAA,mBAAO,EAAC,GAAG,CAAC,CAAC;YAC3B,MAAM,IAAI,gCAAoB,CAC1B,iCAAiC,EACjC,SAAS,EACT,SAAS,EACT,KAAK,CACR,CAAC;QACN,CAAC;QACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACtE,MAAM,IAAI,gCAAoB,CAAC,qCAAqC,CAAC,CAAC;QAC1E,CAAC;QACD,6GAA6G;QAC7G,MAAM,MAAM,GAAG,KAAgC,CAAC;QAChD,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;QAC5B,IAAI,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;YAChE,MAAM,IAAI,gCAAoB,CAAC,mCAAmC,CAAC,CAAC;QACxE,CAAC;QACD,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC;QAC5D,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;YACnB,OAAO,IAAI,0BAAc,CACrB,OAAO,EACP,MAAM,CAAC,OAAO,CAAa,EAC3B,SAAS,EACT,WAAW,CACd,CAAC;QACN,CAAC;QACD,IAAI,IAAI,KAAK,UAAU;YAAE,OAAO,IAAI,0BAAc,CAAW,UAAU,CAAC,CAAC;QACzE,IAAI,CAAC,yBAAa,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;YAC5C,MAAM,IAAI,gCAAoB,CAC1B,4DAA4D,EAC5D,WAAW,CACd,CAAC;QACN,CAAC;QACD,IAAI,OAAO,MAAM,CAAC,UAAU,CAAC,KAAK,SAAS,EAAE,CAAC;YAC1C,MAAM,IAAI,gCAAoB,CAC1B,6DAA6D,EAC7D,WAAW,CACd,CAAC;QACN,CAAC;QACD,OAAO,IAAI,0BAAc,CACrB,SAAS,EACT,SAAS,EACT,MAAM,CAAC,OAAO,CAAoB,EAClC,WAAW,EACX,MAAM,CAAC,UAAU,CAAC,CACrB,CAAC;IACN,CAAC;IAED,0KAA0K;IAClK,MAAM,CAAC,WAAW,CAAC,KAAc;QACrC,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QAC1C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACtE,MAAM,IAAI,gCAAoB,CAAC,uCAAuC,CAAC,CAAC;QAC5E,CAAC;QACD,uGAAuG;QACvG,MAAM,MAAM,GAAG,KAAgC,CAAC;QAChD,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC1B,MAAM,SAAS,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;QACtC,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YACrD,MAAM,IAAI,gCAAoB,CAAC,oDAAoD,CAAC,CAAC;QACzF,CAAC;QACD,IAAI,SAAS,KAAK,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;YAC3D,MAAM,IAAI,gCAAoB,CAAC,gDAAgD,CAAC,CAAC;QACrF,CAAC;QACD,OAAO,IAAI,6BAAiB,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IACjD,CAAC;CACJ;AAhFD,kDAgFC","sourcesContent":["import {\n    ApiErrorCodec,\n    ApiErrorPayload,\n    DtoValue,\n    StreamCorrelation,\n    StreamEnvelope,\n    StreamTransportError,\n    toError,\n} from '@webpieces/core-util';\n\n/** Strict JSON codec shared by the NDJSON request writer and SSE response reader. */\nexport class StreamEnvelopeCodec {\n    // webpieces-disable no-function-outside-class -- stateless wire codec shared by client transports\n    static encode(envelope: StreamEnvelope<DtoValue>): string {\n        return JSON.stringify(envelope);\n    }\n\n    // webpieces-disable no-function-outside-class -- stateless public wire codec; webpieces-disable no-any-unknown -- JSON.parse is narrowed below before it crosses the boundary\n    static decode(json: string): StreamEnvelope<DtoValue> {\n        let value: unknown;\n        // eslint-disable-next-line @webpieces/no-unmanaged-exceptions -- malformed wire data is translated to a typed transport error\n        try {\n            // webpieces-disable no-any-unknown -- JSON.parse result is narrowed immediately below\n            value = JSON.parse(json) as unknown;\n        } catch (err: unknown) {\n            const error = toError(err);\n            throw new StreamTransportError(\n                'Stream frame is not valid JSON.',\n                undefined,\n                undefined,\n                error,\n            );\n        }\n        if (typeof value !== 'object' || value === null || Array.isArray(value)) {\n            throw new StreamTransportError('Stream frame must be a JSON object.');\n        }\n        // webpieces-disable no-any-unknown -- validated object remains an untrusted field bag until each field check\n        const record = value as Record<string, unknown>;\n        const kind = record['kind'];\n        if (kind !== 'event' && kind !== 'failure' && kind !== 'complete') {\n            throw new StreamTransportError('Stream frame has an invalid kind.');\n        }\n        const correlation = this.correlation(record['correlation']);\n        if (kind === 'event') {\n            return new StreamEnvelope<DtoValue>(\n                'event',\n                record['value'] as DtoValue,\n                undefined,\n                correlation,\n            );\n        }\n        if (kind === 'complete') return new StreamEnvelope<DtoValue>('complete');\n        if (!ApiErrorCodec.isPayload(record['error'])) {\n            throw new StreamTransportError(\n                'Failure stream frame has no valid Webpieces error payload.',\n                correlation,\n            );\n        }\n        if (typeof record['terminal'] !== 'boolean') {\n            throw new StreamTransportError(\n                'Failure stream frame must declare its terminal disposition.',\n                correlation,\n            );\n        }\n        return new StreamEnvelope<DtoValue>(\n            'failure',\n            undefined,\n            record['error'] as ApiErrorPayload,\n            correlation,\n            record['terminal'],\n        );\n    }\n\n    // webpieces-disable no-function-outside-class -- private stateless wire-field validator; webpieces-disable no-any-unknown -- correlation is untrusted until narrowed here\n    private static correlation(value: unknown): StreamCorrelation | undefined {\n        if (value === undefined) return undefined;\n        if (typeof value !== 'object' || value === null || Array.isArray(value)) {\n            throw new StreamTransportError('Stream correlation must be an object.');\n        }\n        // webpieces-disable no-any-unknown -- validated object remains untrusted until both fields are checked\n        const record = value as Record<string, unknown>;\n        const key = record['key'];\n        const requestId = record['requestId'];\n        if (typeof key !== 'string' && typeof key !== 'number') {\n            throw new StreamTransportError('Stream correlation key must be a string or number.');\n        }\n        if (requestId !== undefined && typeof requestId !== 'string') {\n            throw new StreamTransportError('Stream correlation requestId must be a string.');\n        }\n        return new StreamCorrelation(key, requestId);\n    }\n}\n"]}

package/src/StreamingCapabilityError.d.ts

@@ -0,0 +1,5 @@
+import { StreamTransportError } from '@webpieces/core-util';
+/** Raised before opening a stream when the runtime cannot safely do bidirectional fetch. */
+export declare class StreamingCapabilityError extends StreamTransportError {
+    constructor(runtime: 'browser' | 'node', detail: string, options?: ErrorOptions);
+}

package/src/StreamingCapabilityError.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StreamingCapabilityError = void 0;
+const core_util_1 = require("@webpieces/core-util");
+/** Raised before opening a stream when the runtime cannot safely do bidirectional fetch. */
+class StreamingCapabilityError extends core_util_1.StreamTransportError {
+    constructor(runtime, detail, options) {
+        super(`${runtime} cannot open this typed duplex HTTP stream: ${detail} ` +
+            'The transport requires a streaming NDJSON request body and a concurrently readable SSE response.', undefined, undefined, options?.cause instanceof Error ? options.cause : undefined);
+    }
+}
+exports.StreamingCapabilityError = StreamingCapabilityError;
+//# sourceMappingURL=StreamingCapabilityError.js.map

package/src/StreamingCapabilityError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StreamingCapabilityError.js","sourceRoot":"","sources":["../../../../../packages/http/http-client-core/src/StreamingCapabilityError.ts"],"names":[],"mappings":";;;AAAA,oDAA4D;AAE5D,4FAA4F;AAC5F,MAAa,wBAAyB,SAAQ,gCAAoB;IAC9D,YAAY,OAA2B,EAAE,MAAc,EAAE,OAAsB;QAC3E,KAAK,CACD,GAAG,OAAO,+CAA+C,MAAM,GAAG;YAC9D,kGAAkG,EACtG,SAAS,EACT,SAAS,EACT,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAC9D,CAAC;IACN,CAAC;CACJ;AAVD,4DAUC","sourcesContent":["import { StreamTransportError } from '@webpieces/core-util';\n\n/** Raised before opening a stream when the runtime cannot safely do bidirectional fetch. */\nexport class StreamingCapabilityError extends StreamTransportError {\n    constructor(runtime: 'browser' | 'node', detail: string, options?: ErrorOptions) {\n        super(\n            `${runtime} cannot open this typed duplex HTTP stream: ${detail} ` +\n                'The transport requires a streaming NDJSON request body and a concurrently readable SSE response.',\n            undefined,\n            undefined,\n            options?.cause instanceof Error ? options.cause : undefined,\n        );\n    }\n}\n"]}

package/src/Utf8Codec.d.ts

@@ -0,0 +1,6 @@
+/** Small dependency-free UTF-8 codec for browser, Node, and React Native bundles. */
+export declare class Utf8Codec {
+    private pending;
+    encode(value: string): Uint8Array;
+    decode(bytes?: Uint8Array, stream?: boolean): string;
+}

package/src/Utf8Codec.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Utf8Codec = void 0;
+/** Small dependency-free UTF-8 codec for browser, Node, and React Native bundles. */
+class Utf8Codec {
+    pending = [];
+    encode(value) {
+        const bytes = [];
+        for (const character of value) {
+            const point = character.codePointAt(0) ?? 0;
+            if (point <= 0x7f) {
+                bytes.push(point);
+            }
+            else if (point <= 0x7ff) {
+                bytes.push(0xc0 | (point >> 6), 0x80 | (point & 0x3f));
+            }
+            else if (point <= 0xffff) {
+                bytes.push(0xe0 | (point >> 12), 0x80 | ((point >> 6) & 0x3f), 0x80 | (point & 0x3f));
+            }
+            else {
+                bytes.push(0xf0 | (point >> 18), 0x80 | ((point >> 12) & 0x3f), 0x80 | ((point >> 6) & 0x3f), 0x80 | (point & 0x3f));
+            }
+        }
+        return Uint8Array.from(bytes);
+    }
+    decode(bytes, stream = false) {
+        const input = [...this.pending, ...(bytes ?? [])];
+        this.pending = [];
+        let output = '';
+        let index = 0;
+        while (index < input.length) {
+            const first = input[index];
+            const length = first <= 0x7f
+                ? 1
+                : first >= 0xc2 && first <= 0xdf
+                    ? 2
+                    : first >= 0xe0 && first <= 0xef
+                        ? 3
+                        : first >= 0xf0 && first <= 0xf4
+                            ? 4
+                            : 0;
+            if (length === 0) {
+                output += '\ufffd';
+                index++;
+                continue;
+            }
+            if (index + length > input.length) {
+                if (stream)
+                    this.pending = input.slice(index);
+                else
+                    output += '\ufffd';
+                break;
+            }
+            let point = length === 1 ? first : first & (0x7f >> length);
+            let valid = true;
+            for (let offset = 1; offset < length; offset++) {
+                const continuation = input[index + offset];
+                if ((continuation & 0xc0) !== 0x80) {
+                    valid = false;
+                    break;
+                }
+                point = (point << 6) | (continuation & 0x3f);
+            }
+            const minimum = length === 1 ? 0 : length === 2 ? 0x80 : length === 3 ? 0x800 : 0x10000;
+            if (!valid ||
+                point < minimum ||
+                point > 0x10ffff ||
+                (point >= 0xd800 && point <= 0xdfff)) {
+                output += '\ufffd';
+                index++;
+                continue;
+            }
+            output += String.fromCodePoint(point);
+            index += length;
+        }
+        return output;
+    }
+}
+exports.Utf8Codec = Utf8Codec;
+//# sourceMappingURL=Utf8Codec.js.map

package/src/Utf8Codec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Utf8Codec.js","sourceRoot":"","sources":["../../../../../packages/http/http-client-core/src/Utf8Codec.ts"],"names":[],"mappings":"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","sourcesContent":["/** Small dependency-free UTF-8 codec for browser, Node, and React Native bundles. */\nexport class Utf8Codec {\n    private pending: number[] = [];\n\n    encode(value: string): Uint8Array {\n        const bytes: number[] = [];\n        for (const character of value) {\n            const point = character.codePointAt(0) ?? 0;\n            if (point <= 0x7f) {\n                bytes.push(point);\n            } else if (point <= 0x7ff) {\n                bytes.push(0xc0 | (point >> 6), 0x80 | (point & 0x3f));\n            } else if (point <= 0xffff) {\n                bytes.push(\n                    0xe0 | (point >> 12),\n                    0x80 | ((point >> 6) & 0x3f),\n                    0x80 | (point & 0x3f),\n                );\n            } else {\n                bytes.push(\n                    0xf0 | (point >> 18),\n                    0x80 | ((point >> 12) & 0x3f),\n                    0x80 | ((point >> 6) & 0x3f),\n                    0x80 | (point & 0x3f),\n                );\n            }\n        }\n        return Uint8Array.from(bytes);\n    }\n\n    decode(bytes?: Uint8Array, stream = false): string {\n        const input = [...this.pending, ...(bytes ?? [])];\n        this.pending = [];\n        let output = '';\n        let index = 0;\n        while (index < input.length) {\n            const first = input[index];\n            const length =\n                first <= 0x7f\n                    ? 1\n                    : first >= 0xc2 && first <= 0xdf\n                      ? 2\n                      : first >= 0xe0 && first <= 0xef\n                        ? 3\n                        : first >= 0xf0 && first <= 0xf4\n                          ? 4\n                          : 0;\n            if (length === 0) {\n                output += '\\ufffd';\n                index++;\n                continue;\n            }\n            if (index + length > input.length) {\n                if (stream) this.pending = input.slice(index);\n                else output += '\\ufffd';\n                break;\n            }\n            let point = length === 1 ? first : first & (0x7f >> length);\n            let valid = true;\n            for (let offset = 1; offset < length; offset++) {\n                const continuation = input[index + offset];\n                if ((continuation & 0xc0) !== 0x80) {\n                    valid = false;\n                    break;\n                }\n                point = (point << 6) | (continuation & 0x3f);\n            }\n            const minimum = length === 1 ? 0 : length === 2 ? 0x80 : length === 3 ? 0x800 : 0x10000;\n            if (\n                !valid ||\n                point < minimum ||\n                point > 0x10ffff ||\n                (point >= 0xd800 && point <= 0xdfff)\n            ) {\n                output += '\\ufffd';\n                index++;\n                continue;\n            }\n            output += String.fromCodePoint(point);\n            index += length;\n        }\n        return output;\n    }\n}\n"]}

package/src/index.d.ts

@@ -36,3 +36,10 @@ export { ResponseBodyReader } from './ResponseBodyReader';
 export { ClientRequest } from './ClientRequest';
 export { ClientFilterDefinition } from './ClientFilter';
 export type { ClientFilter } from './ClientFilter';
+export { NdjsonRequestStream } from './NdjsonRequestStream';
+export { SseEvent, SseEventParser } from './SseEventParser';
+export { SseResponseStream } from './SseResponseStream';
+export { StreamEnvelopeCodec } from './StreamEnvelopeCodec';
+export { StreamingCapabilityError } from './StreamingCapabilityError';
+export { Utf8Codec } from './Utf8Codec';
+export type { ByteReadableStream, ByteStreamReader, ByteReadResult } from './ByteStream';

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.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.TranslatedFailure = exports.HttpResponseDtoFactory = exports.UnexpectedApiResponseError = 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");
@@ -52,4 +52,19 @@ var ClientRequest_1 = require("./ClientRequest");
 Object.defineProperty(exports, "ClientRequest", { enumerable: true, get: function () { return ClientRequest_1.ClientRequest; } });
 var ClientFilter_1 = require("./ClientFilter");
 Object.defineProperty(exports, "ClientFilterDefinition", { enumerable: true, get: function () { return ClientFilter_1.ClientFilterDefinition; } });
+// Generic streaming wire adapters: NDJSON uploads, request-scoped SSE downloads, and a typed
+// capability failure for runtimes that cannot safely keep both fetch halves open concurrently.
+var NdjsonRequestStream_1 = require("./NdjsonRequestStream");
+Object.defineProperty(exports, "NdjsonRequestStream", { enumerable: true, get: function () { return NdjsonRequestStream_1.NdjsonRequestStream; } });
+var SseEventParser_1 = require("./SseEventParser");
+Object.defineProperty(exports, "SseEvent", { enumerable: true, get: function () { return SseEventParser_1.SseEvent; } });
+Object.defineProperty(exports, "SseEventParser", { enumerable: true, get: function () { return SseEventParser_1.SseEventParser; } });
+var SseResponseStream_1 = require("./SseResponseStream");
+Object.defineProperty(exports, "SseResponseStream", { enumerable: true, get: function () { return SseResponseStream_1.SseResponseStream; } });
+var StreamEnvelopeCodec_1 = require("./StreamEnvelopeCodec");
+Object.defineProperty(exports, "StreamEnvelopeCodec", { enumerable: true, get: function () { return StreamEnvelopeCodec_1.StreamEnvelopeCodec; } });
+var StreamingCapabilityError_1 = require("./StreamingCapabilityError");
+Object.defineProperty(exports, "StreamingCapabilityError", { enumerable: true, get: function () { return StreamingCapabilityError_1.StreamingCapabilityError; } });
+var Utf8Codec_1 = require("./Utf8Codec");
+Object.defineProperty(exports, "Utf8Codec", { enumerable: true, get: function () { return Utf8Codec_1.Utf8Codec; } });
 //# sourceMappingURL=index.js.map

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","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"]}
+{"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"]}