@metamask/core-backend 5.0.0 → 5.1.0

package/dist/api/ApiPlatformClient.d.cts

@@ -0,0 +1,127 @@
+/**
+ * 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
+ * ```
+ */
+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.
+ *
+ * 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)
+ */
+export declare class ApiPlatformClient {
+    #private;
+    /**
+     * Accounts API client.
+     * Provides methods for balances, transactions, relationships, NFTs, and token discovery.
+     */
+    readonly accounts: AccountsApiClient;
+    /**
+     * Prices API client.
+     * Provides methods for spot prices, exchange rates, and historical prices.
+     */
+    readonly prices: PricesApiClient;
+    /**
+     * Token API client.
+     * Provides methods for token metadata, networks, trending tokens, and top assets.
+     */
+    readonly token: TokenApiClient;
+    /**
+     * Tokens API client.
+     * Provides methods for bulk asset operations and supported networks.
+     */
+    readonly tokens: TokensApiClient;
+    constructor(options: ApiPlatformClientOptions);
+    /**
+     * Get the underlying QueryClient (for advanced usage).
+     *
+     * @returns The underlying QueryClient instance.
+     */
+    get queryClient(): QueryClient;
+    /**
+     * Get cached data for a query key.
+     *
+     * @param queryKey - The query key to look up.
+     * @returns The cached data or undefined.
+     */
+    getCachedData<CachedData>(queryKey: QueryKey): CachedData | undefined;
+    /**
+     * Set cached data for a query key.
+     *
+     * @param queryKey - The query key to set data for.
+     * @param data - The data to cache.
+     */
+    setCachedData<CachedData>(queryKey: QueryKey, data: CachedData): void;
+    /**
+     * Check if a query is currently fetching.
+     *
+     * @param queryKey - The query key to check.
+     * @returns True if the query is currently fetching.
+     */
+    isFetching(queryKey: QueryKey): boolean;
+    /**
+     * Clear all cached data across all sub-clients.
+     */
+    clear(): void;
+    /**
+     * Invalidate all queries across all sub-clients.
+     */
+    invalidateAll(): Promise<void>;
+    /**
+     * 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.
+     */
+    invalidateAuthToken(): Promise<void>;
+}
+/**
+ * Factory function to create an ApiPlatformClient.
+ *
+ * @param options - Configuration options for the client.
+ * @returns A new ApiPlatformClient instance.
+ */
+export declare function createApiPlatformClient(options: ApiPlatformClientOptions): ApiPlatformClient;
+//# 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,6BAAmB;AAE/C,OAAO,EAAE,eAAe,EAAE,2BAAiB;AAO3C,OAAO,KAAK,EAAE,wBAAwB,EAAE,2BAAuB;AAC/D,OAAO,EAAE,cAAc,EAAE,0BAAgB;AACzC,OAAO,EAAE,eAAe,EAAE,2BAAiB;AAM3C;;;;;;;;;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"}

package/dist/api/ApiPlatformClient.d.mts

@@ -0,0 +1,127 @@
+/**
+ * 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
+ * ```
+ */
+import { QueryClient } from "@tanstack/query-core";
+import type { QueryKey } from "@tanstack/query-core";
+import { AccountsApiClient } from "./accounts/index.mjs";
+import { PricesApiClient } from "./prices/index.mjs";
+import type { ApiPlatformClientOptions } from "./shared-types.mjs";
+import { TokenApiClient } from "./token/index.mjs";
+import { TokensApiClient } from "./tokens/index.mjs";
+/**
+ * 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)
+ */
+export declare class ApiPlatformClient {
+    #private;
+    /**
+     * Accounts API client.
+     * Provides methods for balances, transactions, relationships, NFTs, and token discovery.
+     */
+    readonly accounts: AccountsApiClient;
+    /**
+     * Prices API client.
+     * Provides methods for spot prices, exchange rates, and historical prices.
+     */
+    readonly prices: PricesApiClient;
+    /**
+     * Token API client.
+     * Provides methods for token metadata, networks, trending tokens, and top assets.
+     */
+    readonly token: TokenApiClient;
+    /**
+     * Tokens API client.
+     * Provides methods for bulk asset operations and supported networks.
+     */
+    readonly tokens: TokensApiClient;
+    constructor(options: ApiPlatformClientOptions);
+    /**
+     * Get the underlying QueryClient (for advanced usage).
+     *
+     * @returns The underlying QueryClient instance.
+     */
+    get queryClient(): QueryClient;
+    /**
+     * Get cached data for a query key.
+     *
+     * @param queryKey - The query key to look up.
+     * @returns The cached data or undefined.
+     */
+    getCachedData<CachedData>(queryKey: QueryKey): CachedData | undefined;
+    /**
+     * Set cached data for a query key.
+     *
+     * @param queryKey - The query key to set data for.
+     * @param data - The data to cache.
+     */
+    setCachedData<CachedData>(queryKey: QueryKey, data: CachedData): void;
+    /**
+     * Check if a query is currently fetching.
+     *
+     * @param queryKey - The query key to check.
+     * @returns True if the query is currently fetching.
+     */
+    isFetching(queryKey: QueryKey): boolean;
+    /**
+     * Clear all cached data across all sub-clients.
+     */
+    clear(): void;
+    /**
+     * Invalidate all queries across all sub-clients.
+     */
+    invalidateAll(): Promise<void>;
+    /**
+     * 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.
+     */
+    invalidateAuthToken(): Promise<void>;
+}
+/**
+ * Factory function to create an ApiPlatformClient.
+ *
+ * @param options - Configuration options for the client.
+ * @returns A new ApiPlatformClient instance.
+ */
+export declare function createApiPlatformClient(options: ApiPlatformClientOptions): ApiPlatformClient;
+//# sourceMappingURL=ApiPlatformClient.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ApiPlatformClient.d.mts","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,6BAAmB;AAE/C,OAAO,EAAE,eAAe,EAAE,2BAAiB;AAO3C,OAAO,KAAK,EAAE,wBAAwB,EAAE,2BAAuB;AAC/D,OAAO,EAAE,cAAc,EAAE,0BAAgB;AACzC,OAAO,EAAE,eAAe,EAAE,2BAAiB;AAM3C;;;;;;;;;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"}

package/dist/api/ApiPlatformClient.mjs

@@ -0,0 +1,172 @@
+/**
+ * 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;
+import { QueryClient } from "@tanstack/query-core";
+// Import API clients from subfolders
+import { AccountsApiClient } from "./accounts/index.mjs";
+import { authQueryKeys } from "./base-client.mjs";
+import { PricesApiClient } from "./prices/index.mjs";
+import { STALE_TIMES, GC_TIMES, shouldRetry, calculateRetryDelay } from "./shared-types.mjs";
+import { TokenApiClient } from "./token/index.mjs";
+import { TokensApiClient } from "./tokens/index.mjs";
+// ============================================================================
+// 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)
+ */
+export 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 QueryClient({
+                defaultOptions: {
+                    queries: {
+                        staleTime: STALE_TIMES.DEFAULT,
+                        gcTime: GC_TIMES.DEFAULT,
+                        retry: shouldRetry,
+                        retryDelay: 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 AccountsApiClient(sharedOptions);
+        this.prices = new PricesApiClient(sharedOptions);
+        this.token = new TokenApiClient(sharedOptions);
+        this.tokens = new 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: authQueryKeys.bearerToken(),
+        });
+    }
+}
+_ApiPlatformClient_sharedQueryClient = new WeakMap();
+/**
+ * Factory function to create an ApiPlatformClient.
+ *
+ * @param options - Configuration options for the client.
+ * @returns A new ApiPlatformClient instance.
+ */
+export function createApiPlatformClient(options) {
+    return new ApiPlatformClient(options);
+}
+//# sourceMappingURL=ApiPlatformClient.mjs.map

package/dist/api/ApiPlatformClient.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ApiPlatformClient.mjs","sourceRoot":"","sources":["../../src/api/ApiPlatformClient.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;;;;;;;;;;;;;AAEH,OAAO,EAAE,WAAW,EAAE,6BAA6B;AAGnD,qCAAqC;AACrC,OAAO,EAAE,iBAAiB,EAAE,6BAAmB;AAC/C,OAAO,EAAE,aAAa,EAAE,0BAAsB;AAC9C,OAAO,EAAE,eAAe,EAAE,2BAAiB;AAC3C,OAAO,EACL,WAAW,EACX,QAAQ,EACR,WAAW,EACX,mBAAmB,EACpB,2BAAuB;AAExB,OAAO,EAAE,cAAc,EAAE,0BAAgB;AACzC,OAAO,EAAE,eAAe,EAAE,2BAAiB;AAE3C,+EAA+E;AAC/E,qBAAqB;AACrB,+EAA+E;AAE/E;;;;;;;;;GASG;AACH,MAAM,OAAO,iBAAiB;IA8B5B,YAAY,OAAiC;QAL7C;;WAEG;QACM,uDAAgC;QAGvC,iEAAiE;QACjE,uBAAA,IAAI,wCACF,OAAO,CAAC,WAAW;YACnB,IAAI,WAAW,CAAC;gBACd,cAAc,EAAE;oBACd,OAAO,EAAE;wBACP,SAAS,EAAE,WAAW,CAAC,OAAO;wBAC9B,MAAM,EAAE,QAAQ,CAAC,OAAO;wBACxB,KAAK,EAAE,WAAW;wBAClB,UAAU,EAAE,mBAAmB;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,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,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,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';\nimport { authQueryKeys } from './base-client';\nimport { PricesApiClient } from './prices';\nimport {\n  STALE_TIMES,\n  GC_TIMES,\n  shouldRetry,\n  calculateRetryDelay,\n} from './shared-types';\nimport type { ApiPlatformClientOptions } from './shared-types';\nimport { TokenApiClient } from './token';\nimport { TokensApiClient } from './tokens';\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"]}