@xyo-network/xl1-react-client-sdk 5.0.13 → 5.0.15

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -11,6 +11,8 @@ export interface InPageGatewaysProviderProps extends PropsWithChildren {
11
11
  signerAccount?: AccountInstance;
12
12
  /** Factory that supplies the signer used by mutation providers. */
13
13
  signerFactory?: CreatableProviderFactory;
14
+ /** Stable config identifier for signerFactory; defaults to its providerName. */
15
+ signerProviderId?: string;
14
16
  /** Optional RPC transport used to reach a remote signer. */
15
17
  signerTransport?: RpcTransport<XyoSignerRpcSchemas>;
16
18
  /** Chain-data transport mode; defaults to JSON-RPC and may be set to static REST. */
@@ -31,10 +33,9 @@ export interface InPageGatewaysProviderProps extends PropsWithChildren {
31
33
  * expose whichever gateway their subtree cares about.
32
34
  *
33
35
  * Unlike `WalletGatewayProvider`, gateways here are owned by the page — no
34
- * browser wallet extension is required. Read-only REST gateways launch one
35
- * config-resolved XL1 browser system per network. RPC gateways and REST
36
- * gateways with an in-page signing capability retain the direct
37
- * `buildGateway` compatibility path.
36
+ * browser wallet extension is required. Every gateway launches one
37
+ * config-resolved XL1 browser system per network, regardless of transport or
38
+ * signing mode.
38
39
  *
39
40
  * `transport` selects how each gateway reads chain data: `'rpc'` (the
40
41
  * default viewer/runner locator, reads over RPC) or `'rest'` (the
@@ -46,11 +47,9 @@ export interface InPageGatewaysProviderProps extends PropsWithChildren {
46
47
  * `Promise.allSettled`. Networks that resolve populate `gateways[id]`;
47
48
  * networks that reject populate `errors[id]`. One failed network does
48
49
  * not block the others.
49
- * - Read-only REST gateways are resolved once through browser-kit and share
50
- * one immutable provider graph with their XL1 system actor. The page owns
51
- * each session until React cleanup or `pagehide`.
52
- * - If a signing capability is provided, gateways are built through the
53
- * existing *runner* compatibility path.
50
+ * - Every gateway is resolved once through browser-kit and shares one
51
+ * immutable provider graph with its XL1 system actor. The page owns each
52
+ * session until React cleanup or `pagehide`.
54
53
  * - When `signerTransport` changes identity mid-life, the provider clears
55
54
  * all cached gateways and errors synchronously during render (via
56
55
  * `previousSignerTransport` state) so consumers never see gateways
@@ -1 +1 @@
1
- {"version":3,"file":"Provider.d.ts","sourceRoot":"","sources":["../../../../../src/client/context/in-page/Provider.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AACvD,OAAO,KAAK,EACV,wBAAwB,EACX,YAAY,EAAE,mBAAmB,EAC/C,MAAM,sBAAsB,CAAA;AAE7B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAA;AAC9C,OAAO,KAGN,MAAM,OAAO,CAAA;AAKd,OAAO,EAEL,KAAK,gBAAgB,EAGtB,MAAM,gBAAgB,CAAA;AAKvB,iEAAiE;AACjE,MAAM,WAAW,2BAA4B,SAAQ,iBAAiB;IAEpE,kGAAkG;IAClG,aAAa,CAAC,EAAE,MAAM,CAAA;IAEtB,4FAA4F;IAC5F,aAAa,CAAC,EAAE,eAAe,CAAA;IAE/B,mEAAmE;IACnE,aAAa,CAAC,EAAE,wBAAwB,CAAA;IAExC,4DAA4D;IAC5D,eAAe,CAAC,EAAE,YAAY,CAAC,mBAAmB,CAAC,CAAA;IAEnD,qFAAqF;IACrF,SAAS,CAAC,EAAE,gBAAgB,CAAA;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DG;AACH,eAAO,MAAM,sBAAsB,EAAE,KAAK,CAAC,EAAE,CAAC,2BAA2B,CAqGxE,CAAA"}
1
+ {"version":3,"file":"Provider.d.ts","sourceRoot":"","sources":["../../../../../src/client/context/in-page/Provider.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AACvD,OAAO,KAAK,EACV,wBAAwB,EACX,YAAY,EAAE,mBAAmB,EAC/C,MAAM,sBAAsB,CAAA;AAE7B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAA;AAC9C,OAAO,KAGN,MAAM,OAAO,CAAA;AAKd,OAAO,EACL,KAAK,gBAAgB,EAGtB,MAAM,gBAAgB,CAAA;AAKvB,iEAAiE;AACjE,MAAM,WAAW,2BAA4B,SAAQ,iBAAiB;IAEpE,kGAAkG;IAClG,aAAa,CAAC,EAAE,MAAM,CAAA;IAEtB,4FAA4F;IAC5F,aAAa,CAAC,EAAE,eAAe,CAAA;IAE/B,mEAAmE;IACnE,aAAa,CAAC,EAAE,wBAAwB,CAAA;IACxC,gFAAgF;IAChF,gBAAgB,CAAC,EAAE,MAAM,CAAA;IAEzB,4DAA4D;IAC5D,eAAe,CAAC,EAAE,YAAY,CAAC,mBAAmB,CAAC,CAAA;IAEnD,qFAAqF;IACrF,SAAS,CAAC,EAAE,gBAAgB,CAAA;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AACH,eAAO,MAAM,sBAAsB,EAAE,KAAK,CAAC,EAAE,CAAC,2BAA2B,CAqGxE,CAAA"}
@@ -28,6 +28,8 @@ export type GatewayTransport = 'rpc' | 'rest';
28
28
  * - `transport` — how chain data is read. Defaults to `'rpc'`.
29
29
  * - `signerAccount` — a signing account the page owns; seeds the context signer home and
30
30
  * registers a `SimpleXyoSigner`. Precedence: `signerFactory` › `signerAccount` › `signerTransport`.
31
+ * @deprecated Direct-locator compatibility only. Use `launchXl1BrowserGatewaySystem` and retain
32
+ * its session so the owning browser realm can stop the provider system.
31
33
  */
32
34
  export declare const buildGateway: (gatewayName: GatewayName, localEndpoint: string, signerTransport?: RpcTransport<XyoSignerRpcSchemas>, signerFactory?: CreatableProviderFactory, transport?: GatewayTransport, signerAccount?: AccountInstance) => Promise<ContextGatewayType>;
33
35
  //# sourceMappingURL=buildGateway.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"buildGateway.d.ts","sourceRoot":"","sources":["../../../../../../src/client/context/in-page/lib/buildGateway.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AACvD,OAAO,KAAK,EACV,wBAAwB,EACxB,WAAW,EAGX,YAAY,EAEZ,mBAAmB,EACpB,MAAM,sBAAsB,CAAA;AAY7B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAEjE,8GAA8G;AAC9G,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,MAAM,CAAA;AAE7C;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,YAAY,GACvB,aAAa,WAAW,EACxB,eAAe,MAAM,EACrB,kBAAkB,YAAY,CAAC,mBAAmB,CAAC,EACnD,gBAAgB,wBAAwB,EACxC,YAAW,gBAAwB,EACnC,gBAAgB,eAAe,KAC9B,OAAO,CAAC,kBAAkB,CA2C5B,CAAA"}
1
+ {"version":3,"file":"buildGateway.d.ts","sourceRoot":"","sources":["../../../../../../src/client/context/in-page/lib/buildGateway.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AACvD,OAAO,KAAK,EACV,wBAAwB,EACxB,WAAW,EAGX,YAAY,EAEZ,mBAAmB,EACpB,MAAM,sBAAsB,CAAA;AAY7B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAEjE,8GAA8G;AAC9G,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,MAAM,CAAA;AAE7C;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,YAAY,GACvB,aAAa,WAAW,EACxB,eAAe,MAAM,EACrB,kBAAkB,YAAY,CAAC,mBAAmB,CAAC,EACnD,gBAAgB,wBAAwB,EACxC,YAAW,gBAAwB,EACnC,gBAAgB,eAAe,KAC9B,OAAO,CAAC,kBAAkB,CA2C5B,CAAA"}
@@ -1,10 +1,12 @@
1
- import type { GatewayName } from '@xyo-network/xl1-sdk';
1
+ import type { AccountInstance } from '@xyo-network/sdk';
2
+ import type { CreatableProviderFactory, GatewayName, RpcTransport, XyoSignerRpcSchemas } from '@xyo-network/xl1-sdk';
2
3
  import type { ContextGatewayType } from '../../../types/index.ts';
4
+ import type { GatewayTransport } from './buildGateway.ts';
3
5
  /** Page-owned browser-system session exposing the gateway expected by the React context. */
4
6
  export interface InPageGatewaySystem {
5
7
  readonly gateway: ContextGatewayType;
6
8
  stop(): Promise<void>;
7
9
  }
8
- /** Launches one read-only REST browser system for a configured XL1 network. */
9
- export declare function launchInPageGatewaySystem(gatewayName: GatewayName, localEndpoint: string): Promise<InPageGatewaySystem>;
10
+ /** Launches one page-owned REST/RPC browser system for a configured XL1 network. */
11
+ export declare function launchInPageGatewaySystem(gatewayName: GatewayName, localEndpoint: string, signerTransport?: RpcTransport<XyoSignerRpcSchemas>, signerFactory?: CreatableProviderFactory, transport?: GatewayTransport, signerAccount?: AccountInstance, signerProviderId?: string): Promise<InPageGatewaySystem>;
10
12
  //# sourceMappingURL=launchInPageGatewaySystem.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"launchInPageGatewaySystem.d.ts","sourceRoot":"","sources":["../../../../../../src/client/context/in-page/lib/launchInPageGatewaySystem.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAMvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAIjE,4FAA4F;AAC5F,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAA;IACpC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACtB;AAED,+EAA+E;AAC/E,wBAAsB,yBAAyB,CAC7C,WAAW,EAAE,WAAW,EACxB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,mBAAmB,CAAC,CAkC9B"}
1
+ {"version":3,"file":"launchInPageGatewaySystem.d.ts","sourceRoot":"","sources":["../../../../../../src/client/context/in-page/lib/launchInPageGatewaySystem.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAEvD,OAAO,KAAK,EACV,wBAAwB,EACxB,WAAW,EACX,YAAY,EACZ,mBAAmB,EACpB,MAAM,sBAAsB,CAAA;AAM7B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAIzD,4FAA4F;AAC5F,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAA;IACpC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACtB;AAED,oFAAoF;AACpF,wBAAsB,yBAAyB,CAC7C,WAAW,EAAE,WAAW,EACxB,aAAa,EAAE,MAAM,EACrB,eAAe,CAAC,EAAE,YAAY,CAAC,mBAAmB,CAAC,EACnD,aAAa,CAAC,EAAE,wBAAwB,EACxC,SAAS,GAAE,gBAAyB,EACpC,aAAa,CAAC,EAAE,eAAe,EAC/B,gBAAgB,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC,mBAAmB,CAAC,CAuB9B"}
@@ -2205,49 +2205,33 @@ var buildGateway = async (gatewayName, localEndpoint, signerTransport, signerFac
2205
2205
 
2206
2206
  // src/client/context/in-page/lib/launchInPageGatewaySystem.ts
2207
2207
  import { assertEx as assertEx4 } from "@ariestools/sdk";
2208
- import {
2209
- createXl1RestBrowserSystemConfig,
2210
- launchXl1BrowserSystem,
2211
- Xl1BrowserSystemActor
2212
- } from "@xyo-network/xl1-browser-system";
2208
+ import { launchXl1BrowserGatewaySystem } from "@xyo-network/xl1-browser-system";
2213
2209
  import {
2214
2210
  DefaultNetworks as DefaultNetworks2,
2215
2211
  LocalNetwork as LocalNetwork3
2216
2212
  } from "@xyo-network/xl1-sdk";
2217
2213
  var PAGE_HOST = "page";
2218
- async function launchInPageGatewaySystem(gatewayName, localEndpoint) {
2214
+ async function launchInPageGatewaySystem(gatewayName, localEndpoint, signerTransport, signerFactory, transport = "rest", signerAccount, signerProviderId) {
2219
2215
  const network = DefaultNetworks2.find((network2) => network2.id === gatewayName);
2220
2216
  const resolvedNetwork = assertEx4(network, () => `No network found for id ${gatewayName}`);
2221
2217
  const isLocal = resolvedNetwork.id === LocalNetwork3.id;
2222
- const endpoint = isLocal ? localEndpoint : `https://${resolvedNetwork.id}.xyo.space`;
2223
- const config = createXl1RestBrowserSystemConfig({
2218
+ const rpcUrl = `${resolvedNetwork.url}/rpc`;
2219
+ const endpoint = transport === "rpc" ? rpcUrl : isLocal ? localEndpoint : `https://${resolvedNetwork.id}.xyo.space`;
2220
+ const session = await launchXl1BrowserGatewaySystem({
2224
2221
  endpoint,
2225
2222
  host: PAGE_HOST,
2226
- layout: isLocal ? "path" : "subdomain"
2223
+ layout: transport === "rest" && isLocal ? "path" : "subdomain",
2224
+ rpcUrl,
2225
+ signerAccount,
2226
+ signerFactory,
2227
+ signerProviderId,
2228
+ signerTransport,
2229
+ transport
2227
2230
  });
2228
- const session = await launchXl1BrowserSystem({
2229
- config,
2230
- host: PAGE_HOST
2231
- });
2232
- try {
2233
- const actor = session.actors.find((actor2) => actor2 instanceof Xl1BrowserSystemActor);
2234
- const resolvedActor = assertEx4(actor, () => `XL1 browser system actor was not created for ${gatewayName}`);
2235
- const gateway = await resolvedActor.getGateway();
2236
- return {
2237
- gateway,
2238
- stop: async () => await session.stop()
2239
- };
2240
- } catch (launchError) {
2241
- const [stopResult] = await Promise.allSettled([session.stop()]);
2242
- if (stopResult.status === "rejected") {
2243
- throw new AggregateError(
2244
- [launchError, stopResult.reason],
2245
- `XL1 browser system for ${gatewayName} failed to expose a gateway and stop cleanly`,
2246
- { cause: launchError }
2247
- );
2248
- }
2249
- throw launchError;
2250
- }
2231
+ return {
2232
+ gateway: session.gateway,
2233
+ stop: async () => await session.stop()
2234
+ };
2251
2235
  }
2252
2236
 
2253
2237
  // src/client/context/in-page/Provider.tsx
@@ -2266,6 +2250,7 @@ var InPageGatewaysProvider = ({
2266
2250
  localEndpoint = DEFAULT_LOCAL_ENDPOINT,
2267
2251
  signerAccount,
2268
2252
  signerFactory,
2253
+ signerProviderId,
2269
2254
  signerTransport,
2270
2255
  transport = "rpc",
2271
2256
  children
@@ -2288,28 +2273,32 @@ var InPageGatewaysProvider = ({
2288
2273
  if (cancelled) return;
2289
2274
  const results = await Promise.allSettled(
2290
2275
  DefaultNetworks3.map(async (network) => {
2291
- if (transport === "rest" && signerAccount === void 0 && signerFactory === void 0 && signerTransport === void 0) {
2292
- const system = await launchInPageGatewaySystem(network.id, localEndpoint);
2293
- if (cancelled) {
2294
- await Promise.allSettled([system.stop()]);
2295
- return { id: network.id, gateway: system.gateway };
2296
- }
2297
- const disposePageLifecycle = bindPageLifecycle(system, {
2298
- onStopError: (error) => {
2299
- if (cancelled) return;
2300
- startTransition(() => {
2301
- setErrors((previous) => ({
2302
- ...previous,
2303
- [network.id]: error instanceof Error ? error : new Error(String(error))
2304
- }));
2305
- });
2306
- }
2307
- });
2308
- ownedSystems.push({ disposePageLifecycle, system });
2276
+ const system = await launchInPageGatewaySystem(
2277
+ network.id,
2278
+ localEndpoint,
2279
+ signerTransport,
2280
+ signerFactory,
2281
+ transport,
2282
+ signerAccount,
2283
+ signerProviderId
2284
+ );
2285
+ if (cancelled) {
2286
+ await Promise.allSettled([system.stop()]);
2309
2287
  return { id: network.id, gateway: system.gateway };
2310
2288
  }
2311
- const gateway = await buildGateway(network.id, localEndpoint, signerTransport, signerFactory, transport, signerAccount);
2312
- return { id: network.id, gateway };
2289
+ const disposePageLifecycle = bindPageLifecycle(system, {
2290
+ onStopError: (error) => {
2291
+ if (cancelled) return;
2292
+ startTransition(() => {
2293
+ setErrors((previous) => ({
2294
+ ...previous,
2295
+ [network.id]: error instanceof Error ? error : new Error(String(error))
2296
+ }));
2297
+ });
2298
+ }
2299
+ });
2300
+ ownedSystems.push({ disposePageLifecycle, system });
2301
+ return { id: network.id, gateway: system.gateway };
2313
2302
  })
2314
2303
  );
2315
2304
  if (!cancelled) {
@@ -2335,7 +2324,7 @@ var InPageGatewaysProvider = ({
2335
2324
  for (const owned of ownedSystems) owned.disposePageLifecycle();
2336
2325
  void Promise.allSettled(ownedSystems.map(async (owned) => await owned.system.stop()));
2337
2326
  };
2338
- }, [localEndpoint, signerAccount, signerFactory, signerTransport, transport]);
2327
+ }, [localEndpoint, signerAccount, signerFactory, signerProviderId, signerTransport, transport]);
2339
2328
  const value = useMemo6(() => {
2340
2329
  const value2 = {
2341
2330
  clearAll,