@xyo-network/xl1-browser-system 5.0.11

package/LICENSE

@@ -0,0 +1,165 @@
+                   GNU LESSER GENERAL PUBLIC LICENSE
+                       Version 3, 29 June 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+
+  This version of the GNU Lesser General Public License incorporates
+the terms and conditions of version 3 of the GNU General Public
+License, supplemented by the additional permissions listed below.
+
+  0. Additional Definitions.
+
+  As used herein, "this License" refers to version 3 of the GNU Lesser
+General Public License, and the "GNU GPL" refers to version 3 of the GNU
+General Public License.
+
+  "The Library" refers to a covered work governed by this License,
+other than an Application or a Combined Work as defined below.
+
+  An "Application" is any work that makes use of an interface provided
+by the Library, but which is not otherwise based on the Library.
+Defining a subclass of a class defined by the Library is deemed a mode
+of using an interface provided by the Library.
+
+  A "Combined Work" is a work produced by combining or linking an
+Application with the Library.  The particular version of the Library
+with which the Combined Work was made is also called the "Linked
+Version".
+
+  The "Minimal Corresponding Source" for a Combined Work means the
+Corresponding Source for the Combined Work, excluding any source code
+for portions of the Combined Work that, considered in isolation, are
+based on the Application, and not on the Linked Version.
+
+  The "Corresponding Application Code" for a Combined Work means the
+object code and/or source code for the Application, including any data
+and utility programs needed for reproducing the Combined Work from the
+Application, but excluding the System Libraries of the Combined Work.
+
+  1. Exception to Section 3 of the GNU GPL.
+
+  You may convey a covered work under sections 3 and 4 of this License
+without being bound by section 3 of the GNU GPL.
+
+  2. Conveying Modified Versions.
+
+  If you modify a copy of the Library, and, in your modifications, a
+facility refers to a function or data to be supplied by an Application
+that uses the facility (other than as an argument passed when the
+facility is invoked), then you may convey a copy of the modified
+version:
+
+   a) under this License, provided that you make a good faith effort to
+   ensure that, in the event an Application does not supply the
+   function or data, the facility still operates, and performs
+   whatever part of its purpose remains meaningful, or
+
+   b) under the GNU GPL, with none of the additional permissions of
+   this License applicable to that copy.
+
+  3. Object Code Incorporating Material from Library Header Files.
+
+  The object code form of an Application may incorporate material from
+a header file that is part of the Library.  You may convey such object
+code under terms of your choice, provided that, if the incorporated
+material is not limited to numerical parameters, data structure
+layouts and accessors, or small macros, inline functions and templates
+(ten or fewer lines in length), you do both of the following:
+
+   a) Give prominent notice with each copy of the object code that the
+   Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the object code with a copy of the GNU GPL and this license
+   document.
+
+  4. Combined Works.
+
+  You may convey a Combined Work under terms of your choice that,
+taken together, effectively do not restrict modification of the
+portions of the Library contained in the Combined Work and reverse
+engineering for debugging such modifications, if you also do each of
+the following:
+
+   a) Give prominent notice with each copy of the Combined Work that
+   the Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the Combined Work with a copy of the GNU GPL and this license
+   document.
+
+   c) For a Combined Work that displays copyright notices during
+   execution, include the copyright notice for the Library among
+   these notices, as well as a reference directing the user to the
+   copies of the GNU GPL and this license document.
+
+   d) Do one of the following:
+
+       0) Convey the Minimal Corresponding Source under the terms of this
+       License, and the Corresponding Application Code in a form
+       suitable for, and under terms that permit, the user to
+       recombine or relink the Application with a modified version of
+       the Linked Version to produce a modified Combined Work, in the
+       manner specified by section 6 of the GNU GPL for conveying
+       Corresponding Source.
+
+       1) Use a suitable shared library mechanism for linking with the
+       Library.  A suitable mechanism is one that (a) uses at run time
+       a copy of the Library already present on the user's computer
+       system, and (b) will operate properly with a modified version
+       of the Library that is interface-compatible with the Linked
+       Version.
+
+   e) Provide Installation Information, but only if you would otherwise
+   be required to provide such information under section 6 of the
+   GNU GPL, and only to the extent that such information is
+   necessary to install and execute a modified version of the
+   Combined Work produced by recombining or relinking the
+   Application with a modified version of the Linked Version. (If
+   you use option 4d0, the Installation Information must accompany
+   the Minimal Corresponding Source and Corresponding Application
+   Code. If you use option 4d1, you must provide the Installation
+   Information in the manner specified by section 6 of the GNU GPL
+   for conveying Corresponding Source.)
+
+  5. Combined Libraries.
+
+  You may place library facilities that are a work based on the
+Library side by side in a single library together with other library
+facilities that are not Applications and are not covered by this
+License, and convey such a combined library under terms of your
+choice, if you do both of the following:
+
+   a) Accompany the combined library with a copy of the same work based
+   on the Library, uncombined with any other library facilities,
+   conveyed under the terms of this License.
+
+   b) Give prominent notice with the combined library that part of it
+   is a work based on the Library, and explaining where to find the
+   accompanying uncombined form of the same work.
+
+  6. Revised Versions of the GNU Lesser General Public License.
+
+  The Free Software Foundation may publish revised and/or new versions
+of the GNU Lesser General Public License from time to time. Such new
+versions will be similar in spirit to the present version, but may
+differ in detail to address new problems or concerns.
+
+  Each version is given a distinguishing version number. If the
+Library as you received it specifies that a certain numbered version
+of the GNU Lesser General Public License "or any later version"
+applies to it, you have the option of following the terms and
+conditions either of that published version or of any later version
+published by the Free Software Foundation. If the Library as you
+received it does not specify a version number of the GNU Lesser
+General Public License, you may choose any version of the GNU Lesser
+General Public License ever published by the Free Software Foundation.
+
+  If the Library as you received it specifies that a proxy can decide
+whether future versions of the GNU Lesser General Public License shall
+apply, that proxy's public statement of acceptance of any version is
+permanent authorization for you to choose that version for the
+Library.

package/README.md

@@ -0,0 +1,33 @@
+# `@xyo-network/xl1-browser-system`
+
+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.
+
+```ts
+import {
+  createXl1RestBrowserSystemConfig,
+  launchXl1BrowserSystem,
+  Xl1BrowserSystemActor,
+} from '@xyo-network/xl1-browser-system'
+
+const config = createXl1RestBrowserSystemConfig({
+  endpoint: 'https://sample.mainnet.xyo.space',
+  host: 'page',
+})
+const session = await launchXl1BrowserSystem({ config, host: 'page' })
+const actor = session.actors[0] as Xl1BrowserSystemActor
+const gateway = await actor.getGateway()
+const blockNumber = await gateway.connection.viewer?.block.currentBlockNumber()
+
+await session.stop()
+```
+
+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.

package/dist/browser/Xl1BrowserConfig.d.ts

@@ -0,0 +1,21 @@
+import type { BrowserActorSelection, BrowserSystemConfig } from '@ariestools/browser-kit';
+import type { LocatorConfig, PrimeCachesMode } from '@xyo-network/xl1-sdk';
+/** Authored XL1 locator fields plus browser actor selections. */
+export interface Xl1BrowserSystemConfig extends LocatorConfig {
+    readonly actors: readonly BrowserActorSelection[];
+}
+/** Options for the standard read-only REST-backed XL1 browser system. */
+export interface CreateXl1RestBrowserSystemConfigOptions {
+    readonly actors?: readonly BrowserActorSelection[];
+    readonly dataLakeEndpoint?: string;
+    readonly endpoint: string;
+    readonly host?: string;
+    readonly primeCaches?: PrimeCachesMode;
+}
+/** 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. */
+export declare function toBrowserSystemConfig(config: Xl1BrowserSystemConfig): BrowserSystemConfig;
+/** Creates explicit REST connections and provider bindings for a read-only XL1 gateway actor. */
+export declare function createXl1RestBrowserSystemConfig(options: CreateXl1RestBrowserSystemConfigOptions): Xl1BrowserSystemConfig;
+//# sourceMappingURL=Xl1BrowserConfig.d.ts.map

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

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

package/dist/browser/Xl1BrowserProvider.d.ts

@@ -0,0 +1,27 @@
+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';
+/** Browser-kit plan metadata retaining the XL1 provider class used by the provisioner. */
+export interface Xl1BrowserProviderDeclaration {
+    readonly connectionTypes: readonly string[];
+    readonly dependencies: readonly string[];
+    readonly id: string;
+    readonly monikers: readonly string[];
+    readonly xl1: Xl1ProviderDescriptor;
+}
+/** Non-serializable XL1 runtime homes supplied by the realm that owns the system. */
+export type Xl1BrowserProviderRuntimeContext = Omit<CreatableProviderContext, 'config' | 'locator'>;
+/** Options captured by the XL1 browser-system provisioner. */
+export interface CreateXl1BrowserSystemProvisionerOptions {
+    readonly config: Xl1BrowserSystemConfig;
+    readonly context?: Xl1BrowserProviderRuntimeContext;
+}
+/** Adapts one XL1 provider candidate into neutral browser-kit plan metadata. */
+export declare function xl1BrowserProviderDeclaration(descriptor: Xl1ProviderDescriptor): Xl1BrowserProviderDeclaration;
+/** Returns the XL1 provider catalog available to browser-system configuration. */
+export declare function xl1BrowserProviderCandidates(): Xl1ProviderDescriptor[];
+/** Adapts an XL1 provider catalog for browser-kit planning. */
+export declare function xl1BrowserProviderDeclarations(candidates?: readonly Xl1ProviderDescriptor[]): Xl1BrowserProviderDeclaration[];
+/** Creates the owner-realm provisioner that instantiates one resolved XL1 locator. */
+export declare function createXl1BrowserSystemProvisioner(options: CreateXl1BrowserSystemProvisionerOptions): BrowserSystemProvisioner<ProviderFactoryLocatorInstance>;
+//# sourceMappingURL=Xl1BrowserProvider.d.ts.map

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

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

package/dist/browser/Xl1BrowserSystemActor.d.ts

@@ -0,0 +1,19 @@
+import type { ProviderActorParams } from '@ariestools/actor';
+import { ProviderActor } from '@ariestools/actor';
+import type { BrowserActor, ResolvedBrowserProviderPlan, ResolvedBrowserSystemConfig } from '@ariestools/browser-kit';
+import { BrowserActorCatalog as BrowserActorCatalogInstance } from '@ariestools/browser-kit';
+import type { ProviderFactoryLocatorInstance, XyoGateway } from '@xyo-network/xl1-sdk';
+export declare const Xl1BrowserSystemActorType: "xl1-system";
+export declare const Xl1BrowserSystemWithDataLakeActorType: "xl1-system-with-data-lake";
+export interface Xl1BrowserSystemActorParams extends ProviderActorParams<ProviderFactoryLocatorInstance, ResolvedBrowserSystemConfig, unknown, ResolvedBrowserProviderPlan> {
+}
+/** Resident actor representing one configured XL1 gateway system. */
+export declare class Xl1BrowserSystemActor extends ProviderActor<Xl1BrowserSystemActorParams> {
+    /** Resolves the gateway owned by this actor's immutable provider system. */
+    getGateway(): Promise<XyoGateway>;
+}
+export declare const Xl1BrowserSystemActorDependencies: readonly ["XyoGateway"];
+export declare const Xl1BrowserSystemWithDataLakeActorDependencies: readonly ["XyoGateway", "DataLakeViewer"];
+/** Creates the default actor catalog and optionally installs application actors. */
+export declare function createXl1BrowserActorCatalog(): BrowserActorCatalogInstance<BrowserActor, ProviderFactoryLocatorInstance<import("@xyo-network/xl1-sdk").ProcessProviderContextType>>;
+//# sourceMappingURL=Xl1BrowserSystemActor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Xl1BrowserSystemActor.d.ts","sourceRoot":"","sources":["../../src/Xl1BrowserSystemActor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,mBAAmB,EACpB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACjD,OAAO,KAAK,EACV,YAAY,EACZ,2BAA2B,EAC3B,2BAA2B,EAC5B,MAAM,yBAAyB,CAAA;AAChC,OAAO,EAAE,mBAAmB,IAAI,2BAA2B,EAAE,MAAM,yBAAyB,CAAA;AAE5F,OAAO,KAAK,EACV,8BAA8B,EAC9B,UAAU,EACX,MAAM,sBAAsB,CAAA;AAM7B,eAAO,MAAM,yBAAyB,EAAG,YAAqB,CAAA;AAC9D,eAAO,MAAM,qCAAqC,EAAG,2BAAoC,CAAA;AAEzF,MAAM,WAAW,2BAA4B,SAAQ,mBAAmB,CACtE,8BAA8B,EAC9B,2BAA2B,EAC3B,OAAO,EACP,2BAA2B,CAC5B;CAAG;AAEJ,qEAAqE;AACrE,qBAAa,qBAAsB,SAAQ,aAAa,CAAC,2BAA2B,CAAC;IACnF,4EAA4E;IACtE,UAAU,IAAI,OAAO,CAAC,UAAU,CAAC;CAMxC;AAED,eAAO,MAAM,iCAAiC,yBAA+B,CAAA;AAC7E,eAAO,MAAM,6CAA6C,2CAGhD,CAAA;AAEV,oFAAoF;AACpF,wBAAgB,4BAA4B,yIAyC3C"}

package/dist/browser/index.d.ts

@@ -0,0 +1,5 @@
+export * from './launchXl1BrowserSystem.ts';
+export * from './Xl1BrowserConfig.ts';
+export * from './Xl1BrowserProvider.ts';
+export * from './Xl1BrowserSystemActor.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAA;AAC3C,cAAc,uBAAuB,CAAA;AACrC,cAAc,yBAAyB,CAAA;AACvC,cAAc,4BAA4B,CAAA"}

package/dist/browser/index.mjs

@@ -0,0 +1,302 @@
+// src/launchXl1BrowserSystem.ts
+import { launchBrowserSystem } from "@ariestools/browser-kit";
+
+// src/Xl1BrowserConfig.ts
+import { parseBrowserSystemConfig } from "@ariestools/browser-kit";
+import {
+  BlockViewerMoniker,
+  ChainContractViewerMoniker,
+  ChainStateViewerMoniker,
+  DataLakeViewerMoniker as DataLakeViewerMoniker2,
+  FinalizationViewerMoniker,
+  IndexViewerMoniker,
+  NetworkStakeStepRewardsByPositionViewerMoniker,
+  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";
+import { createResolvedProviderSystem } from "@ariestools/provider-model";
+import {
+  allProviderCandidates,
+  compileLocatorConfig,
+  providerCandidateFromClass,
+  ProviderFactoryLocator,
+  SimpleXyoConnectionViewer as SimpleXyoConnectionViewer2,
+  SimpleXyoGateway as SimpleXyoGateway2
+} from "@xyo-network/xl1-sdk";
+function xl1BrowserProviderDeclaration(descriptor) {
+  return Object.freeze({
+    connectionTypes: Object.freeze([...descriptor.connectionTypes]),
+    dependencies: Object.freeze([...descriptor.dependencies ?? []]),
+    id: descriptor.id,
+    monikers: Object.freeze([...descriptor.satisfies]),
+    xl1: descriptor
+  });
+}
+function xl1BrowserProviderCandidates() {
+  return [
+    ...allProviderCandidates(),
+    providerCandidateFromClass(SimpleXyoConnectionViewer2),
+    providerCandidateFromClass(SimpleXyoGateway2)
+  ];
+}
+function xl1BrowserProviderDeclarations(candidates = xl1BrowserProviderCandidates()) {
+  return candidates.map(xl1BrowserProviderDeclaration);
+}
+function createXl1BrowserSystemProvisioner(options) {
+  return async (input) => {
+    const providerBindings = mergeResolvedProviderBindings(
+      options.config.providerBindings,
+      input.compiled.config.providerBindings
+    );
+    const locatorConfig = compileLocatorConfig({
+      ...options.config,
+      connections: input.compiled.config.connections,
+      providerBindings
+    });
+    const locator = new ProviderFactoryLocator({
+      caches: {},
+      singletons: {},
+      ...options.context,
+      config: locatorConfig
+    });
+    for (const selected of input.compiled.resolution.selected) {
+      const declaration = selected;
+      const descriptor = declaration.xl1;
+      locator.register(descriptor.creatableProvider.factory([
+        ...descriptor.dependencies ?? descriptor.creatableProvider.dependencies
+      ]));
+    }
+    locator.freeze();
+    try {
+      for (const moniker of input.compiled.declaration.dependencies) {
+        await locator.getInstance(moniker);
+      }
+    } catch (startError) {
+      const releaseError = await releaseXl1Providers(locator).catch((error) => error);
+      if (releaseError !== void 0) {
+        throw new AggregateError(
+          [startError, releaseError],
+          "XL1 browser provider provisioning and cleanup both failed",
+          { cause: startError }
+        );
+      }
+      throw startError;
+    }
+    const resolvedConfig = Object.freeze({
+      ...options.config,
+      actors: input.config.actors,
+      connections: input.compiled.config.connections,
+      providerBindings
+    });
+    const system = createResolvedProviderSystem({
+      config: resolvedConfig,
+      locator,
+      resolution: createResolvedBrowserProviderPlan(input.compiled.resolution)
+    });
+    let releasePromise;
+    return {
+      release: () => {
+        releasePromise ??= releaseXl1Providers(locator);
+        return releasePromise;
+      },
+      system
+    };
+  };
+}
+function mergeResolvedProviderBindings(authored, resolved) {
+  return Object.fromEntries(Object.entries(resolved).map(([moniker, binding]) => [
+    moniker,
+    {
+      ...authored[moniker],
+      ...binding
+    }
+  ]));
+}
+async function releaseXl1Providers(locator) {
+  const instances = await instantiatedProviders(locator);
+  for (const instance of instances) instance.requestCancel?.();
+  const errors = [];
+  for (const instance of instances.toReversed()) {
+    try {
+      await stopOrShutdown(instance);
+    } catch (error) {
+      errors.push(error);
+    }
+  }
+  if (errors.length > 0) {
+    throw new AggregateError(errors, `${errors.length} XL1 browser provider(s) failed to stop`);
+  }
+}
+async function instantiatedProviders(locator) {
+  const instances = await Promise.all(
+    Object.values(locator.context.singletons).map(async (value) => await value)
+  );
+  return [...new Set(instances)].filter(isCreatableProviderInstance);
+}
+function isCreatableProviderInstance(value) {
+  return typeof value === "object" && value !== null && "stop" in value && typeof value.stop === "function";
+}
+
+// src/launchXl1BrowserSystem.ts
+async function launchXl1BrowserSystem(options) {
+  const config = parseXl1BrowserSystemConfig(options.config);
+  const actorCatalog = options.actorCatalog ?? createXl1BrowserActorCatalog();
+  const providerDescriptors = xl1BrowserProviderDeclarations(options.providerCandidates);
+  return await launchBrowserSystem({
+    actorCatalog,
+    config: toBrowserSystemConfig(config),
+    host: options.host,
+    identity: options.identity,
+    providerDescriptors,
+    provision: createXl1BrowserSystemProvisioner({
+      config,
+      context: options.context
+    }),
+    readyTimeoutMs: options.readyTimeoutMs
+  });
+}
+export {
+  Xl1BrowserSystemActor,
+  Xl1BrowserSystemActorDependencies,
+  Xl1BrowserSystemActorType,
+  Xl1BrowserSystemWithDataLakeActorDependencies,
+  Xl1BrowserSystemWithDataLakeActorType,
+  createXl1BrowserActorCatalog,
+  createXl1BrowserSystemProvisioner,
+  createXl1RestBrowserSystemConfig,
+  launchXl1BrowserSystem,
+  parseXl1BrowserSystemConfig,
+  toBrowserSystemConfig,
+  xl1BrowserProviderCandidates,
+  xl1BrowserProviderDeclaration,
+  xl1BrowserProviderDeclarations
+};
+//# sourceMappingURL=index.mjs.map

package/dist/browser/index.mjs.map

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

package/dist/browser/launchXl1BrowserSystem.d.ts

@@ -0,0 +1,16 @@
+import type { BrowserActor, BrowserActorCatalog, BrowserSystemIdentity, BrowserSystemSession } from '@ariestools/browser-kit';
+import type { ProviderDescriptor as Xl1ProviderDescriptor, ProviderFactoryLocatorInstance } from '@xyo-network/xl1-sdk';
+import { type Xl1BrowserProviderRuntimeContext } from './Xl1BrowserProvider.ts';
+/** Inputs for launching one owner-resolved XL1 browser provider system. */
+export interface LaunchXl1BrowserSystemOptions<TActor extends BrowserActor = BrowserActor> {
+    readonly actorCatalog?: BrowserActorCatalog<TActor, ProviderFactoryLocatorInstance>;
+    readonly config: unknown;
+    readonly context?: Xl1BrowserProviderRuntimeContext;
+    readonly host?: string;
+    readonly identity?: BrowserSystemIdentity;
+    readonly providerCandidates?: readonly Xl1ProviderDescriptor[];
+    readonly readyTimeoutMs?: number;
+}
+/** Parses, resolves, provisions, and starts one XL1 system from browser-safe config. */
+export declare function launchXl1BrowserSystem<TActor extends BrowserActor = BrowserActor>(options: LaunchXl1BrowserSystemOptions<TActor>): Promise<BrowserSystemSession<TActor, ProviderFactoryLocatorInstance>>;
+//# sourceMappingURL=launchXl1BrowserSystem.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"launchXl1BrowserSystem.d.ts","sourceRoot":"","sources":["../../src/launchXl1BrowserSystem.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,mBAAmB,EAEnB,qBAAqB,EACrB,oBAAoB,EACrB,MAAM,yBAAyB,CAAA;AAEhC,OAAO,KAAK,EACV,kBAAkB,IAAI,qBAAqB,EAC3C,8BAA8B,EAC/B,MAAM,sBAAsB,CAAA;AAM7B,OAAO,EAGL,KAAK,gCAAgC,EACtC,MAAM,yBAAyB,CAAA;AAGhC,2EAA2E;AAC3E,MAAM,WAAW,6BAA6B,CAAC,MAAM,SAAS,YAAY,GAAG,YAAY;IACvF,QAAQ,CAAC,YAAY,CAAC,EAAE,mBAAmB,CAAC,MAAM,EAAE,8BAA8B,CAAC,CAAA;IACnF,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,gCAAgC,CAAA;IACnD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,qBAAqB,CAAA;IACzC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,SAAS,qBAAqB,EAAE,CAAA;IAC9D,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CACjC;AAED,wFAAwF;AACxF,wBAAsB,sBAAsB,CAAC,MAAM,SAAS,YAAY,GAAG,YAAY,EACrF,OAAO,EAAE,6BAA6B,CAAC,MAAM,CAAC,GAC7C,OAAO,CAAC,oBAAoB,CAAC,MAAM,EAAE,8BAA8B,CAAC,CAAC,CAiBvE"}

package/package.json

@@ -0,0 +1,83 @@
+{
+  "$schema": "http://json.schemastore.org/package.json",
+  "name": "@xyo-network/xl1-browser-system",
+  "version": "5.0.11",
+  "description": "Config-driven XL1 provider actor systems for browser runtimes",
+  "homepage": "https://xylabs.com",
+  "bugs": {
+    "url": "https://github.com/XYOracleNetwork/xl1-protocol/issues",
+    "email": "support@xylabs.com"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/XYOracleNetwork/xl1-protocol.git",
+    "directory": "packages/browser-system"
+  },
+  "license": "LGPL-3.0-only",
+  "author": {
+    "name": "XY Labs Development Team",
+    "email": "support@xylabs.com",
+    "url": "https://xylabs.com"
+  },
+  "sideEffects": false,
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/browser/index.d.ts",
+      "browser": {
+        "types": "./dist/browser/index.d.ts",
+        "default": "./dist/browser/index.mjs"
+      },
+      "default": "./dist/browser/index.mjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "!**/*.bench.*",
+    "!**/*.spec.*",
+    "!**/*.test.*",
+    "README.md"
+  ],
+  "dependencies": {
+    "@ariestools/provider-model": "~1.1.1",
+    "@xyo-network/xl1-sdk": "~5.0.11"
+  },
+  "devDependencies": {
+    "@ariestools/actor": "~1.1.1",
+    "@ariestools/actor-model": "~1.1.1",
+    "@ariestools/browser-kit": "~0.1.1",
+    "@ariestools/provider": "~1.1.1",
+    "@ariestools/sdk": "~8.1.6",
+    "@ariestools/toolchain": "~8.7.26",
+    "@ariestools/tsconfig": "~8.7.26",
+    "@ariestools/tsconfig-dom": "~8.7.26",
+    "@opentelemetry/api": "~1.9.1",
+    "@xyo-network/sdk": "~7.2.3",
+    "@xyo-network/sdk-protocol": "~7.2.3",
+    "ajv": "~8.20.0",
+    "async-mutex": "~0.5.0",
+    "eslint": "~10.8.0",
+    "ethers": "~6.17.0",
+    "msw": "~2.15.0",
+    "typescript": "~6.0.3",
+    "vite": "~8.2.0",
+    "vitest": "~4.1.10",
+    "zod": "~4.4.3"
+  },
+  "peerDependencies": {
+    "@ariestools/actor": "^1.1",
+    "@ariestools/browser-kit": "^0.1"
+  },
+  "engines": {
+    "node": ">=22.3"
+  },
+  "engineStrict": true,
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "test": "vitest run",
+    "test:ci": "vitest run"
+  }
+}