@metamask-previews/base-data-service 1.0.0-preview-abca9bcea → 1.0.0-preview-8bfa290fb

package/CHANGELOG.md

@@ -7,6 +7,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Added
+
+- Add `executeMutation` protected method to `BaseDataService` to allow for making server-state-mutating requests ([#9324](https://github.com/MetaMask/core/pull/9324))
+  - These kinds of requests are never retried, unlike queries.
+  - To use this, create a method in your data service class which takes whatever arguments you need, plus a optional final argument called `globalId`; then call `executeMutation` with a `mutationKey`, `globalId`, and `mutationFn`. See `ExampleDataService` in this package for an example.
+  - A `MutationKey` type is also available.
+- The payload for `:cacheUpdated` and `:cacheUpdated:${hash}` events now includes an `objectType` property, which is either "query" or "mutation" ([#9324](https://github.com/MetaMask/core/pull/9324))
+
 ### Changed
 
 - Bump `@metamask/utils` from `^11.11.0` to `^11.12.0` ([#10076](https://github.com/MetaMask/core/pull/10076))

package/dist/BaseDataService.cjs

@@ -13,7 +13,7 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
-var _BaseDataService_instances, _BaseDataService_messenger, _BaseDataService_externalMessenger, _BaseDataService_policy, _BaseDataService_queryClient, _BaseDataService_queryCacheUnsubscribe, _BaseDataService_debouncedPersist, _BaseDataService_persistenceConfig, _BaseDataService_publishCacheUpdate, _BaseDataService_persistCache, _BaseDataService_loadCache;
+var _BaseDataService_instances, _BaseDataService_messenger, _BaseDataService_externalMessenger, _BaseDataService_policy, _BaseDataService_queryClient, _BaseDataService_queryCacheUnsubscribe, _BaseDataService_mutationCacheUnsubscribe, _BaseDataService_debouncedPersist, _BaseDataService_persistenceConfig, _BaseDataService_publishCacheUpdate, _BaseDataService_persistCache, _BaseDataService_loadCache;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BaseDataService = exports.STORAGE_SERVICE_KEY = void 0;
 const messenger_1 = require("@metamask/messenger");
@@ -23,13 +23,20 @@ const query_core_1 = require("@tanstack/query-core");
 const fast_deep_equal_1 = __importDefault(require("fast-deep-equal"));
 const lodash_1 = require("lodash");
 const createServicePolicy_js_1 = require("./createServicePolicy.cjs");
+const loggers_js_1 = require("./loggers.cjs");
 const utils_js_1 = require("./utils.cjs");
-// Defaults to apply to all data service queries if no default option specified
+const log = (0, loggers_js_1.createModuleLogger)(loggers_js_1.projectLogger, 'BaseDataService');
+/*
+ * Defaults to apply to all data service queries if no default option specified.
+ */
 const QUERY_CLIENT_DEFAULTS = {
     queries: {
         retry: false,
         staleTime: (0, utils_1.inMilliseconds)(1, utils_1.Duration.Minute),
     },
+    mutations: {
+        retry: false,
+    },
 };
 exports.STORAGE_SERVICE_KEY = 'cache';
 class BaseDataService {
@@ -40,6 +47,7 @@ class BaseDataService {
         _BaseDataService_policy.set(this, void 0);
         _BaseDataService_queryClient.set(this, void 0);
         _BaseDataService_queryCacheUnsubscribe.set(this, void 0);
+        _BaseDataService_mutationCacheUnsubscribe.set(this, void 0);
         _BaseDataService_debouncedPersist.set(this, void 0);
         _BaseDataService_persistenceConfig.set(this, void 0);
         this.name = name;
@@ -57,7 +65,10 @@ class BaseDataService {
                     ...QUERY_CLIENT_DEFAULTS.queries,
                     ...queryClientConfig.defaultOptions?.queries,
                 },
-                mutations: queryClientConfig.defaultOptions?.mutations,
+                mutations: {
+                    ...QUERY_CLIENT_DEFAULTS.mutations,
+                    ...queryClientConfig.defaultOptions?.mutations,
+                },
             },
         }), "f");
         __classPrivateFieldSet(this, _BaseDataService_persistenceConfig, persistenceConfig, "f");
@@ -75,8 +86,21 @@ class BaseDataService {
         __classPrivateFieldSet(this, _BaseDataService_queryCacheUnsubscribe, __classPrivateFieldGet(this, _BaseDataService_queryClient, "f")
             .getQueryCache()
             .subscribe((event) => {
+            log('Query cache event emitted', event);
             if (['added', 'updated', 'removed'].includes(event.type)) {
-                __classPrivateFieldGet(this, _BaseDataService_instances, "m", _BaseDataService_publishCacheUpdate).call(this, event.query.queryHash, event.type);
+                __classPrivateFieldGet(this, _BaseDataService_instances, "m", _BaseDataService_publishCacheUpdate).call(this, 'query', event.type, event.query.queryHash);
+                __classPrivateFieldGet(this, _BaseDataService_debouncedPersist, "f")?.call(this);
+            }
+        }), "f");
+        log('Subscribing to mutation cache');
+        __classPrivateFieldSet(this, _BaseDataService_mutationCacheUnsubscribe, __classPrivateFieldGet(this, _BaseDataService_queryClient, "f")
+            .getMutationCache()
+            .subscribe((event) => {
+            log('Mutation cache event emitted', event);
+            if (['added', 'updated', 'removed'].includes(event.type) &&
+                event.mutation?.options.mutationKey !== undefined) {
+                const mutationHash = (0, query_core_1.hashKey)(event.mutation.options.mutationKey);
+                __classPrivateFieldGet(this, _BaseDataService_instances, "m", _BaseDataService_publishCacheUpdate).call(this, 'mutation', event.type, mutationHash);
                 __classPrivateFieldGet(this, _BaseDataService_debouncedPersist, "f")?.call(this);
             }
         }), "f");
@@ -87,14 +111,15 @@ class BaseDataService {
      *
      * @param options - The options defining the query. Keep in mind that `queryKey` and `queryFn` are required when using data services.
      * Additionally `retry` and `retryDelay` are not available, retries can be customized using the `servicePolicyOptions`.
+     * @param options.queryFn - The query function.
      * @param options.responseStruct - An optional struct for validating the response of the query function.
      * @returns The query results.
      */
-    async fetchQuery({ responseStruct, ...options }) {
+    async fetchQuery({ queryFn, responseStruct, ...options }) {
         return __classPrivateFieldGet(this, _BaseDataService_queryClient, "f").fetchQuery({
             ...options,
             queryFn: async (context) => {
-                const response = await __classPrivateFieldGet(this, _BaseDataService_policy, "f").execute(() => options.queryFn(context));
+                const response = await __classPrivateFieldGet(this, _BaseDataService_policy, "f").execute(() => queryFn(context));
                 return (0, utils_js_1.processQueryResponse)(options.queryKey, response, responseStruct);
             },
         });
@@ -134,6 +159,43 @@ class BaseDataService {
         const pageIndex = result.pageParams.findIndex((param) => (0, fast_deep_equal_1.default)(param, pageParam));
         return result.pages[pageIndex];
     }
+    /**
+     * Execute a mutation (e.g. a request that is expected to change server-side data).
+     * Unlike `fetchQuery`, the request will not be cached or retried.
+     *
+     * @param options - The options defining the mutation. Keep in mind that `mutationKey` and `mutationFn` are required when using data services.
+     * Additionally, `retry` and `retryDelay` are not available.
+     * @param options.mutationFn - The mutation function.
+     * @param options.responseStruct - An optional struct for validating the response of the mutation function.
+     * @param options.globalId - A string which uniquely identifies this mutation
+     * across different query clients — specifically, the one in this data service
+     * and the one that `createUIQueryClient` in `@metamask/react-data-query`
+     * holds (in fact usually you don't need to pass this — `createUIQueryClient`
+     * will do it automatically). This global ID will be stored in the new
+     * mutation `meta` data and included in `:cacheUpdated` payloads.
+     * @returns The mutation results.
+     */
+    async executeMutation({ mutationFn, responseStruct, globalId, ...options }) {
+        const mutationCache = __classPrivateFieldGet(this, _BaseDataService_queryClient, "f").getMutationCache();
+        const mutation = mutationCache.build(__classPrivateFieldGet(this, _BaseDataService_queryClient, "f"), {
+            ...options,
+            ...(globalId !== undefined && {
+                meta: { ...options.meta, globalId },
+            }),
+            mutationFn: async (...args) => {
+                // To guard against mutations being retried, we deliberately execute the
+                // mutation function through the circuit breaker policy alone, rather
+                // than through `this.#policy` (which is a combination of both a
+                // circuit breaker policy and retry policy).
+                const response = await __classPrivateFieldGet(this, _BaseDataService_policy, "f").circuitBreakerPolicy.execute(() => mutationFn(...args));
+                return (0, utils_js_1.processMutationResponse)(options.mutationKey, response, responseStruct);
+            },
+        });
+        // We purposely pass an empty set of variables because this method is
+        // intended to be used internally by the data service, not end users, and
+        // the data service has full control of `mutationFn` anyway.
+        return await mutation.execute({});
+    }
     /**
      * Invalidate queries serviced by this data service.
      *
@@ -159,25 +221,38 @@ class BaseDataService {
     destroy() {
         __classPrivateFieldGet(this, _BaseDataService_debouncedPersist, "f")?.cancel();
         __classPrivateFieldGet(this, _BaseDataService_queryCacheUnsubscribe, "f").call(this);
+        __classPrivateFieldGet(this, _BaseDataService_mutationCacheUnsubscribe, "f").call(this);
+        // `QueryClient.clear()` clears both caches, but `MutationCache.clear()`
+        // only drops its references to mutations without clearing their pending
+        // garbage-collection timers. We destroy each mutation first so those timers
+        // are cleared and do not keep the process alive.
+        for (const mutation of __classPrivateFieldGet(this, _BaseDataService_queryClient, "f").getMutationCache().getAll()) {
+            mutation.destroy();
+        }
         __classPrivateFieldGet(this, _BaseDataService_queryClient, "f").clear();
         this.messenger.clearSubscriptions();
         this.messenger.clearActions();
     }
 }
 exports.BaseDataService = BaseDataService;
-_BaseDataService_messenger = new WeakMap(), _BaseDataService_externalMessenger = new WeakMap(), _BaseDataService_policy = new WeakMap(), _BaseDataService_queryClient = new WeakMap(), _BaseDataService_queryCacheUnsubscribe = new WeakMap(), _BaseDataService_debouncedPersist = new WeakMap(), _BaseDataService_persistenceConfig = new WeakMap(), _BaseDataService_instances = new WeakSet(), _BaseDataService_publishCacheUpdate = function _BaseDataService_publishCacheUpdate(hash, type) {
-    const state = type === 'added' || type === 'updated'
+_BaseDataService_messenger = new WeakMap(), _BaseDataService_externalMessenger = new WeakMap(), _BaseDataService_policy = new WeakMap(), _BaseDataService_queryClient = new WeakMap(), _BaseDataService_queryCacheUnsubscribe = new WeakMap(), _BaseDataService_mutationCacheUnsubscribe = new WeakMap(), _BaseDataService_debouncedPersist = new WeakMap(), _BaseDataService_persistenceConfig = new WeakMap(), _BaseDataService_instances = new WeakSet(), _BaseDataService_publishCacheUpdate = function _BaseDataService_publishCacheUpdate(objectType, eventType, hash) {
+    const state = eventType === 'added' || eventType === 'updated'
         ? (0, query_core_1.dehydrate)(__classPrivateFieldGet(this, _BaseDataService_queryClient, "f"), {
-            shouldDehydrateQuery: (query) => query.queryHash === hash,
+            shouldDehydrateQuery: (query) => objectType === 'query' && query.queryHash === hash,
+            shouldDehydrateMutation: (mutation) => objectType === 'mutation' &&
+                mutation.options.mutationKey !== undefined &&
+                (0, query_core_1.hashKey)(mutation.options.mutationKey) === hash,
         })
         : null;
     __classPrivateFieldGet(this, _BaseDataService_messenger, "f").publish(`${this.name}:cacheUpdated`, {
-        type,
+        type: eventType,
+        objectType,
         hash,
         state,
     });
     __classPrivateFieldGet(this, _BaseDataService_messenger, "f").publish(`${this.name}:cacheUpdated:${hash}`, {
-        type,
+        type: eventType,
+        objectType,
         state,
     });
 }, _BaseDataService_persistCache = 

package/dist/BaseDataService.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"BaseDataService.cjs","sourceRoot":"","sources":["../src/BaseDataService.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  Messenger,\n  ActionConstraint,\n  EventConstraint,\n  MessengerActions,\n  MessengerEvents,\n} from '@metamask/messenger';\nimport type {\n  StorageServiceGetItemAction,\n  StorageServiceRemoveItemAction,\n  StorageServiceSetItemAction,\n} from '@metamask/storage-service';\nimport { Struct } from '@metamask/superstruct';\nimport { Duration, inMilliseconds } from '@metamask/utils';\nimport type { Json } from '@metamask/utils';\nimport {\n  DefaultError,\n  DefaultOptions,\n  DehydratedState,\n  FetchQueryOptions,\n  InfiniteData,\n  InfiniteQueryPageParamsOptions,\n  InvalidateOptions,\n  InvalidateQueryFilters,\n  OmitKeyof,\n  QueryClient,\n  QueryClientConfig,\n  QueryFunction,\n  WithRequired,\n  dehydrate,\n  hydrate,\n} from '@tanstack/query-core';\nimport deepEqual from 'fast-deep-equal';\nimport { debounce, DebouncedFunc } from 'lodash';\n\nimport {\n  createServicePolicy,\n  CreateServicePolicyOptions,\n  ServicePolicy,\n} from './createServicePolicy.js';\nimport { processQueryResponse } from './utils.js';\n\n// Data service queries use the following format: ['ServiceActionName', ...params]\nexport type QueryKey = [string, ...Json[]] | readonly [string, ...Json[]];\n\n/**\n * The supertype of all messengers, scoped to a namespace.\n *\n * @template Namespace - The namespace for the messenger's own actions and\n * events.\n */\nexport type BaseMessenger<Namespace extends string> = Messenger<\n  Namespace,\n  ActionConstraint,\n  EventConstraint,\n  // Use `any` to allow any parent to be set. `any` is harmless in a type constraint anyway,\n  // it's the one totally safe place to use it.\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  any\n>;\n\nexport type DataServiceGranularCacheUpdatedPayload =\n  | { type: 'added' | 'updated'; state: DehydratedState }\n  | {\n      type: 'removed';\n      state: null;\n    };\n\nexport type DataServiceCacheUpdatedPayload =\n  DataServiceGranularCacheUpdatedPayload & {\n    hash: string;\n  };\n\ntype CacheUpdatedType = DataServiceCacheUpdatedPayload['type'];\n\nexport type DataServiceInvalidateQueriesAction<ServiceName extends string> = {\n  type: `${ServiceName}:invalidateQueries`;\n  handler: BaseDataService<\n    ServiceName,\n    BaseMessenger<ServiceName>\n  >['invalidateQueries'];\n};\n\nexport type DataServiceActions<ServiceName extends string> =\n  DataServiceInvalidateQueriesAction<ServiceName>;\n\ntype DataServiceAllowedActions =\n  | StorageServiceGetItemAction\n  | StorageServiceSetItemAction\n  | StorageServiceRemoveItemAction;\n\nexport type DataServiceCacheUpdatedEvent<ServiceName extends string> = {\n  type: `${ServiceName}:cacheUpdated`;\n  payload: [DataServiceCacheUpdatedPayload];\n};\n\nexport type DataServiceGranularCacheUpdatedEvent<ServiceName extends string> = {\n  type: `${ServiceName}:cacheUpdated:${string}`;\n  payload: [DataServiceGranularCacheUpdatedPayload];\n};\n\nexport type DataServiceEvents<ServiceName extends string> =\n  | DataServiceCacheUpdatedEvent<ServiceName>\n  | DataServiceGranularCacheUpdatedEvent<ServiceName>;\n\n// Defaults to apply to all data service queries if no default option specified\nconst QUERY_CLIENT_DEFAULTS: DefaultOptions = {\n  queries: {\n    retry: false,\n    staleTime: inMilliseconds(1, Duration.Minute),\n  },\n};\n\nexport const STORAGE_SERVICE_KEY = 'cache';\n\n/**\n * Options for persistence configuration.\n */\nexport type PersistenceConfiguration = {\n  /**\n   * The maximum age before the cache is treated as expired in milliseconds.\n   * This is relevant for rehydrating the state during initialization,\n   * if the cached state is too old it will be discarded.\n   */\n  maxAge: number;\n  /**\n   * The number of milliseconds to wait before triggering persistence following a cache update.\n   */\n  writeDelay?: number;\n  /**\n   * The maximum number of milliseconds to wait between persistence writes.\n   */\n  maxWriteDelay?: number;\n};\n\ntype PersistedCache = {\n  state: DehydratedState;\n  timestamp: number;\n};\n\nexport class BaseDataService<\n  ServiceName extends string,\n  ServiceMessenger extends BaseMessenger<ServiceName>,\n> {\n  public readonly name: ServiceName;\n\n  readonly #messenger: Messenger<\n    ServiceName,\n    DataServiceActions<ServiceName>,\n    DataServiceEvents<ServiceName>\n  >;\n\n  readonly #externalMessenger: Messenger<\n    ServiceName,\n    DataServiceAllowedActions\n  >;\n\n  protected messenger: ServiceMessenger;\n\n  readonly #policy: ServicePolicy;\n\n  readonly #queryClient: QueryClient;\n\n  readonly #queryCacheUnsubscribe: () => void;\n\n  readonly #debouncedPersist?: DebouncedFunc<() => void>;\n\n  readonly #persistenceConfig?: PersistenceConfiguration;\n\n  constructor({\n    name,\n    messenger,\n    queryClientConfig = {},\n    policyOptions,\n    persistenceConfig,\n  }: {\n    name: ServiceName;\n    messenger: DataServiceActions<ServiceName>['type'] extends\n      | MessengerActions<ServiceMessenger>['type']\n      | DataServiceAllowedActions['type']\n      ? DataServiceEvents<ServiceName>['type'] extends MessengerEvents<ServiceMessenger>['type']\n        ? ServiceMessenger\n        : never\n      : never;\n    queryClientConfig?: QueryClientConfig;\n    policyOptions?: CreateServicePolicyOptions;\n    persistenceConfig?: PersistenceConfiguration;\n  }) {\n    this.name = name;\n\n    // We store two narrowly-typed messengers alongside the generic public one:\n    // - #messenger handles the service's own action registration and event publishing\n    // - #externalMessenger handles calls to external actions\n    // Splitting them avoids TypeScript issues with mixing template-literals with regular strings\n    this.#messenger = messenger as unknown as Messenger<\n      ServiceName,\n      DataServiceActions<ServiceName>,\n      DataServiceEvents<ServiceName>\n    >;\n    this.#externalMessenger = messenger as unknown as Messenger<\n      ServiceName,\n      DataServiceAllowedActions\n    >;\n    this.messenger = messenger;\n\n    this.#queryClient = new QueryClient({\n      ...queryClientConfig,\n      defaultOptions: {\n        queries: {\n          ...QUERY_CLIENT_DEFAULTS.queries,\n          ...queryClientConfig.defaultOptions?.queries,\n        },\n        mutations: queryClientConfig.defaultOptions?.mutations,\n      },\n    });\n\n    this.#persistenceConfig = persistenceConfig;\n\n    this.#policy = createServicePolicy(policyOptions);\n\n    this.#debouncedPersist =\n      this.#persistenceConfig &&\n      debounce(\n        () => {\n          this.#persistCache().catch(\n            /* istanbul ignore next */\n            (error) => this.#messenger.captureException?.(error),\n          );\n        },\n        this.#persistenceConfig.writeDelay ??\n          inMilliseconds(10, Duration.Second),\n        {\n          maxWait:\n            this.#persistenceConfig.maxWriteDelay ??\n            inMilliseconds(1, Duration.Minute),\n        },\n      );\n\n    this.#queryCacheUnsubscribe = this.#queryClient\n      .getQueryCache()\n      .subscribe((event) => {\n        if (['added', 'updated', 'removed'].includes(event.type)) {\n          this.#publishCacheUpdate(\n            event.query.queryHash,\n            event.type as CacheUpdatedType,\n          );\n\n          this.#debouncedPersist?.();\n        }\n      });\n\n    this.#messenger.registerActionHandler(\n      `${this.name}:invalidateQueries`,\n      this.invalidateQueries.bind(this),\n    );\n  }\n\n  /**\n   * Fetch a query.\n   *\n   * @param options - The options defining the query. Keep in mind that `queryKey` and `queryFn` are required when using data services.\n   * Additionally `retry` and `retryDelay` are not available, retries can be customized using the `servicePolicyOptions`.\n   * @param options.responseStruct - An optional struct for validating the response of the query function.\n   * @returns The query results.\n   */\n  protected async fetchQuery<\n    TQueryFnData extends Json,\n    TError = DefaultError,\n    TDataStruct extends Struct<TQueryFnData> | undefined = undefined,\n    TData = TDataStruct extends Struct<infer StructType>\n      ? StructType\n      : TQueryFnData,\n    TQueryKey extends QueryKey = QueryKey,\n  >({\n    responseStruct,\n    ...options\n  }: WithRequired<\n    OmitKeyof<\n      FetchQueryOptions<TQueryFnData, TError, TData, TQueryKey>,\n      'retry' | 'retryDelay' | 'queryFn'\n    >,\n    'queryKey'\n  > & {\n    queryFn: QueryFunction<TQueryFnData, TQueryKey>;\n    responseStruct?: TDataStruct;\n  }): Promise<TData> {\n    return this.#queryClient.fetchQuery({\n      ...options,\n      queryFn: async (context) => {\n        const response = await this.#policy.execute(() =>\n          options.queryFn(context),\n        );\n        return processQueryResponse(options.queryKey, response, responseStruct);\n      },\n    });\n  }\n\n  /**\n   * Fetch a paginated query.\n   *\n   * @param options - The options defining the query. Keep in mind that `queryKey` and `queryFn` are required when using data services.\n   * Additionally `retry` and `retryDelay` are not available, retries can be customized using the `servicePolicyOptions`.\n   * @param options.responseStruct - An optional struct for validating the response of the query function.\n   * @param pageParam - An optional page parameter.\n   * @returns The query result, exclusively the requested page is returned.\n   */\n  protected async fetchInfiniteQuery<\n    TQueryFnData extends Json,\n    TError = DefaultError,\n    TDataStruct extends Struct<TQueryFnData> | undefined = undefined,\n    TData extends TQueryFnData = TDataStruct extends Struct<infer StructType>\n      ? StructType\n      : TQueryFnData,\n    TQueryKey extends QueryKey = QueryKey,\n    TPageParam extends Json = Json,\n  >(\n    {\n      responseStruct,\n      ...options\n    }: WithRequired<\n      OmitKeyof<\n        FetchQueryOptions<\n          TQueryFnData,\n          TError,\n          InfiniteData<TData, TPageParam>,\n          TQueryKey,\n          TPageParam\n        >,\n        'retry' | 'retryDelay' | 'queryFn' | 'initialPageParam'\n      >,\n      'queryKey'\n    > &\n      InfiniteQueryPageParamsOptions<TQueryFnData, TPageParam> & {\n        queryFn: QueryFunction<TQueryFnData, TQueryKey, TPageParam>;\n        responseStruct?: TDataStruct;\n      },\n    pageParam?: TPageParam,\n  ): Promise<TData> {\n    const cache = this.#queryClient.getQueryCache();\n\n    const query = cache.find<\n      TQueryFnData,\n      TError,\n      InfiniteData<TData, TPageParam>\n    >({\n      queryKey: options.queryKey,\n    });\n\n    if (!query?.state.data || !pageParam) {\n      const result = await this.#queryClient.fetchInfiniteQuery({\n        ...options,\n        initialPageParam: pageParam ?? options.initialPageParam,\n        queryFn: async (context) => {\n          const response = await this.#policy.execute(async () =>\n            options.queryFn({\n              ...context,\n              pageParam: context.meta?.pageParam ?? context.pageParam,\n            }),\n          );\n          return processQueryResponse(\n            options.queryKey,\n            response,\n            responseStruct,\n          );\n        },\n      });\n\n      return result.pages[0];\n    }\n\n    const { pages, pageParams } = query.state.data;\n    const next = options.getNextPageParam(\n      pages[pages.length - 1],\n      pages,\n      pageParams[pageParams.length - 1],\n      pageParams,\n    );\n\n    const direction = deepEqual(pageParam, next) ? 'forward' : 'backward';\n\n    const result = await query.fetch(\n      { ...query.options, meta: { pageParam } },\n      { meta: { fetchMore: { direction } } },\n    );\n\n    const pageIndex = result.pageParams.findIndex((param) =>\n      deepEqual(param, pageParam),\n    );\n\n    return result.pages[pageIndex];\n  }\n\n  /**\n   * Invalidate queries serviced by this data service.\n   *\n   * @param filters - Optional filter for selecting specific queries.\n   * @param options - Additional optional options for query invalidations.\n   * @returns Nothing.\n   */\n  async invalidateQueries(\n    filters?: InvalidateQueryFilters<QueryKey>,\n    options?: InvalidateOptions,\n  ): Promise<void> {\n    return this.#queryClient.invalidateQueries(filters, options);\n  }\n\n  /**\n   * Initialize the service, rehydrating the cache with persisted data if possible.\n   */\n  init(): void {\n    this.#loadCache().catch(\n      /* istanbul ignore next */\n      (error) => this.#messenger.captureException?.(error),\n    );\n  }\n\n  /**\n   * Prepares the service for garbage collection. This should be extended\n   * by any subclasses to clean up any additional connections or events.\n   */\n  destroy(): void {\n    this.#debouncedPersist?.cancel();\n    this.#queryCacheUnsubscribe();\n    this.#queryClient.clear();\n    this.messenger.clearSubscriptions();\n    this.messenger.clearActions();\n  }\n\n  /**\n   * Publish `cacheUpdated` events when a given query changes.\n   *\n   * @param hash The hash of the query.\n   * @param type The type of cache update.\n   */\n  #publishCacheUpdate(hash: string, type: CacheUpdatedType): void {\n    const state =\n      type === 'added' || type === 'updated'\n        ? dehydrate(this.#queryClient, {\n            shouldDehydrateQuery: (query) => query.queryHash === hash,\n          })\n        : null;\n\n    this.#messenger.publish(\n      `${this.name}:cacheUpdated` as const,\n      {\n        type,\n        hash,\n        state,\n      } as DataServiceCacheUpdatedPayload,\n    );\n\n    this.#messenger.publish(\n      `${this.name}:cacheUpdated:${hash}` as const,\n      {\n        type,\n        state,\n      } as DataServiceGranularCacheUpdatedPayload,\n    );\n  }\n\n  /**\n   * Persist the query client cache using the StorageService, if the cache is not empty.\n   *\n   * @returns Nothing.\n   */\n  async #persistCache(): Promise<void> {\n    const state = dehydrate(this.#queryClient, {\n      // This is the default, but we specify it to be explicit.\n      shouldDehydrateQuery: (query) => query.state.status === 'success',\n    });\n\n    if (state.queries.length === 0 && state.mutations.length === 0) {\n      await this.#externalMessenger.call(\n        'StorageService:removeItem',\n        this.name,\n        STORAGE_SERVICE_KEY,\n      );\n      return;\n    }\n\n    const cache: PersistedCache = {\n      timestamp: Date.now(),\n      state,\n    };\n\n    await this.#externalMessenger.call(\n      'StorageService:setItem',\n      this.name,\n      STORAGE_SERVICE_KEY,\n      cache as unknown as Json,\n    );\n  }\n\n  /**\n   * Load the query client cache from the StorageService, if persistence is configured\n   * and the persisted cache is not expired.\n   *\n   * @returns Nothing.\n   */\n  async #loadCache(): Promise<void> {\n    if (!this.#persistenceConfig) {\n      return;\n    }\n\n    const { result: untypedCache } = await this.#externalMessenger.call(\n      'StorageService:getItem',\n      this.name,\n      STORAGE_SERVICE_KEY,\n    );\n\n    if (!untypedCache) {\n      return;\n    }\n\n    const cache = untypedCache as unknown as PersistedCache;\n\n    if (Date.now() - cache.timestamp >= this.#persistenceConfig.maxAge) {\n      await this.#externalMessenger.call(\n        'StorageService:removeItem',\n        this.name,\n        STORAGE_SERVICE_KEY,\n      );\n      return;\n    }\n\n    hydrate(this.#queryClient, cache.state);\n  }\n}\n"]}
+{"version":3,"file":"BaseDataService.cjs","sourceRoot":"","sources":["../src/BaseDataService.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;AAAA,mDAM6B;AAM7B,uDAA+C;AAC/C,2CAA2D;AAE3D,qDAmB8B;AAC9B,sEAAwC;AACxC,mCAAiD;AAEjD,sEAIkC;AAClC,8CAAiE;AACjE,0CAA2E;AAE3E,MAAM,GAAG,GAAG,IAAA,+BAAkB,EAAC,0BAAa,EAAE,iBAAiB,CAAC,CAAC;AAmFjE;;GAEG;AACH,MAAM,qBAAqB,GAAmB;IAC5C,OAAO,EAAE;QACP,KAAK,EAAE,KAAK;QACZ,SAAS,EAAE,IAAA,sBAAc,EAAC,CAAC,EAAE,gBAAQ,CAAC,MAAM,CAAC;KAC9C;IACD,SAAS,EAAE;QACT,KAAK,EAAE,KAAK;KACb;CACF,CAAC;AAEW,QAAA,mBAAmB,GAAG,OAAO,CAAC;AA2B3C,MAAa,eAAe;IA+B1B,YAAY,EACV,IAAI,EACJ,SAAS,EACT,iBAAiB,GAAG,EAAE,EACtB,aAAa,EACb,iBAAiB,GAalB;;QA3CQ,6CAIP;QAEO,qDAGP;QAIO,0CAAuB;QAEvB,+CAA0B;QAE1B,yDAAmC;QAEnC,4DAAsC;QAEtC,oDAA8C;QAE9C,qDAA8C;QAqBrD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QAEjB,2EAA2E;QAC3E,kFAAkF;QAClF,yDAAyD;QACzD,6FAA6F;QAC7F,uBAAA,IAAI,8BAAc,SAIjB,MAAA,CAAC;QACF,uBAAA,IAAI,sCAAsB,SAGzB,MAAA,CAAC;QACF,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAE3B,uBAAA,IAAI,gCAAgB,IAAI,wBAAW,CAAC;YAClC,GAAG,iBAAiB;YACpB,cAAc,EAAE;gBACd,OAAO,EAAE;oBACP,GAAG,qBAAqB,CAAC,OAAO;oBAChC,GAAG,iBAAiB,CAAC,cAAc,EAAE,OAAO;iBAC7C;gBACD,SAAS,EAAE;oBACT,GAAG,qBAAqB,CAAC,SAAS;oBAClC,GAAG,iBAAiB,CAAC,cAAc,EAAE,SAAS;iBAC/C;aACF;SACF,CAAC,MAAA,CAAC;QAEH,uBAAA,IAAI,sCAAsB,iBAAiB,MAAA,CAAC;QAE5C,uBAAA,IAAI,2BAAW,IAAA,4CAAmB,EAAC,aAAa,CAAC,MAAA,CAAC;QAElD,uBAAA,IAAI,qCACF,uBAAA,IAAI,0CAAmB;YACvB,IAAA,iBAAQ,EACN,GAAG,EAAE;gBACH,uBAAA,IAAI,iEAAc,MAAlB,IAAI,CAAgB,CAAC,KAAK;gBACxB,0BAA0B;gBAC1B,CAAC,KAAK,EAAE,EAAE,CAAC,uBAAA,IAAI,kCAAW,CAAC,gBAAgB,EAAE,CAAC,KAAK,CAAC,CACrD,CAAC;YACJ,CAAC,EACD,uBAAA,IAAI,0CAAmB,CAAC,UAAU;gBAChC,IAAA,sBAAc,EAAC,EAAE,EAAE,gBAAQ,CAAC,MAAM,CAAC,EACrC;gBACE,OAAO,EACL,uBAAA,IAAI,0CAAmB,CAAC,aAAa;oBACrC,IAAA,sBAAc,EAAC,CAAC,EAAE,gBAAQ,CAAC,MAAM,CAAC;aACrC,CACF,MAAA,CAAC;QAEJ,uBAAA,IAAI,0CAA0B,uBAAA,IAAI,oCAAa;aAC5C,aAAa,EAAE;aACf,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE;YACnB,GAAG,CAAC,2BAA2B,EAAE,KAAK,CAAC,CAAC;YACxC,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBACzD,uBAAA,IAAI,uEAAoB,MAAxB,IAAI,EACF,OAAO,EACP,KAAK,CAAC,IAAwB,EAC9B,KAAK,CAAC,KAAK,CAAC,SAAS,CACtB,CAAC;gBAEF,uBAAA,IAAI,yCAAkB,EAAE,KAAxB,IAAI,CAAsB,CAAC;YAC7B,CAAC;QACH,CAAC,CAAC,MAAA,CAAC;QAEL,GAAG,CAAC,+BAA+B,CAAC,CAAC;QACrC,uBAAA,IAAI,6CAA6B,uBAAA,IAAI,oCAAa;aAC/C,gBAAgB,EAAE;aAClB,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE;YACnB,GAAG,CAAC,8BAA8B,EAAE,KAAK,CAAC,CAAC;YAC3C,IACE,CAAC,OAAO,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC;gBACpD,KAAK,CAAC,QAAQ,EAAE,OAAO,CAAC,WAAW,KAAK,SAAS,EACjD,CAAC;gBACD,MAAM,YAAY,GAAG,IAAA,oBAAO,EAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;gBACjE,uBAAA,IAAI,uEAAoB,MAAxB,IAAI,EACF,UAAU,EACV,KAAK,CAAC,IAAwB,EAC9B,YAAY,CACb,CAAC;gBAEF,uBAAA,IAAI,yCAAkB,EAAE,KAAxB,IAAI,CAAsB,CAAC;YAC7B,CAAC;QACH,CAAC,CAAC,MAAA,CAAC;QAEL,uBAAA,IAAI,kCAAW,CAAC,qBAAqB,CACnC,GAAG,IAAI,CAAC,IAAI,oBAAoB,EAChC,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAClC,CAAC;IACJ,CAAC;IAED;;;;;;;;OAQG;IACO,KAAK,CAAC,UAAU,CAQxB,EACA,OAAO,EACP,cAAc,EACd,GAAG,OAAO,EAUX;QACC,OAAO,uBAAA,IAAI,oCAAa,CAAC,UAAU,CAAC;YAClC,GAAG,OAAO;YACV,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;gBACzB,MAAM,QAAQ,GAAG,MAAM,uBAAA,IAAI,+BAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;gBACpE,OAAO,IAAA,+BAAoB,EAAC,OAAO,CAAC,QAAQ,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC;YAC1E,CAAC;SACF,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;OAQG;IACO,KAAK,CAAC,kBAAkB,CAUhC,EACE,cAAc,EACd,GAAG,OAAO,EAiBT,EACH,SAAsB;QAEtB,MAAM,KAAK,GAAG,uBAAA,IAAI,oCAAa,CAAC,aAAa,EAAE,CAAC;QAEhD,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAItB;YACA,QAAQ,EAAE,OAAO,CAAC,QAAQ;SAC3B,CAAC,CAAC;QAEH,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACrC,MAAM,MAAM,GAAG,MAAM,uBAAA,IAAI,oCAAa,CAAC,kBAAkB,CAAC;gBACxD,GAAG,OAAO;gBACV,gBAAgB,EAAE,SAAS,IAAI,OAAO,CAAC,gBAAgB;gBACvD,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;oBACzB,MAAM,QAAQ,GAAG,MAAM,uBAAA,IAAI,+BAAQ,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CACrD,OAAO,CAAC,OAAO,CAAC;wBACd,GAAG,OAAO;wBACV,SAAS,EAAE,OAAO,CAAC,IAAI,EAAE,SAAS,IAAI,OAAO,CAAC,SAAS;qBACxD,CAAC,CACH,CAAC;oBACF,OAAO,IAAA,+BAAoB,EACzB,OAAO,CAAC,QAAQ,EAChB,QAAQ,EACR,cAAc,CACf,CAAC;gBACJ,CAAC;aACF,CAAC,CAAC;YAEH,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACzB,CAAC;QAED,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC;QAC/C,MAAM,IAAI,GAAG,OAAO,CAAC,gBAAgB,CACnC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,EACvB,KAAK,EACL,UAAU,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,EACjC,UAAU,CACX,CAAC;QAEF,MAAM,SAAS,GAAG,IAAA,yBAAS,EAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC;QAEtE,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,KAAK,CAC9B,EAAE,GAAG,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,EAAE,EACzC,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,CACvC,CAAC;QAEF,MAAM,SAAS,GAAG,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CACtD,IAAA,yBAAS,EAAC,KAAK,EAAE,SAAS,CAAC,CAC5B,CAAC;QAEF,OAAO,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACjC,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACO,KAAK,CAAC,eAAe,CAe7B,EACA,UAAU,EACV,cAAc,EACd,QAAQ,EACR,GAAG,OAAO,EASX;QACC,MAAM,aAAa,GAAG,uBAAA,IAAI,oCAAa,CAAC,gBAAgB,EAAE,CAAC;QAC3D,MAAM,QAAQ,GAAG,aAAa,CAAC,KAAK,CAKlC,uBAAA,IAAI,oCAAa,EAAE;YACnB,GAAG,OAAO;YACV,GAAG,CAAC,QAAQ,KAAK,SAAS,IAAI;gBAC5B,IAAI,EAAE,EAAE,GAAG,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE;aACpC,CAAC;YACF,UAAU,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,EAAE;gBAC5B,wEAAwE;gBACxE,qEAAqE;gBACrE,gEAAgE;gBAChE,4CAA4C;gBAC5C,MAAM,QAAQ,GAAG,MAAM,uBAAA,IAAI,+BAAQ,CAAC,oBAAoB,CAAC,OAAO,CAAC,GAAG,EAAE,CACpE,UAAU,CAAC,GAAG,IAAI,CAAC,CACpB,CAAC;gBACF,OAAO,IAAA,kCAAuB,EAC5B,OAAO,CAAC,WAAW,EACnB,QAAQ,EACR,cAAc,CACf,CAAC;YACJ,CAAC;SACF,CAAC,CAAC;QACH,qEAAqE;QACrE,yEAAyE;QACzE,4DAA4D;QAC5D,OAAO,MAAM,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACpC,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,iBAAiB,CACrB,OAA0C,EAC1C,OAA2B;QAE3B,OAAO,uBAAA,IAAI,oCAAa,CAAC,iBAAiB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC/D,CAAC;IAED;;OAEG;IACH,IAAI;QACF,uBAAA,IAAI,8DAAW,MAAf,IAAI,CAAa,CAAC,KAAK;QACrB,0BAA0B;QAC1B,CAAC,KAAK,EAAE,EAAE,CAAC,uBAAA,IAAI,kCAAW,CAAC,gBAAgB,EAAE,CAAC,KAAK,CAAC,CACrD,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,OAAO;QACL,uBAAA,IAAI,yCAAkB,EAAE,MAAM,EAAE,CAAC;QACjC,uBAAA,IAAI,8CAAuB,MAA3B,IAAI,CAAyB,CAAC;QAC9B,uBAAA,IAAI,iDAA0B,MAA9B,IAAI,CAA4B,CAAC;QACjC,wEAAwE;QACxE,wEAAwE;QACxE,4EAA4E;QAC5E,iDAAiD;QACjD,KAAK,MAAM,QAAQ,IAAI,uBAAA,IAAI,oCAAa,CAAC,gBAAgB,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC;YACrE,QAAQ,CAAC,OAAO,EAAE,CAAC;QACrB,CAAC;QACD,uBAAA,IAAI,oCAAa,CAAC,KAAK,EAAE,CAAC;QAC1B,IAAI,CAAC,SAAS,CAAC,kBAAkB,EAAE,CAAC;QACpC,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,CAAC;IAChC,CAAC;CAgHF;AA9fD,0CA8fC;ghBAtGG,UAAgC,EAChC,SAA2B,EAC3B,IAAY;IAEZ,MAAM,KAAK,GACT,SAAS,KAAK,OAAO,IAAI,SAAS,KAAK,SAAS;QAC9C,CAAC,CAAC,IAAA,sBAAS,EAAC,uBAAA,IAAI,oCAAa,EAAE;YAC3B,oBAAoB,EAAE,CAAC,KAAK,EAAE,EAAE,CAC9B,UAAU,KAAK,OAAO,IAAI,KAAK,CAAC,SAAS,KAAK,IAAI;YACpD,uBAAuB,EAAE,CAAC,QAAQ,EAAE,EAAE,CACpC,UAAU,KAAK,UAAU;gBACzB,QAAQ,CAAC,OAAO,CAAC,WAAW,KAAK,SAAS;gBAC1C,IAAA,oBAAO,EAAC,QAAQ,CAAC,OAAO,CAAC,WAAW,CAAC,KAAK,IAAI;SACjD,CAAC;QACJ,CAAC,CAAC,IAAI,CAAC;IAEX,uBAAA,IAAI,kCAAW,CAAC,OAAO,CACrB,GAAG,IAAI,CAAC,IAAI,eAAwB,EACpC;QACE,IAAI,EAAE,SAAS;QACf,UAAU;QACV,IAAI;QACJ,KAAK;KAC4B,CACpC,CAAC;IACF,uBAAA,IAAI,kCAAW,CAAC,OAAO,CACrB,GAAG,IAAI,CAAC,IAAI,iBAAiB,IAAI,EAAW,EAC5C;QACE,IAAI,EAAE,SAAS;QACf,UAAU;QACV,KAAK;KACoC,CAC5C,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,KAAK;IACH,MAAM,KAAK,GAAG,IAAA,sBAAS,EAAC,uBAAA,IAAI,oCAAa,EAAE;QACzC,yDAAyD;QACzD,oBAAoB,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS;KAClE,CAAC,CAAC;IAEH,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/D,MAAM,uBAAA,IAAI,0CAAmB,CAAC,IAAI,CAChC,2BAA2B,EAC3B,IAAI,CAAC,IAAI,EACT,2BAAmB,CACpB,CAAC;QACF,OAAO;IACT,CAAC;IAED,MAAM,KAAK,GAAmB;QAC5B,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,KAAK;KACN,CAAC;IAEF,MAAM,uBAAA,IAAI,0CAAmB,CAAC,IAAI,CAChC,wBAAwB,EACxB,IAAI,CAAC,IAAI,EACT,2BAAmB,EACnB,KAAwB,CACzB,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,KAAK;IACH,IAAI,CAAC,uBAAA,IAAI,0CAAmB,EAAE,CAAC;QAC7B,OAAO;IACT,CAAC;IAED,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,uBAAA,IAAI,0CAAmB,CAAC,IAAI,CACjE,wBAAwB,EACxB,IAAI,CAAC,IAAI,EACT,2BAAmB,CACpB,CAAC;IAEF,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,OAAO;IACT,CAAC;IAED,MAAM,KAAK,GAAG,YAAyC,CAAC;IAExD,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,SAAS,IAAI,uBAAA,IAAI,0CAAmB,CAAC,MAAM,EAAE,CAAC;QACnE,MAAM,uBAAA,IAAI,0CAAmB,CAAC,IAAI,CAChC,2BAA2B,EAC3B,IAAI,CAAC,IAAI,EACT,2BAAmB,CACpB,CAAC;QACF,OAAO;IACT,CAAC;IAED,IAAA,oBAAO,EAAC,uBAAA,IAAI,oCAAa,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;AAC1C,CAAC","sourcesContent":["import {\n  Messenger,\n  ActionConstraint,\n  EventConstraint,\n  MessengerActions,\n  MessengerEvents,\n} from '@metamask/messenger';\nimport type {\n  StorageServiceGetItemAction,\n  StorageServiceRemoveItemAction,\n  StorageServiceSetItemAction,\n} from '@metamask/storage-service';\nimport { Struct } from '@metamask/superstruct';\nimport { Duration, inMilliseconds } from '@metamask/utils';\nimport type { Json } from '@metamask/utils';\nimport {\n  DefaultError,\n  DefaultOptions,\n  DehydratedState,\n  FetchQueryOptions,\n  InfiniteData,\n  InfiniteQueryPageParamsOptions,\n  InvalidateOptions,\n  InvalidateQueryFilters,\n  MutationOptions,\n  OmitKeyof,\n  QueryClient,\n  QueryClientConfig,\n  QueryFunction,\n  WithRequired,\n  dehydrate,\n  hydrate,\n  hashKey,\n  MutationFunction,\n} from '@tanstack/query-core';\nimport deepEqual from 'fast-deep-equal';\nimport { debounce, DebouncedFunc } from 'lodash';\n\nimport {\n  createServicePolicy,\n  CreateServicePolicyOptions,\n  ServicePolicy,\n} from './createServicePolicy.js';\nimport { createModuleLogger, projectLogger } from './loggers.js';\nimport { processMutationResponse, processQueryResponse } from './utils.js';\n\nconst log = createModuleLogger(projectLogger, 'BaseDataService');\n\n/**\n * Data service mutations and queries use the following format:\n * `['${ServiceName}:${ActionName}', ...params]`\n */\ntype Key = [string, ...Json[]] | readonly [string, ...Json[]];\n\n/*\n * Data service queries use the following format:\n * `['${ServiceName}:${ActionName}', ...params]`\n */\nexport type QueryKey = Key;\n\n/*\n * Data service mutations use the following format:\n * `['${ServiceName}:${ActionName}', ...params]`\n */\nexport type MutationKey = Key;\n\n/**\n * The supertype of all messengers, scoped to a namespace.\n *\n * @template Namespace - The namespace for the messenger's own actions and\n * events.\n */\nexport type BaseMessenger<Namespace extends string> = Messenger<\n  Namespace,\n  ActionConstraint,\n  EventConstraint,\n  // Use `any` to allow any parent to be set. `any` is harmless in a type constraint anyway,\n  // it's the one totally safe place to use it.\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  any\n>;\n\nexport type DataServiceGranularCacheUpdatedPayload = {\n  objectType: 'query' | 'mutation';\n} & (\n  | { type: 'added' | 'updated'; state: DehydratedState }\n  | {\n      type: 'removed';\n      state: null;\n    }\n);\n\nexport type DataServiceCacheUpdatedPayload =\n  DataServiceGranularCacheUpdatedPayload & {\n    hash: string;\n  };\n\ntype CacheUpdatedType = DataServiceCacheUpdatedPayload['type'];\n\nexport type DataServiceInvalidateQueriesAction<ServiceName extends string> = {\n  type: `${ServiceName}:invalidateQueries`;\n  handler: BaseDataService<\n    ServiceName,\n    BaseMessenger<ServiceName>\n  >['invalidateQueries'];\n};\n\nexport type DataServiceActions<ServiceName extends string> =\n  DataServiceInvalidateQueriesAction<ServiceName>;\n\ntype DataServiceAllowedActions =\n  | StorageServiceGetItemAction\n  | StorageServiceSetItemAction\n  | StorageServiceRemoveItemAction;\n\nexport type DataServiceCacheUpdatedEvent<ServiceName extends string> = {\n  type: `${ServiceName}:cacheUpdated`;\n  payload: [DataServiceCacheUpdatedPayload];\n};\n\nexport type DataServiceGranularCacheUpdatedEvent<ServiceName extends string> = {\n  type: `${ServiceName}:cacheUpdated:${string}`;\n  payload: [DataServiceGranularCacheUpdatedPayload];\n};\n\nexport type DataServiceEvents<ServiceName extends string> =\n  | DataServiceCacheUpdatedEvent<ServiceName>\n  | DataServiceGranularCacheUpdatedEvent<ServiceName>;\n\n/*\n * Defaults to apply to all data service queries if no default option specified.\n */\nconst QUERY_CLIENT_DEFAULTS: DefaultOptions = {\n  queries: {\n    retry: false,\n    staleTime: inMilliseconds(1, Duration.Minute),\n  },\n  mutations: {\n    retry: false,\n  },\n};\n\nexport const STORAGE_SERVICE_KEY = 'cache';\n\n/**\n * Options for persistence configuration.\n */\nexport type PersistenceConfiguration = {\n  /**\n   * The maximum age before the cache is treated as expired in milliseconds.\n   * This is relevant for rehydrating the state during initialization,\n   * if the cached state is too old it will be discarded.\n   */\n  maxAge: number;\n  /**\n   * The number of milliseconds to wait before triggering persistence following a cache update.\n   */\n  writeDelay?: number;\n  /**\n   * The maximum number of milliseconds to wait between persistence writes.\n   */\n  maxWriteDelay?: number;\n};\n\ntype PersistedCache = {\n  state: DehydratedState;\n  timestamp: number;\n};\n\nexport class BaseDataService<\n  ServiceName extends string,\n  ServiceMessenger extends BaseMessenger<ServiceName>,\n> {\n  public readonly name: ServiceName;\n\n  readonly #messenger: Messenger<\n    ServiceName,\n    DataServiceActions<ServiceName>,\n    DataServiceEvents<ServiceName>\n  >;\n\n  readonly #externalMessenger: Messenger<\n    ServiceName,\n    DataServiceAllowedActions\n  >;\n\n  protected messenger: ServiceMessenger;\n\n  readonly #policy: ServicePolicy;\n\n  readonly #queryClient: QueryClient;\n\n  readonly #queryCacheUnsubscribe: () => void;\n\n  readonly #mutationCacheUnsubscribe: () => void;\n\n  readonly #debouncedPersist?: DebouncedFunc<() => void>;\n\n  readonly #persistenceConfig?: PersistenceConfiguration;\n\n  constructor({\n    name,\n    messenger,\n    queryClientConfig = {},\n    policyOptions,\n    persistenceConfig,\n  }: {\n    name: ServiceName;\n    messenger: DataServiceActions<ServiceName>['type'] extends\n      | MessengerActions<ServiceMessenger>['type']\n      | DataServiceAllowedActions['type']\n      ? DataServiceEvents<ServiceName>['type'] extends MessengerEvents<ServiceMessenger>['type']\n        ? ServiceMessenger\n        : never\n      : never;\n    queryClientConfig?: QueryClientConfig;\n    policyOptions?: CreateServicePolicyOptions;\n    persistenceConfig?: PersistenceConfiguration;\n  }) {\n    this.name = name;\n\n    // We store two narrowly-typed messengers alongside the generic public one:\n    // - #messenger handles the service's own action registration and event publishing\n    // - #externalMessenger handles calls to external actions\n    // Splitting them avoids TypeScript issues with mixing template-literals with regular strings\n    this.#messenger = messenger as unknown as Messenger<\n      ServiceName,\n      DataServiceActions<ServiceName>,\n      DataServiceEvents<ServiceName>\n    >;\n    this.#externalMessenger = messenger as unknown as Messenger<\n      ServiceName,\n      DataServiceAllowedActions\n    >;\n    this.messenger = messenger;\n\n    this.#queryClient = new QueryClient({\n      ...queryClientConfig,\n      defaultOptions: {\n        queries: {\n          ...QUERY_CLIENT_DEFAULTS.queries,\n          ...queryClientConfig.defaultOptions?.queries,\n        },\n        mutations: {\n          ...QUERY_CLIENT_DEFAULTS.mutations,\n          ...queryClientConfig.defaultOptions?.mutations,\n        },\n      },\n    });\n\n    this.#persistenceConfig = persistenceConfig;\n\n    this.#policy = createServicePolicy(policyOptions);\n\n    this.#debouncedPersist =\n      this.#persistenceConfig &&\n      debounce(\n        () => {\n          this.#persistCache().catch(\n            /* istanbul ignore next */\n            (error) => this.#messenger.captureException?.(error),\n          );\n        },\n        this.#persistenceConfig.writeDelay ??\n          inMilliseconds(10, Duration.Second),\n        {\n          maxWait:\n            this.#persistenceConfig.maxWriteDelay ??\n            inMilliseconds(1, Duration.Minute),\n        },\n      );\n\n    this.#queryCacheUnsubscribe = this.#queryClient\n      .getQueryCache()\n      .subscribe((event) => {\n        log('Query cache event emitted', event);\n        if (['added', 'updated', 'removed'].includes(event.type)) {\n          this.#publishCacheUpdate(\n            'query',\n            event.type as CacheUpdatedType,\n            event.query.queryHash,\n          );\n\n          this.#debouncedPersist?.();\n        }\n      });\n\n    log('Subscribing to mutation cache');\n    this.#mutationCacheUnsubscribe = this.#queryClient\n      .getMutationCache()\n      .subscribe((event) => {\n        log('Mutation cache event emitted', event);\n        if (\n          ['added', 'updated', 'removed'].includes(event.type) &&\n          event.mutation?.options.mutationKey !== undefined\n        ) {\n          const mutationHash = hashKey(event.mutation.options.mutationKey);\n          this.#publishCacheUpdate(\n            'mutation',\n            event.type as CacheUpdatedType,\n            mutationHash,\n          );\n\n          this.#debouncedPersist?.();\n        }\n      });\n\n    this.#messenger.registerActionHandler(\n      `${this.name}:invalidateQueries`,\n      this.invalidateQueries.bind(this),\n    );\n  }\n\n  /**\n   * Fetch a query.\n   *\n   * @param options - The options defining the query. Keep in mind that `queryKey` and `queryFn` are required when using data services.\n   * Additionally `retry` and `retryDelay` are not available, retries can be customized using the `servicePolicyOptions`.\n   * @param options.queryFn - The query function.\n   * @param options.responseStruct - An optional struct for validating the response of the query function.\n   * @returns The query results.\n   */\n  protected async fetchQuery<\n    TQueryFnData extends Json,\n    TError = DefaultError,\n    TDataStruct extends Struct<TQueryFnData> | undefined = undefined,\n    TData = TDataStruct extends Struct<infer StructType>\n      ? StructType\n      : TQueryFnData,\n    TQueryKey extends QueryKey = QueryKey,\n  >({\n    queryFn,\n    responseStruct,\n    ...options\n  }: WithRequired<\n    OmitKeyof<\n      FetchQueryOptions<TQueryFnData, TError, TData, TQueryKey>,\n      'retry' | 'retryDelay' | 'queryFn'\n    >,\n    'queryKey'\n  > & {\n    queryFn: QueryFunction<TQueryFnData, TQueryKey>;\n    responseStruct?: TDataStruct;\n  }): Promise<TData> {\n    return this.#queryClient.fetchQuery({\n      ...options,\n      queryFn: async (context) => {\n        const response = await this.#policy.execute(() => queryFn(context));\n        return processQueryResponse(options.queryKey, response, responseStruct);\n      },\n    });\n  }\n\n  /**\n   * Fetch a paginated query.\n   *\n   * @param options - The options defining the query. Keep in mind that `queryKey` and `queryFn` are required when using data services.\n   * Additionally `retry` and `retryDelay` are not available, retries can be customized using the `servicePolicyOptions`.\n   * @param options.responseStruct - An optional struct for validating the response of the query function.\n   * @param pageParam - An optional page parameter.\n   * @returns The query result, exclusively the requested page is returned.\n   */\n  protected async fetchInfiniteQuery<\n    TQueryFnData extends Json,\n    TError = DefaultError,\n    TDataStruct extends Struct<TQueryFnData> | undefined = undefined,\n    TData extends TQueryFnData = TDataStruct extends Struct<infer StructType>\n      ? StructType\n      : TQueryFnData,\n    TQueryKey extends QueryKey = QueryKey,\n    TPageParam extends Json = Json,\n  >(\n    {\n      responseStruct,\n      ...options\n    }: WithRequired<\n      OmitKeyof<\n        FetchQueryOptions<\n          TQueryFnData,\n          TError,\n          InfiniteData<TData, TPageParam>,\n          TQueryKey,\n          TPageParam\n        >,\n        'retry' | 'retryDelay' | 'queryFn' | 'initialPageParam'\n      >,\n      'queryKey'\n    > &\n      InfiniteQueryPageParamsOptions<TQueryFnData, TPageParam> & {\n        queryFn: QueryFunction<TQueryFnData, TQueryKey, TPageParam>;\n        responseStruct?: TDataStruct;\n      },\n    pageParam?: TPageParam,\n  ): Promise<TData> {\n    const cache = this.#queryClient.getQueryCache();\n\n    const query = cache.find<\n      TQueryFnData,\n      TError,\n      InfiniteData<TData, TPageParam>\n    >({\n      queryKey: options.queryKey,\n    });\n\n    if (!query?.state.data || !pageParam) {\n      const result = await this.#queryClient.fetchInfiniteQuery({\n        ...options,\n        initialPageParam: pageParam ?? options.initialPageParam,\n        queryFn: async (context) => {\n          const response = await this.#policy.execute(async () =>\n            options.queryFn({\n              ...context,\n              pageParam: context.meta?.pageParam ?? context.pageParam,\n            }),\n          );\n          return processQueryResponse(\n            options.queryKey,\n            response,\n            responseStruct,\n          );\n        },\n      });\n\n      return result.pages[0];\n    }\n\n    const { pages, pageParams } = query.state.data;\n    const next = options.getNextPageParam(\n      pages[pages.length - 1],\n      pages,\n      pageParams[pageParams.length - 1],\n      pageParams,\n    );\n\n    const direction = deepEqual(pageParam, next) ? 'forward' : 'backward';\n\n    const result = await query.fetch(\n      { ...query.options, meta: { pageParam } },\n      { meta: { fetchMore: { direction } } },\n    );\n\n    const pageIndex = result.pageParams.findIndex((param) =>\n      deepEqual(param, pageParam),\n    );\n\n    return result.pages[pageIndex];\n  }\n\n  /**\n   * Execute a mutation (e.g. a request that is expected to change server-side data).\n   * Unlike `fetchQuery`, the request will not be cached or retried.\n   *\n   * @param options - The options defining the mutation. Keep in mind that `mutationKey` and `mutationFn` are required when using data services.\n   * Additionally, `retry` and `retryDelay` are not available.\n   * @param options.mutationFn - The mutation function.\n   * @param options.responseStruct - An optional struct for validating the response of the mutation function.\n   * @param options.globalId - A string which uniquely identifies this mutation\n   * across different query clients — specifically, the one in this data service\n   * and the one that `createUIQueryClient` in `@metamask/react-data-query`\n   * holds (in fact usually you don't need to pass this — `createUIQueryClient`\n   * will do it automatically). This global ID will be stored in the new\n   * mutation `meta` data and included in `:cacheUpdated` payloads.\n   * @returns The mutation results.\n   */\n  protected async executeMutation<\n    TMutationFnData extends Json,\n    // We have to use `Struct<any>` here, as using `Struct<InputResponse>` (or\n    // even `Struct<unknown>`) would reject a more concrete, \"real world\" struct.\n    // The reason is that `Struct` is an object type with methods whose signatures\n    // feature the struct's content type, making `Struct` contravariant in its\n    // content type. The only way to get around this is to use `any`.\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    TDataStruct extends Struct<any> | undefined = undefined,\n    TData = TDataStruct extends Struct<infer StructType>\n      ? StructType\n      : TMutationFnData,\n    TError = DefaultError,\n    TOnMutateResult = unknown,\n    TMutationKey extends MutationKey = MutationKey,\n  >({\n    mutationFn,\n    responseStruct,\n    globalId,\n    ...options\n  }: OmitKeyof<\n    MutationOptions<TData, TError, Record<never, never>, TOnMutateResult>,\n    'retry' | 'retryDelay' | 'mutationKey' | 'mutationFn'\n  > & {\n    mutationKey: TMutationKey;\n    mutationFn: MutationFunction<TMutationFnData, Record<never, never>>;\n    responseStruct?: TDataStruct;\n    globalId?: string;\n  }): Promise<TData> {\n    const mutationCache = this.#queryClient.getMutationCache();\n    const mutation = mutationCache.build<\n      TData,\n      TError,\n      Record<never, never>,\n      TOnMutateResult\n    >(this.#queryClient, {\n      ...options,\n      ...(globalId !== undefined && {\n        meta: { ...options.meta, globalId },\n      }),\n      mutationFn: async (...args) => {\n        // To guard against mutations being retried, we deliberately execute the\n        // mutation function through the circuit breaker policy alone, rather\n        // than through `this.#policy` (which is a combination of both a\n        // circuit breaker policy and retry policy).\n        const response = await this.#policy.circuitBreakerPolicy.execute(() =>\n          mutationFn(...args),\n        );\n        return processMutationResponse(\n          options.mutationKey,\n          response,\n          responseStruct,\n        );\n      },\n    });\n    // We purposely pass an empty set of variables because this method is\n    // intended to be used internally by the data service, not end users, and\n    // the data service has full control of `mutationFn` anyway.\n    return await mutation.execute({});\n  }\n\n  /**\n   * Invalidate queries serviced by this data service.\n   *\n   * @param filters - Optional filter for selecting specific queries.\n   * @param options - Additional optional options for query invalidations.\n   * @returns Nothing.\n   */\n  async invalidateQueries(\n    filters?: InvalidateQueryFilters<QueryKey>,\n    options?: InvalidateOptions,\n  ): Promise<void> {\n    return this.#queryClient.invalidateQueries(filters, options);\n  }\n\n  /**\n   * Initialize the service, rehydrating the cache with persisted data if possible.\n   */\n  init(): void {\n    this.#loadCache().catch(\n      /* istanbul ignore next */\n      (error) => this.#messenger.captureException?.(error),\n    );\n  }\n\n  /**\n   * Prepares the service for garbage collection. This should be extended\n   * by any subclasses to clean up any additional connections or events.\n   */\n  destroy(): void {\n    this.#debouncedPersist?.cancel();\n    this.#queryCacheUnsubscribe();\n    this.#mutationCacheUnsubscribe();\n    // `QueryClient.clear()` clears both caches, but `MutationCache.clear()`\n    // only drops its references to mutations without clearing their pending\n    // garbage-collection timers. We destroy each mutation first so those timers\n    // are cleared and do not keep the process alive.\n    for (const mutation of this.#queryClient.getMutationCache().getAll()) {\n      mutation.destroy();\n    }\n    this.#queryClient.clear();\n    this.messenger.clearSubscriptions();\n    this.messenger.clearActions();\n  }\n\n  /**\n   * Publish `cacheUpdated` events when the query or mutation cache is updated.\n   *\n   * @param objectType - The type of object updated (\"query\" or \"mutation\").\n   * @param eventType - What happened to the query or mutation (\"added\" or \"updated\").\n   * @param hash - The hash of the query or mutation.\n   */\n  #publishCacheUpdate(\n    objectType: 'query' | 'mutation',\n    eventType: CacheUpdatedType,\n    hash: string,\n  ): void {\n    const state =\n      eventType === 'added' || eventType === 'updated'\n        ? dehydrate(this.#queryClient, {\n            shouldDehydrateQuery: (query) =>\n              objectType === 'query' && query.queryHash === hash,\n            shouldDehydrateMutation: (mutation) =>\n              objectType === 'mutation' &&\n              mutation.options.mutationKey !== undefined &&\n              hashKey(mutation.options.mutationKey) === hash,\n          })\n        : null;\n\n    this.#messenger.publish(\n      `${this.name}:cacheUpdated` as const,\n      {\n        type: eventType,\n        objectType,\n        hash,\n        state,\n      } as DataServiceCacheUpdatedPayload,\n    );\n    this.#messenger.publish(\n      `${this.name}:cacheUpdated:${hash}` as const,\n      {\n        type: eventType,\n        objectType,\n        state,\n      } as DataServiceGranularCacheUpdatedPayload,\n    );\n  }\n\n  /**\n   * Persist the query client cache using the StorageService, if the cache is not empty.\n   *\n   * @returns Nothing.\n   */\n  async #persistCache(): Promise<void> {\n    const state = dehydrate(this.#queryClient, {\n      // This is the default, but we specify it to be explicit.\n      shouldDehydrateQuery: (query) => query.state.status === 'success',\n    });\n\n    if (state.queries.length === 0 && state.mutations.length === 0) {\n      await this.#externalMessenger.call(\n        'StorageService:removeItem',\n        this.name,\n        STORAGE_SERVICE_KEY,\n      );\n      return;\n    }\n\n    const cache: PersistedCache = {\n      timestamp: Date.now(),\n      state,\n    };\n\n    await this.#externalMessenger.call(\n      'StorageService:setItem',\n      this.name,\n      STORAGE_SERVICE_KEY,\n      cache as unknown as Json,\n    );\n  }\n\n  /**\n   * Load the query client cache from the StorageService, if persistence is configured\n   * and the persisted cache is not expired.\n   *\n   * @returns Nothing.\n   */\n  async #loadCache(): Promise<void> {\n    if (!this.#persistenceConfig) {\n      return;\n    }\n\n    const { result: untypedCache } = await this.#externalMessenger.call(\n      'StorageService:getItem',\n      this.name,\n      STORAGE_SERVICE_KEY,\n    );\n\n    if (!untypedCache) {\n      return;\n    }\n\n    const cache = untypedCache as unknown as PersistedCache;\n\n    if (Date.now() - cache.timestamp >= this.#persistenceConfig.maxAge) {\n      await this.#externalMessenger.call(\n        'StorageService:removeItem',\n        this.name,\n        STORAGE_SERVICE_KEY,\n      );\n      return;\n    }\n\n    hydrate(this.#queryClient, cache.state);\n  }\n}\n"]}

package/dist/BaseDataService.d.cts

@@ -2,9 +2,15 @@ import { Messenger, ActionConstraint, EventConstraint, MessengerActions, Messeng
 import type { StorageServiceGetItemAction, StorageServiceRemoveItemAction, StorageServiceSetItemAction } from "@metamask/storage-service";
 import { Struct } from "@metamask/superstruct";
 import type { Json } from "@metamask/utils";
-import { DefaultError, DehydratedState, FetchQueryOptions, InfiniteData, InfiniteQueryPageParamsOptions, InvalidateOptions, InvalidateQueryFilters, OmitKeyof, QueryClientConfig, QueryFunction, WithRequired } from "@tanstack/query-core";
+import { DefaultError, DehydratedState, FetchQueryOptions, InfiniteData, InfiniteQueryPageParamsOptions, InvalidateOptions, InvalidateQueryFilters, MutationOptions, OmitKeyof, QueryClientConfig, QueryFunction, WithRequired, MutationFunction } from "@tanstack/query-core";
 import { CreateServicePolicyOptions } from "./createServicePolicy.cjs";
-export type QueryKey = [string, ...Json[]] | readonly [string, ...Json[]];
+/**
+ * Data service mutations and queries use the following format:
+ * `['${ServiceName}:${ActionName}', ...params]`
+ */
+type Key = [string, ...Json[]] | readonly [string, ...Json[]];
+export type QueryKey = Key;
+export type MutationKey = Key;
 /**
  * The supertype of all messengers, scoped to a namespace.
  *
@@ -13,12 +19,14 @@ export type QueryKey = [string, ...Json[]] | readonly [string, ...Json[]];
  */
 export type BaseMessenger<Namespace extends string> = Messenger<Namespace, ActionConstraint, EventConstraint, any>;
 export type DataServiceGranularCacheUpdatedPayload = {
+    objectType: 'query' | 'mutation';
+} & ({
     type: 'added' | 'updated';
     state: DehydratedState;
 } | {
     type: 'removed';
     state: null;
-};
+});
 export type DataServiceCacheUpdatedPayload = DataServiceGranularCacheUpdatedPayload & {
     hash: string;
 };
@@ -73,10 +81,11 @@ export declare class BaseDataService<ServiceName extends string, ServiceMessenge
      *
      * @param options - The options defining the query. Keep in mind that `queryKey` and `queryFn` are required when using data services.
      * Additionally `retry` and `retryDelay` are not available, retries can be customized using the `servicePolicyOptions`.
+     * @param options.queryFn - The query function.
      * @param options.responseStruct - An optional struct for validating the response of the query function.
      * @returns The query results.
      */
-    protected fetchQuery<TQueryFnData extends Json, TError = DefaultError, TDataStruct extends Struct<TQueryFnData> | undefined = undefined, TData = TDataStruct extends Struct<infer StructType> ? StructType : TQueryFnData, TQueryKey extends QueryKey = QueryKey>({ responseStruct, ...options }: WithRequired<OmitKeyof<FetchQueryOptions<TQueryFnData, TError, TData, TQueryKey>, 'retry' | 'retryDelay' | 'queryFn'>, 'queryKey'> & {
+    protected fetchQuery<TQueryFnData extends Json, TError = DefaultError, TDataStruct extends Struct<TQueryFnData> | undefined = undefined, TData = TDataStruct extends Struct<infer StructType> ? StructType : TQueryFnData, TQueryKey extends QueryKey = QueryKey>({ queryFn, responseStruct, ...options }: WithRequired<OmitKeyof<FetchQueryOptions<TQueryFnData, TError, TData, TQueryKey>, 'retry' | 'retryDelay' | 'queryFn'>, 'queryKey'> & {
         queryFn: QueryFunction<TQueryFnData, TQueryKey>;
         responseStruct?: TDataStruct;
     }): Promise<TData>;
@@ -93,6 +102,28 @@ export declare class BaseDataService<ServiceName extends string, ServiceMessenge
         queryFn: QueryFunction<TQueryFnData, TQueryKey, TPageParam>;
         responseStruct?: TDataStruct;
     }, pageParam?: TPageParam): Promise<TData>;
+    /**
+     * Execute a mutation (e.g. a request that is expected to change server-side data).
+     * Unlike `fetchQuery`, the request will not be cached or retried.
+     *
+     * @param options - The options defining the mutation. Keep in mind that `mutationKey` and `mutationFn` are required when using data services.
+     * Additionally, `retry` and `retryDelay` are not available.
+     * @param options.mutationFn - The mutation function.
+     * @param options.responseStruct - An optional struct for validating the response of the mutation function.
+     * @param options.globalId - A string which uniquely identifies this mutation
+     * across different query clients — specifically, the one in this data service
+     * and the one that `createUIQueryClient` in `@metamask/react-data-query`
+     * holds (in fact usually you don't need to pass this — `createUIQueryClient`
+     * will do it automatically). This global ID will be stored in the new
+     * mutation `meta` data and included in `:cacheUpdated` payloads.
+     * @returns The mutation results.
+     */
+    protected executeMutation<TMutationFnData extends Json, TDataStruct extends Struct<any> | undefined = undefined, TData = TDataStruct extends Struct<infer StructType> ? StructType : TMutationFnData, TError = DefaultError, TOnMutateResult = unknown, TMutationKey extends MutationKey = MutationKey>({ mutationFn, responseStruct, globalId, ...options }: OmitKeyof<MutationOptions<TData, TError, Record<never, never>, TOnMutateResult>, 'retry' | 'retryDelay' | 'mutationKey' | 'mutationFn'> & {
+        mutationKey: TMutationKey;
+        mutationFn: MutationFunction<TMutationFnData, Record<never, never>>;
+        responseStruct?: TDataStruct;
+        globalId?: string;
+    }): Promise<TData>;
     /**
      * Invalidate queries serviced by this data service.
      *

package/dist/BaseDataService.d.cts.map

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

package/dist/BaseDataService.d.mts

@@ -2,9 +2,15 @@ import { Messenger, ActionConstraint, EventConstraint, MessengerActions, Messeng
 import type { StorageServiceGetItemAction, StorageServiceRemoveItemAction, StorageServiceSetItemAction } from "@metamask/storage-service";
 import { Struct } from "@metamask/superstruct";
 import type { Json } from "@metamask/utils";
-import { DefaultError, DehydratedState, FetchQueryOptions, InfiniteData, InfiniteQueryPageParamsOptions, InvalidateOptions, InvalidateQueryFilters, OmitKeyof, QueryClientConfig, QueryFunction, WithRequired } from "@tanstack/query-core";
+import { DefaultError, DehydratedState, FetchQueryOptions, InfiniteData, InfiniteQueryPageParamsOptions, InvalidateOptions, InvalidateQueryFilters, MutationOptions, OmitKeyof, QueryClientConfig, QueryFunction, WithRequired, MutationFunction } from "@tanstack/query-core";
 import { CreateServicePolicyOptions } from "./createServicePolicy.mjs";
-export type QueryKey = [string, ...Json[]] | readonly [string, ...Json[]];
+/**
+ * Data service mutations and queries use the following format:
+ * `['${ServiceName}:${ActionName}', ...params]`
+ */
+type Key = [string, ...Json[]] | readonly [string, ...Json[]];
+export type QueryKey = Key;
+export type MutationKey = Key;
 /**
  * The supertype of all messengers, scoped to a namespace.
  *
@@ -13,12 +19,14 @@ export type QueryKey = [string, ...Json[]] | readonly [string, ...Json[]];
  */
 export type BaseMessenger<Namespace extends string> = Messenger<Namespace, ActionConstraint, EventConstraint, any>;
 export type DataServiceGranularCacheUpdatedPayload = {
+    objectType: 'query' | 'mutation';
+} & ({
     type: 'added' | 'updated';
     state: DehydratedState;
 } | {
     type: 'removed';
     state: null;
-};
+});
 export type DataServiceCacheUpdatedPayload = DataServiceGranularCacheUpdatedPayload & {
     hash: string;
 };
@@ -73,10 +81,11 @@ export declare class BaseDataService<ServiceName extends string, ServiceMessenge
      *
      * @param options - The options defining the query. Keep in mind that `queryKey` and `queryFn` are required when using data services.
      * Additionally `retry` and `retryDelay` are not available, retries can be customized using the `servicePolicyOptions`.
+     * @param options.queryFn - The query function.
      * @param options.responseStruct - An optional struct for validating the response of the query function.
      * @returns The query results.
      */
-    protected fetchQuery<TQueryFnData extends Json, TError = DefaultError, TDataStruct extends Struct<TQueryFnData> | undefined = undefined, TData = TDataStruct extends Struct<infer StructType> ? StructType : TQueryFnData, TQueryKey extends QueryKey = QueryKey>({ responseStruct, ...options }: WithRequired<OmitKeyof<FetchQueryOptions<TQueryFnData, TError, TData, TQueryKey>, 'retry' | 'retryDelay' | 'queryFn'>, 'queryKey'> & {
+    protected fetchQuery<TQueryFnData extends Json, TError = DefaultError, TDataStruct extends Struct<TQueryFnData> | undefined = undefined, TData = TDataStruct extends Struct<infer StructType> ? StructType : TQueryFnData, TQueryKey extends QueryKey = QueryKey>({ queryFn, responseStruct, ...options }: WithRequired<OmitKeyof<FetchQueryOptions<TQueryFnData, TError, TData, TQueryKey>, 'retry' | 'retryDelay' | 'queryFn'>, 'queryKey'> & {
         queryFn: QueryFunction<TQueryFnData, TQueryKey>;
         responseStruct?: TDataStruct;
     }): Promise<TData>;
@@ -93,6 +102,28 @@ export declare class BaseDataService<ServiceName extends string, ServiceMessenge
         queryFn: QueryFunction<TQueryFnData, TQueryKey, TPageParam>;
         responseStruct?: TDataStruct;
     }, pageParam?: TPageParam): Promise<TData>;
+    /**
+     * Execute a mutation (e.g. a request that is expected to change server-side data).
+     * Unlike `fetchQuery`, the request will not be cached or retried.
+     *
+     * @param options - The options defining the mutation. Keep in mind that `mutationKey` and `mutationFn` are required when using data services.
+     * Additionally, `retry` and `retryDelay` are not available.
+     * @param options.mutationFn - The mutation function.
+     * @param options.responseStruct - An optional struct for validating the response of the mutation function.
+     * @param options.globalId - A string which uniquely identifies this mutation
+     * across different query clients — specifically, the one in this data service
+     * and the one that `createUIQueryClient` in `@metamask/react-data-query`
+     * holds (in fact usually you don't need to pass this — `createUIQueryClient`
+     * will do it automatically). This global ID will be stored in the new
+     * mutation `meta` data and included in `:cacheUpdated` payloads.
+     * @returns The mutation results.
+     */
+    protected executeMutation<TMutationFnData extends Json, TDataStruct extends Struct<any> | undefined = undefined, TData = TDataStruct extends Struct<infer StructType> ? StructType : TMutationFnData, TError = DefaultError, TOnMutateResult = unknown, TMutationKey extends MutationKey = MutationKey>({ mutationFn, responseStruct, globalId, ...options }: OmitKeyof<MutationOptions<TData, TError, Record<never, never>, TOnMutateResult>, 'retry' | 'retryDelay' | 'mutationKey' | 'mutationFn'> & {
+        mutationKey: TMutationKey;
+        mutationFn: MutationFunction<TMutationFnData, Record<never, never>>;
+        responseStruct?: TDataStruct;
+        globalId?: string;
+    }): Promise<TData>;
     /**
      * Invalidate queries serviced by this data service.
      *

package/dist/BaseDataService.d.mts.map

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

package/dist/BaseDataService.mjs

@@ -9,7 +9,7 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
     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 _BaseDataService_instances, _BaseDataService_messenger, _BaseDataService_externalMessenger, _BaseDataService_policy, _BaseDataService_queryClient, _BaseDataService_queryCacheUnsubscribe, _BaseDataService_debouncedPersist, _BaseDataService_persistenceConfig, _BaseDataService_publishCacheUpdate, _BaseDataService_persistCache, _BaseDataService_loadCache;
+var _BaseDataService_instances, _BaseDataService_messenger, _BaseDataService_externalMessenger, _BaseDataService_policy, _BaseDataService_queryClient, _BaseDataService_queryCacheUnsubscribe, _BaseDataService_mutationCacheUnsubscribe, _BaseDataService_debouncedPersist, _BaseDataService_persistenceConfig, _BaseDataService_publishCacheUpdate, _BaseDataService_persistCache, _BaseDataService_loadCache;
 function $importDefault(module) {
     if (module?.__esModule) {
         return module.default;
@@ -19,19 +19,26 @@ function $importDefault(module) {
 import { Messenger } from "@metamask/messenger";
 import { Struct } from "@metamask/superstruct";
 import { Duration, inMilliseconds } from "@metamask/utils";
-import { QueryClient, dehydrate, hydrate } from "@tanstack/query-core";
+import { QueryClient, dehydrate, hydrate, hashKey } from "@tanstack/query-core";
 import $deepEqual from "fast-deep-equal";
 const deepEqual = $importDefault($deepEqual);
 import $lodash from "lodash";
 const { debounce } = $lodash;
 import { createServicePolicy } from "./createServicePolicy.mjs";
-import { processQueryResponse } from "./utils.mjs";
-// Defaults to apply to all data service queries if no default option specified
+import { createModuleLogger, projectLogger } from "./loggers.mjs";
+import { processMutationResponse, processQueryResponse } from "./utils.mjs";
+const log = createModuleLogger(projectLogger, 'BaseDataService');
+/*
+ * Defaults to apply to all data service queries if no default option specified.
+ */
 const QUERY_CLIENT_DEFAULTS = {
     queries: {
         retry: false,
         staleTime: inMilliseconds(1, Duration.Minute),
     },
+    mutations: {
+        retry: false,
+    },
 };
 export const STORAGE_SERVICE_KEY = 'cache';
 export class BaseDataService {
@@ -42,6 +49,7 @@ export class BaseDataService {
         _BaseDataService_policy.set(this, void 0);
         _BaseDataService_queryClient.set(this, void 0);
         _BaseDataService_queryCacheUnsubscribe.set(this, void 0);
+        _BaseDataService_mutationCacheUnsubscribe.set(this, void 0);
         _BaseDataService_debouncedPersist.set(this, void 0);
         _BaseDataService_persistenceConfig.set(this, void 0);
         this.name = name;
@@ -59,7 +67,10 @@ export class BaseDataService {
                     ...QUERY_CLIENT_DEFAULTS.queries,
                     ...queryClientConfig.defaultOptions?.queries,
                 },
-                mutations: queryClientConfig.defaultOptions?.mutations,
+                mutations: {
+                    ...QUERY_CLIENT_DEFAULTS.mutations,
+                    ...queryClientConfig.defaultOptions?.mutations,
+                },
             },
         }), "f");
         __classPrivateFieldSet(this, _BaseDataService_persistenceConfig, persistenceConfig, "f");
@@ -77,8 +88,21 @@ export class BaseDataService {
         __classPrivateFieldSet(this, _BaseDataService_queryCacheUnsubscribe, __classPrivateFieldGet(this, _BaseDataService_queryClient, "f")
             .getQueryCache()
             .subscribe((event) => {
+            log('Query cache event emitted', event);
             if (['added', 'updated', 'removed'].includes(event.type)) {
-                __classPrivateFieldGet(this, _BaseDataService_instances, "m", _BaseDataService_publishCacheUpdate).call(this, event.query.queryHash, event.type);
+                __classPrivateFieldGet(this, _BaseDataService_instances, "m", _BaseDataService_publishCacheUpdate).call(this, 'query', event.type, event.query.queryHash);
+                __classPrivateFieldGet(this, _BaseDataService_debouncedPersist, "f")?.call(this);
+            }
+        }), "f");
+        log('Subscribing to mutation cache');
+        __classPrivateFieldSet(this, _BaseDataService_mutationCacheUnsubscribe, __classPrivateFieldGet(this, _BaseDataService_queryClient, "f")
+            .getMutationCache()
+            .subscribe((event) => {
+            log('Mutation cache event emitted', event);
+            if (['added', 'updated', 'removed'].includes(event.type) &&
+                event.mutation?.options.mutationKey !== undefined) {
+                const mutationHash = hashKey(event.mutation.options.mutationKey);
+                __classPrivateFieldGet(this, _BaseDataService_instances, "m", _BaseDataService_publishCacheUpdate).call(this, 'mutation', event.type, mutationHash);
                 __classPrivateFieldGet(this, _BaseDataService_debouncedPersist, "f")?.call(this);
             }
         }), "f");
@@ -89,14 +113,15 @@ export class BaseDataService {
      *
      * @param options - The options defining the query. Keep in mind that `queryKey` and `queryFn` are required when using data services.
      * Additionally `retry` and `retryDelay` are not available, retries can be customized using the `servicePolicyOptions`.
+     * @param options.queryFn - The query function.
      * @param options.responseStruct - An optional struct for validating the response of the query function.
      * @returns The query results.
      */
-    async fetchQuery({ responseStruct, ...options }) {
+    async fetchQuery({ queryFn, responseStruct, ...options }) {
         return __classPrivateFieldGet(this, _BaseDataService_queryClient, "f").fetchQuery({
             ...options,
             queryFn: async (context) => {
-                const response = await __classPrivateFieldGet(this, _BaseDataService_policy, "f").execute(() => options.queryFn(context));
+                const response = await __classPrivateFieldGet(this, _BaseDataService_policy, "f").execute(() => queryFn(context));
                 return processQueryResponse(options.queryKey, response, responseStruct);
             },
         });
@@ -136,6 +161,43 @@ export class BaseDataService {
         const pageIndex = result.pageParams.findIndex((param) => deepEqual(param, pageParam));
         return result.pages[pageIndex];
     }
+    /**
+     * Execute a mutation (e.g. a request that is expected to change server-side data).
+     * Unlike `fetchQuery`, the request will not be cached or retried.
+     *
+     * @param options - The options defining the mutation. Keep in mind that `mutationKey` and `mutationFn` are required when using data services.
+     * Additionally, `retry` and `retryDelay` are not available.
+     * @param options.mutationFn - The mutation function.
+     * @param options.responseStruct - An optional struct for validating the response of the mutation function.
+     * @param options.globalId - A string which uniquely identifies this mutation
+     * across different query clients — specifically, the one in this data service
+     * and the one that `createUIQueryClient` in `@metamask/react-data-query`
+     * holds (in fact usually you don't need to pass this — `createUIQueryClient`
+     * will do it automatically). This global ID will be stored in the new
+     * mutation `meta` data and included in `:cacheUpdated` payloads.
+     * @returns The mutation results.
+     */
+    async executeMutation({ mutationFn, responseStruct, globalId, ...options }) {
+        const mutationCache = __classPrivateFieldGet(this, _BaseDataService_queryClient, "f").getMutationCache();
+        const mutation = mutationCache.build(__classPrivateFieldGet(this, _BaseDataService_queryClient, "f"), {
+            ...options,
+            ...(globalId !== undefined && {
+                meta: { ...options.meta, globalId },
+            }),
+            mutationFn: async (...args) => {
+                // To guard against mutations being retried, we deliberately execute the
+                // mutation function through the circuit breaker policy alone, rather
+                // than through `this.#policy` (which is a combination of both a
+                // circuit breaker policy and retry policy).
+                const response = await __classPrivateFieldGet(this, _BaseDataService_policy, "f").circuitBreakerPolicy.execute(() => mutationFn(...args));
+                return processMutationResponse(options.mutationKey, response, responseStruct);
+            },
+        });
+        // We purposely pass an empty set of variables because this method is
+        // intended to be used internally by the data service, not end users, and
+        // the data service has full control of `mutationFn` anyway.
+        return await mutation.execute({});
+    }
     /**
      * Invalidate queries serviced by this data service.
      *
@@ -161,24 +223,37 @@ export class BaseDataService {
     destroy() {
         __classPrivateFieldGet(this, _BaseDataService_debouncedPersist, "f")?.cancel();
         __classPrivateFieldGet(this, _BaseDataService_queryCacheUnsubscribe, "f").call(this);
+        __classPrivateFieldGet(this, _BaseDataService_mutationCacheUnsubscribe, "f").call(this);
+        // `QueryClient.clear()` clears both caches, but `MutationCache.clear()`
+        // only drops its references to mutations without clearing their pending
+        // garbage-collection timers. We destroy each mutation first so those timers
+        // are cleared and do not keep the process alive.
+        for (const mutation of __classPrivateFieldGet(this, _BaseDataService_queryClient, "f").getMutationCache().getAll()) {
+            mutation.destroy();
+        }
         __classPrivateFieldGet(this, _BaseDataService_queryClient, "f").clear();
         this.messenger.clearSubscriptions();
         this.messenger.clearActions();
     }
 }
-_BaseDataService_messenger = new WeakMap(), _BaseDataService_externalMessenger = new WeakMap(), _BaseDataService_policy = new WeakMap(), _BaseDataService_queryClient = new WeakMap(), _BaseDataService_queryCacheUnsubscribe = new WeakMap(), _BaseDataService_debouncedPersist = new WeakMap(), _BaseDataService_persistenceConfig = new WeakMap(), _BaseDataService_instances = new WeakSet(), _BaseDataService_publishCacheUpdate = function _BaseDataService_publishCacheUpdate(hash, type) {
-    const state = type === 'added' || type === 'updated'
+_BaseDataService_messenger = new WeakMap(), _BaseDataService_externalMessenger = new WeakMap(), _BaseDataService_policy = new WeakMap(), _BaseDataService_queryClient = new WeakMap(), _BaseDataService_queryCacheUnsubscribe = new WeakMap(), _BaseDataService_mutationCacheUnsubscribe = new WeakMap(), _BaseDataService_debouncedPersist = new WeakMap(), _BaseDataService_persistenceConfig = new WeakMap(), _BaseDataService_instances = new WeakSet(), _BaseDataService_publishCacheUpdate = function _BaseDataService_publishCacheUpdate(objectType, eventType, hash) {
+    const state = eventType === 'added' || eventType === 'updated'
         ? dehydrate(__classPrivateFieldGet(this, _BaseDataService_queryClient, "f"), {
-            shouldDehydrateQuery: (query) => query.queryHash === hash,
+            shouldDehydrateQuery: (query) => objectType === 'query' && query.queryHash === hash,
+            shouldDehydrateMutation: (mutation) => objectType === 'mutation' &&
+                mutation.options.mutationKey !== undefined &&
+                hashKey(mutation.options.mutationKey) === hash,
         })
         : null;
     __classPrivateFieldGet(this, _BaseDataService_messenger, "f").publish(`${this.name}:cacheUpdated`, {
-        type,
+        type: eventType,
+        objectType,
         hash,
         state,
     });
     __classPrivateFieldGet(this, _BaseDataService_messenger, "f").publish(`${this.name}:cacheUpdated:${hash}`, {
-        type,
+        type: eventType,
+        objectType,
         state,
     });
 }, _BaseDataService_persistCache = 

package/dist/BaseDataService.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"BaseDataService.mjs","sourceRoot":"","sources":["../src/BaseDataService.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  Messenger,\n  ActionConstraint,\n  EventConstraint,\n  MessengerActions,\n  MessengerEvents,\n} from '@metamask/messenger';\nimport type {\n  StorageServiceGetItemAction,\n  StorageServiceRemoveItemAction,\n  StorageServiceSetItemAction,\n} from '@metamask/storage-service';\nimport { Struct } from '@metamask/superstruct';\nimport { Duration, inMilliseconds } from '@metamask/utils';\nimport type { Json } from '@metamask/utils';\nimport {\n  DefaultError,\n  DefaultOptions,\n  DehydratedState,\n  FetchQueryOptions,\n  InfiniteData,\n  InfiniteQueryPageParamsOptions,\n  InvalidateOptions,\n  InvalidateQueryFilters,\n  OmitKeyof,\n  QueryClient,\n  QueryClientConfig,\n  QueryFunction,\n  WithRequired,\n  dehydrate,\n  hydrate,\n} from '@tanstack/query-core';\nimport deepEqual from 'fast-deep-equal';\nimport { debounce, DebouncedFunc } from 'lodash';\n\nimport {\n  createServicePolicy,\n  CreateServicePolicyOptions,\n  ServicePolicy,\n} from './createServicePolicy.js';\nimport { processQueryResponse } from './utils.js';\n\n// Data service queries use the following format: ['ServiceActionName', ...params]\nexport type QueryKey = [string, ...Json[]] | readonly [string, ...Json[]];\n\n/**\n * The supertype of all messengers, scoped to a namespace.\n *\n * @template Namespace - The namespace for the messenger's own actions and\n * events.\n */\nexport type BaseMessenger<Namespace extends string> = Messenger<\n  Namespace,\n  ActionConstraint,\n  EventConstraint,\n  // Use `any` to allow any parent to be set. `any` is harmless in a type constraint anyway,\n  // it's the one totally safe place to use it.\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  any\n>;\n\nexport type DataServiceGranularCacheUpdatedPayload =\n  | { type: 'added' | 'updated'; state: DehydratedState }\n  | {\n      type: 'removed';\n      state: null;\n    };\n\nexport type DataServiceCacheUpdatedPayload =\n  DataServiceGranularCacheUpdatedPayload & {\n    hash: string;\n  };\n\ntype CacheUpdatedType = DataServiceCacheUpdatedPayload['type'];\n\nexport type DataServiceInvalidateQueriesAction<ServiceName extends string> = {\n  type: `${ServiceName}:invalidateQueries`;\n  handler: BaseDataService<\n    ServiceName,\n    BaseMessenger<ServiceName>\n  >['invalidateQueries'];\n};\n\nexport type DataServiceActions<ServiceName extends string> =\n  DataServiceInvalidateQueriesAction<ServiceName>;\n\ntype DataServiceAllowedActions =\n  | StorageServiceGetItemAction\n  | StorageServiceSetItemAction\n  | StorageServiceRemoveItemAction;\n\nexport type DataServiceCacheUpdatedEvent<ServiceName extends string> = {\n  type: `${ServiceName}:cacheUpdated`;\n  payload: [DataServiceCacheUpdatedPayload];\n};\n\nexport type DataServiceGranularCacheUpdatedEvent<ServiceName extends string> = {\n  type: `${ServiceName}:cacheUpdated:${string}`;\n  payload: [DataServiceGranularCacheUpdatedPayload];\n};\n\nexport type DataServiceEvents<ServiceName extends string> =\n  | DataServiceCacheUpdatedEvent<ServiceName>\n  | DataServiceGranularCacheUpdatedEvent<ServiceName>;\n\n// Defaults to apply to all data service queries if no default option specified\nconst QUERY_CLIENT_DEFAULTS: DefaultOptions = {\n  queries: {\n    retry: false,\n    staleTime: inMilliseconds(1, Duration.Minute),\n  },\n};\n\nexport const STORAGE_SERVICE_KEY = 'cache';\n\n/**\n * Options for persistence configuration.\n */\nexport type PersistenceConfiguration = {\n  /**\n   * The maximum age before the cache is treated as expired in milliseconds.\n   * This is relevant for rehydrating the state during initialization,\n   * if the cached state is too old it will be discarded.\n   */\n  maxAge: number;\n  /**\n   * The number of milliseconds to wait before triggering persistence following a cache update.\n   */\n  writeDelay?: number;\n  /**\n   * The maximum number of milliseconds to wait between persistence writes.\n   */\n  maxWriteDelay?: number;\n};\n\ntype PersistedCache = {\n  state: DehydratedState;\n  timestamp: number;\n};\n\nexport class BaseDataService<\n  ServiceName extends string,\n  ServiceMessenger extends BaseMessenger<ServiceName>,\n> {\n  public readonly name: ServiceName;\n\n  readonly #messenger: Messenger<\n    ServiceName,\n    DataServiceActions<ServiceName>,\n    DataServiceEvents<ServiceName>\n  >;\n\n  readonly #externalMessenger: Messenger<\n    ServiceName,\n    DataServiceAllowedActions\n  >;\n\n  protected messenger: ServiceMessenger;\n\n  readonly #policy: ServicePolicy;\n\n  readonly #queryClient: QueryClient;\n\n  readonly #queryCacheUnsubscribe: () => void;\n\n  readonly #debouncedPersist?: DebouncedFunc<() => void>;\n\n  readonly #persistenceConfig?: PersistenceConfiguration;\n\n  constructor({\n    name,\n    messenger,\n    queryClientConfig = {},\n    policyOptions,\n    persistenceConfig,\n  }: {\n    name: ServiceName;\n    messenger: DataServiceActions<ServiceName>['type'] extends\n      | MessengerActions<ServiceMessenger>['type']\n      | DataServiceAllowedActions['type']\n      ? DataServiceEvents<ServiceName>['type'] extends MessengerEvents<ServiceMessenger>['type']\n        ? ServiceMessenger\n        : never\n      : never;\n    queryClientConfig?: QueryClientConfig;\n    policyOptions?: CreateServicePolicyOptions;\n    persistenceConfig?: PersistenceConfiguration;\n  }) {\n    this.name = name;\n\n    // We store two narrowly-typed messengers alongside the generic public one:\n    // - #messenger handles the service's own action registration and event publishing\n    // - #externalMessenger handles calls to external actions\n    // Splitting them avoids TypeScript issues with mixing template-literals with regular strings\n    this.#messenger = messenger as unknown as Messenger<\n      ServiceName,\n      DataServiceActions<ServiceName>,\n      DataServiceEvents<ServiceName>\n    >;\n    this.#externalMessenger = messenger as unknown as Messenger<\n      ServiceName,\n      DataServiceAllowedActions\n    >;\n    this.messenger = messenger;\n\n    this.#queryClient = new QueryClient({\n      ...queryClientConfig,\n      defaultOptions: {\n        queries: {\n          ...QUERY_CLIENT_DEFAULTS.queries,\n          ...queryClientConfig.defaultOptions?.queries,\n        },\n        mutations: queryClientConfig.defaultOptions?.mutations,\n      },\n    });\n\n    this.#persistenceConfig = persistenceConfig;\n\n    this.#policy = createServicePolicy(policyOptions);\n\n    this.#debouncedPersist =\n      this.#persistenceConfig &&\n      debounce(\n        () => {\n          this.#persistCache().catch(\n            /* istanbul ignore next */\n            (error) => this.#messenger.captureException?.(error),\n          );\n        },\n        this.#persistenceConfig.writeDelay ??\n          inMilliseconds(10, Duration.Second),\n        {\n          maxWait:\n            this.#persistenceConfig.maxWriteDelay ??\n            inMilliseconds(1, Duration.Minute),\n        },\n      );\n\n    this.#queryCacheUnsubscribe = this.#queryClient\n      .getQueryCache()\n      .subscribe((event) => {\n        if (['added', 'updated', 'removed'].includes(event.type)) {\n          this.#publishCacheUpdate(\n            event.query.queryHash,\n            event.type as CacheUpdatedType,\n          );\n\n          this.#debouncedPersist?.();\n        }\n      });\n\n    this.#messenger.registerActionHandler(\n      `${this.name}:invalidateQueries`,\n      this.invalidateQueries.bind(this),\n    );\n  }\n\n  /**\n   * Fetch a query.\n   *\n   * @param options - The options defining the query. Keep in mind that `queryKey` and `queryFn` are required when using data services.\n   * Additionally `retry` and `retryDelay` are not available, retries can be customized using the `servicePolicyOptions`.\n   * @param options.responseStruct - An optional struct for validating the response of the query function.\n   * @returns The query results.\n   */\n  protected async fetchQuery<\n    TQueryFnData extends Json,\n    TError = DefaultError,\n    TDataStruct extends Struct<TQueryFnData> | undefined = undefined,\n    TData = TDataStruct extends Struct<infer StructType>\n      ? StructType\n      : TQueryFnData,\n    TQueryKey extends QueryKey = QueryKey,\n  >({\n    responseStruct,\n    ...options\n  }: WithRequired<\n    OmitKeyof<\n      FetchQueryOptions<TQueryFnData, TError, TData, TQueryKey>,\n      'retry' | 'retryDelay' | 'queryFn'\n    >,\n    'queryKey'\n  > & {\n    queryFn: QueryFunction<TQueryFnData, TQueryKey>;\n    responseStruct?: TDataStruct;\n  }): Promise<TData> {\n    return this.#queryClient.fetchQuery({\n      ...options,\n      queryFn: async (context) => {\n        const response = await this.#policy.execute(() =>\n          options.queryFn(context),\n        );\n        return processQueryResponse(options.queryKey, response, responseStruct);\n      },\n    });\n  }\n\n  /**\n   * Fetch a paginated query.\n   *\n   * @param options - The options defining the query. Keep in mind that `queryKey` and `queryFn` are required when using data services.\n   * Additionally `retry` and `retryDelay` are not available, retries can be customized using the `servicePolicyOptions`.\n   * @param options.responseStruct - An optional struct for validating the response of the query function.\n   * @param pageParam - An optional page parameter.\n   * @returns The query result, exclusively the requested page is returned.\n   */\n  protected async fetchInfiniteQuery<\n    TQueryFnData extends Json,\n    TError = DefaultError,\n    TDataStruct extends Struct<TQueryFnData> | undefined = undefined,\n    TData extends TQueryFnData = TDataStruct extends Struct<infer StructType>\n      ? StructType\n      : TQueryFnData,\n    TQueryKey extends QueryKey = QueryKey,\n    TPageParam extends Json = Json,\n  >(\n    {\n      responseStruct,\n      ...options\n    }: WithRequired<\n      OmitKeyof<\n        FetchQueryOptions<\n          TQueryFnData,\n          TError,\n          InfiniteData<TData, TPageParam>,\n          TQueryKey,\n          TPageParam\n        >,\n        'retry' | 'retryDelay' | 'queryFn' | 'initialPageParam'\n      >,\n      'queryKey'\n    > &\n      InfiniteQueryPageParamsOptions<TQueryFnData, TPageParam> & {\n        queryFn: QueryFunction<TQueryFnData, TQueryKey, TPageParam>;\n        responseStruct?: TDataStruct;\n      },\n    pageParam?: TPageParam,\n  ): Promise<TData> {\n    const cache = this.#queryClient.getQueryCache();\n\n    const query = cache.find<\n      TQueryFnData,\n      TError,\n      InfiniteData<TData, TPageParam>\n    >({\n      queryKey: options.queryKey,\n    });\n\n    if (!query?.state.data || !pageParam) {\n      const result = await this.#queryClient.fetchInfiniteQuery({\n        ...options,\n        initialPageParam: pageParam ?? options.initialPageParam,\n        queryFn: async (context) => {\n          const response = await this.#policy.execute(async () =>\n            options.queryFn({\n              ...context,\n              pageParam: context.meta?.pageParam ?? context.pageParam,\n            }),\n          );\n          return processQueryResponse(\n            options.queryKey,\n            response,\n            responseStruct,\n          );\n        },\n      });\n\n      return result.pages[0];\n    }\n\n    const { pages, pageParams } = query.state.data;\n    const next = options.getNextPageParam(\n      pages[pages.length - 1],\n      pages,\n      pageParams[pageParams.length - 1],\n      pageParams,\n    );\n\n    const direction = deepEqual(pageParam, next) ? 'forward' : 'backward';\n\n    const result = await query.fetch(\n      { ...query.options, meta: { pageParam } },\n      { meta: { fetchMore: { direction } } },\n    );\n\n    const pageIndex = result.pageParams.findIndex((param) =>\n      deepEqual(param, pageParam),\n    );\n\n    return result.pages[pageIndex];\n  }\n\n  /**\n   * Invalidate queries serviced by this data service.\n   *\n   * @param filters - Optional filter for selecting specific queries.\n   * @param options - Additional optional options for query invalidations.\n   * @returns Nothing.\n   */\n  async invalidateQueries(\n    filters?: InvalidateQueryFilters<QueryKey>,\n    options?: InvalidateOptions,\n  ): Promise<void> {\n    return this.#queryClient.invalidateQueries(filters, options);\n  }\n\n  /**\n   * Initialize the service, rehydrating the cache with persisted data if possible.\n   */\n  init(): void {\n    this.#loadCache().catch(\n      /* istanbul ignore next */\n      (error) => this.#messenger.captureException?.(error),\n    );\n  }\n\n  /**\n   * Prepares the service for garbage collection. This should be extended\n   * by any subclasses to clean up any additional connections or events.\n   */\n  destroy(): void {\n    this.#debouncedPersist?.cancel();\n    this.#queryCacheUnsubscribe();\n    this.#queryClient.clear();\n    this.messenger.clearSubscriptions();\n    this.messenger.clearActions();\n  }\n\n  /**\n   * Publish `cacheUpdated` events when a given query changes.\n   *\n   * @param hash The hash of the query.\n   * @param type The type of cache update.\n   */\n  #publishCacheUpdate(hash: string, type: CacheUpdatedType): void {\n    const state =\n      type === 'added' || type === 'updated'\n        ? dehydrate(this.#queryClient, {\n            shouldDehydrateQuery: (query) => query.queryHash === hash,\n          })\n        : null;\n\n    this.#messenger.publish(\n      `${this.name}:cacheUpdated` as const,\n      {\n        type,\n        hash,\n        state,\n      } as DataServiceCacheUpdatedPayload,\n    );\n\n    this.#messenger.publish(\n      `${this.name}:cacheUpdated:${hash}` as const,\n      {\n        type,\n        state,\n      } as DataServiceGranularCacheUpdatedPayload,\n    );\n  }\n\n  /**\n   * Persist the query client cache using the StorageService, if the cache is not empty.\n   *\n   * @returns Nothing.\n   */\n  async #persistCache(): Promise<void> {\n    const state = dehydrate(this.#queryClient, {\n      // This is the default, but we specify it to be explicit.\n      shouldDehydrateQuery: (query) => query.state.status === 'success',\n    });\n\n    if (state.queries.length === 0 && state.mutations.length === 0) {\n      await this.#externalMessenger.call(\n        'StorageService:removeItem',\n        this.name,\n        STORAGE_SERVICE_KEY,\n      );\n      return;\n    }\n\n    const cache: PersistedCache = {\n      timestamp: Date.now(),\n      state,\n    };\n\n    await this.#externalMessenger.call(\n      'StorageService:setItem',\n      this.name,\n      STORAGE_SERVICE_KEY,\n      cache as unknown as Json,\n    );\n  }\n\n  /**\n   * Load the query client cache from the StorageService, if persistence is configured\n   * and the persisted cache is not expired.\n   *\n   * @returns Nothing.\n   */\n  async #loadCache(): Promise<void> {\n    if (!this.#persistenceConfig) {\n      return;\n    }\n\n    const { result: untypedCache } = await this.#externalMessenger.call(\n      'StorageService:getItem',\n      this.name,\n      STORAGE_SERVICE_KEY,\n    );\n\n    if (!untypedCache) {\n      return;\n    }\n\n    const cache = untypedCache as unknown as PersistedCache;\n\n    if (Date.now() - cache.timestamp >= this.#persistenceConfig.maxAge) {\n      await this.#externalMessenger.call(\n        'StorageService:removeItem',\n        this.name,\n        STORAGE_SERVICE_KEY,\n      );\n      return;\n    }\n\n    hydrate(this.#queryClient, cache.state);\n  }\n}\n"]}
+{"version":3,"file":"BaseDataService.mjs","sourceRoot":"","sources":["../src/BaseDataService.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  Messenger,\n  ActionConstraint,\n  EventConstraint,\n  MessengerActions,\n  MessengerEvents,\n} from '@metamask/messenger';\nimport type {\n  StorageServiceGetItemAction,\n  StorageServiceRemoveItemAction,\n  StorageServiceSetItemAction,\n} from '@metamask/storage-service';\nimport { Struct } from '@metamask/superstruct';\nimport { Duration, inMilliseconds } from '@metamask/utils';\nimport type { Json } from '@metamask/utils';\nimport {\n  DefaultError,\n  DefaultOptions,\n  DehydratedState,\n  FetchQueryOptions,\n  InfiniteData,\n  InfiniteQueryPageParamsOptions,\n  InvalidateOptions,\n  InvalidateQueryFilters,\n  MutationOptions,\n  OmitKeyof,\n  QueryClient,\n  QueryClientConfig,\n  QueryFunction,\n  WithRequired,\n  dehydrate,\n  hydrate,\n  hashKey,\n  MutationFunction,\n} from '@tanstack/query-core';\nimport deepEqual from 'fast-deep-equal';\nimport { debounce, DebouncedFunc } from 'lodash';\n\nimport {\n  createServicePolicy,\n  CreateServicePolicyOptions,\n  ServicePolicy,\n} from './createServicePolicy.js';\nimport { createModuleLogger, projectLogger } from './loggers.js';\nimport { processMutationResponse, processQueryResponse } from './utils.js';\n\nconst log = createModuleLogger(projectLogger, 'BaseDataService');\n\n/**\n * Data service mutations and queries use the following format:\n * `['${ServiceName}:${ActionName}', ...params]`\n */\ntype Key = [string, ...Json[]] | readonly [string, ...Json[]];\n\n/*\n * Data service queries use the following format:\n * `['${ServiceName}:${ActionName}', ...params]`\n */\nexport type QueryKey = Key;\n\n/*\n * Data service mutations use the following format:\n * `['${ServiceName}:${ActionName}', ...params]`\n */\nexport type MutationKey = Key;\n\n/**\n * The supertype of all messengers, scoped to a namespace.\n *\n * @template Namespace - The namespace for the messenger's own actions and\n * events.\n */\nexport type BaseMessenger<Namespace extends string> = Messenger<\n  Namespace,\n  ActionConstraint,\n  EventConstraint,\n  // Use `any` to allow any parent to be set. `any` is harmless in a type constraint anyway,\n  // it's the one totally safe place to use it.\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  any\n>;\n\nexport type DataServiceGranularCacheUpdatedPayload = {\n  objectType: 'query' | 'mutation';\n} & (\n  | { type: 'added' | 'updated'; state: DehydratedState }\n  | {\n      type: 'removed';\n      state: null;\n    }\n);\n\nexport type DataServiceCacheUpdatedPayload =\n  DataServiceGranularCacheUpdatedPayload & {\n    hash: string;\n  };\n\ntype CacheUpdatedType = DataServiceCacheUpdatedPayload['type'];\n\nexport type DataServiceInvalidateQueriesAction<ServiceName extends string> = {\n  type: `${ServiceName}:invalidateQueries`;\n  handler: BaseDataService<\n    ServiceName,\n    BaseMessenger<ServiceName>\n  >['invalidateQueries'];\n};\n\nexport type DataServiceActions<ServiceName extends string> =\n  DataServiceInvalidateQueriesAction<ServiceName>;\n\ntype DataServiceAllowedActions =\n  | StorageServiceGetItemAction\n  | StorageServiceSetItemAction\n  | StorageServiceRemoveItemAction;\n\nexport type DataServiceCacheUpdatedEvent<ServiceName extends string> = {\n  type: `${ServiceName}:cacheUpdated`;\n  payload: [DataServiceCacheUpdatedPayload];\n};\n\nexport type DataServiceGranularCacheUpdatedEvent<ServiceName extends string> = {\n  type: `${ServiceName}:cacheUpdated:${string}`;\n  payload: [DataServiceGranularCacheUpdatedPayload];\n};\n\nexport type DataServiceEvents<ServiceName extends string> =\n  | DataServiceCacheUpdatedEvent<ServiceName>\n  | DataServiceGranularCacheUpdatedEvent<ServiceName>;\n\n/*\n * Defaults to apply to all data service queries if no default option specified.\n */\nconst QUERY_CLIENT_DEFAULTS: DefaultOptions = {\n  queries: {\n    retry: false,\n    staleTime: inMilliseconds(1, Duration.Minute),\n  },\n  mutations: {\n    retry: false,\n  },\n};\n\nexport const STORAGE_SERVICE_KEY = 'cache';\n\n/**\n * Options for persistence configuration.\n */\nexport type PersistenceConfiguration = {\n  /**\n   * The maximum age before the cache is treated as expired in milliseconds.\n   * This is relevant for rehydrating the state during initialization,\n   * if the cached state is too old it will be discarded.\n   */\n  maxAge: number;\n  /**\n   * The number of milliseconds to wait before triggering persistence following a cache update.\n   */\n  writeDelay?: number;\n  /**\n   * The maximum number of milliseconds to wait between persistence writes.\n   */\n  maxWriteDelay?: number;\n};\n\ntype PersistedCache = {\n  state: DehydratedState;\n  timestamp: number;\n};\n\nexport class BaseDataService<\n  ServiceName extends string,\n  ServiceMessenger extends BaseMessenger<ServiceName>,\n> {\n  public readonly name: ServiceName;\n\n  readonly #messenger: Messenger<\n    ServiceName,\n    DataServiceActions<ServiceName>,\n    DataServiceEvents<ServiceName>\n  >;\n\n  readonly #externalMessenger: Messenger<\n    ServiceName,\n    DataServiceAllowedActions\n  >;\n\n  protected messenger: ServiceMessenger;\n\n  readonly #policy: ServicePolicy;\n\n  readonly #queryClient: QueryClient;\n\n  readonly #queryCacheUnsubscribe: () => void;\n\n  readonly #mutationCacheUnsubscribe: () => void;\n\n  readonly #debouncedPersist?: DebouncedFunc<() => void>;\n\n  readonly #persistenceConfig?: PersistenceConfiguration;\n\n  constructor({\n    name,\n    messenger,\n    queryClientConfig = {},\n    policyOptions,\n    persistenceConfig,\n  }: {\n    name: ServiceName;\n    messenger: DataServiceActions<ServiceName>['type'] extends\n      | MessengerActions<ServiceMessenger>['type']\n      | DataServiceAllowedActions['type']\n      ? DataServiceEvents<ServiceName>['type'] extends MessengerEvents<ServiceMessenger>['type']\n        ? ServiceMessenger\n        : never\n      : never;\n    queryClientConfig?: QueryClientConfig;\n    policyOptions?: CreateServicePolicyOptions;\n    persistenceConfig?: PersistenceConfiguration;\n  }) {\n    this.name = name;\n\n    // We store two narrowly-typed messengers alongside the generic public one:\n    // - #messenger handles the service's own action registration and event publishing\n    // - #externalMessenger handles calls to external actions\n    // Splitting them avoids TypeScript issues with mixing template-literals with regular strings\n    this.#messenger = messenger as unknown as Messenger<\n      ServiceName,\n      DataServiceActions<ServiceName>,\n      DataServiceEvents<ServiceName>\n    >;\n    this.#externalMessenger = messenger as unknown as Messenger<\n      ServiceName,\n      DataServiceAllowedActions\n    >;\n    this.messenger = messenger;\n\n    this.#queryClient = new QueryClient({\n      ...queryClientConfig,\n      defaultOptions: {\n        queries: {\n          ...QUERY_CLIENT_DEFAULTS.queries,\n          ...queryClientConfig.defaultOptions?.queries,\n        },\n        mutations: {\n          ...QUERY_CLIENT_DEFAULTS.mutations,\n          ...queryClientConfig.defaultOptions?.mutations,\n        },\n      },\n    });\n\n    this.#persistenceConfig = persistenceConfig;\n\n    this.#policy = createServicePolicy(policyOptions);\n\n    this.#debouncedPersist =\n      this.#persistenceConfig &&\n      debounce(\n        () => {\n          this.#persistCache().catch(\n            /* istanbul ignore next */\n            (error) => this.#messenger.captureException?.(error),\n          );\n        },\n        this.#persistenceConfig.writeDelay ??\n          inMilliseconds(10, Duration.Second),\n        {\n          maxWait:\n            this.#persistenceConfig.maxWriteDelay ??\n            inMilliseconds(1, Duration.Minute),\n        },\n      );\n\n    this.#queryCacheUnsubscribe = this.#queryClient\n      .getQueryCache()\n      .subscribe((event) => {\n        log('Query cache event emitted', event);\n        if (['added', 'updated', 'removed'].includes(event.type)) {\n          this.#publishCacheUpdate(\n            'query',\n            event.type as CacheUpdatedType,\n            event.query.queryHash,\n          );\n\n          this.#debouncedPersist?.();\n        }\n      });\n\n    log('Subscribing to mutation cache');\n    this.#mutationCacheUnsubscribe = this.#queryClient\n      .getMutationCache()\n      .subscribe((event) => {\n        log('Mutation cache event emitted', event);\n        if (\n          ['added', 'updated', 'removed'].includes(event.type) &&\n          event.mutation?.options.mutationKey !== undefined\n        ) {\n          const mutationHash = hashKey(event.mutation.options.mutationKey);\n          this.#publishCacheUpdate(\n            'mutation',\n            event.type as CacheUpdatedType,\n            mutationHash,\n          );\n\n          this.#debouncedPersist?.();\n        }\n      });\n\n    this.#messenger.registerActionHandler(\n      `${this.name}:invalidateQueries`,\n      this.invalidateQueries.bind(this),\n    );\n  }\n\n  /**\n   * Fetch a query.\n   *\n   * @param options - The options defining the query. Keep in mind that `queryKey` and `queryFn` are required when using data services.\n   * Additionally `retry` and `retryDelay` are not available, retries can be customized using the `servicePolicyOptions`.\n   * @param options.queryFn - The query function.\n   * @param options.responseStruct - An optional struct for validating the response of the query function.\n   * @returns The query results.\n   */\n  protected async fetchQuery<\n    TQueryFnData extends Json,\n    TError = DefaultError,\n    TDataStruct extends Struct<TQueryFnData> | undefined = undefined,\n    TData = TDataStruct extends Struct<infer StructType>\n      ? StructType\n      : TQueryFnData,\n    TQueryKey extends QueryKey = QueryKey,\n  >({\n    queryFn,\n    responseStruct,\n    ...options\n  }: WithRequired<\n    OmitKeyof<\n      FetchQueryOptions<TQueryFnData, TError, TData, TQueryKey>,\n      'retry' | 'retryDelay' | 'queryFn'\n    >,\n    'queryKey'\n  > & {\n    queryFn: QueryFunction<TQueryFnData, TQueryKey>;\n    responseStruct?: TDataStruct;\n  }): Promise<TData> {\n    return this.#queryClient.fetchQuery({\n      ...options,\n      queryFn: async (context) => {\n        const response = await this.#policy.execute(() => queryFn(context));\n        return processQueryResponse(options.queryKey, response, responseStruct);\n      },\n    });\n  }\n\n  /**\n   * Fetch a paginated query.\n   *\n   * @param options - The options defining the query. Keep in mind that `queryKey` and `queryFn` are required when using data services.\n   * Additionally `retry` and `retryDelay` are not available, retries can be customized using the `servicePolicyOptions`.\n   * @param options.responseStruct - An optional struct for validating the response of the query function.\n   * @param pageParam - An optional page parameter.\n   * @returns The query result, exclusively the requested page is returned.\n   */\n  protected async fetchInfiniteQuery<\n    TQueryFnData extends Json,\n    TError = DefaultError,\n    TDataStruct extends Struct<TQueryFnData> | undefined = undefined,\n    TData extends TQueryFnData = TDataStruct extends Struct<infer StructType>\n      ? StructType\n      : TQueryFnData,\n    TQueryKey extends QueryKey = QueryKey,\n    TPageParam extends Json = Json,\n  >(\n    {\n      responseStruct,\n      ...options\n    }: WithRequired<\n      OmitKeyof<\n        FetchQueryOptions<\n          TQueryFnData,\n          TError,\n          InfiniteData<TData, TPageParam>,\n          TQueryKey,\n          TPageParam\n        >,\n        'retry' | 'retryDelay' | 'queryFn' | 'initialPageParam'\n      >,\n      'queryKey'\n    > &\n      InfiniteQueryPageParamsOptions<TQueryFnData, TPageParam> & {\n        queryFn: QueryFunction<TQueryFnData, TQueryKey, TPageParam>;\n        responseStruct?: TDataStruct;\n      },\n    pageParam?: TPageParam,\n  ): Promise<TData> {\n    const cache = this.#queryClient.getQueryCache();\n\n    const query = cache.find<\n      TQueryFnData,\n      TError,\n      InfiniteData<TData, TPageParam>\n    >({\n      queryKey: options.queryKey,\n    });\n\n    if (!query?.state.data || !pageParam) {\n      const result = await this.#queryClient.fetchInfiniteQuery({\n        ...options,\n        initialPageParam: pageParam ?? options.initialPageParam,\n        queryFn: async (context) => {\n          const response = await this.#policy.execute(async () =>\n            options.queryFn({\n              ...context,\n              pageParam: context.meta?.pageParam ?? context.pageParam,\n            }),\n          );\n          return processQueryResponse(\n            options.queryKey,\n            response,\n            responseStruct,\n          );\n        },\n      });\n\n      return result.pages[0];\n    }\n\n    const { pages, pageParams } = query.state.data;\n    const next = options.getNextPageParam(\n      pages[pages.length - 1],\n      pages,\n      pageParams[pageParams.length - 1],\n      pageParams,\n    );\n\n    const direction = deepEqual(pageParam, next) ? 'forward' : 'backward';\n\n    const result = await query.fetch(\n      { ...query.options, meta: { pageParam } },\n      { meta: { fetchMore: { direction } } },\n    );\n\n    const pageIndex = result.pageParams.findIndex((param) =>\n      deepEqual(param, pageParam),\n    );\n\n    return result.pages[pageIndex];\n  }\n\n  /**\n   * Execute a mutation (e.g. a request that is expected to change server-side data).\n   * Unlike `fetchQuery`, the request will not be cached or retried.\n   *\n   * @param options - The options defining the mutation. Keep in mind that `mutationKey` and `mutationFn` are required when using data services.\n   * Additionally, `retry` and `retryDelay` are not available.\n   * @param options.mutationFn - The mutation function.\n   * @param options.responseStruct - An optional struct for validating the response of the mutation function.\n   * @param options.globalId - A string which uniquely identifies this mutation\n   * across different query clients — specifically, the one in this data service\n   * and the one that `createUIQueryClient` in `@metamask/react-data-query`\n   * holds (in fact usually you don't need to pass this — `createUIQueryClient`\n   * will do it automatically). This global ID will be stored in the new\n   * mutation `meta` data and included in `:cacheUpdated` payloads.\n   * @returns The mutation results.\n   */\n  protected async executeMutation<\n    TMutationFnData extends Json,\n    // We have to use `Struct<any>` here, as using `Struct<InputResponse>` (or\n    // even `Struct<unknown>`) would reject a more concrete, \"real world\" struct.\n    // The reason is that `Struct` is an object type with methods whose signatures\n    // feature the struct's content type, making `Struct` contravariant in its\n    // content type. The only way to get around this is to use `any`.\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    TDataStruct extends Struct<any> | undefined = undefined,\n    TData = TDataStruct extends Struct<infer StructType>\n      ? StructType\n      : TMutationFnData,\n    TError = DefaultError,\n    TOnMutateResult = unknown,\n    TMutationKey extends MutationKey = MutationKey,\n  >({\n    mutationFn,\n    responseStruct,\n    globalId,\n    ...options\n  }: OmitKeyof<\n    MutationOptions<TData, TError, Record<never, never>, TOnMutateResult>,\n    'retry' | 'retryDelay' | 'mutationKey' | 'mutationFn'\n  > & {\n    mutationKey: TMutationKey;\n    mutationFn: MutationFunction<TMutationFnData, Record<never, never>>;\n    responseStruct?: TDataStruct;\n    globalId?: string;\n  }): Promise<TData> {\n    const mutationCache = this.#queryClient.getMutationCache();\n    const mutation = mutationCache.build<\n      TData,\n      TError,\n      Record<never, never>,\n      TOnMutateResult\n    >(this.#queryClient, {\n      ...options,\n      ...(globalId !== undefined && {\n        meta: { ...options.meta, globalId },\n      }),\n      mutationFn: async (...args) => {\n        // To guard against mutations being retried, we deliberately execute the\n        // mutation function through the circuit breaker policy alone, rather\n        // than through `this.#policy` (which is a combination of both a\n        // circuit breaker policy and retry policy).\n        const response = await this.#policy.circuitBreakerPolicy.execute(() =>\n          mutationFn(...args),\n        );\n        return processMutationResponse(\n          options.mutationKey,\n          response,\n          responseStruct,\n        );\n      },\n    });\n    // We purposely pass an empty set of variables because this method is\n    // intended to be used internally by the data service, not end users, and\n    // the data service has full control of `mutationFn` anyway.\n    return await mutation.execute({});\n  }\n\n  /**\n   * Invalidate queries serviced by this data service.\n   *\n   * @param filters - Optional filter for selecting specific queries.\n   * @param options - Additional optional options for query invalidations.\n   * @returns Nothing.\n   */\n  async invalidateQueries(\n    filters?: InvalidateQueryFilters<QueryKey>,\n    options?: InvalidateOptions,\n  ): Promise<void> {\n    return this.#queryClient.invalidateQueries(filters, options);\n  }\n\n  /**\n   * Initialize the service, rehydrating the cache with persisted data if possible.\n   */\n  init(): void {\n    this.#loadCache().catch(\n      /* istanbul ignore next */\n      (error) => this.#messenger.captureException?.(error),\n    );\n  }\n\n  /**\n   * Prepares the service for garbage collection. This should be extended\n   * by any subclasses to clean up any additional connections or events.\n   */\n  destroy(): void {\n    this.#debouncedPersist?.cancel();\n    this.#queryCacheUnsubscribe();\n    this.#mutationCacheUnsubscribe();\n    // `QueryClient.clear()` clears both caches, but `MutationCache.clear()`\n    // only drops its references to mutations without clearing their pending\n    // garbage-collection timers. We destroy each mutation first so those timers\n    // are cleared and do not keep the process alive.\n    for (const mutation of this.#queryClient.getMutationCache().getAll()) {\n      mutation.destroy();\n    }\n    this.#queryClient.clear();\n    this.messenger.clearSubscriptions();\n    this.messenger.clearActions();\n  }\n\n  /**\n   * Publish `cacheUpdated` events when the query or mutation cache is updated.\n   *\n   * @param objectType - The type of object updated (\"query\" or \"mutation\").\n   * @param eventType - What happened to the query or mutation (\"added\" or \"updated\").\n   * @param hash - The hash of the query or mutation.\n   */\n  #publishCacheUpdate(\n    objectType: 'query' | 'mutation',\n    eventType: CacheUpdatedType,\n    hash: string,\n  ): void {\n    const state =\n      eventType === 'added' || eventType === 'updated'\n        ? dehydrate(this.#queryClient, {\n            shouldDehydrateQuery: (query) =>\n              objectType === 'query' && query.queryHash === hash,\n            shouldDehydrateMutation: (mutation) =>\n              objectType === 'mutation' &&\n              mutation.options.mutationKey !== undefined &&\n              hashKey(mutation.options.mutationKey) === hash,\n          })\n        : null;\n\n    this.#messenger.publish(\n      `${this.name}:cacheUpdated` as const,\n      {\n        type: eventType,\n        objectType,\n        hash,\n        state,\n      } as DataServiceCacheUpdatedPayload,\n    );\n    this.#messenger.publish(\n      `${this.name}:cacheUpdated:${hash}` as const,\n      {\n        type: eventType,\n        objectType,\n        state,\n      } as DataServiceGranularCacheUpdatedPayload,\n    );\n  }\n\n  /**\n   * Persist the query client cache using the StorageService, if the cache is not empty.\n   *\n   * @returns Nothing.\n   */\n  async #persistCache(): Promise<void> {\n    const state = dehydrate(this.#queryClient, {\n      // This is the default, but we specify it to be explicit.\n      shouldDehydrateQuery: (query) => query.state.status === 'success',\n    });\n\n    if (state.queries.length === 0 && state.mutations.length === 0) {\n      await this.#externalMessenger.call(\n        'StorageService:removeItem',\n        this.name,\n        STORAGE_SERVICE_KEY,\n      );\n      return;\n    }\n\n    const cache: PersistedCache = {\n      timestamp: Date.now(),\n      state,\n    };\n\n    await this.#externalMessenger.call(\n      'StorageService:setItem',\n      this.name,\n      STORAGE_SERVICE_KEY,\n      cache as unknown as Json,\n    );\n  }\n\n  /**\n   * Load the query client cache from the StorageService, if persistence is configured\n   * and the persisted cache is not expired.\n   *\n   * @returns Nothing.\n   */\n  async #loadCache(): Promise<void> {\n    if (!this.#persistenceConfig) {\n      return;\n    }\n\n    const { result: untypedCache } = await this.#externalMessenger.call(\n      'StorageService:getItem',\n      this.name,\n      STORAGE_SERVICE_KEY,\n    );\n\n    if (!untypedCache) {\n      return;\n    }\n\n    const cache = untypedCache as unknown as PersistedCache;\n\n    if (Date.now() - cache.timestamp >= this.#persistenceConfig.maxAge) {\n      await this.#externalMessenger.call(\n        'StorageService:removeItem',\n        this.name,\n        STORAGE_SERVICE_KEY,\n      );\n      return;\n    }\n\n    hydrate(this.#queryClient, cache.state);\n  }\n}\n"]}

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAKA,uCAQmB;AAPjB,+GAAA,kBAAkB,OAAA;AAClB,kHAAA,YAAY,OAAyB;AACrC,yGAAA,YAAY,OAAA;AACZ,4GAAA,eAAe,OAAA;AACf,+GAAA,kBAAkB,OAAA;AAClB,sGAAA,SAAS,OAAA;AACT,uGAAA,UAAU,OAAA;AAcZ,4DAAuD;AAA9C,qHAAA,eAAe,OAAA;AAExB,oEAMkC;AALhC,wIAAA,8BAA8B,OAAA;AAC9B,oIAAA,0BAA0B,OAAA;AAC1B,0IAAA,gCAAgC,OAAA;AAChC,6HAAA,mBAAmB,OAAA;AACnB,6HAAA,mBAAmB,OAAA","sourcesContent":["export type {\n  Event as CockatielEvent,\n  FailureReason as CockatielFailureReason,\n} from 'cockatiel';\n\nexport {\n  BrokenCircuitError,\n  EventEmitter as CockatielEventEmitter,\n  CircuitState,\n  ConstantBackoff,\n  ExponentialBackoff,\n  handleAll,\n  handleWhen,\n} from 'cockatiel';\n\nexport type {\n  DataServiceActions,\n  DataServiceEvents,\n  DataServiceCacheUpdatedPayload,\n  DataServiceGranularCacheUpdatedPayload,\n  DataServiceInvalidateQueriesAction,\n  DataServiceCacheUpdatedEvent,\n  DataServiceGranularCacheUpdatedEvent,\n  QueryKey,\n  PersistenceConfiguration,\n} from './BaseDataService.js';\nexport { BaseDataService } from './BaseDataService.js';\n\nexport {\n  DEFAULT_CIRCUIT_BREAK_DURATION,\n  DEFAULT_DEGRADED_THRESHOLD,\n  DEFAULT_MAX_CONSECUTIVE_FAILURES,\n  DEFAULT_MAX_RETRIES,\n  createServicePolicy,\n} from './createServicePolicy.js';\nexport type {\n  CreateServicePolicyOptions,\n  ServicePolicy,\n} from './createServicePolicy.js';\n"]}
+{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAKA,uCAQmB;AAPjB,+GAAA,kBAAkB,OAAA;AAClB,kHAAA,YAAY,OAAyB;AACrC,yGAAA,YAAY,OAAA;AACZ,4GAAA,eAAe,OAAA;AACf,+GAAA,kBAAkB,OAAA;AAClB,sGAAA,SAAS,OAAA;AACT,uGAAA,UAAU,OAAA;AAeZ,4DAAuD;AAA9C,qHAAA,eAAe,OAAA;AAExB,oEAMkC;AALhC,wIAAA,8BAA8B,OAAA;AAC9B,oIAAA,0BAA0B,OAAA;AAC1B,0IAAA,gCAAgC,OAAA;AAChC,6HAAA,mBAAmB,OAAA;AACnB,6HAAA,mBAAmB,OAAA","sourcesContent":["export type {\n  Event as CockatielEvent,\n  FailureReason as CockatielFailureReason,\n} from 'cockatiel';\n\nexport {\n  BrokenCircuitError,\n  EventEmitter as CockatielEventEmitter,\n  CircuitState,\n  ConstantBackoff,\n  ExponentialBackoff,\n  handleAll,\n  handleWhen,\n} from 'cockatiel';\n\nexport type {\n  DataServiceActions,\n  DataServiceEvents,\n  DataServiceCacheUpdatedPayload,\n  DataServiceGranularCacheUpdatedPayload,\n  DataServiceInvalidateQueriesAction,\n  DataServiceCacheUpdatedEvent,\n  DataServiceGranularCacheUpdatedEvent,\n  QueryKey,\n  MutationKey,\n  PersistenceConfiguration,\n} from './BaseDataService.js';\nexport { BaseDataService } from './BaseDataService.js';\n\nexport {\n  DEFAULT_CIRCUIT_BREAK_DURATION,\n  DEFAULT_DEGRADED_THRESHOLD,\n  DEFAULT_MAX_CONSECUTIVE_FAILURES,\n  DEFAULT_MAX_RETRIES,\n  createServicePolicy,\n} from './createServicePolicy.js';\nexport type {\n  CreateServicePolicyOptions,\n  ServicePolicy,\n} from './createServicePolicy.js';\n"]}

package/dist/index.d.cts

@@ -1,6 +1,6 @@
 export type { Event as CockatielEvent, FailureReason as CockatielFailureReason, } from "cockatiel";
 export { BrokenCircuitError, EventEmitter as CockatielEventEmitter, CircuitState, ConstantBackoff, ExponentialBackoff, handleAll, handleWhen, } from "cockatiel";
-export type { DataServiceActions, DataServiceEvents, DataServiceCacheUpdatedPayload, DataServiceGranularCacheUpdatedPayload, DataServiceInvalidateQueriesAction, DataServiceCacheUpdatedEvent, DataServiceGranularCacheUpdatedEvent, QueryKey, PersistenceConfiguration, } from "./BaseDataService.cjs";
+export type { DataServiceActions, DataServiceEvents, DataServiceCacheUpdatedPayload, DataServiceGranularCacheUpdatedPayload, DataServiceInvalidateQueriesAction, DataServiceCacheUpdatedEvent, DataServiceGranularCacheUpdatedEvent, QueryKey, MutationKey, PersistenceConfiguration, } from "./BaseDataService.cjs";
 export { BaseDataService } from "./BaseDataService.cjs";
 export { DEFAULT_CIRCUIT_BREAK_DURATION, DEFAULT_DEGRADED_THRESHOLD, DEFAULT_MAX_CONSECUTIVE_FAILURES, DEFAULT_MAX_RETRIES, createServicePolicy, } from "./createServicePolicy.cjs";
 export type { CreateServicePolicyOptions, ServicePolicy, } from "./createServicePolicy.cjs";

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,KAAK,IAAI,cAAc,EACvB,aAAa,IAAI,sBAAsB,GACxC,kBAAkB;AAEnB,OAAO,EACL,kBAAkB,EAClB,YAAY,IAAI,qBAAqB,EACrC,YAAY,EACZ,eAAe,EACf,kBAAkB,EAClB,SAAS,EACT,UAAU,GACX,kBAAkB;AAEnB,YAAY,EACV,kBAAkB,EAClB,iBAAiB,EACjB,8BAA8B,EAC9B,sCAAsC,EACtC,kCAAkC,EAClC,4BAA4B,EAC5B,oCAAoC,EACpC,QAAQ,EACR,wBAAwB,GACzB,8BAA6B;AAC9B,OAAO,EAAE,eAAe,EAAE,8BAA6B;AAEvD,OAAO,EACL,8BAA8B,EAC9B,0BAA0B,EAC1B,gCAAgC,EAChC,mBAAmB,EACnB,mBAAmB,GACpB,kCAAiC;AAClC,YAAY,EACV,0BAA0B,EAC1B,aAAa,GACd,kCAAiC"}
+{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,KAAK,IAAI,cAAc,EACvB,aAAa,IAAI,sBAAsB,GACxC,kBAAkB;AAEnB,OAAO,EACL,kBAAkB,EAClB,YAAY,IAAI,qBAAqB,EACrC,YAAY,EACZ,eAAe,EACf,kBAAkB,EAClB,SAAS,EACT,UAAU,GACX,kBAAkB;AAEnB,YAAY,EACV,kBAAkB,EAClB,iBAAiB,EACjB,8BAA8B,EAC9B,sCAAsC,EACtC,kCAAkC,EAClC,4BAA4B,EAC5B,oCAAoC,EACpC,QAAQ,EACR,WAAW,EACX,wBAAwB,GACzB,8BAA6B;AAC9B,OAAO,EAAE,eAAe,EAAE,8BAA6B;AAEvD,OAAO,EACL,8BAA8B,EAC9B,0BAA0B,EAC1B,gCAAgC,EAChC,mBAAmB,EACnB,mBAAmB,GACpB,kCAAiC;AAClC,YAAY,EACV,0BAA0B,EAC1B,aAAa,GACd,kCAAiC"}

package/dist/index.d.mts

@@ -1,6 +1,6 @@
 export type { Event as CockatielEvent, FailureReason as CockatielFailureReason, } from "cockatiel";
 export { BrokenCircuitError, EventEmitter as CockatielEventEmitter, CircuitState, ConstantBackoff, ExponentialBackoff, handleAll, handleWhen, } from "cockatiel";
-export type { DataServiceActions, DataServiceEvents, DataServiceCacheUpdatedPayload, DataServiceGranularCacheUpdatedPayload, DataServiceInvalidateQueriesAction, DataServiceCacheUpdatedEvent, DataServiceGranularCacheUpdatedEvent, QueryKey, PersistenceConfiguration, } from "./BaseDataService.mjs";
+export type { DataServiceActions, DataServiceEvents, DataServiceCacheUpdatedPayload, DataServiceGranularCacheUpdatedPayload, DataServiceInvalidateQueriesAction, DataServiceCacheUpdatedEvent, DataServiceGranularCacheUpdatedEvent, QueryKey, MutationKey, PersistenceConfiguration, } from "./BaseDataService.mjs";
 export { BaseDataService } from "./BaseDataService.mjs";
 export { DEFAULT_CIRCUIT_BREAK_DURATION, DEFAULT_DEGRADED_THRESHOLD, DEFAULT_MAX_CONSECUTIVE_FAILURES, DEFAULT_MAX_RETRIES, createServicePolicy, } from "./createServicePolicy.mjs";
 export type { CreateServicePolicyOptions, ServicePolicy, } from "./createServicePolicy.mjs";

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,KAAK,IAAI,cAAc,EACvB,aAAa,IAAI,sBAAsB,GACxC,kBAAkB;AAEnB,OAAO,EACL,kBAAkB,EAClB,YAAY,IAAI,qBAAqB,EACrC,YAAY,EACZ,eAAe,EACf,kBAAkB,EAClB,SAAS,EACT,UAAU,GACX,kBAAkB;AAEnB,YAAY,EACV,kBAAkB,EAClB,iBAAiB,EACjB,8BAA8B,EAC9B,sCAAsC,EACtC,kCAAkC,EAClC,4BAA4B,EAC5B,oCAAoC,EACpC,QAAQ,EACR,wBAAwB,GACzB,8BAA6B;AAC9B,OAAO,EAAE,eAAe,EAAE,8BAA6B;AAEvD,OAAO,EACL,8BAA8B,EAC9B,0BAA0B,EAC1B,gCAAgC,EAChC,mBAAmB,EACnB,mBAAmB,GACpB,kCAAiC;AAClC,YAAY,EACV,0BAA0B,EAC1B,aAAa,GACd,kCAAiC"}
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,KAAK,IAAI,cAAc,EACvB,aAAa,IAAI,sBAAsB,GACxC,kBAAkB;AAEnB,OAAO,EACL,kBAAkB,EAClB,YAAY,IAAI,qBAAqB,EACrC,YAAY,EACZ,eAAe,EACf,kBAAkB,EAClB,SAAS,EACT,UAAU,GACX,kBAAkB;AAEnB,YAAY,EACV,kBAAkB,EAClB,iBAAiB,EACjB,8BAA8B,EAC9B,sCAAsC,EACtC,kCAAkC,EAClC,4BAA4B,EAC5B,oCAAoC,EACpC,QAAQ,EACR,WAAW,EACX,wBAAwB,GACzB,8BAA6B;AAC9B,OAAO,EAAE,eAAe,EAAE,8BAA6B;AAEvD,OAAO,EACL,8BAA8B,EAC9B,0BAA0B,EAC1B,gCAAgC,EAChC,mBAAmB,EACnB,mBAAmB,GACpB,kCAAiC;AAClC,YAAY,EACV,0BAA0B,EAC1B,aAAa,GACd,kCAAiC"}

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,kBAAkB,EAClB,YAAY,IAAI,qBAAqB,EACrC,YAAY,EACZ,eAAe,EACf,kBAAkB,EAClB,SAAS,EACT,UAAU,EACX,kBAAkB;AAanB,OAAO,EAAE,eAAe,EAAE,8BAA6B;AAEvD,OAAO,EACL,8BAA8B,EAC9B,0BAA0B,EAC1B,gCAAgC,EAChC,mBAAmB,EACnB,mBAAmB,EACpB,kCAAiC","sourcesContent":["export type {\n  Event as CockatielEvent,\n  FailureReason as CockatielFailureReason,\n} from 'cockatiel';\n\nexport {\n  BrokenCircuitError,\n  EventEmitter as CockatielEventEmitter,\n  CircuitState,\n  ConstantBackoff,\n  ExponentialBackoff,\n  handleAll,\n  handleWhen,\n} from 'cockatiel';\n\nexport type {\n  DataServiceActions,\n  DataServiceEvents,\n  DataServiceCacheUpdatedPayload,\n  DataServiceGranularCacheUpdatedPayload,\n  DataServiceInvalidateQueriesAction,\n  DataServiceCacheUpdatedEvent,\n  DataServiceGranularCacheUpdatedEvent,\n  QueryKey,\n  PersistenceConfiguration,\n} from './BaseDataService.js';\nexport { BaseDataService } from './BaseDataService.js';\n\nexport {\n  DEFAULT_CIRCUIT_BREAK_DURATION,\n  DEFAULT_DEGRADED_THRESHOLD,\n  DEFAULT_MAX_CONSECUTIVE_FAILURES,\n  DEFAULT_MAX_RETRIES,\n  createServicePolicy,\n} from './createServicePolicy.js';\nexport type {\n  CreateServicePolicyOptions,\n  ServicePolicy,\n} from './createServicePolicy.js';\n"]}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,kBAAkB,EAClB,YAAY,IAAI,qBAAqB,EACrC,YAAY,EACZ,eAAe,EACf,kBAAkB,EAClB,SAAS,EACT,UAAU,EACX,kBAAkB;AAcnB,OAAO,EAAE,eAAe,EAAE,8BAA6B;AAEvD,OAAO,EACL,8BAA8B,EAC9B,0BAA0B,EAC1B,gCAAgC,EAChC,mBAAmB,EACnB,mBAAmB,EACpB,kCAAiC","sourcesContent":["export type {\n  Event as CockatielEvent,\n  FailureReason as CockatielFailureReason,\n} from 'cockatiel';\n\nexport {\n  BrokenCircuitError,\n  EventEmitter as CockatielEventEmitter,\n  CircuitState,\n  ConstantBackoff,\n  ExponentialBackoff,\n  handleAll,\n  handleWhen,\n} from 'cockatiel';\n\nexport type {\n  DataServiceActions,\n  DataServiceEvents,\n  DataServiceCacheUpdatedPayload,\n  DataServiceGranularCacheUpdatedPayload,\n  DataServiceInvalidateQueriesAction,\n  DataServiceCacheUpdatedEvent,\n  DataServiceGranularCacheUpdatedEvent,\n  QueryKey,\n  MutationKey,\n  PersistenceConfiguration,\n} from './BaseDataService.js';\nexport { BaseDataService } from './BaseDataService.js';\n\nexport {\n  DEFAULT_CIRCUIT_BREAK_DURATION,\n  DEFAULT_DEGRADED_THRESHOLD,\n  DEFAULT_MAX_CONSECUTIVE_FAILURES,\n  DEFAULT_MAX_RETRIES,\n  createServicePolicy,\n} from './createServicePolicy.js';\nexport type {\n  CreateServicePolicyOptions,\n  ServicePolicy,\n} from './createServicePolicy.js';\n"]}

package/dist/loggers.cjs

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createModuleLogger = exports.projectLogger = void 0;
+const utils_1 = require("@metamask/utils");
+Object.defineProperty(exports, "createModuleLogger", { enumerable: true, get: function () { return utils_1.createModuleLogger; } });
+exports.projectLogger = (0, utils_1.createProjectLogger)('base-data-service');
+//# sourceMappingURL=loggers.cjs.map

package/dist/loggers.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"loggers.cjs","sourceRoot":"","sources":["../src/loggers.ts"],"names":[],"mappings":";;;AAAA,2CAA0E;AAIjE,mGAJqB,0BAAkB,OAIrB;AAFd,QAAA,aAAa,GAAG,IAAA,2BAAmB,EAAC,mBAAmB,CAAC,CAAC","sourcesContent":["import { createProjectLogger, createModuleLogger } from '@metamask/utils';\n\nexport const projectLogger = createProjectLogger('base-data-service');\n\nexport { createModuleLogger };\n"]}

package/dist/loggers.d.cts

@@ -0,0 +1,5 @@
+/// <reference types="debug" />
+import { createModuleLogger } from "@metamask/utils";
+export declare const projectLogger: import("debug").Debugger;
+export { createModuleLogger };
+//# sourceMappingURL=loggers.d.cts.map

package/dist/loggers.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loggers.d.cts","sourceRoot":"","sources":["../src/loggers.ts"],"names":[],"mappings":";AAAA,OAAO,EAAuB,kBAAkB,EAAE,wBAAwB;AAE1E,eAAO,MAAM,aAAa,0BAA2C,CAAC;AAEtE,OAAO,EAAE,kBAAkB,EAAE,CAAC"}

package/dist/loggers.d.mts

@@ -0,0 +1,5 @@
+/// <reference types="debug" />
+import { createModuleLogger } from "@metamask/utils";
+export declare const projectLogger: import("debug").Debugger;
+export { createModuleLogger };
+//# sourceMappingURL=loggers.d.mts.map

package/dist/loggers.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loggers.d.mts","sourceRoot":"","sources":["../src/loggers.ts"],"names":[],"mappings":";AAAA,OAAO,EAAuB,kBAAkB,EAAE,wBAAwB;AAE1E,eAAO,MAAM,aAAa,0BAA2C,CAAC;AAEtE,OAAO,EAAE,kBAAkB,EAAE,CAAC"}

package/dist/loggers.mjs

@@ -0,0 +1,4 @@
+import { createProjectLogger, createModuleLogger } from "@metamask/utils";
+export const projectLogger = createProjectLogger('base-data-service');
+export { createModuleLogger };
+//# sourceMappingURL=loggers.mjs.map

package/dist/loggers.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"loggers.mjs","sourceRoot":"","sources":["../src/loggers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,wBAAwB;AAE1E,MAAM,CAAC,MAAM,aAAa,GAAG,mBAAmB,CAAC,mBAAmB,CAAC,CAAC;AAEtE,OAAO,EAAE,kBAAkB,EAAE,CAAC","sourcesContent":["import { createProjectLogger, createModuleLogger } from '@metamask/utils';\n\nexport const projectLogger = createProjectLogger('base-data-service');\n\nexport { createModuleLogger };\n"]}

package/dist/utils.cjs

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.processQueryResponse = void 0;
+exports.processMutationResponse = exports.processQueryResponse = void 0;
 const superstruct_1 = require("@metamask/superstruct");
 /**
  * Process query responses, validating them using Superstruct if a struct is defined.
@@ -22,4 +22,35 @@ function processQueryResponse(queryKey, response, struct) {
     return result;
 }
 exports.processQueryResponse = processQueryResponse;
+/**
+ * Process mutation responses, validating them using Superstruct if a struct is defined.
+ *
+ * @param mutationKey - The mutation key.
+ * @param response - The mutation response
+ * @param struct - The struct defining the schema for the mutation response.
+ * @returns The mutation response, coerced by Superstruct if needed.
+ * @throws If the mutation response does not match the struct.
+ * @template InputResponse - The type of the response data being validated, e.g. `Json`.
+ * @template ResponseStruct - The struct used to validate and decode the response,
+ * e.g. `Struct<FetchOrdersResponse>`, or `undefined` when no validation is needed.
+ */
+function processMutationResponse(mutationKey, response, struct) {
+    if (!struct) {
+        // Type assertion: TypeScript cannot "see" that when `struct` is
+        // `undefined`, `response` satisfies the `InputResponse` branch of
+        // `Response` (even though we stated this fact in the conditional type
+        // above). This is because at this point in time, `ResponseStruct` — being a
+        // generic — is unresolved, which makes `Response` unresolved too. This is a
+        // limitation of the way that generics work. Therefore, we need to help
+        // TypeScript out.
+        return response;
+    }
+    const [error, result] = (0, superstruct_1.validate)(response, struct);
+    if (error) {
+        throw new Error(`Mutation function for "${mutationKey[0]}" returned an unexpected response: ${error.message}.`);
+    }
+    // Type assertion: See above.
+    return result;
+}
+exports.processMutationResponse = processMutationResponse;
 //# sourceMappingURL=utils.cjs.map

package/dist/utils.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"utils.cjs","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":";;;AAAA,uDAAyD;AAIzD;;;;;;;;GAQG;AACH,SAAgB,oBAAoB,CAClC,QAAkB,EAClB,QAAkB,EAClB,MAAyB;IAEzB,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,IAAA,sBAAQ,EAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAEnD,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CACb,uBAAuB,QAAQ,CAAC,CAAC,CAAC,sCAAsC,KAAK,CAAC,OAAO,GAAG,CACzF,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAlBD,oDAkBC","sourcesContent":["import { Struct, validate } from '@metamask/superstruct';\n\nimport type { QueryKey } from './BaseDataService.js';\n\n/**\n * Process query responses, validating them using Superstruct if a struct is defined.\n *\n * @param queryKey - The query key.\n * @param response - The query response\n * @param struct - The struct defining the schema for the query response.\n * @returns The query response, coerced by Superstruct if needed.\n * @throws If the query response does not match the struct.\n */\nexport function processQueryResponse<Response>(\n  queryKey: QueryKey,\n  response: Response,\n  struct?: Struct<Response>,\n): Response {\n  if (!struct) {\n    return response;\n  }\n\n  const [error, result] = validate(response, struct);\n\n  if (error) {\n    throw new Error(\n      `Query function for \"${queryKey[0]}\" returned an unexpected response: ${error.message}.`,\n    );\n  }\n\n  return result;\n}\n"]}
+{"version":3,"file":"utils.cjs","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":";;;AAAA,uDAAyD;AAIzD;;;;;;;;GAQG;AACH,SAAgB,oBAAoB,CAClC,QAAkB,EAClB,QAAkB,EAClB,MAAyB;IAEzB,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,IAAA,sBAAQ,EAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAEnD,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CACb,uBAAuB,QAAQ,CAAC,CAAC,CAAC,sCAAsC,KAAK,CAAC,OAAO,GAAG,CACzF,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAlBD,oDAkBC;AAED;;;;;;;;;;;GAWG;AACH,SAAgB,uBAAuB,CAUrC,WAAwB,EACxB,QAAuB,EACvB,MAAuB;IAavB,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,gEAAgE;QAChE,kEAAkE;QAClE,sEAAsE;QACtE,4EAA4E;QAC5E,4EAA4E;QAC5E,uEAAuE;QACvE,kBAAkB;QAClB,OAAO,QAA+B,CAAC;IACzC,CAAC;IAED,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,IAAA,sBAAQ,EAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAEnD,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CACb,0BAA0B,WAAW,CAAC,CAAC,CAAC,sCAAsC,KAAK,CAAC,OAAO,GAAG,CAC/F,CAAC;IACJ,CAAC;IAED,6BAA6B;IAC7B,OAAO,MAA6B,CAAC;AACvC,CAAC;AA9CD,0DA8CC","sourcesContent":["import { Struct, validate } from '@metamask/superstruct';\n\nimport type { MutationKey, QueryKey } from './BaseDataService.js';\n\n/**\n * Process query responses, validating them using Superstruct if a struct is defined.\n *\n * @param queryKey - The query key.\n * @param response - The query response\n * @param struct - The struct defining the schema for the query response.\n * @returns The query response, coerced by Superstruct if needed.\n * @throws If the query response does not match the struct.\n */\nexport function processQueryResponse<Response>(\n  queryKey: QueryKey,\n  response: Response,\n  struct?: Struct<Response>,\n): Response {\n  if (!struct) {\n    return response;\n  }\n\n  const [error, result] = validate(response, struct);\n\n  if (error) {\n    throw new Error(\n      `Query function for \"${queryKey[0]}\" returned an unexpected response: ${error.message}.`,\n    );\n  }\n\n  return result;\n}\n\n/**\n * Process mutation responses, validating them using Superstruct if a struct is defined.\n *\n * @param mutationKey - The mutation key.\n * @param response - The mutation response\n * @param struct - The struct defining the schema for the mutation response.\n * @returns The mutation response, coerced by Superstruct if needed.\n * @throws If the mutation response does not match the struct.\n * @template InputResponse - The type of the response data being validated, e.g. `Json`.\n * @template ResponseStruct - The struct used to validate and decode the response,\n * e.g. `Struct<FetchOrdersResponse>`, or `undefined` when no validation is needed.\n */\nexport function processMutationResponse<\n  InputResponse,\n  // We have to use `Struct<any>` here, as using `Struct<InputResponse>` (or\n  // even `Struct<unknown>`) would reject a more concrete, \"real world\" struct.\n  // The reason is that `Struct` is an object type with methods whose signatures\n  // feature the struct's content type, making `Struct` contravariant in its\n  // content type. The only way to get around this is to use `any`.\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  ResponseStruct extends Struct<any> | undefined = undefined,\n>(\n  mutationKey: MutationKey,\n  response: InputResponse,\n  struct?: ResponseStruct,\n  // We don't want this to be a type parameter as it should not be customizable\n  // (it is only derived).\n): ResponseStruct extends Struct<infer StructType>\n  ? StructType\n  : InputResponse {\n  // Because we aren't defining the return type as a type parameter,\n  // we need to restate it so we can reuse it below.\n  type Response =\n    ResponseStruct extends Struct<infer StructType>\n      ? StructType\n      : InputResponse;\n\n  if (!struct) {\n    // Type assertion: TypeScript cannot \"see\" that when `struct` is\n    // `undefined`, `response` satisfies the `InputResponse` branch of\n    // `Response` (even though we stated this fact in the conditional type\n    // above). This is because at this point in time, `ResponseStruct` — being a\n    // generic — is unresolved, which makes `Response` unresolved too. This is a\n    // limitation of the way that generics work. Therefore, we need to help\n    // TypeScript out.\n    return response as unknown as Response;\n  }\n\n  const [error, result] = validate(response, struct);\n\n  if (error) {\n    throw new Error(\n      `Mutation function for \"${mutationKey[0]}\" returned an unexpected response: ${error.message}.`,\n    );\n  }\n\n  // Type assertion: See above.\n  return result as unknown as Response;\n}\n"]}

package/dist/utils.d.cts

@@ -1,5 +1,5 @@
 import { Struct } from "@metamask/superstruct";
-import type { QueryKey } from "./BaseDataService.cjs";
+import type { MutationKey, QueryKey } from "./BaseDataService.cjs";
 /**
  * Process query responses, validating them using Superstruct if a struct is defined.
  *
@@ -10,4 +10,17 @@ import type { QueryKey } from "./BaseDataService.cjs";
  * @throws If the query response does not match the struct.
  */
 export declare function processQueryResponse<Response>(queryKey: QueryKey, response: Response, struct?: Struct<Response>): Response;
+/**
+ * Process mutation responses, validating them using Superstruct if a struct is defined.
+ *
+ * @param mutationKey - The mutation key.
+ * @param response - The mutation response
+ * @param struct - The struct defining the schema for the mutation response.
+ * @returns The mutation response, coerced by Superstruct if needed.
+ * @throws If the mutation response does not match the struct.
+ * @template InputResponse - The type of the response data being validated, e.g. `Json`.
+ * @template ResponseStruct - The struct used to validate and decode the response,
+ * e.g. `Struct<FetchOrdersResponse>`, or `undefined` when no validation is needed.
+ */
+export declare function processMutationResponse<InputResponse, ResponseStruct extends Struct<any> | undefined = undefined>(mutationKey: MutationKey, response: InputResponse, struct?: ResponseStruct): ResponseStruct extends Struct<infer StructType> ? StructType : InputResponse;
 //# sourceMappingURL=utils.d.cts.map

package/dist/utils.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.cts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAY,8BAA8B;AAEzD,OAAO,KAAK,EAAE,QAAQ,EAAE,8BAA6B;AAErD;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAC3C,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,QAAQ,EAClB,MAAM,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,GACxB,QAAQ,CAcV"}
+{"version":3,"file":"utils.d.cts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAY,8BAA8B;AAEzD,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,8BAA6B;AAElE;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAC3C,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,QAAQ,EAClB,MAAM,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,GACxB,QAAQ,CAcV;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CACrC,aAAa,EAOb,cAAc,SAAS,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,GAAG,SAAS,EAE1D,WAAW,EAAE,WAAW,EACxB,QAAQ,EAAE,aAAa,EACvB,MAAM,CAAC,EAAE,cAAc,GAGtB,cAAc,SAAS,MAAM,CAAC,MAAM,UAAU,CAAC,GAC9C,UAAU,GACV,aAAa,CA6BhB"}

package/dist/utils.d.mts

@@ -1,5 +1,5 @@
 import { Struct } from "@metamask/superstruct";
-import type { QueryKey } from "./BaseDataService.mjs";
+import type { MutationKey, QueryKey } from "./BaseDataService.mjs";
 /**
  * Process query responses, validating them using Superstruct if a struct is defined.
  *
@@ -10,4 +10,17 @@ import type { QueryKey } from "./BaseDataService.mjs";
  * @throws If the query response does not match the struct.
  */
 export declare function processQueryResponse<Response>(queryKey: QueryKey, response: Response, struct?: Struct<Response>): Response;
+/**
+ * Process mutation responses, validating them using Superstruct if a struct is defined.
+ *
+ * @param mutationKey - The mutation key.
+ * @param response - The mutation response
+ * @param struct - The struct defining the schema for the mutation response.
+ * @returns The mutation response, coerced by Superstruct if needed.
+ * @throws If the mutation response does not match the struct.
+ * @template InputResponse - The type of the response data being validated, e.g. `Json`.
+ * @template ResponseStruct - The struct used to validate and decode the response,
+ * e.g. `Struct<FetchOrdersResponse>`, or `undefined` when no validation is needed.
+ */
+export declare function processMutationResponse<InputResponse, ResponseStruct extends Struct<any> | undefined = undefined>(mutationKey: MutationKey, response: InputResponse, struct?: ResponseStruct): ResponseStruct extends Struct<infer StructType> ? StructType : InputResponse;
 //# sourceMappingURL=utils.d.mts.map

package/dist/utils.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.mts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAY,8BAA8B;AAEzD,OAAO,KAAK,EAAE,QAAQ,EAAE,8BAA6B;AAErD;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAC3C,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,QAAQ,EAClB,MAAM,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,GACxB,QAAQ,CAcV"}
+{"version":3,"file":"utils.d.mts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAY,8BAA8B;AAEzD,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,8BAA6B;AAElE;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAC3C,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,QAAQ,EAClB,MAAM,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,GACxB,QAAQ,CAcV;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CACrC,aAAa,EAOb,cAAc,SAAS,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,GAAG,SAAS,EAE1D,WAAW,EAAE,WAAW,EACxB,QAAQ,EAAE,aAAa,EACvB,MAAM,CAAC,EAAE,cAAc,GAGtB,cAAc,SAAS,MAAM,CAAC,MAAM,UAAU,CAAC,GAC9C,UAAU,GACV,aAAa,CA6BhB"}

package/dist/utils.mjs

@@ -18,4 +18,34 @@ export function processQueryResponse(queryKey, response, struct) {
     }
     return result;
 }
+/**
+ * Process mutation responses, validating them using Superstruct if a struct is defined.
+ *
+ * @param mutationKey - The mutation key.
+ * @param response - The mutation response
+ * @param struct - The struct defining the schema for the mutation response.
+ * @returns The mutation response, coerced by Superstruct if needed.
+ * @throws If the mutation response does not match the struct.
+ * @template InputResponse - The type of the response data being validated, e.g. `Json`.
+ * @template ResponseStruct - The struct used to validate and decode the response,
+ * e.g. `Struct<FetchOrdersResponse>`, or `undefined` when no validation is needed.
+ */
+export function processMutationResponse(mutationKey, response, struct) {
+    if (!struct) {
+        // Type assertion: TypeScript cannot "see" that when `struct` is
+        // `undefined`, `response` satisfies the `InputResponse` branch of
+        // `Response` (even though we stated this fact in the conditional type
+        // above). This is because at this point in time, `ResponseStruct` — being a
+        // generic — is unresolved, which makes `Response` unresolved too. This is a
+        // limitation of the way that generics work. Therefore, we need to help
+        // TypeScript out.
+        return response;
+    }
+    const [error, result] = validate(response, struct);
+    if (error) {
+        throw new Error(`Mutation function for "${mutationKey[0]}" returned an unexpected response: ${error.message}.`);
+    }
+    // Type assertion: See above.
+    return result;
+}
 //# sourceMappingURL=utils.mjs.map

package/dist/utils.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"utils.mjs","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,8BAA8B;AAIzD;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB,CAClC,QAAkB,EAClB,QAAkB,EAClB,MAAyB;IAEzB,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAEnD,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CACb,uBAAuB,QAAQ,CAAC,CAAC,CAAC,sCAAsC,KAAK,CAAC,OAAO,GAAG,CACzF,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC","sourcesContent":["import { Struct, validate } from '@metamask/superstruct';\n\nimport type { QueryKey } from './BaseDataService.js';\n\n/**\n * Process query responses, validating them using Superstruct if a struct is defined.\n *\n * @param queryKey - The query key.\n * @param response - The query response\n * @param struct - The struct defining the schema for the query response.\n * @returns The query response, coerced by Superstruct if needed.\n * @throws If the query response does not match the struct.\n */\nexport function processQueryResponse<Response>(\n  queryKey: QueryKey,\n  response: Response,\n  struct?: Struct<Response>,\n): Response {\n  if (!struct) {\n    return response;\n  }\n\n  const [error, result] = validate(response, struct);\n\n  if (error) {\n    throw new Error(\n      `Query function for \"${queryKey[0]}\" returned an unexpected response: ${error.message}.`,\n    );\n  }\n\n  return result;\n}\n"]}
+{"version":3,"file":"utils.mjs","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,8BAA8B;AAIzD;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB,CAClC,QAAkB,EAClB,QAAkB,EAClB,MAAyB;IAEzB,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAEnD,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CACb,uBAAuB,QAAQ,CAAC,CAAC,CAAC,sCAAsC,KAAK,CAAC,OAAO,GAAG,CACzF,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,uBAAuB,CAUrC,WAAwB,EACxB,QAAuB,EACvB,MAAuB;IAavB,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,gEAAgE;QAChE,kEAAkE;QAClE,sEAAsE;QACtE,4EAA4E;QAC5E,4EAA4E;QAC5E,uEAAuE;QACvE,kBAAkB;QAClB,OAAO,QAA+B,CAAC;IACzC,CAAC;IAED,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAEnD,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CACb,0BAA0B,WAAW,CAAC,CAAC,CAAC,sCAAsC,KAAK,CAAC,OAAO,GAAG,CAC/F,CAAC;IACJ,CAAC;IAED,6BAA6B;IAC7B,OAAO,MAA6B,CAAC;AACvC,CAAC","sourcesContent":["import { Struct, validate } from '@metamask/superstruct';\n\nimport type { MutationKey, QueryKey } from './BaseDataService.js';\n\n/**\n * Process query responses, validating them using Superstruct if a struct is defined.\n *\n * @param queryKey - The query key.\n * @param response - The query response\n * @param struct - The struct defining the schema for the query response.\n * @returns The query response, coerced by Superstruct if needed.\n * @throws If the query response does not match the struct.\n */\nexport function processQueryResponse<Response>(\n  queryKey: QueryKey,\n  response: Response,\n  struct?: Struct<Response>,\n): Response {\n  if (!struct) {\n    return response;\n  }\n\n  const [error, result] = validate(response, struct);\n\n  if (error) {\n    throw new Error(\n      `Query function for \"${queryKey[0]}\" returned an unexpected response: ${error.message}.`,\n    );\n  }\n\n  return result;\n}\n\n/**\n * Process mutation responses, validating them using Superstruct if a struct is defined.\n *\n * @param mutationKey - The mutation key.\n * @param response - The mutation response\n * @param struct - The struct defining the schema for the mutation response.\n * @returns The mutation response, coerced by Superstruct if needed.\n * @throws If the mutation response does not match the struct.\n * @template InputResponse - The type of the response data being validated, e.g. `Json`.\n * @template ResponseStruct - The struct used to validate and decode the response,\n * e.g. `Struct<FetchOrdersResponse>`, or `undefined` when no validation is needed.\n */\nexport function processMutationResponse<\n  InputResponse,\n  // We have to use `Struct<any>` here, as using `Struct<InputResponse>` (or\n  // even `Struct<unknown>`) would reject a more concrete, \"real world\" struct.\n  // The reason is that `Struct` is an object type with methods whose signatures\n  // feature the struct's content type, making `Struct` contravariant in its\n  // content type. The only way to get around this is to use `any`.\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  ResponseStruct extends Struct<any> | undefined = undefined,\n>(\n  mutationKey: MutationKey,\n  response: InputResponse,\n  struct?: ResponseStruct,\n  // We don't want this to be a type parameter as it should not be customizable\n  // (it is only derived).\n): ResponseStruct extends Struct<infer StructType>\n  ? StructType\n  : InputResponse {\n  // Because we aren't defining the return type as a type parameter,\n  // we need to restate it so we can reuse it below.\n  type Response =\n    ResponseStruct extends Struct<infer StructType>\n      ? StructType\n      : InputResponse;\n\n  if (!struct) {\n    // Type assertion: TypeScript cannot \"see\" that when `struct` is\n    // `undefined`, `response` satisfies the `InputResponse` branch of\n    // `Response` (even though we stated this fact in the conditional type\n    // above). This is because at this point in time, `ResponseStruct` — being a\n    // generic — is unresolved, which makes `Response` unresolved too. This is a\n    // limitation of the way that generics work. Therefore, we need to help\n    // TypeScript out.\n    return response as unknown as Response;\n  }\n\n  const [error, result] = validate(response, struct);\n\n  if (error) {\n    throw new Error(\n      `Mutation function for \"${mutationKey[0]}\" returned an unexpected response: ${error.message}.`,\n    );\n  }\n\n  // Type assertion: See above.\n  return result as unknown as Response;\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metamask-previews/base-data-service",
-  "version": "1.0.0-preview-abca9bcea",
+  "version": "1.0.0-preview-8bfa290fb",
   "description": "Provides utilities for building data services",
   "keywords": [
     "Ethereum",