Interface: SubscribeChangesSnapshotOptions\#

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

Extends#

• Omit\<[`SubscribeChangesOptions`](SubscribeChangesOptions.md)\<`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:874

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:866

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:850

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:873

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:842

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`](../type-aliases/WithVirtualProps.md)\<`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:844

Pre-compiled expression for filtering changes

Inherited from#

SubscribeChangesOptions.whereExpression