Interface: SubscribeChangesSnapshotOptions<T, TKey>#

Defined in: packages/db/src/types.ts:891

Extends#

• Omit<SubscribeChangesOptions<T, TKey>, "includeInitialState">

Type Parameters#

T#

T extends object = Record<string, unknown>

TKey#

TKey extends string | number = string | number

Properties#

limit?#

optional limit: number;

Defined in: packages/db/src/types.ts:896

Internal

Optional limit to include in loadSubset for query-specific cache keys.

Overrides#

SubscribeChangesOptions.limit

onLoadSubsetResult()?#

optional onLoadSubsetResult: (result) => void;

Defined in: packages/db/src/types.ts:888

Internal

Callback that receives the loadSubset result (Promise or true) from requestSnapshot. Allows the caller to directly track the loading promise for isReady status.

Parameters#

result#

true | Promise<void>

Returns#

void

Inherited from#

Omit.onLoadSubsetResult

onStatusChange()?#

optional onStatusChange: (event) => void;

Defined in: packages/db/src/types.ts:872

Internal

Listener for subscription status changes. Registered BEFORE any snapshot is requested, ensuring no status transitions are missed.

Parameters#

event#

SubscriptionStatusChangeEvent

Returns#

void

Inherited from#

Omit.onStatusChange

orderBy?#

optional orderBy: OrderBy;

Defined in: packages/db/src/types.ts:895

Internal

Optional orderBy to include in loadSubset for query-specific cache keys.

Overrides#

SubscribeChangesOptions.orderBy

where()?#

optional where: (row) => any;

Defined in: packages/db/src/types.ts:864

Callback function for filtering changes using a row proxy. The callback receives a proxy object that records property access, allowing you to use query builder functions like eq, gt, etc.

Parameters#

row#

SingleRowRefProxy<WithVirtualProps<T, TKey>>

Returns#

any

Example#

import { eq } from "@tanstack/db"

collection.subscribeChanges(callback, {
  where: (row) => eq(row.status, "active")
})

Inherited from#

Omit.where

whereExpression?#

optional whereExpression: BasicExpression<boolean>;

Defined in: packages/db/src/types.ts:866

Pre-compiled expression for filtering changes

Inherited from#

SubscribeChangesOptions.whereExpression