@webpieces/http-client-core 0.4.865 → 0.4.867

package/package.json

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

package/src/Wiring.d.ts

@@ -0,0 +1,15 @@
+/** Platform adapters supply their own module types; topology stays transport independent. */
+export interface Wiring<B, R> {
+    getBindingModules(): B[];
+    getRoutingModules(): R[];
+}
+/** Only applications select libraries. Libraries expose their own two module channels. */
+export interface AppWiring<B, R> extends Wiring<B, R> {
+    getWirings(): Wiring<B, R>[];
+}
+/** Ordered materialization preserves configured instances and repeated selections. */
+export declare class WiringModules<B, R> {
+    readonly bindingModules: B[];
+    readonly routingModules: R[];
+    constructor(app: AppWiring<B, R>);
+}

package/src/Wiring.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WiringModules = void 0;
+/** Ordered materialization preserves configured instances and repeated selections. */
+class WiringModules {
+    bindingModules;
+    routingModules;
+    constructor(app) {
+        this.bindingModules = [...app.getBindingModules()];
+        this.routingModules = [...app.getRoutingModules()];
+        const selected = new Map();
+        for (const library of app.getWirings()) {
+            let lists = selected.get(library);
+            if (lists === undefined) {
+                lists = new WiringLists(library.getBindingModules(), library.getRoutingModules());
+                selected.set(library, lists);
+            }
+            this.bindingModules.push(...lists.bindings);
+            this.routingModules.push(...lists.routes);
+        }
+    }
+}
+exports.WiringModules = WiringModules;
+class WiringLists {
+    bindings;
+    routes;
+    constructor(bindings, routes) {
+        this.bindings = bindings;
+        this.routes = routes;
+    }
+}
+//# sourceMappingURL=Wiring.js.map

package/src/Wiring.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Wiring.js","sourceRoot":"","sources":["../../../../../packages/http/http-client-core/src/Wiring.ts"],"names":[],"mappings":";;;AAWA,sFAAsF;AACtF,MAAa,aAAa;IACb,cAAc,CAAM;IACpB,cAAc,CAAM;IAE7B,YAAY,GAAoB;QAC5B,IAAI,CAAC,cAAc,GAAG,CAAC,GAAG,GAAG,CAAC,iBAAiB,EAAE,CAAC,CAAC;QACnD,IAAI,CAAC,cAAc,GAAG,CAAC,GAAG,GAAG,CAAC,iBAAiB,EAAE,CAAC,CAAC;QACnD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAmC,CAAC;QAC5D,KAAK,MAAM,OAAO,IAAI,GAAG,CAAC,UAAU,EAAE,EAAE,CAAC;YACrC,IAAI,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAClC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACtB,KAAK,GAAG,IAAI,WAAW,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;gBAClF,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YACjC,CAAC;YACD,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC;YAC5C,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;QAC9C,CAAC;IACL,CAAC;CACJ;AAlBD,sCAkBC;AAED,MAAM,WAAW;IACQ;IAAwB;IAA7C,YAAqB,QAAa,EAAW,MAAW;QAAnC,aAAQ,GAAR,QAAQ,CAAK;QAAW,WAAM,GAAN,MAAM,CAAK;IAAG,CAAC;CAC/D","sourcesContent":["/** Platform adapters supply their own module types; topology stays transport independent. */\nexport interface Wiring<B, R> {\n    getBindingModules(): B[];\n    getRoutingModules(): R[];\n}\n\n/** Only applications select libraries. Libraries expose their own two module channels. */\nexport interface AppWiring<B, R> extends Wiring<B, R> {\n    getWirings(): Wiring<B, R>[];\n}\n\n/** Ordered materialization preserves configured instances and repeated selections. */\nexport class WiringModules<B, R> {\n    readonly bindingModules: B[];\n    readonly routingModules: R[];\n\n    constructor(app: AppWiring<B, R>) {\n        this.bindingModules = [...app.getBindingModules()];\n        this.routingModules = [...app.getRoutingModules()];\n        const selected = new Map<Wiring<B, R>, WiringLists<B, R>>();\n        for (const library of app.getWirings()) {\n            let lists = selected.get(library);\n            if (lists === undefined) {\n                lists = new WiringLists(library.getBindingModules(), library.getRoutingModules());\n                selected.set(library, lists);\n            }\n            this.bindingModules.push(...lists.bindings);\n            this.routingModules.push(...lists.routes);\n        }\n    }\n}\n\nclass WiringLists<B, R> {\n    constructor(readonly bindings: B[], readonly routes: R[]) {}\n}\n"]}

package/src/index.d.ts

@@ -40,8 +40,8 @@ export { SseEvent, SseEventParser } from './SseEventParser';
 export { StreamingCapabilityError } from './StreamingCapabilityError';
 export { Utf8Codec } from './Utf8Codec';
 export type { ByteReadableStream, ByteStreamReader, ByteReadResult } from './ByteStream';
-export { rpcTarget } from './RpcTarget';
-export type { RpcTarget } from './RpcTarget';
+export type { Wiring, AppWiring } from './Wiring';
+export { WiringModules } from './Wiring';
 export { ClientToken } from './ClientToken';
 export { ExternalContractUse } from './ExternalContractUse';
 export { WiringPolicy } from './WiringPolicy';

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.WiringPolicy = exports.ExternalContractUse = exports.ClientToken = exports.rpcTarget = exports.Utf8Codec = exports.StreamingCapabilityError = exports.SseEventParser = exports.SseEvent = exports.ClientFilterDefinition = exports.ClientRequest = exports.ResponseBodyReader = exports.RequestBodySerializer = exports.HttpResponseDtoFactory = exports.ClientErrorTranslator = exports.buildClientProxy = exports.RequestOutcome = exports.ProxyClient = void 0;
+exports.WiringPolicy = exports.ExternalContractUse = exports.ClientToken = exports.WiringModules = exports.Utf8Codec = exports.StreamingCapabilityError = exports.SseEventParser = exports.SseEvent = exports.ClientFilterDefinition = exports.ClientRequest = exports.ResponseBodyReader = exports.RequestBodySerializer = exports.HttpResponseDtoFactory = exports.ClientErrorTranslator = exports.buildClientProxy = exports.RequestOutcome = exports.ProxyClient = void 0;
 var ProxyClient_1 = require("./ProxyClient");
 Object.defineProperty(exports, "ProxyClient", { enumerable: true, get: function () { return ProxyClient_1.ProxyClient; } });
 var RequestOutcome_1 = require("./RequestOutcome");
@@ -59,8 +59,8 @@ 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; } });
-var RpcTarget_1 = require("./RpcTarget");
-Object.defineProperty(exports, "rpcTarget", { enumerable: true, get: function () { return RpcTarget_1.rpcTarget; } });
+var Wiring_1 = require("./Wiring");
+Object.defineProperty(exports, "WiringModules", { enumerable: true, get: function () { return Wiring_1.WiringModules; } });
 var ClientToken_1 = require("./ClientToken");
 Object.defineProperty(exports, "ClientToken", { enumerable: true, get: function () { return ClientToken_1.ClientToken; } });
 var ExternalContractUse_1 = require("./ExternalContractUse");

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,gGAAgG;AAChG,iFAAiF;AACjF,mEAAkE;AAAzD,gIAAA,sBAAsB,OAAA;AAC/B,iEAAgE;AAAvD,8HAAA,qBAAqB,OAAA;AAC9B,2DAA0D;AAAjD,wHAAA,kBAAkB,OAAA;AAC3B,kGAAkG;AAClG,kFAAkF;AAClF,gEAAgE;AAChE,iDAAgD;AAAvC,8GAAA,aAAa,OAAA;AAEtB,+CAAwD;AAA/C,sHAAA,sBAAsB,OAAA;AAE/B,6FAA6F;AAC7F,+FAA+F;AAC/F,mDAA4D;AAAnD,0GAAA,QAAQ,OAAA;AAAE,gHAAA,cAAc,OAAA;AACjC,uEAAsE;AAA7D,oIAAA,wBAAwB,OAAA;AACjC,yCAAwC;AAA/B,sGAAA,SAAS,OAAA;AAGlB,yCAAwC;AAA/B,sGAAA,SAAS,OAAA;AAElB,6CAA4C;AAAnC,0GAAA,WAAW,OAAA;AACpB,6DAA4D;AAAnD,0HAAA,mBAAmB,OAAA;AAC5B,+CAA8C;AAArC,4GAAA,YAAY,OAAA","sourcesContent":["/**\n * @webpieces/http-client-core\n *\n * The ISOMORPHIC core of the webpieces HTTP client — everything that reads an API contract's\n * decorators and turns a method call into an HTTP request, with no opinion about where the\n * magic context comes from or whether a DI container exists.\n *\n * You almost certainly want one of its two environment packages instead:\n * - Server:  @webpieces/http-client-node    (inversify-wired, reads RequestContext, mints OIDC)\n * - Browser: @webpieces/http-client-browser (no DI — React or Angular, app-managed context store)\n *\n * Architecture:\n * ```\n * http-api (defines the contract)\n *    ^\n *    +-- http-routing (server: contract -> handlers)\n *    +-- http-client-core (contract -> HTTP requests)   <- YOU ARE HERE\n *          +-- http-client-node     (RequestContext + Secrets + OIDC + inversify factory)\n *          +-- http-client-browser  (app-held store + plain factory, no DI)\n * ```\n *\n * There is no context/credential/recording seam here at all: ProxyClient is ABSTRACT and asks its\n * subclass for the base URL, the context headers, the log map, the outbound credential, and the\n * recorder. Nothing server-only (RequestContext, Secrets, mintIdToken, TestCaseRecorder) can reach\n * a browser bundle, and nothing browser-only (a ContextReader store) reaches a server.\n */\n\nexport { ProxyClient } from './ProxyClient';\nexport { RequestOutcome } from './RequestOutcome';\nexport type { ApiPrototype } from './ApiPrototype';\nexport { buildClientProxy } from './buildClientProxy';\nexport { ClientErrorTranslator } from './ClientErrorTranslator';\n// The CLIENT-side transport boundary: a fetch Response becomes the ONE HttpResponseDto an app's\n// ErrorTranslator sees, so node and browser hand `fromWire` the identical shape.\nexport { HttpResponseDtoFactory } from './HttpResponseDtoFactory';\nexport { RequestBodySerializer } from './RequestBodySerializer';\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 type { HttpTransport } from './HttpTransport';\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 { SseEvent, SseEventParser } from './SseEventParser';\nexport { StreamingCapabilityError } from './StreamingCapabilityError';\nexport { Utf8Codec } from './Utf8Codec';\nexport type { ByteReadableStream, ByteStreamReader, ByteReadResult } from './ByteStream';\n\nexport { rpcTarget } from './RpcTarget';\nexport type { RpcTarget } from './RpcTarget';\nexport { ClientToken } from './ClientToken';\nexport { ExternalContractUse } from './ExternalContractUse';\nexport { WiringPolicy } from './WiringPolicy';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/http/http-client-core/src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;;;AAEH,6CAA4C;AAAnC,0GAAA,WAAW,OAAA;AACpB,mDAAkD;AAAzC,gHAAA,cAAc,OAAA;AAEvB,uDAAsD;AAA7C,oHAAA,gBAAgB,OAAA;AACzB,iEAAgE;AAAvD,8HAAA,qBAAqB,OAAA;AAC9B,gGAAgG;AAChG,iFAAiF;AACjF,mEAAkE;AAAzD,gIAAA,sBAAsB,OAAA;AAC/B,iEAAgE;AAAvD,8HAAA,qBAAqB,OAAA;AAC9B,2DAA0D;AAAjD,wHAAA,kBAAkB,OAAA;AAC3B,kGAAkG;AAClG,kFAAkF;AAClF,gEAAgE;AAChE,iDAAgD;AAAvC,8GAAA,aAAa,OAAA;AAEtB,+CAAwD;AAA/C,sHAAA,sBAAsB,OAAA;AAE/B,6FAA6F;AAC7F,+FAA+F;AAC/F,mDAA4D;AAAnD,0GAAA,QAAQ,OAAA;AAAE,gHAAA,cAAc,OAAA;AACjC,uEAAsE;AAA7D,oIAAA,wBAAwB,OAAA;AACjC,yCAAwC;AAA/B,sGAAA,SAAS,OAAA;AAIlB,mCAAyC;AAAhC,uGAAA,aAAa,OAAA;AACtB,6CAA4C;AAAnC,0GAAA,WAAW,OAAA;AACpB,6DAA4D;AAAnD,0HAAA,mBAAmB,OAAA;AAC5B,+CAA8C;AAArC,4GAAA,YAAY,OAAA","sourcesContent":["/**\n * @webpieces/http-client-core\n *\n * The ISOMORPHIC core of the webpieces HTTP client — everything that reads an API contract's\n * decorators and turns a method call into an HTTP request, with no opinion about where the\n * magic context comes from or whether a DI container exists.\n *\n * You almost certainly want one of its two environment packages instead:\n * - Server:  @webpieces/http-client-node    (inversify-wired, reads RequestContext, mints OIDC)\n * - Browser: @webpieces/http-client-browser (no DI — React or Angular, app-managed context store)\n *\n * Architecture:\n * ```\n * http-api (defines the contract)\n *    ^\n *    +-- http-routing (server: contract -> handlers)\n *    +-- http-client-core (contract -> HTTP requests)   <- YOU ARE HERE\n *          +-- http-client-node     (RequestContext + Secrets + OIDC + inversify factory)\n *          +-- http-client-browser  (app-held store + plain factory, no DI)\n * ```\n *\n * There is no context/credential/recording seam here at all: ProxyClient is ABSTRACT and asks its\n * subclass for the base URL, the context headers, the log map, the outbound credential, and the\n * recorder. Nothing server-only (RequestContext, Secrets, mintIdToken, TestCaseRecorder) can reach\n * a browser bundle, and nothing browser-only (a ContextReader store) reaches a server.\n */\n\nexport { ProxyClient } from './ProxyClient';\nexport { RequestOutcome } from './RequestOutcome';\nexport type { ApiPrototype } from './ApiPrototype';\nexport { buildClientProxy } from './buildClientProxy';\nexport { ClientErrorTranslator } from './ClientErrorTranslator';\n// The CLIENT-side transport boundary: a fetch Response becomes the ONE HttpResponseDto an app's\n// ErrorTranslator sees, so node and browser hand `fromWire` the identical shape.\nexport { HttpResponseDtoFactory } from './HttpResponseDtoFactory';\nexport { RequestBodySerializer } from './RequestBodySerializer';\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 type { HttpTransport } from './HttpTransport';\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 { SseEvent, SseEventParser } from './SseEventParser';\nexport { StreamingCapabilityError } from './StreamingCapabilityError';\nexport { Utf8Codec } from './Utf8Codec';\nexport type { ByteReadableStream, ByteStreamReader, ByteReadResult } from './ByteStream';\n\nexport type { Wiring, AppWiring } from './Wiring';\nexport { WiringModules } from './Wiring';\nexport { ClientToken } from './ClientToken';\nexport { ExternalContractUse } from './ExternalContractUse';\nexport { WiringPolicy } from './WiringPolicy';\n"]}

package/src/RpcTarget.d.ts

@@ -1,11 +0,0 @@
-import type { ApiPrototype } from './ApiPrototype';
-declare const rpcTargetContract: unique symbol;
-/** A contract capability at one deployment. URLs and credentials stay in the registry. */
-declare class RpcTarget<T extends object> {
-    readonly api: ApiPrototype<T>;
-    readonly serviceName: string;
-    readonly [rpcTargetContract]: (value: T) => T;
-    constructor(api: ApiPrototype<T>, serviceName: string);
-}
-export declare function rpcTarget<T extends object>(api: ApiPrototype<T>, serviceName: string): RpcTarget<T>;
-export type { RpcTarget };

package/src/RpcTarget.js

@@ -1,17 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.rpcTarget = rpcTarget;
-/** A contract capability at one deployment. URLs and credentials stay in the registry. */
-class RpcTarget {
-    api;
-    serviceName;
-    constructor(api, serviceName) {
-        this.api = api;
-        this.serviceName = serviceName;
-    }
-}
-// webpieces-disable no-function-outside-class -- public declaration helper, deliberately one expression at the wiring boundary
-function rpcTarget(api, serviceName) {
-    return new RpcTarget(api, serviceName);
-}
-//# sourceMappingURL=RpcTarget.js.map

package/src/RpcTarget.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"RpcTarget.js","sourceRoot":"","sources":["../../../../../packages/http/http-client-core/src/RpcTarget.ts"],"names":[],"mappings":";;AAgBA,8BAKC;AAjBD,0FAA0F;AAC1F,MAAM,SAAS;IAKS;IACA;IAFpB,YACoB,GAAoB,EACpB,WAAmB;QADnB,QAAG,GAAH,GAAG,CAAiB;QACpB,gBAAW,GAAX,WAAW,CAAQ;IACpC,CAAC;CACP;AAED,+HAA+H;AAC/H,SAAgB,SAAS,CACrB,GAAoB,EACpB,WAAmB;IAEnB,OAAO,IAAI,SAAS,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;AAC3C,CAAC","sourcesContent":["import type { ApiPrototype } from './ApiPrototype';\n\ndeclare const rpcTargetContract: unique symbol;\n\n/** A contract capability at one deployment. URLs and credentials stay in the registry. */\nclass RpcTarget<T extends object> {\n    // Invariance prevents a target for a narrower contract being widened to a different API.\n    declare readonly [rpcTargetContract]: (value: T) => T;\n\n    constructor(\n        public readonly api: ApiPrototype<T>,\n        public readonly serviceName: string,\n    ) {}\n}\n\n// webpieces-disable no-function-outside-class -- public declaration helper, deliberately one expression at the wiring boundary\nexport function rpcTarget<T extends object>(\n    api: ApiPrototype<T>,\n    serviceName: string,\n): RpcTarget<T> {\n    return new RpcTarget(api, serviceName);\n}\n\nexport type { RpcTarget };\n"]}