@webpieces/http-client-browser 0.4.869 → 0.4.871

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webpieces/http-client-browser",
-  "version": "0.4.869",
+  "version": "0.4.871",
   "description": "Browser HTTP client for webpieces: DI-free (React or Angular), app-managed context store, no AsyncLocalStorage",
   "type": "commonjs",
   "main": "./src/index.js",
@@ -22,7 +22,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@webpieces/core-util": "0.4.869",
-    "@webpieces/http-client-core": "0.4.869"
+    "@webpieces/core-util": "0.4.871",
+    "@webpieces/http-client-core": "0.4.871"
   }
 }

package/src/BinderCompileAssertions.d.ts

@@ -0,0 +1,8 @@
+import { Binder } from './Wiring';
+import type { AppWiring, Wiring } from './Wiring';
+/** Compiled fixtures protect token/API inference and the browser's missing route channel. */
+export declare class BinderCompileAssertions {
+    check(binder: Binder, token: symbol): void;
+    external(binder: Binder): void;
+    routes(wiring: Wiring, app: AppWiring): void;
+}

package/src/BinderCompileAssertions.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BinderCompileAssertions = void 0;
+const Wiring_1 = require("./Wiring");
+const ExternalImpl_1 = require("./ExternalImpl");
+class TextApi {
+}
+class ClockApi {
+}
+class VendorText extends TextApi {
+    read() { return 'vendor'; }
+}
+class LoggedText extends TextApi {
+}
+/** Compiled fixtures protect token/API inference and the browser's missing route channel. */
+class BinderCompileAssertions {
+    check(binder, token) {
+        binder.createRpcClientAndBind(TextApi, 'text-service');
+        binder.createRpcClientAndBind(TextApi, 'text-service', new Wiring_1.ClientBindOptions(token));
+        // @ts-expect-error A service destination is required.
+        binder.createRpcClientAndBind(TextApi);
+        // @ts-expect-error Wrapper destinations were removed; use a service string.
+        binder.createRpcClientAndBind(TextApi, { serviceName: 'text-service' });
+    }
+    external(binder) {
+        binder.bindExternal(TextApi, new ExternalImpl_1.UseClass(VendorText));
+        binder.bindExternal(TextApi, new ExternalImpl_1.UseExisting(LoggedText));
+        // @ts-expect-error A bare class is ambiguous (construct it, or alias it?); name the recipe: UseClass or UseExisting.
+        binder.bindExternal(TextApi, VendorText);
+        // @ts-expect-error The implementation must provide the external contract.
+        binder.bindExternal(ClockApi, new ExternalImpl_1.UseClass(VendorText));
+        // @ts-expect-error UseClass constructs its argument, so an abstract class is refused; alias it with UseExisting.
+        binder.bindExternal(TextApi, new ExternalImpl_1.UseClass(LoggedText));
+        // @ts-expect-error The implementation must provide the external contract.
+        binder.bindExternal(ClockApi, new ExternalImpl_1.UseExisting(LoggedText));
+    }
+    routes(wiring, app) {
+        // @ts-expect-error The browser has no route channel.
+        wiring.getRouteModules();
+        // @ts-expect-error The browser has no route channel.
+        app.getRoutingModules();
+    }
+}
+exports.BinderCompileAssertions = BinderCompileAssertions;
+//# sourceMappingURL=BinderCompileAssertions.js.map

package/src/BinderCompileAssertions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BinderCompileAssertions.js","sourceRoot":"","sources":["../../../../../packages/http/http-client-browser/src/BinderCompileAssertions.ts"],"names":[],"mappings":";;;AAAA,qCAAqD;AAErD,iDAAuD;AAEvD,MAAe,OAAO;CAA6B;AACnD,MAAe,QAAQ;CAA4B;AACnD,MAAM,UAAW,SAAQ,OAAO;IAAG,IAAI,KAAa,OAAO,QAAQ,CAAC,CAAC,CAAC;CAAE;AACxE,MAAe,UAAW,SAAQ,OAAO;CAAG;AAE5C,6FAA6F;AAC7F,MAAa,uBAAuB;IAChC,KAAK,CAAC,MAAc,EAAE,KAAa;QAC/B,MAAM,CAAC,sBAAsB,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;QACvD,MAAM,CAAC,sBAAsB,CAAC,OAAO,EAAE,cAAc,EAAE,IAAI,0BAAiB,CAAU,KAAK,CAAC,CAAC,CAAC;QAC9F,sDAAsD;QACtD,MAAM,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC;QACvC,4EAA4E;QAC5E,MAAM,CAAC,sBAAsB,CAAC,OAAO,EAAE,EAAE,WAAW,EAAE,cAAc,EAAE,CAAC,CAAC;IAC5E,CAAC;IAED,QAAQ,CAAC,MAAc;QACnB,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,IAAI,uBAAQ,CAAC,UAAU,CAAC,CAAC,CAAC;QACvD,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,IAAI,0BAAW,CAAC,UAAU,CAAC,CAAC,CAAC;QAC1D,qHAAqH;QACrH,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QACzC,0EAA0E;QAC1E,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,IAAI,uBAAQ,CAAC,UAAU,CAAC,CAAC,CAAC;QACxD,iHAAiH;QACjH,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,IAAI,uBAAQ,CAAC,UAAU,CAAC,CAAC,CAAC;QACvD,0EAA0E;QAC1E,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,IAAI,0BAAW,CAAC,UAAU,CAAC,CAAC,CAAC;IAC/D,CAAC;IAED,MAAM,CAAC,MAAc,EAAE,GAAc;QACjC,qDAAqD;QACrD,MAAM,CAAC,eAAe,EAAE,CAAC;QACzB,qDAAqD;QACrD,GAAG,CAAC,iBAAiB,EAAE,CAAC;IAC5B,CAAC;CACJ;AA7BD,0DA6BC","sourcesContent":["import { Binder, ClientBindOptions } from './Wiring';\nimport type { AppWiring, Wiring } from './Wiring';\nimport { UseClass, UseExisting } from './ExternalImpl';\n\nabstract class TextApi { abstract read(): string; }\nabstract class ClockApi { abstract now(): number; }\nclass VendorText extends TextApi { read(): string { return 'vendor'; } }\nabstract class LoggedText extends TextApi {}\n\n/** Compiled fixtures protect token/API inference and the browser's missing route channel. */\nexport class BinderCompileAssertions {\n    check(binder: Binder, token: symbol): void {\n        binder.createRpcClientAndBind(TextApi, 'text-service');\n        binder.createRpcClientAndBind(TextApi, 'text-service', new ClientBindOptions<TextApi>(token));\n        // @ts-expect-error A service destination is required.\n        binder.createRpcClientAndBind(TextApi);\n        // @ts-expect-error Wrapper destinations were removed; use a service string.\n        binder.createRpcClientAndBind(TextApi, { serviceName: 'text-service' });\n    }\n\n    external(binder: Binder): void {\n        binder.bindExternal(TextApi, new UseClass(VendorText));\n        binder.bindExternal(TextApi, new UseExisting(LoggedText));\n        // @ts-expect-error A bare class is ambiguous (construct it, or alias it?); name the recipe: UseClass or UseExisting.\n        binder.bindExternal(TextApi, VendorText);\n        // @ts-expect-error The implementation must provide the external contract.\n        binder.bindExternal(ClockApi, new UseClass(VendorText));\n        // @ts-expect-error UseClass constructs its argument, so an abstract class is refused; alias it with UseExisting.\n        binder.bindExternal(TextApi, new UseClass(LoggedText));\n        // @ts-expect-error The implementation must provide the external contract.\n        binder.bindExternal(ClockApi, new UseExisting(LoggedText));\n    }\n\n    routes(wiring: Wiring, app: AppWiring): void {\n        // @ts-expect-error The browser has no route channel.\n        wiring.getRouteModules();\n        // @ts-expect-error The browser has no route channel.\n        app.getRoutingModules();\n    }\n}\n"]}

package/src/ExternalImpl.d.ts

@@ -0,0 +1,34 @@
+import type { BrowserProvider, BrowserToken } from './BrowserProviders';
+/** A class the injector may construct (`useClass`). */
+export type ExternalClassType<T extends object> = new (...args: never[]) => T;
+/** A class token the injector already provides (`useExisting`), possibly abstract. */
+export type ExternalExistingType<T extends object> = abstract new (...args: never[]) => T;
+/**
+ * The vendor implementation handed to {@link Binder.bindExternal}. A class the injector constructs
+ * and a class it already provides are both classes at runtime, so the recipe is NAMED by the class
+ * that carries it rather than guessed from the argument:
+ *
+ * - `new UseClass(Vendor)` — the external contract is constructed as `Vendor`.
+ * - `new UseExisting(Logged)` — the external contract aliases the token `Logged`, which is provided
+ *   elsewhere (e.g. `@Injectable({ providedIn: 'root' })`), so both tokens share one instance.
+ *
+ * `T` is what the implementation provides; bindExternal requires it to satisfy the contract.
+ */
+export declare abstract class ExternalImpl<T extends object> {
+    /** Type-only: carries `T` so an implementation of the wrong contract does not compile. */
+    readonly implementation: T;
+    /** The structural provider registering `contract` with this implementation. */
+    abstract provider(contract: BrowserToken): BrowserProvider;
+}
+/** `useClass`: the external contract is constructed as {@link useClass}. */
+export declare class UseClass<T extends object> extends ExternalImpl<T> {
+    readonly useClass: ExternalClassType<T>;
+    constructor(useClass: ExternalClassType<T>);
+    provider(contract: BrowserToken): BrowserProvider;
+}
+/** `useExisting`: the external contract aliases the already-provided token {@link useExisting}. */
+export declare class UseExisting<T extends object> extends ExternalImpl<T> {
+    readonly useExisting: ExternalExistingType<T>;
+    constructor(useExisting: ExternalExistingType<T>);
+    provider(contract: BrowserToken): BrowserProvider;
+}

package/src/ExternalImpl.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UseExisting = exports.UseClass = exports.ExternalImpl = void 0;
+const BrowserProviders_1 = require("./BrowserProviders");
+/**
+ * The vendor implementation handed to {@link Binder.bindExternal}. A class the injector constructs
+ * and a class it already provides are both classes at runtime, so the recipe is NAMED by the class
+ * that carries it rather than guessed from the argument:
+ *
+ * - `new UseClass(Vendor)` — the external contract is constructed as `Vendor`.
+ * - `new UseExisting(Logged)` — the external contract aliases the token `Logged`, which is provided
+ *   elsewhere (e.g. `@Injectable({ providedIn: 'root' })`), so both tokens share one instance.
+ *
+ * `T` is what the implementation provides; bindExternal requires it to satisfy the contract.
+ */
+class ExternalImpl {
+}
+exports.ExternalImpl = ExternalImpl;
+/** `useClass`: the external contract is constructed as {@link useClass}. */
+class UseClass extends ExternalImpl {
+    useClass;
+    constructor(useClass) {
+        super();
+        this.useClass = useClass;
+    }
+    provider(contract) {
+        return new BrowserProviders_1.BrowserClassProvider(contract, this.useClass);
+    }
+}
+exports.UseClass = UseClass;
+/** `useExisting`: the external contract aliases the already-provided token {@link useExisting}. */
+class UseExisting extends ExternalImpl {
+    useExisting;
+    constructor(useExisting) {
+        super();
+        this.useExisting = useExisting;
+    }
+    provider(contract) {
+        return new BrowserProviders_1.BrowserExistingProvider(contract, this.useExisting);
+    }
+}
+exports.UseExisting = UseExisting;
+//# sourceMappingURL=ExternalImpl.js.map

package/src/ExternalImpl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExternalImpl.js","sourceRoot":"","sources":["../../../../../packages/http/http-client-browser/src/ExternalImpl.ts"],"names":[],"mappings":";;;AAAA,yDAAmF;AAQnF;;;;;;;;;;GAUG;AACH,MAAsB,YAAY;CAMjC;AAND,oCAMC;AAED,4EAA4E;AAC5E,MAAa,QAA2B,SAAQ,YAAe;IAC/B;IAA5B,YAA4B,QAA8B;QACtD,KAAK,EAAE,CAAC;QADgB,aAAQ,GAAR,QAAQ,CAAsB;IAE1D,CAAC;IAED,QAAQ,CAAC,QAAsB;QAC3B,OAAO,IAAI,uCAAoB,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC7D,CAAC;CACJ;AARD,4BAQC;AAED,mGAAmG;AACnG,MAAa,WAA8B,SAAQ,YAAe;IAClC;IAA5B,YAA4B,WAAoC;QAC5D,KAAK,EAAE,CAAC;QADgB,gBAAW,GAAX,WAAW,CAAyB;IAEhE,CAAC;IAED,QAAQ,CAAC,QAAsB;QAC3B,OAAO,IAAI,0CAAuB,CAAC,QAAQ,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IACnE,CAAC;CACJ;AARD,kCAQC","sourcesContent":["import { BrowserClassProvider, BrowserExistingProvider } from './BrowserProviders';\nimport type { BrowserProvider, BrowserToken } from './BrowserProviders';\n\n/** A class the injector may construct (`useClass`). */\nexport type ExternalClassType<T extends object> = new (...args: never[]) => T;\n/** A class token the injector already provides (`useExisting`), possibly abstract. */\nexport type ExternalExistingType<T extends object> = abstract new (...args: never[]) => T;\n\n/**\n * The vendor implementation handed to {@link Binder.bindExternal}. A class the injector constructs\n * and a class it already provides are both classes at runtime, so the recipe is NAMED by the class\n * that carries it rather than guessed from the argument:\n *\n * - `new UseClass(Vendor)` — the external contract is constructed as `Vendor`.\n * - `new UseExisting(Logged)` — the external contract aliases the token `Logged`, which is provided\n *   elsewhere (e.g. `@Injectable({ providedIn: 'root' })`), so both tokens share one instance.\n *\n * `T` is what the implementation provides; bindExternal requires it to satisfy the contract.\n */\nexport abstract class ExternalImpl<T extends object> {\n    /** Type-only: carries `T` so an implementation of the wrong contract does not compile. */\n    declare readonly implementation: T;\n\n    /** The structural provider registering `contract` with this implementation. */\n    abstract provider(contract: BrowserToken): BrowserProvider;\n}\n\n/** `useClass`: the external contract is constructed as {@link useClass}. */\nexport class UseClass<T extends object> extends ExternalImpl<T> {\n    constructor(public readonly useClass: ExternalClassType<T>) {\n        super();\n    }\n\n    provider(contract: BrowserToken): BrowserProvider {\n        return new BrowserClassProvider(contract, this.useClass);\n    }\n}\n\n/** `useExisting`: the external contract aliases the already-provided token {@link useExisting}. */\nexport class UseExisting<T extends object> extends ExternalImpl<T> {\n    constructor(public readonly useExisting: ExternalExistingType<T>) {\n        super();\n    }\n\n    provider(contract: BrowserToken): BrowserProvider {\n        return new BrowserExistingProvider(contract, this.useExisting);\n    }\n}\n"]}

package/src/RpcClientProvider.d.ts

@@ -1,13 +1,16 @@
 import type { ApiPrototype } from '@webpieces/http-client-core';
+import type { BrowserToken } from './BrowserProviders';
 import { ClientHttpBrowserFactory } from './ClientHttpBrowserFactory';
 import { ClientConfig } from './ClientConfig';
-/** Structurally compatible Angular factory provider. The original token remains overrideable. */
+/**
+ * Structurally compatible Angular factory provider, created by Binder.createRpcClientAndBind. The
+ * token remains overrideable and the client is created lazily, on first inject.
+ */
 export declare class RpcClientProvider<T extends object> {
-    readonly provide: ApiPrototype<T> | symbol;
+    readonly provide: BrowserToken;
     private readonly api;
     private readonly destination;
     readonly deps: (typeof ClientConfig | typeof ClientHttpBrowserFactory)[];
-    constructor(provide: ApiPrototype<T> | symbol, api: ApiPrototype<T>, destination: string);
+    constructor(provide: BrowserToken, api: ApiPrototype<T>, destination: string);
     readonly useFactory: (factory: ClientHttpBrowserFactory, _config: ClientConfig) => T;
 }
-export declare function provideRpcClient<T extends object>(token: ApiPrototype<NoInfer<T>> | symbol, api: ApiPrototype<T>, destination: string): RpcClientProvider<T>;

package/src/RpcClientProvider.js

@@ -1,10 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RpcClientProvider = void 0;
-exports.provideRpcClient = provideRpcClient;
 const ClientHttpBrowserFactory_1 = require("./ClientHttpBrowserFactory");
 const ClientConfig_1 = require("./ClientConfig");
-/** Structurally compatible Angular factory provider. The original token remains overrideable. */
+/**
+ * Structurally compatible Angular factory provider, created by Binder.createRpcClientAndBind. The
+ * token remains overrideable and the client is created lazily, on first inject.
+ */
 class RpcClientProvider {
     provide;
     api;
@@ -18,8 +20,4 @@ class RpcClientProvider {
     useFactory = (factory, _config) => factory.createRpcClient(this.api, new ClientConfig_1.ClientConfig(this.destination));
 }
 exports.RpcClientProvider = RpcClientProvider;
-// webpieces-disable no-function-outside-class -- declarative framework integration seam
-function provideRpcClient(token, api, destination) {
-    return new RpcClientProvider(token, api, destination);
-}
 //# sourceMappingURL=RpcClientProvider.js.map

package/src/RpcClientProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"RpcClientProvider.js","sourceRoot":"","sources":["../../../../../packages/http/http-client-browser/src/RpcClientProvider.ts"],"names":[],"mappings":";;;AAmBA,4CAMC;AAxBD,yEAAsE;AACtE,iDAA8C;AAE9C,iGAAiG;AACjG,MAAa,iBAAiB;IAIN;IACC;IACA;IALZ,IAAI,GAAG,CAAC,mDAAwB,EAAE,2BAAY,CAAC,CAAC;IAEzD,YACoB,OAAiC,EAChC,GAAoB,EACpB,WAAmB;QAFpB,YAAO,GAAP,OAAO,CAA0B;QAChC,QAAG,GAAH,GAAG,CAAiB;QACpB,gBAAW,GAAX,WAAW,CAAQ;IACrC,CAAC;IAEK,UAAU,GAAG,CAAC,OAAiC,EAAE,OAAqB,EAAK,EAAE,CAClF,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,2BAAY,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;CAC7E;AAXD,8CAWC;AAED,wFAAwF;AACxF,SAAgB,gBAAgB,CAC5B,KAAwC,EACxC,GAAoB,EACpB,WAAmB;IAEnB,OAAO,IAAI,iBAAiB,CAAC,KAAK,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC;AAC1D,CAAC","sourcesContent":["import type { ApiPrototype } from '@webpieces/http-client-core';\nimport { ClientHttpBrowserFactory } from './ClientHttpBrowserFactory';\nimport { ClientConfig } from './ClientConfig';\n\n/** Structurally compatible Angular factory provider. The original token remains overrideable. */\nexport class RpcClientProvider<T extends object> {\n    readonly deps = [ClientHttpBrowserFactory, ClientConfig];\n\n    constructor(\n        public readonly provide: ApiPrototype<T> | symbol,\n        private readonly api: ApiPrototype<T>,\n        private readonly destination: string,\n    ) {}\n\n    readonly useFactory = (factory: ClientHttpBrowserFactory, _config: ClientConfig): T =>\n        factory.createRpcClient(this.api, new ClientConfig(this.destination));\n}\n\n// webpieces-disable no-function-outside-class -- declarative framework integration seam\nexport function provideRpcClient<T extends object>(\n    token: ApiPrototype<NoInfer<T>> | symbol,\n    api: ApiPrototype<T>,\n    destination: string,\n): RpcClientProvider<T> {\n    return new RpcClientProvider(token, api, destination);\n}\n"]}
+{"version":3,"file":"RpcClientProvider.js","sourceRoot":"","sources":["../../../../../packages/http/http-client-browser/src/RpcClientProvider.ts"],"names":[],"mappings":";;;AAEA,yEAAsE;AACtE,iDAA8C;AAE9C;;;GAGG;AACH,MAAa,iBAAiB;IAIN;IACC;IACA;IALZ,IAAI,GAAG,CAAC,mDAAwB,EAAE,2BAAY,CAAC,CAAC;IAEzD,YACoB,OAAqB,EACpB,GAAoB,EACpB,WAAmB;QAFpB,YAAO,GAAP,OAAO,CAAc;QACpB,QAAG,GAAH,GAAG,CAAiB;QACpB,gBAAW,GAAX,WAAW,CAAQ;IACrC,CAAC;IAEK,UAAU,GAAG,CAAC,OAAiC,EAAE,OAAqB,EAAK,EAAE,CAClF,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,2BAAY,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;CAC7E;AAXD,8CAWC","sourcesContent":["import type { ApiPrototype } from '@webpieces/http-client-core';\nimport type { BrowserToken } from './BrowserProviders';\nimport { ClientHttpBrowserFactory } from './ClientHttpBrowserFactory';\nimport { ClientConfig } from './ClientConfig';\n\n/**\n * Structurally compatible Angular factory provider, created by Binder.createRpcClientAndBind. The\n * token remains overrideable and the client is created lazily, on first inject.\n */\nexport class RpcClientProvider<T extends object> {\n    readonly deps = [ClientHttpBrowserFactory, ClientConfig];\n\n    constructor(\n        public readonly provide: BrowserToken,\n        private readonly api: ApiPrototype<T>,\n        private readonly destination: string,\n    ) {}\n\n    readonly useFactory = (factory: ClientHttpBrowserFactory, _config: ClientConfig): T =>\n        factory.createRpcClient(this.api, new ClientConfig(this.destination));\n}\n"]}

package/src/Wiring.d.ts

@@ -1,22 +1,41 @@
 import type { BrowserProvider } from './BrowserProviders';
-import type { Wiring as Topology, AppWiring as AppTopology } from '@webpieces/http-client-core';
-/** The browser adapter imports neither Angular nor Node runtime or types. */
-export declare class BrowserBindings {
-    readonly providers: BrowserProvider[];
-    add(provider: BrowserProvider): void;
+import type { ApiPrototype, BindModule as HostBindModule, Wiring as HostWiring, AppWiring as HostAppWiring } from '@webpieces/http-client-core';
+import type { ExternalImpl } from './ExternalImpl';
+/**
+ * Options for {@link Binder.createRpcClientAndBind}. `token` is an EXTRA identity, needed only when two
+ * clients of the SAME api must coexist (e.g. one per deployment); omitted, the API class is the token.
+ */
+export declare class ClientBindOptions<T> {
+    readonly token?: (ApiPrototype<T> | symbol) | undefined;
+    constructor(token?: (ApiPrototype<T> | symbol) | undefined);
 }
-export interface BindingModule {
-    configure(bindings: BrowserBindings): void;
+/**
+ * The browser host's binder, handed to every {@link BindModule}.configure. It collects structural
+ * provider recipes; the package imports neither Angular nor Node runtime or types.
+ */
+export declare class Binder {
+    private readonly recipes;
+    /** Angular-compatible provider recipes, in order. */
+    provide(...recipes: BrowserProvider[]): void;
+    /** Registers a lazy factory provider: the client is created from ClientHttpBrowserFactory on first inject. */
+    createRpcClientAndBind<T extends object>(api: ApiPrototype<T>, deployment: string, options?: ClientBindOptions<NoInfer<T>>): void;
+    /**
+     * Registers a vendor implementation of an external contract AND records the external-contract
+     * graph edge. `impl` is `new UseClass(Vendor)` or `new UseExisting(Token)`.
+     */
+    bindExternal<T extends object>(api: ApiPrototype<T>, impl: ExternalImpl<NoInfer<T>>): void;
+    get providers(): BrowserProvider[];
 }
-/** Lazy route providers remain separate from domain bindings. */
-export interface RouteModule {
-    configure(bindings: BrowserBindings): void;
+/** A browser DI module. Angular router providers are ordinary provider recipes here. */
+export interface BindModule extends HostBindModule<Binder> {
+    configure(binder: Binder): void;
 }
-export interface Wiring extends Topology<BindingModule, RouteModule> {
+/** The browser has no route channel: a Wiring selects bind modules only. */
+export interface Wiring extends HostWiring<BindModule> {
 }
-export interface AppWiring extends AppTopology<BindingModule, RouteModule> {
+export interface AppWiring extends HostAppWiring<BindModule, Wiring> {
 }
-/** Configure the selected domain and route modules once, in topology order. */
+/** Configure the selected bind modules once, in topology order. */
 export declare class BrowserWiringProviders {
     toProviders(app: AppWiring): BrowserProvider[];
 }

package/src/Wiring.js

@@ -1,25 +1,53 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.BrowserWiringProviders = exports.BrowserBindings = void 0;
+exports.BrowserWiringProviders = exports.Binder = exports.ClientBindOptions = void 0;
 const http_client_core_1 = require("@webpieces/http-client-core");
-/** The browser adapter imports neither Angular nor Node runtime or types. */
-class BrowserBindings {
-    providers = [];
-    add(provider) {
-        this.providers.push(provider);
+const RpcClientProvider_1 = require("./RpcClientProvider");
+/**
+ * Options for {@link Binder.createRpcClientAndBind}. `token` is an EXTRA identity, needed only when two
+ * clients of the SAME api must coexist (e.g. one per deployment); omitted, the API class is the token.
+ */
+class ClientBindOptions {
+    token;
+    constructor(token) {
+        this.token = token;
     }
 }
-exports.BrowserBindings = BrowserBindings;
-/** Configure the selected domain and route modules once, in topology order. */
+exports.ClientBindOptions = ClientBindOptions;
+/**
+ * The browser host's binder, handed to every {@link BindModule}.configure. It collects structural
+ * provider recipes; the package imports neither Angular nor Node runtime or types.
+ */
+class Binder {
+    recipes = [];
+    /** Angular-compatible provider recipes, in order. */
+    provide(...recipes) {
+        this.recipes.push(...recipes);
+    }
+    /** Registers a lazy factory provider: the client is created from ClientHttpBrowserFactory on first inject. */
+    createRpcClientAndBind(api, deployment, options) {
+        const token = options?.token ?? api;
+        this.recipes.push(new RpcClientProvider_1.RpcClientProvider(token, api, deployment));
+    }
+    /**
+     * Registers a vendor implementation of an external contract AND records the external-contract
+     * graph edge. `impl` is `new UseClass(Vendor)` or `new UseExisting(Token)`.
+     */
+    bindExternal(api, impl) {
+        this.recipes.push(impl.provider(api));
+    }
+    get providers() {
+        return [...this.recipes];
+    }
+}
+exports.Binder = Binder;
+/** Configure the selected bind modules once, in topology order. */
 class BrowserWiringProviders {
     toProviders(app) {
-        const modules = new http_client_core_1.WiringModules(app);
-        const bindings = new BrowserBindings();
-        for (const module of modules.bindingModules)
-            module.configure(bindings);
-        for (const module of modules.routingModules)
-            module.configure(bindings);
-        return bindings.providers;
+        const binder = new Binder();
+        for (const module of new http_client_core_1.WiringModules(app).bindModules)
+            module.configure(binder);
+        return binder.providers;
     }
 }
 exports.BrowserWiringProviders = BrowserWiringProviders;

package/src/Wiring.js.map

@@ -1 +1 @@
-{"version":3,"file":"Wiring.js","sourceRoot":"","sources":["../../../../../packages/http/http-client-browser/src/Wiring.ts"],"names":[],"mappings":";;;AAEA,kEAA4D;AAE5D,6EAA6E;AAC7E,MAAa,eAAe;IACf,SAAS,GAAsB,EAAE,CAAC;IAE3C,GAAG,CAAC,QAAyB;QACzB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;CACJ;AAND,0CAMC;AAcD,+EAA+E;AAC/E,MAAa,sBAAsB;IAC/B,WAAW,CAAC,GAAc;QACtB,MAAM,OAAO,GAAG,IAAI,gCAAa,CAAC,GAAG,CAAC,CAAC;QACvC,MAAM,QAAQ,GAAG,IAAI,eAAe,EAAE,CAAC;QACvC,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,cAAc;YAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QACxE,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,cAAc;YAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QACxE,OAAO,QAAQ,CAAC,SAAS,CAAC;IAC9B,CAAC;CACJ;AARD,wDAQC","sourcesContent":["import type { BrowserProvider } from './BrowserProviders';\nimport type { Wiring as Topology, AppWiring as AppTopology } from '@webpieces/http-client-core';\nimport { WiringModules } from '@webpieces/http-client-core';\n\n/** The browser adapter imports neither Angular nor Node runtime or types. */\nexport class BrowserBindings {\n    readonly providers: BrowserProvider[] = [];\n\n    add(provider: BrowserProvider): void {\n        this.providers.push(provider);\n    }\n}\n\nexport interface BindingModule {\n    configure(bindings: BrowserBindings): void;\n}\n\n/** Lazy route providers remain separate from domain bindings. */\nexport interface RouteModule {\n    configure(bindings: BrowserBindings): void;\n}\n\nexport interface Wiring extends Topology<BindingModule, RouteModule> {}\nexport interface AppWiring extends AppTopology<BindingModule, RouteModule> {}\n\n/** Configure the selected domain and route modules once, in topology order. */\nexport class BrowserWiringProviders {\n    toProviders(app: AppWiring): BrowserProvider[] {\n        const modules = new WiringModules(app);\n        const bindings = new BrowserBindings();\n        for (const module of modules.bindingModules) module.configure(bindings);\n        for (const module of modules.routingModules) module.configure(bindings);\n        return bindings.providers;\n    }\n}\n"]}
+{"version":3,"file":"Wiring.js","sourceRoot":"","sources":["../../../../../packages/http/http-client-browser/src/Wiring.ts"],"names":[],"mappings":";;;AAOA,kEAA4D;AAC5D,2DAAwD;AAGxD;;;GAGG;AACH,MAAa,iBAAiB;IACE;IAA5B,YAA4B,KAAgC;QAAhC,UAAK,GAAL,KAAK,CAA2B;IAAG,CAAC;CACnE;AAFD,8CAEC;AAED;;;GAGG;AACH,MAAa,MAAM;IACE,OAAO,GAAsB,EAAE,CAAC;IAEjD,qDAAqD;IACrD,OAAO,CAAC,GAAG,OAA0B;QACjC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC;IAClC,CAAC;IAED,8GAA8G;IAC9G,sBAAsB,CAClB,GAAoB,EACpB,UAAkB,EAClB,OAAuC;QAEvC,MAAM,KAAK,GAAiB,OAAO,EAAE,KAAK,IAAI,GAAG,CAAC;QAClD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,qCAAiB,CAAI,KAAK,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC;IACxE,CAAC;IAED;;;OAGG;IACH,YAAY,CAAmB,GAAoB,EAAE,IAA8B;QAC/E,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1C,CAAC;IAED,IAAI,SAAS;QACT,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;CACJ;AA7BD,wBA6BC;AAWD,mEAAmE;AACnE,MAAa,sBAAsB;IAC/B,WAAW,CAAC,GAAc;QACtB,MAAM,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;QAC5B,KAAK,MAAM,MAAM,IAAI,IAAI,gCAAa,CAAa,GAAG,CAAC,CAAC,WAAW;YAAE,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAC9F,OAAO,MAAM,CAAC,SAAS,CAAC;IAC5B,CAAC;CACJ;AAND,wDAMC","sourcesContent":["import type { BrowserProvider, BrowserToken } from './BrowserProviders';\nimport type {\n    ApiPrototype,\n    BindModule as HostBindModule,\n    Wiring as HostWiring,\n    AppWiring as HostAppWiring,\n} from '@webpieces/http-client-core';\nimport { WiringModules } from '@webpieces/http-client-core';\nimport { RpcClientProvider } from './RpcClientProvider';\nimport type { ExternalImpl } from './ExternalImpl';\n\n/**\n * Options for {@link Binder.createRpcClientAndBind}. `token` is an EXTRA identity, needed only when two\n * clients of the SAME api must coexist (e.g. one per deployment); omitted, the API class is the token.\n */\nexport class ClientBindOptions<T> {\n    constructor(public readonly token?: ApiPrototype<T> | symbol) {}\n}\n\n/**\n * The browser host's binder, handed to every {@link BindModule}.configure. It collects structural\n * provider recipes; the package imports neither Angular nor Node runtime or types.\n */\nexport class Binder {\n    private readonly recipes: BrowserProvider[] = [];\n\n    /** Angular-compatible provider recipes, in order. */\n    provide(...recipes: BrowserProvider[]): void {\n        this.recipes.push(...recipes);\n    }\n\n    /** Registers a lazy factory provider: the client is created from ClientHttpBrowserFactory on first inject. */\n    createRpcClientAndBind<T extends object>(\n        api: ApiPrototype<T>,\n        deployment: string,\n        options?: ClientBindOptions<NoInfer<T>>,\n    ): void {\n        const token: BrowserToken = options?.token ?? api;\n        this.recipes.push(new RpcClientProvider<T>(token, api, deployment));\n    }\n\n    /**\n     * Registers a vendor implementation of an external contract AND records the external-contract\n     * graph edge. `impl` is `new UseClass(Vendor)` or `new UseExisting(Token)`.\n     */\n    bindExternal<T extends object>(api: ApiPrototype<T>, impl: ExternalImpl<NoInfer<T>>): void {\n        this.recipes.push(impl.provider(api));\n    }\n\n    get providers(): BrowserProvider[] {\n        return [...this.recipes];\n    }\n}\n\n/** A browser DI module. Angular router providers are ordinary provider recipes here. */\nexport interface BindModule extends HostBindModule<Binder> {\n    configure(binder: Binder): void;\n}\n\n/** The browser has no route channel: a Wiring selects bind modules only. */\nexport interface Wiring extends HostWiring<BindModule> {}\nexport interface AppWiring extends HostAppWiring<BindModule, Wiring> {}\n\n/** Configure the selected bind modules once, in topology order. */\nexport class BrowserWiringProviders {\n    toProviders(app: AppWiring): BrowserProvider[] {\n        const binder = new Binder();\n        for (const module of new WiringModules<BindModule>(app).bindModules) module.configure(binder);\n        return binder.providers;\n    }\n}\n"]}

package/src/index.d.ts

@@ -36,9 +36,10 @@ export { ContextMgr } from '@webpieces/core-util';
 export { ContextReader, ContextWriter, ContextStore, ContextKey, HeaderRegistry, ClientRegistry, templateDeriver, WebpiecesCoreHeaders, } from '@webpieces/core-util';
 export type { ServiceUrlDeriver } from '@webpieces/core-util';
 export { ApiPath, Endpoint, PathParam, QueryParam, WpAuthPublic, WpAuth, WpAuthorization, AuthorizationType, WpLocalOnly, jwt, oidc, sharedSecret, webhook, apiKey, Rpc, PubSub, Queue, ValidateImplementation, } from '@webpieces/core-util';
-export type { Wiring, AppWiring, BindingModule, RouteModule } from './Wiring';
-export { BrowserBindings, BrowserWiringProviders } from './Wiring';
+export type { Wiring, AppWiring, BindModule } from './Wiring';
+export { Binder, ClientBindOptions, BrowserWiringProviders } from './Wiring';
+export { ExternalImpl, UseClass, UseExisting } from './ExternalImpl';
+export type { ExternalClassType, ExternalExistingType } from './ExternalImpl';
 export { BrowserValueProvider, BrowserClassProvider, BrowserExistingProvider, BrowserFactoryProvider } from './BrowserProviders';
 export type { BrowserProvider, BrowserToken, BrowserType } from './BrowserProviders';
-export { RpcClientProvider, provideRpcClient } from './RpcClientProvider';
-export { WiringPolicy, ExternalContractUse } from '@webpieces/http-client-core';
+export { WiringPolicy } from '@webpieces/http-client-core';

package/src/index.js

@@ -25,7 +25,7 @@
  * The server twin is @webpieces/http-client-node.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ExternalContractUse = exports.WiringPolicy = exports.provideRpcClient = exports.RpcClientProvider = exports.BrowserFactoryProvider = exports.BrowserExistingProvider = exports.BrowserClassProvider = exports.BrowserValueProvider = exports.BrowserWiringProviders = exports.BrowserBindings = exports.Queue = exports.PubSub = exports.Rpc = exports.apiKey = exports.webhook = exports.sharedSecret = exports.oidc = exports.jwt = exports.WpLocalOnly = exports.AuthorizationType = exports.WpAuthorization = exports.WpAuth = exports.WpAuthPublic = exports.QueryParam = exports.PathParam = exports.Endpoint = exports.ApiPath = exports.WebpiecesCoreHeaders = exports.templateDeriver = exports.ClientRegistry = exports.HeaderRegistry = exports.ContextKey = exports.ContextMgr = exports.StreamingCapabilityError = exports.RequestOutcome = exports.ClientErrorTranslator = exports.ProxyClient = exports.MutableContextStore = exports.ClientConfig = exports.BrowserApiCallContext = exports.BrowserProxyClient = exports.ClientHttpBrowserFactory = void 0;
+exports.WiringPolicy = exports.BrowserFactoryProvider = exports.BrowserExistingProvider = exports.BrowserClassProvider = exports.BrowserValueProvider = exports.UseExisting = exports.UseClass = exports.ExternalImpl = exports.BrowserWiringProviders = exports.ClientBindOptions = exports.Binder = exports.Queue = exports.PubSub = exports.Rpc = exports.apiKey = exports.webhook = exports.sharedSecret = exports.oidc = exports.jwt = exports.WpLocalOnly = exports.AuthorizationType = exports.WpAuthorization = exports.WpAuth = exports.WpAuthPublic = exports.QueryParam = exports.PathParam = exports.Endpoint = exports.ApiPath = exports.WebpiecesCoreHeaders = exports.templateDeriver = exports.ClientRegistry = exports.HeaderRegistry = exports.ContextKey = exports.ContextMgr = exports.StreamingCapabilityError = exports.RequestOutcome = exports.ClientErrorTranslator = exports.ProxyClient = exports.MutableContextStore = exports.ClientConfig = exports.BrowserApiCallContext = exports.BrowserProxyClient = exports.ClientHttpBrowserFactory = void 0;
 var ClientHttpBrowserFactory_1 = require("./ClientHttpBrowserFactory");
 Object.defineProperty(exports, "ClientHttpBrowserFactory", { enumerable: true, get: function () { return ClientHttpBrowserFactory_1.ClientHttpBrowserFactory; } });
 var BrowserProxyClient_1 = require("./BrowserProxyClient");
@@ -77,17 +77,18 @@ Object.defineProperty(exports, "Rpc", { enumerable: true, get: function () { ret
 Object.defineProperty(exports, "PubSub", { enumerable: true, get: function () { return core_util_3.PubSub; } });
 Object.defineProperty(exports, "Queue", { enumerable: true, get: function () { return core_util_3.Queue; } });
 var Wiring_1 = require("./Wiring");
-Object.defineProperty(exports, "BrowserBindings", { enumerable: true, get: function () { return Wiring_1.BrowserBindings; } });
+Object.defineProperty(exports, "Binder", { enumerable: true, get: function () { return Wiring_1.Binder; } });
+Object.defineProperty(exports, "ClientBindOptions", { enumerable: true, get: function () { return Wiring_1.ClientBindOptions; } });
 Object.defineProperty(exports, "BrowserWiringProviders", { enumerable: true, get: function () { return Wiring_1.BrowserWiringProviders; } });
+var ExternalImpl_1 = require("./ExternalImpl");
+Object.defineProperty(exports, "ExternalImpl", { enumerable: true, get: function () { return ExternalImpl_1.ExternalImpl; } });
+Object.defineProperty(exports, "UseClass", { enumerable: true, get: function () { return ExternalImpl_1.UseClass; } });
+Object.defineProperty(exports, "UseExisting", { enumerable: true, get: function () { return ExternalImpl_1.UseExisting; } });
 var BrowserProviders_1 = require("./BrowserProviders");
 Object.defineProperty(exports, "BrowserValueProvider", { enumerable: true, get: function () { return BrowserProviders_1.BrowserValueProvider; } });
 Object.defineProperty(exports, "BrowserClassProvider", { enumerable: true, get: function () { return BrowserProviders_1.BrowserClassProvider; } });
 Object.defineProperty(exports, "BrowserExistingProvider", { enumerable: true, get: function () { return BrowserProviders_1.BrowserExistingProvider; } });
 Object.defineProperty(exports, "BrowserFactoryProvider", { enumerable: true, get: function () { return BrowserProviders_1.BrowserFactoryProvider; } });
-var RpcClientProvider_1 = require("./RpcClientProvider");
-Object.defineProperty(exports, "RpcClientProvider", { enumerable: true, get: function () { return RpcClientProvider_1.RpcClientProvider; } });
-Object.defineProperty(exports, "provideRpcClient", { enumerable: true, get: function () { return RpcClientProvider_1.provideRpcClient; } });
 var http_client_core_3 = require("@webpieces/http-client-core");
 Object.defineProperty(exports, "WiringPolicy", { enumerable: true, get: function () { return http_client_core_3.WiringPolicy; } });
-Object.defineProperty(exports, "ExternalContractUse", { enumerable: true, get: function () { return http_client_core_3.ExternalContractUse; } });
 //# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/http/http-client-browser/src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;;;AAEH,uEAAsE;AAA7D,oIAAA,wBAAwB,OAAA;AACjC,2DAA0D;AAAjD,wHAAA,kBAAkB,OAAA;AAC3B,4FAA4F;AAC5F,kGAAkG;AAClG,8BAA8B;AAC9B,iEAAgE;AAAvD,8HAAA,qBAAqB,OAAA;AAC9B,+CAA8C;AAArC,4GAAA,YAAY,OAAA;AACrB,6DAA4D;AAAnD,0HAAA,mBAAmB,OAAA;AAG5B,wEAAwE;AACxE,gEAAiG;AAAxF,+GAAA,WAAW,OAAA;AAAE,yHAAA,qBAAqB,OAAA;AAAE,kHAAA,cAAc,OAAA;AAE3D,gEAAuE;AAA9D,4HAAA,wBAAwB,OAAA;AAEjC,iGAAiG;AACjG,mGAAmG;AACnG,kDAAkD;AAAzC,uGAAA,UAAU,OAAA;AAEnB,yFAAyF;AACzF,kDAS8B;AAL1B,uGAAA,UAAU,OAAA;AACV,2GAAA,cAAc,OAAA;AACd,2GAAA,cAAc,OAAA;AACd,4GAAA,eAAe,OAAA;AACf,iHAAA,oBAAoB,OAAA;AAIxB,uEAAuE;AACvE,kDAmB8B;AAlB1B,oGAAA,OAAO,OAAA;AACP,qGAAA,QAAQ,OAAA;AACR,sGAAA,SAAS,OAAA;AACT,uGAAA,UAAU,OAAA;AACV,yGAAA,YAAY,OAAA;AACZ,mGAAA,MAAM,OAAA;AACN,4GAAA,eAAe,OAAA;AACf,8GAAA,iBAAiB,OAAA;AACjB,wGAAA,WAAW,OAAA;AACX,gGAAA,GAAG,OAAA;AACH,iGAAA,IAAI,OAAA;AACJ,yGAAA,YAAY,OAAA;AACZ,oGAAA,OAAO,OAAA;AACP,mGAAA,MAAM,OAAA;AACN,gGAAA,GAAG,OAAA;AACH,mGAAA,MAAM,OAAA;AACN,kGAAA,KAAK,OAAA;AAKT,mCAAmE;AAA1D,yGAAA,eAAe,OAAA;AAAE,gHAAA,sBAAsB,OAAA;AAChD,uDAAiI;AAAxH,wHAAA,oBAAoB,OAAA;AAAE,wHAAA,oBAAoB,OAAA;AAAE,2HAAA,uBAAuB,OAAA;AAAE,0HAAA,sBAAsB,OAAA;AAEpG,yDAA0E;AAAjE,sHAAA,iBAAiB,OAAA;AAAE,qHAAA,gBAAgB,OAAA;AAE5C,gEAAgF;AAAvE,gHAAA,YAAY,OAAA;AAAE,uHAAA,mBAAmB,OAAA","sourcesContent":["/**\n * @webpieces/http-client-browser\n *\n * The BROWSER HTTP client. Reads an API contract's decorators and generates type-safe HTTP\n * clients from it — the same contract the server implements.\n *\n * DI-free on purpose: this may be bundled by React or Angular, so it ships no inversify and no\n * @webpieces/core-context (which is AsyncLocalStorage-backed and Node-only). Browsers have no\n * ambient request scope, so the app holds a {@link MutableContextStore} and sets context values\n * as they become known; every outbound call then transfers them as headers.\n *\n * Usage:\n * ```typescript\n * import { ClientHttpBrowserFactory, ClientConfig, MutableContextStore } from '@webpieces/http-client-browser';\n *\n * HeaderRegistry.configure(CompanyHeaders.ALL_HEADERS, true);\n * const store = new MutableContextStore();\n * const factory = new ClientHttpBrowserFactory(store);\n *\n * const client = factory.createRpcClient(SaveApi, new ClientConfig('save-svc'));\n * const response = await client.save({ query: 'test' });\n * ```\n *\n * The server twin is @webpieces/http-client-node.\n */\n\nexport { ClientHttpBrowserFactory } from './ClientHttpBrowserFactory';\nexport { BrowserProxyClient } from './BrowserProxyClient';\n// Browser impl of the ApiCallContext seam, constructed by BrowserProxyClient. Exported so a\n// browser/Angular logger can read the current tag via the STATIC BrowserApiCallContext.snapshot()\n// and fold it into log lines.\nexport { BrowserApiCallContext } from './BrowserApiCallContext';\nexport { ClientConfig } from './ClientConfig';\nexport { MutableContextStore } from './MutableContextStore';\nexport type { RequestLifecycleListener } from './RequestLifecycleListener';\n\n// The isomorphic engine, re-exported so a browser app needs one import.\nexport { ProxyClient, ClientErrorTranslator, RequestOutcome } from '@webpieces/http-client-core';\nexport type { ApiPrototype } from '@webpieces/http-client-core';\nexport { StreamingCapabilityError } from '@webpieces/http-client-core';\n\n// ContextMgr is the BROWSER's outbound-header propagation. This is the only package that may use\n// it; the server reads RequestContext directly (RequestContextHeaders in @webpieces/core-context).\nexport { ContextMgr } from '@webpieces/core-util';\n\n// Re-export the context-key contract from core-util for convenience (browser one-import)\nexport {\n    ContextReader,\n    ContextWriter,\n    ContextStore,\n    ContextKey,\n    HeaderRegistry,\n    ClientRegistry,\n    templateDeriver,\n    WebpiecesCoreHeaders,\n} from '@webpieces/core-util';\nexport type { ServiceUrlDeriver } from '@webpieces/core-util';\n\n// Re-export API decorators for convenience (same as http-routing does)\nexport {\n    ApiPath,\n    Endpoint,\n    PathParam,\n    QueryParam,\n    WpAuthPublic,\n    WpAuth,\n    WpAuthorization,\n    AuthorizationType,\n    WpLocalOnly,\n    jwt,\n    oidc,\n    sharedSecret,\n    webhook,\n    apiKey,\n    Rpc,\n    PubSub,\n    Queue,\n    ValidateImplementation,\n} from '@webpieces/core-util';\n\nexport type { Wiring, AppWiring, BindingModule, RouteModule } from './Wiring';\nexport { BrowserBindings, BrowserWiringProviders } from './Wiring';\nexport { BrowserValueProvider, BrowserClassProvider, BrowserExistingProvider, BrowserFactoryProvider } from './BrowserProviders';\nexport type { BrowserProvider, BrowserToken, BrowserType } from './BrowserProviders';\nexport { RpcClientProvider, provideRpcClient } from './RpcClientProvider';\n\nexport { WiringPolicy, ExternalContractUse } from '@webpieces/http-client-core';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/http/http-client-browser/src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;;;AAEH,uEAAsE;AAA7D,oIAAA,wBAAwB,OAAA;AACjC,2DAA0D;AAAjD,wHAAA,kBAAkB,OAAA;AAC3B,4FAA4F;AAC5F,kGAAkG;AAClG,8BAA8B;AAC9B,iEAAgE;AAAvD,8HAAA,qBAAqB,OAAA;AAC9B,+CAA8C;AAArC,4GAAA,YAAY,OAAA;AACrB,6DAA4D;AAAnD,0HAAA,mBAAmB,OAAA;AAG5B,wEAAwE;AACxE,gEAAiG;AAAxF,+GAAA,WAAW,OAAA;AAAE,yHAAA,qBAAqB,OAAA;AAAE,kHAAA,cAAc,OAAA;AAE3D,gEAAuE;AAA9D,4HAAA,wBAAwB,OAAA;AAEjC,iGAAiG;AACjG,mGAAmG;AACnG,kDAAkD;AAAzC,uGAAA,UAAU,OAAA;AAEnB,yFAAyF;AACzF,kDAS8B;AAL1B,uGAAA,UAAU,OAAA;AACV,2GAAA,cAAc,OAAA;AACd,2GAAA,cAAc,OAAA;AACd,4GAAA,eAAe,OAAA;AACf,iHAAA,oBAAoB,OAAA;AAIxB,uEAAuE;AACvE,kDAmB8B;AAlB1B,oGAAA,OAAO,OAAA;AACP,qGAAA,QAAQ,OAAA;AACR,sGAAA,SAAS,OAAA;AACT,uGAAA,UAAU,OAAA;AACV,yGAAA,YAAY,OAAA;AACZ,mGAAA,MAAM,OAAA;AACN,4GAAA,eAAe,OAAA;AACf,8GAAA,iBAAiB,OAAA;AACjB,wGAAA,WAAW,OAAA;AACX,gGAAA,GAAG,OAAA;AACH,iGAAA,IAAI,OAAA;AACJ,yGAAA,YAAY,OAAA;AACZ,oGAAA,OAAO,OAAA;AACP,mGAAA,MAAM,OAAA;AACN,gGAAA,GAAG,OAAA;AACH,mGAAA,MAAM,OAAA;AACN,kGAAA,KAAK,OAAA;AAOT,mCAA6E;AAApE,gGAAA,MAAM,OAAA;AAAE,2GAAA,iBAAiB,OAAA;AAAE,gHAAA,sBAAsB,OAAA;AAC1D,+CAAqE;AAA5D,4GAAA,YAAY,OAAA;AAAE,wGAAA,QAAQ,OAAA;AAAE,2GAAA,WAAW,OAAA;AAE5C,uDAAiI;AAAxH,wHAAA,oBAAoB,OAAA;AAAE,wHAAA,oBAAoB,OAAA;AAAE,2HAAA,uBAAuB,OAAA;AAAE,0HAAA,sBAAsB,OAAA;AAGpG,gEAA2D;AAAlD,gHAAA,YAAY,OAAA","sourcesContent":["/**\n * @webpieces/http-client-browser\n *\n * The BROWSER HTTP client. Reads an API contract's decorators and generates type-safe HTTP\n * clients from it — the same contract the server implements.\n *\n * DI-free on purpose: this may be bundled by React or Angular, so it ships no inversify and no\n * @webpieces/core-context (which is AsyncLocalStorage-backed and Node-only). Browsers have no\n * ambient request scope, so the app holds a {@link MutableContextStore} and sets context values\n * as they become known; every outbound call then transfers them as headers.\n *\n * Usage:\n * ```typescript\n * import { ClientHttpBrowserFactory, ClientConfig, MutableContextStore } from '@webpieces/http-client-browser';\n *\n * HeaderRegistry.configure(CompanyHeaders.ALL_HEADERS, true);\n * const store = new MutableContextStore();\n * const factory = new ClientHttpBrowserFactory(store);\n *\n * const client = factory.createRpcClient(SaveApi, new ClientConfig('save-svc'));\n * const response = await client.save({ query: 'test' });\n * ```\n *\n * The server twin is @webpieces/http-client-node.\n */\n\nexport { ClientHttpBrowserFactory } from './ClientHttpBrowserFactory';\nexport { BrowserProxyClient } from './BrowserProxyClient';\n// Browser impl of the ApiCallContext seam, constructed by BrowserProxyClient. Exported so a\n// browser/Angular logger can read the current tag via the STATIC BrowserApiCallContext.snapshot()\n// and fold it into log lines.\nexport { BrowserApiCallContext } from './BrowserApiCallContext';\nexport { ClientConfig } from './ClientConfig';\nexport { MutableContextStore } from './MutableContextStore';\nexport type { RequestLifecycleListener } from './RequestLifecycleListener';\n\n// The isomorphic engine, re-exported so a browser app needs one import.\nexport { ProxyClient, ClientErrorTranslator, RequestOutcome } from '@webpieces/http-client-core';\nexport type { ApiPrototype } from '@webpieces/http-client-core';\nexport { StreamingCapabilityError } from '@webpieces/http-client-core';\n\n// ContextMgr is the BROWSER's outbound-header propagation. This is the only package that may use\n// it; the server reads RequestContext directly (RequestContextHeaders in @webpieces/core-context).\nexport { ContextMgr } from '@webpieces/core-util';\n\n// Re-export the context-key contract from core-util for convenience (browser one-import)\nexport {\n    ContextReader,\n    ContextWriter,\n    ContextStore,\n    ContextKey,\n    HeaderRegistry,\n    ClientRegistry,\n    templateDeriver,\n    WebpiecesCoreHeaders,\n} from '@webpieces/core-util';\nexport type { ServiceUrlDeriver } from '@webpieces/core-util';\n\n// Re-export API decorators for convenience (same as http-routing does)\nexport {\n    ApiPath,\n    Endpoint,\n    PathParam,\n    QueryParam,\n    WpAuthPublic,\n    WpAuth,\n    WpAuthorization,\n    AuthorizationType,\n    WpLocalOnly,\n    jwt,\n    oidc,\n    sharedSecret,\n    webhook,\n    apiKey,\n    Rpc,\n    PubSub,\n    Queue,\n    ValidateImplementation,\n} from '@webpieces/core-util';\n\n// The browser host's wiring: bind modules only (no route channel), the Binder they configure, and\n// the ExternalImpl recipes (UseClass / UseExisting) Binder.bindExternal takes.\nexport type { Wiring, AppWiring, BindModule } from './Wiring';\nexport { Binder, ClientBindOptions, BrowserWiringProviders } from './Wiring';\nexport { ExternalImpl, UseClass, UseExisting } from './ExternalImpl';\nexport type { ExternalClassType, ExternalExistingType } from './ExternalImpl';\nexport { BrowserValueProvider, BrowserClassProvider, BrowserExistingProvider, BrowserFactoryProvider } from './BrowserProviders';\nexport type { BrowserProvider, BrowserToken, BrowserType } from './BrowserProviders';\n\nexport { WiringPolicy } from '@webpieces/http-client-core';\n"]}

package/src/RpcClientProviderCompileAssertions.d.ts

@@ -1,4 +0,0 @@
-/** Compiled fixtures protect token/API inference after removing destination wrappers. */
-export declare class RpcClientProviderCompileAssertions {
-    check(): void;
-}

package/src/RpcClientProviderCompileAssertions.js

@@ -1,22 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.RpcClientProviderCompileAssertions = void 0;
-const RpcClientProvider_1 = require("./RpcClientProvider");
-class TextApi {
-}
-class CountApi {
-}
-/** Compiled fixtures protect token/API inference after removing destination wrappers. */
-class RpcClientProviderCompileAssertions {
-    check() {
-        (0, RpcClientProvider_1.provideRpcClient)(TextApi, TextApi, 'text-service');
-        // @ts-expect-error Class tokens must match the API contract.
-        (0, RpcClientProvider_1.provideRpcClient)(CountApi, TextApi, 'text-service');
-        // @ts-expect-error A service destination is required.
-        (0, RpcClientProvider_1.provideRpcClient)(TextApi, TextApi);
-        // @ts-expect-error Wrapper destinations were removed; use a service string.
-        (0, RpcClientProvider_1.provideRpcClient)(TextApi, TextApi, { serviceName: 'text-service' });
-    }
-}
-exports.RpcClientProviderCompileAssertions = RpcClientProviderCompileAssertions;
-//# sourceMappingURL=RpcClientProviderCompileAssertions.js.map

package/src/RpcClientProviderCompileAssertions.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"RpcClientProviderCompileAssertions.js","sourceRoot":"","sources":["../../../../../packages/http/http-client-browser/src/RpcClientProviderCompileAssertions.ts"],"names":[],"mappings":";;;AAAA,2DAAuD;AAEvD,MAAe,OAAO;CAA6B;AACnD,MAAe,QAAQ;CAA6B;AAEpD,yFAAyF;AACzF,MAAa,kCAAkC;IAC3C,KAAK;QACD,IAAA,oCAAgB,EAAC,OAAO,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC;QACnD,6DAA6D;QAC7D,IAAA,oCAAgB,EAAC,QAAQ,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC;QACpD,sDAAsD;QACtD,IAAA,oCAAgB,EAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACnC,4EAA4E;QAC5E,IAAA,oCAAgB,EAAC,OAAO,EAAE,OAAO,EAAE,EAAE,WAAW,EAAE,cAAc,EAAE,CAAC,CAAC;IACxE,CAAC;CACJ;AAVD,gFAUC","sourcesContent":["import { provideRpcClient } from './RpcClientProvider';\n\nabstract class TextApi { abstract read(): string; }\nabstract class CountApi { abstract read(): number; }\n\n/** Compiled fixtures protect token/API inference after removing destination wrappers. */\nexport class RpcClientProviderCompileAssertions {\n    check(): void {\n        provideRpcClient(TextApi, TextApi, 'text-service');\n        // @ts-expect-error Class tokens must match the API contract.\n        provideRpcClient(CountApi, TextApi, 'text-service');\n        // @ts-expect-error A service destination is required.\n        provideRpcClient(TextApi, TextApi);\n        // @ts-expect-error Wrapper destinations were removed; use a service string.\n        provideRpcClient(TextApi, TextApi, { serviceName: 'text-service' });\n    }\n}\n"]}