@metamask/core-backend 4.1.0 → 5.1.0

package/dist/api/accounts/types.d.cts

@@ -0,0 +1,195 @@
+/**
+ * Accounts API types for the API Platform Client.
+ * API: accounts.api.cx.metamask.io
+ */
+import type { PageInfo } from "../shared-types.cjs";
+/** V5 Balance Item from Accounts API */
+export type V5BalanceItem = {
+    object: 'token';
+    symbol: string;
+    name: string;
+    type: 'native' | 'erc20';
+    decimals: number;
+    assetId: string;
+    balance: string;
+    accountId: string;
+};
+/** V5 Multi-account balances response */
+export type V5BalancesResponse = {
+    count: number;
+    unprocessedNetworks: string[];
+    balances: V5BalanceItem[];
+};
+/** V2 Balance item */
+export type V2BalanceItem = {
+    object: string;
+    type?: string;
+    timestamp?: string;
+    address: string;
+    symbol: string;
+    name: string;
+    decimals: number;
+    chainId: number;
+    balance: string;
+    accountAddress?: string;
+};
+/** V2 Balances response */
+export type V2BalancesResponse = {
+    count: number;
+    balances: V2BalanceItem[];
+    unprocessedNetworks: number[];
+};
+/** V4 Multi-account balances response */
+export type V4BalancesResponse = {
+    count: number;
+    balances: V2BalanceItem[];
+    unprocessedNetworks: number[];
+};
+/** V1 Supported networks response */
+export type V1SupportedNetworksResponse = {
+    supportedNetworks: number[];
+};
+/** V2 Supported networks response */
+export type V2SupportedNetworksResponse = {
+    fullSupport: number[];
+    partialSupport: {
+        balances: number[];
+    };
+};
+/** Active networks response */
+export type V2ActiveNetworksResponse = {
+    activeNetworks: string[];
+};
+/** Transaction by hash response */
+export type V1TransactionByHashResponse = {
+    hash: string;
+    timestamp: string;
+    chainId: number;
+    blockNumber: number;
+    blockHash: string;
+    gas: number;
+    gasUsed: number;
+    gasPrice: string;
+    effectiveGasPrice: string;
+    nonce: number;
+    cumulativeGasUsed: number;
+    methodId?: string;
+    value: string;
+    to: string;
+    from: string;
+    isError?: boolean;
+    valueTransfers?: {
+        from: string;
+        to: string;
+        amount: string;
+        decimal: number;
+        contractAddress: string;
+        symbol: string;
+        name: string;
+        transferType: string;
+    }[];
+    logs?: {
+        data: string;
+        topics: string[];
+        address: string;
+        logIndex: number;
+    }[];
+    transactionType?: string;
+    transactionCategory?: string;
+    transactionProtocol?: string;
+};
+/** Account transactions response */
+export type V1AccountTransactionsResponse = {
+    data: V1TransactionByHashResponse[];
+    pageInfo: PageInfo;
+};
+/** V4 Multi-account transactions response */
+export type V4MultiAccountTransactionsResponse = {
+    unprocessedNetworks: string[];
+    pageInfo: {
+        count: number;
+        hasNextPage: boolean;
+        endCursor?: string;
+    };
+    data: V1TransactionByHashResponse[];
+};
+/**
+ * Value transfer within a transaction
+ */
+export type ValueTransfer = {
+    from: string;
+    to: string;
+    amount: string;
+    decimal: number;
+    transferType: string;
+};
+/**
+ * Account address relationship result from v1 endpoint
+ */
+export type V1AccountRelationshipResult = {
+    /** Transaction hash of the relationship */
+    txHash?: string;
+    /** Chain ID */
+    chainId?: number;
+    /** Number of interactions */
+    count?: number;
+    /** Transaction data details */
+    data?: {
+        hash: string;
+        timestamp: string;
+        chainId: number;
+        blockNumber: number;
+        blockHash: string;
+        gas: number;
+        gasUsed: number;
+        gasPrice: string;
+        effectiveGasPrice: string;
+        nonce: number;
+        cumulativeGasUsed: number;
+        methodId: string;
+        value: string;
+        to: string;
+        from: string;
+        isError: boolean;
+        valueTransfers: ValueTransfer[];
+        logs: unknown[];
+        transactionType: string;
+        transactionCategory: string;
+        readable: string;
+        textFunctionSignature: string;
+    };
+    /** Error information when relationship lookup fails */
+    error?: {
+        code: string;
+        message: string;
+    };
+};
+/** NFT item */
+export type NftItem = {
+    tokenId: string;
+    contractAddress: string;
+    chainId: number;
+    name?: string;
+    description?: string;
+    imageUrl?: string;
+    attributes?: Record<string, unknown>[];
+};
+/** NFTs response */
+export type V2NftsResponse = {
+    data: NftItem[];
+    pageInfo: PageInfo;
+};
+/** Token discovery item */
+export type TokenDiscoveryItem = {
+    address: string;
+    chainId: number;
+    symbol: string;
+    name: string;
+    decimals: number;
+    balance?: string;
+};
+/** Tokens response */
+export type V2TokensResponse = {
+    data: TokenDiscoveryItem[];
+};
+//# sourceMappingURL=types.d.cts.map

package/dist/api/accounts/types.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.cts","sourceRoot":"","sources":["../../../src/api/accounts/types.ts"],"names":[],"mappings":"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"}

package/dist/api/accounts/types.d.mts

@@ -0,0 +1,195 @@
+/**
+ * Accounts API types for the API Platform Client.
+ * API: accounts.api.cx.metamask.io
+ */
+import type { PageInfo } from "../shared-types.mjs";
+/** V5 Balance Item from Accounts API */
+export type V5BalanceItem = {
+    object: 'token';
+    symbol: string;
+    name: string;
+    type: 'native' | 'erc20';
+    decimals: number;
+    assetId: string;
+    balance: string;
+    accountId: string;
+};
+/** V5 Multi-account balances response */
+export type V5BalancesResponse = {
+    count: number;
+    unprocessedNetworks: string[];
+    balances: V5BalanceItem[];
+};
+/** V2 Balance item */
+export type V2BalanceItem = {
+    object: string;
+    type?: string;
+    timestamp?: string;
+    address: string;
+    symbol: string;
+    name: string;
+    decimals: number;
+    chainId: number;
+    balance: string;
+    accountAddress?: string;
+};
+/** V2 Balances response */
+export type V2BalancesResponse = {
+    count: number;
+    balances: V2BalanceItem[];
+    unprocessedNetworks: number[];
+};
+/** V4 Multi-account balances response */
+export type V4BalancesResponse = {
+    count: number;
+    balances: V2BalanceItem[];
+    unprocessedNetworks: number[];
+};
+/** V1 Supported networks response */
+export type V1SupportedNetworksResponse = {
+    supportedNetworks: number[];
+};
+/** V2 Supported networks response */
+export type V2SupportedNetworksResponse = {
+    fullSupport: number[];
+    partialSupport: {
+        balances: number[];
+    };
+};
+/** Active networks response */
+export type V2ActiveNetworksResponse = {
+    activeNetworks: string[];
+};
+/** Transaction by hash response */
+export type V1TransactionByHashResponse = {
+    hash: string;
+    timestamp: string;
+    chainId: number;
+    blockNumber: number;
+    blockHash: string;
+    gas: number;
+    gasUsed: number;
+    gasPrice: string;
+    effectiveGasPrice: string;
+    nonce: number;
+    cumulativeGasUsed: number;
+    methodId?: string;
+    value: string;
+    to: string;
+    from: string;
+    isError?: boolean;
+    valueTransfers?: {
+        from: string;
+        to: string;
+        amount: string;
+        decimal: number;
+        contractAddress: string;
+        symbol: string;
+        name: string;
+        transferType: string;
+    }[];
+    logs?: {
+        data: string;
+        topics: string[];
+        address: string;
+        logIndex: number;
+    }[];
+    transactionType?: string;
+    transactionCategory?: string;
+    transactionProtocol?: string;
+};
+/** Account transactions response */
+export type V1AccountTransactionsResponse = {
+    data: V1TransactionByHashResponse[];
+    pageInfo: PageInfo;
+};
+/** V4 Multi-account transactions response */
+export type V4MultiAccountTransactionsResponse = {
+    unprocessedNetworks: string[];
+    pageInfo: {
+        count: number;
+        hasNextPage: boolean;
+        endCursor?: string;
+    };
+    data: V1TransactionByHashResponse[];
+};
+/**
+ * Value transfer within a transaction
+ */
+export type ValueTransfer = {
+    from: string;
+    to: string;
+    amount: string;
+    decimal: number;
+    transferType: string;
+};
+/**
+ * Account address relationship result from v1 endpoint
+ */
+export type V1AccountRelationshipResult = {
+    /** Transaction hash of the relationship */
+    txHash?: string;
+    /** Chain ID */
+    chainId?: number;
+    /** Number of interactions */
+    count?: number;
+    /** Transaction data details */
+    data?: {
+        hash: string;
+        timestamp: string;
+        chainId: number;
+        blockNumber: number;
+        blockHash: string;
+        gas: number;
+        gasUsed: number;
+        gasPrice: string;
+        effectiveGasPrice: string;
+        nonce: number;
+        cumulativeGasUsed: number;
+        methodId: string;
+        value: string;
+        to: string;
+        from: string;
+        isError: boolean;
+        valueTransfers: ValueTransfer[];
+        logs: unknown[];
+        transactionType: string;
+        transactionCategory: string;
+        readable: string;
+        textFunctionSignature: string;
+    };
+    /** Error information when relationship lookup fails */
+    error?: {
+        code: string;
+        message: string;
+    };
+};
+/** NFT item */
+export type NftItem = {
+    tokenId: string;
+    contractAddress: string;
+    chainId: number;
+    name?: string;
+    description?: string;
+    imageUrl?: string;
+    attributes?: Record<string, unknown>[];
+};
+/** NFTs response */
+export type V2NftsResponse = {
+    data: NftItem[];
+    pageInfo: PageInfo;
+};
+/** Token discovery item */
+export type TokenDiscoveryItem = {
+    address: string;
+    chainId: number;
+    symbol: string;
+    name: string;
+    decimals: number;
+    balance?: string;
+};
+/** Tokens response */
+export type V2TokensResponse = {
+    data: TokenDiscoveryItem[];
+};
+//# sourceMappingURL=types.d.mts.map

package/dist/api/accounts/types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.mts","sourceRoot":"","sources":["../../../src/api/accounts/types.ts"],"names":[],"mappings":"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"}

package/dist/api/accounts/types.mjs

@@ -0,0 +1,6 @@
+/**
+ * Accounts API types for the API Platform Client.
+ * API: accounts.api.cx.metamask.io
+ */
+export {};
+//# sourceMappingURL=types.mjs.map

package/dist/api/accounts/types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.mjs","sourceRoot":"","sources":["../../../src/api/accounts/types.ts"],"names":[],"mappings":"AAAA;;;GAGG","sourcesContent":["/**\n * Accounts API types for the API Platform Client.\n * API: accounts.api.cx.metamask.io\n */\n\nimport type { PageInfo } from '../shared-types';\n\n// ============================================================================\n// BALANCE TYPES\n// ============================================================================\n\n/** V5 Balance Item from Accounts API */\nexport type V5BalanceItem = {\n  object: 'token';\n  symbol: string;\n  name: string;\n  type: 'native' | 'erc20';\n  decimals: number;\n  assetId: string;\n  balance: string;\n  accountId: string;\n};\n\n/** V5 Multi-account balances response */\nexport type V5BalancesResponse = {\n  count: number;\n  unprocessedNetworks: string[];\n  balances: V5BalanceItem[];\n};\n\n/** V2 Balance item */\nexport type V2BalanceItem = {\n  object: string;\n  type?: string;\n  timestamp?: string;\n  address: string;\n  symbol: string;\n  name: string;\n  decimals: number;\n  chainId: number;\n  balance: string;\n  accountAddress?: string;\n};\n\n/** V2 Balances response */\nexport type V2BalancesResponse = {\n  count: number;\n  balances: V2BalanceItem[];\n  unprocessedNetworks: number[];\n};\n\n/** V4 Multi-account balances response */\nexport type V4BalancesResponse = {\n  count: number;\n  balances: V2BalanceItem[];\n  unprocessedNetworks: number[];\n};\n\n// ============================================================================\n// SUPPORTED NETWORKS TYPES\n// ============================================================================\n\n/** V1 Supported networks response */\nexport type V1SupportedNetworksResponse = {\n  supportedNetworks: number[];\n};\n\n/** V2 Supported networks response */\nexport type V2SupportedNetworksResponse = {\n  fullSupport: number[];\n  partialSupport: {\n    balances: number[];\n  };\n};\n\n/** Active networks response */\nexport type V2ActiveNetworksResponse = {\n  activeNetworks: string[];\n};\n\n// ============================================================================\n// TRANSACTION TYPES\n// ============================================================================\n\n/** Transaction by hash response */\nexport type V1TransactionByHashResponse = {\n  hash: string;\n  timestamp: string;\n  chainId: number;\n  blockNumber: number;\n  blockHash: string;\n  gas: number;\n  gasUsed: number;\n  gasPrice: string;\n  effectiveGasPrice: string;\n  nonce: number;\n  cumulativeGasUsed: number;\n  methodId?: string;\n  value: string;\n  to: string;\n  from: string;\n  isError?: boolean;\n  valueTransfers?: {\n    from: string;\n    to: string;\n    amount: string;\n    decimal: number;\n    contractAddress: string;\n    symbol: string;\n    name: string;\n    transferType: string;\n  }[];\n  logs?: {\n    data: string;\n    topics: string[];\n    address: string;\n    logIndex: number;\n  }[];\n  transactionType?: string;\n  transactionCategory?: string;\n  transactionProtocol?: string;\n};\n\n/** Account transactions response */\nexport type V1AccountTransactionsResponse = {\n  data: V1TransactionByHashResponse[];\n  pageInfo: PageInfo;\n};\n\n/** V4 Multi-account transactions response */\nexport type V4MultiAccountTransactionsResponse = {\n  unprocessedNetworks: string[];\n  pageInfo: {\n    count: number;\n    hasNextPage: boolean;\n    endCursor?: string;\n  };\n  data: V1TransactionByHashResponse[];\n};\n\n// ============================================================================\n// RELATIONSHIP TYPES\n// ============================================================================\n\n/**\n * Value transfer within a transaction\n */\nexport type ValueTransfer = {\n  from: string;\n  to: string;\n  amount: string;\n  decimal: number;\n  transferType: string;\n};\n\n/**\n * Account address relationship result from v1 endpoint\n */\nexport type V1AccountRelationshipResult = {\n  /** Transaction hash of the relationship */\n  txHash?: string;\n  /** Chain ID */\n  chainId?: number;\n  /** Number of interactions */\n  count?: number;\n  /** Transaction data details */\n  data?: {\n    hash: string;\n    timestamp: string;\n    chainId: number;\n    blockNumber: number;\n    blockHash: string;\n    gas: number;\n    gasUsed: number;\n    gasPrice: string;\n    effectiveGasPrice: string;\n    nonce: number;\n    cumulativeGasUsed: number;\n    methodId: string;\n    value: string;\n    to: string;\n    from: string;\n    isError: boolean;\n    valueTransfers: ValueTransfer[];\n    logs: unknown[];\n    transactionType: string;\n    transactionCategory: string;\n    readable: string;\n    textFunctionSignature: string;\n  };\n  /** Error information when relationship lookup fails */\n  error?: {\n    code: string;\n    message: string;\n  };\n};\n\n// ============================================================================\n// NFT TYPES\n// ============================================================================\n\n/** NFT item */\nexport type NftItem = {\n  tokenId: string;\n  contractAddress: string;\n  chainId: number;\n  name?: string;\n  description?: string;\n  imageUrl?: string;\n  attributes?: Record<string, unknown>[];\n};\n\n/** NFTs response */\nexport type V2NftsResponse = {\n  data: NftItem[];\n  pageInfo: PageInfo;\n};\n\n// ============================================================================\n// TOKEN DISCOVERY TYPES\n// ============================================================================\n\n/** Token discovery item */\nexport type TokenDiscoveryItem = {\n  address: string;\n  chainId: number;\n  symbol: string;\n  name: string;\n  decimals: number;\n  balance?: string;\n};\n\n/** Tokens response */\nexport type V2TokensResponse = {\n  data: TokenDiscoveryItem[];\n};\n"]}

package/dist/api/base-client.cjs

@@ -0,0 +1,149 @@
+"use strict";
+/**
+ * Base API Client - Shared HTTP functionality for all API clients.
+ */
+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 __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 _BaseApiClient_queryClientInstance;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpError = exports.GC_TIMES = exports.STALE_TIMES = exports.API_URLS = exports.BaseApiClient = exports.authQueryKeys = void 0;
+const query_core_1 = require("@tanstack/query-core");
+const shared_types_1 = require("./shared-types.cjs");
+Object.defineProperty(exports, "API_URLS", { enumerable: true, get: function () { return shared_types_1.API_URLS; } });
+Object.defineProperty(exports, "STALE_TIMES", { enumerable: true, get: function () { return shared_types_1.STALE_TIMES; } });
+Object.defineProperty(exports, "GC_TIMES", { enumerable: true, get: function () { return shared_types_1.GC_TIMES; } });
+Object.defineProperty(exports, "HttpError", { enumerable: true, get: function () { return shared_types_1.HttpError; } });
+// Auth query keys - shared for token management across clients
+exports.authQueryKeys = {
+    bearerToken: () => ['auth', 'bearerToken'],
+};
+/**
+ * Base API Client with shared HTTP and caching functionality.
+ * Extended by all specific API clients.
+ */
+class BaseApiClient {
+    /**
+     * Get the underlying QueryClient instance.
+     * Exposed for cache management operations.
+     *
+     * @returns The QueryClient instance.
+     */
+    get queryClient() {
+        return __classPrivateFieldGet(this, _BaseApiClient_queryClientInstance, "f");
+    }
+    /**
+     * 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, _BaseApiClient_queryClientInstance, "f").resetQueries({
+            queryKey: exports.authQueryKeys.bearerToken(),
+        });
+    }
+    constructor(options) {
+        _BaseApiClient_queryClientInstance.set(this, void 0);
+        this.clientProduct = options.clientProduct;
+        this.clientVersion = options.clientVersion ?? '1.0.0';
+        this.getBearerToken = options.getBearerToken;
+        __classPrivateFieldSet(this, _BaseApiClient_queryClientInstance, options.queryClient ??
+            new query_core_1.QueryClient({
+                defaultOptions: {
+                    queries: {
+                        staleTime: shared_types_1.STALE_TIMES.DEFAULT,
+                        gcTime: shared_types_1.GC_TIMES.DEFAULT,
+                        retry: shared_types_1.shouldRetry,
+                        retryDelay: shared_types_1.calculateRetryDelay,
+                        refetchOnWindowFocus: false,
+                        networkMode: 'always',
+                    },
+                },
+            }), "f");
+    }
+    /**
+     * Internal HTTP fetch method with authentication and error handling.
+     *
+     * @param baseUrl - The base URL for the API.
+     * @param path - The API endpoint path.
+     * @param options - Optional fetch configuration.
+     * @returns The parsed JSON response.
+     */
+    async fetch(baseUrl, path, options) {
+        const url = new URL(path, baseUrl);
+        if (options?.params) {
+            for (const [key, value] of Object.entries(options.params)) {
+                if (value === undefined) {
+                    continue;
+                }
+                if (Array.isArray(value)) {
+                    // Convert array values (including number[]) to comma-separated string
+                    url.searchParams.set(key, value.map(String).join(','));
+                }
+                else {
+                    url.searchParams.set(key, String(value));
+                }
+            }
+        }
+        const headers = {
+            'Content-Type': 'application/json',
+            'X-Client-Product': this.clientProduct,
+            'X-Client-Version': this.clientVersion,
+        };
+        // Get bearer token using fetchQuery for automatic deduplication
+        if (this.getBearerToken) {
+            const queryKey = exports.authQueryKeys.bearerToken();
+            const { getBearerToken } = this;
+            try {
+                // fetchQuery handles caching and deduplicates concurrent requests
+                const token = await __classPrivateFieldGet(this, _BaseApiClient_queryClientInstance, "f").fetchQuery({
+                    queryKey,
+                    queryFn: async () => {
+                        const result = await getBearerToken();
+                        // Throw if no token - prevents caching null/undefined
+                        // so subsequent requests can retry (e.g., after user logs in)
+                        if (!result) {
+                            throw new Error('No bearer token available');
+                        }
+                        return result;
+                    },
+                    staleTime: shared_types_1.STALE_TIMES.AUTH_TOKEN,
+                    retry: false, // Don't retry auth failures
+                });
+                headers.Authorization = `Bearer ${token}`;
+            }
+            catch {
+                // No token available - continue without auth header
+            }
+        }
+        const response = await fetch(url.toString(), {
+            method: 'GET',
+            headers,
+            signal: options?.signal,
+        });
+        if (!response.ok) {
+            let body;
+            try {
+                body = await response.json();
+            }
+            catch {
+                // Response body is not JSON or is empty, leave body as undefined
+            }
+            throw new shared_types_1.HttpError(`HTTP ${response.status}: ${response.statusText}`, response.status, response.statusText, url.toString(), body);
+        }
+        return response.json();
+    }
+}
+exports.BaseApiClient = BaseApiClient;
+_BaseApiClient_queryClientInstance = new WeakMap();
+//# sourceMappingURL=base-client.cjs.map

package/dist/api/base-client.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-client.cjs","sourceRoot":"","sources":["../../src/api/base-client.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Base API Client - Shared HTTP functionality for all API clients.\n */\n\nimport { QueryClient } from '@tanstack/query-core';\nimport type { QueryKey } from '@tanstack/query-core';\n\nimport {\n  API_URLS,\n  STALE_TIMES,\n  GC_TIMES,\n  calculateRetryDelay,\n  shouldRetry,\n  HttpError,\n} from './shared-types';\nimport type { ApiPlatformClientOptions } from './shared-types';\n\n// Auth query keys - shared for token management across clients\nexport const authQueryKeys = {\n  bearerToken: (): QueryKey => ['auth', 'bearerToken'],\n} as const;\n\nexport type { ApiPlatformClientOptions };\n\n/**\n * Internal fetch options for HTTP requests.\n */\nexport type InternalFetchOptions = {\n  signal?: AbortSignal;\n  params?: Record<\n    string,\n    string | string[] | number | number[] | boolean | undefined\n  >;\n};\n\n/**\n * Base API Client with shared HTTP and caching functionality.\n * Extended by all specific API clients.\n */\nexport class BaseApiClient {\n  protected readonly clientProduct: string;\n\n  protected readonly clientVersion: string;\n\n  protected readonly getBearerToken?: () => Promise<string | undefined>;\n\n  readonly #queryClientInstance: QueryClient;\n\n  /**\n   * Get the underlying QueryClient instance.\n   * Exposed for cache management operations.\n   *\n   * @returns The QueryClient instance.\n   */\n  get queryClient(): QueryClient {\n    return this.#queryClientInstance;\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.#queryClientInstance.resetQueries({\n      queryKey: authQueryKeys.bearerToken(),\n    });\n  }\n\n  constructor(options: ApiPlatformClientOptions) {\n    this.clientProduct = options.clientProduct;\n    this.clientVersion = options.clientVersion ?? '1.0.0';\n    this.getBearerToken = options.getBearerToken;\n\n    this.#queryClientInstance =\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\n  /**\n   * Internal HTTP fetch method with authentication and error handling.\n   *\n   * @param baseUrl - The base URL for the API.\n   * @param path - The API endpoint path.\n   * @param options - Optional fetch configuration.\n   * @returns The parsed JSON response.\n   */\n  protected async fetch<ResponseType>(\n    baseUrl: string,\n    path: string,\n    options?: InternalFetchOptions,\n  ): Promise<ResponseType> {\n    const url = new URL(path, baseUrl);\n\n    if (options?.params) {\n      for (const [key, value] of Object.entries(options.params)) {\n        if (value === undefined) {\n          continue;\n        }\n        if (Array.isArray(value)) {\n          // Convert array values (including number[]) to comma-separated string\n          url.searchParams.set(key, value.map(String).join(','));\n        } else {\n          url.searchParams.set(key, String(value));\n        }\n      }\n    }\n\n    const headers: Record<string, string> = {\n      'Content-Type': 'application/json',\n      'X-Client-Product': this.clientProduct,\n      'X-Client-Version': this.clientVersion,\n    };\n\n    // Get bearer token using fetchQuery for automatic deduplication\n    if (this.getBearerToken) {\n      const queryKey = authQueryKeys.bearerToken();\n      const { getBearerToken } = this;\n\n      try {\n        // fetchQuery handles caching and deduplicates concurrent requests\n        const token = await this.#queryClientInstance.fetchQuery({\n          queryKey,\n          queryFn: async () => {\n            const result = await getBearerToken();\n            // Throw if no token - prevents caching null/undefined\n            // so subsequent requests can retry (e.g., after user logs in)\n            if (!result) {\n              throw new Error('No bearer token available');\n            }\n            return result;\n          },\n          staleTime: STALE_TIMES.AUTH_TOKEN,\n          retry: false, // Don't retry auth failures\n        });\n\n        headers.Authorization = `Bearer ${token}`;\n      } catch {\n        // No token available - continue without auth header\n      }\n    }\n\n    const response = await fetch(url.toString(), {\n      method: 'GET',\n      headers,\n      signal: options?.signal,\n    });\n\n    if (!response.ok) {\n      let body: unknown;\n      try {\n        body = await response.json();\n      } catch {\n        // Response body is not JSON or is empty, leave body as undefined\n      }\n      throw new HttpError(\n        `HTTP ${response.status}: ${response.statusText}`,\n        response.status,\n        response.statusText,\n        url.toString(),\n        body,\n      );\n    }\n\n    return response.json() as Promise<ResponseType>;\n  }\n}\n\n// Re-export constants for use by API clients\nexport { API_URLS, STALE_TIMES, GC_TIMES, HttpError };\n"]}

package/dist/api/base-client.d.cts

@@ -0,0 +1,54 @@
+/**
+ * Base API Client - Shared HTTP functionality for all API clients.
+ */
+import { QueryClient } from "@tanstack/query-core";
+import { API_URLS, STALE_TIMES, GC_TIMES, HttpError } from "./shared-types.cjs";
+import type { ApiPlatformClientOptions } from "./shared-types.cjs";
+export declare const authQueryKeys: {
+    readonly bearerToken: () => readonly unknown[];
+};
+export type { ApiPlatformClientOptions };
+/**
+ * Internal fetch options for HTTP requests.
+ */
+export type InternalFetchOptions = {
+    signal?: AbortSignal;
+    params?: Record<string, string | string[] | number | number[] | boolean | undefined>;
+};
+/**
+ * Base API Client with shared HTTP and caching functionality.
+ * Extended by all specific API clients.
+ */
+export declare class BaseApiClient {
+    #private;
+    protected readonly clientProduct: string;
+    protected readonly clientVersion: string;
+    protected readonly getBearerToken?: () => Promise<string | undefined>;
+    /**
+     * Get the underlying QueryClient instance.
+     * Exposed for cache management operations.
+     *
+     * @returns The QueryClient instance.
+     */
+    get queryClient(): QueryClient;
+    /**
+     * 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>;
+    constructor(options: ApiPlatformClientOptions);
+    /**
+     * Internal HTTP fetch method with authentication and error handling.
+     *
+     * @param baseUrl - The base URL for the API.
+     * @param path - The API endpoint path.
+     * @param options - Optional fetch configuration.
+     * @returns The parsed JSON response.
+     */
+    protected fetch<ResponseType>(baseUrl: string, path: string, options?: InternalFetchOptions): Promise<ResponseType>;
+}
+export { API_URLS, STALE_TIMES, GC_TIMES, HttpError };
+//# sourceMappingURL=base-client.d.cts.map

package/dist/api/base-client.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-client.d.cts","sourceRoot":"","sources":["../../src/api/base-client.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,6BAA6B;AAGnD,OAAO,EACL,QAAQ,EACR,WAAW,EACX,QAAQ,EAGR,SAAS,EACV,2BAAuB;AACxB,OAAO,KAAK,EAAE,wBAAwB,EAAE,2BAAuB;AAG/D,eAAO,MAAM,aAAa;;CAEhB,CAAC;AAEX,YAAY,EAAE,wBAAwB,EAAE,CAAC;AAEzC;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CACb,MAAM,EACN,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,GAAG,SAAS,CAC5D,CAAC;CACH,CAAC;AAEF;;;GAGG;AACH,qBAAa,aAAa;;IACxB,SAAS,CAAC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAEzC,SAAS,CAAC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAEzC,SAAS,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAItE;;;;;OAKG;IACH,IAAI,WAAW,IAAI,WAAW,CAE7B;IAED;;;;;;OAMG;IACG,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;gBAM9B,OAAO,EAAE,wBAAwB;IAqB7C;;;;;;;OAOG;cACa,KAAK,CAAC,YAAY,EAChC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,YAAY,CAAC;CA2EzB;AAGD,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC"}