@metamask-previews/client-controller 1.0.1-preview-3866c0ff1 → 1.0.1-preview-e3275932a

package/CHANGELOG.md

@@ -9,7 +9,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Changed
 
-- **BREAKING:** Bump minimum Node.js version to 22 ([#9168](https://github.com/MetaMask/core/pull/9168))
 - Bump `@metamask/messenger` from `^1.0.0` to `^2.0.0` ([#8364](https://github.com/MetaMask/core/pull/8364), [#8373](https://github.com/MetaMask/core/pull/8373), [#8632](https://github.com/MetaMask/core/pull/8632), [#9392](https://github.com/MetaMask/core/pull/9392))
 - Bump `@metamask/base-controller` from `^9.0.1` to `^9.1.0` ([#8457](https://github.com/MetaMask/core/pull/8457))
 

package/dist/ClientController-method-action-types.cjs

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * This file is auto generated.
+ * Do not edit manually.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ClientController-method-action-types.cjs.map

package/dist/ClientController-method-action-types.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClientController-method-action-types.cjs","sourceRoot":"","sources":["../src/ClientController-method-action-types.ts"],"names":[],"mappings":";AAAA;;;GAGG","sourcesContent":["/**\n * This file is auto generated.\n * Do not edit manually.\n */\n\nimport type { ClientController } from './ClientController.js';\n\n/**\n * Updates state with whether the MetaMask UI is open.\n *\n * This method should be called when the user has opened the first window or\n * screen containing the MetaMask UI, or closed the last window or screen\n * containing the MetaMask UI.\n *\n * @param open - Whether the MetaMask UI is open.\n */\nexport type ClientControllerSetUiOpenAction = {\n  type: `ClientController:setUiOpen`;\n  handler: ClientController['setUiOpen'];\n};\n\n/**\n * Union of all ClientController action types.\n */\nexport type ClientControllerMethodActions = ClientControllerSetUiOpenAction;\n"]}

package/dist/{ClientController-method-action-types.d.ts → ClientController-method-action-types.d.cts}

@@ -2,7 +2,7 @@
  * This file is auto generated.
  * Do not edit manually.
  */
-import type { ClientController } from './ClientController.js';
+import type { ClientController } from "./ClientController.cjs";
 /**
  * Updates state with whether the MetaMask UI is open.
  *
@@ -20,4 +20,4 @@ export type ClientControllerSetUiOpenAction = {
  * Union of all ClientController action types.
  */
 export type ClientControllerMethodActions = ClientControllerSetUiOpenAction;
-//# sourceMappingURL=ClientController-method-action-types.d.ts.map
+//# sourceMappingURL=ClientController-method-action-types.d.cts.map

package/dist/ClientController-method-action-types.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClientController-method-action-types.d.cts","sourceRoot":"","sources":["../src/ClientController-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,+BAA8B;AAE9D;;;;;;;;GAQG;AACH,MAAM,MAAM,+BAA+B,GAAG;IAC5C,IAAI,EAAE,4BAA4B,CAAC;IACnC,OAAO,EAAE,gBAAgB,CAAC,WAAW,CAAC,CAAC;CACxC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,6BAA6B,GAAG,+BAA+B,CAAC"}

package/dist/ClientController-method-action-types.d.mts

@@ -0,0 +1,23 @@
+/**
+ * This file is auto generated.
+ * Do not edit manually.
+ */
+import type { ClientController } from "./ClientController.mjs";
+/**
+ * Updates state with whether the MetaMask UI is open.
+ *
+ * This method should be called when the user has opened the first window or
+ * screen containing the MetaMask UI, or closed the last window or screen
+ * containing the MetaMask UI.
+ *
+ * @param open - Whether the MetaMask UI is open.
+ */
+export type ClientControllerSetUiOpenAction = {
+    type: `ClientController:setUiOpen`;
+    handler: ClientController['setUiOpen'];
+};
+/**
+ * Union of all ClientController action types.
+ */
+export type ClientControllerMethodActions = ClientControllerSetUiOpenAction;
+//# sourceMappingURL=ClientController-method-action-types.d.mts.map

package/dist/ClientController-method-action-types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClientController-method-action-types.d.mts","sourceRoot":"","sources":["../src/ClientController-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,+BAA8B;AAE9D;;;;;;;;GAQG;AACH,MAAM,MAAM,+BAA+B,GAAG;IAC5C,IAAI,EAAE,4BAA4B,CAAC;IACnC,OAAO,EAAE,gBAAgB,CAAC,WAAW,CAAC,CAAC;CACxC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,6BAA6B,GAAG,+BAA+B,CAAC"}

package/dist/{ClientController-method-action-types.js → ClientController-method-action-types.mjs}

@@ -3,4 +3,4 @@
  * Do not edit manually.
  */
 export {};
-//# sourceMappingURL=ClientController-method-action-types.js.map
+//# sourceMappingURL=ClientController-method-action-types.mjs.map

package/dist/ClientController-method-action-types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClientController-method-action-types.mjs","sourceRoot":"","sources":["../src/ClientController-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG","sourcesContent":["/**\n * This file is auto generated.\n * Do not edit manually.\n */\n\nimport type { ClientController } from './ClientController.js';\n\n/**\n * Updates state with whether the MetaMask UI is open.\n *\n * This method should be called when the user has opened the first window or\n * screen containing the MetaMask UI, or closed the last window or screen\n * containing the MetaMask UI.\n *\n * @param open - Whether the MetaMask UI is open.\n */\nexport type ClientControllerSetUiOpenAction = {\n  type: `ClientController:setUiOpen`;\n  handler: ClientController['setUiOpen'];\n};\n\n/**\n * Union of all ClientController action types.\n */\nexport type ClientControllerMethodActions = ClientControllerSetUiOpenAction;\n"]}

package/dist/ClientController.cjs

@@ -0,0 +1,117 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClientController = exports.getDefaultClientControllerState = exports.controllerName = void 0;
+const base_controller_1 = require("@metamask/base-controller");
+// === GENERAL ===
+/**
+ * The name of the {@link ClientController}.
+ */
+exports.controllerName = 'ClientController';
+/**
+ * Constructs the default {@link ClientController} state.
+ *
+ * @returns The default {@link ClientController} state.
+ */
+function getDefaultClientControllerState() {
+    return {
+        isUiOpen: false,
+    };
+}
+exports.getDefaultClientControllerState = getDefaultClientControllerState;
+/**
+ * The metadata for each property in {@link ClientControllerState}.
+ */
+const controllerMetadata = {
+    isUiOpen: {
+        includeInDebugSnapshot: true,
+        includeInStateLogs: true,
+        persist: false,
+        usedInUi: false,
+    },
+};
+// === MESSENGER ===
+const MESSENGER_EXPOSED_METHODS = ['setUiOpen'];
+/**
+ * `ClientController` manages the application lifecycle state.
+ *
+ * This controller tracks whether the MetaMask UI is open and publishes state
+ * change events that other controllers can subscribe to for adjusting their behavior.
+ *
+ * **Use cases:**
+ * - Polling controllers can pause when the UI closes, resume when it opens
+ * - WebSocket connections can disconnect when closed, reconnect when opened
+ * - Real-time subscriptions can pause when not visible
+ *
+ * **Platform Integration:**
+ * Platform code should call `ClientController:setUiOpen` via messenger.
+ *
+ * @example
+ * ```typescript
+ * // In MetamaskController or platform code
+ * onUiOpened() {
+ *   // ...
+ *   this.controllerMessenger.call('ClientController:setUiOpen', true);
+ * }
+ *
+ * onUiClosed() {
+ *   // ...
+ *   this.controllerMessenger.call('ClientController:setUiOpen', false);
+ * }
+ *
+ * // Consumer controller subscribing to state changes
+ * class MyController extends BaseController {
+ *   constructor({ messenger }) {
+ *     super({ messenger, ... });
+ *
+ *     messenger.subscribe(
+ *       'ClientController:stateChange',
+ *       (isClientOpen) => {
+ *         if (isClientOpen) {
+ *           this.resumePolling();
+ *         } else {
+ *           this.pausePolling();
+ *         }
+ *       },
+ *       clientControllerSelectors.selectIsUiOpen,
+ *     );
+ *   }
+ * }
+ * ```
+ */
+class ClientController extends base_controller_1.BaseController {
+    /**
+     * Constructs a new {@link ClientController}.
+     *
+     * @param options - The constructor options.
+     * @param options.messenger - The messenger suited for this controller.
+     * @param options.state - The initial state to set on this controller.
+     */
+    constructor({ messenger, state = {} }) {
+        super({
+            messenger,
+            metadata: controllerMetadata,
+            name: exports.controllerName,
+            state: {
+                ...getDefaultClientControllerState(),
+                ...state,
+            },
+        });
+        this.messenger.registerMethodActionHandlers(this, MESSENGER_EXPOSED_METHODS);
+    }
+    /**
+     * Updates state with whether the MetaMask UI is open.
+     *
+     * This method should be called when the user has opened the first window or
+     * screen containing the MetaMask UI, or closed the last window or screen
+     * containing the MetaMask UI.
+     *
+     * @param open - Whether the MetaMask UI is open.
+     */
+    setUiOpen(open) {
+        this.update((state) => {
+            state.isUiOpen = open;
+        });
+    }
+}
+exports.ClientController = ClientController;
+//# sourceMappingURL=ClientController.cjs.map

package/dist/ClientController.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClientController.cjs","sourceRoot":"","sources":["../src/ClientController.ts"],"names":[],"mappings":";;;AAKA,+DAA2D;AAK3D,kBAAkB;AAElB;;GAEG;AACU,QAAA,cAAc,GAAG,kBAAkB,CAAC;AAgBjD;;;;GAIG;AACH,SAAgB,+BAA+B;IAC7C,OAAO;QACL,QAAQ,EAAE,KAAK;KAChB,CAAC;AACJ,CAAC;AAJD,0EAIC;AAED;;GAEG;AACH,MAAM,kBAAkB,GAAG;IACzB,QAAQ,EAAE;QACR,sBAAsB,EAAE,IAAI;QAC5B,kBAAkB,EAAE,IAAI;QACxB,OAAO,EAAE,KAAK;QACd,QAAQ,EAAE,KAAK;KAChB;CAC6C,CAAC;AAEjD,oBAAoB;AAEpB,MAAM,yBAAyB,GAAG,CAAC,WAAW,CAAU,CAAC;AAiEzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,MAAa,gBAAiB,SAAQ,gCAIrC;IACC;;;;;;OAMG;IACH,YAAY,EAAE,SAAS,EAAE,KAAK,GAAG,EAAE,EAA2B;QAC5D,KAAK,CAAC;YACJ,SAAS;YACT,QAAQ,EAAE,kBAAkB;YAC5B,IAAI,EAAE,sBAAc;YACpB,KAAK,EAAE;gBACL,GAAG,+BAA+B,EAAE;gBACpC,GAAG,KAAK;aACT;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,SAAS,CAAC,4BAA4B,CACzC,IAAI,EACJ,yBAAyB,CAC1B,CAAC;IACJ,CAAC;IAED;;;;;;;;OAQG;IACH,SAAS,CAAC,IAAa;QACrB,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;YACpB,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC;QACxB,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AA3CD,4CA2CC","sourcesContent":["import type {\n  StateMetadata,\n  ControllerGetStateAction,\n  ControllerStateChangeEvent,\n} from '@metamask/base-controller';\nimport { BaseController } from '@metamask/base-controller';\nimport type { Messenger } from '@metamask/messenger';\n\nimport type { ClientControllerMethodActions } from './ClientController-method-action-types.js';\n\n// === GENERAL ===\n\n/**\n * The name of the {@link ClientController}.\n */\nexport const controllerName = 'ClientController';\n\n// === STATE ===\n\n/**\n * Describes the shape of the state object for {@link ClientController}.\n */\nexport type ClientControllerState = {\n  /**\n   * Whether the user has opened at least one window or screen\n   * containing the MetaMask UI. These windows or screens may or\n   * may not be in an inactive state.\n   */\n  isUiOpen: boolean;\n};\n\n/**\n * Constructs the default {@link ClientController} state.\n *\n * @returns The default {@link ClientController} state.\n */\nexport function getDefaultClientControllerState(): ClientControllerState {\n  return {\n    isUiOpen: false,\n  };\n}\n\n/**\n * The metadata for each property in {@link ClientControllerState}.\n */\nconst controllerMetadata = {\n  isUiOpen: {\n    includeInDebugSnapshot: true,\n    includeInStateLogs: true,\n    persist: false,\n    usedInUi: false,\n  },\n} satisfies StateMetadata<ClientControllerState>;\n\n// === MESSENGER ===\n\nconst MESSENGER_EXPOSED_METHODS = ['setUiOpen'] as const;\n\n/**\n * Retrieves the state of the {@link ClientController}.\n */\nexport type ClientControllerGetStateAction = ControllerGetStateAction<\n  typeof controllerName,\n  ClientControllerState\n>;\n\n/**\n * Actions that {@link ClientController} exposes.\n */\nexport type ClientControllerActions =\n  | ClientControllerGetStateAction\n  | ClientControllerMethodActions;\n\n/**\n * Actions from other messengers that {@link ClientController} calls.\n */\ntype AllowedActions = never;\n\n/**\n * Published when the state of {@link ClientController} changes.\n */\nexport type ClientControllerStateChangeEvent = ControllerStateChangeEvent<\n  typeof controllerName,\n  ClientControllerState\n>;\n\n/**\n * Events that {@link ClientController} exposes.\n */\nexport type ClientControllerEvents = ClientControllerStateChangeEvent;\n\n/**\n * Events from other messengers that {@link ClientController} subscribes to.\n */\ntype AllowedEvents = never;\n\n/**\n * The messenger for {@link ClientController}.\n */\nexport type ClientControllerMessenger = Messenger<\n  typeof controllerName,\n  ClientControllerActions | AllowedActions,\n  ClientControllerEvents | AllowedEvents\n>;\n\n// === CONTROLLER DEFINITION ===\n\n/**\n * The options for constructing a {@link ClientController}.\n */\nexport type ClientControllerOptions = {\n  /**\n   * The messenger suited for this controller.\n   */\n  messenger: ClientControllerMessenger;\n  /**\n   * The initial state to set on this controller.\n   */\n  state?: Partial<ClientControllerState>;\n};\n\n/**\n * `ClientController` manages the application lifecycle state.\n *\n * This controller tracks whether the MetaMask UI is open and publishes state\n * change events that other controllers can subscribe to for adjusting their behavior.\n *\n * **Use cases:**\n * - Polling controllers can pause when the UI closes, resume when it opens\n * - WebSocket connections can disconnect when closed, reconnect when opened\n * - Real-time subscriptions can pause when not visible\n *\n * **Platform Integration:**\n * Platform code should call `ClientController:setUiOpen` via messenger.\n *\n * @example\n * ```typescript\n * // In MetamaskController or platform code\n * onUiOpened() {\n *   // ...\n *   this.controllerMessenger.call('ClientController:setUiOpen', true);\n * }\n *\n * onUiClosed() {\n *   // ...\n *   this.controllerMessenger.call('ClientController:setUiOpen', false);\n * }\n *\n * // Consumer controller subscribing to state changes\n * class MyController extends BaseController {\n *   constructor({ messenger }) {\n *     super({ messenger, ... });\n *\n *     messenger.subscribe(\n *       'ClientController:stateChange',\n *       (isClientOpen) => {\n *         if (isClientOpen) {\n *           this.resumePolling();\n *         } else {\n *           this.pausePolling();\n *         }\n *       },\n *       clientControllerSelectors.selectIsUiOpen,\n *     );\n *   }\n * }\n * ```\n */\nexport class ClientController extends BaseController<\n  typeof controllerName,\n  ClientControllerState,\n  ClientControllerMessenger\n> {\n  /**\n   * Constructs a new {@link ClientController}.\n   *\n   * @param options - The constructor options.\n   * @param options.messenger - The messenger suited for this controller.\n   * @param options.state - The initial state to set on this controller.\n   */\n  constructor({ messenger, state = {} }: ClientControllerOptions) {\n    super({\n      messenger,\n      metadata: controllerMetadata,\n      name: controllerName,\n      state: {\n        ...getDefaultClientControllerState(),\n        ...state,\n      },\n    });\n\n    this.messenger.registerMethodActionHandlers(\n      this,\n      MESSENGER_EXPOSED_METHODS,\n    );\n  }\n\n  /**\n   * Updates state with whether the MetaMask UI is open.\n   *\n   * This method should be called when the user has opened the first window or\n   * screen containing the MetaMask UI, or closed the last window or screen\n   * containing the MetaMask UI.\n   *\n   * @param open - Whether the MetaMask UI is open.\n   */\n  setUiOpen(open: boolean): void {\n    this.update((state) => {\n      state.isUiOpen = open;\n    });\n  }\n}\n"]}

package/dist/{ClientController.d.ts → ClientController.d.cts}

@@ -1,7 +1,7 @@
-import type { ControllerGetStateAction, ControllerStateChangeEvent } from '@metamask/base-controller';
-import { BaseController } from '@metamask/base-controller';
-import type { Messenger } from '@metamask/messenger';
-import type { ClientControllerMethodActions } from './ClientController-method-action-types.js';
+import type { ControllerGetStateAction, ControllerStateChangeEvent } from "@metamask/base-controller";
+import { BaseController } from "@metamask/base-controller";
+import type { Messenger } from "@metamask/messenger";
+import type { ClientControllerMethodActions } from "./ClientController-method-action-types.cjs";
 /**
  * The name of the {@link ClientController}.
  */
@@ -132,4 +132,4 @@ export declare class ClientController extends BaseController<typeof controllerNa
     setUiOpen(open: boolean): void;
 }
 export {};
-//# sourceMappingURL=ClientController.d.ts.map
+//# sourceMappingURL=ClientController.d.cts.map

package/dist/ClientController.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClientController.d.cts","sourceRoot":"","sources":["../src/ClientController.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,wBAAwB,EACxB,0BAA0B,EAC3B,kCAAkC;AACnC,OAAO,EAAE,cAAc,EAAE,kCAAkC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,4BAA4B;AAErD,OAAO,KAAK,EAAE,6BAA6B,EAAE,mDAAkD;AAI/F;;GAEG;AACH,eAAO,MAAM,cAAc,qBAAqB,CAAC;AAIjD;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC;;;;OAIG;IACH,QAAQ,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,+BAA+B,IAAI,qBAAqB,CAIvE;AAkBD;;GAEG;AACH,MAAM,MAAM,8BAA8B,GAAG,wBAAwB,CACnE,OAAO,cAAc,EACrB,qBAAqB,CACtB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAC/B,8BAA8B,GAC9B,6BAA6B,CAAC;AAElC;;GAEG;AACH,KAAK,cAAc,GAAG,KAAK,CAAC;AAE5B;;GAEG;AACH,MAAM,MAAM,gCAAgC,GAAG,0BAA0B,CACvE,OAAO,cAAc,EACrB,qBAAqB,CACtB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,gCAAgC,CAAC;AAEtE;;GAEG;AACH,KAAK,aAAa,GAAG,KAAK,CAAC;AAE3B;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG,SAAS,CAC/C,OAAO,cAAc,EACrB,uBAAuB,GAAG,cAAc,EACxC,sBAAsB,GAAG,aAAa,CACvC,CAAC;AAIF;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACpC;;OAEG;IACH,SAAS,EAAE,yBAAyB,CAAC;IACrC;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,CAAC;CACxC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,qBAAa,gBAAiB,SAAQ,cAAc,CAClD,OAAO,cAAc,EACrB,qBAAqB,EACrB,yBAAyB,CAC1B;IACC;;;;;;OAMG;gBACS,EAAE,SAAS,EAAE,KAAU,EAAE,EAAE,uBAAuB;IAiB9D;;;;;;;;OAQG;IACH,SAAS,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;CAK/B"}

package/dist/ClientController.d.mts

@@ -0,0 +1,135 @@
+import type { ControllerGetStateAction, ControllerStateChangeEvent } from "@metamask/base-controller";
+import { BaseController } from "@metamask/base-controller";
+import type { Messenger } from "@metamask/messenger";
+import type { ClientControllerMethodActions } from "./ClientController-method-action-types.mjs";
+/**
+ * The name of the {@link ClientController}.
+ */
+export declare const controllerName = "ClientController";
+/**
+ * Describes the shape of the state object for {@link ClientController}.
+ */
+export type ClientControllerState = {
+    /**
+     * Whether the user has opened at least one window or screen
+     * containing the MetaMask UI. These windows or screens may or
+     * may not be in an inactive state.
+     */
+    isUiOpen: boolean;
+};
+/**
+ * Constructs the default {@link ClientController} state.
+ *
+ * @returns The default {@link ClientController} state.
+ */
+export declare function getDefaultClientControllerState(): ClientControllerState;
+/**
+ * Retrieves the state of the {@link ClientController}.
+ */
+export type ClientControllerGetStateAction = ControllerGetStateAction<typeof controllerName, ClientControllerState>;
+/**
+ * Actions that {@link ClientController} exposes.
+ */
+export type ClientControllerActions = ClientControllerGetStateAction | ClientControllerMethodActions;
+/**
+ * Actions from other messengers that {@link ClientController} calls.
+ */
+type AllowedActions = never;
+/**
+ * Published when the state of {@link ClientController} changes.
+ */
+export type ClientControllerStateChangeEvent = ControllerStateChangeEvent<typeof controllerName, ClientControllerState>;
+/**
+ * Events that {@link ClientController} exposes.
+ */
+export type ClientControllerEvents = ClientControllerStateChangeEvent;
+/**
+ * Events from other messengers that {@link ClientController} subscribes to.
+ */
+type AllowedEvents = never;
+/**
+ * The messenger for {@link ClientController}.
+ */
+export type ClientControllerMessenger = Messenger<typeof controllerName, ClientControllerActions | AllowedActions, ClientControllerEvents | AllowedEvents>;
+/**
+ * The options for constructing a {@link ClientController}.
+ */
+export type ClientControllerOptions = {
+    /**
+     * The messenger suited for this controller.
+     */
+    messenger: ClientControllerMessenger;
+    /**
+     * The initial state to set on this controller.
+     */
+    state?: Partial<ClientControllerState>;
+};
+/**
+ * `ClientController` manages the application lifecycle state.
+ *
+ * This controller tracks whether the MetaMask UI is open and publishes state
+ * change events that other controllers can subscribe to for adjusting their behavior.
+ *
+ * **Use cases:**
+ * - Polling controllers can pause when the UI closes, resume when it opens
+ * - WebSocket connections can disconnect when closed, reconnect when opened
+ * - Real-time subscriptions can pause when not visible
+ *
+ * **Platform Integration:**
+ * Platform code should call `ClientController:setUiOpen` via messenger.
+ *
+ * @example
+ * ```typescript
+ * // In MetamaskController or platform code
+ * onUiOpened() {
+ *   // ...
+ *   this.controllerMessenger.call('ClientController:setUiOpen', true);
+ * }
+ *
+ * onUiClosed() {
+ *   // ...
+ *   this.controllerMessenger.call('ClientController:setUiOpen', false);
+ * }
+ *
+ * // Consumer controller subscribing to state changes
+ * class MyController extends BaseController {
+ *   constructor({ messenger }) {
+ *     super({ messenger, ... });
+ *
+ *     messenger.subscribe(
+ *       'ClientController:stateChange',
+ *       (isClientOpen) => {
+ *         if (isClientOpen) {
+ *           this.resumePolling();
+ *         } else {
+ *           this.pausePolling();
+ *         }
+ *       },
+ *       clientControllerSelectors.selectIsUiOpen,
+ *     );
+ *   }
+ * }
+ * ```
+ */
+export declare class ClientController extends BaseController<typeof controllerName, ClientControllerState, ClientControllerMessenger> {
+    /**
+     * Constructs a new {@link ClientController}.
+     *
+     * @param options - The constructor options.
+     * @param options.messenger - The messenger suited for this controller.
+     * @param options.state - The initial state to set on this controller.
+     */
+    constructor({ messenger, state }: ClientControllerOptions);
+    /**
+     * Updates state with whether the MetaMask UI is open.
+     *
+     * This method should be called when the user has opened the first window or
+     * screen containing the MetaMask UI, or closed the last window or screen
+     * containing the MetaMask UI.
+     *
+     * @param open - Whether the MetaMask UI is open.
+     */
+    setUiOpen(open: boolean): void;
+}
+export {};
+//# sourceMappingURL=ClientController.d.mts.map

package/dist/ClientController.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClientController.d.mts","sourceRoot":"","sources":["../src/ClientController.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,wBAAwB,EACxB,0BAA0B,EAC3B,kCAAkC;AACnC,OAAO,EAAE,cAAc,EAAE,kCAAkC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,4BAA4B;AAErD,OAAO,KAAK,EAAE,6BAA6B,EAAE,mDAAkD;AAI/F;;GAEG;AACH,eAAO,MAAM,cAAc,qBAAqB,CAAC;AAIjD;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC;;;;OAIG;IACH,QAAQ,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,+BAA+B,IAAI,qBAAqB,CAIvE;AAkBD;;GAEG;AACH,MAAM,MAAM,8BAA8B,GAAG,wBAAwB,CACnE,OAAO,cAAc,EACrB,qBAAqB,CACtB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAC/B,8BAA8B,GAC9B,6BAA6B,CAAC;AAElC;;GAEG;AACH,KAAK,cAAc,GAAG,KAAK,CAAC;AAE5B;;GAEG;AACH,MAAM,MAAM,gCAAgC,GAAG,0BAA0B,CACvE,OAAO,cAAc,EACrB,qBAAqB,CACtB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,gCAAgC,CAAC;AAEtE;;GAEG;AACH,KAAK,aAAa,GAAG,KAAK,CAAC;AAE3B;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG,SAAS,CAC/C,OAAO,cAAc,EACrB,uBAAuB,GAAG,cAAc,EACxC,sBAAsB,GAAG,aAAa,CACvC,CAAC;AAIF;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACpC;;OAEG;IACH,SAAS,EAAE,yBAAyB,CAAC;IACrC;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,CAAC;CACxC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,qBAAa,gBAAiB,SAAQ,cAAc,CAClD,OAAO,cAAc,EACrB,qBAAqB,EACrB,yBAAyB,CAC1B;IACC;;;;;;OAMG;gBACS,EAAE,SAAS,EAAE,KAAU,EAAE,EAAE,uBAAuB;IAiB9D;;;;;;;;OAQG;IACH,SAAS,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;CAK/B"}

package/dist/{ClientController.js → ClientController.mjs}

@@ -1,4 +1,4 @@
-import { BaseController } from '@metamask/base-controller';
+import { BaseController } from "@metamask/base-controller";
 // === GENERAL ===
 /**
  * The name of the {@link ClientController}.
@@ -109,4 +109,4 @@ export class ClientController extends BaseController {
         });
     }
 }
-//# sourceMappingURL=ClientController.js.map
+//# sourceMappingURL=ClientController.mjs.map

package/dist/ClientController.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClientController.mjs","sourceRoot":"","sources":["../src/ClientController.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,cAAc,EAAE,kCAAkC;AAK3D,kBAAkB;AAElB;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,kBAAkB,CAAC;AAgBjD;;;;GAIG;AACH,MAAM,UAAU,+BAA+B;IAC7C,OAAO;QACL,QAAQ,EAAE,KAAK;KAChB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,kBAAkB,GAAG;IACzB,QAAQ,EAAE;QACR,sBAAsB,EAAE,IAAI;QAC5B,kBAAkB,EAAE,IAAI;QACxB,OAAO,EAAE,KAAK;QACd,QAAQ,EAAE,KAAK;KAChB;CAC6C,CAAC;AAEjD,oBAAoB;AAEpB,MAAM,yBAAyB,GAAG,CAAC,WAAW,CAAU,CAAC;AAiEzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,MAAM,OAAO,gBAAiB,SAAQ,cAIrC;IACC;;;;;;OAMG;IACH,YAAY,EAAE,SAAS,EAAE,KAAK,GAAG,EAAE,EAA2B;QAC5D,KAAK,CAAC;YACJ,SAAS;YACT,QAAQ,EAAE,kBAAkB;YAC5B,IAAI,EAAE,cAAc;YACpB,KAAK,EAAE;gBACL,GAAG,+BAA+B,EAAE;gBACpC,GAAG,KAAK;aACT;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,SAAS,CAAC,4BAA4B,CACzC,IAAI,EACJ,yBAAyB,CAC1B,CAAC;IACJ,CAAC;IAED;;;;;;;;OAQG;IACH,SAAS,CAAC,IAAa;QACrB,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;YACpB,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC;QACxB,CAAC,CAAC,CAAC;IACL,CAAC;CACF","sourcesContent":["import type {\n  StateMetadata,\n  ControllerGetStateAction,\n  ControllerStateChangeEvent,\n} from '@metamask/base-controller';\nimport { BaseController } from '@metamask/base-controller';\nimport type { Messenger } from '@metamask/messenger';\n\nimport type { ClientControllerMethodActions } from './ClientController-method-action-types.js';\n\n// === GENERAL ===\n\n/**\n * The name of the {@link ClientController}.\n */\nexport const controllerName = 'ClientController';\n\n// === STATE ===\n\n/**\n * Describes the shape of the state object for {@link ClientController}.\n */\nexport type ClientControllerState = {\n  /**\n   * Whether the user has opened at least one window or screen\n   * containing the MetaMask UI. These windows or screens may or\n   * may not be in an inactive state.\n   */\n  isUiOpen: boolean;\n};\n\n/**\n * Constructs the default {@link ClientController} state.\n *\n * @returns The default {@link ClientController} state.\n */\nexport function getDefaultClientControllerState(): ClientControllerState {\n  return {\n    isUiOpen: false,\n  };\n}\n\n/**\n * The metadata for each property in {@link ClientControllerState}.\n */\nconst controllerMetadata = {\n  isUiOpen: {\n    includeInDebugSnapshot: true,\n    includeInStateLogs: true,\n    persist: false,\n    usedInUi: false,\n  },\n} satisfies StateMetadata<ClientControllerState>;\n\n// === MESSENGER ===\n\nconst MESSENGER_EXPOSED_METHODS = ['setUiOpen'] as const;\n\n/**\n * Retrieves the state of the {@link ClientController}.\n */\nexport type ClientControllerGetStateAction = ControllerGetStateAction<\n  typeof controllerName,\n  ClientControllerState\n>;\n\n/**\n * Actions that {@link ClientController} exposes.\n */\nexport type ClientControllerActions =\n  | ClientControllerGetStateAction\n  | ClientControllerMethodActions;\n\n/**\n * Actions from other messengers that {@link ClientController} calls.\n */\ntype AllowedActions = never;\n\n/**\n * Published when the state of {@link ClientController} changes.\n */\nexport type ClientControllerStateChangeEvent = ControllerStateChangeEvent<\n  typeof controllerName,\n  ClientControllerState\n>;\n\n/**\n * Events that {@link ClientController} exposes.\n */\nexport type ClientControllerEvents = ClientControllerStateChangeEvent;\n\n/**\n * Events from other messengers that {@link ClientController} subscribes to.\n */\ntype AllowedEvents = never;\n\n/**\n * The messenger for {@link ClientController}.\n */\nexport type ClientControllerMessenger = Messenger<\n  typeof controllerName,\n  ClientControllerActions | AllowedActions,\n  ClientControllerEvents | AllowedEvents\n>;\n\n// === CONTROLLER DEFINITION ===\n\n/**\n * The options for constructing a {@link ClientController}.\n */\nexport type ClientControllerOptions = {\n  /**\n   * The messenger suited for this controller.\n   */\n  messenger: ClientControllerMessenger;\n  /**\n   * The initial state to set on this controller.\n   */\n  state?: Partial<ClientControllerState>;\n};\n\n/**\n * `ClientController` manages the application lifecycle state.\n *\n * This controller tracks whether the MetaMask UI is open and publishes state\n * change events that other controllers can subscribe to for adjusting their behavior.\n *\n * **Use cases:**\n * - Polling controllers can pause when the UI closes, resume when it opens\n * - WebSocket connections can disconnect when closed, reconnect when opened\n * - Real-time subscriptions can pause when not visible\n *\n * **Platform Integration:**\n * Platform code should call `ClientController:setUiOpen` via messenger.\n *\n * @example\n * ```typescript\n * // In MetamaskController or platform code\n * onUiOpened() {\n *   // ...\n *   this.controllerMessenger.call('ClientController:setUiOpen', true);\n * }\n *\n * onUiClosed() {\n *   // ...\n *   this.controllerMessenger.call('ClientController:setUiOpen', false);\n * }\n *\n * // Consumer controller subscribing to state changes\n * class MyController extends BaseController {\n *   constructor({ messenger }) {\n *     super({ messenger, ... });\n *\n *     messenger.subscribe(\n *       'ClientController:stateChange',\n *       (isClientOpen) => {\n *         if (isClientOpen) {\n *           this.resumePolling();\n *         } else {\n *           this.pausePolling();\n *         }\n *       },\n *       clientControllerSelectors.selectIsUiOpen,\n *     );\n *   }\n * }\n * ```\n */\nexport class ClientController extends BaseController<\n  typeof controllerName,\n  ClientControllerState,\n  ClientControllerMessenger\n> {\n  /**\n   * Constructs a new {@link ClientController}.\n   *\n   * @param options - The constructor options.\n   * @param options.messenger - The messenger suited for this controller.\n   * @param options.state - The initial state to set on this controller.\n   */\n  constructor({ messenger, state = {} }: ClientControllerOptions) {\n    super({\n      messenger,\n      metadata: controllerMetadata,\n      name: controllerName,\n      state: {\n        ...getDefaultClientControllerState(),\n        ...state,\n      },\n    });\n\n    this.messenger.registerMethodActionHandlers(\n      this,\n      MESSENGER_EXPOSED_METHODS,\n    );\n  }\n\n  /**\n   * Updates state with whether the MetaMask UI is open.\n   *\n   * This method should be called when the user has opened the first window or\n   * screen containing the MetaMask UI, or closed the last window or screen\n   * containing the MetaMask UI.\n   *\n   * @param open - Whether the MetaMask UI is open.\n   */\n  setUiOpen(open: boolean): void {\n    this.update((state) => {\n      state.isUiOpen = open;\n    });\n  }\n}\n"]}

package/dist/index.cjs

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clientControllerSelectors = exports.getDefaultClientControllerState = exports.ClientController = void 0;
+var ClientController_js_1 = require("./ClientController.cjs");
+Object.defineProperty(exports, "ClientController", { enumerable: true, get: function () { return ClientController_js_1.ClientController; } });
+Object.defineProperty(exports, "getDefaultClientControllerState", { enumerable: true, get: function () { return ClientController_js_1.getDefaultClientControllerState; } });
+var selectors_js_1 = require("./selectors.cjs");
+Object.defineProperty(exports, "clientControllerSelectors", { enumerable: true, get: function () { return selectors_js_1.clientControllerSelectors; } });
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,8DAG+B;AAF7B,uHAAA,gBAAgB,OAAA;AAChB,sIAAA,+BAA+B,OAAA;AAEjC,gDAA2D;AAAlD,yHAAA,yBAAyB,OAAA","sourcesContent":["export {\n  ClientController,\n  getDefaultClientControllerState,\n} from './ClientController.js';\nexport { clientControllerSelectors } from './selectors.js';\n\nexport type {\n  ClientControllerState,\n  ClientControllerOptions,\n  ClientControllerGetStateAction,\n  ClientControllerActions,\n  ClientControllerStateChangeEvent,\n  ClientControllerEvents,\n  ClientControllerMessenger,\n} from './ClientController.js';\nexport type { ClientControllerSetUiOpenAction } from './ClientController-method-action-types.js';\n"]}

package/dist/index.d.cts

@@ -0,0 +1,5 @@
+export { ClientController, getDefaultClientControllerState, } from "./ClientController.cjs";
+export { clientControllerSelectors } from "./selectors.cjs";
+export type { ClientControllerState, ClientControllerOptions, ClientControllerGetStateAction, ClientControllerActions, ClientControllerStateChangeEvent, ClientControllerEvents, ClientControllerMessenger, } from "./ClientController.cjs";
+export type { ClientControllerSetUiOpenAction } from "./ClientController-method-action-types.cjs";
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,+BAA+B,GAChC,+BAA8B;AAC/B,OAAO,EAAE,yBAAyB,EAAE,wBAAuB;AAE3D,YAAY,EACV,qBAAqB,EACrB,uBAAuB,EACvB,8BAA8B,EAC9B,uBAAuB,EACvB,gCAAgC,EAChC,sBAAsB,EACtB,yBAAyB,GAC1B,+BAA8B;AAC/B,YAAY,EAAE,+BAA+B,EAAE,mDAAkD"}

package/dist/index.d.mts

@@ -0,0 +1,5 @@
+export { ClientController, getDefaultClientControllerState, } from "./ClientController.mjs";
+export { clientControllerSelectors } from "./selectors.mjs";
+export type { ClientControllerState, ClientControllerOptions, ClientControllerGetStateAction, ClientControllerActions, ClientControllerStateChangeEvent, ClientControllerEvents, ClientControllerMessenger, } from "./ClientController.mjs";
+export type { ClientControllerSetUiOpenAction } from "./ClientController-method-action-types.mjs";
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,+BAA+B,GAChC,+BAA8B;AAC/B,OAAO,EAAE,yBAAyB,EAAE,wBAAuB;AAE3D,YAAY,EACV,qBAAqB,EACrB,uBAAuB,EACvB,8BAA8B,EAC9B,uBAAuB,EACvB,gCAAgC,EAChC,sBAAsB,EACtB,yBAAyB,GAC1B,+BAA8B;AAC/B,YAAY,EAAE,+BAA+B,EAAE,mDAAkD"}

package/dist/index.mjs

@@ -0,0 +1,3 @@
+export { ClientController, getDefaultClientControllerState } from "./ClientController.mjs";
+export { clientControllerSelectors } from "./selectors.mjs";
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,+BAA+B,EAChC,+BAA8B;AAC/B,OAAO,EAAE,yBAAyB,EAAE,wBAAuB","sourcesContent":["export {\n  ClientController,\n  getDefaultClientControllerState,\n} from './ClientController.js';\nexport { clientControllerSelectors } from './selectors.js';\n\nexport type {\n  ClientControllerState,\n  ClientControllerOptions,\n  ClientControllerGetStateAction,\n  ClientControllerActions,\n  ClientControllerStateChangeEvent,\n  ClientControllerEvents,\n  ClientControllerMessenger,\n} from './ClientController.js';\nexport type { ClientControllerSetUiOpenAction } from './ClientController-method-action-types.js';\n"]}

package/dist/selectors.cjs

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clientControllerSelectors = void 0;
+/**
+ * Selects whether the UI is currently open.
+ *
+ * @param state - The ClientController state.
+ * @returns True if the UI is open.
+ */
+const selectIsUiOpen = (state) => state.isUiOpen;
+/**
+ * Selectors for the ClientController state.
+ * These can be used with Redux or directly with controller state.
+ */
+exports.clientControllerSelectors = {
+    selectIsUiOpen,
+};
+//# sourceMappingURL=selectors.cjs.map

package/dist/selectors.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectors.cjs","sourceRoot":"","sources":["../src/selectors.ts"],"names":[],"mappings":";;;AAEA;;;;;GAKG;AACH,MAAM,cAAc,GAAG,CAAC,KAA4B,EAAW,EAAE,CAC/D,KAAK,CAAC,QAAQ,CAAC;AAEjB;;;GAGG;AACU,QAAA,yBAAyB,GAAG;IACvC,cAAc;CACf,CAAC","sourcesContent":["import type { ClientControllerState } from './ClientController.js';\n\n/**\n * Selects whether the UI is currently open.\n *\n * @param state - The ClientController state.\n * @returns True if the UI is open.\n */\nconst selectIsUiOpen = (state: ClientControllerState): boolean =>\n  state.isUiOpen;\n\n/**\n * Selectors for the ClientController state.\n * These can be used with Redux or directly with controller state.\n */\nexport const clientControllerSelectors = {\n  selectIsUiOpen,\n};\n"]}

package/dist/selectors.d.cts

@@ -0,0 +1,9 @@
+import type { ClientControllerState } from "./ClientController.cjs";
+/**
+ * Selectors for the ClientController state.
+ * These can be used with Redux or directly with controller state.
+ */
+export declare const clientControllerSelectors: {
+    selectIsUiOpen: (state: ClientControllerState) => boolean;
+};
+//# sourceMappingURL=selectors.d.cts.map

package/dist/selectors.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectors.d.cts","sourceRoot":"","sources":["../src/selectors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,+BAA8B;AAWnE;;;GAGG;AACH,eAAO,MAAM,yBAAyB;4BAPP,qBAAqB,KAAG,OAAO;CAS7D,CAAC"}

package/dist/selectors.d.mts

@@ -0,0 +1,9 @@
+import type { ClientControllerState } from "./ClientController.mjs";
+/**
+ * Selectors for the ClientController state.
+ * These can be used with Redux or directly with controller state.
+ */
+export declare const clientControllerSelectors: {
+    selectIsUiOpen: (state: ClientControllerState) => boolean;
+};
+//# sourceMappingURL=selectors.d.mts.map

package/dist/selectors.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectors.d.mts","sourceRoot":"","sources":["../src/selectors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,+BAA8B;AAWnE;;;GAGG;AACH,eAAO,MAAM,yBAAyB;4BAPP,qBAAqB,KAAG,OAAO;CAS7D,CAAC"}

package/dist/{selectors.js → selectors.mjs}

@@ -12,4 +12,4 @@ const selectIsUiOpen = (state) => state.isUiOpen;
 export const clientControllerSelectors = {
     selectIsUiOpen,
 };
-//# sourceMappingURL=selectors.js.map
+//# sourceMappingURL=selectors.mjs.map

package/dist/selectors.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectors.mjs","sourceRoot":"","sources":["../src/selectors.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,cAAc,GAAG,CAAC,KAA4B,EAAW,EAAE,CAC/D,KAAK,CAAC,QAAQ,CAAC;AAEjB;;;GAGG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,cAAc;CACf,CAAC","sourcesContent":["import type { ClientControllerState } from './ClientController.js';\n\n/**\n * Selects whether the UI is currently open.\n *\n * @param state - The ClientController state.\n * @returns True if the UI is open.\n */\nconst selectIsUiOpen = (state: ClientControllerState): boolean =>\n  state.isUiOpen;\n\n/**\n * Selectors for the ClientController state.\n * These can be used with Redux or directly with controller state.\n */\nexport const clientControllerSelectors = {\n  selectIsUiOpen,\n};\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metamask-previews/client-controller",
-  "version": "1.0.1-preview-3866c0ff1",
+  "version": "1.0.1-preview-e3275932a",
   "description": "Client-level state for MetaMask (e.g. whether a UI window is open)",
   "keywords": [
     "Ethereum",
@@ -18,12 +18,19 @@
   "files": [
     "dist/"
   ],
-  "type": "module",
   "sideEffects": false,
+  "main": "./dist/index.cjs",
+  "types": "./dist/index.d.cts",
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "default": "./dist/index.js"
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
     },
     "./package.json": "./package.json"
   },
@@ -32,11 +39,9 @@
     "registry": "https://registry.npmjs.org/"
   },
   "scripts": {
-    "build": "tsc --project tsconfig.build.json",
-    "build:all": "tsc --build tsconfig.build.json --verbose",
-    "build:clean": "yarn build:only-clean && yarn build",
+    "build": "ts-bridge --project tsconfig.build.json --verbose --clean --no-references",
+    "build:all": "ts-bridge --project tsconfig.build.json --verbose --clean",
     "build:docs": "typedoc",
-    "build:only-clean": "rimraf './dist' './tsconfig.build.tsbuildinfo'",
     "changelog:update": "../../scripts/update-changelog.sh @metamask/client-controller",
     "changelog:validate": "../../scripts/validate-changelog.sh @metamask/client-controller",
     "lint:tsconfigs": "tsx ../../scripts/lint-tsconfigs/lint-tsconfigs.mts",
@@ -55,19 +60,18 @@
   },
   "devDependencies": {
     "@metamask/auto-changelog": "^6.1.0",
+    "@ts-bridge/cli": "^0.6.4",
     "@types/jest": "^30.0.0",
-    "@typescript/native": "npm:typescript@^7.0.2",
     "deepmerge": "^4.2.2",
     "jest": "^30.4.2",
     "jest-environment-jsdom": "^30.4.1",
-    "rimraf": "^5.0.5",
     "ts-jest": "^29.4.11",
     "tsx": "^4.20.5",
     "typedoc": "^0.25.13",
     "typedoc-plugin-missing-exports": "^2.0.0",
-    "typescript": "npm:@typescript/typescript6@^6.0.2"
+    "typescript": "~5.3.3"
   },
   "engines": {
-    "node": "^22.14.0 || ^24"
+    "node": "^18.18 || >=20"
   }
 }

package/dist/ClientController-method-action-types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ClientController-method-action-types.d.ts","sourceRoot":"","sources":["../src/ClientController-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D;;;;;;;;GAQG;AACH,MAAM,MAAM,+BAA+B,GAAG;IAC5C,IAAI,EAAE,4BAA4B,CAAC;IACnC,OAAO,EAAE,gBAAgB,CAAC,WAAW,CAAC,CAAC;CACxC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,6BAA6B,GAAG,+BAA+B,CAAC"}

package/dist/ClientController-method-action-types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ClientController-method-action-types.js","sourceRoot":"","sources":["../src/ClientController-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG","sourcesContent":["/**\n * This file is auto generated.\n * Do not edit manually.\n */\n\nimport type { ClientController } from './ClientController.js';\n\n/**\n * Updates state with whether the MetaMask UI is open.\n *\n * This method should be called when the user has opened the first window or\n * screen containing the MetaMask UI, or closed the last window or screen\n * containing the MetaMask UI.\n *\n * @param open - Whether the MetaMask UI is open.\n */\nexport type ClientControllerSetUiOpenAction = {\n  type: `ClientController:setUiOpen`;\n  handler: ClientController['setUiOpen'];\n};\n\n/**\n * Union of all ClientController action types.\n */\nexport type ClientControllerMethodActions = ClientControllerSetUiOpenAction;\n"]}

package/dist/ClientController.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ClientController.d.ts","sourceRoot":"","sources":["../src/ClientController.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,wBAAwB,EACxB,0BAA0B,EAC3B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,2CAA2C,CAAC;AAI/F;;GAEG;AACH,eAAO,MAAM,cAAc,qBAAqB,CAAC;AAIjD;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC;;;;OAIG;IACH,QAAQ,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,+BAA+B,IAAI,qBAAqB,CAIvE;AAkBD;;GAEG;AACH,MAAM,MAAM,8BAA8B,GAAG,wBAAwB,CACnE,OAAO,cAAc,EACrB,qBAAqB,CACtB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAC/B,8BAA8B,GAC9B,6BAA6B,CAAC;AAElC;;GAEG;AACH,KAAK,cAAc,GAAG,KAAK,CAAC;AAE5B;;GAEG;AACH,MAAM,MAAM,gCAAgC,GAAG,0BAA0B,CACvE,OAAO,cAAc,EACrB,qBAAqB,CACtB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,gCAAgC,CAAC;AAEtE;;GAEG;AACH,KAAK,aAAa,GAAG,KAAK,CAAC;AAE3B;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG,SAAS,CAC/C,OAAO,cAAc,EACrB,uBAAuB,GAAG,cAAc,EACxC,sBAAsB,GAAG,aAAa,CACvC,CAAC;AAIF;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACpC;;OAEG;IACH,SAAS,EAAE,yBAAyB,CAAC;IACrC;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,CAAC;CACxC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,qBAAa,gBAAiB,SAAQ,cAAc,CAClD,OAAO,cAAc,EACrB,qBAAqB,EACrB,yBAAyB,CAC1B;IACC;;;;;;OAMG;IACH,YAAY,EAAE,SAAS,EAAE,KAAU,EAAE,EAAE,uBAAuB,EAe7D;IAED;;;;;;;;OAQG;IACH,SAAS,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAI7B;CACF"}

package/dist/ClientController.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ClientController.js","sourceRoot":"","sources":["../src/ClientController.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAK3D,kBAAkB;AAElB;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,kBAAkB,CAAC;AAgBjD;;;;GAIG;AACH,MAAM,UAAU,+BAA+B;IAC7C,OAAO;QACL,QAAQ,EAAE,KAAK;KAChB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,kBAAkB,GAAG;IACzB,QAAQ,EAAE;QACR,sBAAsB,EAAE,IAAI;QAC5B,kBAAkB,EAAE,IAAI;QACxB,OAAO,EAAE,KAAK;QACd,QAAQ,EAAE,KAAK;KAChB;CAC6C,CAAC;AAEjD,oBAAoB;AAEpB,MAAM,yBAAyB,GAAG,CAAC,WAAW,CAAU,CAAC;AAiEzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,MAAM,OAAO,gBAAiB,SAAQ,cAIrC;IACC;;;;;;OAMG;IACH,YAAY,EAAE,SAAS,EAAE,KAAK,GAAG,EAAE,EAA2B;QAC5D,KAAK,CAAC;YACJ,SAAS;YACT,QAAQ,EAAE,kBAAkB;YAC5B,IAAI,EAAE,cAAc;YACpB,KAAK,EAAE;gBACL,GAAG,+BAA+B,EAAE;gBACpC,GAAG,KAAK;aACT;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,SAAS,CAAC,4BAA4B,CACzC,IAAI,EACJ,yBAAyB,CAC1B,CAAC;IACJ,CAAC;IAED;;;;;;;;OAQG;IACH,SAAS,CAAC,IAAa;QACrB,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;YACpB,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC;QACxB,CAAC,CAAC,CAAC;IACL,CAAC;CACF","sourcesContent":["import type {\n  StateMetadata,\n  ControllerGetStateAction,\n  ControllerStateChangeEvent,\n} from '@metamask/base-controller';\nimport { BaseController } from '@metamask/base-controller';\nimport type { Messenger } from '@metamask/messenger';\n\nimport type { ClientControllerMethodActions } from './ClientController-method-action-types.js';\n\n// === GENERAL ===\n\n/**\n * The name of the {@link ClientController}.\n */\nexport const controllerName = 'ClientController';\n\n// === STATE ===\n\n/**\n * Describes the shape of the state object for {@link ClientController}.\n */\nexport type ClientControllerState = {\n  /**\n   * Whether the user has opened at least one window or screen\n   * containing the MetaMask UI. These windows or screens may or\n   * may not be in an inactive state.\n   */\n  isUiOpen: boolean;\n};\n\n/**\n * Constructs the default {@link ClientController} state.\n *\n * @returns The default {@link ClientController} state.\n */\nexport function getDefaultClientControllerState(): ClientControllerState {\n  return {\n    isUiOpen: false,\n  };\n}\n\n/**\n * The metadata for each property in {@link ClientControllerState}.\n */\nconst controllerMetadata = {\n  isUiOpen: {\n    includeInDebugSnapshot: true,\n    includeInStateLogs: true,\n    persist: false,\n    usedInUi: false,\n  },\n} satisfies StateMetadata<ClientControllerState>;\n\n// === MESSENGER ===\n\nconst MESSENGER_EXPOSED_METHODS = ['setUiOpen'] as const;\n\n/**\n * Retrieves the state of the {@link ClientController}.\n */\nexport type ClientControllerGetStateAction = ControllerGetStateAction<\n  typeof controllerName,\n  ClientControllerState\n>;\n\n/**\n * Actions that {@link ClientController} exposes.\n */\nexport type ClientControllerActions =\n  | ClientControllerGetStateAction\n  | ClientControllerMethodActions;\n\n/**\n * Actions from other messengers that {@link ClientController} calls.\n */\ntype AllowedActions = never;\n\n/**\n * Published when the state of {@link ClientController} changes.\n */\nexport type ClientControllerStateChangeEvent = ControllerStateChangeEvent<\n  typeof controllerName,\n  ClientControllerState\n>;\n\n/**\n * Events that {@link ClientController} exposes.\n */\nexport type ClientControllerEvents = ClientControllerStateChangeEvent;\n\n/**\n * Events from other messengers that {@link ClientController} subscribes to.\n */\ntype AllowedEvents = never;\n\n/**\n * The messenger for {@link ClientController}.\n */\nexport type ClientControllerMessenger = Messenger<\n  typeof controllerName,\n  ClientControllerActions | AllowedActions,\n  ClientControllerEvents | AllowedEvents\n>;\n\n// === CONTROLLER DEFINITION ===\n\n/**\n * The options for constructing a {@link ClientController}.\n */\nexport type ClientControllerOptions = {\n  /**\n   * The messenger suited for this controller.\n   */\n  messenger: ClientControllerMessenger;\n  /**\n   * The initial state to set on this controller.\n   */\n  state?: Partial<ClientControllerState>;\n};\n\n/**\n * `ClientController` manages the application lifecycle state.\n *\n * This controller tracks whether the MetaMask UI is open and publishes state\n * change events that other controllers can subscribe to for adjusting their behavior.\n *\n * **Use cases:**\n * - Polling controllers can pause when the UI closes, resume when it opens\n * - WebSocket connections can disconnect when closed, reconnect when opened\n * - Real-time subscriptions can pause when not visible\n *\n * **Platform Integration:**\n * Platform code should call `ClientController:setUiOpen` via messenger.\n *\n * @example\n * ```typescript\n * // In MetamaskController or platform code\n * onUiOpened() {\n *   // ...\n *   this.controllerMessenger.call('ClientController:setUiOpen', true);\n * }\n *\n * onUiClosed() {\n *   // ...\n *   this.controllerMessenger.call('ClientController:setUiOpen', false);\n * }\n *\n * // Consumer controller subscribing to state changes\n * class MyController extends BaseController {\n *   constructor({ messenger }) {\n *     super({ messenger, ... });\n *\n *     messenger.subscribe(\n *       'ClientController:stateChange',\n *       (isClientOpen) => {\n *         if (isClientOpen) {\n *           this.resumePolling();\n *         } else {\n *           this.pausePolling();\n *         }\n *       },\n *       clientControllerSelectors.selectIsUiOpen,\n *     );\n *   }\n * }\n * ```\n */\nexport class ClientController extends BaseController<\n  typeof controllerName,\n  ClientControllerState,\n  ClientControllerMessenger\n> {\n  /**\n   * Constructs a new {@link ClientController}.\n   *\n   * @param options - The constructor options.\n   * @param options.messenger - The messenger suited for this controller.\n   * @param options.state - The initial state to set on this controller.\n   */\n  constructor({ messenger, state = {} }: ClientControllerOptions) {\n    super({\n      messenger,\n      metadata: controllerMetadata,\n      name: controllerName,\n      state: {\n        ...getDefaultClientControllerState(),\n        ...state,\n      },\n    });\n\n    this.messenger.registerMethodActionHandlers(\n      this,\n      MESSENGER_EXPOSED_METHODS,\n    );\n  }\n\n  /**\n   * Updates state with whether the MetaMask UI is open.\n   *\n   * This method should be called when the user has opened the first window or\n   * screen containing the MetaMask UI, or closed the last window or screen\n   * containing the MetaMask UI.\n   *\n   * @param open - Whether the MetaMask UI is open.\n   */\n  setUiOpen(open: boolean): void {\n    this.update((state) => {\n      state.isUiOpen = open;\n    });\n  }\n}\n"]}

package/dist/index.d.ts

@@ -1,5 +0,0 @@
-export { ClientController, getDefaultClientControllerState, } from './ClientController.js';
-export { clientControllerSelectors } from './selectors.js';
-export type { ClientControllerState, ClientControllerOptions, ClientControllerGetStateAction, ClientControllerActions, ClientControllerStateChangeEvent, ClientControllerEvents, ClientControllerMessenger, } from './ClientController.js';
-export type { ClientControllerSetUiOpenAction } from './ClientController-method-action-types.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,+BAA+B,GAChC,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAE3D,YAAY,EACV,qBAAqB,EACrB,uBAAuB,EACvB,8BAA8B,EAC9B,uBAAuB,EACvB,gCAAgC,EAChC,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,+BAA+B,EAAE,MAAM,2CAA2C,CAAC"}

package/dist/index.js

@@ -1,3 +0,0 @@
-export { ClientController, getDefaultClientControllerState, } from './ClientController.js';
-export { clientControllerSelectors } from './selectors.js';
-//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,+BAA+B,GAChC,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC","sourcesContent":["export {\n  ClientController,\n  getDefaultClientControllerState,\n} from './ClientController.js';\nexport { clientControllerSelectors } from './selectors.js';\n\nexport type {\n  ClientControllerState,\n  ClientControllerOptions,\n  ClientControllerGetStateAction,\n  ClientControllerActions,\n  ClientControllerStateChangeEvent,\n  ClientControllerEvents,\n  ClientControllerMessenger,\n} from './ClientController.js';\nexport type { ClientControllerSetUiOpenAction } from './ClientController-method-action-types.js';\n"]}

package/dist/selectors.d.ts

@@ -1,17 +0,0 @@
-import type { ClientControllerState } from './ClientController.js';
-/**
- * Selects whether the UI is currently open.
- *
- * @param state - The ClientController state.
- * @returns True if the UI is open.
- */
-declare const selectIsUiOpen: (state: ClientControllerState) => boolean;
-/**
- * Selectors for the ClientController state.
- * These can be used with Redux or directly with controller state.
- */
-export declare const clientControllerSelectors: {
-    selectIsUiOpen: typeof selectIsUiOpen;
-};
-export {};
-//# sourceMappingURL=selectors.d.ts.map

package/dist/selectors.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"selectors.d.ts","sourceRoot":"","sources":["../src/selectors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAEnE;;;;;GAKG;AACH,QAAA,MAAM,cAAc,UAAW,qBAAqB,KAAG,OACvC,CAAC;AAEjB;;;GAGG;AACH,eAAO,MAAM,yBAAyB;;CAErC,CAAC"}

package/dist/selectors.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"selectors.js","sourceRoot":"","sources":["../src/selectors.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,cAAc,GAAG,CAAC,KAA4B,EAAW,EAAE,CAC/D,KAAK,CAAC,QAAQ,CAAC;AAEjB;;;GAGG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,cAAc;CACf,CAAC","sourcesContent":["import type { ClientControllerState } from './ClientController.js';\n\n/**\n * Selects whether the UI is currently open.\n *\n * @param state - The ClientController state.\n * @returns True if the UI is open.\n */\nconst selectIsUiOpen = (state: ClientControllerState): boolean =>\n  state.isUiOpen;\n\n/**\n * Selectors for the ClientController state.\n * These can be used with Redux or directly with controller state.\n */\nexport const clientControllerSelectors = {\n  selectIsUiOpen,\n};\n"]}