@xyo-network/xl1-browser-system 5.0.11 → 5.0.13

package/README.md

@@ -4,30 +4,248 @@ Config-driven XL1 provider actor systems for browser pages, workers, service
 workers, and extension background realms.
 
 The package adapts XL1's provider catalog to browser-kit's neutral planner.
-Configuration is parsed and resolved once, one XL1 `ProviderFactoryLocator` is
-provisioned in the owner realm, and every selected actor receives that same
-resolved provider system with its own actor configuration.
+Configuration is resolved once, one XL1 `ProviderFactoryLocator` is provisioned
+in the owner realm, and every selected actor receives that same resolved
+provider system with its own actor configuration.
+
+## Install
+
+Install the XL1 integration and only the realm adapters the application uses:
+
+```sh
+pnpm add @xyo-network/xl1-browser-system \
+  @ariestools/browser-kit-page \
+  @ariestools/browser-kit-worker \
+  @ariestools/browser-kit-service-worker \
+  @ariestools/browser-kit-plugin
+```
+
+## Configuration
+
+Create the configuration as data. The host selects which realm constructs the
+actor; it does not select a different provider graph for that actor.
+
+```ts
+import { createXl1RestBrowserSystemConfig } from '@xyo-network/xl1-browser-system'
+
+export function xl1ConfigFor(host: string) {
+  return createXl1RestBrowserSystemConfig({
+    endpoint: 'https://sample.mainnet.xyo.space',
+    host,
+  })
+}
+```
+
+The resulting object contains actor selections, named connections, and provider
+bindings. It contains no module paths or executable code.
+
+For local gateways that publish buckets under one path-based origin rather than
+the standard `blocks.*`, `state.*`, and `indexes.*` subdomains, set
+`layout: 'path'`:
+
+```ts
+const localConfig = createXl1RestBrowserSystemConfig({
+  endpoint: 'https://chain.aries.test:8791',
+  host: 'page',
+  layout: 'path',
+})
+```
+
+When adding a custom provider candidate, pass a stable explicit identifier to
+`providerCandidateFromClass`. Constructor names can be changed by production
+minifiers and must not become configuration identifiers:
 
 ```ts
+const candidate = providerCandidateFromClass(
+  MyBrowserProvider,
+  'com.example.my-browser-provider',
+)
+```
+
+## Page
+
+The page owns the system until navigation or discard:
+
+```ts
+import { bindPageLifecycle } from '@ariestools/browser-kit-page'
 import {
-  createXl1RestBrowserSystemConfig,
   launchXl1BrowserSystem,
   Xl1BrowserSystemActor,
 } from '@xyo-network/xl1-browser-system'
 
-const config = createXl1RestBrowserSystemConfig({
-  endpoint: 'https://sample.mainnet.xyo.space',
+import { xl1ConfigFor } from './xl1Config.ts'
+
+const session = await launchXl1BrowserSystem({
+  config: xl1ConfigFor('page'),
   host: 'page',
 })
-const session = await launchXl1BrowserSystem({ config, host: 'page' })
-const actor = session.actors[0] as Xl1BrowserSystemActor
+bindPageLifecycle(session, {
+  onStopError: error => console.error('XL1 page system failed to stop', error),
+})
+
+const actor = session.actors.find(actor => actor instanceof Xl1BrowserSystemActor)
+if (actor === undefined) throw new Error('XL1 page system actor was not created')
 const gateway = await actor.getGateway()
 const blockNumber = await gateway.connection.viewer?.block.currentBlockNumber()
+```
+
+See the [executable page example](https://github.com/XYOracleNetwork/xl1-protocol/blob/v/5/packages/browser-system/examples/page.ts).
+
+## Web worker
+
+The worker launches the same system and binds explicit shutdown handling:
+
+```ts
+/// <reference lib="webworker" />
+
+import { bindWorkerShutdown } from '@ariestools/browser-kit-worker'
+import { launchXl1BrowserSystem } from '@xyo-network/xl1-browser-system'
+
+import { xl1ConfigFor } from './xl1Config.ts'
+
+const session = await launchXl1BrowserSystem({
+  config: xl1ConfigFor('worker'),
+  host: 'worker',
+})
+bindWorkerShutdown(self, session, {
+  onStopError: error => console.error('XL1 worker system failed to stop', error),
+})
+```
+
+Create it from the owning page with a module worker. Send
+`{ type: 'browser-kit:shutdown' }` when the worker should stop and wait for the
+`browser-kit:stopped` acknowledgement before terminating it.
+
+```ts
+const worker = new Worker(new URL('./xl1.worker.ts', import.meta.url), {
+  type: 'module',
+})
+```
+
+See the executable [worker owner](https://github.com/XYOracleNetwork/xl1-protocol/blob/v/5/packages/browser-system/examples/xl1.worker.ts)
+and [page client](https://github.com/XYOracleNetwork/xl1-protocol/blob/v/5/packages/browser-system/examples/worker.ts).
+
+## Service worker
+
+A service worker reconstructs the system once per browser-managed worker
+incarnation. Attach every operation to the triggering event lifetime:
+
+```ts
+/// <reference lib="webworker" />
+
+import { ServiceWorkerSystemHost } from '@ariestools/browser-kit-service-worker'
+import {
+  launchXl1BrowserSystem,
+  Xl1BrowserSystemActor,
+} from '@xyo-network/xl1-browser-system'
+
+import { xl1ConfigFor } from './xl1Config.ts'
+
+const systemHost = new ServiceWorkerSystemHost(async () =>
+  await launchXl1BrowserSystem({
+    config: xl1ConfigFor('service-worker'),
+    host: 'service-worker',
+    identity: {
+      planId: 'my-xl1-service-worker:v1',
+      systemInstanceId: crypto.randomUUID(),
+    },
+  }))
+
+self.addEventListener('message', (event) => {
+  if (event.data?.type !== 'xl1-current-block') return
+  void systemHost.dispatch(event, async (session) => {
+    const actor = session.actors.find(actor => actor instanceof Xl1BrowserSystemActor)
+    if (actor === undefined) throw new Error('XL1 service-worker actor was not created')
+    const gateway = await actor.getGateway()
+    event.source?.postMessage({
+      blockNumber: await gateway.connection.viewer?.block.currentBlockNumber(),
+      type: 'xl1-current-block-result',
+    })
+  })
+})
+```
+
+Register the module service worker from a page and communicate with its active
+instance. Browser termination discards resident memory; the next event launches
+the same plan with a new `systemInstanceId`.
+
+```ts
+import serviceWorkerUrl from './xl1.service-worker.ts?worker&url'
+
+const registration = await navigator.serviceWorker.register(
+  serviceWorkerUrl,
+  { type: 'module' },
+)
+registration.active?.postMessage({ type: 'xl1-current-block' })
+```
+
+Timers are not durable service-worker triggers. Use browser events, alarms, or
+sync APIs, and keep durable state in providers rather than worker globals. See
+the executable [service worker](https://github.com/XYOracleNetwork/xl1-protocol/blob/v/5/packages/browser-system/examples/xl1.service-worker.ts)
+and [registration client](https://github.com/XYOracleNetwork/xl1-protocol/blob/v/5/packages/browser-system/examples/serviceWorker.ts).
+
+## Browser plugin or extension
+
+The extension background service worker owns the XL1 locator. Popups, side
+panels, and content scripts attach through an authorized extension port; they do
+not resolve a second provider system.
+
+```ts
+import { bindExtensionRuntimeBrowserSystemHost } from '@ariestools/browser-kit-plugin'
+import { ServiceWorkerSystemHost } from '@ariestools/browser-kit-service-worker'
+import type { XyoGateway } from '@xyo-network/xl1-sdk'
+import { XyoGatewayMoniker } from '@xyo-network/xl1-sdk'
+import { launchXl1BrowserSystem } from '@xyo-network/xl1-browser-system'
+
+const systemHost = new ServiceWorkerSystemHost(async () =>
+  await launchXl1BrowserSystem({
+    config,
+    host: 'extension-background',
+    identity: {
+      planId: 'my-extension-xl1:v1',
+      systemInstanceId: crypto.randomUUID(),
+    },
+  }))
+
+bindExtensionRuntimeBrowserSystemHost(chrome.runtime, {
+  authorize: port =>
+    (port.sender as { id?: string } | undefined)?.id === chrome.runtime.id,
+  channelName: 'my-extension-xl1',
+  getSession: async () => await systemHost.session(),
+  handlers: {
+    [XyoGatewayMoniker]: {
+      currentBlockNumber: async ({ instance }) =>
+        await (instance as XyoGateway).connection.viewer?.block.currentBlockNumber(),
+    },
+  },
+  onError: error => console.error('XL1 extension system failed', error),
+})
+```
+
+The required `authorize` callback is application policy. `planId` expresses
+compatibility and `systemInstanceId` detects stale clients; neither value
+authenticates a caller. Only explicitly registered provider operations cross
+the port.
+
+The complete Manifest V3 fixture includes both sides of the connection:
+
+- [background owner](https://github.com/XYOracleNetwork/xl1-protocol/blob/v/5/packages/browser-system/examples/extension/service-worker.ts)
+- [attached extension page](https://github.com/XYOracleNetwork/xl1-protocol/blob/v/5/packages/browser-system/examples/extension/client.ts)
+- [manifest](https://github.com/XYOracleNetwork/xl1-protocol/blob/v/5/packages/browser-system/examples/extension/public/manifest.json)
+
+Custody, permissions, storage, operation schemas, and sender policy remain
+application concerns.
+
+## Run the real-browser examples
+
+The repository includes a production-minified Vite build and Playwright suite.
+It performs a typed block-number read in every realm and forces Chromium to
+terminate and reconstruct both the standard and extension service workers:
 
-await session.stop()
+```sh
+pnpm --filter @xyo-network/xl1-browser-system test:e2e
 ```
 
 Browser-kit owns realm lifecycle and transport. This package owns only the XL1
 provider catalog, locator provisioning, standard actor, and XL1 configuration
-helpers. Wallet custody, extension authorization, storage, and sender policy
-remain application concerns.
+helpers.

package/dist/browser/Xl1BrowserConfig.d.ts

@@ -10,8 +10,11 @@ export interface CreateXl1RestBrowserSystemConfigOptions {
     readonly dataLakeEndpoint?: string;
     readonly endpoint: string;
     readonly host?: string;
+    readonly layout?: Xl1RestEndpointLayout;
     readonly primeCaches?: PrimeCachesMode;
 }
+/** How the REST gateway's finalized, chain-state, and index URLs are derived from its endpoint. */
+export type Xl1RestEndpointLayout = 'path' | 'subdomain';
 /** Parses XL1 locator fields and browser actor selections without importing code from config. */
 export declare function parseXl1BrowserSystemConfig(input: unknown): Xl1BrowserSystemConfig;
 /** Projects the XL1 config onto the neutral fields browser-kit compiles. */

package/dist/browser/Xl1BrowserConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Xl1BrowserConfig.d.ts","sourceRoot":"","sources":["../../src/Xl1BrowserConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qBAAqB,EACrB,mBAAmB,EACpB,MAAM,yBAAyB,CAAA;AAEhC,OAAO,KAAK,EAEV,aAAa,EACb,eAAe,EAEhB,MAAM,sBAAsB,CAAA;AAuB7B,iEAAiE;AACjE,MAAM,WAAW,sBAAuB,SAAQ,aAAa;IAC3D,QAAQ,CAAC,MAAM,EAAE,SAAS,qBAAqB,EAAE,CAAA;CAClD;AAED,yEAAyE;AACzE,MAAM,WAAW,uCAAuC;IACtD,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,qBAAqB,EAAE,CAAA;IAClD,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,eAAe,CAAA;CACvC;AAED,iGAAiG;AACjG,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,sBAAsB,CAWlF;AAED,4EAA4E;AAC5E,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,sBAAsB,GAC7B,mBAAmB,CAMrB;AAED,iGAAiG;AACjG,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,uCAAuC,GAC/C,sBAAsB,CAwCxB"}
+{"version":3,"file":"Xl1BrowserConfig.d.ts","sourceRoot":"","sources":["../../src/Xl1BrowserConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qBAAqB,EACrB,mBAAmB,EACpB,MAAM,yBAAyB,CAAA;AAEhC,OAAO,KAAK,EAEV,aAAa,EACb,eAAe,EAGhB,MAAM,sBAAsB,CAAA;AAyB7B,iEAAiE;AACjE,MAAM,WAAW,sBAAuB,SAAQ,aAAa;IAC3D,QAAQ,CAAC,MAAM,EAAE,SAAS,qBAAqB,EAAE,CAAA;CAClD;AAED,yEAAyE;AACzE,MAAM,WAAW,uCAAuC;IACtD,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,qBAAqB,EAAE,CAAA;IAClD,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,qBAAqB,CAAA;IACvC,QAAQ,CAAC,WAAW,CAAC,EAAE,eAAe,CAAA;CACvC;AAED,mGAAmG;AACnG,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,WAAW,CAAA;AAExD,iGAAiG;AACjG,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,sBAAsB,CAWlF;AAED,4EAA4E;AAC5E,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,sBAAsB,GAC7B,mBAAmB,CAMrB;AAED,iGAAiG;AACjG,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,uCAAuC,GAC/C,sBAAsB,CA0CxB"}

package/dist/browser/Xl1BrowserProvider.d.ts

@@ -1,6 +1,10 @@
 import type { BrowserSystemProvisioner } from '@ariestools/browser-kit';
 import type { CreatableProviderContext, ProviderDescriptor as Xl1ProviderDescriptor, ProviderFactoryLocatorInstance } from '@xyo-network/xl1-sdk';
 import type { Xl1BrowserSystemConfig } from './Xl1BrowserConfig.ts';
+/** Stable browser-provider identifier retained across production minification. */
+export declare const SimpleXyoConnectionViewerProviderId = "SimpleXyoConnectionViewer";
+/** Stable browser-provider identifier retained across production minification. */
+export declare const SimpleXyoGatewayProviderId = "SimpleXyoGateway";
 /** Browser-kit plan metadata retaining the XL1 provider class used by the provisioner. */
 export interface Xl1BrowserProviderDeclaration {
     readonly connectionTypes: readonly string[];

package/dist/browser/Xl1BrowserProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Xl1BrowserProvider.d.ts","sourceRoot":"","sources":["../../src/Xl1BrowserProvider.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAA;AAGvE,OAAO,KAAK,EAEV,wBAAwB,EAGxB,kBAAkB,IAAI,qBAAqB,EAC3C,8BAA8B,EAC/B,MAAM,sBAAsB,CAAA;AAU7B,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AAEnE,0FAA0F;AAC1F,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAA;IAC3C,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAA;IACxC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;IACpC,QAAQ,CAAC,GAAG,EAAE,qBAAqB,CAAA;CACpC;AAED,qFAAqF;AACrF,MAAM,MAAM,gCAAgC,GAAG,IAAI,CACjD,wBAAwB,EACxB,QAAQ,GAAG,SAAS,CACrB,CAAA;AAED,8DAA8D;AAC9D,MAAM,WAAW,wCAAwC;IACvD,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAA;IACvC,QAAQ,CAAC,OAAO,CAAC,EAAE,gCAAgC,CAAA;CACpD;AAED,gFAAgF;AAChF,wBAAgB,6BAA6B,CAC3C,UAAU,EAAE,qBAAqB,GAChC,6BAA6B,CAQ/B;AAED,kFAAkF;AAClF,wBAAgB,4BAA4B,IAAI,qBAAqB,EAAE,CAMtE;AAED,+DAA+D;AAC/D,wBAAgB,8BAA8B,CAC5C,UAAU,GAAE,SAAS,qBAAqB,EAAmC,GAC5E,6BAA6B,EAAE,CAEjC;AAED,sFAAsF;AACtF,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,wCAAwC,GAChD,wBAAwB,CAAC,8BAA8B,CAAC,CA8D1D"}
+{"version":3,"file":"Xl1BrowserProvider.d.ts","sourceRoot":"","sources":["../../src/Xl1BrowserProvider.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAA;AAGvE,OAAO,KAAK,EAEV,wBAAwB,EAGxB,kBAAkB,IAAI,qBAAqB,EAC3C,8BAA8B,EAC/B,MAAM,sBAAsB,CAAA;AAU7B,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AAEnE,kFAAkF;AAClF,eAAO,MAAM,mCAAmC,8BAA8B,CAAA;AAC9E,kFAAkF;AAClF,eAAO,MAAM,0BAA0B,qBAAqB,CAAA;AAE5D,0FAA0F;AAC1F,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAA;IAC3C,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAA;IACxC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;IACpC,QAAQ,CAAC,GAAG,EAAE,qBAAqB,CAAA;CACpC;AAED,qFAAqF;AACrF,MAAM,MAAM,gCAAgC,GAAG,IAAI,CACjD,wBAAwB,EACxB,QAAQ,GAAG,SAAS,CACrB,CAAA;AAED,8DAA8D;AAC9D,MAAM,WAAW,wCAAwC;IACvD,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAA;IACvC,QAAQ,CAAC,OAAO,CAAC,EAAE,gCAAgC,CAAA;CACpD;AAED,gFAAgF;AAChF,wBAAgB,6BAA6B,CAC3C,UAAU,EAAE,qBAAqB,GAChC,6BAA6B,CAQ/B;AAED,kFAAkF;AAClF,wBAAgB,4BAA4B,IAAI,qBAAqB,EAAE,CAMtE;AAED,+DAA+D;AAC/D,wBAAgB,8BAA8B,CAC5C,UAAU,GAAE,SAAS,qBAAqB,EAAmC,GAC5E,6BAA6B,EAAE,CAEjC;AAED,sFAAsF;AACtF,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,wCAAwC,GAChD,wBAAwB,CAAC,8BAA8B,CAAC,CA8D1D"}

package/dist/browser/index.mjs

@@ -14,131 +14,10 @@ import {
   parseLocatorConfigFields,
   restConnectionFromS3Bucket,
   restGatewayConfigFromEndpoint,
-  SimpleXyoConnectionViewer,
-  SimpleXyoGateway,
   XyoConnectionMoniker,
   XyoGatewayMoniker as XyoGatewayMoniker2
 } from "@xyo-network/xl1-sdk";
 
-// src/Xl1BrowserSystemActor.ts
-import { ProviderActor } from "@ariestools/actor";
-import { BrowserActorCatalog as BrowserActorCatalogInstance } from "@ariestools/browser-kit";
-import {
-  DataLakeViewerMoniker,
-  XyoGatewayMoniker
-} from "@xyo-network/xl1-sdk";
-var Xl1BrowserSystemActorType = "xl1-system";
-var Xl1BrowserSystemWithDataLakeActorType = "xl1-system-with-data-lake";
-var Xl1BrowserSystemActor = class extends ProviderActor {
-  /** Resolves the gateway owned by this actor's immutable provider system. */
-  async getGateway() {
-    if (this.status !== "started") {
-      throw new Error(`XL1 browser system actor is not running (status: ${this.status})`);
-    }
-    return await this.getProvider(XyoGatewayMoniker);
-  }
-};
-var Xl1BrowserSystemActorDependencies = [XyoGatewayMoniker];
-var Xl1BrowserSystemWithDataLakeActorDependencies = [
-  XyoGatewayMoniker,
-  DataLakeViewerMoniker
-];
-function createXl1BrowserActorCatalog() {
-  const catalog = new BrowserActorCatalogInstance();
-  const create = async (id, providerContext) => await Xl1BrowserSystemActor.create({
-    name: id,
-    providerContext
-  });
-  catalog.register({
-    create: async ({ id, providerContext }) => await create(
-      id,
-      providerContext
-    ),
-    dependencies: Xl1BrowserSystemActorDependencies,
-    type: Xl1BrowserSystemActorType
-  });
-  catalog.register({
-    create: async ({ id, providerContext }) => await create(
-      id,
-      providerContext
-    ),
-    dependencies: Xl1BrowserSystemWithDataLakeActorDependencies,
-    type: Xl1BrowserSystemWithDataLakeActorType
-  });
-  return catalog;
-}
-
-// src/Xl1BrowserConfig.ts
-function parseXl1BrowserSystemConfig(input) {
-  const locatorConfig = parseLocatorConfigFields(input);
-  const browserConfig = parseBrowserSystemConfig({
-    actors: isRecord(input) ? input["actors"] : void 0,
-    connections: locatorConfig.connections,
-    providerBindings: toBrowserProviderBindings(locatorConfig.providerBindings)
-  });
-  return Object.freeze({
-    ...locatorConfig,
-    actors: Object.freeze([...browserConfig.actors ?? []])
-  });
-}
-function toBrowserSystemConfig(config) {
-  return {
-    actors: config.actors,
-    connections: config.connections,
-    providerBindings: toBrowserProviderBindings(config.providerBindings)
-  };
-}
-function createXl1RestBrowserSystemConfig(options) {
-  const buckets = restGatewayConfigFromEndpoint(options.endpoint);
-  const finalized = buckets.finalized;
-  if (finalized === void 0) throw new Error("XL1 REST gateway has no finalized bucket");
-  const connections = {
-    "rest-chain-state": restConnectionFromS3Bucket(buckets.chainState ?? finalized),
-    "rest-finalized": restConnectionFromS3Bucket(finalized),
-    "rest-index": restConnectionFromS3Bucket(buckets.index ?? finalized)
-  };
-  const providerBindings = {
-    [BlockViewerMoniker]: { connection: "rest-finalized" },
-    [ChainContractViewerMoniker]: { connection: "rest-chain-state" },
-    [ChainStateViewerMoniker]: { connection: "rest-chain-state" },
-    [FinalizationViewerMoniker]: { connection: "rest-finalized" },
-    [IndexViewerMoniker]: { connection: "rest-index" },
-    [XyoConnectionMoniker]: { provider: SimpleXyoConnectionViewer.name },
-    [XyoGatewayMoniker2]: { provider: SimpleXyoGateway.name }
-  };
-  if (options.dataLakeEndpoint !== void 0) {
-    connections["rest-data-lake"] = {
-      baseUrl: options.dataLakeEndpoint,
-      type: "rest"
-    };
-    providerBindings[DataLakeViewerMoniker2] = { connection: "rest-data-lake" };
-  }
-  if (options.primeCaches !== void 0) {
-    providerBindings[NetworkStakeStepRewardsByPositionViewerMoniker] = { primeCaches: options.primeCaches };
-  }
-  return parseXl1BrowserSystemConfig({
-    actors: options.actors ?? [{
-      host: options.host,
-      type: options.dataLakeEndpoint === void 0 ? Xl1BrowserSystemActorType : Xl1BrowserSystemWithDataLakeActorType
-    }],
-    connections,
-    providerBindings
-  });
-}
-function toBrowserProviderBindings(bindings) {
-  return Object.fromEntries(Object.entries(bindings).map(([moniker, binding]) => [
-    moniker,
-    binding === void 0 ? {} : {
-      connection: binding.connection,
-      options: binding.options,
-      provider: binding.provider
-    }
-  ]));
-}
-function isRecord(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-
 // src/Xl1BrowserProvider.ts
 import { stopOrShutdown } from "@ariestools/actor";
 import { createResolvedBrowserProviderPlan } from "@ariestools/browser-kit";
@@ -148,9 +27,11 @@ import {
   compileLocatorConfig,
   providerCandidateFromClass,
   ProviderFactoryLocator,
-  SimpleXyoConnectionViewer as SimpleXyoConnectionViewer2,
-  SimpleXyoGateway as SimpleXyoGateway2
+  SimpleXyoConnectionViewer,
+  SimpleXyoGateway
 } from "@xyo-network/xl1-sdk";
+var SimpleXyoConnectionViewerProviderId = "SimpleXyoConnectionViewer";
+var SimpleXyoGatewayProviderId = "SimpleXyoGateway";
 function xl1BrowserProviderDeclaration(descriptor) {
   return Object.freeze({
     connectionTypes: Object.freeze([...descriptor.connectionTypes]),
@@ -163,8 +44,8 @@ function xl1BrowserProviderDeclaration(descriptor) {
 function xl1BrowserProviderCandidates() {
   return [
     ...allProviderCandidates(),
-    providerCandidateFromClass(SimpleXyoConnectionViewer2),
-    providerCandidateFromClass(SimpleXyoGateway2)
+    providerCandidateFromClass(SimpleXyoConnectionViewer, SimpleXyoConnectionViewerProviderId),
+    providerCandidateFromClass(SimpleXyoGateway, SimpleXyoGatewayProviderId)
   ];
 }
 function xl1BrowserProviderDeclarations(candidates = xl1BrowserProviderCandidates()) {
@@ -265,6 +146,133 @@ function isCreatableProviderInstance(value) {
   return typeof value === "object" && value !== null && "stop" in value && typeof value.stop === "function";
 }
 
+// src/Xl1BrowserSystemActor.ts
+import { ProviderActor } from "@ariestools/actor";
+import { BrowserActorCatalog as BrowserActorCatalogInstance } from "@ariestools/browser-kit";
+import {
+  DataLakeViewerMoniker,
+  XyoGatewayMoniker
+} from "@xyo-network/xl1-sdk";
+var Xl1BrowserSystemActorType = "xl1-system";
+var Xl1BrowserSystemWithDataLakeActorType = "xl1-system-with-data-lake";
+var Xl1BrowserSystemActor = class extends ProviderActor {
+  /** Resolves the gateway owned by this actor's immutable provider system. */
+  async getGateway() {
+    if (this.status !== "started") {
+      throw new Error(`XL1 browser system actor is not running (status: ${this.status})`);
+    }
+    return await this.getProvider(XyoGatewayMoniker);
+  }
+};
+var Xl1BrowserSystemActorDependencies = [XyoGatewayMoniker];
+var Xl1BrowserSystemWithDataLakeActorDependencies = [
+  XyoGatewayMoniker,
+  DataLakeViewerMoniker
+];
+function createXl1BrowserActorCatalog() {
+  const catalog = new BrowserActorCatalogInstance();
+  const create = async (id, providerContext) => await Xl1BrowserSystemActor.create({
+    name: id,
+    providerContext
+  });
+  catalog.register({
+    create: async ({ id, providerContext }) => await create(
+      id,
+      providerContext
+    ),
+    dependencies: Xl1BrowserSystemActorDependencies,
+    type: Xl1BrowserSystemActorType
+  });
+  catalog.register({
+    create: async ({ id, providerContext }) => await create(
+      id,
+      providerContext
+    ),
+    dependencies: Xl1BrowserSystemWithDataLakeActorDependencies,
+    type: Xl1BrowserSystemWithDataLakeActorType
+  });
+  return catalog;
+}
+
+// src/Xl1BrowserConfig.ts
+function parseXl1BrowserSystemConfig(input) {
+  const locatorConfig = parseLocatorConfigFields(input);
+  const browserConfig = parseBrowserSystemConfig({
+    actors: isRecord(input) ? input["actors"] : void 0,
+    connections: locatorConfig.connections,
+    providerBindings: toBrowserProviderBindings(locatorConfig.providerBindings)
+  });
+  return Object.freeze({
+    ...locatorConfig,
+    actors: Object.freeze([...browserConfig.actors ?? []])
+  });
+}
+function toBrowserSystemConfig(config) {
+  return {
+    actors: config.actors,
+    connections: config.connections,
+    providerBindings: toBrowserProviderBindings(config.providerBindings)
+  };
+}
+function createXl1RestBrowserSystemConfig(options) {
+  const buckets = options.layout === "path" ? restGatewayConfigFromPathEndpoint(options.endpoint) : restGatewayConfigFromEndpoint(options.endpoint);
+  const finalized = buckets.finalized;
+  if (finalized === void 0) throw new Error("XL1 REST gateway has no finalized bucket");
+  const connections = {
+    "rest-chain-state": restConnectionFromS3Bucket(buckets.chainState ?? finalized),
+    "rest-finalized": restConnectionFromS3Bucket(finalized),
+    "rest-index": restConnectionFromS3Bucket(buckets.index ?? finalized)
+  };
+  const providerBindings = {
+    [BlockViewerMoniker]: { connection: "rest-finalized" },
+    [ChainContractViewerMoniker]: { connection: "rest-chain-state" },
+    [ChainStateViewerMoniker]: { connection: "rest-chain-state" },
+    [FinalizationViewerMoniker]: { connection: "rest-finalized" },
+    [IndexViewerMoniker]: { connection: "rest-index" },
+    [XyoConnectionMoniker]: { provider: SimpleXyoConnectionViewerProviderId },
+    [XyoGatewayMoniker2]: { provider: SimpleXyoGatewayProviderId }
+  };
+  if (options.dataLakeEndpoint !== void 0) {
+    connections["rest-data-lake"] = {
+      baseUrl: options.dataLakeEndpoint,
+      type: "rest"
+    };
+    providerBindings[DataLakeViewerMoniker2] = { connection: "rest-data-lake" };
+  }
+  if (options.primeCaches !== void 0) {
+    providerBindings[NetworkStakeStepRewardsByPositionViewerMoniker] = { primeCaches: options.primeCaches };
+  }
+  return parseXl1BrowserSystemConfig({
+    actors: options.actors ?? [{
+      host: options.host,
+      type: options.dataLakeEndpoint === void 0 ? Xl1BrowserSystemActorType : Xl1BrowserSystemWithDataLakeActorType
+    }],
+    connections,
+    providerBindings
+  });
+}
+function restGatewayConfigFromPathEndpoint(endpoint) {
+  const baseUrl = endpoint.endsWith("/") ? endpoint.slice(0, -1) : endpoint;
+  return {
+    chainState: { readUrl: `${baseUrl}/state` },
+    finalized: { readUrl: `${baseUrl}/blocks` },
+    index: { readUrl: `${baseUrl}/indexes` }
+  };
+}
+function toBrowserProviderBindings(bindings) {
+  return Object.fromEntries(Object.entries(bindings).map(([moniker, binding]) => [
+    moniker,
+    binding === void 0 ? {} : {
+      connection: binding.connection,
+      options: binding.options,
+      provider: binding.provider
+    }
+  ]));
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
 // src/launchXl1BrowserSystem.ts
 async function launchXl1BrowserSystem(options) {
   const config = parseXl1BrowserSystemConfig(options.config);
@@ -284,6 +292,8 @@ async function launchXl1BrowserSystem(options) {
   });
 }
 export {
+  SimpleXyoConnectionViewerProviderId,
+  SimpleXyoGatewayProviderId,
   Xl1BrowserSystemActor,
   Xl1BrowserSystemActorDependencies,
   Xl1BrowserSystemActorType,

package/dist/browser/index.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../../src/launchXl1BrowserSystem.ts", "../../src/Xl1BrowserConfig.ts", "../../src/Xl1BrowserSystemActor.ts", "../../src/Xl1BrowserProvider.ts"],
-  "sourcesContent": ["import type {\n  BrowserActor,\n  BrowserActorCatalog,\n  BrowserProviderDescriptor,\n  BrowserSystemIdentity,\n  BrowserSystemSession,\n} from '@ariestools/browser-kit'\nimport { launchBrowserSystem } from '@ariestools/browser-kit'\nimport type {\n  ProviderDescriptor as Xl1ProviderDescriptor,\n  ProviderFactoryLocatorInstance,\n} from '@xyo-network/xl1-sdk'\n\nimport {\n  parseXl1BrowserSystemConfig,\n  toBrowserSystemConfig,\n} from './Xl1BrowserConfig.ts'\nimport {\n  createXl1BrowserSystemProvisioner,\n  xl1BrowserProviderDeclarations,\n  type Xl1BrowserProviderRuntimeContext,\n} from './Xl1BrowserProvider.ts'\nimport { createXl1BrowserActorCatalog } from './Xl1BrowserSystemActor.ts'\n\n/** Inputs for launching one owner-resolved XL1 browser provider system. */\nexport interface LaunchXl1BrowserSystemOptions<TActor extends BrowserActor = BrowserActor> {\n  readonly actorCatalog?: BrowserActorCatalog<TActor, ProviderFactoryLocatorInstance>\n  readonly config: unknown\n  readonly context?: Xl1BrowserProviderRuntimeContext\n  readonly host?: string\n  readonly identity?: BrowserSystemIdentity\n  readonly providerCandidates?: readonly Xl1ProviderDescriptor[]\n  readonly readyTimeoutMs?: number\n}\n\n/** Parses, resolves, provisions, and starts one XL1 system from browser-safe config. */\nexport async function launchXl1BrowserSystem<TActor extends BrowserActor = BrowserActor>(\n  options: LaunchXl1BrowserSystemOptions<TActor>,\n): Promise<BrowserSystemSession<TActor, ProviderFactoryLocatorInstance>> {\n  const config = parseXl1BrowserSystemConfig(options.config)\n  const actorCatalog = options.actorCatalog\n    ?? createXl1BrowserActorCatalog() as BrowserActorCatalog<TActor, ProviderFactoryLocatorInstance>\n  const providerDescriptors = xl1BrowserProviderDeclarations(options.providerCandidates)\n  return await launchBrowserSystem({\n    actorCatalog,\n    config: toBrowserSystemConfig(config),\n    host: options.host,\n    identity: options.identity,\n    providerDescriptors: providerDescriptors as unknown as BrowserProviderDescriptor[],\n    provision: createXl1BrowserSystemProvisioner({\n      config,\n      context: options.context,\n    }),\n    readyTimeoutMs: options.readyTimeoutMs,\n  })\n}\n", "import type {\n  BrowserActorSelection,\n  BrowserSystemConfig,\n} from '@ariestools/browser-kit'\nimport { parseBrowserSystemConfig } from '@ariestools/browser-kit'\nimport type {\n  ConnectionsConfig,\n  LocatorConfig,\n  PrimeCachesMode,\n  ProviderBindingsConfig,\n} from '@xyo-network/xl1-sdk'\nimport {\n  BlockViewerMoniker,\n  ChainContractViewerMoniker,\n  ChainStateViewerMoniker,\n  DataLakeViewerMoniker,\n  FinalizationViewerMoniker,\n  IndexViewerMoniker,\n  NetworkStakeStepRewardsByPositionViewerMoniker,\n  parseLocatorConfigFields,\n  restConnectionFromS3Bucket,\n  restGatewayConfigFromEndpoint,\n  SimpleXyoConnectionViewer,\n  SimpleXyoGateway,\n  XyoConnectionMoniker,\n  XyoGatewayMoniker,\n} from '@xyo-network/xl1-sdk'\n\nimport {\n  Xl1BrowserSystemActorType,\n  Xl1BrowserSystemWithDataLakeActorType,\n} from './Xl1BrowserSystemActor.ts'\n\n/** Authored XL1 locator fields plus browser actor selections. */\nexport interface Xl1BrowserSystemConfig extends LocatorConfig {\n  readonly actors: readonly BrowserActorSelection[]\n}\n\n/** Options for the standard read-only REST-backed XL1 browser system. */\nexport interface CreateXl1RestBrowserSystemConfigOptions {\n  readonly actors?: readonly BrowserActorSelection[]\n  readonly dataLakeEndpoint?: string\n  readonly endpoint: string\n  readonly host?: string\n  readonly primeCaches?: PrimeCachesMode\n}\n\n/** Parses XL1 locator fields and browser actor selections without importing code from config. */\nexport function parseXl1BrowserSystemConfig(input: unknown): Xl1BrowserSystemConfig {\n  const locatorConfig = parseLocatorConfigFields(input)\n  const browserConfig = parseBrowserSystemConfig({\n    actors: isRecord(input) ? input['actors'] : undefined,\n    connections: locatorConfig.connections,\n    providerBindings: toBrowserProviderBindings(locatorConfig.providerBindings),\n  })\n  return Object.freeze({\n    ...locatorConfig,\n    actors: Object.freeze([...(browserConfig.actors ?? [])]),\n  })\n}\n\n/** Projects the XL1 config onto the neutral fields browser-kit compiles. */\nexport function toBrowserSystemConfig(\n  config: Xl1BrowserSystemConfig,\n): BrowserSystemConfig {\n  return {\n    actors: config.actors,\n    connections: config.connections,\n    providerBindings: toBrowserProviderBindings(config.providerBindings),\n  }\n}\n\n/** Creates explicit REST connections and provider bindings for a read-only XL1 gateway actor. */\nexport function createXl1RestBrowserSystemConfig(\n  options: CreateXl1RestBrowserSystemConfigOptions,\n): Xl1BrowserSystemConfig {\n  const buckets = restGatewayConfigFromEndpoint(options.endpoint)\n  const finalized = buckets.finalized\n  if (finalized === undefined) throw new Error('XL1 REST gateway has no finalized bucket')\n\n  const connections: ConnectionsConfig = {\n    'rest-chain-state': restConnectionFromS3Bucket(buckets.chainState ?? finalized),\n    'rest-finalized': restConnectionFromS3Bucket(finalized),\n    'rest-index': restConnectionFromS3Bucket(buckets.index ?? finalized),\n  }\n  const providerBindings: ProviderBindingsConfig = {\n    [BlockViewerMoniker]: { connection: 'rest-finalized' },\n    [ChainContractViewerMoniker]: { connection: 'rest-chain-state' },\n    [ChainStateViewerMoniker]: { connection: 'rest-chain-state' },\n    [FinalizationViewerMoniker]: { connection: 'rest-finalized' },\n    [IndexViewerMoniker]: { connection: 'rest-index' },\n    [XyoConnectionMoniker]: { provider: SimpleXyoConnectionViewer.name },\n    [XyoGatewayMoniker]: { provider: SimpleXyoGateway.name },\n  }\n  if (options.dataLakeEndpoint !== undefined) {\n    connections['rest-data-lake'] = {\n      baseUrl: options.dataLakeEndpoint,\n      type: 'rest',\n    }\n    providerBindings[DataLakeViewerMoniker] = { connection: 'rest-data-lake' }\n  }\n  if (options.primeCaches !== undefined) {\n    providerBindings[NetworkStakeStepRewardsByPositionViewerMoniker] = { primeCaches: options.primeCaches }\n  }\n\n  return parseXl1BrowserSystemConfig({\n    actors: options.actors ?? [{\n      host: options.host,\n      type: options.dataLakeEndpoint === undefined\n        ? Xl1BrowserSystemActorType\n        : Xl1BrowserSystemWithDataLakeActorType,\n    }],\n    connections,\n    providerBindings,\n  })\n}\n\nfunction toBrowserProviderBindings(\n  bindings: ProviderBindingsConfig,\n): NonNullable<BrowserSystemConfig['providerBindings']> {\n  return Object.fromEntries(Object.entries(bindings).map(([moniker, binding]) => [\n    moniker,\n    binding === undefined\n      ? {}\n      : {\n          connection: binding.connection,\n          options: binding.options,\n          provider: binding.provider,\n        },\n  ]))\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value)\n}\n", "import type {\n  ProviderActorContext,\n  ProviderActorParams,\n} from '@ariestools/actor'\nimport { ProviderActor } from '@ariestools/actor'\nimport type {\n  BrowserActor,\n  ResolvedBrowserProviderPlan,\n  ResolvedBrowserSystemConfig,\n} from '@ariestools/browser-kit'\nimport { BrowserActorCatalog as BrowserActorCatalogInstance } from '@ariestools/browser-kit'\nimport type { CreatableName } from '@ariestools/sdk'\nimport type {\n  ProviderFactoryLocatorInstance,\n  XyoGateway,\n} from '@xyo-network/xl1-sdk'\nimport {\n  DataLakeViewerMoniker,\n  XyoGatewayMoniker,\n} from '@xyo-network/xl1-sdk'\n\nexport const Xl1BrowserSystemActorType = 'xl1-system' as const\nexport const Xl1BrowserSystemWithDataLakeActorType = 'xl1-system-with-data-lake' as const\n\nexport interface Xl1BrowserSystemActorParams extends ProviderActorParams<\n  ProviderFactoryLocatorInstance,\n  ResolvedBrowserSystemConfig,\n  unknown,\n  ResolvedBrowserProviderPlan\n> {}\n\n/** Resident actor representing one configured XL1 gateway system. */\nexport class Xl1BrowserSystemActor extends ProviderActor<Xl1BrowserSystemActorParams> {\n  /** Resolves the gateway owned by this actor's immutable provider system. */\n  async getGateway(): Promise<XyoGateway> {\n    if (this.status !== 'started') {\n      throw new Error(`XL1 browser system actor is not running (status: ${this.status})`)\n    }\n    return await this.getProvider<XyoGateway>(XyoGatewayMoniker)\n  }\n}\n\nexport const Xl1BrowserSystemActorDependencies = [XyoGatewayMoniker] as const\nexport const Xl1BrowserSystemWithDataLakeActorDependencies = [\n  XyoGatewayMoniker,\n  DataLakeViewerMoniker,\n] as const\n\n/** Creates the default actor catalog and optionally installs application actors. */\nexport function createXl1BrowserActorCatalog() {\n  const catalog = new BrowserActorCatalogInstance<BrowserActor, ProviderFactoryLocatorInstance>()\n  const create = async (\n    id: string,\n    providerContext: ProviderActorContext<\n      ProviderFactoryLocatorInstance,\n      ResolvedBrowserSystemConfig,\n      unknown,\n      ResolvedBrowserProviderPlan\n    >,\n  ) => await Xl1BrowserSystemActor.create({\n    name: id as CreatableName,\n    providerContext,\n  })\n  catalog.register({\n    create: async ({ id, providerContext }) => await create(\n      id,\n      providerContext as ProviderActorContext<\n        ProviderFactoryLocatorInstance,\n        ResolvedBrowserSystemConfig,\n        unknown,\n        ResolvedBrowserProviderPlan\n      >,\n    ),\n    dependencies: Xl1BrowserSystemActorDependencies,\n    type: Xl1BrowserSystemActorType,\n  })\n  catalog.register({\n    create: async ({ id, providerContext }) => await create(\n      id,\n      providerContext as ProviderActorContext<\n        ProviderFactoryLocatorInstance,\n        ResolvedBrowserSystemConfig,\n        unknown,\n        ResolvedBrowserProviderPlan\n      >,\n    ),\n    dependencies: Xl1BrowserSystemWithDataLakeActorDependencies,\n    type: Xl1BrowserSystemWithDataLakeActorType,\n  })\n  return catalog\n}\n", "import { stopOrShutdown } from '@ariestools/actor'\nimport type { BrowserSystemProvisioner } from '@ariestools/browser-kit'\nimport { createResolvedBrowserProviderPlan } from '@ariestools/browser-kit'\nimport { createResolvedProviderSystem } from '@ariestools/provider-model'\nimport type {\n  ConnectionsConfig,\n  CreatableProviderContext,\n  CreatableProviderInstance,\n  ProviderBindingsConfig,\n  ProviderDescriptor as Xl1ProviderDescriptor,\n  ProviderFactoryLocatorInstance,\n} from '@xyo-network/xl1-sdk'\nimport {\n  allProviderCandidates,\n  compileLocatorConfig,\n  providerCandidateFromClass,\n  ProviderFactoryLocator,\n  SimpleXyoConnectionViewer,\n  SimpleXyoGateway,\n} from '@xyo-network/xl1-sdk'\n\nimport type { Xl1BrowserSystemConfig } from './Xl1BrowserConfig.ts'\n\n/** Browser-kit plan metadata retaining the XL1 provider class used by the provisioner. */\nexport interface Xl1BrowserProviderDeclaration {\n  readonly connectionTypes: readonly string[]\n  readonly dependencies: readonly string[]\n  readonly id: string\n  readonly monikers: readonly string[]\n  readonly xl1: Xl1ProviderDescriptor\n}\n\n/** Non-serializable XL1 runtime homes supplied by the realm that owns the system. */\nexport type Xl1BrowserProviderRuntimeContext = Omit<\n  CreatableProviderContext,\n  'config' | 'locator'\n>\n\n/** Options captured by the XL1 browser-system provisioner. */\nexport interface CreateXl1BrowserSystemProvisionerOptions {\n  readonly config: Xl1BrowserSystemConfig\n  readonly context?: Xl1BrowserProviderRuntimeContext\n}\n\n/** Adapts one XL1 provider candidate into neutral browser-kit plan metadata. */\nexport function xl1BrowserProviderDeclaration(\n  descriptor: Xl1ProviderDescriptor,\n): Xl1BrowserProviderDeclaration {\n  return Object.freeze({\n    connectionTypes: Object.freeze([...descriptor.connectionTypes]),\n    dependencies: Object.freeze([...(descriptor.dependencies ?? [])]),\n    id: descriptor.id,\n    monikers: Object.freeze([...descriptor.satisfies]),\n    xl1: descriptor,\n  })\n}\n\n/** Returns the XL1 provider catalog available to browser-system configuration. */\nexport function xl1BrowserProviderCandidates(): Xl1ProviderDescriptor[] {\n  return [\n    ...allProviderCandidates(),\n    providerCandidateFromClass(SimpleXyoConnectionViewer),\n    providerCandidateFromClass(SimpleXyoGateway),\n  ]\n}\n\n/** Adapts an XL1 provider catalog for browser-kit planning. */\nexport function xl1BrowserProviderDeclarations(\n  candidates: readonly Xl1ProviderDescriptor[] = xl1BrowserProviderCandidates(),\n): Xl1BrowserProviderDeclaration[] {\n  return candidates.map(xl1BrowserProviderDeclaration)\n}\n\n/** Creates the owner-realm provisioner that instantiates one resolved XL1 locator. */\nexport function createXl1BrowserSystemProvisioner(\n  options: CreateXl1BrowserSystemProvisionerOptions,\n): BrowserSystemProvisioner<ProviderFactoryLocatorInstance> {\n  return async (input) => {\n    const providerBindings = mergeResolvedProviderBindings(\n      options.config.providerBindings,\n      input.compiled.config.providerBindings,\n    )\n    const locatorConfig = compileLocatorConfig({\n      ...options.config,\n      connections: input.compiled.config.connections as ConnectionsConfig,\n      providerBindings,\n    })\n    const locator = new ProviderFactoryLocator({\n      caches: {},\n      singletons: {},\n      ...options.context,\n      config: locatorConfig,\n    })\n    for (const selected of input.compiled.resolution.selected) {\n      const declaration = selected as unknown as Xl1BrowserProviderDeclaration\n      const descriptor = declaration.xl1\n      locator.register(descriptor.creatableProvider.factory([\n        ...(descriptor.dependencies ?? descriptor.creatableProvider.dependencies),\n      ]))\n    }\n    locator.freeze()\n\n    try {\n      for (const moniker of input.compiled.declaration.dependencies) {\n        await locator.getInstance(moniker)\n      }\n    } catch (startError) {\n      const releaseError = await releaseXl1Providers(locator).catch(error => error)\n      if (releaseError !== undefined) {\n        throw new AggregateError(\n          [startError, releaseError],\n          'XL1 browser provider provisioning and cleanup both failed',\n          { cause: startError },\n        )\n      }\n      throw startError\n    }\n\n    const resolvedConfig = Object.freeze({\n      ...options.config,\n      actors: input.config.actors,\n      connections: input.compiled.config.connections as ConnectionsConfig,\n      providerBindings,\n    })\n    const system = createResolvedProviderSystem({\n      config: resolvedConfig,\n      locator,\n      resolution: createResolvedBrowserProviderPlan(input.compiled.resolution),\n    })\n    let releasePromise: Promise<void> | undefined\n    return {\n      release: () => {\n        releasePromise ??= releaseXl1Providers(locator)\n        return releasePromise\n      },\n      system,\n    }\n  }\n}\n\nfunction mergeResolvedProviderBindings(\n  authored: ProviderBindingsConfig,\n  resolved: Readonly<Record<string, {\n    readonly connection?: string\n    readonly options?: Readonly<Record<string, unknown>>\n    readonly provider?: string\n  } | undefined>>,\n): ProviderBindingsConfig {\n  return Object.fromEntries(Object.entries(resolved).map(([moniker, binding]) => [\n    moniker,\n    {\n      ...authored[moniker],\n      ...binding,\n    },\n  ]))\n}\n\nasync function releaseXl1Providers(locator: ProviderFactoryLocatorInstance): Promise<void> {\n  const instances = await instantiatedProviders(locator)\n  for (const instance of instances) instance.requestCancel?.()\n\n  const errors: unknown[] = []\n  for (const instance of instances.toReversed()) {\n    try {\n      await stopOrShutdown(instance)\n    } catch (error) {\n      errors.push(error)\n    }\n  }\n  if (errors.length > 0) {\n    throw new AggregateError(errors, `${errors.length} XL1 browser provider(s) failed to stop`)\n  }\n}\n\nasync function instantiatedProviders(\n  locator: ProviderFactoryLocatorInstance,\n): Promise<(CreatableProviderInstance & { requestCancel?(reason?: unknown): void })[]> {\n  const instances = await Promise.all(\n    Object.values(locator.context.singletons).map(async value => await value),\n  )\n  return [...new Set(instances)].filter(isCreatableProviderInstance)\n}\n\nfunction isCreatableProviderInstance(\n  value: unknown,\n): value is CreatableProviderInstance & { requestCancel?(reason?: unknown): void } {\n  return typeof value === 'object'\n    && value !== null\n    && 'stop' in value\n    && typeof value.stop === 'function'\n}\n"],
-  "mappings": "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",
-  "names": ["DataLakeViewerMoniker", "XyoGatewayMoniker", "XyoGatewayMoniker", "DataLakeViewerMoniker", "SimpleXyoConnectionViewer", "SimpleXyoGateway"]
+  "sources": ["../../src/launchXl1BrowserSystem.ts", "../../src/Xl1BrowserConfig.ts", "../../src/Xl1BrowserProvider.ts", "../../src/Xl1BrowserSystemActor.ts"],
+  "sourcesContent": ["import type {\n  BrowserActor,\n  BrowserActorCatalog,\n  BrowserProviderDescriptor,\n  BrowserSystemIdentity,\n  BrowserSystemSession,\n} from '@ariestools/browser-kit'\nimport { launchBrowserSystem } from '@ariestools/browser-kit'\nimport type {\n  ProviderDescriptor as Xl1ProviderDescriptor,\n  ProviderFactoryLocatorInstance,\n} from '@xyo-network/xl1-sdk'\n\nimport {\n  parseXl1BrowserSystemConfig,\n  toBrowserSystemConfig,\n} from './Xl1BrowserConfig.ts'\nimport {\n  createXl1BrowserSystemProvisioner,\n  xl1BrowserProviderDeclarations,\n  type Xl1BrowserProviderRuntimeContext,\n} from './Xl1BrowserProvider.ts'\nimport { createXl1BrowserActorCatalog } from './Xl1BrowserSystemActor.ts'\n\n/** Inputs for launching one owner-resolved XL1 browser provider system. */\nexport interface LaunchXl1BrowserSystemOptions<TActor extends BrowserActor = BrowserActor> {\n  readonly actorCatalog?: BrowserActorCatalog<TActor, ProviderFactoryLocatorInstance>\n  readonly config: unknown\n  readonly context?: Xl1BrowserProviderRuntimeContext\n  readonly host?: string\n  readonly identity?: BrowserSystemIdentity\n  readonly providerCandidates?: readonly Xl1ProviderDescriptor[]\n  readonly readyTimeoutMs?: number\n}\n\n/** Parses, resolves, provisions, and starts one XL1 system from browser-safe config. */\nexport async function launchXl1BrowserSystem<TActor extends BrowserActor = BrowserActor>(\n  options: LaunchXl1BrowserSystemOptions<TActor>,\n): Promise<BrowserSystemSession<TActor, ProviderFactoryLocatorInstance>> {\n  const config = parseXl1BrowserSystemConfig(options.config)\n  const actorCatalog = options.actorCatalog\n    ?? createXl1BrowserActorCatalog() as BrowserActorCatalog<TActor, ProviderFactoryLocatorInstance>\n  const providerDescriptors = xl1BrowserProviderDeclarations(options.providerCandidates)\n  return await launchBrowserSystem({\n    actorCatalog,\n    config: toBrowserSystemConfig(config),\n    host: options.host,\n    identity: options.identity,\n    providerDescriptors: providerDescriptors as unknown as BrowserProviderDescriptor[],\n    provision: createXl1BrowserSystemProvisioner({\n      config,\n      context: options.context,\n    }),\n    readyTimeoutMs: options.readyTimeoutMs,\n  })\n}\n", "import type {\n  BrowserActorSelection,\n  BrowserSystemConfig,\n} from '@ariestools/browser-kit'\nimport { parseBrowserSystemConfig } from '@ariestools/browser-kit'\nimport type {\n  ConnectionsConfig,\n  LocatorConfig,\n  PrimeCachesMode,\n  ProviderBindingsConfig,\n  RestGatewayConfig,\n} from '@xyo-network/xl1-sdk'\nimport {\n  BlockViewerMoniker,\n  ChainContractViewerMoniker,\n  ChainStateViewerMoniker,\n  DataLakeViewerMoniker,\n  FinalizationViewerMoniker,\n  IndexViewerMoniker,\n  NetworkStakeStepRewardsByPositionViewerMoniker,\n  parseLocatorConfigFields,\n  restConnectionFromS3Bucket,\n  restGatewayConfigFromEndpoint,\n  XyoConnectionMoniker,\n  XyoGatewayMoniker,\n} from '@xyo-network/xl1-sdk'\n\nimport {\n  SimpleXyoConnectionViewerProviderId,\n  SimpleXyoGatewayProviderId,\n} from './Xl1BrowserProvider.ts'\nimport {\n  Xl1BrowserSystemActorType,\n  Xl1BrowserSystemWithDataLakeActorType,\n} from './Xl1BrowserSystemActor.ts'\n\n/** Authored XL1 locator fields plus browser actor selections. */\nexport interface Xl1BrowserSystemConfig extends LocatorConfig {\n  readonly actors: readonly BrowserActorSelection[]\n}\n\n/** Options for the standard read-only REST-backed XL1 browser system. */\nexport interface CreateXl1RestBrowserSystemConfigOptions {\n  readonly actors?: readonly BrowserActorSelection[]\n  readonly dataLakeEndpoint?: string\n  readonly endpoint: string\n  readonly host?: string\n  readonly layout?: Xl1RestEndpointLayout\n  readonly primeCaches?: PrimeCachesMode\n}\n\n/** How the REST gateway's finalized, chain-state, and index URLs are derived from its endpoint. */\nexport type Xl1RestEndpointLayout = 'path' | 'subdomain'\n\n/** Parses XL1 locator fields and browser actor selections without importing code from config. */\nexport function parseXl1BrowserSystemConfig(input: unknown): Xl1BrowserSystemConfig {\n  const locatorConfig = parseLocatorConfigFields(input)\n  const browserConfig = parseBrowserSystemConfig({\n    actors: isRecord(input) ? input['actors'] : undefined,\n    connections: locatorConfig.connections,\n    providerBindings: toBrowserProviderBindings(locatorConfig.providerBindings),\n  })\n  return Object.freeze({\n    ...locatorConfig,\n    actors: Object.freeze([...(browserConfig.actors ?? [])]),\n  })\n}\n\n/** Projects the XL1 config onto the neutral fields browser-kit compiles. */\nexport function toBrowserSystemConfig(\n  config: Xl1BrowserSystemConfig,\n): BrowserSystemConfig {\n  return {\n    actors: config.actors,\n    connections: config.connections,\n    providerBindings: toBrowserProviderBindings(config.providerBindings),\n  }\n}\n\n/** Creates explicit REST connections and provider bindings for a read-only XL1 gateway actor. */\nexport function createXl1RestBrowserSystemConfig(\n  options: CreateXl1RestBrowserSystemConfigOptions,\n): Xl1BrowserSystemConfig {\n  const buckets = options.layout === 'path'\n    ? restGatewayConfigFromPathEndpoint(options.endpoint)\n    : restGatewayConfigFromEndpoint(options.endpoint)\n  const finalized = buckets.finalized\n  if (finalized === undefined) throw new Error('XL1 REST gateway has no finalized bucket')\n\n  const connections: ConnectionsConfig = {\n    'rest-chain-state': restConnectionFromS3Bucket(buckets.chainState ?? finalized),\n    'rest-finalized': restConnectionFromS3Bucket(finalized),\n    'rest-index': restConnectionFromS3Bucket(buckets.index ?? finalized),\n  }\n  const providerBindings: ProviderBindingsConfig = {\n    [BlockViewerMoniker]: { connection: 'rest-finalized' },\n    [ChainContractViewerMoniker]: { connection: 'rest-chain-state' },\n    [ChainStateViewerMoniker]: { connection: 'rest-chain-state' },\n    [FinalizationViewerMoniker]: { connection: 'rest-finalized' },\n    [IndexViewerMoniker]: { connection: 'rest-index' },\n    [XyoConnectionMoniker]: { provider: SimpleXyoConnectionViewerProviderId },\n    [XyoGatewayMoniker]: { provider: SimpleXyoGatewayProviderId },\n  }\n  if (options.dataLakeEndpoint !== undefined) {\n    connections['rest-data-lake'] = {\n      baseUrl: options.dataLakeEndpoint,\n      type: 'rest',\n    }\n    providerBindings[DataLakeViewerMoniker] = { connection: 'rest-data-lake' }\n  }\n  if (options.primeCaches !== undefined) {\n    providerBindings[NetworkStakeStepRewardsByPositionViewerMoniker] = { primeCaches: options.primeCaches }\n  }\n\n  return parseXl1BrowserSystemConfig({\n    actors: options.actors ?? [{\n      host: options.host,\n      type: options.dataLakeEndpoint === undefined\n        ? Xl1BrowserSystemActorType\n        : Xl1BrowserSystemWithDataLakeActorType,\n    }],\n    connections,\n    providerBindings,\n  })\n}\n\nfunction restGatewayConfigFromPathEndpoint(\n  endpoint: string,\n): Required<Pick<RestGatewayConfig, 'chainState' | 'finalized' | 'index'>> {\n  const baseUrl = endpoint.endsWith('/') ? endpoint.slice(0, -1) : endpoint\n  return {\n    chainState: { readUrl: `${baseUrl}/state` },\n    finalized: { readUrl: `${baseUrl}/blocks` },\n    index: { readUrl: `${baseUrl}/indexes` },\n  }\n}\n\nfunction toBrowserProviderBindings(\n  bindings: ProviderBindingsConfig,\n): NonNullable<BrowserSystemConfig['providerBindings']> {\n  return Object.fromEntries(Object.entries(bindings).map(([moniker, binding]) => [\n    moniker,\n    binding === undefined\n      ? {}\n      : {\n          connection: binding.connection,\n          options: binding.options,\n          provider: binding.provider,\n        },\n  ]))\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value)\n}\n", "import { stopOrShutdown } from '@ariestools/actor'\nimport type { BrowserSystemProvisioner } from '@ariestools/browser-kit'\nimport { createResolvedBrowserProviderPlan } from '@ariestools/browser-kit'\nimport { createResolvedProviderSystem } from '@ariestools/provider-model'\nimport type {\n  ConnectionsConfig,\n  CreatableProviderContext,\n  CreatableProviderInstance,\n  ProviderBindingsConfig,\n  ProviderDescriptor as Xl1ProviderDescriptor,\n  ProviderFactoryLocatorInstance,\n} from '@xyo-network/xl1-sdk'\nimport {\n  allProviderCandidates,\n  compileLocatorConfig,\n  providerCandidateFromClass,\n  ProviderFactoryLocator,\n  SimpleXyoConnectionViewer,\n  SimpleXyoGateway,\n} from '@xyo-network/xl1-sdk'\n\nimport type { Xl1BrowserSystemConfig } from './Xl1BrowserConfig.ts'\n\n/** Stable browser-provider identifier retained across production minification. */\nexport const SimpleXyoConnectionViewerProviderId = 'SimpleXyoConnectionViewer'\n/** Stable browser-provider identifier retained across production minification. */\nexport const SimpleXyoGatewayProviderId = 'SimpleXyoGateway'\n\n/** Browser-kit plan metadata retaining the XL1 provider class used by the provisioner. */\nexport interface Xl1BrowserProviderDeclaration {\n  readonly connectionTypes: readonly string[]\n  readonly dependencies: readonly string[]\n  readonly id: string\n  readonly monikers: readonly string[]\n  readonly xl1: Xl1ProviderDescriptor\n}\n\n/** Non-serializable XL1 runtime homes supplied by the realm that owns the system. */\nexport type Xl1BrowserProviderRuntimeContext = Omit<\n  CreatableProviderContext,\n  'config' | 'locator'\n>\n\n/** Options captured by the XL1 browser-system provisioner. */\nexport interface CreateXl1BrowserSystemProvisionerOptions {\n  readonly config: Xl1BrowserSystemConfig\n  readonly context?: Xl1BrowserProviderRuntimeContext\n}\n\n/** Adapts one XL1 provider candidate into neutral browser-kit plan metadata. */\nexport function xl1BrowserProviderDeclaration(\n  descriptor: Xl1ProviderDescriptor,\n): Xl1BrowserProviderDeclaration {\n  return Object.freeze({\n    connectionTypes: Object.freeze([...descriptor.connectionTypes]),\n    dependencies: Object.freeze([...(descriptor.dependencies ?? [])]),\n    id: descriptor.id,\n    monikers: Object.freeze([...descriptor.satisfies]),\n    xl1: descriptor,\n  })\n}\n\n/** Returns the XL1 provider catalog available to browser-system configuration. */\nexport function xl1BrowserProviderCandidates(): Xl1ProviderDescriptor[] {\n  return [\n    ...allProviderCandidates(),\n    providerCandidateFromClass(SimpleXyoConnectionViewer, SimpleXyoConnectionViewerProviderId),\n    providerCandidateFromClass(SimpleXyoGateway, SimpleXyoGatewayProviderId),\n  ]\n}\n\n/** Adapts an XL1 provider catalog for browser-kit planning. */\nexport function xl1BrowserProviderDeclarations(\n  candidates: readonly Xl1ProviderDescriptor[] = xl1BrowserProviderCandidates(),\n): Xl1BrowserProviderDeclaration[] {\n  return candidates.map(xl1BrowserProviderDeclaration)\n}\n\n/** Creates the owner-realm provisioner that instantiates one resolved XL1 locator. */\nexport function createXl1BrowserSystemProvisioner(\n  options: CreateXl1BrowserSystemProvisionerOptions,\n): BrowserSystemProvisioner<ProviderFactoryLocatorInstance> {\n  return async (input) => {\n    const providerBindings = mergeResolvedProviderBindings(\n      options.config.providerBindings,\n      input.compiled.config.providerBindings,\n    )\n    const locatorConfig = compileLocatorConfig({\n      ...options.config,\n      connections: input.compiled.config.connections as ConnectionsConfig,\n      providerBindings,\n    })\n    const locator = new ProviderFactoryLocator({\n      caches: {},\n      singletons: {},\n      ...options.context,\n      config: locatorConfig,\n    })\n    for (const selected of input.compiled.resolution.selected) {\n      const declaration = selected as unknown as Xl1BrowserProviderDeclaration\n      const descriptor = declaration.xl1\n      locator.register(descriptor.creatableProvider.factory([\n        ...(descriptor.dependencies ?? descriptor.creatableProvider.dependencies),\n      ]))\n    }\n    locator.freeze()\n\n    try {\n      for (const moniker of input.compiled.declaration.dependencies) {\n        await locator.getInstance(moniker)\n      }\n    } catch (startError) {\n      const releaseError = await releaseXl1Providers(locator).catch(error => error)\n      if (releaseError !== undefined) {\n        throw new AggregateError(\n          [startError, releaseError],\n          'XL1 browser provider provisioning and cleanup both failed',\n          { cause: startError },\n        )\n      }\n      throw startError\n    }\n\n    const resolvedConfig = Object.freeze({\n      ...options.config,\n      actors: input.config.actors,\n      connections: input.compiled.config.connections as ConnectionsConfig,\n      providerBindings,\n    })\n    const system = createResolvedProviderSystem({\n      config: resolvedConfig,\n      locator,\n      resolution: createResolvedBrowserProviderPlan(input.compiled.resolution),\n    })\n    let releasePromise: Promise<void> | undefined\n    return {\n      release: () => {\n        releasePromise ??= releaseXl1Providers(locator)\n        return releasePromise\n      },\n      system,\n    }\n  }\n}\n\nfunction mergeResolvedProviderBindings(\n  authored: ProviderBindingsConfig,\n  resolved: Readonly<Record<string, {\n    readonly connection?: string\n    readonly options?: Readonly<Record<string, unknown>>\n    readonly provider?: string\n  } | undefined>>,\n): ProviderBindingsConfig {\n  return Object.fromEntries(Object.entries(resolved).map(([moniker, binding]) => [\n    moniker,\n    {\n      ...authored[moniker],\n      ...binding,\n    },\n  ]))\n}\n\nasync function releaseXl1Providers(locator: ProviderFactoryLocatorInstance): Promise<void> {\n  const instances = await instantiatedProviders(locator)\n  for (const instance of instances) instance.requestCancel?.()\n\n  const errors: unknown[] = []\n  for (const instance of instances.toReversed()) {\n    try {\n      await stopOrShutdown(instance)\n    } catch (error) {\n      errors.push(error)\n    }\n  }\n  if (errors.length > 0) {\n    throw new AggregateError(errors, `${errors.length} XL1 browser provider(s) failed to stop`)\n  }\n}\n\nasync function instantiatedProviders(\n  locator: ProviderFactoryLocatorInstance,\n): Promise<(CreatableProviderInstance & { requestCancel?(reason?: unknown): void })[]> {\n  const instances = await Promise.all(\n    Object.values(locator.context.singletons).map(async value => await value),\n  )\n  return [...new Set(instances)].filter(isCreatableProviderInstance)\n}\n\nfunction isCreatableProviderInstance(\n  value: unknown,\n): value is CreatableProviderInstance & { requestCancel?(reason?: unknown): void } {\n  return typeof value === 'object'\n    && value !== null\n    && 'stop' in value\n    && typeof value.stop === 'function'\n}\n", "import type {\n  ProviderActorContext,\n  ProviderActorParams,\n} from '@ariestools/actor'\nimport { ProviderActor } from '@ariestools/actor'\nimport type {\n  BrowserActor,\n  ResolvedBrowserProviderPlan,\n  ResolvedBrowserSystemConfig,\n} from '@ariestools/browser-kit'\nimport { BrowserActorCatalog as BrowserActorCatalogInstance } from '@ariestools/browser-kit'\nimport type { CreatableName } from '@ariestools/sdk'\nimport type {\n  ProviderFactoryLocatorInstance,\n  XyoGateway,\n} from '@xyo-network/xl1-sdk'\nimport {\n  DataLakeViewerMoniker,\n  XyoGatewayMoniker,\n} from '@xyo-network/xl1-sdk'\n\nexport const Xl1BrowserSystemActorType = 'xl1-system' as const\nexport const Xl1BrowserSystemWithDataLakeActorType = 'xl1-system-with-data-lake' as const\n\nexport interface Xl1BrowserSystemActorParams extends ProviderActorParams<\n  ProviderFactoryLocatorInstance,\n  ResolvedBrowserSystemConfig,\n  unknown,\n  ResolvedBrowserProviderPlan\n> {}\n\n/** Resident actor representing one configured XL1 gateway system. */\nexport class Xl1BrowserSystemActor extends ProviderActor<Xl1BrowserSystemActorParams> {\n  /** Resolves the gateway owned by this actor's immutable provider system. */\n  async getGateway(): Promise<XyoGateway> {\n    if (this.status !== 'started') {\n      throw new Error(`XL1 browser system actor is not running (status: ${this.status})`)\n    }\n    return await this.getProvider<XyoGateway>(XyoGatewayMoniker)\n  }\n}\n\nexport const Xl1BrowserSystemActorDependencies = [XyoGatewayMoniker] as const\nexport const Xl1BrowserSystemWithDataLakeActorDependencies = [\n  XyoGatewayMoniker,\n  DataLakeViewerMoniker,\n] as const\n\n/** Creates the default actor catalog and optionally installs application actors. */\nexport function createXl1BrowserActorCatalog() {\n  const catalog = new BrowserActorCatalogInstance<BrowserActor, ProviderFactoryLocatorInstance>()\n  const create = async (\n    id: string,\n    providerContext: ProviderActorContext<\n      ProviderFactoryLocatorInstance,\n      ResolvedBrowserSystemConfig,\n      unknown,\n      ResolvedBrowserProviderPlan\n    >,\n  ) => await Xl1BrowserSystemActor.create({\n    name: id as CreatableName,\n    providerContext,\n  })\n  catalog.register({\n    create: async ({ id, providerContext }) => await create(\n      id,\n      providerContext as ProviderActorContext<\n        ProviderFactoryLocatorInstance,\n        ResolvedBrowserSystemConfig,\n        unknown,\n        ResolvedBrowserProviderPlan\n      >,\n    ),\n    dependencies: Xl1BrowserSystemActorDependencies,\n    type: Xl1BrowserSystemActorType,\n  })\n  catalog.register({\n    create: async ({ id, providerContext }) => await create(\n      id,\n      providerContext as ProviderActorContext<\n        ProviderFactoryLocatorInstance,\n        ResolvedBrowserSystemConfig,\n        unknown,\n        ResolvedBrowserProviderPlan\n      >,\n    ),\n    dependencies: Xl1BrowserSystemWithDataLakeActorDependencies,\n    type: Xl1BrowserSystemWithDataLakeActorType,\n  })\n  return catalog\n}\n"],
+  "mappings": "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",
+  "names": ["DataLakeViewerMoniker", "XyoGatewayMoniker", "XyoGatewayMoniker", "DataLakeViewerMoniker"]
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "http://json.schemastore.org/package.json",
   "name": "@xyo-network/xl1-browser-system",
-  "version": "5.0.11",
+  "version": "5.0.13",
   "description": "Config-driven XL1 provider actor systems for browser runtimes",
   "homepage": "https://xylabs.com",
   "bugs": {
@@ -41,14 +41,18 @@
   ],
   "dependencies": {
     "@ariestools/provider-model": "~1.1.1",
-    "@xyo-network/xl1-sdk": "~5.0.11"
+    "@xyo-network/xl1-sdk": "~5.0.13"
   },
   "devDependencies": {
     "@ariestools/actor": "~1.1.1",
     "@ariestools/actor-model": "~1.1.1",
     "@ariestools/browser-kit": "~0.1.1",
+    "@ariestools/browser-kit-page": "~0.1.1",
+    "@ariestools/browser-kit-plugin": "~0.1.1",
+    "@ariestools/browser-kit-service-worker": "~0.1.1",
+    "@ariestools/browser-kit-worker": "~0.1.1",
     "@ariestools/provider": "~1.1.1",
-    "@ariestools/sdk": "~8.1.6",
+    "@ariestools/sdk": "~8.1.7",
     "@ariestools/toolchain": "~8.7.26",
     "@ariestools/tsconfig": "~8.7.26",
     "@ariestools/tsconfig-dom": "~8.7.26",
@@ -60,6 +64,7 @@
     "eslint": "~10.8.0",
     "ethers": "~6.17.0",
     "msw": "~2.15.0",
+    "playwright": "~1.62.1",
     "typescript": "~6.0.3",
     "vite": "~8.2.0",
     "vitest": "~4.1.10",
@@ -77,7 +82,10 @@
     "access": "public"
   },
   "scripts": {
+    "example:build": "vite build --config examples/vite.config.ts && vite build --config examples/extension/vite.config.ts",
+    "example:serve": "vite preview --config examples/vite.config.ts --host 127.0.0.1 --port 4173",
     "test": "vitest run",
-    "test:ci": "vitest run"
+    "test:ci": "vitest run",
+    "test:e2e": "playwright test --config test/e2e/playwright.config.ts"
   }
 }