@tanstack/query-db-collection 1.0.0 → 1.0.2

package/dist/cjs/query.cjs

@@ -1,9 +1,9 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const queryCore = require("@tanstack/query-core");
-const db = require("@tanstack/db");
 const errors = require("./errors.cjs");
 const manualSync = require("./manual-sync.cjs");
+const serialization = require("./serialization.cjs");
 class QueryCollectionUtilsImpl {
   constructor(state, refetch, writeUtils) {
     this.state = state;
@@ -123,7 +123,15 @@ function queryCollectionOptions(config) {
     const { begin, write, commit, markReady, collection } = params;
     let syncStarted = false;
     const createQueryFromOpts = (opts = {}, queryFunction = queryFn) => {
-      const key = typeof queryKey === `function` ? queryKey(opts) : queryKey;
+      let key;
+      if (typeof queryKey === `function`) {
+        key = queryKey(opts);
+      } else if (syncMode === `on-demand`) {
+        const serialized = serialization.serializeLoadSubsetOptions(opts);
+        key = serialized !== void 0 ? [...queryKey, serialized] : queryKey;
+      } else {
+        key = queryKey;
+      }
       const hashedQueryKey = queryCore.hashKey(key);
       const extendedMeta = { ...meta, loadSubsetOptions: opts };
       if (state.observers.has(hashedQueryKey)) {
@@ -251,16 +259,6 @@ function queryCollectionOptions(config) {
       };
       return handleQueryResult;
     };
-    const createLocalQuery = (opts) => {
-      const queryFn2 = ({ meta: meta2 }) => {
-        const inserts = collection.currentStateAsChanges(
-          meta2.loadSubsetOptions
-        );
-        const data = inserts.map(({ value }) => value);
-        return Promise.resolve(data);
-      };
-      createQueryFromOpts(opts, queryFn2);
-    };
     const isSubscribed = (hashedQueryKey) => {
       return unsubscribes.has(hashedQueryKey);
     };
@@ -351,12 +349,9 @@ function queryCollectionOptions(config) {
         })
       );
     };
-    const loadSubsetDedupe = syncMode === `eager` ? void 0 : new db.DeduplicatedLoadSubset({
-      loadSubset: createQueryFromOpts,
-      onDeduplicate: createLocalQuery
-    });
+    const loadSubsetDedupe = syncMode === `eager` ? void 0 : createQueryFromOpts;
     return {
-      loadSubset: loadSubsetDedupe?.loadSubset,
+      loadSubset: loadSubsetDedupe,
       cleanup
     };
   };

package/dist/cjs/query.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"query.cjs","sources":["../../src/query.ts"],"sourcesContent":["import { QueryObserver, hashKey } from \"@tanstack/query-core\"\nimport { DeduplicatedLoadSubset } from \"@tanstack/db\"\nimport {\n  GetKeyRequiredError,\n  QueryClientRequiredError,\n  QueryFnRequiredError,\n  QueryKeyRequiredError,\n} from \"./errors\"\nimport { createWriteUtils } from \"./manual-sync\"\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  // 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      const key = typeof queryKey === `function` ? queryKey(opts) : queryKey\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    // This function is called when a loadSubset call is deduplicated\n    // meaning that we have all the data locally available to answer the query\n    // so we execute the query locally\n    const createLocalQuery = (opts: LoadSubsetOptions) => {\n      const queryFn = ({ meta }: QueryFunctionContext<any>) => {\n        const inserts = collection.currentStateAsChanges(\n          meta!.loadSubsetOptions as LoadSubsetOptions\n        )!\n        const data = inserts.map(({ value }) => value)\n        return Promise.resolve(data)\n      }\n\n      createQueryFromOpts(opts, queryFn)\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`\n        ? undefined\n        : new DeduplicatedLoadSubset({\n            loadSubset: createQueryFromOpts,\n            onDeduplicate: createLocalQuery,\n          })\n\n    return {\n      loadSubset: loadSubsetDedupe?.loadSubset,\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":["QueryKeyRequiredError","QueryFnRequiredError","QueryClientRequiredError","GetKeyRequiredError","hashKey","QueryObserver","queryKey","queryFn","meta","DeduplicatedLoadSubset","createWriteUtils"],"mappings":"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"}
+{"version":3,"file":"query.cjs","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  // 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":["QueryKeyRequiredError","QueryFnRequiredError","QueryClientRequiredError","GetKeyRequiredError","serializeLoadSubsetOptions","hashKey","QueryObserver","queryKey","createWriteUtils"],"mappings":"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"}

package/dist/cjs/serialization.cjs

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+function serializeLoadSubsetOptions(options) {
+  if (!options) {
+    return void 0;
+  }
+  const result = {};
+  if (options.where) {
+    result.where = serializeExpression(options.where);
+  }
+  if (options.orderBy?.length) {
+    result.orderBy = options.orderBy.map((clause) => {
+      const baseOrderBy = {
+        expression: serializeExpression(clause.expression),
+        direction: clause.compareOptions.direction,
+        nulls: clause.compareOptions.nulls,
+        stringSort: clause.compareOptions.stringSort
+      };
+      if (clause.compareOptions.stringSort === `locale`) {
+        return {
+          ...baseOrderBy,
+          locale: clause.compareOptions.locale,
+          localeOptions: clause.compareOptions.localeOptions
+        };
+      }
+      return baseOrderBy;
+    });
+  }
+  if (options.limit !== void 0) {
+    result.limit = options.limit;
+  }
+  return Object.keys(result).length === 0 ? void 0 : JSON.stringify(result);
+}
+function serializeExpression(expr) {
+  if (!expr) {
+    return null;
+  }
+  switch (expr.type) {
+    case `val`:
+      return {
+        type: `val`,
+        value: serializeValue(expr.value)
+      };
+    case `ref`:
+      return {
+        type: `ref`,
+        path: [...expr.path]
+      };
+    case `func`:
+      return {
+        type: `func`,
+        name: expr.name,
+        args: expr.args.map((arg) => serializeExpression(arg))
+      };
+    default:
+      return null;
+  }
+}
+function serializeValue(value) {
+  if (value === void 0) {
+    return { __type: `undefined` };
+  }
+  if (typeof value === `number`) {
+    if (Number.isNaN(value)) {
+      return { __type: `nan` };
+    }
+    if (value === Number.POSITIVE_INFINITY) {
+      return { __type: `infinity`, sign: 1 };
+    }
+    if (value === Number.NEGATIVE_INFINITY) {
+      return { __type: `infinity`, sign: -1 };
+    }
+  }
+  if (value === null || typeof value === `string` || typeof value === `number` || typeof value === `boolean`) {
+    return value;
+  }
+  if (value instanceof Date) {
+    return { __type: `date`, value: value.toJSON() };
+  }
+  if (Array.isArray(value)) {
+    return value.map((item) => serializeValue(item));
+  }
+  if (typeof value === `object`) {
+    return Object.fromEntries(
+      Object.entries(value).map(([key, val]) => [
+        key,
+        serializeValue(val)
+      ])
+    );
+  }
+  return value;
+}
+exports.serializeLoadSubsetOptions = serializeLoadSubsetOptions;
+//# sourceMappingURL=serialization.cjs.map

package/dist/cjs/serialization.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization.cjs","sources":["../../src/serialization.ts"],"sourcesContent":["import type { IR, LoadSubsetOptions } from \"@tanstack/db\"\n\n/**\n * Serializes LoadSubsetOptions into a stable, hashable format for query keys\n * @internal\n */\nexport function serializeLoadSubsetOptions(\n  options: LoadSubsetOptions | undefined\n): string | undefined {\n  if (!options) {\n    return undefined\n  }\n\n  const result: Record<string, unknown> = {}\n\n  if (options.where) {\n    result.where = serializeExpression(options.where)\n  }\n\n  if (options.orderBy?.length) {\n    result.orderBy = options.orderBy.map((clause) => {\n      const baseOrderBy = {\n        expression: serializeExpression(clause.expression),\n        direction: clause.compareOptions.direction,\n        nulls: clause.compareOptions.nulls,\n        stringSort: clause.compareOptions.stringSort,\n      }\n\n      // Handle locale-specific options when stringSort is 'locale'\n      if (clause.compareOptions.stringSort === `locale`) {\n        return {\n          ...baseOrderBy,\n          locale: clause.compareOptions.locale,\n          localeOptions: clause.compareOptions.localeOptions,\n        }\n      }\n\n      return baseOrderBy\n    })\n  }\n\n  if (options.limit !== undefined) {\n    result.limit = options.limit\n  }\n\n  return Object.keys(result).length === 0 ? undefined : JSON.stringify(result)\n}\n\n/**\n * Recursively serializes an IR expression for stable hashing\n * @internal\n */\nfunction serializeExpression(expr: IR.BasicExpression | undefined): unknown {\n  if (!expr) {\n    return null\n  }\n\n  switch (expr.type) {\n    case `val`:\n      return {\n        type: `val`,\n        value: serializeValue(expr.value),\n      }\n    case `ref`:\n      return {\n        type: `ref`,\n        path: [...expr.path],\n      }\n    case `func`:\n      return {\n        type: `func`,\n        name: expr.name,\n        args: expr.args.map((arg) => serializeExpression(arg)),\n      }\n    default:\n      return null\n  }\n}\n\n/**\n * Serializes special JavaScript values (undefined, NaN, Infinity, Date)\n * @internal\n */\nfunction serializeValue(value: unknown): unknown {\n  if (value === undefined) {\n    return { __type: `undefined` }\n  }\n\n  if (typeof value === `number`) {\n    if (Number.isNaN(value)) {\n      return { __type: `nan` }\n    }\n    if (value === Number.POSITIVE_INFINITY) {\n      return { __type: `infinity`, sign: 1 }\n    }\n    if (value === Number.NEGATIVE_INFINITY) {\n      return { __type: `infinity`, sign: -1 }\n    }\n  }\n\n  if (\n    value === null ||\n    typeof value === `string` ||\n    typeof value === `number` ||\n    typeof value === `boolean`\n  ) {\n    return value\n  }\n\n  if (value instanceof Date) {\n    return { __type: `date`, value: value.toJSON() }\n  }\n\n  if (Array.isArray(value)) {\n    return value.map((item) => serializeValue(item))\n  }\n\n  if (typeof value === `object`) {\n    return Object.fromEntries(\n      Object.entries(value as Record<string, unknown>).map(([key, val]) => [\n        key,\n        serializeValue(val),\n      ])\n    )\n  }\n\n  return value\n}\n"],"names":[],"mappings":";;AAMO,SAAS,2BACd,SACoB;AACpB,MAAI,CAAC,SAAS;AACZ,WAAO;AAAA,EACT;AAEA,QAAM,SAAkC,CAAA;AAExC,MAAI,QAAQ,OAAO;AACjB,WAAO,QAAQ,oBAAoB,QAAQ,KAAK;AAAA,EAClD;AAEA,MAAI,QAAQ,SAAS,QAAQ;AAC3B,WAAO,UAAU,QAAQ,QAAQ,IAAI,CAAC,WAAW;AAC/C,YAAM,cAAc;AAAA,QAClB,YAAY,oBAAoB,OAAO,UAAU;AAAA,QACjD,WAAW,OAAO,eAAe;AAAA,QACjC,OAAO,OAAO,eAAe;AAAA,QAC7B,YAAY,OAAO,eAAe;AAAA,MAAA;AAIpC,UAAI,OAAO,eAAe,eAAe,UAAU;AACjD,eAAO;AAAA,UACL,GAAG;AAAA,UACH,QAAQ,OAAO,eAAe;AAAA,UAC9B,eAAe,OAAO,eAAe;AAAA,QAAA;AAAA,MAEzC;AAEA,aAAO;AAAA,IACT,CAAC;AAAA,EACH;AAEA,MAAI,QAAQ,UAAU,QAAW;AAC/B,WAAO,QAAQ,QAAQ;AAAA,EACzB;AAEA,SAAO,OAAO,KAAK,MAAM,EAAE,WAAW,IAAI,SAAY,KAAK,UAAU,MAAM;AAC7E;AAMA,SAAS,oBAAoB,MAA+C;AAC1E,MAAI,CAAC,MAAM;AACT,WAAO;AAAA,EACT;AAEA,UAAQ,KAAK,MAAA;AAAA,IACX,KAAK;AACH,aAAO;AAAA,QACL,MAAM;AAAA,QACN,OAAO,eAAe,KAAK,KAAK;AAAA,MAAA;AAAA,IAEpC,KAAK;AACH,aAAO;AAAA,QACL,MAAM;AAAA,QACN,MAAM,CAAC,GAAG,KAAK,IAAI;AAAA,MAAA;AAAA,IAEvB,KAAK;AACH,aAAO;AAAA,QACL,MAAM;AAAA,QACN,MAAM,KAAK;AAAA,QACX,MAAM,KAAK,KAAK,IAAI,CAAC,QAAQ,oBAAoB,GAAG,CAAC;AAAA,MAAA;AAAA,IAEzD;AACE,aAAO;AAAA,EAAA;AAEb;AAMA,SAAS,eAAe,OAAyB;AAC/C,MAAI,UAAU,QAAW;AACvB,WAAO,EAAE,QAAQ,YAAA;AAAA,EACnB;AAEA,MAAI,OAAO,UAAU,UAAU;AAC7B,QAAI,OAAO,MAAM,KAAK,GAAG;AACvB,aAAO,EAAE,QAAQ,MAAA;AAAA,IACnB;AACA,QAAI,UAAU,OAAO,mBAAmB;AACtC,aAAO,EAAE,QAAQ,YAAY,MAAM,EAAA;AAAA,IACrC;AACA,QAAI,UAAU,OAAO,mBAAmB;AACtC,aAAO,EAAE,QAAQ,YAAY,MAAM,GAAA;AAAA,IACrC;AAAA,EACF;AAEA,MACE,UAAU,QACV,OAAO,UAAU,YACjB,OAAO,UAAU,YACjB,OAAO,UAAU,WACjB;AACA,WAAO;AAAA,EACT;AAEA,MAAI,iBAAiB,MAAM;AACzB,WAAO,EAAE,QAAQ,QAAQ,OAAO,MAAM,SAAO;AAAA,EAC/C;AAEA,MAAI,MAAM,QAAQ,KAAK,GAAG;AACxB,WAAO,MAAM,IAAI,CAAC,SAAS,eAAe,IAAI,CAAC;AAAA,EACjD;AAEA,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO,OAAO;AAAA,MACZ,OAAO,QAAQ,KAAgC,EAAE,IAAI,CAAC,CAAC,KAAK,GAAG,MAAM;AAAA,QACnE;AAAA,QACA,eAAe,GAAG;AAAA,MAAA,CACnB;AAAA,IAAA;AAAA,EAEL;AAEA,SAAO;AACT;;"}

package/dist/cjs/serialization.d.cts

@@ -0,0 +1,6 @@
+import { LoadSubsetOptions } from '@tanstack/db';
+/**
+ * Serializes LoadSubsetOptions into a stable, hashable format for query keys
+ * @internal
+ */
+export declare function serializeLoadSubsetOptions(options: LoadSubsetOptions | undefined): string | undefined;

package/dist/esm/query.js

@@ -1,7 +1,7 @@
 import { hashKey, QueryObserver } from "@tanstack/query-core";
-import { DeduplicatedLoadSubset } from "@tanstack/db";
 import { QueryKeyRequiredError, QueryFnRequiredError, QueryClientRequiredError, GetKeyRequiredError } from "./errors.js";
 import { createWriteUtils } from "./manual-sync.js";
+import { serializeLoadSubsetOptions } from "./serialization.js";
 class QueryCollectionUtilsImpl {
   constructor(state, refetch, writeUtils) {
     this.state = state;
@@ -121,7 +121,15 @@ function queryCollectionOptions(config) {
     const { begin, write, commit, markReady, collection } = params;
     let syncStarted = false;
     const createQueryFromOpts = (opts = {}, queryFunction = queryFn) => {
-      const key = typeof queryKey === `function` ? queryKey(opts) : queryKey;
+      let key;
+      if (typeof queryKey === `function`) {
+        key = queryKey(opts);
+      } else if (syncMode === `on-demand`) {
+        const serialized = serializeLoadSubsetOptions(opts);
+        key = serialized !== void 0 ? [...queryKey, serialized] : queryKey;
+      } else {
+        key = queryKey;
+      }
       const hashedQueryKey = hashKey(key);
       const extendedMeta = { ...meta, loadSubsetOptions: opts };
       if (state.observers.has(hashedQueryKey)) {
@@ -249,16 +257,6 @@ function queryCollectionOptions(config) {
       };
       return handleQueryResult;
     };
-    const createLocalQuery = (opts) => {
-      const queryFn2 = ({ meta: meta2 }) => {
-        const inserts = collection.currentStateAsChanges(
-          meta2.loadSubsetOptions
-        );
-        const data = inserts.map(({ value }) => value);
-        return Promise.resolve(data);
-      };
-      createQueryFromOpts(opts, queryFn2);
-    };
     const isSubscribed = (hashedQueryKey) => {
       return unsubscribes.has(hashedQueryKey);
     };
@@ -349,12 +347,9 @@ function queryCollectionOptions(config) {
         })
       );
     };
-    const loadSubsetDedupe = syncMode === `eager` ? void 0 : new DeduplicatedLoadSubset({
-      loadSubset: createQueryFromOpts,
-      onDeduplicate: createLocalQuery
-    });
+    const loadSubsetDedupe = syncMode === `eager` ? void 0 : createQueryFromOpts;
     return {
-      loadSubset: loadSubsetDedupe?.loadSubset,
+      loadSubset: loadSubsetDedupe,
       cleanup
     };
   };

package/dist/esm/query.js.map

@@ -1 +1 @@
-{"version":3,"file":"query.js","sources":["../../src/query.ts"],"sourcesContent":["import { QueryObserver, hashKey } from \"@tanstack/query-core\"\nimport { DeduplicatedLoadSubset } from \"@tanstack/db\"\nimport {\n  GetKeyRequiredError,\n  QueryClientRequiredError,\n  QueryFnRequiredError,\n  QueryKeyRequiredError,\n} from \"./errors\"\nimport { createWriteUtils } from \"./manual-sync\"\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  // 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      const key = typeof queryKey === `function` ? queryKey(opts) : queryKey\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    // This function is called when a loadSubset call is deduplicated\n    // meaning that we have all the data locally available to answer the query\n    // so we execute the query locally\n    const createLocalQuery = (opts: LoadSubsetOptions) => {\n      const queryFn = ({ meta }: QueryFunctionContext<any>) => {\n        const inserts = collection.currentStateAsChanges(\n          meta!.loadSubsetOptions as LoadSubsetOptions\n        )!\n        const data = inserts.map(({ value }) => value)\n        return Promise.resolve(data)\n      }\n\n      createQueryFromOpts(opts, queryFn)\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`\n        ? undefined\n        : new DeduplicatedLoadSubset({\n            loadSubset: createQueryFromOpts,\n            onDeduplicate: createLocalQuery,\n          })\n\n    return {\n      loadSubset: loadSubsetDedupe?.loadSubset,\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","queryFn","meta"],"mappings":"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"}
+{"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  // 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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"}

package/dist/esm/serialization.d.ts

@@ -0,0 +1,6 @@
+import { LoadSubsetOptions } from '@tanstack/db';
+/**
+ * Serializes LoadSubsetOptions into a stable, hashable format for query keys
+ * @internal
+ */
+export declare function serializeLoadSubsetOptions(options: LoadSubsetOptions | undefined): string | undefined;

package/dist/esm/serialization.js

@@ -0,0 +1,94 @@
+function serializeLoadSubsetOptions(options) {
+  if (!options) {
+    return void 0;
+  }
+  const result = {};
+  if (options.where) {
+    result.where = serializeExpression(options.where);
+  }
+  if (options.orderBy?.length) {
+    result.orderBy = options.orderBy.map((clause) => {
+      const baseOrderBy = {
+        expression: serializeExpression(clause.expression),
+        direction: clause.compareOptions.direction,
+        nulls: clause.compareOptions.nulls,
+        stringSort: clause.compareOptions.stringSort
+      };
+      if (clause.compareOptions.stringSort === `locale`) {
+        return {
+          ...baseOrderBy,
+          locale: clause.compareOptions.locale,
+          localeOptions: clause.compareOptions.localeOptions
+        };
+      }
+      return baseOrderBy;
+    });
+  }
+  if (options.limit !== void 0) {
+    result.limit = options.limit;
+  }
+  return Object.keys(result).length === 0 ? void 0 : JSON.stringify(result);
+}
+function serializeExpression(expr) {
+  if (!expr) {
+    return null;
+  }
+  switch (expr.type) {
+    case `val`:
+      return {
+        type: `val`,
+        value: serializeValue(expr.value)
+      };
+    case `ref`:
+      return {
+        type: `ref`,
+        path: [...expr.path]
+      };
+    case `func`:
+      return {
+        type: `func`,
+        name: expr.name,
+        args: expr.args.map((arg) => serializeExpression(arg))
+      };
+    default:
+      return null;
+  }
+}
+function serializeValue(value) {
+  if (value === void 0) {
+    return { __type: `undefined` };
+  }
+  if (typeof value === `number`) {
+    if (Number.isNaN(value)) {
+      return { __type: `nan` };
+    }
+    if (value === Number.POSITIVE_INFINITY) {
+      return { __type: `infinity`, sign: 1 };
+    }
+    if (value === Number.NEGATIVE_INFINITY) {
+      return { __type: `infinity`, sign: -1 };
+    }
+  }
+  if (value === null || typeof value === `string` || typeof value === `number` || typeof value === `boolean`) {
+    return value;
+  }
+  if (value instanceof Date) {
+    return { __type: `date`, value: value.toJSON() };
+  }
+  if (Array.isArray(value)) {
+    return value.map((item) => serializeValue(item));
+  }
+  if (typeof value === `object`) {
+    return Object.fromEntries(
+      Object.entries(value).map(([key, val]) => [
+        key,
+        serializeValue(val)
+      ])
+    );
+  }
+  return value;
+}
+export {
+  serializeLoadSubsetOptions
+};
+//# sourceMappingURL=serialization.js.map

package/dist/esm/serialization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization.js","sources":["../../src/serialization.ts"],"sourcesContent":["import type { IR, LoadSubsetOptions } from \"@tanstack/db\"\n\n/**\n * Serializes LoadSubsetOptions into a stable, hashable format for query keys\n * @internal\n */\nexport function serializeLoadSubsetOptions(\n  options: LoadSubsetOptions | undefined\n): string | undefined {\n  if (!options) {\n    return undefined\n  }\n\n  const result: Record<string, unknown> = {}\n\n  if (options.where) {\n    result.where = serializeExpression(options.where)\n  }\n\n  if (options.orderBy?.length) {\n    result.orderBy = options.orderBy.map((clause) => {\n      const baseOrderBy = {\n        expression: serializeExpression(clause.expression),\n        direction: clause.compareOptions.direction,\n        nulls: clause.compareOptions.nulls,\n        stringSort: clause.compareOptions.stringSort,\n      }\n\n      // Handle locale-specific options when stringSort is 'locale'\n      if (clause.compareOptions.stringSort === `locale`) {\n        return {\n          ...baseOrderBy,\n          locale: clause.compareOptions.locale,\n          localeOptions: clause.compareOptions.localeOptions,\n        }\n      }\n\n      return baseOrderBy\n    })\n  }\n\n  if (options.limit !== undefined) {\n    result.limit = options.limit\n  }\n\n  return Object.keys(result).length === 0 ? undefined : JSON.stringify(result)\n}\n\n/**\n * Recursively serializes an IR expression for stable hashing\n * @internal\n */\nfunction serializeExpression(expr: IR.BasicExpression | undefined): unknown {\n  if (!expr) {\n    return null\n  }\n\n  switch (expr.type) {\n    case `val`:\n      return {\n        type: `val`,\n        value: serializeValue(expr.value),\n      }\n    case `ref`:\n      return {\n        type: `ref`,\n        path: [...expr.path],\n      }\n    case `func`:\n      return {\n        type: `func`,\n        name: expr.name,\n        args: expr.args.map((arg) => serializeExpression(arg)),\n      }\n    default:\n      return null\n  }\n}\n\n/**\n * Serializes special JavaScript values (undefined, NaN, Infinity, Date)\n * @internal\n */\nfunction serializeValue(value: unknown): unknown {\n  if (value === undefined) {\n    return { __type: `undefined` }\n  }\n\n  if (typeof value === `number`) {\n    if (Number.isNaN(value)) {\n      return { __type: `nan` }\n    }\n    if (value === Number.POSITIVE_INFINITY) {\n      return { __type: `infinity`, sign: 1 }\n    }\n    if (value === Number.NEGATIVE_INFINITY) {\n      return { __type: `infinity`, sign: -1 }\n    }\n  }\n\n  if (\n    value === null ||\n    typeof value === `string` ||\n    typeof value === `number` ||\n    typeof value === `boolean`\n  ) {\n    return value\n  }\n\n  if (value instanceof Date) {\n    return { __type: `date`, value: value.toJSON() }\n  }\n\n  if (Array.isArray(value)) {\n    return value.map((item) => serializeValue(item))\n  }\n\n  if (typeof value === `object`) {\n    return Object.fromEntries(\n      Object.entries(value as Record<string, unknown>).map(([key, val]) => [\n        key,\n        serializeValue(val),\n      ])\n    )\n  }\n\n  return value\n}\n"],"names":[],"mappings":"AAMO,SAAS,2BACd,SACoB;AACpB,MAAI,CAAC,SAAS;AACZ,WAAO;AAAA,EACT;AAEA,QAAM,SAAkC,CAAA;AAExC,MAAI,QAAQ,OAAO;AACjB,WAAO,QAAQ,oBAAoB,QAAQ,KAAK;AAAA,EAClD;AAEA,MAAI,QAAQ,SAAS,QAAQ;AAC3B,WAAO,UAAU,QAAQ,QAAQ,IAAI,CAAC,WAAW;AAC/C,YAAM,cAAc;AAAA,QAClB,YAAY,oBAAoB,OAAO,UAAU;AAAA,QACjD,WAAW,OAAO,eAAe;AAAA,QACjC,OAAO,OAAO,eAAe;AAAA,QAC7B,YAAY,OAAO,eAAe;AAAA,MAAA;AAIpC,UAAI,OAAO,eAAe,eAAe,UAAU;AACjD,eAAO;AAAA,UACL,GAAG;AAAA,UACH,QAAQ,OAAO,eAAe;AAAA,UAC9B,eAAe,OAAO,eAAe;AAAA,QAAA;AAAA,MAEzC;AAEA,aAAO;AAAA,IACT,CAAC;AAAA,EACH;AAEA,MAAI,QAAQ,UAAU,QAAW;AAC/B,WAAO,QAAQ,QAAQ;AAAA,EACzB;AAEA,SAAO,OAAO,KAAK,MAAM,EAAE,WAAW,IAAI,SAAY,KAAK,UAAU,MAAM;AAC7E;AAMA,SAAS,oBAAoB,MAA+C;AAC1E,MAAI,CAAC,MAAM;AACT,WAAO;AAAA,EACT;AAEA,UAAQ,KAAK,MAAA;AAAA,IACX,KAAK;AACH,aAAO;AAAA,QACL,MAAM;AAAA,QACN,OAAO,eAAe,KAAK,KAAK;AAAA,MAAA;AAAA,IAEpC,KAAK;AACH,aAAO;AAAA,QACL,MAAM;AAAA,QACN,MAAM,CAAC,GAAG,KAAK,IAAI;AAAA,MAAA;AAAA,IAEvB,KAAK;AACH,aAAO;AAAA,QACL,MAAM;AAAA,QACN,MAAM,KAAK;AAAA,QACX,MAAM,KAAK,KAAK,IAAI,CAAC,QAAQ,oBAAoB,GAAG,CAAC;AAAA,MAAA;AAAA,IAEzD;AACE,aAAO;AAAA,EAAA;AAEb;AAMA,SAAS,eAAe,OAAyB;AAC/C,MAAI,UAAU,QAAW;AACvB,WAAO,EAAE,QAAQ,YAAA;AAAA,EACnB;AAEA,MAAI,OAAO,UAAU,UAAU;AAC7B,QAAI,OAAO,MAAM,KAAK,GAAG;AACvB,aAAO,EAAE,QAAQ,MAAA;AAAA,IACnB;AACA,QAAI,UAAU,OAAO,mBAAmB;AACtC,aAAO,EAAE,QAAQ,YAAY,MAAM,EAAA;AAAA,IACrC;AACA,QAAI,UAAU,OAAO,mBAAmB;AACtC,aAAO,EAAE,QAAQ,YAAY,MAAM,GAAA;AAAA,IACrC;AAAA,EACF;AAEA,MACE,UAAU,QACV,OAAO,UAAU,YACjB,OAAO,UAAU,YACjB,OAAO,UAAU,WACjB;AACA,WAAO;AAAA,EACT;AAEA,MAAI,iBAAiB,MAAM;AACzB,WAAO,EAAE,QAAQ,QAAQ,OAAO,MAAM,SAAO;AAAA,EAC/C;AAEA,MAAI,MAAM,QAAQ,KAAK,GAAG;AACxB,WAAO,MAAM,IAAI,CAAC,SAAS,eAAe,IAAI,CAAC;AAAA,EACjD;AAEA,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO,OAAO;AAAA,MACZ,OAAO,QAAQ,KAAgC,EAAE,IAAI,CAAC,CAAC,KAAK,GAAG,MAAM;AAAA,QACnE;AAAA,QACA,eAAe,GAAG;AAAA,MAAA,CACnB;AAAA,IAAA;AAAA,EAEL;AAEA,SAAO;AACT;"}

package/package.json

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

package/src/query.ts

@@ -1,5 +1,4 @@
 import { QueryObserver, hashKey } from "@tanstack/query-core"
-import { DeduplicatedLoadSubset } from "@tanstack/db"
 import {
   GetKeyRequiredError,
   QueryClientRequiredError,
@@ -7,6 +6,7 @@ import {
   QueryKeyRequiredError,
 } from "./errors"
 import { createWriteUtils } from "./manual-sync"
+import { serializeLoadSubsetOptions } from "./serialization"
 import type {
   BaseCollectionConfig,
   ChangeMessage,
@@ -627,7 +627,19 @@ export function queryCollectionOptions(
       queryFunction: typeof queryFn = queryFn
     ): true | Promise<void> => {
       // Push the predicates down to the queryKey and queryFn
-      const key = typeof queryKey === `function` ? queryKey(opts) : queryKey
+      let key: QueryKey
+      if (typeof queryKey === `function`) {
+        // Function-based queryKey: use it to build the key from opts
+        key = queryKey(opts)
+      } else if (syncMode === `on-demand`) {
+        // Static queryKey in on-demand mode: automatically append serialized predicates
+        // to create separate cache entries for different predicate combinations
+        const serialized = serializeLoadSubsetOptions(opts)
+        key = serialized !== undefined ? [...queryKey, serialized] : queryKey
+      } else {
+        // Static queryKey in eager mode: use as-is
+        key = queryKey
+      }
       const hashedQueryKey = hashKey(key)
       const extendedMeta = { ...meta, loadSubsetOptions: opts }
 
@@ -824,21 +836,6 @@ export function queryCollectionOptions(
       return handleQueryResult
     }
 
-    // This function is called when a loadSubset call is deduplicated
-    // meaning that we have all the data locally available to answer the query
-    // so we execute the query locally
-    const createLocalQuery = (opts: LoadSubsetOptions) => {
-      const queryFn = ({ meta }: QueryFunctionContext<any>) => {
-        const inserts = collection.currentStateAsChanges(
-          meta!.loadSubsetOptions as LoadSubsetOptions
-        )!
-        const data = inserts.map(({ value }) => value)
-        return Promise.resolve(data)
-      }
-
-      createQueryFromOpts(opts, queryFn)
-    }
-
     const isSubscribed = (hashedQueryKey: string) => {
       return unsubscribes.has(hashedQueryKey)
     }
@@ -972,15 +969,10 @@ export function queryCollectionOptions(
     // This prevents redundant snapshot requests when multiple concurrent
     // live queries request overlapping or subset predicates
     const loadSubsetDedupe =
-      syncMode === `eager`
-        ? undefined
-        : new DeduplicatedLoadSubset({
-            loadSubset: createQueryFromOpts,
-            onDeduplicate: createLocalQuery,
-          })
+      syncMode === `eager` ? undefined : createQueryFromOpts
 
     return {
-      loadSubset: loadSubsetDedupe?.loadSubset,
+      loadSubset: loadSubsetDedupe,
       cleanup,
     }
   }

package/src/serialization.ts

@@ -0,0 +1,128 @@
+import type { IR, LoadSubsetOptions } from "@tanstack/db"
+
+/**
+ * Serializes LoadSubsetOptions into a stable, hashable format for query keys
+ * @internal
+ */
+export function serializeLoadSubsetOptions(
+  options: LoadSubsetOptions | undefined
+): string | undefined {
+  if (!options) {
+    return undefined
+  }
+
+  const result: Record<string, unknown> = {}
+
+  if (options.where) {
+    result.where = serializeExpression(options.where)
+  }
+
+  if (options.orderBy?.length) {
+    result.orderBy = options.orderBy.map((clause) => {
+      const baseOrderBy = {
+        expression: serializeExpression(clause.expression),
+        direction: clause.compareOptions.direction,
+        nulls: clause.compareOptions.nulls,
+        stringSort: clause.compareOptions.stringSort,
+      }
+
+      // Handle locale-specific options when stringSort is 'locale'
+      if (clause.compareOptions.stringSort === `locale`) {
+        return {
+          ...baseOrderBy,
+          locale: clause.compareOptions.locale,
+          localeOptions: clause.compareOptions.localeOptions,
+        }
+      }
+
+      return baseOrderBy
+    })
+  }
+
+  if (options.limit !== undefined) {
+    result.limit = options.limit
+  }
+
+  return Object.keys(result).length === 0 ? undefined : JSON.stringify(result)
+}
+
+/**
+ * Recursively serializes an IR expression for stable hashing
+ * @internal
+ */
+function serializeExpression(expr: IR.BasicExpression | undefined): unknown {
+  if (!expr) {
+    return null
+  }
+
+  switch (expr.type) {
+    case `val`:
+      return {
+        type: `val`,
+        value: serializeValue(expr.value),
+      }
+    case `ref`:
+      return {
+        type: `ref`,
+        path: [...expr.path],
+      }
+    case `func`:
+      return {
+        type: `func`,
+        name: expr.name,
+        args: expr.args.map((arg) => serializeExpression(arg)),
+      }
+    default:
+      return null
+  }
+}
+
+/**
+ * Serializes special JavaScript values (undefined, NaN, Infinity, Date)
+ * @internal
+ */
+function serializeValue(value: unknown): unknown {
+  if (value === undefined) {
+    return { __type: `undefined` }
+  }
+
+  if (typeof value === `number`) {
+    if (Number.isNaN(value)) {
+      return { __type: `nan` }
+    }
+    if (value === Number.POSITIVE_INFINITY) {
+      return { __type: `infinity`, sign: 1 }
+    }
+    if (value === Number.NEGATIVE_INFINITY) {
+      return { __type: `infinity`, sign: -1 }
+    }
+  }
+
+  if (
+    value === null ||
+    typeof value === `string` ||
+    typeof value === `number` ||
+    typeof value === `boolean`
+  ) {
+    return value
+  }
+
+  if (value instanceof Date) {
+    return { __type: `date`, value: value.toJSON() }
+  }
+
+  if (Array.isArray(value)) {
+    return value.map((item) => serializeValue(item))
+  }
+
+  if (typeof value === `object`) {
+    return Object.fromEntries(
+      Object.entries(value as Record<string, unknown>).map(([key, val]) => [
+        key,
+        serializeValue(val),
+      ])
+    )
+  }
+
+  return value
+}