SyncConfig

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

Type Parameters

T

T extends object = Record<string, unknown>

TKey

TKey extends string | number = string | number

Properties

exportSyncMeta()?

optional exportSyncMeta: () => unknown;

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

Export adapter-specific metadata that lets hydration/persistence resume sync. The payload shape is owned by the adapter.

Returns

unknown

getSyncMetadata()?

optional getSyncMetadata: () => Record<string, unknown>;

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

Get the sync metadata for insert operations

Returns

Record<string, unknown>

Record containing relation information

importSyncMeta()?

optional importSyncMeta: (meta) => void;

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

Import adapter-specific metadata produced by exportSyncMeta.

Parameters

Returns

void

mergeSyncMeta()?

optional mergeSyncMeta: (current, incoming) => unknown;

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

Merge two adapter-specific metadata payloads during hydration.

Parameters

current

unknown

incoming

unknown

Returns

unknown

rowUpdateMode?

optional rowUpdateMode: "full" | "partial";

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

The row update mode used to sync to the collection.

Default

partial

Description

partial: Updates contain only the changes to the row.
full: Updates contain the entire row.

sync()

sync: (params) => 
  | void
  | CleanupFn
  | SyncConfigRes;

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

Parameters

params

begin

(options?) => void

Begin a new sync transaction.

collection

Collection<T, TKey, any, any, any>

commit

(signal?) => SyncAppliedReceipt

Commit the active sync transaction in FIFO order. Returns true when the writes and events are already visible. Otherwise returns a receipt that resolves after they become visible. If collection cleanup or an optional request abort abandons the transaction first, the receipt rejects with an error named AbortError. If cancellation of an earlier transaction invalidates this transaction's insert admission, the receipt rejects with DuplicateKeySyncError. If cancellation removes a row required by this transaction's partial update, its receipt rejects with an error named AbortError. Pass a signal only for request-scoped work that must not publish after cancellation. Aborting after application has no effect.