@webpieces/http-client-browser 0.3.380 → 0.3.381

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webpieces/http-client-browser",
-  "version": "0.3.380",
+  "version": "0.3.381",
   "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.3.380",
-    "@webpieces/http-client-core": "0.3.380"
+    "@webpieces/core-util": "0.3.381",
+    "@webpieces/http-client-core": "0.3.381"
   }
 }

package/src/BrowserProxyClient.d.ts

@@ -17,6 +17,17 @@ export declare class BrowserProxyClient extends ProxyClient {
     constructor(contextMgr: ContextMgr);
     /** Bind this client to one API contract + base URL. */
     init(apiPrototype: ApiPrototype<object>, config: ClientConfig): void;
+    /**
+     * The same chain every client runs — a ClientRegistry mapping, else the installed deriver — but
+     * with the BROWSER's fallback: `''`, which makes the URL RELATIVE (`/auth/oauth`) and therefore
+     * same-origin, by definition. A browser app almost always calls the backend that served it, so
+     * that is the default, and an unregistered svcName must NEVER throw the way it used to — a
+     * forgotten registration silently killed sign-in, the request never leaving the page.
+     *
+     * A mapping still wins, which is exactly how an Angular dev server on :4201 reaches its backend
+     * on :8201, while the same bundle served BY that backend in prod registers nothing and goes
+     * relative. No `window` access, so this stays SSR-safe and testable.
+     */
     protected resolveBaseUrl(): Promise<string>;
     protected outboundHeaders(): Map<string, string>;
     /**

package/src/BrowserProxyClient.js

@@ -25,10 +25,19 @@ class BrowserProxyClient extends http_client_core_1.ProxyClient {
         this.config = config;
         this.initRoutes(apiPrototype);
     }
-    resolveBaseUrl() {
-        // A browser cannot derive a GCP URL, so it resolves purely via the registry, which the app
-        // populates at startup (per environment). lookup() throws if the svcName was not registered.
-        return Promise.resolve(core_util_1.ClientRegistry.lookup(this.config.svcName));
+    /**
+     * The same chain every client runs — a ClientRegistry mapping, else the installed deriver — but
+     * with the BROWSER's fallback: `''`, which makes the URL RELATIVE (`/auth/oauth`) and therefore
+     * same-origin, by definition. A browser app almost always calls the backend that served it, so
+     * that is the default, and an unregistered svcName must NEVER throw the way it used to — a
+     * forgotten registration silently killed sign-in, the request never leaving the page.
+     *
+     * A mapping still wins, which is exactly how an Angular dev server on :4201 reaches its backend
+     * on :8201, while the same bundle served BY that backend in prod registers nothing and goes
+     * relative. No `window` access, so this stays SSR-safe and testable.
+     */
+    async resolveBaseUrl() {
+        return (await core_util_1.ClientRegistry.tryResolve(this.config.svcName)) ?? '';
     }
     outboundHeaders() {
         return this.contextMgr.buildOutboundHeaders();

package/src/BrowserProxyClient.js.map

@@ -1 +1 @@
-{"version":3,"file":"BrowserProxyClient.js","sourceRoot":"","sources":["../../../../../packages/http/http-client-browser/src/BrowserProxyClient.ts"],"names":[],"mappings":";;;AAAA,oDAA4E;AAC5E,kEAAwE;AAGxE;;;;;;;;;GASG;AACH,MAAa,kBAAmB,SAAQ,8BAAW;IAGlB;IAFrB,MAAM,CAAgB;IAE9B,YAA6B,UAAsB;QAC/C,KAAK,EAAE,CAAC;QADiB,eAAU,GAAV,UAAU,CAAY;IAEnD,CAAC;IAED,uDAAuD;IACvD,IAAI,CAAC,YAAkC,EAAE,MAAoB;QACzD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;IAClC,CAAC;IAEkB,cAAc;QAC7B,2FAA2F;QAC3F,6FAA6F;QAC7F,OAAO,OAAO,CAAC,OAAO,CAAC,0BAAc,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IACvE,CAAC;IAEkB,eAAe;QAC9B,OAAO,IAAI,CAAC,UAAU,CAAC,oBAAoB,EAAE,CAAC;IAClD,CAAC;IAED;;;;OAIG;IACgB,uBAAuB,CAAC,QAA8B,EAAE,UAAkB;QACzF,MAAM,IAAI,GAAG,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC;QACjC,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,eAAe,EAAE,CAAC;YAC9C,OAAO;QACX,CAAC;QACD,MAAM,IAAI,KAAK,CACX,YAAY,UAAU,QAAQ,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,kBAAkB,sBAAsB;YACrG,wGAAwG,CAC3G,CAAC;IACN,CAAC;CACJ;AAtCD,gDAsCC","sourcesContent":["import { AuthMeta, ContextMgr, ClientRegistry } from '@webpieces/core-util';\nimport { ApiPrototype, ProxyClient } from '@webpieces/http-client-core';\nimport { ClientConfig } from './ClientConfig';\n\n/**\n * The browser {@link ProxyClient}. Reads context from the app-held store (via {@link ContextMgr}),\n * because a browser has no ambient request scope.\n *\n * It attaches NO outbound credential and does NO recording — both inherit the base's no-ops. A\n * browser cannot mint an OIDC token and must never hold a shared secret; the user's JWT travels as\n * an ordinary transferred context key, set on the store at login.\n *\n * This is the ONLY class in webpieces that names ContextMgr.\n */\nexport class BrowserProxyClient extends ProxyClient {\n    private config!: ClientConfig;\n\n    constructor(private readonly contextMgr: ContextMgr) {\n        super();\n    }\n\n    /** Bind this client to one API contract + base URL. */\n    init(apiPrototype: ApiPrototype<object>, config: ClientConfig): void {\n        this.config = config;\n        this.initRoutes(apiPrototype);\n    }\n\n    protected override resolveBaseUrl(): Promise<string> {\n        // A browser cannot derive a GCP URL, so it resolves purely via the registry, which the app\n        // populates at startup (per environment). lookup() throws if the svcName was not registered.\n        return Promise.resolve(ClientRegistry.lookup(this.config.svcName));\n    }\n\n    protected override outboundHeaders(): Map<string, string> {\n        return this.contextMgr.buildOutboundHeaders();\n    }\n\n    /**\n     * Reject a contract this browser cannot satisfy, at bind time rather than on the first call.\n     * Both service-to-service modes need credentials only a server has: @AuthOidc needs a runtime\n     * service account to mint a token, @AuthSharedSecret needs a secret no browser may ship.\n     */\n    protected override assertEndpointSupported(authMeta: AuthMeta | undefined, methodName: string): void {\n        const kind = authMeta?.mode.kind;\n        if (kind !== 'oidc' && kind !== 'shared-secret') {\n            return;\n        }\n        throw new Error(\n            `Endpoint ${methodName} is @${kind === 'oidc' ? 'AuthOidc' : 'AuthSharedSecret'} — a browser cannot ` +\n            `hold service credentials. Call it server-side with ClientHttpFactory from @webpieces/http-client-node.`,\n        );\n    }\n}\n"]}
+{"version":3,"file":"BrowserProxyClient.js","sourceRoot":"","sources":["../../../../../packages/http/http-client-browser/src/BrowserProxyClient.ts"],"names":[],"mappings":";;;AAAA,oDAA4E;AAC5E,kEAAwE;AAGxE;;;;;;;;;GASG;AACH,MAAa,kBAAmB,SAAQ,8BAAW;IAGlB;IAFrB,MAAM,CAAgB;IAE9B,YAA6B,UAAsB;QAC/C,KAAK,EAAE,CAAC;QADiB,eAAU,GAAV,UAAU,CAAY;IAEnD,CAAC;IAED,uDAAuD;IACvD,IAAI,CAAC,YAAkC,EAAE,MAAoB;QACzD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;IAClC,CAAC;IAED;;;;;;;;;;OAUG;IACgB,KAAK,CAAC,cAAc;QACnC,OAAO,CAAC,MAAM,0BAAc,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;IACxE,CAAC;IAEkB,eAAe;QAC9B,OAAO,IAAI,CAAC,UAAU,CAAC,oBAAoB,EAAE,CAAC;IAClD,CAAC;IAED;;;;OAIG;IACgB,uBAAuB,CAAC,QAA8B,EAAE,UAAkB;QACzF,MAAM,IAAI,GAAG,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC;QACjC,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,eAAe,EAAE,CAAC;YAC9C,OAAO;QACX,CAAC;QACD,MAAM,IAAI,KAAK,CACX,YAAY,UAAU,QAAQ,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,kBAAkB,sBAAsB;YACrG,wGAAwG,CAC3G,CAAC;IACN,CAAC;CACJ;AA/CD,gDA+CC","sourcesContent":["import { AuthMeta, ContextMgr, ClientRegistry } from '@webpieces/core-util';\nimport { ApiPrototype, ProxyClient } from '@webpieces/http-client-core';\nimport { ClientConfig } from './ClientConfig';\n\n/**\n * The browser {@link ProxyClient}. Reads context from the app-held store (via {@link ContextMgr}),\n * because a browser has no ambient request scope.\n *\n * It attaches NO outbound credential and does NO recording — both inherit the base's no-ops. A\n * browser cannot mint an OIDC token and must never hold a shared secret; the user's JWT travels as\n * an ordinary transferred context key, set on the store at login.\n *\n * This is the ONLY class in webpieces that names ContextMgr.\n */\nexport class BrowserProxyClient extends ProxyClient {\n    private config!: ClientConfig;\n\n    constructor(private readonly contextMgr: ContextMgr) {\n        super();\n    }\n\n    /** Bind this client to one API contract + base URL. */\n    init(apiPrototype: ApiPrototype<object>, config: ClientConfig): void {\n        this.config = config;\n        this.initRoutes(apiPrototype);\n    }\n\n    /**\n     * The same chain every client runs — a ClientRegistry mapping, else the installed deriver — but\n     * with the BROWSER's fallback: `''`, which makes the URL RELATIVE (`/auth/oauth`) and therefore\n     * same-origin, by definition. A browser app almost always calls the backend that served it, so\n     * that is the default, and an unregistered svcName must NEVER throw the way it used to — a\n     * forgotten registration silently killed sign-in, the request never leaving the page.\n     *\n     * A mapping still wins, which is exactly how an Angular dev server on :4201 reaches its backend\n     * on :8201, while the same bundle served BY that backend in prod registers nothing and goes\n     * relative. No `window` access, so this stays SSR-safe and testable.\n     */\n    protected override async resolveBaseUrl(): Promise<string> {\n        return (await ClientRegistry.tryResolve(this.config.svcName)) ?? '';\n    }\n\n    protected override outboundHeaders(): Map<string, string> {\n        return this.contextMgr.buildOutboundHeaders();\n    }\n\n    /**\n     * Reject a contract this browser cannot satisfy, at bind time rather than on the first call.\n     * Both service-to-service modes need credentials only a server has: @AuthOidc needs a runtime\n     * service account to mint a token, @AuthSharedSecret needs a secret no browser may ship.\n     */\n    protected override assertEndpointSupported(authMeta: AuthMeta | undefined, methodName: string): void {\n        const kind = authMeta?.mode.kind;\n        if (kind !== 'oidc' && kind !== 'shared-secret') {\n            return;\n        }\n        throw new Error(\n            `Endpoint ${methodName} is @${kind === 'oidc' ? 'AuthOidc' : 'AuthSharedSecret'} — a browser cannot ` +\n            `hold service credentials. Call it server-side with ClientHttpFactory from @webpieces/http-client-node.`,\n        );\n    }\n}\n"]}

package/src/ClientConfig.d.ts

@@ -2,10 +2,11 @@
  * Per-client STATE for a browser HTTP client — nothing else. A plain class; it extends nothing and
  * is unrelated to the server package's ClientConfig.
  *
- * A browser cannot read `K_SERVICE`, so it cannot derive a Cloud Run URL. It resolves its base URL
- * entirely through the global {@link ClientRegistry} by `svcName` — the Angular app registers each
- * svcName at startup (from its per-environment config; on localhost that URL points at a local port,
- * in the cloud at the deployed host). So this config is just the svcName.
+ * The base URL is resolved from `svcName` through the global {@link ClientRegistry}: a registered
+ * mapping, else the installed deriver, else RELATIVE — i.e. the origin that served the page, which
+ * is what a browser app calling its own backend wants and needs NO configuration. Register a mapping
+ * only when the backend is somewhere else (an Angular dev server on :4201 reaching :8201). So this
+ * config is just the svcName, and an unregistered one never throws.
  *
  * The context store is NOT config: it is a dependency of {@link ClientHttpBrowserFactory}, shared
  * by every client it builds.

package/src/ClientConfig.js

@@ -5,10 +5,11 @@ exports.ClientConfig = void 0;
  * Per-client STATE for a browser HTTP client — nothing else. A plain class; it extends nothing and
  * is unrelated to the server package's ClientConfig.
  *
- * A browser cannot read `K_SERVICE`, so it cannot derive a Cloud Run URL. It resolves its base URL
- * entirely through the global {@link ClientRegistry} by `svcName` — the Angular app registers each
- * svcName at startup (from its per-environment config; on localhost that URL points at a local port,
- * in the cloud at the deployed host). So this config is just the svcName.
+ * The base URL is resolved from `svcName` through the global {@link ClientRegistry}: a registered
+ * mapping, else the installed deriver, else RELATIVE — i.e. the origin that served the page, which
+ * is what a browser app calling its own backend wants and needs NO configuration. Register a mapping
+ * only when the backend is somewhere else (an Angular dev server on :4201 reaching :8201). So this
+ * config is just the svcName, and an unregistered one never throws.
  *
  * The context store is NOT config: it is a dependency of {@link ClientHttpBrowserFactory}, shared
  * by every client it builds.

package/src/ClientConfig.js.map

@@ -1 +1 @@
-{"version":3,"file":"ClientConfig.js","sourceRoot":"","sources":["../../../../../packages/http/http-client-browser/src/ClientConfig.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;GAWG;AACH,MAAa,YAAY;IAGD;IAFpB;IACI,2FAA2F;IAC3E,OAAe;QAAf,YAAO,GAAP,OAAO,CAAQ;IAChC,CAAC;CACP;AALD,oCAKC","sourcesContent":["/**\n * Per-client STATE for a browser HTTP client — nothing else. A plain class; it extends nothing and\n * is unrelated to the server package's ClientConfig.\n *\n * A browser cannot read `K_SERVICE`, so it cannot derive a Cloud Run URL. It resolves its base URL\n * entirely through the global {@link ClientRegistry} by `svcName` — the Angular app registers each\n * svcName at startup (from its per-environment config; on localhost that URL points at a local port,\n * in the cloud at the deployed host). So this config is just the svcName.\n *\n * The context store is NOT config: it is a dependency of {@link ClientHttpBrowserFactory}, shared\n * by every client it builds.\n */\nexport class ClientConfig {\n    constructor(\n        /** Service name; resolved to a base URL via ClientRegistry (registered at app startup). */\n        public readonly svcName: string,\n    ) {}\n}\n"]}
+{"version":3,"file":"ClientConfig.js","sourceRoot":"","sources":["../../../../../packages/http/http-client-browser/src/ClientConfig.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;GAYG;AACH,MAAa,YAAY;IAGD;IAFpB;IACI,2FAA2F;IAC3E,OAAe;QAAf,YAAO,GAAP,OAAO,CAAQ;IAChC,CAAC;CACP;AALD,oCAKC","sourcesContent":["/**\n * Per-client STATE for a browser HTTP client — nothing else. A plain class; it extends nothing and\n * is unrelated to the server package's ClientConfig.\n *\n * The base URL is resolved from `svcName` through the global {@link ClientRegistry}: a registered\n * mapping, else the installed deriver, else RELATIVE — i.e. the origin that served the page, which\n * is what a browser app calling its own backend wants and needs NO configuration. Register a mapping\n * only when the backend is somewhere else (an Angular dev server on :4201 reaching :8201). So this\n * config is just the svcName, and an unregistered one never throws.\n *\n * The context store is NOT config: it is a dependency of {@link ClientHttpBrowserFactory}, shared\n * by every client it builds.\n */\nexport class ClientConfig {\n    constructor(\n        /** Service name; resolved to a base URL via ClientRegistry (registered at app startup). */\n        public readonly svcName: string,\n    ) {}\n}\n"]}

package/src/index.d.ts

@@ -30,5 +30,6 @@ export { MutableContextStore } from './MutableContextStore';
 export { ProxyClient, ClientErrorTranslator } from '@webpieces/http-client-core';
 export type { ApiPrototype } from '@webpieces/http-client-core';
 export { ContextMgr } from '@webpieces/core-util';
-export { ContextReader, ContextKey, HeaderRegistry, ClientRegistry, WebpiecesCoreHeaders, } from '@webpieces/core-util';
+export { ContextReader, ContextKey, HeaderRegistry, ClientRegistry, templateDeriver, WebpiecesCoreHeaders, } from '@webpieces/core-util';
+export type { ServiceUrlDeriver } from '@webpieces/core-util';
 export { ApiPath, Endpoint, Authentication, AuthenticationConfig, Public, AuthJwt, AuthOidc, AuthSharedSecret, Rpc, PubSub, Queue, ValidateImplementation, } from '@webpieces/core-util';

package/src/index.js

@@ -25,7 +25,7 @@
  * The server twin is @webpieces/http-client-node.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Queue = exports.PubSub = exports.Rpc = exports.AuthSharedSecret = exports.AuthOidc = exports.AuthJwt = exports.Public = exports.AuthenticationConfig = exports.Authentication = exports.Endpoint = exports.ApiPath = exports.WebpiecesCoreHeaders = exports.ClientRegistry = exports.HeaderRegistry = exports.ContextKey = exports.ContextMgr = exports.ClientErrorTranslator = exports.ProxyClient = exports.MutableContextStore = exports.ClientConfig = exports.BrowserProxyClient = exports.ClientHttpBrowserFactory = void 0;
+exports.Queue = exports.PubSub = exports.Rpc = exports.AuthSharedSecret = exports.AuthOidc = exports.AuthJwt = exports.Public = exports.AuthenticationConfig = exports.Authentication = exports.Endpoint = exports.ApiPath = exports.WebpiecesCoreHeaders = exports.templateDeriver = exports.ClientRegistry = exports.HeaderRegistry = exports.ContextKey = exports.ContextMgr = exports.ClientErrorTranslator = exports.ProxyClient = exports.MutableContextStore = exports.ClientConfig = 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");
@@ -47,6 +47,7 @@ var core_util_2 = require("@webpieces/core-util");
 Object.defineProperty(exports, "ContextKey", { enumerable: true, get: function () { return core_util_2.ContextKey; } });
 Object.defineProperty(exports, "HeaderRegistry", { enumerable: true, get: function () { return core_util_2.HeaderRegistry; } });
 Object.defineProperty(exports, "ClientRegistry", { enumerable: true, get: function () { return core_util_2.ClientRegistry; } });
+Object.defineProperty(exports, "templateDeriver", { enumerable: true, get: function () { return core_util_2.templateDeriver; } });
 Object.defineProperty(exports, "WebpiecesCoreHeaders", { enumerable: true, get: function () { return core_util_2.WebpiecesCoreHeaders; } });
 // Re-export API decorators for convenience (same as http-routing does)
 var core_util_3 = require("@webpieces/core-util");

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,+CAA8C;AAArC,4GAAA,YAAY,OAAA;AACrB,6DAA4D;AAAnD,0HAAA,mBAAmB,OAAA;AAE5B,wEAAwE;AACxE,gEAAiF;AAAxE,+GAAA,WAAW,OAAA;AAAE,yHAAA,qBAAqB,OAAA;AAG3C,iGAAiG;AACjG,mGAAmG;AACnG,kDAAkD;AAAzC,uGAAA,UAAU,OAAA;AAEnB,yFAAyF;AACzF,kDAM8B;AAJ1B,uGAAA,UAAU,OAAA;AACV,2GAAA,cAAc,OAAA;AACd,2GAAA,cAAc,OAAA;AACd,iHAAA,oBAAoB,OAAA;AAGxB,uEAAuE;AACvE,kDAa8B;AAZ1B,oGAAA,OAAO,OAAA;AACP,qGAAA,QAAQ,OAAA;AACR,2GAAA,cAAc,OAAA;AACd,iHAAA,oBAAoB,OAAA;AACpB,mGAAA,MAAM,OAAA;AACN,oGAAA,OAAO,OAAA;AACP,qGAAA,QAAQ,OAAA;AACR,6GAAA,gBAAgB,OAAA;AAChB,gGAAA,GAAG,OAAA;AACH,mGAAA,MAAM,OAAA;AACN,kGAAA,KAAK,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.getAllHeaders(), 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';\nexport { ClientConfig } from './ClientConfig';\nexport { MutableContextStore } from './MutableContextStore';\n\n// The isomorphic engine, re-exported so a browser app needs one import.\nexport { ProxyClient, ClientErrorTranslator } from '@webpieces/http-client-core';\nexport type { ApiPrototype } 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    ContextKey,\n    HeaderRegistry,\n    ClientRegistry,\n    WebpiecesCoreHeaders,\n} from '@webpieces/core-util';\n\n// Re-export API decorators for convenience (same as http-routing does)\nexport {\n    ApiPath,\n    Endpoint,\n    Authentication,\n    AuthenticationConfig,\n    Public,\n    AuthJwt,\n    AuthOidc,\n    AuthSharedSecret,\n    Rpc,\n    PubSub,\n    Queue,\n    ValidateImplementation,\n} from '@webpieces/core-util';\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,+CAA8C;AAArC,4GAAA,YAAY,OAAA;AACrB,6DAA4D;AAAnD,0HAAA,mBAAmB,OAAA;AAE5B,wEAAwE;AACxE,gEAAiF;AAAxE,+GAAA,WAAW,OAAA;AAAE,yHAAA,qBAAqB,OAAA;AAG3C,iGAAiG;AACjG,mGAAmG;AACnG,kDAAkD;AAAzC,uGAAA,UAAU,OAAA;AAEnB,yFAAyF;AACzF,kDAO8B;AAL1B,uGAAA,UAAU,OAAA;AACV,2GAAA,cAAc,OAAA;AACd,2GAAA,cAAc,OAAA;AACd,4GAAA,eAAe,OAAA;AACf,iHAAA,oBAAoB,OAAA;AAIxB,uEAAuE;AACvE,kDAa8B;AAZ1B,oGAAA,OAAO,OAAA;AACP,qGAAA,QAAQ,OAAA;AACR,2GAAA,cAAc,OAAA;AACd,iHAAA,oBAAoB,OAAA;AACpB,mGAAA,MAAM,OAAA;AACN,oGAAA,OAAO,OAAA;AACP,qGAAA,QAAQ,OAAA;AACR,6GAAA,gBAAgB,OAAA;AAChB,gGAAA,GAAG,OAAA;AACH,mGAAA,MAAM,OAAA;AACN,kGAAA,KAAK,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.getAllHeaders(), 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';\nexport { ClientConfig } from './ClientConfig';\nexport { MutableContextStore } from './MutableContextStore';\n\n// The isomorphic engine, re-exported so a browser app needs one import.\nexport { ProxyClient, ClientErrorTranslator } from '@webpieces/http-client-core';\nexport type { ApiPrototype } 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    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    Authentication,\n    AuthenticationConfig,\n    Public,\n    AuthJwt,\n    AuthOidc,\n    AuthSharedSecret,\n    Rpc,\n    PubSub,\n    Queue,\n    ValidateImplementation,\n} from '@webpieces/core-util';\n"]}