@metamask-previews/core-backend 9.0.0-preview-3866c0ff1 → 9.0.0-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/remote-feature-flag-controller` from `^6.0.0` to `^6.1.0` ([#9980](https://github.com/MetaMask/core/pull/9980))
 
 ## [9.0.0]

package/dist/ApiPlatformClientService-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=ApiPlatformClientService-method-action-types.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ApiPlatformClientService-method-action-types.cjs","sourceRoot":"","sources":["../src/ApiPlatformClientService-method-action-types.ts"],"names":[],"mappings":";AAAA;;;GAGG","sourcesContent":["/**\n * This file is auto generated.\n * Do not edit manually.\n */\n\nimport type { ApiPlatformClientService } from './ApiPlatformClientService.js';\n\n/**\n * Returns the shared ApiPlatformClient instance.\n *\n * Use this via the messenger: `messenger.call('ApiPlatformClientService:getApiPlatformClient')`.\n *\n * @returns The ApiPlatformClient instance (accounts, prices, token, tokens).\n */\nexport type ApiPlatformClientServiceGetApiPlatformClientAction = {\n  type: `ApiPlatformClientService:getApiPlatformClient`;\n  handler: ApiPlatformClientService['getApiPlatformClient'];\n};\n\n/**\n * Union of all ApiPlatformClientService action types.\n */\nexport type ApiPlatformClientServiceMethodActions =\n  ApiPlatformClientServiceGetApiPlatformClientAction;\n"]}

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

@@ -2,7 +2,7 @@
  * This file is auto generated.
  * Do not edit manually.
  */
-import type { ApiPlatformClientService } from './ApiPlatformClientService.js';
+import type { ApiPlatformClientService } from "./ApiPlatformClientService.cjs";
 /**
  * Returns the shared ApiPlatformClient instance.
  *
@@ -18,4 +18,4 @@ export type ApiPlatformClientServiceGetApiPlatformClientAction = {
  * Union of all ApiPlatformClientService action types.
  */
 export type ApiPlatformClientServiceMethodActions = ApiPlatformClientServiceGetApiPlatformClientAction;
-//# sourceMappingURL=ApiPlatformClientService-method-action-types.d.ts.map
+//# sourceMappingURL=ApiPlatformClientService-method-action-types.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ApiPlatformClientService-method-action-types.d.cts","sourceRoot":"","sources":["../src/ApiPlatformClientService-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,wBAAwB,EAAE,uCAAsC;AAE9E;;;;;;GAMG;AACH,MAAM,MAAM,kDAAkD,GAAG;IAC/D,IAAI,EAAE,+CAA+C,CAAC;IACtD,OAAO,EAAE,wBAAwB,CAAC,sBAAsB,CAAC,CAAC;CAC3D,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,qCAAqC,GAC/C,kDAAkD,CAAC"}

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

@@ -0,0 +1,21 @@
+/**
+ * This file is auto generated.
+ * Do not edit manually.
+ */
+import type { ApiPlatformClientService } from "./ApiPlatformClientService.mjs";
+/**
+ * Returns the shared ApiPlatformClient instance.
+ *
+ * Use this via the messenger: `messenger.call('ApiPlatformClientService:getApiPlatformClient')`.
+ *
+ * @returns The ApiPlatformClient instance (accounts, prices, token, tokens).
+ */
+export type ApiPlatformClientServiceGetApiPlatformClientAction = {
+    type: `ApiPlatformClientService:getApiPlatformClient`;
+    handler: ApiPlatformClientService['getApiPlatformClient'];
+};
+/**
+ * Union of all ApiPlatformClientService action types.
+ */
+export type ApiPlatformClientServiceMethodActions = ApiPlatformClientServiceGetApiPlatformClientAction;
+//# sourceMappingURL=ApiPlatformClientService-method-action-types.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ApiPlatformClientService-method-action-types.d.mts","sourceRoot":"","sources":["../src/ApiPlatformClientService-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,wBAAwB,EAAE,uCAAsC;AAE9E;;;;;;GAMG;AACH,MAAM,MAAM,kDAAkD,GAAG;IAC/D,IAAI,EAAE,+CAA+C,CAAC;IACtD,OAAO,EAAE,wBAAwB,CAAC,sBAAsB,CAAC,CAAC;CAC3D,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,qCAAqC,GAC/C,kDAAkD,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"ApiPlatformClientService-method-action-types.mjs","sourceRoot":"","sources":["../src/ApiPlatformClientService-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG","sourcesContent":["/**\n * This file is auto generated.\n * Do not edit manually.\n */\n\nimport type { ApiPlatformClientService } from './ApiPlatformClientService.js';\n\n/**\n * Returns the shared ApiPlatformClient instance.\n *\n * Use this via the messenger: `messenger.call('ApiPlatformClientService:getApiPlatformClient')`.\n *\n * @returns The ApiPlatformClient instance (accounts, prices, token, tokens).\n */\nexport type ApiPlatformClientServiceGetApiPlatformClientAction = {\n  type: `ApiPlatformClientService:getApiPlatformClient`;\n  handler: ApiPlatformClientService['getApiPlatformClient'];\n};\n\n/**\n * Union of all ApiPlatformClientService action types.\n */\nexport type ApiPlatformClientServiceMethodActions =\n  ApiPlatformClientServiceGetApiPlatformClientAction;\n"]}

package/dist/ApiPlatformClientService.cjs

@@ -0,0 +1,82 @@
+"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 _ApiPlatformClientService_messenger, _ApiPlatformClientService_client;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ApiPlatformClientService = exports.apiPlatformClientServiceName = void 0;
+const index_js_1 = require("./api/index.cjs");
+// === GENERAL ===
+/**
+ * The name of the {@link ApiPlatformClientService}, used to namespace the
+ * service's actions and events.
+ */
+exports.apiPlatformClientServiceName = 'ApiPlatformClientService';
+// === MESSENGER ===
+const MESSENGER_EXPOSED_METHODS = ['getApiPlatformClient'];
+// === SERVICE DEFINITION ===
+/**
+ * Service that provides access to {@link ApiPlatformClient} via the messenger.
+ *
+ * Consumers obtain the client by calling the `ApiPlatformClientService:getApiPlatformClient`
+ * action, then use it for accounts, prices, token, and tokens API calls.
+ *
+ * @example
+ *
+ * ```ts
+ * import { Messenger } from '@metamask/messenger';
+ * import {
+ *   ApiPlatformClientService,
+ *   type ApiPlatformClientServiceActions,
+ *   type ApiPlatformClientServiceEvents,
+ * } from '@metamask/core-backend';
+ *
+ * const rootMessenger = new Messenger<'Root', ApiPlatformClientServiceActions, ApiPlatformClientServiceEvents>({ namespace: 'Root' });
+ * const serviceMessenger = new Messenger<
+ *   'ApiPlatformClientService',
+ *   ApiPlatformClientServiceActions,
+ *   ApiPlatformClientServiceEvents,
+ *   typeof rootMessenger
+ * >({ namespace: 'ApiPlatformClientService', parent: rootMessenger });
+ *
+ * new ApiPlatformClientService({
+ *   messenger: serviceMessenger,
+ *   clientProduct: 'metamask-extension',
+ *   getBearerToken: async () => token,
+ * });
+ *
+ * const client = rootMessenger.call('ApiPlatformClientService:getApiPlatformClient');
+ * const balances = await client.accounts.fetchV5MultiAccountBalances(accountIds);
+ * ```
+ */
+class ApiPlatformClientService {
+    constructor({ messenger, ...clientOptions }) {
+        _ApiPlatformClientService_messenger.set(this, void 0);
+        _ApiPlatformClientService_client.set(this, void 0);
+        this.name = exports.apiPlatformClientServiceName;
+        __classPrivateFieldSet(this, _ApiPlatformClientService_messenger, messenger, "f");
+        __classPrivateFieldSet(this, _ApiPlatformClientService_client, new index_js_1.ApiPlatformClient(clientOptions), "f");
+        __classPrivateFieldGet(this, _ApiPlatformClientService_messenger, "f").registerMethodActionHandlers(this, MESSENGER_EXPOSED_METHODS);
+    }
+    /**
+     * Returns the shared ApiPlatformClient instance.
+     *
+     * Use this via the messenger: `messenger.call('ApiPlatformClientService:getApiPlatformClient')`.
+     *
+     * @returns The ApiPlatformClient instance (accounts, prices, token, tokens).
+     */
+    getApiPlatformClient() {
+        return __classPrivateFieldGet(this, _ApiPlatformClientService_client, "f");
+    }
+}
+exports.ApiPlatformClientService = ApiPlatformClientService;
+_ApiPlatformClientService_messenger = new WeakMap(), _ApiPlatformClientService_client = new WeakMap();
+//# sourceMappingURL=ApiPlatformClientService.cjs.map

package/dist/ApiPlatformClientService.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ApiPlatformClientService.cjs","sourceRoot":"","sources":["../src/ApiPlatformClientService.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAEA,8CAAmD;AAInD,kBAAkB;AAElB;;;GAGG;AACU,QAAA,4BAA4B,GAAG,0BAA0B,CAAC;AAEvE,oBAAoB;AAEpB,MAAM,yBAAyB,GAAG,CAAC,sBAAsB,CAAU,CAAC;AA2CpE,6BAA6B;AAE7B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAa,wBAAwB;IAOnC,YAAY,EACV,SAAS,EACT,GAAG,aAAa,EACgB;QAPzB,sDAA8C;QAE9C,mDAA2B;QAMlC,IAAI,CAAC,IAAI,GAAG,oCAA4B,CAAC;QACzC,uBAAA,IAAI,uCAAc,SAAS,MAAA,CAAC;QAC5B,uBAAA,IAAI,oCAAW,IAAI,4BAAiB,CAAC,aAAa,CAAC,MAAA,CAAC;QAEpD,uBAAA,IAAI,2CAAW,CAAC,4BAA4B,CAC1C,IAAI,EACJ,yBAAyB,CAC1B,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACH,oBAAoB;QAClB,OAAO,uBAAA,IAAI,wCAAQ,CAAC;IACtB,CAAC;CACF;AA/BD,4DA+BC","sourcesContent":["import type { Messenger } from '@metamask/messenger';\n\nimport { ApiPlatformClient } from './api/index.js';\nimport type { ApiPlatformClientOptions } from './api/index.js';\nimport type { ApiPlatformClientServiceMethodActions } from './ApiPlatformClientService-method-action-types.js';\n\n// === GENERAL ===\n\n/**\n * The name of the {@link ApiPlatformClientService}, used to namespace the\n * service's actions and events.\n */\nexport const apiPlatformClientServiceName = 'ApiPlatformClientService';\n\n// === MESSENGER ===\n\nconst MESSENGER_EXPOSED_METHODS = ['getApiPlatformClient'] as const;\n\n/**\n * Actions that {@link ApiPlatformClientService} exposes to other consumers.\n */\nexport type ApiPlatformClientServiceActions =\n  ApiPlatformClientServiceMethodActions;\n\n/**\n * Actions from other messengers that {@link ApiPlatformClientServiceMessenger} calls.\n */\ntype AllowedActions = never;\n\n/**\n * Events that {@link ApiPlatformClientService} exposes to other consumers.\n */\nexport type ApiPlatformClientServiceEvents = never;\n\n/**\n * Events from other messengers that {@link ApiPlatformClientService} subscribes to.\n */\ntype AllowedEvents = never;\n\n/**\n * The messenger which is restricted to actions and events accessed by\n * {@link ApiPlatformClientService}.\n */\nexport type ApiPlatformClientServiceMessenger = Messenger<\n  typeof apiPlatformClientServiceName,\n  ApiPlatformClientServiceActions | AllowedActions,\n  ApiPlatformClientServiceEvents | AllowedEvents\n>;\n\n// === SERVICE OPTIONS ===\n\n/**\n * Options for constructing {@link ApiPlatformClientService}.\n */\nexport type ApiPlatformClientServiceOptions = {\n  /** The messenger suited for this service. */\n  messenger: ApiPlatformClientServiceMessenger;\n} & ApiPlatformClientOptions;\n\n// === SERVICE DEFINITION ===\n\n/**\n * Service that provides access to {@link ApiPlatformClient} via the messenger.\n *\n * Consumers obtain the client by calling the `ApiPlatformClientService:getApiPlatformClient`\n * action, then use it for accounts, prices, token, and tokens API calls.\n *\n * @example\n *\n * ```ts\n * import { Messenger } from '@metamask/messenger';\n * import {\n *   ApiPlatformClientService,\n *   type ApiPlatformClientServiceActions,\n *   type ApiPlatformClientServiceEvents,\n * } from '@metamask/core-backend';\n *\n * const rootMessenger = new Messenger<'Root', ApiPlatformClientServiceActions, ApiPlatformClientServiceEvents>({ namespace: 'Root' });\n * const serviceMessenger = new Messenger<\n *   'ApiPlatformClientService',\n *   ApiPlatformClientServiceActions,\n *   ApiPlatformClientServiceEvents,\n *   typeof rootMessenger\n * >({ namespace: 'ApiPlatformClientService', parent: rootMessenger });\n *\n * new ApiPlatformClientService({\n *   messenger: serviceMessenger,\n *   clientProduct: 'metamask-extension',\n *   getBearerToken: async () => token,\n * });\n *\n * const client = rootMessenger.call('ApiPlatformClientService:getApiPlatformClient');\n * const balances = await client.accounts.fetchV5MultiAccountBalances(accountIds);\n * ```\n */\nexport class ApiPlatformClientService {\n  readonly name: typeof apiPlatformClientServiceName;\n\n  readonly #messenger: ApiPlatformClientServiceMessenger;\n\n  readonly #client: ApiPlatformClient;\n\n  constructor({\n    messenger,\n    ...clientOptions\n  }: ApiPlatformClientServiceOptions) {\n    this.name = apiPlatformClientServiceName;\n    this.#messenger = messenger;\n    this.#client = new ApiPlatformClient(clientOptions);\n\n    this.#messenger.registerMethodActionHandlers(\n      this,\n      MESSENGER_EXPOSED_METHODS,\n    );\n  }\n\n  /**\n   * Returns the shared ApiPlatformClient instance.\n   *\n   * Use this via the messenger: `messenger.call('ApiPlatformClientService:getApiPlatformClient')`.\n   *\n   * @returns The ApiPlatformClient instance (accounts, prices, token, tokens).\n   */\n  getApiPlatformClient(): ApiPlatformClient {\n    return this.#client;\n  }\n}\n"]}

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

@@ -1,7 +1,7 @@
-import type { Messenger } from '@metamask/messenger';
-import { ApiPlatformClient } from './api/index.js';
-import type { ApiPlatformClientOptions } from './api/index.js';
-import type { ApiPlatformClientServiceMethodActions } from './ApiPlatformClientService-method-action-types.js';
+import type { Messenger } from "@metamask/messenger";
+import { ApiPlatformClient } from "./api/index.cjs";
+import type { ApiPlatformClientOptions } from "./api/index.cjs";
+import type { ApiPlatformClientServiceMethodActions } from "./ApiPlatformClientService-method-action-types.cjs";
 /**
  * The name of the {@link ApiPlatformClientService}, used to namespace the
  * service's actions and events.
@@ -83,4 +83,4 @@ export declare class ApiPlatformClientService {
     getApiPlatformClient(): ApiPlatformClient;
 }
 export {};
-//# sourceMappingURL=ApiPlatformClientService.d.ts.map
+//# sourceMappingURL=ApiPlatformClientService.d.cts.map

package/dist/ApiPlatformClientService.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ApiPlatformClientService.d.cts","sourceRoot":"","sources":["../src/ApiPlatformClientService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,4BAA4B;AAErD,OAAO,EAAE,iBAAiB,EAAE,wBAAuB;AACnD,OAAO,KAAK,EAAE,wBAAwB,EAAE,wBAAuB;AAC/D,OAAO,KAAK,EAAE,qCAAqC,EAAE,2DAA0D;AAI/G;;;GAGG;AACH,eAAO,MAAM,4BAA4B,6BAA6B,CAAC;AAMvE;;GAEG;AACH,MAAM,MAAM,+BAA+B,GACzC,qCAAqC,CAAC;AAExC;;GAEG;AACH,KAAK,cAAc,GAAG,KAAK,CAAC;AAE5B;;GAEG;AACH,MAAM,MAAM,8BAA8B,GAAG,KAAK,CAAC;AAEnD;;GAEG;AACH,KAAK,aAAa,GAAG,KAAK,CAAC;AAE3B;;;GAGG;AACH,MAAM,MAAM,iCAAiC,GAAG,SAAS,CACvD,OAAO,4BAA4B,EACnC,+BAA+B,GAAG,cAAc,EAChD,8BAA8B,GAAG,aAAa,CAC/C,CAAC;AAIF;;GAEG;AACH,MAAM,MAAM,+BAA+B,GAAG;IAC5C,6CAA6C;IAC7C,SAAS,EAAE,iCAAiC,CAAC;CAC9C,GAAG,wBAAwB,CAAC;AAI7B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,qBAAa,wBAAwB;;IACnC,QAAQ,CAAC,IAAI,EAAE,OAAO,4BAA4B,CAAC;gBAMvC,EACV,SAAS,EACT,GAAG,aAAa,EACjB,EAAE,+BAA+B;IAWlC;;;;;;OAMG;IACH,oBAAoB,IAAI,iBAAiB;CAG1C"}

package/dist/ApiPlatformClientService.d.mts

@@ -0,0 +1,86 @@
+import type { Messenger } from "@metamask/messenger";
+import { ApiPlatformClient } from "./api/index.mjs";
+import type { ApiPlatformClientOptions } from "./api/index.mjs";
+import type { ApiPlatformClientServiceMethodActions } from "./ApiPlatformClientService-method-action-types.mjs";
+/**
+ * The name of the {@link ApiPlatformClientService}, used to namespace the
+ * service's actions and events.
+ */
+export declare const apiPlatformClientServiceName = "ApiPlatformClientService";
+/**
+ * Actions that {@link ApiPlatformClientService} exposes to other consumers.
+ */
+export type ApiPlatformClientServiceActions = ApiPlatformClientServiceMethodActions;
+/**
+ * Actions from other messengers that {@link ApiPlatformClientServiceMessenger} calls.
+ */
+type AllowedActions = never;
+/**
+ * Events that {@link ApiPlatformClientService} exposes to other consumers.
+ */
+export type ApiPlatformClientServiceEvents = never;
+/**
+ * Events from other messengers that {@link ApiPlatformClientService} subscribes to.
+ */
+type AllowedEvents = never;
+/**
+ * The messenger which is restricted to actions and events accessed by
+ * {@link ApiPlatformClientService}.
+ */
+export type ApiPlatformClientServiceMessenger = Messenger<typeof apiPlatformClientServiceName, ApiPlatformClientServiceActions | AllowedActions, ApiPlatformClientServiceEvents | AllowedEvents>;
+/**
+ * Options for constructing {@link ApiPlatformClientService}.
+ */
+export type ApiPlatformClientServiceOptions = {
+    /** The messenger suited for this service. */
+    messenger: ApiPlatformClientServiceMessenger;
+} & ApiPlatformClientOptions;
+/**
+ * Service that provides access to {@link ApiPlatformClient} via the messenger.
+ *
+ * Consumers obtain the client by calling the `ApiPlatformClientService:getApiPlatformClient`
+ * action, then use it for accounts, prices, token, and tokens API calls.
+ *
+ * @example
+ *
+ * ```ts
+ * import { Messenger } from '@metamask/messenger';
+ * import {
+ *   ApiPlatformClientService,
+ *   type ApiPlatformClientServiceActions,
+ *   type ApiPlatformClientServiceEvents,
+ * } from '@metamask/core-backend';
+ *
+ * const rootMessenger = new Messenger<'Root', ApiPlatformClientServiceActions, ApiPlatformClientServiceEvents>({ namespace: 'Root' });
+ * const serviceMessenger = new Messenger<
+ *   'ApiPlatformClientService',
+ *   ApiPlatformClientServiceActions,
+ *   ApiPlatformClientServiceEvents,
+ *   typeof rootMessenger
+ * >({ namespace: 'ApiPlatformClientService', parent: rootMessenger });
+ *
+ * new ApiPlatformClientService({
+ *   messenger: serviceMessenger,
+ *   clientProduct: 'metamask-extension',
+ *   getBearerToken: async () => token,
+ * });
+ *
+ * const client = rootMessenger.call('ApiPlatformClientService:getApiPlatformClient');
+ * const balances = await client.accounts.fetchV5MultiAccountBalances(accountIds);
+ * ```
+ */
+export declare class ApiPlatformClientService {
+    #private;
+    readonly name: typeof apiPlatformClientServiceName;
+    constructor({ messenger, ...clientOptions }: ApiPlatformClientServiceOptions);
+    /**
+     * Returns the shared ApiPlatformClient instance.
+     *
+     * Use this via the messenger: `messenger.call('ApiPlatformClientService:getApiPlatformClient')`.
+     *
+     * @returns The ApiPlatformClient instance (accounts, prices, token, tokens).
+     */
+    getApiPlatformClient(): ApiPlatformClient;
+}
+export {};
+//# sourceMappingURL=ApiPlatformClientService.d.mts.map

package/dist/ApiPlatformClientService.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ApiPlatformClientService.d.mts","sourceRoot":"","sources":["../src/ApiPlatformClientService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,4BAA4B;AAErD,OAAO,EAAE,iBAAiB,EAAE,wBAAuB;AACnD,OAAO,KAAK,EAAE,wBAAwB,EAAE,wBAAuB;AAC/D,OAAO,KAAK,EAAE,qCAAqC,EAAE,2DAA0D;AAI/G;;;GAGG;AACH,eAAO,MAAM,4BAA4B,6BAA6B,CAAC;AAMvE;;GAEG;AACH,MAAM,MAAM,+BAA+B,GACzC,qCAAqC,CAAC;AAExC;;GAEG;AACH,KAAK,cAAc,GAAG,KAAK,CAAC;AAE5B;;GAEG;AACH,MAAM,MAAM,8BAA8B,GAAG,KAAK,CAAC;AAEnD;;GAEG;AACH,KAAK,aAAa,GAAG,KAAK,CAAC;AAE3B;;;GAGG;AACH,MAAM,MAAM,iCAAiC,GAAG,SAAS,CACvD,OAAO,4BAA4B,EACnC,+BAA+B,GAAG,cAAc,EAChD,8BAA8B,GAAG,aAAa,CAC/C,CAAC;AAIF;;GAEG;AACH,MAAM,MAAM,+BAA+B,GAAG;IAC5C,6CAA6C;IAC7C,SAAS,EAAE,iCAAiC,CAAC;CAC9C,GAAG,wBAAwB,CAAC;AAI7B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,qBAAa,wBAAwB;;IACnC,QAAQ,CAAC,IAAI,EAAE,OAAO,4BAA4B,CAAC;gBAMvC,EACV,SAAS,EACT,GAAG,aAAa,EACjB,EAAE,+BAA+B;IAWlC;;;;;;OAMG;IACH,oBAAoB,IAAI,iBAAiB;CAG1C"}

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

@@ -1,4 +1,16 @@
-import { ApiPlatformClient } from './api/index.js';
+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 _ApiPlatformClientService_messenger, _ApiPlatformClientService_client;
+import { ApiPlatformClient } from "./api/index.mjs";
 // === GENERAL ===
 /**
  * The name of the {@link ApiPlatformClientService}, used to namespace the
@@ -43,14 +55,13 @@ const MESSENGER_EXPOSED_METHODS = ['getApiPlatformClient'];
  * ```
  */
 export class ApiPlatformClientService {
-    name;
-    #messenger;
-    #client;
     constructor({ messenger, ...clientOptions }) {
+        _ApiPlatformClientService_messenger.set(this, void 0);
+        _ApiPlatformClientService_client.set(this, void 0);
         this.name = apiPlatformClientServiceName;
-        this.#messenger = messenger;
-        this.#client = new ApiPlatformClient(clientOptions);
-        this.#messenger.registerMethodActionHandlers(this, MESSENGER_EXPOSED_METHODS);
+        __classPrivateFieldSet(this, _ApiPlatformClientService_messenger, messenger, "f");
+        __classPrivateFieldSet(this, _ApiPlatformClientService_client, new ApiPlatformClient(clientOptions), "f");
+        __classPrivateFieldGet(this, _ApiPlatformClientService_messenger, "f").registerMethodActionHandlers(this, MESSENGER_EXPOSED_METHODS);
     }
     /**
      * Returns the shared ApiPlatformClient instance.
@@ -60,7 +71,8 @@ export class ApiPlatformClientService {
      * @returns The ApiPlatformClient instance (accounts, prices, token, tokens).
      */
     getApiPlatformClient() {
-        return this.#client;
+        return __classPrivateFieldGet(this, _ApiPlatformClientService_client, "f");
     }
 }
-//# sourceMappingURL=ApiPlatformClientService.js.map
+_ApiPlatformClientService_messenger = new WeakMap(), _ApiPlatformClientService_client = new WeakMap();
+//# sourceMappingURL=ApiPlatformClientService.mjs.map

package/dist/ApiPlatformClientService.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ApiPlatformClientService.mjs","sourceRoot":"","sources":["../src/ApiPlatformClientService.ts"],"names":[],"mappings":";;;;;;;;;;;;AAEA,OAAO,EAAE,iBAAiB,EAAE,wBAAuB;AAInD,kBAAkB;AAElB;;;GAGG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,0BAA0B,CAAC;AAEvE,oBAAoB;AAEpB,MAAM,yBAAyB,GAAG,CAAC,sBAAsB,CAAU,CAAC;AA2CpE,6BAA6B;AAE7B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,OAAO,wBAAwB;IAOnC,YAAY,EACV,SAAS,EACT,GAAG,aAAa,EACgB;QAPzB,sDAA8C;QAE9C,mDAA2B;QAMlC,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;QACzC,uBAAA,IAAI,uCAAc,SAAS,MAAA,CAAC;QAC5B,uBAAA,IAAI,oCAAW,IAAI,iBAAiB,CAAC,aAAa,CAAC,MAAA,CAAC;QAEpD,uBAAA,IAAI,2CAAW,CAAC,4BAA4B,CAC1C,IAAI,EACJ,yBAAyB,CAC1B,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACH,oBAAoB;QAClB,OAAO,uBAAA,IAAI,wCAAQ,CAAC;IACtB,CAAC;CACF","sourcesContent":["import type { Messenger } from '@metamask/messenger';\n\nimport { ApiPlatformClient } from './api/index.js';\nimport type { ApiPlatformClientOptions } from './api/index.js';\nimport type { ApiPlatformClientServiceMethodActions } from './ApiPlatformClientService-method-action-types.js';\n\n// === GENERAL ===\n\n/**\n * The name of the {@link ApiPlatformClientService}, used to namespace the\n * service's actions and events.\n */\nexport const apiPlatformClientServiceName = 'ApiPlatformClientService';\n\n// === MESSENGER ===\n\nconst MESSENGER_EXPOSED_METHODS = ['getApiPlatformClient'] as const;\n\n/**\n * Actions that {@link ApiPlatformClientService} exposes to other consumers.\n */\nexport type ApiPlatformClientServiceActions =\n  ApiPlatformClientServiceMethodActions;\n\n/**\n * Actions from other messengers that {@link ApiPlatformClientServiceMessenger} calls.\n */\ntype AllowedActions = never;\n\n/**\n * Events that {@link ApiPlatformClientService} exposes to other consumers.\n */\nexport type ApiPlatformClientServiceEvents = never;\n\n/**\n * Events from other messengers that {@link ApiPlatformClientService} subscribes to.\n */\ntype AllowedEvents = never;\n\n/**\n * The messenger which is restricted to actions and events accessed by\n * {@link ApiPlatformClientService}.\n */\nexport type ApiPlatformClientServiceMessenger = Messenger<\n  typeof apiPlatformClientServiceName,\n  ApiPlatformClientServiceActions | AllowedActions,\n  ApiPlatformClientServiceEvents | AllowedEvents\n>;\n\n// === SERVICE OPTIONS ===\n\n/**\n * Options for constructing {@link ApiPlatformClientService}.\n */\nexport type ApiPlatformClientServiceOptions = {\n  /** The messenger suited for this service. */\n  messenger: ApiPlatformClientServiceMessenger;\n} & ApiPlatformClientOptions;\n\n// === SERVICE DEFINITION ===\n\n/**\n * Service that provides access to {@link ApiPlatformClient} via the messenger.\n *\n * Consumers obtain the client by calling the `ApiPlatformClientService:getApiPlatformClient`\n * action, then use it for accounts, prices, token, and tokens API calls.\n *\n * @example\n *\n * ```ts\n * import { Messenger } from '@metamask/messenger';\n * import {\n *   ApiPlatformClientService,\n *   type ApiPlatformClientServiceActions,\n *   type ApiPlatformClientServiceEvents,\n * } from '@metamask/core-backend';\n *\n * const rootMessenger = new Messenger<'Root', ApiPlatformClientServiceActions, ApiPlatformClientServiceEvents>({ namespace: 'Root' });\n * const serviceMessenger = new Messenger<\n *   'ApiPlatformClientService',\n *   ApiPlatformClientServiceActions,\n *   ApiPlatformClientServiceEvents,\n *   typeof rootMessenger\n * >({ namespace: 'ApiPlatformClientService', parent: rootMessenger });\n *\n * new ApiPlatformClientService({\n *   messenger: serviceMessenger,\n *   clientProduct: 'metamask-extension',\n *   getBearerToken: async () => token,\n * });\n *\n * const client = rootMessenger.call('ApiPlatformClientService:getApiPlatformClient');\n * const balances = await client.accounts.fetchV5MultiAccountBalances(accountIds);\n * ```\n */\nexport class ApiPlatformClientService {\n  readonly name: typeof apiPlatformClientServiceName;\n\n  readonly #messenger: ApiPlatformClientServiceMessenger;\n\n  readonly #client: ApiPlatformClient;\n\n  constructor({\n    messenger,\n    ...clientOptions\n  }: ApiPlatformClientServiceOptions) {\n    this.name = apiPlatformClientServiceName;\n    this.#messenger = messenger;\n    this.#client = new ApiPlatformClient(clientOptions);\n\n    this.#messenger.registerMethodActionHandlers(\n      this,\n      MESSENGER_EXPOSED_METHODS,\n    );\n  }\n\n  /**\n   * Returns the shared ApiPlatformClient instance.\n   *\n   * Use this via the messenger: `messenger.call('ApiPlatformClientService:getApiPlatformClient')`.\n   *\n   * @returns The ApiPlatformClient instance (accounts, prices, token, tokens).\n   */\n  getApiPlatformClient(): ApiPlatformClient {\n    return this.#client;\n  }\n}\n"]}

package/dist/api/ApiPlatformClient.cjs

@@ -0,0 +1,177 @@
+"use strict";
+/**
+ * ApiPlatformClient - MetaMask API Platform Client
+ *
+ * A comprehensive API client that uses @tanstack/query-core directly for:
+ * - Automatic request deduplication
+ * - Intelligent caching
+ * - Automatic retries with exponential backoff
+ *
+ * Provides unified access to all MetaMask backend APIs:
+ * - Accounts API (accounts.api.cx.metamask.io)
+ * - Price API (price.api.cx.metamask.io)
+ * - Token API (token.api.cx.metamask.io)
+ * - Tokens API (tokens.api.cx.metamask.io)
+ *
+ * @example
+ * ```typescript
+ * const client = new ApiPlatformClient({
+ *   clientProduct: 'metamask-extension',
+ *   getBearerToken: async () => token,
+ * });
+ *
+ * // Access API methods through sub-clients
+ * const networks = await client.accounts.fetchV2SupportedNetworks();
+ * const balances = await client.accounts.fetchV5MultiAccountBalances(accountIds);
+ * const prices = await client.prices.fetchV3SpotPrices(assetIds);
+ * const tokenList = await client.token.fetchTokenList(1);
+ * const assets = await client.tokens.fetchV3Assets(assetIds);
+ *
+ * // Cache management
+ * await client.invalidateAll();           // Invalidate all caches
+ * await client.invalidateAuthToken();     // Invalidate auth token
+ * await client.accounts.invalidateBalances(); // Domain-specific via sub-client
+ * await client.prices.invalidatePrices();     // Domain-specific via sub-client
+ * ```
+ */
+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 _ApiPlatformClient_sharedQueryClient;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createApiPlatformClient = exports.ApiPlatformClient = void 0;
+const query_core_1 = require("@tanstack/query-core");
+// Import API clients from subfolders
+const index_js_1 = require("./accounts/index.cjs");
+const base_client_js_1 = require("./base-client.cjs");
+const index_js_2 = require("./prices/index.cjs");
+const shared_types_js_1 = require("./shared-types.cjs");
+const index_js_3 = require("./token/index.cjs");
+const index_js_4 = require("./tokens/index.cjs");
+// ============================================================================
+// UNIFIED API CLIENT
+// ============================================================================
+/**
+ * MetaMask API Platform Client with TanStack Query caching.
+ * Provides cached access to all MetaMask backend APIs through a unified interface.
+ *
+ * Access API methods through the sub-clients:
+ * - `client.accounts` - Accounts API (balances, transactions, NFTs, etc.)
+ * - `client.prices` - Prices API (spot prices, exchange rates, historical prices)
+ * - `client.token` - Token API (token metadata, trending, top gainers)
+ * - `client.tokens` - Tokens API (bulk asset operations, supported networks)
+ */
+class ApiPlatformClient {
+    constructor(options) {
+        /**
+         * Shared QueryClient instance used by all sub-clients.
+         */
+        _ApiPlatformClient_sharedQueryClient.set(this, void 0);
+        // Create or use provided QueryClient - shared by all sub-clients
+        __classPrivateFieldSet(this, _ApiPlatformClient_sharedQueryClient, options.queryClient ??
+            new query_core_1.QueryClient({
+                defaultOptions: {
+                    queries: {
+                        staleTime: shared_types_js_1.STALE_TIMES.DEFAULT,
+                        gcTime: shared_types_js_1.GC_TIMES.DEFAULT,
+                        retry: shared_types_js_1.shouldRetry,
+                        retryDelay: shared_types_js_1.calculateRetryDelay,
+                        refetchOnWindowFocus: false,
+                        networkMode: 'always',
+                    },
+                },
+            }), "f");
+        // Pass the shared QueryClient to all sub-clients
+        const sharedOptions = {
+            ...options,
+            queryClient: __classPrivateFieldGet(this, _ApiPlatformClient_sharedQueryClient, "f"),
+        };
+        this.accounts = new index_js_1.AccountsApiClient(sharedOptions);
+        this.prices = new index_js_2.PricesApiClient(sharedOptions);
+        this.token = new index_js_3.TokenApiClient(sharedOptions);
+        this.tokens = new index_js_4.TokensApiClient(sharedOptions);
+    }
+    // ==========================================================================
+    // CACHE MANAGEMENT (operates on shared QueryClient)
+    // ==========================================================================
+    /**
+     * Get the underlying QueryClient (for advanced usage).
+     *
+     * @returns The underlying QueryClient instance.
+     */
+    get queryClient() {
+        return __classPrivateFieldGet(this, _ApiPlatformClient_sharedQueryClient, "f");
+    }
+    /**
+     * Get cached data for a query key.
+     *
+     * @param queryKey - The query key to look up.
+     * @returns The cached data or undefined.
+     */
+    getCachedData(queryKey) {
+        return __classPrivateFieldGet(this, _ApiPlatformClient_sharedQueryClient, "f").getQueryData(queryKey);
+    }
+    /**
+     * Set cached data for a query key.
+     *
+     * @param queryKey - The query key to set data for.
+     * @param data - The data to cache.
+     */
+    setCachedData(queryKey, data) {
+        __classPrivateFieldGet(this, _ApiPlatformClient_sharedQueryClient, "f").setQueryData(queryKey, data);
+    }
+    /**
+     * Check if a query is currently fetching.
+     *
+     * @param queryKey - The query key to check.
+     * @returns True if the query is currently fetching.
+     */
+    isFetching(queryKey) {
+        return __classPrivateFieldGet(this, _ApiPlatformClient_sharedQueryClient, "f").isFetching({ queryKey }) > 0;
+    }
+    /**
+     * Clear all cached data across all sub-clients.
+     */
+    clear() {
+        __classPrivateFieldGet(this, _ApiPlatformClient_sharedQueryClient, "f").clear();
+    }
+    /**
+     * Invalidate all queries across all sub-clients.
+     */
+    async invalidateAll() {
+        await __classPrivateFieldGet(this, _ApiPlatformClient_sharedQueryClient, "f").invalidateQueries();
+    }
+    /**
+     * Invalidate the cached auth token.
+     * Call this when the user logs out or the token expires.
+     *
+     * Uses resetQueries() instead of invalidateQueries() to completely remove
+     * the cached value, ensuring the next request fetches a fresh token immediately.
+     */
+    async invalidateAuthToken() {
+        await __classPrivateFieldGet(this, _ApiPlatformClient_sharedQueryClient, "f").resetQueries({
+            queryKey: base_client_js_1.authQueryKeys.bearerToken(),
+        });
+    }
+}
+exports.ApiPlatformClient = ApiPlatformClient;
+_ApiPlatformClient_sharedQueryClient = new WeakMap();
+/**
+ * Factory function to create an ApiPlatformClient.
+ *
+ * @param options - Configuration options for the client.
+ * @returns A new ApiPlatformClient instance.
+ */
+function createApiPlatformClient(options) {
+    return new ApiPlatformClient(options);
+}
+exports.createApiPlatformClient = createApiPlatformClient;
+//# sourceMappingURL=ApiPlatformClient.cjs.map

package/dist/api/{ApiPlatformClient.js.map → ApiPlatformClient.cjs.map}

@@ -1 +1 @@
-{"version":3,"file":"ApiPlatformClient.js","sourceRoot":"","sources":["../../src/api/ApiPlatformClient.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGnD,qCAAqC;AACrC,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EACL,WAAW,EACX,QAAQ,EACR,WAAW,EACX,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,+EAA+E;AAC/E,qBAAqB;AACrB,+EAA+E;AAE/E;;;;;;;;;GASG;AACH,MAAM,OAAO,iBAAiB;IAC5B;;;OAGG;IACM,QAAQ,CAAoB;IAErC;;;OAGG;IACM,MAAM,CAAkB;IAEjC;;;OAGG;IACM,KAAK,CAAiB;IAE/B;;;OAGG;IACM,MAAM,CAAkB;IAEjC;;OAEG;IACM,kBAAkB,CAAc;IAEzC,YAAY,OAAiC;QAC3C,iEAAiE;QACjE,IAAI,CAAC,kBAAkB;YACrB,OAAO,CAAC,WAAW;gBACnB,IAAI,WAAW,CAAC;oBACd,cAAc,EAAE;wBACd,OAAO,EAAE;4BACP,SAAS,EAAE,WAAW,CAAC,OAAO;4BAC9B,MAAM,EAAE,QAAQ,CAAC,OAAO;4BACxB,KAAK,EAAE,WAAW;4BAClB,UAAU,EAAE,mBAAmB;4BAC/B,oBAAoB,EAAE,KAAK;4BAC3B,WAAW,EAAE,QAAQ;yBACtB;qBACF;iBACF,CAAC,CAAC;QAEL,iDAAiD;QACjD,MAAM,aAAa,GAA6B;YAC9C,GAAG,OAAO;YACV,WAAW,EAAE,IAAI,CAAC,kBAAkB;SACrC,CAAC;QAEF,IAAI,CAAC,QAAQ,GAAG,IAAI,iBAAiB,CAAC,aAAa,CAAC,CAAC;QACrD,IAAI,CAAC,MAAM,GAAG,IAAI,eAAe,CAAC,aAAa,CAAC,CAAC;QACjD,IAAI,CAAC,KAAK,GAAG,IAAI,cAAc,CAAC,aAAa,CAAC,CAAC;QAC/C,IAAI,CAAC,MAAM,GAAG,IAAI,eAAe,CAAC,aAAa,CAAC,CAAC;IACnD,CAAC;IAED,6EAA6E;IAC7E,oDAAoD;IACpD,6EAA6E;IAE7E;;;;OAIG;IACH,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,kBAAkB,CAAC;IACjC,CAAC;IAED;;;;;OAKG;IACH,aAAa,CAAa,QAAkB;QAC1C,OAAO,IAAI,CAAC,kBAAkB,CAAC,YAAY,CAAa,QAAQ,CAAC,CAAC;IACpE,CAAC;IAED;;;;;OAKG;IACH,aAAa,CAAa,QAAkB,EAAE,IAAgB;QAC5D,IAAI,CAAC,kBAAkB,CAAC,YAAY,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACvD,CAAC;IAED;;;;;OAKG;IACH,UAAU,CAAC,QAAkB;QAC3B,OAAO,IAAI,CAAC,kBAAkB,CAAC,UAAU,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC;IAC9D,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,kBAAkB,CAAC,KAAK,EAAE,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa;QACjB,MAAM,IAAI,CAAC,kBAAkB,CAAC,iBAAiB,EAAE,CAAC;IACpD,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,mBAAmB;QACvB,MAAM,IAAI,CAAC,kBAAkB,CAAC,YAAY,CAAC;YACzC,QAAQ,EAAE,aAAa,CAAC,WAAW,EAAE;SACtC,CAAC,CAAC;IACL,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CACrC,OAAiC;IAEjC,OAAO,IAAI,iBAAiB,CAAC,OAAO,CAAC,CAAC;AACxC,CAAC","sourcesContent":["/**\n * ApiPlatformClient - MetaMask API Platform Client\n *\n * A comprehensive API client that uses @tanstack/query-core directly for:\n * - Automatic request deduplication\n * - Intelligent caching\n * - Automatic retries with exponential backoff\n *\n * Provides unified access to all MetaMask backend APIs:\n * - Accounts API (accounts.api.cx.metamask.io)\n * - Price API (price.api.cx.metamask.io)\n * - Token API (token.api.cx.metamask.io)\n * - Tokens API (tokens.api.cx.metamask.io)\n *\n * @example\n * ```typescript\n * const client = new ApiPlatformClient({\n *   clientProduct: 'metamask-extension',\n *   getBearerToken: async () => token,\n * });\n *\n * // Access API methods through sub-clients\n * const networks = await client.accounts.fetchV2SupportedNetworks();\n * const balances = await client.accounts.fetchV5MultiAccountBalances(accountIds);\n * const prices = await client.prices.fetchV3SpotPrices(assetIds);\n * const tokenList = await client.token.fetchTokenList(1);\n * const assets = await client.tokens.fetchV3Assets(assetIds);\n *\n * // Cache management\n * await client.invalidateAll();           // Invalidate all caches\n * await client.invalidateAuthToken();     // Invalidate auth token\n * await client.accounts.invalidateBalances(); // Domain-specific via sub-client\n * await client.prices.invalidatePrices();     // Domain-specific via sub-client\n * ```\n */\n\nimport { QueryClient } from '@tanstack/query-core';\nimport type { QueryKey } from '@tanstack/query-core';\n\n// Import API clients from subfolders\nimport { AccountsApiClient } from './accounts/index.js';\nimport { authQueryKeys } from './base-client.js';\nimport { PricesApiClient } from './prices/index.js';\nimport {\n  STALE_TIMES,\n  GC_TIMES,\n  shouldRetry,\n  calculateRetryDelay,\n} from './shared-types.js';\nimport type { ApiPlatformClientOptions } from './shared-types.js';\nimport { TokenApiClient } from './token/index.js';\nimport { TokensApiClient } from './tokens/index.js';\n\n// ============================================================================\n// UNIFIED API CLIENT\n// ============================================================================\n\n/**\n * MetaMask API Platform Client with TanStack Query caching.\n * Provides cached access to all MetaMask backend APIs through a unified interface.\n *\n * Access API methods through the sub-clients:\n * - `client.accounts` - Accounts API (balances, transactions, NFTs, etc.)\n * - `client.prices` - Prices API (spot prices, exchange rates, historical prices)\n * - `client.token` - Token API (token metadata, trending, top gainers)\n * - `client.tokens` - Tokens API (bulk asset operations, supported networks)\n */\nexport class ApiPlatformClient {\n  /**\n   * Accounts API client.\n   * Provides methods for balances, transactions, relationships, NFTs, and token discovery.\n   */\n  readonly accounts: AccountsApiClient;\n\n  /**\n   * Prices API client.\n   * Provides methods for spot prices, exchange rates, and historical prices.\n   */\n  readonly prices: PricesApiClient;\n\n  /**\n   * Token API client.\n   * Provides methods for token metadata, networks, trending tokens, and top assets.\n   */\n  readonly token: TokenApiClient;\n\n  /**\n   * Tokens API client.\n   * Provides methods for bulk asset operations and supported networks.\n   */\n  readonly tokens: TokensApiClient;\n\n  /**\n   * Shared QueryClient instance used by all sub-clients.\n   */\n  readonly #sharedQueryClient: QueryClient;\n\n  constructor(options: ApiPlatformClientOptions) {\n    // Create or use provided QueryClient - shared by all sub-clients\n    this.#sharedQueryClient =\n      options.queryClient ??\n      new QueryClient({\n        defaultOptions: {\n          queries: {\n            staleTime: STALE_TIMES.DEFAULT,\n            gcTime: GC_TIMES.DEFAULT,\n            retry: shouldRetry,\n            retryDelay: calculateRetryDelay,\n            refetchOnWindowFocus: false,\n            networkMode: 'always',\n          },\n        },\n      });\n\n    // Pass the shared QueryClient to all sub-clients\n    const sharedOptions: ApiPlatformClientOptions = {\n      ...options,\n      queryClient: this.#sharedQueryClient,\n    };\n\n    this.accounts = new AccountsApiClient(sharedOptions);\n    this.prices = new PricesApiClient(sharedOptions);\n    this.token = new TokenApiClient(sharedOptions);\n    this.tokens = new TokensApiClient(sharedOptions);\n  }\n\n  // ==========================================================================\n  // CACHE MANAGEMENT (operates on shared QueryClient)\n  // ==========================================================================\n\n  /**\n   * Get the underlying QueryClient (for advanced usage).\n   *\n   * @returns The underlying QueryClient instance.\n   */\n  get queryClient(): QueryClient {\n    return this.#sharedQueryClient;\n  }\n\n  /**\n   * Get cached data for a query key.\n   *\n   * @param queryKey - The query key to look up.\n   * @returns The cached data or undefined.\n   */\n  getCachedData<CachedData>(queryKey: QueryKey): CachedData | undefined {\n    return this.#sharedQueryClient.getQueryData<CachedData>(queryKey);\n  }\n\n  /**\n   * Set cached data for a query key.\n   *\n   * @param queryKey - The query key to set data for.\n   * @param data - The data to cache.\n   */\n  setCachedData<CachedData>(queryKey: QueryKey, data: CachedData): void {\n    this.#sharedQueryClient.setQueryData(queryKey, data);\n  }\n\n  /**\n   * Check if a query is currently fetching.\n   *\n   * @param queryKey - The query key to check.\n   * @returns True if the query is currently fetching.\n   */\n  isFetching(queryKey: QueryKey): boolean {\n    return this.#sharedQueryClient.isFetching({ queryKey }) > 0;\n  }\n\n  /**\n   * Clear all cached data across all sub-clients.\n   */\n  clear(): void {\n    this.#sharedQueryClient.clear();\n  }\n\n  /**\n   * Invalidate all queries across all sub-clients.\n   */\n  async invalidateAll(): Promise<void> {\n    await this.#sharedQueryClient.invalidateQueries();\n  }\n\n  /**\n   * Invalidate the cached auth token.\n   * Call this when the user logs out or the token expires.\n   *\n   * Uses resetQueries() instead of invalidateQueries() to completely remove\n   * the cached value, ensuring the next request fetches a fresh token immediately.\n   */\n  async invalidateAuthToken(): Promise<void> {\n    await this.#sharedQueryClient.resetQueries({\n      queryKey: authQueryKeys.bearerToken(),\n    });\n  }\n}\n\n/**\n * Factory function to create an ApiPlatformClient.\n *\n * @param options - Configuration options for the client.\n * @returns A new ApiPlatformClient instance.\n */\nexport function createApiPlatformClient(\n  options: ApiPlatformClientOptions,\n): ApiPlatformClient {\n  return new ApiPlatformClient(options);\n}\n"]}
+{"version":3,"file":"ApiPlatformClient.cjs","sourceRoot":"","sources":["../../src/api/ApiPlatformClient.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;;;;;;;;;;;;;;;AAEH,qDAAmD;AAGnD,qCAAqC;AACrC,mDAAwD;AACxD,sDAAiD;AACjD,iDAAoD;AACpD,wDAK2B;AAE3B,gDAAkD;AAClD,iDAAoD;AAEpD,+EAA+E;AAC/E,qBAAqB;AACrB,+EAA+E;AAE/E;;;;;;;;;GASG;AACH,MAAa,iBAAiB;IA8B5B,YAAY,OAAiC;QAL7C;;WAEG;QACM,uDAAgC;QAGvC,iEAAiE;QACjE,uBAAA,IAAI,wCACF,OAAO,CAAC,WAAW;YACnB,IAAI,wBAAW,CAAC;gBACd,cAAc,EAAE;oBACd,OAAO,EAAE;wBACP,SAAS,EAAE,6BAAW,CAAC,OAAO;wBAC9B,MAAM,EAAE,0BAAQ,CAAC,OAAO;wBACxB,KAAK,EAAE,6BAAW;wBAClB,UAAU,EAAE,qCAAmB;wBAC/B,oBAAoB,EAAE,KAAK;wBAC3B,WAAW,EAAE,QAAQ;qBACtB;iBACF;aACF,CAAC,MAAA,CAAC;QAEL,iDAAiD;QACjD,MAAM,aAAa,GAA6B;YAC9C,GAAG,OAAO;YACV,WAAW,EAAE,uBAAA,IAAI,4CAAmB;SACrC,CAAC;QAEF,IAAI,CAAC,QAAQ,GAAG,IAAI,4BAAiB,CAAC,aAAa,CAAC,CAAC;QACrD,IAAI,CAAC,MAAM,GAAG,IAAI,0BAAe,CAAC,aAAa,CAAC,CAAC;QACjD,IAAI,CAAC,KAAK,GAAG,IAAI,yBAAc,CAAC,aAAa,CAAC,CAAC;QAC/C,IAAI,CAAC,MAAM,GAAG,IAAI,0BAAe,CAAC,aAAa,CAAC,CAAC;IACnD,CAAC;IAED,6EAA6E;IAC7E,oDAAoD;IACpD,6EAA6E;IAE7E;;;;OAIG;IACH,IAAI,WAAW;QACb,OAAO,uBAAA,IAAI,4CAAmB,CAAC;IACjC,CAAC;IAED;;;;;OAKG;IACH,aAAa,CAAa,QAAkB;QAC1C,OAAO,uBAAA,IAAI,4CAAmB,CAAC,YAAY,CAAa,QAAQ,CAAC,CAAC;IACpE,CAAC;IAED;;;;;OAKG;IACH,aAAa,CAAa,QAAkB,EAAE,IAAgB;QAC5D,uBAAA,IAAI,4CAAmB,CAAC,YAAY,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACvD,CAAC;IAED;;;;;OAKG;IACH,UAAU,CAAC,QAAkB;QAC3B,OAAO,uBAAA,IAAI,4CAAmB,CAAC,UAAU,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC;IAC9D,CAAC;IAED;;OAEG;IACH,KAAK;QACH,uBAAA,IAAI,4CAAmB,CAAC,KAAK,EAAE,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa;QACjB,MAAM,uBAAA,IAAI,4CAAmB,CAAC,iBAAiB,EAAE,CAAC;IACpD,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,mBAAmB;QACvB,MAAM,uBAAA,IAAI,4CAAmB,CAAC,YAAY,CAAC;YACzC,QAAQ,EAAE,8BAAa,CAAC,WAAW,EAAE;SACtC,CAAC,CAAC;IACL,CAAC;CACF;AAhID,8CAgIC;;AAED;;;;;GAKG;AACH,SAAgB,uBAAuB,CACrC,OAAiC;IAEjC,OAAO,IAAI,iBAAiB,CAAC,OAAO,CAAC,CAAC;AACxC,CAAC;AAJD,0DAIC","sourcesContent":["/**\n * ApiPlatformClient - MetaMask API Platform Client\n *\n * A comprehensive API client that uses @tanstack/query-core directly for:\n * - Automatic request deduplication\n * - Intelligent caching\n * - Automatic retries with exponential backoff\n *\n * Provides unified access to all MetaMask backend APIs:\n * - Accounts API (accounts.api.cx.metamask.io)\n * - Price API (price.api.cx.metamask.io)\n * - Token API (token.api.cx.metamask.io)\n * - Tokens API (tokens.api.cx.metamask.io)\n *\n * @example\n * ```typescript\n * const client = new ApiPlatformClient({\n *   clientProduct: 'metamask-extension',\n *   getBearerToken: async () => token,\n * });\n *\n * // Access API methods through sub-clients\n * const networks = await client.accounts.fetchV2SupportedNetworks();\n * const balances = await client.accounts.fetchV5MultiAccountBalances(accountIds);\n * const prices = await client.prices.fetchV3SpotPrices(assetIds);\n * const tokenList = await client.token.fetchTokenList(1);\n * const assets = await client.tokens.fetchV3Assets(assetIds);\n *\n * // Cache management\n * await client.invalidateAll();           // Invalidate all caches\n * await client.invalidateAuthToken();     // Invalidate auth token\n * await client.accounts.invalidateBalances(); // Domain-specific via sub-client\n * await client.prices.invalidatePrices();     // Domain-specific via sub-client\n * ```\n */\n\nimport { QueryClient } from '@tanstack/query-core';\nimport type { QueryKey } from '@tanstack/query-core';\n\n// Import API clients from subfolders\nimport { AccountsApiClient } from './accounts/index.js';\nimport { authQueryKeys } from './base-client.js';\nimport { PricesApiClient } from './prices/index.js';\nimport {\n  STALE_TIMES,\n  GC_TIMES,\n  shouldRetry,\n  calculateRetryDelay,\n} from './shared-types.js';\nimport type { ApiPlatformClientOptions } from './shared-types.js';\nimport { TokenApiClient } from './token/index.js';\nimport { TokensApiClient } from './tokens/index.js';\n\n// ============================================================================\n// UNIFIED API CLIENT\n// ============================================================================\n\n/**\n * MetaMask API Platform Client with TanStack Query caching.\n * Provides cached access to all MetaMask backend APIs through a unified interface.\n *\n * Access API methods through the sub-clients:\n * - `client.accounts` - Accounts API (balances, transactions, NFTs, etc.)\n * - `client.prices` - Prices API (spot prices, exchange rates, historical prices)\n * - `client.token` - Token API (token metadata, trending, top gainers)\n * - `client.tokens` - Tokens API (bulk asset operations, supported networks)\n */\nexport class ApiPlatformClient {\n  /**\n   * Accounts API client.\n   * Provides methods for balances, transactions, relationships, NFTs, and token discovery.\n   */\n  readonly accounts: AccountsApiClient;\n\n  /**\n   * Prices API client.\n   * Provides methods for spot prices, exchange rates, and historical prices.\n   */\n  readonly prices: PricesApiClient;\n\n  /**\n   * Token API client.\n   * Provides methods for token metadata, networks, trending tokens, and top assets.\n   */\n  readonly token: TokenApiClient;\n\n  /**\n   * Tokens API client.\n   * Provides methods for bulk asset operations and supported networks.\n   */\n  readonly tokens: TokensApiClient;\n\n  /**\n   * Shared QueryClient instance used by all sub-clients.\n   */\n  readonly #sharedQueryClient: QueryClient;\n\n  constructor(options: ApiPlatformClientOptions) {\n    // Create or use provided QueryClient - shared by all sub-clients\n    this.#sharedQueryClient =\n      options.queryClient ??\n      new QueryClient({\n        defaultOptions: {\n          queries: {\n            staleTime: STALE_TIMES.DEFAULT,\n            gcTime: GC_TIMES.DEFAULT,\n            retry: shouldRetry,\n            retryDelay: calculateRetryDelay,\n            refetchOnWindowFocus: false,\n            networkMode: 'always',\n          },\n        },\n      });\n\n    // Pass the shared QueryClient to all sub-clients\n    const sharedOptions: ApiPlatformClientOptions = {\n      ...options,\n      queryClient: this.#sharedQueryClient,\n    };\n\n    this.accounts = new AccountsApiClient(sharedOptions);\n    this.prices = new PricesApiClient(sharedOptions);\n    this.token = new TokenApiClient(sharedOptions);\n    this.tokens = new TokensApiClient(sharedOptions);\n  }\n\n  // ==========================================================================\n  // CACHE MANAGEMENT (operates on shared QueryClient)\n  // ==========================================================================\n\n  /**\n   * Get the underlying QueryClient (for advanced usage).\n   *\n   * @returns The underlying QueryClient instance.\n   */\n  get queryClient(): QueryClient {\n    return this.#sharedQueryClient;\n  }\n\n  /**\n   * Get cached data for a query key.\n   *\n   * @param queryKey - The query key to look up.\n   * @returns The cached data or undefined.\n   */\n  getCachedData<CachedData>(queryKey: QueryKey): CachedData | undefined {\n    return this.#sharedQueryClient.getQueryData<CachedData>(queryKey);\n  }\n\n  /**\n   * Set cached data for a query key.\n   *\n   * @param queryKey - The query key to set data for.\n   * @param data - The data to cache.\n   */\n  setCachedData<CachedData>(queryKey: QueryKey, data: CachedData): void {\n    this.#sharedQueryClient.setQueryData(queryKey, data);\n  }\n\n  /**\n   * Check if a query is currently fetching.\n   *\n   * @param queryKey - The query key to check.\n   * @returns True if the query is currently fetching.\n   */\n  isFetching(queryKey: QueryKey): boolean {\n    return this.#sharedQueryClient.isFetching({ queryKey }) > 0;\n  }\n\n  /**\n   * Clear all cached data across all sub-clients.\n   */\n  clear(): void {\n    this.#sharedQueryClient.clear();\n  }\n\n  /**\n   * Invalidate all queries across all sub-clients.\n   */\n  async invalidateAll(): Promise<void> {\n    await this.#sharedQueryClient.invalidateQueries();\n  }\n\n  /**\n   * Invalidate the cached auth token.\n   * Call this when the user logs out or the token expires.\n   *\n   * Uses resetQueries() instead of invalidateQueries() to completely remove\n   * the cached value, ensuring the next request fetches a fresh token immediately.\n   */\n  async invalidateAuthToken(): Promise<void> {\n    await this.#sharedQueryClient.resetQueries({\n      queryKey: authQueryKeys.bearerToken(),\n    });\n  }\n}\n\n/**\n * Factory function to create an ApiPlatformClient.\n *\n * @param options - Configuration options for the client.\n * @returns A new ApiPlatformClient instance.\n */\nexport function createApiPlatformClient(\n  options: ApiPlatformClientOptions,\n): ApiPlatformClient {\n  return new ApiPlatformClient(options);\n}\n"]}

package/dist/api/{ApiPlatformClient.d.ts → ApiPlatformClient.d.cts}

@@ -33,13 +33,13 @@
  * await client.prices.invalidatePrices();     // Domain-specific via sub-client
  * ```
  */
-import { QueryClient } from '@tanstack/query-core';
-import type { QueryKey } from '@tanstack/query-core';
-import { AccountsApiClient } from './accounts/index.js';
-import { PricesApiClient } from './prices/index.js';
-import type { ApiPlatformClientOptions } from './shared-types.js';
-import { TokenApiClient } from './token/index.js';
-import { TokensApiClient } from './tokens/index.js';
+import { QueryClient } from "@tanstack/query-core";
+import type { QueryKey } from "@tanstack/query-core";
+import { AccountsApiClient } from "./accounts/index.cjs";
+import { PricesApiClient } from "./prices/index.cjs";
+import type { ApiPlatformClientOptions } from "./shared-types.cjs";
+import { TokenApiClient } from "./token/index.cjs";
+import { TokensApiClient } from "./tokens/index.cjs";
 /**
  * MetaMask API Platform Client with TanStack Query caching.
  * Provides cached access to all MetaMask backend APIs through a unified interface.
@@ -124,4 +124,4 @@ export declare class ApiPlatformClient {
  * @returns A new ApiPlatformClient instance.
  */
 export declare function createApiPlatformClient(options: ApiPlatformClientOptions): ApiPlatformClient;
-//# sourceMappingURL=ApiPlatformClient.d.ts.map
+//# sourceMappingURL=ApiPlatformClient.d.cts.map

package/dist/api/ApiPlatformClient.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ApiPlatformClient.d.cts","sourceRoot":"","sources":["../../src/api/ApiPlatformClient.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,EAAE,WAAW,EAAE,6BAA6B;AACnD,OAAO,KAAK,EAAE,QAAQ,EAAE,6BAA6B;AAGrD,OAAO,EAAE,iBAAiB,EAAE,6BAA4B;AAExD,OAAO,EAAE,eAAe,EAAE,2BAA0B;AAOpD,OAAO,KAAK,EAAE,wBAAwB,EAAE,2BAA0B;AAClE,OAAO,EAAE,cAAc,EAAE,0BAAyB;AAClD,OAAO,EAAE,eAAe,EAAE,2BAA0B;AAMpD;;;;;;;;;GASG;AACH,qBAAa,iBAAiB;;IAC5B;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IAErC;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IAEjC;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAE/B;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;gBAOrB,OAAO,EAAE,wBAAwB;IAiC7C;;;;OAIG;IACH,IAAI,WAAW,IAAI,WAAW,CAE7B;IAED;;;;;OAKG;IACH,aAAa,CAAC,UAAU,EAAE,QAAQ,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS;IAIrE;;;;;OAKG;IACH,aAAa,CAAC,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI;IAIrE;;;;;OAKG;IACH,UAAU,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO;IAIvC;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAIpC;;;;;;OAMG;IACG,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;CAK3C;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,wBAAwB,GAChC,iBAAiB,CAEnB"}