@webpieces/http-client-core 0.4.853 → 0.4.855

package/package.json

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

package/src/ClientToken.d.ts

@@ -0,0 +1,8 @@
+declare const clientTokenContract: unique symbol;
+/** Opt-in invariant contract type for a local DI token; legacy symbols remain supported. */
+export declare class ClientToken<T extends object> {
+    readonly identifier: symbol;
+    readonly [clientTokenContract]: (value: T) => T;
+    constructor(identifier: symbol);
+}
+export {};

package/src/ClientToken.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClientToken = void 0;
+/** Opt-in invariant contract type for a local DI token; legacy symbols remain supported. */
+class ClientToken {
+    identifier;
+    constructor(identifier) {
+        this.identifier = identifier;
+    }
+}
+exports.ClientToken = ClientToken;
+//# sourceMappingURL=ClientToken.js.map

package/src/ClientToken.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClientToken.js","sourceRoot":"","sources":["../../../../../packages/http/http-client-core/src/ClientToken.ts"],"names":[],"mappings":";;;AAEA,4FAA4F;AAC5F,MAAa,WAAW;IAEQ;IAA5B,YAA4B,UAAkB;QAAlB,eAAU,GAAV,UAAU,CAAQ;IAAG,CAAC;CACrD;AAHD,kCAGC","sourcesContent":["declare const clientTokenContract: unique symbol;\n\n/** Opt-in invariant contract type for a local DI token; legacy symbols remain supported. */\nexport class ClientToken<T extends object> {\n    declare readonly [clientTokenContract]: (value: T) => T;\n    constructor(public readonly identifier: symbol) {}\n}\n"]}

package/src/ExternalContractUse.d.ts

@@ -0,0 +1,5 @@
+/** An erased vendor interface's qualified identity; this metadata never binds or instantiates an SDK. */
+export declare class ExternalContractUse {
+    readonly contract: `${string}#${string}`;
+    constructor(contract: `${string}#${string}`);
+}

package/src/ExternalContractUse.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExternalContractUse = void 0;
+/** An erased vendor interface's qualified identity; this metadata never binds or instantiates an SDK. */
+class ExternalContractUse {
+    contract;
+    constructor(contract) {
+        this.contract = contract;
+    }
+}
+exports.ExternalContractUse = ExternalContractUse;
+//# sourceMappingURL=ExternalContractUse.js.map

package/src/ExternalContractUse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExternalContractUse.js","sourceRoot":"","sources":["../../../../../packages/http/http-client-core/src/ExternalContractUse.ts"],"names":[],"mappings":";;;AAAA,yGAAyG;AACzG,MAAa,mBAAmB;IACA;IAA5B,YAA4B,QAA+B;QAA/B,aAAQ,GAAR,QAAQ,CAAuB;IAAG,CAAC;CAClE;AAFD,kDAEC","sourcesContent":["/** An erased vendor interface's qualified identity; this metadata never binds or instantiates an SDK. */\nexport class ExternalContractUse {\n    constructor(public readonly contract: `${string}#${string}`) {}\n}\n"]}

package/src/RpcTarget.d.ts

@@ -0,0 +1,11 @@
+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

@@ -0,0 +1,17 @@
+"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

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

package/src/WiringPolicy.d.ts

@@ -0,0 +1,6 @@
+/** Named runtime policy; extraction persists its condition, never the resolved environment value. */
+export declare class WiringPolicy {
+    readonly name: string;
+    readonly enabled: boolean;
+    constructor(name: string, enabled: boolean);
+}

package/src/WiringPolicy.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WiringPolicy = void 0;
+/** Named runtime policy; extraction persists its condition, never the resolved environment value. */
+class WiringPolicy {
+    name;
+    enabled;
+    constructor(name, enabled) {
+        this.name = name;
+        this.enabled = enabled;
+    }
+}
+exports.WiringPolicy = WiringPolicy;
+//# sourceMappingURL=WiringPolicy.js.map

package/src/WiringPolicy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WiringPolicy.js","sourceRoot":"","sources":["../../../../../packages/http/http-client-core/src/WiringPolicy.ts"],"names":[],"mappings":";;;AAAA,qGAAqG;AACrG,MAAa,YAAY;IAED;IACA;IAFpB,YACoB,IAAY,EACZ,OAAgB;QADhB,SAAI,GAAJ,IAAI,CAAQ;QACZ,YAAO,GAAP,OAAO,CAAS;IACjC,CAAC;CACP;AALD,oCAKC","sourcesContent":["/** Named runtime policy; extraction persists its condition, never the resolved environment value. */\nexport class WiringPolicy {\n    constructor(\n        public readonly name: string,\n        public readonly enabled: boolean,\n    ) {}\n}\n"]}

package/src/index.d.ts

@@ -40,3 +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 { 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.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.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;
 var ProxyClient_1 = require("./ProxyClient");
 Object.defineProperty(exports, "ProxyClient", { enumerable: true, get: function () { return ProxyClient_1.ProxyClient; } });
 var RequestOutcome_1 = require("./RequestOutcome");
@@ -59,4 +59,12 @@ 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 ClientToken_1 = require("./ClientToken");
+Object.defineProperty(exports, "ClientToken", { enumerable: true, get: function () { return ClientToken_1.ClientToken; } });
+var ExternalContractUse_1 = require("./ExternalContractUse");
+Object.defineProperty(exports, "ExternalContractUse", { enumerable: true, get: function () { return ExternalContractUse_1.ExternalContractUse; } });
+var WiringPolicy_1 = require("./WiringPolicy");
+Object.defineProperty(exports, "WiringPolicy", { enumerable: true, get: function () { return WiringPolicy_1.WiringPolicy; } });
 //# 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,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","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"]}
+{"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"]}