npm - @tanstack/query-db-collection - Versions diffs - 1.0.3 → 1.0.5 - Mend

@tanstack/query-db-collection 1.0.3 → 1.0.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (14) hide show

package/dist/esm/query.js CHANGED Viewed

@@ -100,6 +100,7 @@ function queryCollectionOptions(config) {
   const queryToRows = /* @__PURE__ */ new Map();
   const rowToQueries = /* @__PURE__ */ new Map();
   const unsubscribes = /* @__PURE__ */ new Map();
+  const queryRefCounts = /* @__PURE__ */ new Map();
   const addRow = (rowKey, hashedQueryKey) => {
     const rowToQueriesSet = rowToQueries.get(rowKey) || /* @__PURE__ */ new Set();
     rowToQueriesSet.add(hashedQueryKey);
@@ -120,19 +121,25 @@ function queryCollectionOptions(config) {
   const internalSync = (params) => {
     const { begin, write, commit, markReady, collection } = params;
     let syncStarted = false;
-    const createQueryFromOpts = (opts = {}, queryFunction = queryFn) => {
-      let key;
+    const generateQueryKeyFromOptions = (opts) => {
       if (typeof queryKey === `function`) {
-        key = queryKey(opts);
+        return queryKey(opts);
       } else if (syncMode === `on-demand`) {
         const serialized = serializeLoadSubsetOptions(opts);
-        key = serialized !== void 0 ? [...queryKey, serialized] : queryKey;
+        return serialized !== void 0 ? [...queryKey, serialized] : queryKey;
       } else {
-        key = queryKey;
+        return queryKey;
       }
+    };
+    const createQueryFromOpts = (opts = {}, queryFunction = queryFn) => {
+      const key = generateQueryKeyFromOptions(opts);
       const hashedQueryKey = hashKey(key);
       const extendedMeta = { ...meta, loadSubsetOptions: opts };
       if (state.observers.has(hashedQueryKey)) {
+        queryRefCounts.set(
+          hashedQueryKey,
+          (queryRefCounts.get(hashedQueryKey) || 0) + 1
+        );
         const observer = state.observers.get(hashedQueryKey);
         const currentResult = observer.getCurrentResult();
         if (currentResult.isSuccess) {
@@ -169,6 +176,10 @@ function queryCollectionOptions(config) {
       const localObserver = new QueryObserver(queryClient, observerOptions);
       hashToQueryKey.set(hashedQueryKey, key);
       state.observers.set(hashedQueryKey, localObserver);
+      queryRefCounts.set(
+        hashedQueryKey,
+        (queryRefCounts.get(hashedQueryKey) || 0) + 1
+      );
       const readyPromise = new Promise((resolve, reject) => {
         const unsubscribe = localObserver.subscribe((result) => {
           if (result.isSuccess) {
@@ -183,10 +194,6 @@ function queryCollectionOptions(config) {
       if (syncStarted || collection.subscriberCount > 0) {
         subscribeToQuery(localObserver, hashedQueryKey);
       }
-      const subscription = opts.subscription;
-      subscription?.once(`unsubscribed`, () => {
-        queryClient.removeQueries({ queryKey: key, exact: true });
-      });
       return readyPromise;
     };
     const makeQueryResultHandler = (queryKey2) => {
@@ -262,10 +269,14 @@ function queryCollectionOptions(config) {
     };
     const subscribeToQuery = (observer, hashedQueryKey) => {
       if (!isSubscribed(hashedQueryKey)) {
-        const queryKey2 = hashToQueryKey.get(hashedQueryKey);
-        const handleQueryResult = makeQueryResultHandler(queryKey2);
+        const cachedQueryKey = hashToQueryKey.get(hashedQueryKey);
+        const handleQueryResult = makeQueryResultHandler(cachedQueryKey);
         const unsubscribeFn = observer.subscribe(handleQueryResult);
         unsubscribes.set(hashedQueryKey, unsubscribeFn);
+        const currentResult = observer.getCurrentResult();
+        if (currentResult.isSuccess || currentResult.isError) {
+          handleQueryResult(currentResult);
+        }
       }
     };
     const subscribeToQueries = () => {
@@ -299,64 +310,110 @@ function queryCollectionOptions(config) {
     }
     subscribeToQueries();
     state.observers.forEach((observer, hashedQueryKey) => {
-      const queryKey2 = hashToQueryKey.get(hashedQueryKey);
-      const handleQueryResult = makeQueryResultHandler(queryKey2);
+      const cachedQueryKey = hashToQueryKey.get(hashedQueryKey);
+      const handleQueryResult = makeQueryResultHandler(cachedQueryKey);
       handleQueryResult(observer.getCurrentResult());
     });
-    const unsubscribeQueryCache = queryClient.getQueryCache().subscribe((event) => {
-      const hashedKey = event.query.queryHash;
-      if (event.type === `removed`) {
-        cleanupQuery(hashedKey);
-      }
-    });
-    function cleanupQuery(hashedQueryKey) {
+    const cleanupQueryInternal = (hashedQueryKey) => {
       unsubscribes.get(hashedQueryKey)?.();
+      unsubscribes.delete(hashedQueryKey);
       const rowKeys = queryToRows.get(hashedQueryKey) ?? /* @__PURE__ */ new Set();
+      const rowsToDelete = [];
       rowKeys.forEach((rowKey) => {
         const queries = rowToQueries.get(rowKey);
-        if (queries && queries.size > 0) {
-          queries.delete(hashedQueryKey);
-          if (queries.size === 0) {
-            rowToQueries.delete(rowKey);
-            if (collection.has(rowKey)) {
-              begin();
-              write({ type: `delete`, value: collection.get(rowKey) });
-              commit();
-            }
+        if (!queries) {
+          return;
+        }
+        queries.delete(hashedQueryKey);
+        if (queries.size === 0) {
+          rowToQueries.delete(rowKey);
+          if (collection.has(rowKey)) {
+            rowsToDelete.push(collection.get(rowKey));
           }
         }
       });
-      unsubscribes.delete(hashedQueryKey);
+      if (rowsToDelete.length > 0) {
+        begin();
+        rowsToDelete.forEach((row) => {
+          write({ type: `delete`, value: row });
+        });
+        commit();
+      }
       state.observers.delete(hashedQueryKey);
       queryToRows.delete(hashedQueryKey);
       hashToQueryKey.delete(hashedQueryKey);
-    }
+      queryRefCounts.delete(hashedQueryKey);
+    };
+    const cleanupQueryIfIdle = (hashedQueryKey) => {
+      const refcount = queryRefCounts.get(hashedQueryKey) || 0;
+      const observer = state.observers.get(hashedQueryKey);
+      if (refcount <= 0) {
+        unsubscribes.get(hashedQueryKey)?.();
+        unsubscribes.delete(hashedQueryKey);
+      }
+      const hasListeners = observer?.hasListeners() ?? false;
+      if (hasListeners) {
+        queryRefCounts.set(hashedQueryKey, 0);
+        return;
+      }
+      if (refcount > 0) {
+        console.warn(
+          `[cleanupQueryIfIdle] Invariant violation: refcount=${refcount} but no listeners. Cleaning up to prevent leak.`,
+          { hashedQueryKey }
+        );
+      }
+      cleanupQueryInternal(hashedQueryKey);
+    };
+    const forceCleanupQuery = (hashedQueryKey) => {
+      cleanupQueryInternal(hashedQueryKey);
+    };
+    const unsubscribeQueryCache = queryClient.getQueryCache().subscribe((event) => {
+      const hashedKey = event.query.queryHash;
+      if (event.type === `removed`) {
+        if (hashToQueryKey.has(hashedKey)) {
+          cleanupQueryIfIdle(hashedKey);
+        }
+      }
+    });
     const cleanup = async () => {
       unsubscribeFromCollectionEvents();
       unsubscribeFromQueries();
-      const queryKeys = [...hashToQueryKey.values()];
-      hashToQueryKey.clear();
-      queryToRows.clear();
-      rowToQueries.clear();
-      state.observers.clear();
+      const allQueryKeys = [...hashToQueryKey.values()];
+      const allHashedKeys = [...state.observers.keys()];
+      for (const hashedKey of allHashedKeys) {
+        forceCleanupQuery(hashedKey);
+      }
       unsubscribeQueryCache();
       await Promise.all(
-        queryKeys.map(async (queryKey2) => {
-          await queryClient.cancelQueries({ queryKey: queryKey2 });
-          queryClient.removeQueries({ queryKey: queryKey2 });
+        allQueryKeys.map(async (qKey) => {
+          await queryClient.cancelQueries({ queryKey: qKey, exact: true });
+          queryClient.removeQueries({ queryKey: qKey, exact: true });
         })
       );
     };
+    const unloadSubset = (options) => {
+      const key = generateQueryKeyFromOptions(options);
+      const hashedQueryKey = hashKey(key);
+      const currentCount = queryRefCounts.get(hashedQueryKey) || 0;
+      const newCount = currentCount - 1;
+      if (newCount <= 0) {
+        queryRefCounts.set(hashedQueryKey, 0);
+        cleanupQueryIfIdle(hashedQueryKey);
+      } else {
+        queryRefCounts.set(hashedQueryKey, newCount);
+      }
+    };
     const loadSubsetDedupe = syncMode === `eager` ? void 0 : createQueryFromOpts;
     return {
       loadSubset: loadSubsetDedupe,
+      unloadSubset: syncMode === `eager` ? void 0 : unloadSubset,
       cleanup
     };
   };
   const refetch = async (opts) => {
-    const queryKeys = [...hashToQueryKey.values()];
-    const refetchPromises = queryKeys.map((queryKey2) => {
-      const queryObserver = state.observers.get(hashKey(queryKey2));
+    const allQueryKeys = [...hashToQueryKey.values()];
+    const refetchPromises = allQueryKeys.map((qKey) => {
+      const queryObserver = state.observers.get(hashKey(qKey));
       return queryObserver.refetch({
         throwOnError: opts?.throwOnError
       });

package/dist/esm/query.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"query.js","sources":["../../src/query.ts"],"sourcesContent":["import { QueryObserver, hashKey } from \"@tanstack/query-core\"\nimport {\n GetKeyRequiredError,\n QueryClientRequiredError,\n QueryFnRequiredError,\n QueryKeyRequiredError,\n} from \"./errors\"\nimport { createWriteUtils } from \"./manual-sync\"\nimport { serializeLoadSubsetOptions } from \"./serialization\"\nimport type {\n BaseCollectionConfig,\n ChangeMessage,\n CollectionConfig,\n DeleteMutationFnParams,\n InsertMutationFnParams,\n LoadSubsetOptions,\n SyncConfig,\n UpdateMutationFnParams,\n UtilsRecord,\n} from \"@tanstack/db\"\nimport type {\n FetchStatus,\n QueryClient,\n QueryFunctionContext,\n QueryKey,\n QueryObserverOptions,\n QueryObserverResult,\n} from \"@tanstack/query-core\"\nimport type { StandardSchemaV1 } from \"@standard-schema/spec\"\n\n// Re-export for external use\nexport type { SyncOperation } from \"./manual-sync\"\n\n/*\n Base type for Query Collection meta properties.\n * Users can extend this type when augmenting the @tanstack/query-core module\n * to add their own custom properties while preserving loadSubsetOptions.\n \n @example\n * ```typescript\n * declare module \"@tanstack/query-core\" {\n * interface Register {\n * queryMeta: QueryCollectionMeta & {\n * myCustomProperty: string\n * }\n * }\n * }\n * ```\n /\nexport type QueryCollectionMeta = Record<string, unknown> & {\n loadSubsetOptions: LoadSubsetOptions\n}\n\n// Module augmentation to extend TanStack Query's Register interface\n// This ensures that ctx.meta always includes loadSubsetOptions\n// We extend Record<string, unknown> to preserve the ability to add other meta properties\ndeclare module \"@tanstack/query-core\" {\n interface Register {\n queryMeta: QueryCollectionMeta\n }\n}\n\n// Schema output type inference helper (matches electric.ts pattern)\ntype InferSchemaOutput<T> = T extends StandardSchemaV1\n ? StandardSchemaV1.InferOutput<T> extends object\n ? StandardSchemaV1.InferOutput<T>\n : Record<string, unknown>\n : Record<string, unknown>\n\n// Schema input type inference helper (matches electric.ts pattern)\ntype InferSchemaInput<T> = T extends StandardSchemaV1\n ? StandardSchemaV1.InferInput<T> extends object\n ? StandardSchemaV1.InferInput<T>\n : Record<string, unknown>\n : Record<string, unknown>\n\ntype TQueryKeyBuilder<TQueryKey> = (opts: LoadSubsetOptions) => TQueryKey\n\n/\n Configuration options for creating a Query Collection\n * @template T - The explicit type of items stored in the collection\n * @template TQueryFn - The queryFn type\n * @template TError - The type of errors that can occur during queries\n * @template TQueryKey - The type of the query key\n * @template TKey - The type of the item keys\n * @template TSchema - The schema type for validation\n /\nexport interface QueryCollectionConfig<\n T extends object = object,\n TQueryFn extends (context: QueryFunctionContext<any>) => Promise<any> = (\n context: QueryFunctionContext<any>\n ) => Promise<any>,\n TError = unknown,\n TQueryKey extends QueryKey = QueryKey,\n TKey extends string \| number = string \| number,\n TSchema extends StandardSchemaV1 = never,\n TQueryData = Awaited<ReturnType<TQueryFn>>,\n> extends BaseCollectionConfig<T, TKey, TSchema> {\n /* The query key used by TanStack Query to identify this query /\n queryKey: TQueryKey \| TQueryKeyBuilder<TQueryKey>\n /* Function that fetches data from the server. Must return the complete collection state /\n queryFn: TQueryFn extends (\n context: QueryFunctionContext<TQueryKey>\n ) => Promise<Array<any>>\n ? (context: QueryFunctionContext<TQueryKey>) => Promise<Array<T>>\n : TQueryFn\n / Function that extracts array items from wrapped API responses (e.g metadata, pagination) /\n select?: (data: TQueryData) => Array<T>\n /* The TanStack Query client instance /\n queryClient: QueryClient\n\n // Query-specific options\n /* Whether the query should automatically run (default: true) /\n enabled?: boolean\n refetchInterval?: QueryObserverOptions<\n Array<T>,\n TError,\n Array<T>,\n Array<T>,\n TQueryKey\n >[`refetchInterval`]\n retry?: QueryObserverOptions<\n Array<T>,\n TError,\n Array<T>,\n Array<T>,\n TQueryKey\n >[`retry`]\n retryDelay?: QueryObserverOptions<\n Array<T>,\n TError,\n Array<T>,\n Array<T>,\n TQueryKey\n >[`retryDelay`]\n staleTime?: QueryObserverOptions<\n Array<T>,\n TError,\n Array<T>,\n Array<T>,\n TQueryKey\n >[`staleTime`]\n\n /\n Metadata to pass to the query.\n * Available in queryFn via context.meta\n \n @example\n * // Using meta for error context\n * queryFn: async (context) => {\n * try {\n * return await api.getTodos(userId)\n * } catch (error) {\n * // Use meta for better error messages\n * throw new Error(\n * context.meta?.errorMessage \|\| 'Failed to load todos'\n * )\n * }\n * },\n * meta: {\n * errorMessage: `Failed to load todos for user ${userId}`\n * }\n /\n meta?: Record<string, unknown>\n}\n\n/\n Type for the refetch utility function\n * Returns the QueryObserverResult from TanStack Query\n /\nexport type RefetchFn = (opts?: {\n throwOnError?: boolean\n}) => Promise<QueryObserverResult<any, any> \| void>\n\n/\n Utility methods available on Query Collections for direct writes and manual operations.\n * Direct writes bypass the normal query/mutation flow and write directly to the synced data store.\n * @template TItem - The type of items stored in the collection\n * @template TKey - The type of the item keys\n * @template TInsertInput - The type accepted for insert operations\n * @template TError - The type of errors that can occur during queries\n /\nexport interface QueryCollectionUtils<\n TItem extends object = Record<string, unknown>,\n TKey extends string \| number = string \| number,\n TInsertInput extends object = TItem,\n TError = unknown,\n> extends UtilsRecord {\n /* Manually trigger a refetch of the query /\n refetch: RefetchFn\n /* Insert one or more items directly into the synced data store without triggering a query refetch or optimistic update /\n writeInsert: (data: TInsertInput \| Array<TInsertInput>) => void\n /* Update one or more items directly in the synced data store without triggering a query refetch or optimistic update /\n writeUpdate: (updates: Partial<TItem> \| Array<Partial<TItem>>) => void\n /* Delete one or more items directly from the synced data store without triggering a query refetch or optimistic update /\n writeDelete: (keys: TKey \| Array<TKey>) => void\n /* Insert or update one or more items directly in the synced data store without triggering a query refetch or optimistic update /\n writeUpsert: (data: Partial<TItem> \| Array<Partial<TItem>>) => void\n /* Execute multiple write operations as a single atomic batch to the synced data store /\n writeBatch: (callback: () => void) => void\n\n // Query Observer State (getters)\n /* Get the last error encountered by the query (if any); reset on success /\n lastError: TError \| undefined\n /* Check if the collection is in an error state /\n isError: boolean\n /\n Get the number of consecutive sync failures.\n * Incremented only when query fails completely (not per retry attempt); reset on success.\n /\n errorCount: number\n /* Check if query is currently fetching (initial or background) /\n isFetching: boolean\n /* Check if query is refetching in background (not initial fetch) /\n isRefetching: boolean\n /* Check if query is loading for the first time (no data yet) /\n isLoading: boolean\n /* Get timestamp of last successful data update (in milliseconds) /\n dataUpdatedAt: number\n /* Get current fetch status /\n fetchStatus: `fetching` \| `paused` \| `idle`\n\n /\n Clear the error state and trigger a refetch of the query\n * @returns Promise that resolves when the refetch completes successfully\n * @throws Error if the refetch fails\n /\n clearError: () => Promise<void>\n}\n\n/\n Internal state object for tracking query observer and errors\n /\ninterface QueryCollectionState {\n lastError: any\n errorCount: number\n lastErrorUpdatedAt: number\n observers: Map<\n string,\n QueryObserver<Array<any>, any, Array<any>, Array<any>, any>\n >\n}\n\n/\n Implementation class for QueryCollectionUtils with explicit dependency injection\n * for better testability and architectural clarity\n /\nclass QueryCollectionUtilsImpl {\n private state: QueryCollectionState\n private refetchFn: RefetchFn\n\n // Write methods\n public refetch: RefetchFn\n public writeInsert: any\n public writeUpdate: any\n public writeDelete: any\n public writeUpsert: any\n public writeBatch: any\n\n constructor(\n state: QueryCollectionState,\n refetch: RefetchFn,\n writeUtils: ReturnType<typeof createWriteUtils>\n ) {\n this.state = state\n this.refetchFn = refetch\n\n // Initialize methods to use passed dependencies\n this.refetch = refetch\n this.writeInsert = writeUtils.writeInsert\n this.writeUpdate = writeUtils.writeUpdate\n this.writeDelete = writeUtils.writeDelete\n this.writeUpsert = writeUtils.writeUpsert\n this.writeBatch = writeUtils.writeBatch\n }\n\n public async clearError() {\n this.state.lastError = undefined\n this.state.errorCount = 0\n this.state.lastErrorUpdatedAt = 0\n await this.refetchFn({ throwOnError: true })\n }\n\n // Getters for error state\n public get lastError() {\n return this.state.lastError\n }\n\n public get isError() {\n return !!this.state.lastError\n }\n\n public get errorCount() {\n return this.state.errorCount\n }\n\n // Getters for QueryObserver state\n public get isFetching() {\n // check if any observer is fetching\n return Array.from(this.state.observers.values()).some(\n (observer) => observer.getCurrentResult().isFetching\n )\n }\n\n public get isRefetching() {\n // check if any observer is refetching\n return Array.from(this.state.observers.values()).some(\n (observer) => observer.getCurrentResult().isRefetching\n )\n }\n\n public get isLoading() {\n // check if any observer is loading\n return Array.from(this.state.observers.values()).some(\n (observer) => observer.getCurrentResult().isLoading\n )\n }\n\n public get dataUpdatedAt() {\n // compute the max dataUpdatedAt of all observers\n return Math.max(\n 0,\n ...Array.from(this.state.observers.values()).map(\n (observer) => observer.getCurrentResult().dataUpdatedAt\n )\n )\n }\n\n public get fetchStatus(): Array<FetchStatus> {\n return Array.from(this.state.observers.values()).map(\n (observer) => observer.getCurrentResult().fetchStatus\n )\n }\n}\n\n/\n Creates query collection options for use with a standard Collection.\n * This integrates TanStack Query with TanStack DB for automatic synchronization.\n \n Supports automatic type inference following the priority order:\n * 1. Schema inference (highest priority)\n * 2. QueryFn return type inference (second priority)\n \n @template T - Type of the schema if a schema is provided otherwise it is the type of the values returned by the queryFn\n * @template TError - The type of errors that can occur during queries\n * @template TQueryKey - The type of the query key\n * @template TKey - The type of the item keys\n * @param config - Configuration options for the Query collection\n * @returns Collection options with utilities for direct writes and manual operations\n \n @example\n * // Type inferred from queryFn return type (NEW!)\n * const todosCollection = createCollection(\n * queryCollectionOptions({\n * queryKey: ['todos'],\n * queryFn: async () => {\n * const response = await fetch('/api/todos')\n * return response.json() as Todo[] // Type automatically inferred!\n * },\n * queryClient,\n * getKey: (item) => item.id, // item is typed as Todo\n * })\n * )\n \n @example\n * // Explicit type\n * const todosCollection = createCollection<Todo>(\n * queryCollectionOptions({\n * queryKey: ['todos'],\n * queryFn: async () => fetch('/api/todos').then(r => r.json()),\n * queryClient,\n * getKey: (item) => item.id,\n * })\n * )\n \n @example\n * // Schema inference\n * const todosCollection = createCollection(\n * queryCollectionOptions({\n * queryKey: ['todos'],\n * queryFn: async () => fetch('/api/todos').then(r => r.json()),\n * queryClient,\n * schema: todoSchema, // Type inferred from schema\n * getKey: (item) => item.id,\n * })\n * )\n \n @example\n * // With persistence handlers\n * const todosCollection = createCollection(\n * queryCollectionOptions({\n * queryKey: ['todos'],\n * queryFn: fetchTodos,\n * queryClient,\n * getKey: (item) => item.id,\n * onInsert: async ({ transaction }) => {\n * await api.createTodos(transaction.mutations.map(m => m.modified))\n * },\n * onUpdate: async ({ transaction }) => {\n * await api.updateTodos(transaction.mutations)\n * },\n * onDelete: async ({ transaction }) => {\n * await api.deleteTodos(transaction.mutations.map(m => m.key))\n * }\n * })\n * )\n \n @example\n * // The select option extracts the items array from a response with metadata\n * const todosCollection = createCollection(\n * queryCollectionOptions({\n * queryKey: ['todos'],\n * queryFn: async () => fetch('/api/todos').then(r => r.json()),\n * select: (data) => data.items, // Extract the array of items\n * queryClient,\n * schema: todoSchema,\n * getKey: (item) => item.id,\n * })\n * )\n /\n// Overload for when schema is provided and select present\nexport function queryCollectionOptions<\n T extends StandardSchemaV1,\n TQueryFn extends (context: QueryFunctionContext<any>) => Promise<any>,\n TError = unknown,\n TQueryKey extends QueryKey = QueryKey,\n TKey extends string \| number = string \| number,\n TQueryData = Awaited<ReturnType<TQueryFn>>,\n>(\n config: QueryCollectionConfig<\n InferSchemaOutput<T>,\n TQueryFn,\n TError,\n TQueryKey,\n TKey,\n T\n > & {\n schema: T\n select: (data: TQueryData) => Array<InferSchemaInput<T>>\n }\n): CollectionConfig<\n InferSchemaOutput<T>,\n TKey,\n T,\n QueryCollectionUtils<InferSchemaOutput<T>, TKey, InferSchemaInput<T>, TError>\n> & {\n schema: T\n utils: QueryCollectionUtils<\n InferSchemaOutput<T>,\n TKey,\n InferSchemaInput<T>,\n TError\n >\n}\n\n// Overload for when no schema is provided and select present\nexport function queryCollectionOptions<\n T extends object,\n TQueryFn extends (context: QueryFunctionContext<any>) => Promise<any> = (\n context: QueryFunctionContext<any>\n ) => Promise<any>,\n TError = unknown,\n TQueryKey extends QueryKey = QueryKey,\n TKey extends string \| number = string \| number,\n TQueryData = Awaited<ReturnType<TQueryFn>>,\n>(\n config: QueryCollectionConfig<\n T,\n TQueryFn,\n TError,\n TQueryKey,\n TKey,\n never,\n TQueryData\n > & {\n schema?: never // prohibit schema\n select: (data: TQueryData) => Array<T>\n }\n): CollectionConfig<\n T,\n TKey,\n never,\n QueryCollectionUtils<T, TKey, T, TError>\n> & {\n schema?: never // no schema in the result\n utils: QueryCollectionUtils<T, TKey, T, TError>\n}\n\n// Overload for when schema is provided\nexport function queryCollectionOptions<\n T extends StandardSchemaV1,\n TError = unknown,\n TQueryKey extends QueryKey = QueryKey,\n TKey extends string \| number = string \| number,\n>(\n config: QueryCollectionConfig<\n InferSchemaOutput<T>,\n (\n context: QueryFunctionContext<any>\n ) => Promise<Array<InferSchemaOutput<T>>>,\n TError,\n TQueryKey,\n TKey,\n T\n > & {\n schema: T\n }\n): CollectionConfig<\n InferSchemaOutput<T>,\n TKey,\n T,\n QueryCollectionUtils<InferSchemaOutput<T>, TKey, InferSchemaInput<T>, TError>\n> & {\n schema: T\n utils: QueryCollectionUtils<\n InferSchemaOutput<T>,\n TKey,\n InferSchemaInput<T>,\n TError\n >\n}\n\n// Overload for when no schema is provided\nexport function queryCollectionOptions<\n T extends object,\n TError = unknown,\n TQueryKey extends QueryKey = QueryKey,\n TKey extends string \| number = string \| number,\n>(\n config: QueryCollectionConfig<\n T,\n (context: QueryFunctionContext<any>) => Promise<Array<T>>,\n TError,\n TQueryKey,\n TKey\n > & {\n schema?: never // prohibit schema\n }\n): CollectionConfig<\n T,\n TKey,\n never,\n QueryCollectionUtils<T, TKey, T, TError>\n> & {\n schema?: never // no schema in the result\n utils: QueryCollectionUtils<T, TKey, T, TError>\n}\n\nexport function queryCollectionOptions(\n config: QueryCollectionConfig<Record<string, unknown>>\n): CollectionConfig<\n Record<string, unknown>,\n string \| number,\n never,\n QueryCollectionUtils\n> & {\n utils: QueryCollectionUtils\n} {\n const {\n queryKey,\n queryFn,\n select,\n queryClient,\n enabled,\n refetchInterval,\n retry,\n retryDelay,\n staleTime,\n getKey,\n onInsert,\n onUpdate,\n onDelete,\n meta,\n ...baseCollectionConfig\n } = config\n\n // Default to eager sync mode if not provided\n const syncMode = baseCollectionConfig.syncMode ?? `eager`\n\n // Validate required parameters\n\n // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n if (!queryKey) {\n throw new QueryKeyRequiredError()\n }\n // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n if (!queryFn) {\n throw new QueryFnRequiredError()\n }\n\n // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n if (!queryClient) {\n throw new QueryClientRequiredError()\n }\n\n // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n if (!getKey) {\n throw new GetKeyRequiredError()\n }\n\n /* State object to hold error tracking and observer reference /\n const state: QueryCollectionState = {\n lastError: undefined as any,\n errorCount: 0,\n lastErrorUpdatedAt: 0,\n observers: new Map<\n string,\n QueryObserver<Array<any>, any, Array<any>, Array<any>, any>\n >(),\n }\n\n // hashedQueryKey → queryKey\n const hashToQueryKey = new Map<string, QueryKey>()\n\n // queryKey → Set<RowKey>\n const queryToRows = new Map<string, Set<string \| number>>()\n\n // RowKey → Set<queryKey>\n const rowToQueries = new Map<string \| number, Set<string>>()\n\n // queryKey → QueryObserver's unsubscribe function\n const unsubscribes = new Map<string, () => void>()\n\n // Helper function to add a row to the internal state\n const addRow = (rowKey: string \| number, hashedQueryKey: string) => {\n const rowToQueriesSet = rowToQueries.get(rowKey) \|\| new Set()\n rowToQueriesSet.add(hashedQueryKey)\n rowToQueries.set(rowKey, rowToQueriesSet)\n\n const queryToRowsSet = queryToRows.get(hashedQueryKey) \|\| new Set()\n queryToRowsSet.add(rowKey)\n queryToRows.set(hashedQueryKey, queryToRowsSet)\n }\n\n // Helper function to remove a row from the internal state\n const removeRow = (rowKey: string \| number, hashedQuerKey: string) => {\n const rowToQueriesSet = rowToQueries.get(rowKey) \|\| new Set()\n rowToQueriesSet.delete(hashedQuerKey)\n rowToQueries.set(rowKey, rowToQueriesSet)\n\n const queryToRowsSet = queryToRows.get(hashedQuerKey) \|\| new Set()\n queryToRowsSet.delete(rowKey)\n queryToRows.set(hashedQuerKey, queryToRowsSet)\n\n return rowToQueriesSet.size === 0\n }\n\n const internalSync: SyncConfig<any>[`sync`] = (params) => {\n const { begin, write, commit, markReady, collection } = params\n\n // Track whether sync has been started\n let syncStarted = false\n\n const createQueryFromOpts = (\n opts: LoadSubsetOptions = {},\n queryFunction: typeof queryFn = queryFn\n ): true \| Promise<void> => {\n // Push the predicates down to the queryKey and queryFn\n let key: QueryKey\n if (typeof queryKey === `function`) {\n // Function-based queryKey: use it to build the key from opts\n key = queryKey(opts)\n } else if (syncMode === `on-demand`) {\n // Static queryKey in on-demand mode: automatically append serialized predicates\n // to create separate cache entries for different predicate combinations\n const serialized = serializeLoadSubsetOptions(opts)\n key = serialized !== undefined ? [...queryKey, serialized] : queryKey\n } else {\n // Static queryKey in eager mode: use as-is\n key = queryKey\n }\n const hashedQueryKey = hashKey(key)\n const extendedMeta = { ...meta, loadSubsetOptions: opts }\n\n if (state.observers.has(hashedQueryKey)) {\n // We already have a query for this queryKey\n // Get the current result and return based on its state\n const observer = state.observers.get(hashedQueryKey)!\n const currentResult = observer.getCurrentResult()\n\n if (currentResult.isSuccess) {\n // Data is already available, return true synchronously\n return true\n } else if (currentResult.isError) {\n // Error already occurred, reject immediately\n return Promise.reject(currentResult.error)\n } else {\n // Query is still loading, wait for the first result\n return new Promise<void>((resolve, reject) => {\n const unsubscribe = observer.subscribe((result) => {\n if (result.isSuccess) {\n unsubscribe()\n resolve()\n } else if (result.isError) {\n unsubscribe()\n reject(result.error)\n }\n })\n })\n }\n }\n\n const observerOptions: QueryObserverOptions<\n Array<any>,\n any,\n Array<any>,\n Array<any>,\n any\n > = {\n queryKey: key,\n queryFn: queryFunction,\n meta: extendedMeta,\n structuralSharing: true,\n notifyOnChangeProps: `all`,\n\n // Only include options that are explicitly defined to allow QueryClient defaultOptions to be used\n ...(enabled !== undefined && { enabled }),\n ...(refetchInterval !== undefined && { refetchInterval }),\n ...(retry !== undefined && { retry }),\n ...(retryDelay !== undefined && { retryDelay }),\n ...(staleTime !== undefined && { staleTime }),\n }\n\n const localObserver = new QueryObserver<\n Array<any>,\n any,\n Array<any>,\n Array<any>,\n any\n >(queryClient, observerOptions)\n\n hashToQueryKey.set(hashedQueryKey, key)\n state.observers.set(hashedQueryKey, localObserver)\n\n // Create a promise that resolves when the query result is first available\n const readyPromise = new Promise<void>((resolve, reject) => {\n const unsubscribe = localObserver.subscribe((result) => {\n if (result.isSuccess) {\n unsubscribe()\n resolve()\n } else if (result.isError) {\n unsubscribe()\n reject(result.error)\n }\n })\n })\n\n // If sync has started or there are subscribers to the collection, subscribe to the query straight away\n // This creates the main subscription that handles data updates\n if (syncStarted \|\| collection.subscriberCount > 0) {\n subscribeToQuery(localObserver, hashedQueryKey)\n }\n\n // Tell tanstack query to GC the query when the subscription is unsubscribed\n // The subscription is unsubscribed when the live query is GCed.\n const subscription = opts.subscription\n subscription?.once(`unsubscribed`, () => {\n queryClient.removeQueries({ queryKey: key, exact: true })\n })\n\n return readyPromise\n }\n\n type UpdateHandler = Parameters<QueryObserver[`subscribe`]>[0]\n\n const makeQueryResultHandler = (queryKey: QueryKey) => {\n const hashedQueryKey = hashKey(queryKey)\n const handleQueryResult: UpdateHandler = (result) => {\n if (result.isSuccess) {\n // Clear error state\n state.lastError = undefined\n state.errorCount = 0\n\n const rawData = result.data\n const newItemsArray = select ? select(rawData) : rawData\n\n if (\n !Array.isArray(newItemsArray) \|\|\n newItemsArray.some((item) => typeof item !== `object`)\n ) {\n const errorMessage = select\n ? `@tanstack/query-db-collection: select() must return an array of objects. Got: ${typeof newItemsArray} for queryKey ${JSON.stringify(queryKey)}`\n : `@tanstack/query-db-collection: queryFn must return an array of objects. Got: ${typeof newItemsArray} for queryKey ${JSON.stringify(queryKey)}`\n\n console.error(errorMessage)\n return\n }\n\n const currentSyncedItems: Map<string \| number, any> = new Map(\n collection._state.syncedData.entries()\n )\n const newItemsMap = new Map<string \| number, any>()\n newItemsArray.forEach((item) => {\n const key = getKey(item)\n newItemsMap.set(key, item)\n })\n\n begin()\n\n // Helper function for shallow equality check of objects\n const shallowEqual = (\n obj1: Record<string, any>,\n obj2: Record<string, any>\n ): boolean => {\n // Get all keys from both objects\n const keys1 = Object.keys(obj1)\n const keys2 = Object.keys(obj2)\n\n // If number of keys is different, objects are not equal\n if (keys1.length !== keys2.length) return false\n\n // Check if all keys in obj1 have the same values in obj2\n return keys1.every((key) => {\n // Skip comparing functions and complex objects deeply\n if (typeof obj1[key] === `function`) return true\n return obj1[key] === obj2[key]\n })\n }\n\n currentSyncedItems.forEach((oldItem, key) => {\n const newItem = newItemsMap.get(key)\n if (!newItem) {\n const needToRemove = removeRow(key, hashedQueryKey) // returns true if the row is no longer referenced by any queries\n if (needToRemove) {\n write({ type: `delete`, value: oldItem })\n }\n } else if (\n !shallowEqual(\n oldItem as Record<string, any>,\n newItem as Record<string, any>\n )\n ) {\n // Only update if there are actual differences in the properties\n write({ type: `update`, value: newItem })\n }\n })\n\n newItemsMap.forEach((newItem, key) => {\n addRow(key, hashedQueryKey)\n if (!currentSyncedItems.has(key)) {\n write({ type: `insert`, value: newItem })\n }\n })\n\n commit()\n\n // Mark collection as ready after first successful query result\n markReady()\n } else if (result.isError) {\n if (result.errorUpdatedAt !== state.lastErrorUpdatedAt) {\n state.lastError = result.error\n state.errorCount++\n state.lastErrorUpdatedAt = result.errorUpdatedAt\n }\n\n console.error(\n `[QueryCollection] Error observing query ${String(queryKey)}:`,\n result.error\n )\n\n // Mark collection as ready even on error to avoid blocking apps\n markReady()\n }\n }\n return handleQueryResult\n }\n\n const isSubscribed = (hashedQueryKey: string) => {\n return unsubscribes.has(hashedQueryKey)\n }\n\n const subscribeToQuery = (\n observer: QueryObserver<Array<any>, any, Array<any>, Array<any>, any>,\n hashedQueryKey: string\n ) => {\n if (!isSubscribed(hashedQueryKey)) {\n const queryKey = hashToQueryKey.get(hashedQueryKey)!\n const handleQueryResult = makeQueryResultHandler(queryKey)\n const unsubscribeFn = observer.subscribe(handleQueryResult)\n unsubscribes.set(hashedQueryKey, unsubscribeFn)\n }\n }\n\n const subscribeToQueries = () => {\n state.observers.forEach(subscribeToQuery)\n }\n\n const unsubscribeFromQueries = () => {\n unsubscribes.forEach((unsubscribeFn) => {\n unsubscribeFn()\n })\n unsubscribes.clear()\n }\n\n // Mark that sync has started\n syncStarted = true\n\n // Set up event listener for subscriber changes\n const unsubscribeFromCollectionEvents = collection.on(\n `subscribers:change`,\n ({ subscriberCount }) => {\n if (subscriberCount > 0) {\n subscribeToQueries()\n } else if (subscriberCount === 0) {\n unsubscribeFromQueries()\n }\n }\n )\n\n // If syncMode is eager, create the initial query without any predicates\n if (syncMode === `eager`) {\n // Catch any errors to prevent unhandled rejections\n const initialResult = createQueryFromOpts({})\n if (initialResult instanceof Promise) {\n initialResult.catch(() => {\n // Errors are already handled by the query result handler\n })\n }\n } else {\n // In on-demand mode, mark ready immediately since there's no initial query\n markReady()\n }\n\n // Always subscribe when sync starts (this could be from preload(), startSync config, or first subscriber)\n // We'll dynamically unsubscribe/resubscribe based on subscriber count to maintain staleTime behavior\n subscribeToQueries()\n\n // Ensure we process any existing query data (QueryObserver doesn't invoke its callback automatically with initial state)\n state.observers.forEach((observer, hashedQueryKey) => {\n const queryKey = hashToQueryKey.get(hashedQueryKey)!\n const handleQueryResult = makeQueryResultHandler(queryKey)\n handleQueryResult(observer.getCurrentResult())\n })\n\n // Subscribe to the query client's cache to handle queries that are GCed by tanstack query\n const unsubscribeQueryCache = queryClient\n .getQueryCache()\n .subscribe((event) => {\n const hashedKey = event.query.queryHash\n if (event.type === `removed`) {\n cleanupQuery(hashedKey)\n }\n })\n\n function cleanupQuery(hashedQueryKey: string) {\n // Unsubscribe from the query's observer\n unsubscribes.get(hashedQueryKey)?.()\n\n // Get all the rows that are in the result of this query\n const rowKeys = queryToRows.get(hashedQueryKey) ?? new Set()\n\n // Remove the query from these rows\n rowKeys.forEach((rowKey) => {\n const queries = rowToQueries.get(rowKey) // set of queries that reference this row\n if (queries && queries.size > 0) {\n queries.delete(hashedQueryKey)\n if (queries.size === 0) {\n // Reference count dropped to 0, we can GC the row\n rowToQueries.delete(rowKey)\n\n if (collection.has(rowKey)) {\n begin()\n write({ type: `delete`, value: collection.get(rowKey) })\n commit()\n }\n }\n }\n })\n\n // Remove the query from the internal state\n unsubscribes.delete(hashedQueryKey)\n state.observers.delete(hashedQueryKey)\n queryToRows.delete(hashedQueryKey)\n hashToQueryKey.delete(hashedQueryKey)\n }\n\n const cleanup = async () => {\n unsubscribeFromCollectionEvents()\n unsubscribeFromQueries()\n\n const queryKeys = [...hashToQueryKey.values()]\n\n hashToQueryKey.clear()\n queryToRows.clear()\n rowToQueries.clear()\n state.observers.clear()\n unsubscribeQueryCache()\n\n await Promise.all(\n queryKeys.map(async (queryKey) => {\n await queryClient.cancelQueries({ queryKey })\n queryClient.removeQueries({ queryKey })\n })\n )\n }\n\n // Create deduplicated loadSubset wrapper for non-eager modes\n // This prevents redundant snapshot requests when multiple concurrent\n // live queries request overlapping or subset predicates\n const loadSubsetDedupe =\n syncMode === `eager` ? undefined : createQueryFromOpts\n\n return {\n loadSubset: loadSubsetDedupe,\n cleanup,\n }\n }\n\n /\n Refetch the query data\n \n Uses queryObserver.refetch() because:\n * - Bypasses `enabled: false` to support manual/imperative refetch patterns (e.g., button-triggered fetch)\n * - Ensures clearError() works even when enabled: false\n * - Always refetches THIS specific collection (exact targeting via observer)\n * - Respects retry, retryDelay, and other observer options\n \n This matches TanStack Query's hook behavior where refetch() bypasses enabled: false.\n * See: https://tanstack.com/query/latest/docs/framework/react/guides/disabling-queries\n \n Used by both:\n * - utils.refetch() - for explicit user-triggered refetches\n * - Internal handlers (onInsert/onUpdate/onDelete) - after mutations to get fresh data\n \n @returns Promise that resolves when the refetch is complete, with QueryObserverResult\n */\n const refetch: RefetchFn = async (opts) => {\n const queryKeys = [...hashToQueryKey.values()]\n const refetchPromises = queryKeys.map((queryKey) => {\n const queryObserver = state.observers.get(hashKey(queryKey))!\n return queryObserver.refetch({\n throwOnError: opts?.throwOnError,\n })\n })\n\n await Promise.all(refetchPromises)\n }\n\n // Create write context for manual write operations\n let writeContext: {\n collection: any\n queryClient: QueryClient\n queryKey: Array<unknown>\n getKey: (item: any) => string \| number\n begin: () => void\n write: (message: Omit<ChangeMessage<any>, `key`>) => void\n commit: () => void\n } \| null = null\n\n // Enhanced internalSync that captures write functions for manual use\n const enhancedInternalSync: SyncConfig<any>[`sync`] = (params) => {\n const { begin, write, commit, collection } = params\n\n // Store references for manual write operations\n writeContext = {\n collection,\n queryClient,\n queryKey: queryKey as unknown as Array<unknown>,\n getKey: getKey as (item: any) => string \| number,\n begin,\n write,\n commit,\n }\n\n // Call the original internalSync logic\n return internalSync(params)\n }\n\n // Create write utils using the manual-sync module\n const writeUtils = createWriteUtils<any, string \| number, any>(\n () => writeContext\n )\n\n // Create wrapper handlers for direct persistence operations that handle refetching\n const wrappedOnInsert = onInsert\n ? async (params: InsertMutationFnParams<any>) => {\n const handlerResult = (await onInsert(params)) ?? {}\n const shouldRefetch =\n (handlerResult as { refetch?: boolean }).refetch !== false\n\n if (shouldRefetch) {\n await refetch()\n }\n\n return handlerResult\n }\n : undefined\n\n const wrappedOnUpdate = onUpdate\n ? async (params: UpdateMutationFnParams<any>) => {\n const handlerResult = (await onUpdate(params)) ?? {}\n const shouldRefetch =\n (handlerResult as { refetch?: boolean }).refetch !== false\n\n if (shouldRefetch) {\n await refetch()\n }\n\n return handlerResult\n }\n : undefined\n\n const wrappedOnDelete = onDelete\n ? async (params: DeleteMutationFnParams<any>) => {\n const handlerResult = (await onDelete(params)) ?? {}\n const shouldRefetch =\n (handlerResult as { refetch?: boolean }).refetch !== false\n\n if (shouldRefetch) {\n await refetch()\n }\n\n return handlerResult\n }\n : undefined\n\n // Create utils instance with state and dependencies passed explicitly\n const utils: any = new QueryCollectionUtilsImpl(state, refetch, writeUtils)\n\n return {\n ...baseCollectionConfig,\n getKey,\n syncMode,\n sync: { sync: enhancedInternalSync },\n onInsert: wrappedOnInsert,\n onUpdate: wrappedOnUpdate,\n onDelete: wrappedOnDelete,\n utils,\n }\n}\n"],"names":["queryKey"],"mappings":"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"}
1	+ {"version":3,"file":"query.js","sources":["../../src/query.ts"],"sourcesContent":["import { QueryObserver, hashKey } from \"@tanstack/query-core\"\nimport {\n GetKeyRequiredError,\n QueryClientRequiredError,\n QueryFnRequiredError,\n QueryKeyRequiredError,\n} from \"./errors\"\nimport { createWriteUtils } from \"./manual-sync\"\nimport { serializeLoadSubsetOptions } from \"./serialization\"\nimport type {\n BaseCollectionConfig,\n ChangeMessage,\n CollectionConfig,\n DeleteMutationFnParams,\n InsertMutationFnParams,\n LoadSubsetOptions,\n SyncConfig,\n UpdateMutationFnParams,\n UtilsRecord,\n} from \"@tanstack/db\"\nimport type {\n FetchStatus,\n QueryClient,\n QueryFunctionContext,\n QueryKey,\n QueryObserverOptions,\n QueryObserverResult,\n} from \"@tanstack/query-core\"\nimport type { StandardSchemaV1 } from \"@standard-schema/spec\"\n\n// Re-export for external use\nexport type { SyncOperation } from \"./manual-sync\"\n\n// Schema output type inference helper (matches electric.ts pattern)\ntype InferSchemaOutput<T> = T extends StandardSchemaV1\n ? StandardSchemaV1.InferOutput<T> extends object\n ? StandardSchemaV1.InferOutput<T>\n : Record<string, unknown>\n : Record<string, unknown>\n\n// Schema input type inference helper (matches electric.ts pattern)\ntype InferSchemaInput<T> = T extends StandardSchemaV1\n ? StandardSchemaV1.InferInput<T> extends object\n ? StandardSchemaV1.InferInput<T>\n : Record<string, unknown>\n : Record<string, unknown>\n\ntype TQueryKeyBuilder<TQueryKey> = (opts: LoadSubsetOptions) => TQueryKey\n\n/*\n Configuration options for creating a Query Collection\n * @template T - The explicit type of items stored in the collection\n * @template TQueryFn - The queryFn type\n * @template TError - The type of errors that can occur during queries\n * @template TQueryKey - The type of the query key\n * @template TKey - The type of the item keys\n * @template TSchema - The schema type for validation\n /\nexport interface QueryCollectionConfig<\n T extends object = object,\n TQueryFn extends (context: QueryFunctionContext<any>) => Promise<any> = (\n context: QueryFunctionContext<any>\n ) => Promise<any>,\n TError = unknown,\n TQueryKey extends QueryKey = QueryKey,\n TKey extends string \| number = string \| number,\n TSchema extends StandardSchemaV1 = never,\n TQueryData = Awaited<ReturnType<TQueryFn>>,\n> extends BaseCollectionConfig<T, TKey, TSchema> {\n /* The query key used by TanStack Query to identify this query /\n queryKey: TQueryKey \| TQueryKeyBuilder<TQueryKey>\n /* Function that fetches data from the server. Must return the complete collection state /\n queryFn: TQueryFn extends (\n context: QueryFunctionContext<TQueryKey>\n ) => Promise<Array<any>>\n ? (context: QueryFunctionContext<TQueryKey>) => Promise<Array<T>>\n : TQueryFn\n / Function that extracts array items from wrapped API responses (e.g metadata, pagination) /\n select?: (data: TQueryData) => Array<T>\n /* The TanStack Query client instance /\n queryClient: QueryClient\n\n // Query-specific options\n /* Whether the query should automatically run (default: true) /\n enabled?: boolean\n refetchInterval?: QueryObserverOptions<\n Array<T>,\n TError,\n Array<T>,\n Array<T>,\n TQueryKey\n >[`refetchInterval`]\n retry?: QueryObserverOptions<\n Array<T>,\n TError,\n Array<T>,\n Array<T>,\n TQueryKey\n >[`retry`]\n retryDelay?: QueryObserverOptions<\n Array<T>,\n TError,\n Array<T>,\n Array<T>,\n TQueryKey\n >[`retryDelay`]\n staleTime?: QueryObserverOptions<\n Array<T>,\n TError,\n Array<T>,\n Array<T>,\n TQueryKey\n >[`staleTime`]\n\n /\n Metadata to pass to the query.\n * Available in queryFn via context.meta\n \n @example\n * // Using meta for error context\n * queryFn: async (context) => {\n * try {\n * return await api.getTodos(userId)\n * } catch (error) {\n * // Use meta for better error messages\n * throw new Error(\n * context.meta?.errorMessage \|\| 'Failed to load todos'\n * )\n * }\n * },\n * meta: {\n * errorMessage: `Failed to load todos for user ${userId}`\n * }\n /\n meta?: Record<string, unknown>\n}\n\n/\n Type for the refetch utility function\n * Returns the QueryObserverResult from TanStack Query\n /\nexport type RefetchFn = (opts?: {\n throwOnError?: boolean\n}) => Promise<QueryObserverResult<any, any> \| void>\n\n/\n Utility methods available on Query Collections for direct writes and manual operations.\n * Direct writes bypass the normal query/mutation flow and write directly to the synced data store.\n * @template TItem - The type of items stored in the collection\n * @template TKey - The type of the item keys\n * @template TInsertInput - The type accepted for insert operations\n * @template TError - The type of errors that can occur during queries\n /\nexport interface QueryCollectionUtils<\n TItem extends object = Record<string, unknown>,\n TKey extends string \| number = string \| number,\n TInsertInput extends object = TItem,\n TError = unknown,\n> extends UtilsRecord {\n /* Manually trigger a refetch of the query /\n refetch: RefetchFn\n /* Insert one or more items directly into the synced data store without triggering a query refetch or optimistic update /\n writeInsert: (data: TInsertInput \| Array<TInsertInput>) => void\n /* Update one or more items directly in the synced data store without triggering a query refetch or optimistic update /\n writeUpdate: (updates: Partial<TItem> \| Array<Partial<TItem>>) => void\n /* Delete one or more items directly from the synced data store without triggering a query refetch or optimistic update /\n writeDelete: (keys: TKey \| Array<TKey>) => void\n /* Insert or update one or more items directly in the synced data store without triggering a query refetch or optimistic update /\n writeUpsert: (data: Partial<TItem> \| Array<Partial<TItem>>) => void\n /* Execute multiple write operations as a single atomic batch to the synced data store /\n writeBatch: (callback: () => void) => void\n\n // Query Observer State (getters)\n /* Get the last error encountered by the query (if any); reset on success /\n lastError: TError \| undefined\n /* Check if the collection is in an error state /\n isError: boolean\n /\n Get the number of consecutive sync failures.\n * Incremented only when query fails completely (not per retry attempt); reset on success.\n /\n errorCount: number\n /* Check if query is currently fetching (initial or background) /\n isFetching: boolean\n /* Check if query is refetching in background (not initial fetch) /\n isRefetching: boolean\n /* Check if query is loading for the first time (no data yet) /\n isLoading: boolean\n /* Get timestamp of last successful data update (in milliseconds) /\n dataUpdatedAt: number\n /* Get current fetch status /\n fetchStatus: `fetching` \| `paused` \| `idle`\n\n /\n Clear the error state and trigger a refetch of the query\n * @returns Promise that resolves when the refetch completes successfully\n * @throws Error if the refetch fails\n /\n clearError: () => Promise<void>\n}\n\n/\n Internal state object for tracking query observer and errors\n /\ninterface QueryCollectionState {\n lastError: any\n errorCount: number\n lastErrorUpdatedAt: number\n observers: Map<\n string,\n QueryObserver<Array<any>, any, Array<any>, Array<any>, any>\n >\n}\n\n/\n Implementation class for QueryCollectionUtils with explicit dependency injection\n * for better testability and architectural clarity\n /\nclass QueryCollectionUtilsImpl {\n private state: QueryCollectionState\n private refetchFn: RefetchFn\n\n // Write methods\n public refetch: RefetchFn\n public writeInsert: any\n public writeUpdate: any\n public writeDelete: any\n public writeUpsert: any\n public writeBatch: any\n\n constructor(\n state: QueryCollectionState,\n refetch: RefetchFn,\n writeUtils: ReturnType<typeof createWriteUtils>\n ) {\n this.state = state\n this.refetchFn = refetch\n\n // Initialize methods to use passed dependencies\n this.refetch = refetch\n this.writeInsert = writeUtils.writeInsert\n this.writeUpdate = writeUtils.writeUpdate\n this.writeDelete = writeUtils.writeDelete\n this.writeUpsert = writeUtils.writeUpsert\n this.writeBatch = writeUtils.writeBatch\n }\n\n public async clearError() {\n this.state.lastError = undefined\n this.state.errorCount = 0\n this.state.lastErrorUpdatedAt = 0\n await this.refetchFn({ throwOnError: true })\n }\n\n // Getters for error state\n public get lastError() {\n return this.state.lastError\n }\n\n public get isError() {\n return !!this.state.lastError\n }\n\n public get errorCount() {\n return this.state.errorCount\n }\n\n // Getters for QueryObserver state\n public get isFetching() {\n // check if any observer is fetching\n return Array.from(this.state.observers.values()).some(\n (observer) => observer.getCurrentResult().isFetching\n )\n }\n\n public get isRefetching() {\n // check if any observer is refetching\n return Array.from(this.state.observers.values()).some(\n (observer) => observer.getCurrentResult().isRefetching\n )\n }\n\n public get isLoading() {\n // check if any observer is loading\n return Array.from(this.state.observers.values()).some(\n (observer) => observer.getCurrentResult().isLoading\n )\n }\n\n public get dataUpdatedAt() {\n // compute the max dataUpdatedAt of all observers\n return Math.max(\n 0,\n ...Array.from(this.state.observers.values()).map(\n (observer) => observer.getCurrentResult().dataUpdatedAt\n )\n )\n }\n\n public get fetchStatus(): Array<FetchStatus> {\n return Array.from(this.state.observers.values()).map(\n (observer) => observer.getCurrentResult().fetchStatus\n )\n }\n}\n\n/\n Creates query collection options for use with a standard Collection.\n * This integrates TanStack Query with TanStack DB for automatic synchronization.\n \n Supports automatic type inference following the priority order:\n * 1. Schema inference (highest priority)\n * 2. QueryFn return type inference (second priority)\n \n @template T - Type of the schema if a schema is provided otherwise it is the type of the values returned by the queryFn\n * @template TError - The type of errors that can occur during queries\n * @template TQueryKey - The type of the query key\n * @template TKey - The type of the item keys\n * @param config - Configuration options for the Query collection\n * @returns Collection options with utilities for direct writes and manual operations\n \n @example\n * // Type inferred from queryFn return type (NEW!)\n * const todosCollection = createCollection(\n * queryCollectionOptions({\n * queryKey: ['todos'],\n * queryFn: async () => {\n * const response = await fetch('/api/todos')\n * return response.json() as Todo[] // Type automatically inferred!\n * },\n * queryClient,\n * getKey: (item) => item.id, // item is typed as Todo\n * })\n * )\n \n @example\n * // Explicit type\n * const todosCollection = createCollection<Todo>(\n * queryCollectionOptions({\n * queryKey: ['todos'],\n * queryFn: async () => fetch('/api/todos').then(r => r.json()),\n * queryClient,\n * getKey: (item) => item.id,\n * })\n * )\n \n @example\n * // Schema inference\n * const todosCollection = createCollection(\n * queryCollectionOptions({\n * queryKey: ['todos'],\n * queryFn: async () => fetch('/api/todos').then(r => r.json()),\n * queryClient,\n * schema: todoSchema, // Type inferred from schema\n * getKey: (item) => item.id,\n * })\n * )\n \n @example\n * // With persistence handlers\n * const todosCollection = createCollection(\n * queryCollectionOptions({\n * queryKey: ['todos'],\n * queryFn: fetchTodos,\n * queryClient,\n * getKey: (item) => item.id,\n * onInsert: async ({ transaction }) => {\n * await api.createTodos(transaction.mutations.map(m => m.modified))\n * },\n * onUpdate: async ({ transaction }) => {\n * await api.updateTodos(transaction.mutations)\n * },\n * onDelete: async ({ transaction }) => {\n * await api.deleteTodos(transaction.mutations.map(m => m.key))\n * }\n * })\n * )\n \n @example\n * // The select option extracts the items array from a response with metadata\n * const todosCollection = createCollection(\n * queryCollectionOptions({\n * queryKey: ['todos'],\n * queryFn: async () => fetch('/api/todos').then(r => r.json()),\n * select: (data) => data.items, // Extract the array of items\n * queryClient,\n * schema: todoSchema,\n * getKey: (item) => item.id,\n * })\n * )\n /\n// Overload for when schema is provided and select present\nexport function queryCollectionOptions<\n T extends StandardSchemaV1,\n TQueryFn extends (context: QueryFunctionContext<any>) => Promise<any>,\n TError = unknown,\n TQueryKey extends QueryKey = QueryKey,\n TKey extends string \| number = string \| number,\n TQueryData = Awaited<ReturnType<TQueryFn>>,\n>(\n config: QueryCollectionConfig<\n InferSchemaOutput<T>,\n TQueryFn,\n TError,\n TQueryKey,\n TKey,\n T\n > & {\n schema: T\n select: (data: TQueryData) => Array<InferSchemaInput<T>>\n }\n): CollectionConfig<\n InferSchemaOutput<T>,\n TKey,\n T,\n QueryCollectionUtils<InferSchemaOutput<T>, TKey, InferSchemaInput<T>, TError>\n> & {\n schema: T\n utils: QueryCollectionUtils<\n InferSchemaOutput<T>,\n TKey,\n InferSchemaInput<T>,\n TError\n >\n}\n\n// Overload for when no schema is provided and select present\nexport function queryCollectionOptions<\n T extends object,\n TQueryFn extends (context: QueryFunctionContext<any>) => Promise<any> = (\n context: QueryFunctionContext<any>\n ) => Promise<any>,\n TError = unknown,\n TQueryKey extends QueryKey = QueryKey,\n TKey extends string \| number = string \| number,\n TQueryData = Awaited<ReturnType<TQueryFn>>,\n>(\n config: QueryCollectionConfig<\n T,\n TQueryFn,\n TError,\n TQueryKey,\n TKey,\n never,\n TQueryData\n > & {\n schema?: never // prohibit schema\n select: (data: TQueryData) => Array<T>\n }\n): CollectionConfig<\n T,\n TKey,\n never,\n QueryCollectionUtils<T, TKey, T, TError>\n> & {\n schema?: never // no schema in the result\n utils: QueryCollectionUtils<T, TKey, T, TError>\n}\n\n// Overload for when schema is provided\nexport function queryCollectionOptions<\n T extends StandardSchemaV1,\n TError = unknown,\n TQueryKey extends QueryKey = QueryKey,\n TKey extends string \| number = string \| number,\n>(\n config: QueryCollectionConfig<\n InferSchemaOutput<T>,\n (\n context: QueryFunctionContext<any>\n ) => Promise<Array<InferSchemaOutput<T>>>,\n TError,\n TQueryKey,\n TKey,\n T\n > & {\n schema: T\n }\n): CollectionConfig<\n InferSchemaOutput<T>,\n TKey,\n T,\n QueryCollectionUtils<InferSchemaOutput<T>, TKey, InferSchemaInput<T>, TError>\n> & {\n schema: T\n utils: QueryCollectionUtils<\n InferSchemaOutput<T>,\n TKey,\n InferSchemaInput<T>,\n TError\n >\n}\n\n// Overload for when no schema is provided\nexport function queryCollectionOptions<\n T extends object,\n TError = unknown,\n TQueryKey extends QueryKey = QueryKey,\n TKey extends string \| number = string \| number,\n>(\n config: QueryCollectionConfig<\n T,\n (context: QueryFunctionContext<any>) => Promise<Array<T>>,\n TError,\n TQueryKey,\n TKey\n > & {\n schema?: never // prohibit schema\n }\n): CollectionConfig<\n T,\n TKey,\n never,\n QueryCollectionUtils<T, TKey, T, TError>\n> & {\n schema?: never // no schema in the result\n utils: QueryCollectionUtils<T, TKey, T, TError>\n}\n\nexport function queryCollectionOptions(\n config: QueryCollectionConfig<Record<string, unknown>>\n): CollectionConfig<\n Record<string, unknown>,\n string \| number,\n never,\n QueryCollectionUtils\n> & {\n utils: QueryCollectionUtils\n} {\n const {\n queryKey,\n queryFn,\n select,\n queryClient,\n enabled,\n refetchInterval,\n retry,\n retryDelay,\n staleTime,\n getKey,\n onInsert,\n onUpdate,\n onDelete,\n meta,\n ...baseCollectionConfig\n } = config\n\n // Default to eager sync mode if not provided\n const syncMode = baseCollectionConfig.syncMode ?? `eager`\n\n // Validate required parameters\n\n // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n if (!queryKey) {\n throw new QueryKeyRequiredError()\n }\n // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n if (!queryFn) {\n throw new QueryFnRequiredError()\n }\n\n // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n if (!queryClient) {\n throw new QueryClientRequiredError()\n }\n\n // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n if (!getKey) {\n throw new GetKeyRequiredError()\n }\n\n /* State object to hold error tracking and observer reference /\n const state: QueryCollectionState = {\n lastError: undefined as any,\n errorCount: 0,\n lastErrorUpdatedAt: 0,\n observers: new Map<\n string,\n QueryObserver<Array<any>, any, Array<any>, Array<any>, any>\n >(),\n }\n\n // hashedQueryKey → queryKey\n const hashToQueryKey = new Map<string, QueryKey>()\n\n // queryKey → Set<RowKey>\n const queryToRows = new Map<string, Set<string \| number>>()\n\n // RowKey → Set<queryKey>\n const rowToQueries = new Map<string \| number, Set<string>>()\n\n // queryKey → QueryObserver's unsubscribe function\n const unsubscribes = new Map<string, () => void>()\n\n // queryKey → reference count (how many loadSubset calls are active)\n // Reference counting for QueryObserver lifecycle management\n // =========================================================\n // Tracks how many live query subscriptions are using each QueryObserver.\n // Multiple live queries with identical predicates share the same QueryObserver for efficiency.\n //\n // Lifecycle:\n // - Increment: when createQueryFromOpts creates or reuses an observer\n // - Decrement: when subscription.unsubscribe() passes predicates to collection._sync.unloadSubset()\n // - Reset: when cleanupQuery() is triggered by TanStack Query's cache GC\n //\n // When refcount reaches 0, unloadSubset():\n // 1. Computes the same queryKey from the predicates\n // 2. Uses existing machinery (queryToRows map) to find rows that query loaded\n // 3. Decrements refcount and GCs rows where count reaches 0\n const queryRefCounts = new Map<string, number>()\n\n // Helper function to add a row to the internal state\n const addRow = (rowKey: string \| number, hashedQueryKey: string) => {\n const rowToQueriesSet = rowToQueries.get(rowKey) \|\| new Set()\n rowToQueriesSet.add(hashedQueryKey)\n rowToQueries.set(rowKey, rowToQueriesSet)\n\n const queryToRowsSet = queryToRows.get(hashedQueryKey) \|\| new Set()\n queryToRowsSet.add(rowKey)\n queryToRows.set(hashedQueryKey, queryToRowsSet)\n }\n\n // Helper function to remove a row from the internal state\n const removeRow = (rowKey: string \| number, hashedQuerKey: string) => {\n const rowToQueriesSet = rowToQueries.get(rowKey) \|\| new Set()\n rowToQueriesSet.delete(hashedQuerKey)\n rowToQueries.set(rowKey, rowToQueriesSet)\n\n const queryToRowsSet = queryToRows.get(hashedQuerKey) \|\| new Set()\n queryToRowsSet.delete(rowKey)\n queryToRows.set(hashedQuerKey, queryToRowsSet)\n\n return rowToQueriesSet.size === 0\n }\n\n const internalSync: SyncConfig<any>[`sync`] = (params) => {\n const { begin, write, commit, markReady, collection } = params\n\n // Track whether sync has been started\n let syncStarted = false\n\n /\n Generate a consistent query key from LoadSubsetOptions.\n * CRITICAL: Must use identical logic in both createQueryFromOpts and unloadSubset\n * so that refcount increment/decrement operations target the same hashedQueryKey.\n * Inconsistent keys would cause refcount leaks and prevent proper cleanup.\n /\n const generateQueryKeyFromOptions = (opts: LoadSubsetOptions): QueryKey => {\n if (typeof queryKey === `function`) {\n // Function-based queryKey: use it to build the key from opts\n return queryKey(opts)\n } else if (syncMode === `on-demand`) {\n // Static queryKey in on-demand mode: automatically append serialized predicates\n // to create separate cache entries for different predicate combinations\n const serialized = serializeLoadSubsetOptions(opts)\n return serialized !== undefined ? [...queryKey, serialized] : queryKey\n } else {\n // Static queryKey in eager mode: use as-is\n return queryKey\n }\n }\n\n const createQueryFromOpts = (\n opts: LoadSubsetOptions = {},\n queryFunction: typeof queryFn = queryFn\n ): true \| Promise<void> => {\n // Generate key using common function\n const key = generateQueryKeyFromOptions(opts)\n const hashedQueryKey = hashKey(key)\n const extendedMeta = { ...meta, loadSubsetOptions: opts }\n\n if (state.observers.has(hashedQueryKey)) {\n // We already have a query for this queryKey\n // Increment reference count since another consumer is using this observer\n queryRefCounts.set(\n hashedQueryKey,\n (queryRefCounts.get(hashedQueryKey) \|\| 0) + 1\n )\n\n // Get the current result and return based on its state\n const observer = state.observers.get(hashedQueryKey)!\n const currentResult = observer.getCurrentResult()\n\n if (currentResult.isSuccess) {\n // Data is already available, return true synchronously\n return true\n } else if (currentResult.isError) {\n // Error already occurred, reject immediately\n return Promise.reject(currentResult.error)\n } else {\n // Query is still loading, wait for the first result\n return new Promise<void>((resolve, reject) => {\n const unsubscribe = observer.subscribe((result) => {\n if (result.isSuccess) {\n unsubscribe()\n resolve()\n } else if (result.isError) {\n unsubscribe()\n reject(result.error)\n }\n })\n })\n }\n }\n\n const observerOptions: QueryObserverOptions<\n Array<any>,\n any,\n Array<any>,\n Array<any>,\n any\n > = {\n queryKey: key,\n queryFn: queryFunction,\n meta: extendedMeta,\n structuralSharing: true,\n notifyOnChangeProps: `all`,\n\n // Only include options that are explicitly defined to allow QueryClient defaultOptions to be used\n ...(enabled !== undefined && { enabled }),\n ...(refetchInterval !== undefined && { refetchInterval }),\n ...(retry !== undefined && { retry }),\n ...(retryDelay !== undefined && { retryDelay }),\n ...(staleTime !== undefined && { staleTime }),\n }\n\n const localObserver = new QueryObserver<\n Array<any>,\n any,\n Array<any>,\n Array<any>,\n any\n >(queryClient, observerOptions)\n\n hashToQueryKey.set(hashedQueryKey, key)\n state.observers.set(hashedQueryKey, localObserver)\n\n // Increment reference count for this query\n queryRefCounts.set(\n hashedQueryKey,\n (queryRefCounts.get(hashedQueryKey) \|\| 0) + 1\n )\n\n // Create a promise that resolves when the query result is first available\n const readyPromise = new Promise<void>((resolve, reject) => {\n const unsubscribe = localObserver.subscribe((result) => {\n if (result.isSuccess) {\n unsubscribe()\n resolve()\n } else if (result.isError) {\n unsubscribe()\n reject(result.error)\n }\n })\n })\n\n // If sync has started or there are subscribers to the collection, subscribe to the query straight away\n // This creates the main subscription that handles data updates\n if (syncStarted \|\| collection.subscriberCount > 0) {\n subscribeToQuery(localObserver, hashedQueryKey)\n }\n\n return readyPromise\n }\n\n type UpdateHandler = Parameters<QueryObserver[`subscribe`]>[0]\n\n const makeQueryResultHandler = (queryKey: QueryKey) => {\n const hashedQueryKey = hashKey(queryKey)\n const handleQueryResult: UpdateHandler = (result) => {\n if (result.isSuccess) {\n // Clear error state\n state.lastError = undefined\n state.errorCount = 0\n\n const rawData = result.data\n const newItemsArray = select ? select(rawData) : rawData\n\n if (\n !Array.isArray(newItemsArray) \|\|\n newItemsArray.some((item) => typeof item !== `object`)\n ) {\n const errorMessage = select\n ? `@tanstack/query-db-collection: select() must return an array of objects. Got: ${typeof newItemsArray} for queryKey ${JSON.stringify(queryKey)}`\n : `@tanstack/query-db-collection: queryFn must return an array of objects. Got: ${typeof newItemsArray} for queryKey ${JSON.stringify(queryKey)}`\n\n console.error(errorMessage)\n return\n }\n\n const currentSyncedItems: Map<string \| number, any> = new Map(\n collection._state.syncedData.entries()\n )\n const newItemsMap = new Map<string \| number, any>()\n newItemsArray.forEach((item) => {\n const key = getKey(item)\n newItemsMap.set(key, item)\n })\n\n begin()\n\n // Helper function for shallow equality check of objects\n const shallowEqual = (\n obj1: Record<string, any>,\n obj2: Record<string, any>\n ): boolean => {\n // Get all keys from both objects\n const keys1 = Object.keys(obj1)\n const keys2 = Object.keys(obj2)\n\n // If number of keys is different, objects are not equal\n if (keys1.length !== keys2.length) return false\n\n // Check if all keys in obj1 have the same values in obj2\n return keys1.every((key) => {\n // Skip comparing functions and complex objects deeply\n if (typeof obj1[key] === `function`) return true\n return obj1[key] === obj2[key]\n })\n }\n\n currentSyncedItems.forEach((oldItem, key) => {\n const newItem = newItemsMap.get(key)\n if (!newItem) {\n const needToRemove = removeRow(key, hashedQueryKey) // returns true if the row is no longer referenced by any queries\n if (needToRemove) {\n write({ type: `delete`, value: oldItem })\n }\n } else if (\n !shallowEqual(\n oldItem as Record<string, any>,\n newItem as Record<string, any>\n )\n ) {\n // Only update if there are actual differences in the properties\n write({ type: `update`, value: newItem })\n }\n })\n\n newItemsMap.forEach((newItem, key) => {\n addRow(key, hashedQueryKey)\n if (!currentSyncedItems.has(key)) {\n write({ type: `insert`, value: newItem })\n }\n })\n\n commit()\n\n // Mark collection as ready after first successful query result\n markReady()\n } else if (result.isError) {\n if (result.errorUpdatedAt !== state.lastErrorUpdatedAt) {\n state.lastError = result.error\n state.errorCount++\n state.lastErrorUpdatedAt = result.errorUpdatedAt\n }\n\n console.error(\n `[QueryCollection] Error observing query ${String(queryKey)}:`,\n result.error\n )\n\n // Mark collection as ready even on error to avoid blocking apps\n markReady()\n }\n }\n return handleQueryResult\n }\n\n const isSubscribed = (hashedQueryKey: string) => {\n return unsubscribes.has(hashedQueryKey)\n }\n\n const subscribeToQuery = (\n observer: QueryObserver<Array<any>, any, Array<any>, Array<any>, any>,\n hashedQueryKey: string\n ) => {\n if (!isSubscribed(hashedQueryKey)) {\n const cachedQueryKey = hashToQueryKey.get(hashedQueryKey)!\n const handleQueryResult = makeQueryResultHandler(cachedQueryKey)\n const unsubscribeFn = observer.subscribe(handleQueryResult)\n unsubscribes.set(hashedQueryKey, unsubscribeFn)\n\n // Process the current result immediately if available\n // This ensures data is synced when resubscribing to a query with cached data\n const currentResult = observer.getCurrentResult()\n if (currentResult.isSuccess \|\| currentResult.isError) {\n handleQueryResult(currentResult)\n }\n }\n }\n\n const subscribeToQueries = () => {\n state.observers.forEach(subscribeToQuery)\n }\n\n const unsubscribeFromQueries = () => {\n unsubscribes.forEach((unsubscribeFn) => {\n unsubscribeFn()\n })\n unsubscribes.clear()\n }\n\n // Mark that sync has started\n syncStarted = true\n\n // Set up event listener for subscriber changes\n const unsubscribeFromCollectionEvents = collection.on(\n `subscribers:change`,\n ({ subscriberCount }) => {\n if (subscriberCount > 0) {\n subscribeToQueries()\n } else if (subscriberCount === 0) {\n unsubscribeFromQueries()\n }\n }\n )\n\n // If syncMode is eager, create the initial query without any predicates\n if (syncMode === `eager`) {\n // Catch any errors to prevent unhandled rejections\n const initialResult = createQueryFromOpts({})\n if (initialResult instanceof Promise) {\n initialResult.catch(() => {\n // Errors are already handled by the query result handler\n })\n }\n } else {\n // In on-demand mode, mark ready immediately since there's no initial query\n markReady()\n }\n\n // Always subscribe when sync starts (this could be from preload(), startSync config, or first subscriber)\n // We'll dynamically unsubscribe/resubscribe based on subscriber count to maintain staleTime behavior\n subscribeToQueries()\n\n // Ensure we process any existing query data (QueryObserver doesn't invoke its callback automatically with initial state)\n state.observers.forEach((observer, hashedQueryKey) => {\n const cachedQueryKey = hashToQueryKey.get(hashedQueryKey)!\n const handleQueryResult = makeQueryResultHandler(cachedQueryKey)\n handleQueryResult(observer.getCurrentResult())\n })\n\n /\n Perform row-level cleanup and remove all tracking for a query.\n * Callers are responsible for ensuring the query is safe to cleanup.\n /\n const cleanupQueryInternal = (hashedQueryKey: string) => {\n unsubscribes.get(hashedQueryKey)?.()\n unsubscribes.delete(hashedQueryKey)\n\n const rowKeys = queryToRows.get(hashedQueryKey) ?? new Set()\n const rowsToDelete: Array<any> = []\n\n rowKeys.forEach((rowKey) => {\n const queries = rowToQueries.get(rowKey)\n\n if (!queries) {\n return\n }\n\n queries.delete(hashedQueryKey)\n\n if (queries.size === 0) {\n rowToQueries.delete(rowKey)\n\n if (collection.has(rowKey)) {\n rowsToDelete.push(collection.get(rowKey))\n }\n }\n })\n\n if (rowsToDelete.length > 0) {\n begin()\n rowsToDelete.forEach((row) => {\n write({ type: `delete`, value: row })\n })\n commit()\n }\n\n state.observers.delete(hashedQueryKey)\n queryToRows.delete(hashedQueryKey)\n hashToQueryKey.delete(hashedQueryKey)\n queryRefCounts.delete(hashedQueryKey)\n }\n\n /\n Attempt to cleanup a query when it appears unused.\n * Respects refcounts and invalidateQueries cycles via hasListeners().\n /\n const cleanupQueryIfIdle = (hashedQueryKey: string) => {\n const refcount = queryRefCounts.get(hashedQueryKey) \|\| 0\n const observer = state.observers.get(hashedQueryKey)\n\n if (refcount <= 0) {\n // Drop our subscription so hasListeners reflects only active consumers\n unsubscribes.get(hashedQueryKey)?.()\n unsubscribes.delete(hashedQueryKey)\n }\n\n const hasListeners = observer?.hasListeners() ?? false\n\n if (hasListeners) {\n // During invalidateQueries, TanStack Query keeps internal listeners alive.\n // Leave refcount at 0 but keep observer so it can resubscribe.\n queryRefCounts.set(hashedQueryKey, 0)\n return\n }\n\n // No listeners means the query is truly idle.\n // Even if refcount > 0, we treat hasListeners as authoritative to prevent leaks.\n // This can happen if subscriptions are GC'd without calling unloadSubset.\n if (refcount > 0) {\n console.warn(\n `[cleanupQueryIfIdle] Invariant violation: refcount=${refcount} but no listeners. Cleaning up to prevent leak.`,\n { hashedQueryKey }\n )\n }\n\n cleanupQueryInternal(hashedQueryKey)\n }\n\n /\n Force cleanup used by explicit collection cleanup.\n * Ignores refcounts/hasListeners and removes everything.\n /\n const forceCleanupQuery = (hashedQueryKey: string) => {\n cleanupQueryInternal(hashedQueryKey)\n }\n\n // Subscribe to the query client's cache to handle queries that are GCed by tanstack query\n const unsubscribeQueryCache = queryClient\n .getQueryCache()\n .subscribe((event) => {\n const hashedKey = event.query.queryHash\n if (event.type === `removed`) {\n // Only cleanup if this is OUR query (we track it)\n if (hashToQueryKey.has(hashedKey)) {\n // TanStack Query GC'd this query after gcTime expired.\n // Use the guarded cleanup path to avoid deleting rows for active queries.\n cleanupQueryIfIdle(hashedKey)\n }\n }\n })\n\n const cleanup = async () => {\n unsubscribeFromCollectionEvents()\n unsubscribeFromQueries()\n\n const allQueryKeys = [...hashToQueryKey.values()]\n const allHashedKeys = [...state.observers.keys()]\n\n // Force cleanup all queries (explicit cleanup path)\n // This ignores hasListeners and always cleans up\n for (const hashedKey of allHashedKeys) {\n forceCleanupQuery(hashedKey)\n }\n\n // Unsubscribe from cache events (cleanup already happened above)\n unsubscribeQueryCache()\n\n // Remove queries from TanStack Query cache\n await Promise.all(\n allQueryKeys.map(async (qKey) => {\n await queryClient.cancelQueries({ queryKey: qKey, exact: true })\n queryClient.removeQueries({ queryKey: qKey, exact: true })\n })\n )\n }\n\n /\n Unload a query subset - the subscription-based cleanup path (on-demand mode).\n \n Called when a live query subscription unsubscribes (via collection._sync.unloadSubset()).\n \n Flow:\n * 1. Receives the same predicates that were passed to loadSubset\n * 2. Computes the queryKey using generateQueryKeyFromOptions (same logic as loadSubset)\n * 3. Decrements refcount\n * 4. If refcount reaches 0:\n * - Checks hasListeners() to detect invalidateQueries cycles\n * - If hasListeners is true: resets refcount (TanStack Query keeping observer alive)\n * - If hasListeners is false: calls forceCleanupQuery() to perform row-level GC\n \n The hasListeners() check prevents premature cleanup during invalidateQueries:\n * - invalidateQueries causes temporary unsubscribe/resubscribe\n * - During unsubscribe, our refcount drops to 0\n * - But observer.hasListeners() is still true (TanStack Query's internal listeners)\n * - We skip cleanup and reset refcount, allowing resubscribe to succeed\n \n We don't cancel in-flight requests. Unsubscribing from the observer is sufficient\n * to prevent late-arriving data from being processed. The request completes and is cached\n * by TanStack Query, allowing quick remounts to restore data without refetching.\n /\n const unloadSubset = (options: LoadSubsetOptions) => {\n // 1. Same predicates → 2. Same queryKey\n const key = generateQueryKeyFromOptions(options)\n const hashedQueryKey = hashKey(key)\n\n // 3. Decrement refcount\n const currentCount = queryRefCounts.get(hashedQueryKey) \|\| 0\n const newCount = currentCount - 1\n\n // Update refcount\n if (newCount <= 0) {\n queryRefCounts.set(hashedQueryKey, 0)\n cleanupQueryIfIdle(hashedQueryKey)\n } else {\n // Still have other references, just decrement\n queryRefCounts.set(hashedQueryKey, newCount)\n }\n }\n\n // Create deduplicated loadSubset wrapper for non-eager modes\n // This prevents redundant snapshot requests when multiple concurrent\n // live queries request overlapping or subset predicates\n const loadSubsetDedupe =\n syncMode === `eager` ? undefined : createQueryFromOpts\n\n return {\n loadSubset: loadSubsetDedupe,\n unloadSubset: syncMode === `eager` ? undefined : unloadSubset,\n cleanup,\n }\n }\n\n /\n Refetch the query data\n \n Uses queryObserver.refetch() because:\n * - Bypasses `enabled: false` to support manual/imperative refetch patterns (e.g., button-triggered fetch)\n * - Ensures clearError() works even when enabled: false\n * - Always refetches THIS specific collection (exact targeting via observer)\n * - Respects retry, retryDelay, and other observer options\n \n This matches TanStack Query's hook behavior where refetch() bypasses enabled: false.\n * See: https://tanstack.com/query/latest/docs/framework/react/guides/disabling-queries\n \n Used by both:\n * - utils.refetch() - for explicit user-triggered refetches\n * - Internal handlers (onInsert/onUpdate/onDelete) - after mutations to get fresh data\n \n @returns Promise that resolves when the refetch is complete, with QueryObserverResult\n */\n const refetch: RefetchFn = async (opts) => {\n const allQueryKeys = [...hashToQueryKey.values()]\n const refetchPromises = allQueryKeys.map((qKey) => {\n const queryObserver = state.observers.get(hashKey(qKey))!\n return queryObserver.refetch({\n throwOnError: opts?.throwOnError,\n })\n })\n\n await Promise.all(refetchPromises)\n }\n\n // Create write context for manual write operations\n let writeContext: {\n collection: any\n queryClient: QueryClient\n queryKey: Array<unknown>\n getKey: (item: any) => string \| number\n begin: () => void\n write: (message: Omit<ChangeMessage<any>, `key`>) => void\n commit: () => void\n } \| null = null\n\n // Enhanced internalSync that captures write functions for manual use\n const enhancedInternalSync: SyncConfig<any>[`sync`] = (params) => {\n const { begin, write, commit, collection } = params\n\n // Store references for manual write operations\n writeContext = {\n collection,\n queryClient,\n queryKey: queryKey as unknown as Array<unknown>,\n getKey: getKey as (item: any) => string \| number,\n begin,\n write,\n commit,\n }\n\n // Call the original internalSync logic\n return internalSync(params)\n }\n\n // Create write utils using the manual-sync module\n const writeUtils = createWriteUtils<any, string \| number, any>(\n () => writeContext\n )\n\n // Create wrapper handlers for direct persistence operations that handle refetching\n const wrappedOnInsert = onInsert\n ? async (params: InsertMutationFnParams<any>) => {\n const handlerResult = (await onInsert(params)) ?? {}\n const shouldRefetch =\n (handlerResult as { refetch?: boolean }).refetch !== false\n\n if (shouldRefetch) {\n await refetch()\n }\n\n return handlerResult\n }\n : undefined\n\n const wrappedOnUpdate = onUpdate\n ? async (params: UpdateMutationFnParams<any>) => {\n const handlerResult = (await onUpdate(params)) ?? {}\n const shouldRefetch =\n (handlerResult as { refetch?: boolean }).refetch !== false\n\n if (shouldRefetch) {\n await refetch()\n }\n\n return handlerResult\n }\n : undefined\n\n const wrappedOnDelete = onDelete\n ? async (params: DeleteMutationFnParams<any>) => {\n const handlerResult = (await onDelete(params)) ?? {}\n const shouldRefetch =\n (handlerResult as { refetch?: boolean }).refetch !== false\n\n if (shouldRefetch) {\n await refetch()\n }\n\n return handlerResult\n }\n : undefined\n\n // Create utils instance with state and dependencies passed explicitly\n const utils: any = new QueryCollectionUtilsImpl(state, refetch, writeUtils)\n\n return {\n ...baseCollectionConfig,\n getKey,\n syncMode,\n sync: { sync: enhancedInternalSync },\n onInsert: wrappedOnInsert,\n onUpdate: wrappedOnUpdate,\n onDelete: wrappedOnDelete,\n utils,\n }\n}\n"],"names":["queryKey"],"mappings":"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"}

package/package.json CHANGED Viewed

@@ -1,14 +1,14 @@
 {
   "name": "@tanstack/query-db-collection",
   "description": "TanStack Query collection for TanStack DB",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "dependencies": {
     "@standard-schema/spec": "^1.0.0"
   },
   "devDependencies": {
     "@tanstack/query-core": "^5.90.10",
     "@vitest/coverage-istanbul": "^3.2.4",
-    "@tanstack/db": "0.5.4"
+    "@tanstack/db": "0.5.6"
   },
   "exports": {
     ".": {

package/src/global.ts ADDED Viewed

@@ -0,0 +1,40 @@
+/**
+ * Global type augmentation for @tanstack/query-core
+ *
+ * This file ensures the module augmentation is always loaded when the package is imported.
+ * The index.ts file re-exports QueryCollectionMeta from this file, which guarantees
+ * TypeScript processes this file (and its module augmentation) whenever anyone imports
+ * from @tanstack/query-db-collection.
+ *
+ * This makes ctx.meta?.loadSubsetOptions automatically type-safe without requiring
+ * users to manually import QueryCollectionMeta.
+ */
+import type { LoadSubsetOptions } from "@tanstack/db"
+/**
+ * Base interface for Query Collection meta properties.
+ * Users can extend this interface to add their own custom properties while
+ * preserving loadSubsetOptions.
+ *
+ * @example
+ * ```typescript
+ * declare module "@tanstack/query-db-collection" {
+ *   interface QueryCollectionMeta {
+ *     myCustomProperty: string
+ *     userId?: number
+ *   }
+ * }
+ * ```
+ */
+export interface QueryCollectionMeta extends Record<string, unknown> {
+  loadSubsetOptions: LoadSubsetOptions
+}
+// Module augmentation to extend TanStack Query's Register interface
+// This ensures that ctx.meta always includes loadSubsetOptions
+declare module "@tanstack/query-core" {
+  interface Register {
+    queryMeta: QueryCollectionMeta
+  }
+}

package/src/index.ts CHANGED Viewed

@@ -1,7 +1,10 @@
+// Export QueryCollectionMeta from global.ts
+// This ensures the module augmentation in global.ts is processed by TypeScript
+export type { QueryCollectionMeta } from "./global"
 export {
   queryCollectionOptions,
   type QueryCollectionConfig,
-  type QueryCollectionMeta,
   type QueryCollectionUtils,
   type SyncOperation,
 } from "./query"