@metamask-previews/wallet 0.0.0-preview-784cc181c → 0.0.0-preview-681bd3562

package/CHANGELOG.md

@@ -7,4 +7,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Added
+
+- Initial release ([#8838](https://github.com/MetaMask/core/pull/8838))
+
 [Unreleased]: https://github.com/MetaMask/core/

package/dist/Wallet.cjs

@@ -0,0 +1,113 @@
+"use strict";
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _Wallet_messenger, _Wallet_instances, _Wallet_controllerMetadata, _Wallet_isDestroyed;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Wallet = void 0;
+const messenger_1 = require("@metamask/messenger");
+const utils_1 = require("@metamask/utils");
+const initialization_1 = require("./initialization/initialization.cjs");
+class Wallet {
+    /**
+     * Creates a `Wallet` instance, initializing all instances as specified by the passed options.
+     *
+     * @param options - Options bag.
+     * @param options.messenger - An optional messenger to override the default one.
+     * @param options.state - An optional state blob.
+     * @param options.initializationConfigurations - An optional list of additional initialization configurations
+     * required beyond the ones included by default.
+     * @param options.instanceOptions - An optional object containing options that should be passed
+     * to specific instances for additional customization.
+     */
+    constructor(options) {
+        // TODO: Expand default types when passing additionalConfigurations.
+        _Wallet_messenger.set(this, void 0);
+        _Wallet_instances.set(this, void 0);
+        _Wallet_controllerMetadata.set(this, void 0);
+        _Wallet_isDestroyed.set(this, false);
+        __classPrivateFieldSet(this, _Wallet_messenger, options.messenger ??
+            new messenger_1.Messenger({
+                namespace: 'Root',
+            }), "f");
+        __classPrivateFieldSet(this, _Wallet_instances, (0, initialization_1.initialize)({
+            ...options,
+            messenger: __classPrivateFieldGet(this, _Wallet_messenger, "f"),
+        }), "f");
+        __classPrivateFieldSet(this, _Wallet_controllerMetadata, Object.fromEntries(Object.entries(__classPrivateFieldGet(this, _Wallet_instances, "f"))
+            .filter(([_, instance]) => (0, utils_1.hasProperty)(instance, 'metadata'))
+            .map(([name, instance]) => [name, instance.metadata])), "f");
+    }
+    /**
+     * @returns The root messenger of the wallet.
+     */
+    get messenger() {
+        return __classPrivateFieldGet(this, _Wallet_messenger, "f");
+    }
+    set messenger(_) {
+        throw new Error('The messenger cannot be directly mutated.');
+    }
+    /**
+     * @returns The combined state of the wallet.
+     */
+    get state() {
+        return Object.entries(__classPrivateFieldGet(this, _Wallet_instances, "f")).reduce((totalState, [name, instance]) => {
+            if (instance.state) {
+                totalState[name] = instance.state;
+            }
+            return totalState;
+        }, {});
+    }
+    set state(_) {
+        throw new Error('Wallet state cannot be directly mutated.');
+    }
+    /**
+     * @returns The controller metadata; containing per-controller information about what properties to persist etc.
+     */
+    get controllerMetadata() {
+        return __classPrivateFieldGet(this, _Wallet_controllerMetadata, "f");
+    }
+    set controllerMetadata(_) {
+        throw new Error('The controller metadata cannot be directly mutated.');
+    }
+    /**
+     * Get an instantiated controller or service.
+     *
+     * @param name - The name.
+     * @returns The instance, if it exists.
+     * @deprecated - Please use the messenger instead of direct access.
+     */
+    getInstance(name) {
+        return __classPrivateFieldGet(this, _Wallet_instances, "f")[name];
+    }
+    /**
+     * Destroy the wallet instance.
+     */
+    async destroy() {
+        if (__classPrivateFieldGet(this, _Wallet_isDestroyed, "f")) {
+            return;
+        }
+        __classPrivateFieldSet(this, _Wallet_isDestroyed, true, "f");
+        await Promise.allSettled(Object.values(__classPrivateFieldGet(this, _Wallet_instances, "f")).map(async (instance) => {
+            // @ts-expect-error Accessing protected property.
+            if (typeof instance.destroy === 'function') {
+                // @ts-expect-error Accessing protected property.
+                // eslint-disable-next-line @typescript-eslint/await-thenable
+                return await instance.destroy();
+            }
+            /* istanbul ignore next */
+            return undefined;
+        }));
+    }
+}
+exports.Wallet = Wallet;
+_Wallet_messenger = new WeakMap(), _Wallet_instances = new WeakMap(), _Wallet_controllerMetadata = new WeakMap(), _Wallet_isDestroyed = new WeakMap();
+//# sourceMappingURL=Wallet.cjs.map

package/dist/Wallet.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Wallet.cjs","sourceRoot":"","sources":["../src/Wallet.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AACA,mDAAgD;AAChD,2CAA8C;AAS9C,wEAA6D;AAG7D,MAAa,MAAM;IAYjB;;;;;;;;;;OAUG;IACH,YAAY,OAAsB;QAtBlC,oEAAoE;QAC3D,oCAAyD;QAEzD,oCAA6B;QAE7B,6CAEP;QAEF,8BAAe,KAAK,EAAC;QAcnB,uBAAA,IAAI,qBACF,OAAO,CAAC,SAAS;YACjB,IAAI,qBAAS,CAAC;gBACZ,SAAS,EAAE,MAAM;aAClB,CAAC,MAAA,CAAC;QAEL,uBAAA,IAAI,qBAAc,IAAA,2BAAU,EAAC;YAC3B,GAAG,OAAO;YACV,SAAS,EAAE,uBAAA,IAAI,yBAAW;SAC3B,CAAC,MAAA,CAAC;QAEH,uBAAA,IAAI,8BAAuB,MAAM,CAAC,WAAW,CAC3C,MAAM,CAAC,OAAO,CAAC,uBAAA,IAAI,yBAAW,CAAC;aAC5B,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC,IAAA,mBAAW,EAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;aAC5D,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC,CACxD,MAAA,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,IAAI,SAAS;QACX,OAAO,uBAAA,IAAI,yBAAW,CAAC;IACzB,CAAC;IAED,IAAI,SAAS,CAAC,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC/D,CAAC;IAED;;OAEG;IACH,IAAI,KAAK;QACP,OAAO,MAAM,CAAC,OAAO,CAAC,uBAAA,IAAI,yBAAW,CAAC,CAAC,MAAM,CAC3C,CAAC,UAAU,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,EAAE;YAC/B,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;gBACnB,UAAU,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC;YACpC,CAAC;YACD,OAAO,UAAU,CAAC;QACpB,CAAC,EACD,EAAE,CACa,CAAC;IACpB,CAAC;IAED,IAAI,KAAK,CAAC,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC9D,CAAC;IAED;;OAEG;IACH,IAAI,kBAAkB;QAGpB,OAAO,uBAAA,IAAI,kCAAoB,CAAC;IAClC,CAAC;IAED,IAAI,kBAAkB,CAAC,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;IAUD;;;;;;OAMG;IACH,WAAW,CACT,IAAY;QAEZ,OAAO,uBAAA,IAAI,yBAAW,CAAC,IAA8B,CAAC,CAAC;IACzD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO;QACX,IAAI,uBAAA,IAAI,2BAAa,EAAE,CAAC;YACtB,OAAO;QACT,CAAC;QAED,uBAAA,IAAI,uBAAgB,IAAI,MAAA,CAAC;QAEzB,MAAM,OAAO,CAAC,UAAU,CACtB,MAAM,CAAC,MAAM,CAAC,uBAAA,IAAI,yBAAW,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE;YACpD,iDAAiD;YACjD,IAAI,OAAO,QAAQ,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;gBAC3C,iDAAiD;gBACjD,6DAA6D;gBAC7D,OAAO,MAAM,QAAQ,CAAC,OAAO,EAAE,CAAC;YAClC,CAAC;YACD,0BAA0B;YAC1B,OAAO,SAAS,CAAC;QACnB,CAAC,CAAC,CACH,CAAC;IACJ,CAAC;CACF;AAjID,wBAiIC","sourcesContent":["import type { StateMetadataConstraint } from '@metamask/base-controller';\nimport { Messenger } from '@metamask/messenger';\nimport { hasProperty } from '@metamask/utils';\n\nimport type {\n  DefaultActions,\n  DefaultEvents,\n  DefaultInstances,\n  DefaultState,\n  RootMessenger,\n} from './initialization/defaults';\nimport { initialize } from './initialization/initialization';\nimport { WalletOptions } from './types';\n\nexport class Wallet {\n  // TODO: Expand default types when passing additionalConfigurations.\n  readonly #messenger: RootMessenger<DefaultActions, DefaultEvents>;\n\n  readonly #instances: DefaultInstances;\n\n  readonly #controllerMetadata: Readonly<\n    Record<string, Readonly<StateMetadataConstraint>>\n  >;\n\n  #isDestroyed = false;\n\n  /**\n   * Creates a `Wallet` instance, initializing all instances as specified by the passed options.\n   *\n   * @param options - Options bag.\n   * @param options.messenger - An optional messenger to override the default one.\n   * @param options.state - An optional state blob.\n   * @param options.initializationConfigurations - An optional list of additional initialization configurations\n   * required beyond the ones included by default.\n   * @param options.instanceOptions - An optional object containing options that should be passed\n   * to specific instances for additional customization.\n   */\n  constructor(options: WalletOptions) {\n    this.#messenger =\n      options.messenger ??\n      new Messenger({\n        namespace: 'Root',\n      });\n\n    this.#instances = initialize({\n      ...options,\n      messenger: this.#messenger,\n    });\n\n    this.#controllerMetadata = Object.fromEntries(\n      Object.entries(this.#instances)\n        .filter(([_, instance]) => hasProperty(instance, 'metadata'))\n        .map(([name, instance]) => [name, instance.metadata]),\n    );\n  }\n\n  /**\n   * @returns The root messenger of the wallet.\n   */\n  get messenger(): Readonly<RootMessenger<DefaultActions, DefaultEvents>> {\n    return this.#messenger;\n  }\n\n  set messenger(_) {\n    throw new Error('The messenger cannot be directly mutated.');\n  }\n\n  /**\n   * @returns The combined state of the wallet.\n   */\n  get state(): DefaultState {\n    return Object.entries(this.#instances).reduce<Record<string, unknown>>(\n      (totalState, [name, instance]) => {\n        if (instance.state) {\n          totalState[name] = instance.state;\n        }\n        return totalState;\n      },\n      {},\n    ) as DefaultState;\n  }\n\n  set state(_) {\n    throw new Error('Wallet state cannot be directly mutated.');\n  }\n\n  /**\n   * @returns The controller metadata; containing per-controller information about what properties to persist etc.\n   */\n  get controllerMetadata(): Readonly<\n    Record<string, Readonly<StateMetadataConstraint>>\n  > {\n    return this.#controllerMetadata;\n  }\n\n  set controllerMetadata(_) {\n    throw new Error('The controller metadata cannot be directly mutated.');\n  }\n\n  getInstance<Name extends keyof DefaultInstances>(\n    name: Name,\n  ): DefaultInstances[Name];\n\n  getInstance(\n    name: string,\n  ): DefaultInstances[keyof DefaultInstances] | undefined;\n\n  /**\n   * Get an instantiated controller or service.\n   *\n   * @param name - The name.\n   * @returns The instance, if it exists.\n   * @deprecated - Please use the messenger instead of direct access.\n   */\n  getInstance(\n    name: string,\n  ): DefaultInstances[keyof DefaultInstances] | undefined {\n    return this.#instances[name as keyof DefaultInstances];\n  }\n\n  /**\n   * Destroy the wallet instance.\n   */\n  async destroy(): Promise<void> {\n    if (this.#isDestroyed) {\n      return;\n    }\n\n    this.#isDestroyed = true;\n\n    await Promise.allSettled(\n      Object.values(this.#instances).map(async (instance) => {\n        // @ts-expect-error Accessing protected property.\n        if (typeof instance.destroy === 'function') {\n          // @ts-expect-error Accessing protected property.\n          // eslint-disable-next-line @typescript-eslint/await-thenable\n          return await instance.destroy();\n        }\n        /* istanbul ignore next */\n        return undefined;\n      }),\n    );\n  }\n}\n"]}

package/dist/Wallet.d.cts

@@ -0,0 +1,40 @@
+import type { StateMetadataConstraint } from "@metamask/base-controller";
+import type { DefaultActions, DefaultEvents, DefaultInstances, DefaultState, RootMessenger } from "./initialization/defaults.cjs";
+import { WalletOptions } from "./types.cjs";
+export declare class Wallet {
+    #private;
+    /**
+     * Creates a `Wallet` instance, initializing all instances as specified by the passed options.
+     *
+     * @param options - Options bag.
+     * @param options.messenger - An optional messenger to override the default one.
+     * @param options.state - An optional state blob.
+     * @param options.initializationConfigurations - An optional list of additional initialization configurations
+     * required beyond the ones included by default.
+     * @param options.instanceOptions - An optional object containing options that should be passed
+     * to specific instances for additional customization.
+     */
+    constructor(options: WalletOptions);
+    /**
+     * @returns The root messenger of the wallet.
+     */
+    get messenger(): Readonly<RootMessenger<DefaultActions, DefaultEvents>>;
+    set messenger(_: Readonly<RootMessenger<DefaultActions, DefaultEvents>>);
+    /**
+     * @returns The combined state of the wallet.
+     */
+    get state(): DefaultState;
+    set state(_: DefaultState);
+    /**
+     * @returns The controller metadata; containing per-controller information about what properties to persist etc.
+     */
+    get controllerMetadata(): Readonly<Record<string, Readonly<StateMetadataConstraint>>>;
+    set controllerMetadata(_: Readonly<Record<string, Readonly<StateMetadataConstraint>>>);
+    getInstance<Name extends keyof DefaultInstances>(name: Name): DefaultInstances[Name];
+    getInstance(name: string): DefaultInstances[keyof DefaultInstances] | undefined;
+    /**
+     * Destroy the wallet instance.
+     */
+    destroy(): Promise<void>;
+}
+//# sourceMappingURL=Wallet.d.cts.map

package/dist/Wallet.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Wallet.d.cts","sourceRoot":"","sources":["../src/Wallet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,kCAAkC;AAIzE,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACd,sCAAkC;AAEnC,OAAO,EAAE,aAAa,EAAE,oBAAgB;AAExC,qBAAa,MAAM;;IAYjB;;;;;;;;;;OAUG;gBACS,OAAO,EAAE,aAAa;IAmBlC;;OAEG;IACH,IAAI,SAAS,IAAI,QAAQ,CAAC,aAAa,CAAC,cAAc,EAAE,aAAa,CAAC,CAAC,CAEtE;IAED,IAAI,SAAS,CAAC,CAAC,EAJE,QAAQ,CAAC,aAAa,CAAC,cAAc,EAAE,aAAa,CAAC,CAIvD,EAEd;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,YAAY,CAUxB;IAED,IAAI,KAAK,CAAC,CAAC,EAZE,YAYF,EAEV;IAED;;OAEG;IACH,IAAI,kBAAkB,IAAI,QAAQ,CAChC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,uBAAuB,CAAC,CAAC,CAClD,CAEA;IAED,IAAI,kBAAkB,CAAC,CAAC,EANE,QAAQ,CAChC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,uBAAuB,CAAC,CAAC,CAK3B,EAEvB;IAED,WAAW,CAAC,IAAI,SAAS,MAAM,gBAAgB,EAC7C,IAAI,EAAE,IAAI,GACT,gBAAgB,CAAC,IAAI,CAAC;IAEzB,WAAW,CACT,IAAI,EAAE,MAAM,GACX,gBAAgB,CAAC,MAAM,gBAAgB,CAAC,GAAG,SAAS;IAevD;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAoB/B"}

package/dist/Wallet.d.mts

@@ -0,0 +1,40 @@
+import type { StateMetadataConstraint } from "@metamask/base-controller";
+import type { DefaultActions, DefaultEvents, DefaultInstances, DefaultState, RootMessenger } from "./initialization/defaults.mjs";
+import { WalletOptions } from "./types.mjs";
+export declare class Wallet {
+    #private;
+    /**
+     * Creates a `Wallet` instance, initializing all instances as specified by the passed options.
+     *
+     * @param options - Options bag.
+     * @param options.messenger - An optional messenger to override the default one.
+     * @param options.state - An optional state blob.
+     * @param options.initializationConfigurations - An optional list of additional initialization configurations
+     * required beyond the ones included by default.
+     * @param options.instanceOptions - An optional object containing options that should be passed
+     * to specific instances for additional customization.
+     */
+    constructor(options: WalletOptions);
+    /**
+     * @returns The root messenger of the wallet.
+     */
+    get messenger(): Readonly<RootMessenger<DefaultActions, DefaultEvents>>;
+    set messenger(_: Readonly<RootMessenger<DefaultActions, DefaultEvents>>);
+    /**
+     * @returns The combined state of the wallet.
+     */
+    get state(): DefaultState;
+    set state(_: DefaultState);
+    /**
+     * @returns The controller metadata; containing per-controller information about what properties to persist etc.
+     */
+    get controllerMetadata(): Readonly<Record<string, Readonly<StateMetadataConstraint>>>;
+    set controllerMetadata(_: Readonly<Record<string, Readonly<StateMetadataConstraint>>>);
+    getInstance<Name extends keyof DefaultInstances>(name: Name): DefaultInstances[Name];
+    getInstance(name: string): DefaultInstances[keyof DefaultInstances] | undefined;
+    /**
+     * Destroy the wallet instance.
+     */
+    destroy(): Promise<void>;
+}
+//# sourceMappingURL=Wallet.d.mts.map

package/dist/Wallet.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Wallet.d.mts","sourceRoot":"","sources":["../src/Wallet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,kCAAkC;AAIzE,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACd,sCAAkC;AAEnC,OAAO,EAAE,aAAa,EAAE,oBAAgB;AAExC,qBAAa,MAAM;;IAYjB;;;;;;;;;;OAUG;gBACS,OAAO,EAAE,aAAa;IAmBlC;;OAEG;IACH,IAAI,SAAS,IAAI,QAAQ,CAAC,aAAa,CAAC,cAAc,EAAE,aAAa,CAAC,CAAC,CAEtE;IAED,IAAI,SAAS,CAAC,CAAC,EAJE,QAAQ,CAAC,aAAa,CAAC,cAAc,EAAE,aAAa,CAAC,CAIvD,EAEd;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,YAAY,CAUxB;IAED,IAAI,KAAK,CAAC,CAAC,EAZE,YAYF,EAEV;IAED;;OAEG;IACH,IAAI,kBAAkB,IAAI,QAAQ,CAChC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,uBAAuB,CAAC,CAAC,CAClD,CAEA;IAED,IAAI,kBAAkB,CAAC,CAAC,EANE,QAAQ,CAChC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,uBAAuB,CAAC,CAAC,CAK3B,EAEvB;IAED,WAAW,CAAC,IAAI,SAAS,MAAM,gBAAgB,EAC7C,IAAI,EAAE,IAAI,GACT,gBAAgB,CAAC,IAAI,CAAC;IAEzB,WAAW,CACT,IAAI,EAAE,MAAM,GACX,gBAAgB,CAAC,MAAM,gBAAgB,CAAC,GAAG,SAAS;IAevD;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAoB/B"}

package/dist/Wallet.mjs

@@ -0,0 +1,109 @@
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _Wallet_messenger, _Wallet_instances, _Wallet_controllerMetadata, _Wallet_isDestroyed;
+import { Messenger } from "@metamask/messenger";
+import { hasProperty } from "@metamask/utils";
+import { initialize } from "./initialization/initialization.mjs";
+export class Wallet {
+    /**
+     * Creates a `Wallet` instance, initializing all instances as specified by the passed options.
+     *
+     * @param options - Options bag.
+     * @param options.messenger - An optional messenger to override the default one.
+     * @param options.state - An optional state blob.
+     * @param options.initializationConfigurations - An optional list of additional initialization configurations
+     * required beyond the ones included by default.
+     * @param options.instanceOptions - An optional object containing options that should be passed
+     * to specific instances for additional customization.
+     */
+    constructor(options) {
+        // TODO: Expand default types when passing additionalConfigurations.
+        _Wallet_messenger.set(this, void 0);
+        _Wallet_instances.set(this, void 0);
+        _Wallet_controllerMetadata.set(this, void 0);
+        _Wallet_isDestroyed.set(this, false);
+        __classPrivateFieldSet(this, _Wallet_messenger, options.messenger ??
+            new Messenger({
+                namespace: 'Root',
+            }), "f");
+        __classPrivateFieldSet(this, _Wallet_instances, initialize({
+            ...options,
+            messenger: __classPrivateFieldGet(this, _Wallet_messenger, "f"),
+        }), "f");
+        __classPrivateFieldSet(this, _Wallet_controllerMetadata, Object.fromEntries(Object.entries(__classPrivateFieldGet(this, _Wallet_instances, "f"))
+            .filter(([_, instance]) => hasProperty(instance, 'metadata'))
+            .map(([name, instance]) => [name, instance.metadata])), "f");
+    }
+    /**
+     * @returns The root messenger of the wallet.
+     */
+    get messenger() {
+        return __classPrivateFieldGet(this, _Wallet_messenger, "f");
+    }
+    set messenger(_) {
+        throw new Error('The messenger cannot be directly mutated.');
+    }
+    /**
+     * @returns The combined state of the wallet.
+     */
+    get state() {
+        return Object.entries(__classPrivateFieldGet(this, _Wallet_instances, "f")).reduce((totalState, [name, instance]) => {
+            if (instance.state) {
+                totalState[name] = instance.state;
+            }
+            return totalState;
+        }, {});
+    }
+    set state(_) {
+        throw new Error('Wallet state cannot be directly mutated.');
+    }
+    /**
+     * @returns The controller metadata; containing per-controller information about what properties to persist etc.
+     */
+    get controllerMetadata() {
+        return __classPrivateFieldGet(this, _Wallet_controllerMetadata, "f");
+    }
+    set controllerMetadata(_) {
+        throw new Error('The controller metadata cannot be directly mutated.');
+    }
+    /**
+     * Get an instantiated controller or service.
+     *
+     * @param name - The name.
+     * @returns The instance, if it exists.
+     * @deprecated - Please use the messenger instead of direct access.
+     */
+    getInstance(name) {
+        return __classPrivateFieldGet(this, _Wallet_instances, "f")[name];
+    }
+    /**
+     * Destroy the wallet instance.
+     */
+    async destroy() {
+        if (__classPrivateFieldGet(this, _Wallet_isDestroyed, "f")) {
+            return;
+        }
+        __classPrivateFieldSet(this, _Wallet_isDestroyed, true, "f");
+        await Promise.allSettled(Object.values(__classPrivateFieldGet(this, _Wallet_instances, "f")).map(async (instance) => {
+            // @ts-expect-error Accessing protected property.
+            if (typeof instance.destroy === 'function') {
+                // @ts-expect-error Accessing protected property.
+                // eslint-disable-next-line @typescript-eslint/await-thenable
+                return await instance.destroy();
+            }
+            /* istanbul ignore next */
+            return undefined;
+        }));
+    }
+}
+_Wallet_messenger = new WeakMap(), _Wallet_instances = new WeakMap(), _Wallet_controllerMetadata = new WeakMap(), _Wallet_isDestroyed = new WeakMap();
+//# sourceMappingURL=Wallet.mjs.map

package/dist/Wallet.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Wallet.mjs","sourceRoot":"","sources":["../src/Wallet.ts"],"names":[],"mappings":";;;;;;;;;;;;AACA,OAAO,EAAE,SAAS,EAAE,4BAA4B;AAChD,OAAO,EAAE,WAAW,EAAE,wBAAwB;AAS9C,OAAO,EAAE,UAAU,EAAE,4CAAwC;AAG7D,MAAM,OAAO,MAAM;IAYjB;;;;;;;;;;OAUG;IACH,YAAY,OAAsB;QAtBlC,oEAAoE;QAC3D,oCAAyD;QAEzD,oCAA6B;QAE7B,6CAEP;QAEF,8BAAe,KAAK,EAAC;QAcnB,uBAAA,IAAI,qBACF,OAAO,CAAC,SAAS;YACjB,IAAI,SAAS,CAAC;gBACZ,SAAS,EAAE,MAAM;aAClB,CAAC,MAAA,CAAC;QAEL,uBAAA,IAAI,qBAAc,UAAU,CAAC;YAC3B,GAAG,OAAO;YACV,SAAS,EAAE,uBAAA,IAAI,yBAAW;SAC3B,CAAC,MAAA,CAAC;QAEH,uBAAA,IAAI,8BAAuB,MAAM,CAAC,WAAW,CAC3C,MAAM,CAAC,OAAO,CAAC,uBAAA,IAAI,yBAAW,CAAC;aAC5B,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;aAC5D,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC,CACxD,MAAA,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,IAAI,SAAS;QACX,OAAO,uBAAA,IAAI,yBAAW,CAAC;IACzB,CAAC;IAED,IAAI,SAAS,CAAC,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC/D,CAAC;IAED;;OAEG;IACH,IAAI,KAAK;QACP,OAAO,MAAM,CAAC,OAAO,CAAC,uBAAA,IAAI,yBAAW,CAAC,CAAC,MAAM,CAC3C,CAAC,UAAU,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,EAAE;YAC/B,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;gBACnB,UAAU,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC;YACpC,CAAC;YACD,OAAO,UAAU,CAAC;QACpB,CAAC,EACD,EAAE,CACa,CAAC;IACpB,CAAC;IAED,IAAI,KAAK,CAAC,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC9D,CAAC;IAED;;OAEG;IACH,IAAI,kBAAkB;QAGpB,OAAO,uBAAA,IAAI,kCAAoB,CAAC;IAClC,CAAC;IAED,IAAI,kBAAkB,CAAC,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;IAUD;;;;;;OAMG;IACH,WAAW,CACT,IAAY;QAEZ,OAAO,uBAAA,IAAI,yBAAW,CAAC,IAA8B,CAAC,CAAC;IACzD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO;QACX,IAAI,uBAAA,IAAI,2BAAa,EAAE,CAAC;YACtB,OAAO;QACT,CAAC;QAED,uBAAA,IAAI,uBAAgB,IAAI,MAAA,CAAC;QAEzB,MAAM,OAAO,CAAC,UAAU,CACtB,MAAM,CAAC,MAAM,CAAC,uBAAA,IAAI,yBAAW,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE;YACpD,iDAAiD;YACjD,IAAI,OAAO,QAAQ,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;gBAC3C,iDAAiD;gBACjD,6DAA6D;gBAC7D,OAAO,MAAM,QAAQ,CAAC,OAAO,EAAE,CAAC;YAClC,CAAC;YACD,0BAA0B;YAC1B,OAAO,SAAS,CAAC;QACnB,CAAC,CAAC,CACH,CAAC;IACJ,CAAC;CACF","sourcesContent":["import type { StateMetadataConstraint } from '@metamask/base-controller';\nimport { Messenger } from '@metamask/messenger';\nimport { hasProperty } from '@metamask/utils';\n\nimport type {\n  DefaultActions,\n  DefaultEvents,\n  DefaultInstances,\n  DefaultState,\n  RootMessenger,\n} from './initialization/defaults';\nimport { initialize } from './initialization/initialization';\nimport { WalletOptions } from './types';\n\nexport class Wallet {\n  // TODO: Expand default types when passing additionalConfigurations.\n  readonly #messenger: RootMessenger<DefaultActions, DefaultEvents>;\n\n  readonly #instances: DefaultInstances;\n\n  readonly #controllerMetadata: Readonly<\n    Record<string, Readonly<StateMetadataConstraint>>\n  >;\n\n  #isDestroyed = false;\n\n  /**\n   * Creates a `Wallet` instance, initializing all instances as specified by the passed options.\n   *\n   * @param options - Options bag.\n   * @param options.messenger - An optional messenger to override the default one.\n   * @param options.state - An optional state blob.\n   * @param options.initializationConfigurations - An optional list of additional initialization configurations\n   * required beyond the ones included by default.\n   * @param options.instanceOptions - An optional object containing options that should be passed\n   * to specific instances for additional customization.\n   */\n  constructor(options: WalletOptions) {\n    this.#messenger =\n      options.messenger ??\n      new Messenger({\n        namespace: 'Root',\n      });\n\n    this.#instances = initialize({\n      ...options,\n      messenger: this.#messenger,\n    });\n\n    this.#controllerMetadata = Object.fromEntries(\n      Object.entries(this.#instances)\n        .filter(([_, instance]) => hasProperty(instance, 'metadata'))\n        .map(([name, instance]) => [name, instance.metadata]),\n    );\n  }\n\n  /**\n   * @returns The root messenger of the wallet.\n   */\n  get messenger(): Readonly<RootMessenger<DefaultActions, DefaultEvents>> {\n    return this.#messenger;\n  }\n\n  set messenger(_) {\n    throw new Error('The messenger cannot be directly mutated.');\n  }\n\n  /**\n   * @returns The combined state of the wallet.\n   */\n  get state(): DefaultState {\n    return Object.entries(this.#instances).reduce<Record<string, unknown>>(\n      (totalState, [name, instance]) => {\n        if (instance.state) {\n          totalState[name] = instance.state;\n        }\n        return totalState;\n      },\n      {},\n    ) as DefaultState;\n  }\n\n  set state(_) {\n    throw new Error('Wallet state cannot be directly mutated.');\n  }\n\n  /**\n   * @returns The controller metadata; containing per-controller information about what properties to persist etc.\n   */\n  get controllerMetadata(): Readonly<\n    Record<string, Readonly<StateMetadataConstraint>>\n  > {\n    return this.#controllerMetadata;\n  }\n\n  set controllerMetadata(_) {\n    throw new Error('The controller metadata cannot be directly mutated.');\n  }\n\n  getInstance<Name extends keyof DefaultInstances>(\n    name: Name,\n  ): DefaultInstances[Name];\n\n  getInstance(\n    name: string,\n  ): DefaultInstances[keyof DefaultInstances] | undefined;\n\n  /**\n   * Get an instantiated controller or service.\n   *\n   * @param name - The name.\n   * @returns The instance, if it exists.\n   * @deprecated - Please use the messenger instead of direct access.\n   */\n  getInstance(\n    name: string,\n  ): DefaultInstances[keyof DefaultInstances] | undefined {\n    return this.#instances[name as keyof DefaultInstances];\n  }\n\n  /**\n   * Destroy the wallet instance.\n   */\n  async destroy(): Promise<void> {\n    if (this.#isDestroyed) {\n      return;\n    }\n\n    this.#isDestroyed = true;\n\n    await Promise.allSettled(\n      Object.values(this.#instances).map(async (instance) => {\n        // @ts-expect-error Accessing protected property.\n        if (typeof instance.destroy === 'function') {\n          // @ts-expect-error Accessing protected property.\n          // eslint-disable-next-line @typescript-eslint/await-thenable\n          return await instance.destroy();\n        }\n        /* istanbul ignore next */\n        return undefined;\n      }),\n    );\n  }\n}\n"]}

package/dist/index.cjs

@@ -1,13 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-/**
- * Example function that returns a greeting for the given name.
- *
- * @param name - The name to greet.
- * @returns The greeting.
- */
-function greeter(name) {
-    return `Hello, ${name}!`;
-}
-exports.default = greeter;
+exports.Wallet = void 0;
+var Wallet_1 = require("./Wallet.cjs");
+Object.defineProperty(exports, "Wallet", { enumerable: true, get: function () { return Wallet_1.Wallet; } });
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;AAAA;;;;;GAKG;AACH,SAAwB,OAAO,CAAC,IAAY;IAC1C,OAAO,UAAU,IAAI,GAAG,CAAC;AAC3B,CAAC;AAFD,0BAEC","sourcesContent":["/**\n * Example function that returns a greeting for the given name.\n *\n * @param name - The name to greet.\n * @returns The greeting.\n */\nexport default function greeter(name: string): string {\n  return `Hello, ${name}!`;\n}\n"]}
+{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,uCAAkC;AAAzB,gGAAA,MAAM,OAAA","sourcesContent":["export { Wallet } from './Wallet';\nexport type { WalletOptions } from './types';\nexport type {\n  DefaultActions,\n  DefaultEvents,\n  DefaultInstances,\n  DefaultState,\n  RootMessenger,\n} from './initialization/defaults';\n"]}

package/dist/index.d.cts

@@ -1,8 +1,4 @@
-/**
- * Example function that returns a greeting for the given name.
- *
- * @param name - The name to greet.
- * @returns The greeting.
- */
-export default function greeter(name: string): string;
+export { Wallet } from "./Wallet.cjs";
+export type { WalletOptions } from "./types.cjs";
+export type { DefaultActions, DefaultEvents, DefaultInstances, DefaultState, RootMessenger, } from "./initialization/defaults.cjs";
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD"}
+{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,qBAAiB;AAClC,YAAY,EAAE,aAAa,EAAE,oBAAgB;AAC7C,YAAY,EACV,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,YAAY,EACZ,aAAa,GACd,sCAAkC"}

package/dist/index.d.mts

@@ -1,8 +1,4 @@
-/**
- * Example function that returns a greeting for the given name.
- *
- * @param name - The name to greet.
- * @returns The greeting.
- */
-export default function greeter(name: string): string;
+export { Wallet } from "./Wallet.mjs";
+export type { WalletOptions } from "./types.mjs";
+export type { DefaultActions, DefaultEvents, DefaultInstances, DefaultState, RootMessenger, } from "./initialization/defaults.mjs";
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD"}
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,qBAAiB;AAClC,YAAY,EAAE,aAAa,EAAE,oBAAgB;AAC7C,YAAY,EACV,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,YAAY,EACZ,aAAa,GACd,sCAAkC"}

package/dist/index.mjs

@@ -1,10 +1,2 @@
-/**
- * Example function that returns a greeting for the given name.
- *
- * @param name - The name to greet.
- * @returns The greeting.
- */
-export default function greeter(name) {
-    return `Hello, ${name}!`;
-}
+export { Wallet } from "./Wallet.mjs";
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,OAAO,CAAC,IAAY;IAC1C,OAAO,UAAU,IAAI,GAAG,CAAC;AAC3B,CAAC","sourcesContent":["/**\n * Example function that returns a greeting for the given name.\n *\n * @param name - The name to greet.\n * @returns The greeting.\n */\nexport default function greeter(name: string): string {\n  return `Hello, ${name}!`;\n}\n"]}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,qBAAiB","sourcesContent":["export { Wallet } from './Wallet';\nexport type { WalletOptions } from './types';\nexport type {\n  DefaultActions,\n  DefaultEvents,\n  DefaultInstances,\n  DefaultState,\n  RootMessenger,\n} from './initialization/defaults';\n"]}

package/dist/initialization/defaults.cjs

@@ -0,0 +1,29 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultConfigurations = void 0;
+const defaultConfigurations = __importStar(require("./instances/index.cjs"));
+exports.defaultConfigurations = defaultConfigurations;
+//# sourceMappingURL=defaults.cjs.map

package/dist/initialization/defaults.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.cjs","sourceRoot":"","sources":["../../src/initialization/defaults.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAQA,6EAAqD;AAG5C,sDAAqB","sourcesContent":["import type {\n  ActionConstraint,\n  EventConstraint,\n  Messenger,\n  MessengerActions,\n  MessengerEvents,\n} from '@metamask/messenger';\n\nimport * as defaultConfigurations from './instances';\nimport type { InitializationConfiguration, InstanceState } from './types';\n\nexport { defaultConfigurations };\n\n/**\n * Utility type for inferring and extracting an instance type from an initialization configuration.\n */\ntype ExtractInstance<Config> =\n  Config extends InitializationConfiguration<infer Instance, unknown>\n    ? Instance\n    : never;\n\n/**\n * Utility type for inferring and extracting an instance messenger type from an initialization configuration.\n */\ntype ExtractInstanceMessenger<Config> =\n  Config extends InitializationConfiguration<unknown, infer InferredMessenger>\n    ? InferredMessenger\n    : never;\n\n/**\n * Utility type for inferring and extracting the name of an instance from an initialization configuration.\n */\ntype ExtractName<Config> =\n  ExtractInstance<Config> extends { name: infer Name extends string }\n    ? Name\n    : never;\n\ntype DefaultConfigs = typeof defaultConfigurations;\n\ntype AllDefaultMessengers = ExtractInstanceMessenger<\n  DefaultConfigs[keyof DefaultConfigs]\n>;\n\nexport type DefaultInstances = {\n  [Key in keyof DefaultConfigs as ExtractName<\n    DefaultConfigs[Key]\n  >]: ExtractInstance<DefaultConfigs[Key]>;\n};\n\nexport type DefaultActions = MessengerActions<AllDefaultMessengers>;\n\nexport type DefaultEvents = MessengerEvents<AllDefaultMessengers>;\n\nexport type RootMessenger<\n  AllowedActions extends ActionConstraint,\n  AllowedEvents extends EventConstraint,\n> = Messenger<'Root', AllowedActions, AllowedEvents>;\n\nexport type DefaultState = {\n  [Key in keyof DefaultInstances]: InstanceState<DefaultInstances[Key]>;\n};\n"]}

package/dist/initialization/defaults.d.cts

@@ -0,0 +1,30 @@
+import type { ActionConstraint, EventConstraint, Messenger, MessengerActions, MessengerEvents } from "@metamask/messenger";
+import * as defaultConfigurations from "./instances/index.cjs";
+import type { InitializationConfiguration, InstanceState } from "./types.cjs";
+export { defaultConfigurations };
+/**
+ * Utility type for inferring and extracting an instance type from an initialization configuration.
+ */
+type ExtractInstance<Config> = Config extends InitializationConfiguration<infer Instance, unknown> ? Instance : never;
+/**
+ * Utility type for inferring and extracting an instance messenger type from an initialization configuration.
+ */
+type ExtractInstanceMessenger<Config> = Config extends InitializationConfiguration<unknown, infer InferredMessenger> ? InferredMessenger : never;
+/**
+ * Utility type for inferring and extracting the name of an instance from an initialization configuration.
+ */
+type ExtractName<Config> = ExtractInstance<Config> extends {
+    name: infer Name extends string;
+} ? Name : never;
+type DefaultConfigs = typeof defaultConfigurations;
+type AllDefaultMessengers = ExtractInstanceMessenger<DefaultConfigs[keyof DefaultConfigs]>;
+export type DefaultInstances = {
+    [Key in keyof DefaultConfigs as ExtractName<DefaultConfigs[Key]>]: ExtractInstance<DefaultConfigs[Key]>;
+};
+export type DefaultActions = MessengerActions<AllDefaultMessengers>;
+export type DefaultEvents = MessengerEvents<AllDefaultMessengers>;
+export type RootMessenger<AllowedActions extends ActionConstraint, AllowedEvents extends EventConstraint> = Messenger<'Root', AllowedActions, AllowedEvents>;
+export type DefaultState = {
+    [Key in keyof DefaultInstances]: InstanceState<DefaultInstances[Key]>;
+};
+//# sourceMappingURL=defaults.d.cts.map

package/dist/initialization/defaults.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.cts","sourceRoot":"","sources":["../../src/initialization/defaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EACf,SAAS,EACT,gBAAgB,EAChB,eAAe,EAChB,4BAA4B;AAE7B,OAAO,KAAK,qBAAqB,8BAAoB;AACrD,OAAO,KAAK,EAAE,2BAA2B,EAAE,aAAa,EAAE,oBAAgB;AAE1E,OAAO,EAAE,qBAAqB,EAAE,CAAC;AAEjC;;GAEG;AACH,KAAK,eAAe,CAAC,MAAM,IACzB,MAAM,SAAS,2BAA2B,CAAC,MAAM,QAAQ,EAAE,OAAO,CAAC,GAC/D,QAAQ,GACR,KAAK,CAAC;AAEZ;;GAEG;AACH,KAAK,wBAAwB,CAAC,MAAM,IAClC,MAAM,SAAS,2BAA2B,CAAC,OAAO,EAAE,MAAM,iBAAiB,CAAC,GACxE,iBAAiB,GACjB,KAAK,CAAC;AAEZ;;GAEG;AACH,KAAK,WAAW,CAAC,MAAM,IACrB,eAAe,CAAC,MAAM,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,IAAI,SAAS,MAAM,CAAA;CAAE,GAC/D,IAAI,GACJ,KAAK,CAAC;AAEZ,KAAK,cAAc,GAAG,OAAO,qBAAqB,CAAC;AAEnD,KAAK,oBAAoB,GAAG,wBAAwB,CAClD,cAAc,CAAC,MAAM,cAAc,CAAC,CACrC,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;KAC5B,GAAG,IAAI,MAAM,cAAc,IAAI,WAAW,CACzC,cAAc,CAAC,GAAG,CAAC,CACpB,GAAG,eAAe,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;CACzC,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,gBAAgB,CAAC,oBAAoB,CAAC,CAAC;AAEpE,MAAM,MAAM,aAAa,GAAG,eAAe,CAAC,oBAAoB,CAAC,CAAC;AAElE,MAAM,MAAM,aAAa,CACvB,cAAc,SAAS,gBAAgB,EACvC,aAAa,SAAS,eAAe,IACnC,SAAS,CAAC,MAAM,EAAE,cAAc,EAAE,aAAa,CAAC,CAAC;AAErD,MAAM,MAAM,YAAY,GAAG;KACxB,GAAG,IAAI,MAAM,gBAAgB,GAAG,aAAa,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;CACtE,CAAC"}

package/dist/initialization/defaults.d.mts

@@ -0,0 +1,30 @@
+import type { ActionConstraint, EventConstraint, Messenger, MessengerActions, MessengerEvents } from "@metamask/messenger";
+import * as defaultConfigurations from "./instances/index.mjs";
+import type { InitializationConfiguration, InstanceState } from "./types.mjs";
+export { defaultConfigurations };
+/**
+ * Utility type for inferring and extracting an instance type from an initialization configuration.
+ */
+type ExtractInstance<Config> = Config extends InitializationConfiguration<infer Instance, unknown> ? Instance : never;
+/**
+ * Utility type for inferring and extracting an instance messenger type from an initialization configuration.
+ */
+type ExtractInstanceMessenger<Config> = Config extends InitializationConfiguration<unknown, infer InferredMessenger> ? InferredMessenger : never;
+/**
+ * Utility type for inferring and extracting the name of an instance from an initialization configuration.
+ */
+type ExtractName<Config> = ExtractInstance<Config> extends {
+    name: infer Name extends string;
+} ? Name : never;
+type DefaultConfigs = typeof defaultConfigurations;
+type AllDefaultMessengers = ExtractInstanceMessenger<DefaultConfigs[keyof DefaultConfigs]>;
+export type DefaultInstances = {
+    [Key in keyof DefaultConfigs as ExtractName<DefaultConfigs[Key]>]: ExtractInstance<DefaultConfigs[Key]>;
+};
+export type DefaultActions = MessengerActions<AllDefaultMessengers>;
+export type DefaultEvents = MessengerEvents<AllDefaultMessengers>;
+export type RootMessenger<AllowedActions extends ActionConstraint, AllowedEvents extends EventConstraint> = Messenger<'Root', AllowedActions, AllowedEvents>;
+export type DefaultState = {
+    [Key in keyof DefaultInstances]: InstanceState<DefaultInstances[Key]>;
+};
+//# sourceMappingURL=defaults.d.mts.map

package/dist/initialization/defaults.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.mts","sourceRoot":"","sources":["../../src/initialization/defaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EACf,SAAS,EACT,gBAAgB,EAChB,eAAe,EAChB,4BAA4B;AAE7B,OAAO,KAAK,qBAAqB,8BAAoB;AACrD,OAAO,KAAK,EAAE,2BAA2B,EAAE,aAAa,EAAE,oBAAgB;AAE1E,OAAO,EAAE,qBAAqB,EAAE,CAAC;AAEjC;;GAEG;AACH,KAAK,eAAe,CAAC,MAAM,IACzB,MAAM,SAAS,2BAA2B,CAAC,MAAM,QAAQ,EAAE,OAAO,CAAC,GAC/D,QAAQ,GACR,KAAK,CAAC;AAEZ;;GAEG;AACH,KAAK,wBAAwB,CAAC,MAAM,IAClC,MAAM,SAAS,2BAA2B,CAAC,OAAO,EAAE,MAAM,iBAAiB,CAAC,GACxE,iBAAiB,GACjB,KAAK,CAAC;AAEZ;;GAEG;AACH,KAAK,WAAW,CAAC,MAAM,IACrB,eAAe,CAAC,MAAM,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,IAAI,SAAS,MAAM,CAAA;CAAE,GAC/D,IAAI,GACJ,KAAK,CAAC;AAEZ,KAAK,cAAc,GAAG,OAAO,qBAAqB,CAAC;AAEnD,KAAK,oBAAoB,GAAG,wBAAwB,CAClD,cAAc,CAAC,MAAM,cAAc,CAAC,CACrC,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;KAC5B,GAAG,IAAI,MAAM,cAAc,IAAI,WAAW,CACzC,cAAc,CAAC,GAAG,CAAC,CACpB,GAAG,eAAe,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;CACzC,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,gBAAgB,CAAC,oBAAoB,CAAC,CAAC;AAEpE,MAAM,MAAM,aAAa,GAAG,eAAe,CAAC,oBAAoB,CAAC,CAAC;AAElE,MAAM,MAAM,aAAa,CACvB,cAAc,SAAS,gBAAgB,EACvC,aAAa,SAAS,eAAe,IACnC,SAAS,CAAC,MAAM,EAAE,cAAc,EAAE,aAAa,CAAC,CAAC;AAErD,MAAM,MAAM,YAAY,GAAG;KACxB,GAAG,IAAI,MAAM,gBAAgB,GAAG,aAAa,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;CACtE,CAAC"}

package/dist/initialization/defaults.mjs

@@ -0,0 +1,3 @@
+import * as defaultConfigurations from "./instances/index.mjs";
+export { defaultConfigurations };
+//# sourceMappingURL=defaults.mjs.map

package/dist/initialization/defaults.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.mjs","sourceRoot":"","sources":["../../src/initialization/defaults.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,qBAAqB,8BAAoB;AAGrD,OAAO,EAAE,qBAAqB,EAAE,CAAC","sourcesContent":["import type {\n  ActionConstraint,\n  EventConstraint,\n  Messenger,\n  MessengerActions,\n  MessengerEvents,\n} from '@metamask/messenger';\n\nimport * as defaultConfigurations from './instances';\nimport type { InitializationConfiguration, InstanceState } from './types';\n\nexport { defaultConfigurations };\n\n/**\n * Utility type for inferring and extracting an instance type from an initialization configuration.\n */\ntype ExtractInstance<Config> =\n  Config extends InitializationConfiguration<infer Instance, unknown>\n    ? Instance\n    : never;\n\n/**\n * Utility type for inferring and extracting an instance messenger type from an initialization configuration.\n */\ntype ExtractInstanceMessenger<Config> =\n  Config extends InitializationConfiguration<unknown, infer InferredMessenger>\n    ? InferredMessenger\n    : never;\n\n/**\n * Utility type for inferring and extracting the name of an instance from an initialization configuration.\n */\ntype ExtractName<Config> =\n  ExtractInstance<Config> extends { name: infer Name extends string }\n    ? Name\n    : never;\n\ntype DefaultConfigs = typeof defaultConfigurations;\n\ntype AllDefaultMessengers = ExtractInstanceMessenger<\n  DefaultConfigs[keyof DefaultConfigs]\n>;\n\nexport type DefaultInstances = {\n  [Key in keyof DefaultConfigs as ExtractName<\n    DefaultConfigs[Key]\n  >]: ExtractInstance<DefaultConfigs[Key]>;\n};\n\nexport type DefaultActions = MessengerActions<AllDefaultMessengers>;\n\nexport type DefaultEvents = MessengerEvents<AllDefaultMessengers>;\n\nexport type RootMessenger<\n  AllowedActions extends ActionConstraint,\n  AllowedEvents extends EventConstraint,\n> = Messenger<'Root', AllowedActions, AllowedEvents>;\n\nexport type DefaultState = {\n  [Key in keyof DefaultInstances]: InstanceState<DefaultInstances[Key]>;\n};\n"]}

package/dist/initialization/initialization.cjs

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initialize = void 0;
+const defaults_1 = require("./defaults.cjs");
+/**
+ * Initialize all instances based on th default configurations and any additional configurations specified in `options`.
+ *
+ * @param options - The wallet options.
+ * @returns A map containing the instances.
+ */
+function initialize(options) {
+    const { messenger, state = {}, initializationConfigurations = [], instanceOptions, } = options;
+    const overriddenConfiguration = initializationConfigurations.map((config) => config.name);
+    const configurationEntries = initializationConfigurations.concat(Object.values(defaults_1.defaultConfigurations).filter((config) => !overriddenConfiguration.includes(config.name)));
+    const instances = {};
+    for (const config of configurationEntries) {
+        const { name } = config;
+        const instanceState = state[name];
+        const instanceMessenger = config.getMessenger(messenger);
+        const camelCaseName = `${name.charAt(0).toLowerCase()}${name.slice(1)}`;
+        const instance = config.init({
+            // TODO: Consider whether this can be improved
+            state: instanceState,
+            messenger: instanceMessenger,
+            options: instanceOptions?.[camelCaseName] ?? {},
+        });
+        instances[name] = instance;
+    }
+    return instances;
+}
+exports.initialize = initialize;
+//# sourceMappingURL=initialization.cjs.map

package/dist/initialization/initialization.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"initialization.cjs","sourceRoot":"","sources":["../../src/initialization/initialization.ts"],"names":[],"mappings":";;;AAMA,6CAAkE;AAMlE;;;;;GAKG;AACH,SAAgB,UAAU,CAAC,OAA0B;IACnD,MAAM,EACJ,SAAS,EACT,KAAK,GAAG,EAAE,EACV,4BAA4B,GAAG,EAAE,EACjC,eAAe,GAChB,GAAG,OAAO,CAAC;IAEZ,MAAM,uBAAuB,GAAG,4BAA4B,CAAC,GAAG,CAC9D,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CACxB,CAAC;IAEF,MAAM,oBAAoB,GAAG,4BAA4B,CAAC,MAAM,CAC9D,MAAM,CAAC,MAAM,CAAC,gCAAqB,CAAC,CAAC,MAAM,CACzC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,uBAAuB,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAC3D,CACF,CAAC;IAEF,MAAM,SAAS,GAA4B,EAAE,CAAC;IAE9C,KAAK,MAAM,MAAM,IAAI,oBAAoB,EAAE,CAAC;QAC1C,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC;QAExB,MAAM,aAAa,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;QAElC,MAAM,iBAAiB,GAAG,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;QAEzD,MAAM,aAAa,GACjB,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAmC,CAAC;QAErF,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC;YAC3B,8CAA8C;YAC9C,KAAK,EAAE,aAAsB;YAC7B,SAAS,EAAE,iBAAiB;YAC5B,OAAO,EAAE,eAAe,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE;SAChD,CAAC,CAAC;QAEH,SAAS,CAAC,IAAI,CAAC,GAAG,QAAmC,CAAC;IACxD,CAAC;IAED,OAAO,SAA6B,CAAC;AACvC,CAAC;AAzCD,gCAyCC","sourcesContent":["import type { InstanceSpecificOptions, WalletOptions } from '../types';\nimport type {\n  DefaultActions,\n  DefaultEvents,\n  DefaultInstances,\n} from './defaults';\nimport { defaultConfigurations, RootMessenger } from './defaults';\n\ntype InitializeOptions = WalletOptions & {\n  messenger: RootMessenger<DefaultActions, DefaultEvents>;\n};\n\n/**\n * Initialize all instances based on th default configurations and any additional configurations specified in `options`.\n *\n * @param options - The wallet options.\n * @returns A map containing the instances.\n */\nexport function initialize(options: InitializeOptions): DefaultInstances {\n  const {\n    messenger,\n    state = {},\n    initializationConfigurations = [],\n    instanceOptions,\n  } = options;\n\n  const overriddenConfiguration = initializationConfigurations.map(\n    (config) => config.name,\n  );\n\n  const configurationEntries = initializationConfigurations.concat(\n    Object.values(defaultConfigurations).filter(\n      (config) => !overriddenConfiguration.includes(config.name),\n    ),\n  );\n\n  const instances: Record<string, unknown> = {};\n\n  for (const config of configurationEntries) {\n    const { name } = config;\n\n    const instanceState = state[name];\n\n    const instanceMessenger = config.getMessenger(messenger);\n\n    const camelCaseName =\n      `${name.charAt(0).toLowerCase()}${name.slice(1)}` as keyof InstanceSpecificOptions;\n\n    const instance = config.init({\n      // TODO: Consider whether this can be improved\n      state: instanceState as never,\n      messenger: instanceMessenger,\n      options: instanceOptions?.[camelCaseName] ?? {},\n    });\n\n    instances[name] = instance as Record<string, unknown>;\n  }\n\n  return instances as DefaultInstances;\n}\n"]}

package/dist/initialization/initialization.d.cts

@@ -0,0 +1,15 @@
+import type { WalletOptions } from "../types.cjs";
+import type { DefaultActions, DefaultEvents, DefaultInstances } from "./defaults.cjs";
+import { RootMessenger } from "./defaults.cjs";
+type InitializeOptions = WalletOptions & {
+    messenger: RootMessenger<DefaultActions, DefaultEvents>;
+};
+/**
+ * Initialize all instances based on th default configurations and any additional configurations specified in `options`.
+ *
+ * @param options - The wallet options.
+ * @returns A map containing the instances.
+ */
+export declare function initialize(options: InitializeOptions): DefaultInstances;
+export {};
+//# sourceMappingURL=initialization.d.cts.map

package/dist/initialization/initialization.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"initialization.d.cts","sourceRoot":"","sources":["../../src/initialization/initialization.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA2B,aAAa,EAAE,qBAAiB;AACvE,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,gBAAgB,EACjB,uBAAmB;AACpB,OAAO,EAAyB,aAAa,EAAE,uBAAmB;AAElE,KAAK,iBAAiB,GAAG,aAAa,GAAG;IACvC,SAAS,EAAE,aAAa,CAAC,cAAc,EAAE,aAAa,CAAC,CAAC;CACzD,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,gBAAgB,CAyCvE"}