Make loadSubsetOptions optional in QueryCollectionMeta (#1238)

* Make loadSubsetOptions optional in QueryCollectionMeta

Fixes #1061 - the required loadSubsetOptions property in QueryCollectionMeta
was polluting all TanStack Query meta usages via the Register module
augmentation, causing type errors for non-db-collection query meta.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* Add changeset for optional loadSubsetOptions

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>

Author: kevin-dp

.changeset/optional-loadsubset-meta.md

@@ -0,0 +1,5 @@
+---
+'@tanstack/query-db-collection': patch
+---
+
+Make loadSubsetOptions optional in QueryCollectionMeta to fix query-core interface pollution (#1061)

packages/query-db-collection/src/global.ts

@@ -28,7 +28,7 @@ import type { LoadSubsetOptions } from '@tanstack/db'
  * ```
  */
 export interface QueryCollectionMeta extends Record<string, unknown> {
-  loadSubsetOptions: LoadSubsetOptions
+  loadSubsetOptions?: LoadSubsetOptions
 }
 
 // Module augmentation to extend TanStack Query's Register interface

packages/query-db-collection/tests/query.test-d.ts

@@ -440,7 +440,7 @@ describe(`Query collection type resolution tests`, () => {
           // Verify that loadSubsetOptions is assignable to LoadSubsetOptions
           // This ensures it can be used where LoadSubsetOptions is expected
           expectTypeOf(
-            ctx.meta!.loadSubsetOptions,
+            ctx.meta!.loadSubsetOptions!,
           ).toExtend<LoadSubsetOptions>()
           // so that parseLoadSubsetOptions can be called without type errors
           parseLoadSubsetOptions(ctx.meta?.loadSubsetOptions)
@@ -465,7 +465,7 @@ describe(`Query collection type resolution tests`, () => {
           // Verify that an object with loadSubsetOptions plus other properties
           // can be assigned to ctx.meta's type. This ensures the type is not too restrictive.
           const metaWithExtra = {
-            loadSubsetOptions: ctx.meta!.loadSubsetOptions,
+            loadSubsetOptions: ctx.meta!.loadSubsetOptions!,
             customProperty: `test`,
             anotherProperty: 123,
           }
@@ -476,7 +476,7 @@ describe(`Query collection type resolution tests`, () => {
 
           // Verify the assignment worked (this will fail at compile time if types don't match)
           expectTypeOf(
-            typedMeta.loadSubsetOptions,
+            typedMeta.loadSubsetOptions!,
           ).toExtend<LoadSubsetOptions>()
 
           return Promise.resolve([])