@tanstack/query-db-collection 1.0.2 → 1.0.3

package/dist/cjs/index.d.cts

@@ -1,3 +1,3 @@
-export { queryCollectionOptions, type QueryCollectionConfig, type QueryCollectionUtils, type SyncOperation, } from './query.cjs';
+export { queryCollectionOptions, type QueryCollectionConfig, type QueryCollectionMeta, type QueryCollectionUtils, type SyncOperation, } from './query.cjs';
 export * from './errors.cjs';
 export { parseWhereExpression, parseOrderByExpression, extractSimpleComparisons, parseLoadSubsetOptions, extractFieldPath, extractValue, walkExpression, type FieldPath, type SimpleComparison, type ParseWhereOptions, type ParsedOrderBy, } from '@tanstack/db';

package/dist/cjs/manual-sync.cjs

@@ -110,7 +110,7 @@ function performWriteOperations(operations, ctx) {
     }
   }
   ctx.commit();
-  const updatedData = ctx.collection.toArray;
+  const updatedData = Array.from(ctx.collection._state.syncedData.values());
   ctx.queryClient.setQueryData(ctx.queryKey, updatedData);
 }
 function createWriteUtils(getContext) {

package/dist/cjs/manual-sync.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"manual-sync.cjs","sources":["../../src/manual-sync.ts"],"sourcesContent":["import {\n  DeleteOperationItemNotFoundError,\n  DuplicateKeyInBatchError,\n  SyncNotInitializedError,\n  UpdateOperationItemNotFoundError,\n} from \"./errors\"\nimport type { QueryClient } from \"@tanstack/query-core\"\nimport type { ChangeMessage, Collection } from \"@tanstack/db\"\n\n// Track active batch operations per context to prevent cross-collection contamination\nconst activeBatchContexts = new WeakMap<\n  SyncContext<any, any>,\n  {\n    operations: Array<SyncOperation<any, any, any>>\n    isActive: boolean\n  }\n>()\n\n// Types for sync operations\nexport type SyncOperation<\n  TRow extends object,\n  TKey extends string | number = string | number,\n  TInsertInput extends object = TRow,\n> =\n  | { type: `insert`; data: TInsertInput | Array<TInsertInput> }\n  | { type: `update`; data: Partial<TRow> | Array<Partial<TRow>> }\n  | { type: `delete`; key: TKey | Array<TKey> }\n  | { type: `upsert`; data: Partial<TRow> | Array<Partial<TRow>> }\n\nexport interface SyncContext<\n  TRow extends object,\n  TKey extends string | number = string | number,\n> {\n  collection: Collection<TRow>\n  queryClient: QueryClient\n  queryKey: Array<unknown>\n  getKey: (item: TRow) => TKey\n  begin: () => void\n  write: (message: Omit<ChangeMessage<TRow>, `key`>) => void\n  commit: () => void\n}\n\ninterface NormalizedOperation<\n  TRow extends object,\n  TKey extends string | number = string | number,\n> {\n  type: `insert` | `update` | `delete` | `upsert`\n  key: TKey\n  data?: TRow | Partial<TRow>\n}\n\n// Normalize operations into a consistent format\nfunction normalizeOperations<\n  TRow extends object,\n  TKey extends string | number = string | number,\n  TInsertInput extends object = TRow,\n>(\n  ops:\n    | SyncOperation<TRow, TKey, TInsertInput>\n    | Array<SyncOperation<TRow, TKey, TInsertInput>>,\n  ctx: SyncContext<TRow, TKey>\n): Array<NormalizedOperation<TRow, TKey>> {\n  const operations = Array.isArray(ops) ? ops : [ops]\n  const normalized: Array<NormalizedOperation<TRow, TKey>> = []\n\n  for (const op of operations) {\n    if (op.type === `delete`) {\n      const keys = Array.isArray(op.key) ? op.key : [op.key]\n      for (const key of keys) {\n        normalized.push({ type: `delete`, key })\n      }\n    } else {\n      const items = Array.isArray(op.data) ? op.data : [op.data]\n      for (const item of items) {\n        let key: TKey\n        if (op.type === `update`) {\n          // For updates, we need to get the key from the partial data\n          key = ctx.getKey(item as TRow)\n        } else {\n          // For insert/upsert, validate and resolve the full item first\n          const resolved = ctx.collection.validateData(\n            item,\n            op.type === `upsert` ? `insert` : op.type\n          )\n          key = ctx.getKey(resolved)\n        }\n        normalized.push({ type: op.type, key, data: item })\n      }\n    }\n  }\n\n  return normalized\n}\n\n// Validate operations before executing\nfunction validateOperations<\n  TRow extends object,\n  TKey extends string | number = string | number,\n>(\n  operations: Array<NormalizedOperation<TRow, TKey>>,\n  ctx: SyncContext<TRow, TKey>\n): void {\n  const seenKeys = new Set<TKey>()\n\n  for (const op of operations) {\n    // Check for duplicate keys within the batch\n    if (seenKeys.has(op.key)) {\n      throw new DuplicateKeyInBatchError(op.key)\n    }\n    seenKeys.add(op.key)\n\n    // Validate operation-specific requirements\n    // NOTE: These validations check the synced store only, not the combined view (synced + optimistic)\n    // This allows write operations to work correctly even when items are optimistically modified\n    if (op.type === `update`) {\n      if (!ctx.collection._state.syncedData.has(op.key)) {\n        throw new UpdateOperationItemNotFoundError(op.key)\n      }\n    } else if (op.type === `delete`) {\n      if (!ctx.collection._state.syncedData.has(op.key)) {\n        throw new DeleteOperationItemNotFoundError(op.key)\n      }\n    }\n  }\n}\n\n// Execute a batch of operations\nexport function performWriteOperations<\n  TRow extends object,\n  TKey extends string | number = string | number,\n  TInsertInput extends object = TRow,\n>(\n  operations:\n    | SyncOperation<TRow, TKey, TInsertInput>\n    | Array<SyncOperation<TRow, TKey, TInsertInput>>,\n  ctx: SyncContext<TRow, TKey>\n): void {\n  const normalized = normalizeOperations(operations, ctx)\n  validateOperations(normalized, ctx)\n\n  ctx.begin()\n\n  for (const op of normalized) {\n    switch (op.type) {\n      case `insert`: {\n        const resolved = ctx.collection.validateData(op.data, `insert`)\n        ctx.write({\n          type: `insert`,\n          value: resolved,\n        })\n        break\n      }\n      case `update`: {\n        // Get from synced store only, not the combined view\n        const currentItem = ctx.collection._state.syncedData.get(op.key)!\n        const updatedItem = {\n          ...currentItem,\n          ...op.data,\n        }\n        const resolved = ctx.collection.validateData(\n          updatedItem,\n          `update`,\n          op.key\n        )\n        ctx.write({\n          type: `update`,\n          value: resolved,\n        })\n        break\n      }\n      case `delete`: {\n        // Get from synced store only, not the combined view\n        const currentItem = ctx.collection._state.syncedData.get(op.key)!\n        ctx.write({\n          type: `delete`,\n          value: currentItem,\n        })\n        break\n      }\n      case `upsert`: {\n        // Check synced store only, not the combined view\n        const existsInSyncedStore = ctx.collection._state.syncedData.has(op.key)\n        const resolved = ctx.collection.validateData(\n          op.data,\n          existsInSyncedStore ? `update` : `insert`,\n          op.key\n        )\n        if (existsInSyncedStore) {\n          ctx.write({\n            type: `update`,\n            value: resolved,\n          })\n        } else {\n          ctx.write({\n            type: `insert`,\n            value: resolved,\n          })\n        }\n        break\n      }\n    }\n  }\n\n  ctx.commit()\n\n  // Update query cache after successful commit\n  const updatedData = ctx.collection.toArray\n  ctx.queryClient.setQueryData(ctx.queryKey, updatedData)\n}\n\n// Factory function to create write utils\nexport function createWriteUtils<\n  TRow extends object,\n  TKey extends string | number = string | number,\n  TInsertInput extends object = TRow,\n>(getContext: () => SyncContext<TRow, TKey> | null) {\n  function ensureContext(): SyncContext<TRow, TKey> {\n    const context = getContext()\n    if (!context) {\n      throw new SyncNotInitializedError()\n    }\n    return context\n  }\n\n  return {\n    writeInsert(data: TInsertInput | Array<TInsertInput>) {\n      const operation: SyncOperation<TRow, TKey, TInsertInput> = {\n        type: `insert`,\n        data,\n      }\n\n      const ctx = ensureContext()\n      const batchContext = activeBatchContexts.get(ctx)\n\n      // If we're in a batch, just add to the batch operations\n      if (batchContext?.isActive) {\n        batchContext.operations.push(operation)\n        return\n      }\n\n      // Otherwise, perform the operation immediately\n      performWriteOperations(operation, ctx)\n    },\n\n    writeUpdate(data: Partial<TRow> | Array<Partial<TRow>>) {\n      const operation: SyncOperation<TRow, TKey, TInsertInput> = {\n        type: `update`,\n        data,\n      }\n\n      const ctx = ensureContext()\n      const batchContext = activeBatchContexts.get(ctx)\n\n      if (batchContext?.isActive) {\n        batchContext.operations.push(operation)\n        return\n      }\n\n      performWriteOperations(operation, ctx)\n    },\n\n    writeDelete(key: TKey | Array<TKey>) {\n      const operation: SyncOperation<TRow, TKey, TInsertInput> = {\n        type: `delete`,\n        key,\n      }\n\n      const ctx = ensureContext()\n      const batchContext = activeBatchContexts.get(ctx)\n\n      if (batchContext?.isActive) {\n        batchContext.operations.push(operation)\n        return\n      }\n\n      performWriteOperations(operation, ctx)\n    },\n\n    writeUpsert(data: Partial<TRow> | Array<Partial<TRow>>) {\n      const operation: SyncOperation<TRow, TKey, TInsertInput> = {\n        type: `upsert`,\n        data,\n      }\n\n      const ctx = ensureContext()\n      const batchContext = activeBatchContexts.get(ctx)\n\n      if (batchContext?.isActive) {\n        batchContext.operations.push(operation)\n        return\n      }\n\n      performWriteOperations(operation, ctx)\n    },\n\n    writeBatch(callback: () => void) {\n      const ctx = ensureContext()\n\n      // Check if we're already in a batch (nested batch)\n      const existingBatch = activeBatchContexts.get(ctx)\n      if (existingBatch?.isActive) {\n        throw new Error(\n          `Cannot nest writeBatch calls. Complete the current batch before starting a new one.`\n        )\n      }\n\n      // Set up the batch context for this specific collection\n      const batchContext = {\n        operations: [] as Array<SyncOperation<TRow, TKey, TInsertInput>>,\n        isActive: true,\n      }\n      activeBatchContexts.set(ctx, batchContext)\n\n      try {\n        // Execute the callback - any write operations will be collected\n        const result = callback()\n\n        // Check if callback returns a promise (async function)\n        if (\n          // @ts-expect-error - Runtime check for async callback, callback is typed as () => void but user might pass async\n          // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n          result &&\n          typeof result === `object` &&\n          `then` in result &&\n          // @ts-expect-error - Runtime check for async callback, callback is typed as () => void but user might pass async\n          typeof result.then === `function`\n        ) {\n          throw new Error(\n            `writeBatch does not support async callbacks. The callback must be synchronous.`\n          )\n        }\n\n        // Perform all collected operations\n        if (batchContext.operations.length > 0) {\n          performWriteOperations(batchContext.operations, ctx)\n        }\n      } finally {\n        // Always clear the batch context\n        batchContext.isActive = false\n        activeBatchContexts.delete(ctx)\n      }\n    },\n  }\n}\n"],"names":["DuplicateKeyInBatchError","UpdateOperationItemNotFoundError","DeleteOperationItemNotFoundError","SyncNotInitializedError"],"mappings":"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"}
+{"version":3,"file":"manual-sync.cjs","sources":["../../src/manual-sync.ts"],"sourcesContent":["import {\n  DeleteOperationItemNotFoundError,\n  DuplicateKeyInBatchError,\n  SyncNotInitializedError,\n  UpdateOperationItemNotFoundError,\n} from \"./errors\"\nimport type { QueryClient } from \"@tanstack/query-core\"\nimport type { ChangeMessage, Collection } from \"@tanstack/db\"\n\n// Track active batch operations per context to prevent cross-collection contamination\nconst activeBatchContexts = new WeakMap<\n  SyncContext<any, any>,\n  {\n    operations: Array<SyncOperation<any, any, any>>\n    isActive: boolean\n  }\n>()\n\n// Types for sync operations\nexport type SyncOperation<\n  TRow extends object,\n  TKey extends string | number = string | number,\n  TInsertInput extends object = TRow,\n> =\n  | { type: `insert`; data: TInsertInput | Array<TInsertInput> }\n  | { type: `update`; data: Partial<TRow> | Array<Partial<TRow>> }\n  | { type: `delete`; key: TKey | Array<TKey> }\n  | { type: `upsert`; data: Partial<TRow> | Array<Partial<TRow>> }\n\nexport interface SyncContext<\n  TRow extends object,\n  TKey extends string | number = string | number,\n> {\n  collection: Collection<TRow>\n  queryClient: QueryClient\n  queryKey: Array<unknown>\n  getKey: (item: TRow) => TKey\n  begin: () => void\n  write: (message: Omit<ChangeMessage<TRow>, `key`>) => void\n  commit: () => void\n}\n\ninterface NormalizedOperation<\n  TRow extends object,\n  TKey extends string | number = string | number,\n> {\n  type: `insert` | `update` | `delete` | `upsert`\n  key: TKey\n  data?: TRow | Partial<TRow>\n}\n\n// Normalize operations into a consistent format\nfunction normalizeOperations<\n  TRow extends object,\n  TKey extends string | number = string | number,\n  TInsertInput extends object = TRow,\n>(\n  ops:\n    | SyncOperation<TRow, TKey, TInsertInput>\n    | Array<SyncOperation<TRow, TKey, TInsertInput>>,\n  ctx: SyncContext<TRow, TKey>\n): Array<NormalizedOperation<TRow, TKey>> {\n  const operations = Array.isArray(ops) ? ops : [ops]\n  const normalized: Array<NormalizedOperation<TRow, TKey>> = []\n\n  for (const op of operations) {\n    if (op.type === `delete`) {\n      const keys = Array.isArray(op.key) ? op.key : [op.key]\n      for (const key of keys) {\n        normalized.push({ type: `delete`, key })\n      }\n    } else {\n      const items = Array.isArray(op.data) ? op.data : [op.data]\n      for (const item of items) {\n        let key: TKey\n        if (op.type === `update`) {\n          // For updates, we need to get the key from the partial data\n          key = ctx.getKey(item as TRow)\n        } else {\n          // For insert/upsert, validate and resolve the full item first\n          const resolved = ctx.collection.validateData(\n            item,\n            op.type === `upsert` ? `insert` : op.type\n          )\n          key = ctx.getKey(resolved)\n        }\n        normalized.push({ type: op.type, key, data: item })\n      }\n    }\n  }\n\n  return normalized\n}\n\n// Validate operations before executing\nfunction validateOperations<\n  TRow extends object,\n  TKey extends string | number = string | number,\n>(\n  operations: Array<NormalizedOperation<TRow, TKey>>,\n  ctx: SyncContext<TRow, TKey>\n): void {\n  const seenKeys = new Set<TKey>()\n\n  for (const op of operations) {\n    // Check for duplicate keys within the batch\n    if (seenKeys.has(op.key)) {\n      throw new DuplicateKeyInBatchError(op.key)\n    }\n    seenKeys.add(op.key)\n\n    // Validate operation-specific requirements\n    // NOTE: These validations check the synced store only, not the combined view (synced + optimistic)\n    // This allows write operations to work correctly even when items are optimistically modified\n    if (op.type === `update`) {\n      if (!ctx.collection._state.syncedData.has(op.key)) {\n        throw new UpdateOperationItemNotFoundError(op.key)\n      }\n    } else if (op.type === `delete`) {\n      if (!ctx.collection._state.syncedData.has(op.key)) {\n        throw new DeleteOperationItemNotFoundError(op.key)\n      }\n    }\n  }\n}\n\n// Execute a batch of operations\nexport function performWriteOperations<\n  TRow extends object,\n  TKey extends string | number = string | number,\n  TInsertInput extends object = TRow,\n>(\n  operations:\n    | SyncOperation<TRow, TKey, TInsertInput>\n    | Array<SyncOperation<TRow, TKey, TInsertInput>>,\n  ctx: SyncContext<TRow, TKey>\n): void {\n  const normalized = normalizeOperations(operations, ctx)\n  validateOperations(normalized, ctx)\n\n  ctx.begin()\n\n  for (const op of normalized) {\n    switch (op.type) {\n      case `insert`: {\n        const resolved = ctx.collection.validateData(op.data, `insert`)\n        ctx.write({\n          type: `insert`,\n          value: resolved,\n        })\n        break\n      }\n      case `update`: {\n        // Get from synced store only, not the combined view\n        const currentItem = ctx.collection._state.syncedData.get(op.key)!\n        const updatedItem = {\n          ...currentItem,\n          ...op.data,\n        }\n        const resolved = ctx.collection.validateData(\n          updatedItem,\n          `update`,\n          op.key\n        )\n        ctx.write({\n          type: `update`,\n          value: resolved,\n        })\n        break\n      }\n      case `delete`: {\n        // Get from synced store only, not the combined view\n        const currentItem = ctx.collection._state.syncedData.get(op.key)!\n        ctx.write({\n          type: `delete`,\n          value: currentItem,\n        })\n        break\n      }\n      case `upsert`: {\n        // Check synced store only, not the combined view\n        const existsInSyncedStore = ctx.collection._state.syncedData.has(op.key)\n        const resolved = ctx.collection.validateData(\n          op.data,\n          existsInSyncedStore ? `update` : `insert`,\n          op.key\n        )\n        if (existsInSyncedStore) {\n          ctx.write({\n            type: `update`,\n            value: resolved,\n          })\n        } else {\n          ctx.write({\n            type: `insert`,\n            value: resolved,\n          })\n        }\n        break\n      }\n    }\n  }\n\n  ctx.commit()\n\n  // Update query cache after successful commit\n  const updatedData = Array.from(ctx.collection._state.syncedData.values())\n  ctx.queryClient.setQueryData(ctx.queryKey, updatedData)\n}\n\n// Factory function to create write utils\nexport function createWriteUtils<\n  TRow extends object,\n  TKey extends string | number = string | number,\n  TInsertInput extends object = TRow,\n>(getContext: () => SyncContext<TRow, TKey> | null) {\n  function ensureContext(): SyncContext<TRow, TKey> {\n    const context = getContext()\n    if (!context) {\n      throw new SyncNotInitializedError()\n    }\n    return context\n  }\n\n  return {\n    writeInsert(data: TInsertInput | Array<TInsertInput>) {\n      const operation: SyncOperation<TRow, TKey, TInsertInput> = {\n        type: `insert`,\n        data,\n      }\n\n      const ctx = ensureContext()\n      const batchContext = activeBatchContexts.get(ctx)\n\n      // If we're in a batch, just add to the batch operations\n      if (batchContext?.isActive) {\n        batchContext.operations.push(operation)\n        return\n      }\n\n      // Otherwise, perform the operation immediately\n      performWriteOperations(operation, ctx)\n    },\n\n    writeUpdate(data: Partial<TRow> | Array<Partial<TRow>>) {\n      const operation: SyncOperation<TRow, TKey, TInsertInput> = {\n        type: `update`,\n        data,\n      }\n\n      const ctx = ensureContext()\n      const batchContext = activeBatchContexts.get(ctx)\n\n      if (batchContext?.isActive) {\n        batchContext.operations.push(operation)\n        return\n      }\n\n      performWriteOperations(operation, ctx)\n    },\n\n    writeDelete(key: TKey | Array<TKey>) {\n      const operation: SyncOperation<TRow, TKey, TInsertInput> = {\n        type: `delete`,\n        key,\n      }\n\n      const ctx = ensureContext()\n      const batchContext = activeBatchContexts.get(ctx)\n\n      if (batchContext?.isActive) {\n        batchContext.operations.push(operation)\n        return\n      }\n\n      performWriteOperations(operation, ctx)\n    },\n\n    writeUpsert(data: Partial<TRow> | Array<Partial<TRow>>) {\n      const operation: SyncOperation<TRow, TKey, TInsertInput> = {\n        type: `upsert`,\n        data,\n      }\n\n      const ctx = ensureContext()\n      const batchContext = activeBatchContexts.get(ctx)\n\n      if (batchContext?.isActive) {\n        batchContext.operations.push(operation)\n        return\n      }\n\n      performWriteOperations(operation, ctx)\n    },\n\n    writeBatch(callback: () => void) {\n      const ctx = ensureContext()\n\n      // Check if we're already in a batch (nested batch)\n      const existingBatch = activeBatchContexts.get(ctx)\n      if (existingBatch?.isActive) {\n        throw new Error(\n          `Cannot nest writeBatch calls. Complete the current batch before starting a new one.`\n        )\n      }\n\n      // Set up the batch context for this specific collection\n      const batchContext = {\n        operations: [] as Array<SyncOperation<TRow, TKey, TInsertInput>>,\n        isActive: true,\n      }\n      activeBatchContexts.set(ctx, batchContext)\n\n      try {\n        // Execute the callback - any write operations will be collected\n        const result = callback()\n\n        // Check if callback returns a promise (async function)\n        if (\n          // @ts-expect-error - Runtime check for async callback, callback is typed as () => void but user might pass async\n          // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n          result &&\n          typeof result === `object` &&\n          `then` in result &&\n          // @ts-expect-error - Runtime check for async callback, callback is typed as () => void but user might pass async\n          typeof result.then === `function`\n        ) {\n          throw new Error(\n            `writeBatch does not support async callbacks. The callback must be synchronous.`\n          )\n        }\n\n        // Perform all collected operations\n        if (batchContext.operations.length > 0) {\n          performWriteOperations(batchContext.operations, ctx)\n        }\n      } finally {\n        // Always clear the batch context\n        batchContext.isActive = false\n        activeBatchContexts.delete(ctx)\n      }\n    },\n  }\n}\n"],"names":["DuplicateKeyInBatchError","UpdateOperationItemNotFoundError","DeleteOperationItemNotFoundError","SyncNotInitializedError"],"mappings":"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"}

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

package/dist/cjs/query.d.cts

@@ -2,6 +2,30 @@ import { BaseCollectionConfig, CollectionConfig, LoadSubsetOptions, UtilsRecord
 import { QueryClient, QueryFunctionContext, QueryKey, QueryObserverOptions, QueryObserverResult } from '@tanstack/query-core';
 import { StandardSchemaV1 } from '@standard-schema/spec';
 export type { SyncOperation } from './manual-sync.cjs';
+/**
+ * Base type for Query Collection meta properties.
+ * Users can extend this type when augmenting the @tanstack/query-core module
+ * to add their own custom properties while preserving loadSubsetOptions.
+ *
+ * @example
+ * ```typescript
+ * declare module "@tanstack/query-core" {
+ *   interface Register {
+ *     queryMeta: QueryCollectionMeta & {
+ *       myCustomProperty: string
+ *     }
+ *   }
+ * }
+ * ```
+ */
+export type QueryCollectionMeta = Record<string, unknown> & {
+    loadSubsetOptions: LoadSubsetOptions;
+};
+declare module "@tanstack/query-core" {
+    interface Register {
+        queryMeta: QueryCollectionMeta;
+    }
+}
 type InferSchemaOutput<T> = T extends StandardSchemaV1 ? StandardSchemaV1.InferOutput<T> extends object ? StandardSchemaV1.InferOutput<T> : Record<string, unknown> : Record<string, unknown>;
 type InferSchemaInput<T> = T extends StandardSchemaV1 ? StandardSchemaV1.InferInput<T> extends object ? StandardSchemaV1.InferInput<T> : Record<string, unknown> : Record<string, unknown>;
 type TQueryKeyBuilder<TQueryKey> = (opts: LoadSubsetOptions) => TQueryKey;

package/dist/esm/index.d.ts

@@ -1,3 +1,3 @@
-export { queryCollectionOptions, type QueryCollectionConfig, type QueryCollectionUtils, type SyncOperation, } from './query.js';
+export { queryCollectionOptions, type QueryCollectionConfig, type QueryCollectionMeta, type QueryCollectionUtils, type SyncOperation, } from './query.js';
 export * from './errors.js';
 export { parseWhereExpression, parseOrderByExpression, extractSimpleComparisons, parseLoadSubsetOptions, extractFieldPath, extractValue, walkExpression, type FieldPath, type SimpleComparison, type ParseWhereOptions, type ParsedOrderBy, } from '@tanstack/db';

package/dist/esm/manual-sync.js

@@ -108,7 +108,7 @@ function performWriteOperations(operations, ctx) {
     }
   }
   ctx.commit();
-  const updatedData = ctx.collection.toArray;
+  const updatedData = Array.from(ctx.collection._state.syncedData.values());
   ctx.queryClient.setQueryData(ctx.queryKey, updatedData);
 }
 function createWriteUtils(getContext) {

package/dist/esm/manual-sync.js.map

@@ -1 +1 @@
-{"version":3,"file":"manual-sync.js","sources":["../../src/manual-sync.ts"],"sourcesContent":["import {\n  DeleteOperationItemNotFoundError,\n  DuplicateKeyInBatchError,\n  SyncNotInitializedError,\n  UpdateOperationItemNotFoundError,\n} from \"./errors\"\nimport type { QueryClient } from \"@tanstack/query-core\"\nimport type { ChangeMessage, Collection } from \"@tanstack/db\"\n\n// Track active batch operations per context to prevent cross-collection contamination\nconst activeBatchContexts = new WeakMap<\n  SyncContext<any, any>,\n  {\n    operations: Array<SyncOperation<any, any, any>>\n    isActive: boolean\n  }\n>()\n\n// Types for sync operations\nexport type SyncOperation<\n  TRow extends object,\n  TKey extends string | number = string | number,\n  TInsertInput extends object = TRow,\n> =\n  | { type: `insert`; data: TInsertInput | Array<TInsertInput> }\n  | { type: `update`; data: Partial<TRow> | Array<Partial<TRow>> }\n  | { type: `delete`; key: TKey | Array<TKey> }\n  | { type: `upsert`; data: Partial<TRow> | Array<Partial<TRow>> }\n\nexport interface SyncContext<\n  TRow extends object,\n  TKey extends string | number = string | number,\n> {\n  collection: Collection<TRow>\n  queryClient: QueryClient\n  queryKey: Array<unknown>\n  getKey: (item: TRow) => TKey\n  begin: () => void\n  write: (message: Omit<ChangeMessage<TRow>, `key`>) => void\n  commit: () => void\n}\n\ninterface NormalizedOperation<\n  TRow extends object,\n  TKey extends string | number = string | number,\n> {\n  type: `insert` | `update` | `delete` | `upsert`\n  key: TKey\n  data?: TRow | Partial<TRow>\n}\n\n// Normalize operations into a consistent format\nfunction normalizeOperations<\n  TRow extends object,\n  TKey extends string | number = string | number,\n  TInsertInput extends object = TRow,\n>(\n  ops:\n    | SyncOperation<TRow, TKey, TInsertInput>\n    | Array<SyncOperation<TRow, TKey, TInsertInput>>,\n  ctx: SyncContext<TRow, TKey>\n): Array<NormalizedOperation<TRow, TKey>> {\n  const operations = Array.isArray(ops) ? ops : [ops]\n  const normalized: Array<NormalizedOperation<TRow, TKey>> = []\n\n  for (const op of operations) {\n    if (op.type === `delete`) {\n      const keys = Array.isArray(op.key) ? op.key : [op.key]\n      for (const key of keys) {\n        normalized.push({ type: `delete`, key })\n      }\n    } else {\n      const items = Array.isArray(op.data) ? op.data : [op.data]\n      for (const item of items) {\n        let key: TKey\n        if (op.type === `update`) {\n          // For updates, we need to get the key from the partial data\n          key = ctx.getKey(item as TRow)\n        } else {\n          // For insert/upsert, validate and resolve the full item first\n          const resolved = ctx.collection.validateData(\n            item,\n            op.type === `upsert` ? `insert` : op.type\n          )\n          key = ctx.getKey(resolved)\n        }\n        normalized.push({ type: op.type, key, data: item })\n      }\n    }\n  }\n\n  return normalized\n}\n\n// Validate operations before executing\nfunction validateOperations<\n  TRow extends object,\n  TKey extends string | number = string | number,\n>(\n  operations: Array<NormalizedOperation<TRow, TKey>>,\n  ctx: SyncContext<TRow, TKey>\n): void {\n  const seenKeys = new Set<TKey>()\n\n  for (const op of operations) {\n    // Check for duplicate keys within the batch\n    if (seenKeys.has(op.key)) {\n      throw new DuplicateKeyInBatchError(op.key)\n    }\n    seenKeys.add(op.key)\n\n    // Validate operation-specific requirements\n    // NOTE: These validations check the synced store only, not the combined view (synced + optimistic)\n    // This allows write operations to work correctly even when items are optimistically modified\n    if (op.type === `update`) {\n      if (!ctx.collection._state.syncedData.has(op.key)) {\n        throw new UpdateOperationItemNotFoundError(op.key)\n      }\n    } else if (op.type === `delete`) {\n      if (!ctx.collection._state.syncedData.has(op.key)) {\n        throw new DeleteOperationItemNotFoundError(op.key)\n      }\n    }\n  }\n}\n\n// Execute a batch of operations\nexport function performWriteOperations<\n  TRow extends object,\n  TKey extends string | number = string | number,\n  TInsertInput extends object = TRow,\n>(\n  operations:\n    | SyncOperation<TRow, TKey, TInsertInput>\n    | Array<SyncOperation<TRow, TKey, TInsertInput>>,\n  ctx: SyncContext<TRow, TKey>\n): void {\n  const normalized = normalizeOperations(operations, ctx)\n  validateOperations(normalized, ctx)\n\n  ctx.begin()\n\n  for (const op of normalized) {\n    switch (op.type) {\n      case `insert`: {\n        const resolved = ctx.collection.validateData(op.data, `insert`)\n        ctx.write({\n          type: `insert`,\n          value: resolved,\n        })\n        break\n      }\n      case `update`: {\n        // Get from synced store only, not the combined view\n        const currentItem = ctx.collection._state.syncedData.get(op.key)!\n        const updatedItem = {\n          ...currentItem,\n          ...op.data,\n        }\n        const resolved = ctx.collection.validateData(\n          updatedItem,\n          `update`,\n          op.key\n        )\n        ctx.write({\n          type: `update`,\n          value: resolved,\n        })\n        break\n      }\n      case `delete`: {\n        // Get from synced store only, not the combined view\n        const currentItem = ctx.collection._state.syncedData.get(op.key)!\n        ctx.write({\n          type: `delete`,\n          value: currentItem,\n        })\n        break\n      }\n      case `upsert`: {\n        // Check synced store only, not the combined view\n        const existsInSyncedStore = ctx.collection._state.syncedData.has(op.key)\n        const resolved = ctx.collection.validateData(\n          op.data,\n          existsInSyncedStore ? `update` : `insert`,\n          op.key\n        )\n        if (existsInSyncedStore) {\n          ctx.write({\n            type: `update`,\n            value: resolved,\n          })\n        } else {\n          ctx.write({\n            type: `insert`,\n            value: resolved,\n          })\n        }\n        break\n      }\n    }\n  }\n\n  ctx.commit()\n\n  // Update query cache after successful commit\n  const updatedData = ctx.collection.toArray\n  ctx.queryClient.setQueryData(ctx.queryKey, updatedData)\n}\n\n// Factory function to create write utils\nexport function createWriteUtils<\n  TRow extends object,\n  TKey extends string | number = string | number,\n  TInsertInput extends object = TRow,\n>(getContext: () => SyncContext<TRow, TKey> | null) {\n  function ensureContext(): SyncContext<TRow, TKey> {\n    const context = getContext()\n    if (!context) {\n      throw new SyncNotInitializedError()\n    }\n    return context\n  }\n\n  return {\n    writeInsert(data: TInsertInput | Array<TInsertInput>) {\n      const operation: SyncOperation<TRow, TKey, TInsertInput> = {\n        type: `insert`,\n        data,\n      }\n\n      const ctx = ensureContext()\n      const batchContext = activeBatchContexts.get(ctx)\n\n      // If we're in a batch, just add to the batch operations\n      if (batchContext?.isActive) {\n        batchContext.operations.push(operation)\n        return\n      }\n\n      // Otherwise, perform the operation immediately\n      performWriteOperations(operation, ctx)\n    },\n\n    writeUpdate(data: Partial<TRow> | Array<Partial<TRow>>) {\n      const operation: SyncOperation<TRow, TKey, TInsertInput> = {\n        type: `update`,\n        data,\n      }\n\n      const ctx = ensureContext()\n      const batchContext = activeBatchContexts.get(ctx)\n\n      if (batchContext?.isActive) {\n        batchContext.operations.push(operation)\n        return\n      }\n\n      performWriteOperations(operation, ctx)\n    },\n\n    writeDelete(key: TKey | Array<TKey>) {\n      const operation: SyncOperation<TRow, TKey, TInsertInput> = {\n        type: `delete`,\n        key,\n      }\n\n      const ctx = ensureContext()\n      const batchContext = activeBatchContexts.get(ctx)\n\n      if (batchContext?.isActive) {\n        batchContext.operations.push(operation)\n        return\n      }\n\n      performWriteOperations(operation, ctx)\n    },\n\n    writeUpsert(data: Partial<TRow> | Array<Partial<TRow>>) {\n      const operation: SyncOperation<TRow, TKey, TInsertInput> = {\n        type: `upsert`,\n        data,\n      }\n\n      const ctx = ensureContext()\n      const batchContext = activeBatchContexts.get(ctx)\n\n      if (batchContext?.isActive) {\n        batchContext.operations.push(operation)\n        return\n      }\n\n      performWriteOperations(operation, ctx)\n    },\n\n    writeBatch(callback: () => void) {\n      const ctx = ensureContext()\n\n      // Check if we're already in a batch (nested batch)\n      const existingBatch = activeBatchContexts.get(ctx)\n      if (existingBatch?.isActive) {\n        throw new Error(\n          `Cannot nest writeBatch calls. Complete the current batch before starting a new one.`\n        )\n      }\n\n      // Set up the batch context for this specific collection\n      const batchContext = {\n        operations: [] as Array<SyncOperation<TRow, TKey, TInsertInput>>,\n        isActive: true,\n      }\n      activeBatchContexts.set(ctx, batchContext)\n\n      try {\n        // Execute the callback - any write operations will be collected\n        const result = callback()\n\n        // Check if callback returns a promise (async function)\n        if (\n          // @ts-expect-error - Runtime check for async callback, callback is typed as () => void but user might pass async\n          // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n          result &&\n          typeof result === `object` &&\n          `then` in result &&\n          // @ts-expect-error - Runtime check for async callback, callback is typed as () => void but user might pass async\n          typeof result.then === `function`\n        ) {\n          throw new Error(\n            `writeBatch does not support async callbacks. The callback must be synchronous.`\n          )\n        }\n\n        // Perform all collected operations\n        if (batchContext.operations.length > 0) {\n          performWriteOperations(batchContext.operations, ctx)\n        }\n      } finally {\n        // Always clear the batch context\n        batchContext.isActive = false\n        activeBatchContexts.delete(ctx)\n      }\n    },\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"manual-sync.js","sources":["../../src/manual-sync.ts"],"sourcesContent":["import {\n  DeleteOperationItemNotFoundError,\n  DuplicateKeyInBatchError,\n  SyncNotInitializedError,\n  UpdateOperationItemNotFoundError,\n} from \"./errors\"\nimport type { QueryClient } from \"@tanstack/query-core\"\nimport type { ChangeMessage, Collection } from \"@tanstack/db\"\n\n// Track active batch operations per context to prevent cross-collection contamination\nconst activeBatchContexts = new WeakMap<\n  SyncContext<any, any>,\n  {\n    operations: Array<SyncOperation<any, any, any>>\n    isActive: boolean\n  }\n>()\n\n// Types for sync operations\nexport type SyncOperation<\n  TRow extends object,\n  TKey extends string | number = string | number,\n  TInsertInput extends object = TRow,\n> =\n  | { type: `insert`; data: TInsertInput | Array<TInsertInput> }\n  | { type: `update`; data: Partial<TRow> | Array<Partial<TRow>> }\n  | { type: `delete`; key: TKey | Array<TKey> }\n  | { type: `upsert`; data: Partial<TRow> | Array<Partial<TRow>> }\n\nexport interface SyncContext<\n  TRow extends object,\n  TKey extends string | number = string | number,\n> {\n  collection: Collection<TRow>\n  queryClient: QueryClient\n  queryKey: Array<unknown>\n  getKey: (item: TRow) => TKey\n  begin: () => void\n  write: (message: Omit<ChangeMessage<TRow>, `key`>) => void\n  commit: () => void\n}\n\ninterface NormalizedOperation<\n  TRow extends object,\n  TKey extends string | number = string | number,\n> {\n  type: `insert` | `update` | `delete` | `upsert`\n  key: TKey\n  data?: TRow | Partial<TRow>\n}\n\n// Normalize operations into a consistent format\nfunction normalizeOperations<\n  TRow extends object,\n  TKey extends string | number = string | number,\n  TInsertInput extends object = TRow,\n>(\n  ops:\n    | SyncOperation<TRow, TKey, TInsertInput>\n    | Array<SyncOperation<TRow, TKey, TInsertInput>>,\n  ctx: SyncContext<TRow, TKey>\n): Array<NormalizedOperation<TRow, TKey>> {\n  const operations = Array.isArray(ops) ? ops : [ops]\n  const normalized: Array<NormalizedOperation<TRow, TKey>> = []\n\n  for (const op of operations) {\n    if (op.type === `delete`) {\n      const keys = Array.isArray(op.key) ? op.key : [op.key]\n      for (const key of keys) {\n        normalized.push({ type: `delete`, key })\n      }\n    } else {\n      const items = Array.isArray(op.data) ? op.data : [op.data]\n      for (const item of items) {\n        let key: TKey\n        if (op.type === `update`) {\n          // For updates, we need to get the key from the partial data\n          key = ctx.getKey(item as TRow)\n        } else {\n          // For insert/upsert, validate and resolve the full item first\n          const resolved = ctx.collection.validateData(\n            item,\n            op.type === `upsert` ? `insert` : op.type\n          )\n          key = ctx.getKey(resolved)\n        }\n        normalized.push({ type: op.type, key, data: item })\n      }\n    }\n  }\n\n  return normalized\n}\n\n// Validate operations before executing\nfunction validateOperations<\n  TRow extends object,\n  TKey extends string | number = string | number,\n>(\n  operations: Array<NormalizedOperation<TRow, TKey>>,\n  ctx: SyncContext<TRow, TKey>\n): void {\n  const seenKeys = new Set<TKey>()\n\n  for (const op of operations) {\n    // Check for duplicate keys within the batch\n    if (seenKeys.has(op.key)) {\n      throw new DuplicateKeyInBatchError(op.key)\n    }\n    seenKeys.add(op.key)\n\n    // Validate operation-specific requirements\n    // NOTE: These validations check the synced store only, not the combined view (synced + optimistic)\n    // This allows write operations to work correctly even when items are optimistically modified\n    if (op.type === `update`) {\n      if (!ctx.collection._state.syncedData.has(op.key)) {\n        throw new UpdateOperationItemNotFoundError(op.key)\n      }\n    } else if (op.type === `delete`) {\n      if (!ctx.collection._state.syncedData.has(op.key)) {\n        throw new DeleteOperationItemNotFoundError(op.key)\n      }\n    }\n  }\n}\n\n// Execute a batch of operations\nexport function performWriteOperations<\n  TRow extends object,\n  TKey extends string | number = string | number,\n  TInsertInput extends object = TRow,\n>(\n  operations:\n    | SyncOperation<TRow, TKey, TInsertInput>\n    | Array<SyncOperation<TRow, TKey, TInsertInput>>,\n  ctx: SyncContext<TRow, TKey>\n): void {\n  const normalized = normalizeOperations(operations, ctx)\n  validateOperations(normalized, ctx)\n\n  ctx.begin()\n\n  for (const op of normalized) {\n    switch (op.type) {\n      case `insert`: {\n        const resolved = ctx.collection.validateData(op.data, `insert`)\n        ctx.write({\n          type: `insert`,\n          value: resolved,\n        })\n        break\n      }\n      case `update`: {\n        // Get from synced store only, not the combined view\n        const currentItem = ctx.collection._state.syncedData.get(op.key)!\n        const updatedItem = {\n          ...currentItem,\n          ...op.data,\n        }\n        const resolved = ctx.collection.validateData(\n          updatedItem,\n          `update`,\n          op.key\n        )\n        ctx.write({\n          type: `update`,\n          value: resolved,\n        })\n        break\n      }\n      case `delete`: {\n        // Get from synced store only, not the combined view\n        const currentItem = ctx.collection._state.syncedData.get(op.key)!\n        ctx.write({\n          type: `delete`,\n          value: currentItem,\n        })\n        break\n      }\n      case `upsert`: {\n        // Check synced store only, not the combined view\n        const existsInSyncedStore = ctx.collection._state.syncedData.has(op.key)\n        const resolved = ctx.collection.validateData(\n          op.data,\n          existsInSyncedStore ? `update` : `insert`,\n          op.key\n        )\n        if (existsInSyncedStore) {\n          ctx.write({\n            type: `update`,\n            value: resolved,\n          })\n        } else {\n          ctx.write({\n            type: `insert`,\n            value: resolved,\n          })\n        }\n        break\n      }\n    }\n  }\n\n  ctx.commit()\n\n  // Update query cache after successful commit\n  const updatedData = Array.from(ctx.collection._state.syncedData.values())\n  ctx.queryClient.setQueryData(ctx.queryKey, updatedData)\n}\n\n// Factory function to create write utils\nexport function createWriteUtils<\n  TRow extends object,\n  TKey extends string | number = string | number,\n  TInsertInput extends object = TRow,\n>(getContext: () => SyncContext<TRow, TKey> | null) {\n  function ensureContext(): SyncContext<TRow, TKey> {\n    const context = getContext()\n    if (!context) {\n      throw new SyncNotInitializedError()\n    }\n    return context\n  }\n\n  return {\n    writeInsert(data: TInsertInput | Array<TInsertInput>) {\n      const operation: SyncOperation<TRow, TKey, TInsertInput> = {\n        type: `insert`,\n        data,\n      }\n\n      const ctx = ensureContext()\n      const batchContext = activeBatchContexts.get(ctx)\n\n      // If we're in a batch, just add to the batch operations\n      if (batchContext?.isActive) {\n        batchContext.operations.push(operation)\n        return\n      }\n\n      // Otherwise, perform the operation immediately\n      performWriteOperations(operation, ctx)\n    },\n\n    writeUpdate(data: Partial<TRow> | Array<Partial<TRow>>) {\n      const operation: SyncOperation<TRow, TKey, TInsertInput> = {\n        type: `update`,\n        data,\n      }\n\n      const ctx = ensureContext()\n      const batchContext = activeBatchContexts.get(ctx)\n\n      if (batchContext?.isActive) {\n        batchContext.operations.push(operation)\n        return\n      }\n\n      performWriteOperations(operation, ctx)\n    },\n\n    writeDelete(key: TKey | Array<TKey>) {\n      const operation: SyncOperation<TRow, TKey, TInsertInput> = {\n        type: `delete`,\n        key,\n      }\n\n      const ctx = ensureContext()\n      const batchContext = activeBatchContexts.get(ctx)\n\n      if (batchContext?.isActive) {\n        batchContext.operations.push(operation)\n        return\n      }\n\n      performWriteOperations(operation, ctx)\n    },\n\n    writeUpsert(data: Partial<TRow> | Array<Partial<TRow>>) {\n      const operation: SyncOperation<TRow, TKey, TInsertInput> = {\n        type: `upsert`,\n        data,\n      }\n\n      const ctx = ensureContext()\n      const batchContext = activeBatchContexts.get(ctx)\n\n      if (batchContext?.isActive) {\n        batchContext.operations.push(operation)\n        return\n      }\n\n      performWriteOperations(operation, ctx)\n    },\n\n    writeBatch(callback: () => void) {\n      const ctx = ensureContext()\n\n      // Check if we're already in a batch (nested batch)\n      const existingBatch = activeBatchContexts.get(ctx)\n      if (existingBatch?.isActive) {\n        throw new Error(\n          `Cannot nest writeBatch calls. Complete the current batch before starting a new one.`\n        )\n      }\n\n      // Set up the batch context for this specific collection\n      const batchContext = {\n        operations: [] as Array<SyncOperation<TRow, TKey, TInsertInput>>,\n        isActive: true,\n      }\n      activeBatchContexts.set(ctx, batchContext)\n\n      try {\n        // Execute the callback - any write operations will be collected\n        const result = callback()\n\n        // Check if callback returns a promise (async function)\n        if (\n          // @ts-expect-error - Runtime check for async callback, callback is typed as () => void but user might pass async\n          // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n          result &&\n          typeof result === `object` &&\n          `then` in result &&\n          // @ts-expect-error - Runtime check for async callback, callback is typed as () => void but user might pass async\n          typeof result.then === `function`\n        ) {\n          throw new Error(\n            `writeBatch does not support async callbacks. The callback must be synchronous.`\n          )\n        }\n\n        // Perform all collected operations\n        if (batchContext.operations.length > 0) {\n          performWriteOperations(batchContext.operations, ctx)\n        }\n      } finally {\n        // Always clear the batch context\n        batchContext.isActive = false\n        activeBatchContexts.delete(ctx)\n      }\n    },\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/esm/query.d.ts

@@ -2,6 +2,30 @@ import { BaseCollectionConfig, CollectionConfig, LoadSubsetOptions, UtilsRecord
 import { QueryClient, QueryFunctionContext, QueryKey, QueryObserverOptions, QueryObserverResult } from '@tanstack/query-core';
 import { StandardSchemaV1 } from '@standard-schema/spec';
 export type { SyncOperation } from './manual-sync.js';
+/**
+ * Base type for Query Collection meta properties.
+ * Users can extend this type when augmenting the @tanstack/query-core module
+ * to add their own custom properties while preserving loadSubsetOptions.
+ *
+ * @example
+ * ```typescript
+ * declare module "@tanstack/query-core" {
+ *   interface Register {
+ *     queryMeta: QueryCollectionMeta & {
+ *       myCustomProperty: string
+ *     }
+ *   }
+ * }
+ * ```
+ */
+export type QueryCollectionMeta = Record<string, unknown> & {
+    loadSubsetOptions: LoadSubsetOptions;
+};
+declare module "@tanstack/query-core" {
+    interface Register {
+        queryMeta: QueryCollectionMeta;
+    }
+}
 type InferSchemaOutput<T> = T extends StandardSchemaV1 ? StandardSchemaV1.InferOutput<T> extends object ? StandardSchemaV1.InferOutput<T> : Record<string, unknown> : Record<string, unknown>;
 type InferSchemaInput<T> = T extends StandardSchemaV1 ? StandardSchemaV1.InferInput<T> extends object ? StandardSchemaV1.InferInput<T> : Record<string, unknown> : Record<string, unknown>;
 type TQueryKeyBuilder<TQueryKey> = (opts: LoadSubsetOptions) => TQueryKey;

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

package/package.json

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

package/src/index.ts

@@ -1,6 +1,7 @@
 export {
   queryCollectionOptions,
   type QueryCollectionConfig,
+  type QueryCollectionMeta,
   type QueryCollectionUtils,
   type SyncOperation,
 } from "./query"

package/src/manual-sync.ts

@@ -204,7 +204,7 @@ export function performWriteOperations<
   ctx.commit()
 
   // Update query cache after successful commit
-  const updatedData = ctx.collection.toArray
+  const updatedData = Array.from(ctx.collection._state.syncedData.values())
   ctx.queryClient.setQueryData(ctx.queryKey, updatedData)
 }
 

package/src/query.ts

@@ -31,6 +31,35 @@ import type { StandardSchemaV1 } from "@standard-schema/spec"
 // Re-export for external use
 export type { SyncOperation } from "./manual-sync"
 
+/**
+ * Base type for Query Collection meta properties.
+ * Users can extend this type when augmenting the @tanstack/query-core module
+ * to add their own custom properties while preserving loadSubsetOptions.
+ *
+ * @example
+ * ```typescript
+ * declare module "@tanstack/query-core" {
+ *   interface Register {
+ *     queryMeta: QueryCollectionMeta & {
+ *       myCustomProperty: string
+ *     }
+ *   }
+ * }
+ * ```
+ */
+export type QueryCollectionMeta = Record<string, unknown> & {
+  loadSubsetOptions: LoadSubsetOptions
+}
+
+// Module augmentation to extend TanStack Query's Register interface
+// This ensures that ctx.meta always includes loadSubsetOptions
+// We extend Record<string, unknown> to preserve the ability to add other meta properties
+declare module "@tanstack/query-core" {
+  interface Register {
+    queryMeta: QueryCollectionMeta
+  }
+}
+
 // Schema output type inference helper (matches electric.ts pattern)
 type InferSchemaOutput<T> = T extends StandardSchemaV1
   ? StandardSchemaV1.InferOutput<T> extends object