Skip to main content

Interface: BaseStateSyncEventData

Defined in: shared/types/events.ts:196

Payload for state synchronization events.

Remarks​

Used to notify frontend about state changes that occurred in the backend. Supports various sync actions including bulk updates, deletions, and individual updates.

Examples​

const event: StateSyncEventData = {
    action: "bulk-sync",
    sites: updatedSites,
    source: "database",
    timestamp: Date.now(),
};
const event: StateSyncEventData = {
    action: "delete",
    siteIdentifier: "site_123",
    sites: [],
    source: "database",
    timestamp: Date.now(),
};

Hierarchy​

View Summary

Extends​

Extended by​

Indexable​

[key: string]: unknown

[key: number]: unknown

[key: symbol]: unknown

Properties​

timestamp​

readonly timestamp: number

Defined in: shared/types/events.ts:110

The time (in milliseconds since epoch) when the event occurred.

Inherited from​

BaseEventData.timestamp

_meta?​

readonly optional _meta?: EventMetadata

Defined in: shared/types/events.ts:112

Runtime metadata describing the emission context.

Inherited from​

BaseStateSyncEventData._meta

_originalMeta?​

readonly optional _originalMeta?: EventMetadata

Defined in: shared/types/events.ts:114

Preserves previously attached metadata when re-emitting events.

Inherited from​

BaseStateSyncEventData._originalMeta

action​

readonly action: "bulk-sync" | "delete" | "update"

Defined in: shared/types/events.ts:198

The synchronization action being performed

revision​

readonly revision: number

Defined in: shared/types/events.ts:203

Monotonic revision counter incremented by the backend for each emitted state sync event.

siteIdentifier?​

readonly optional siteIdentifier?: string

Defined in: shared/types/events.ts:205

Site identifier for targeted operations (delete, update)

source​

readonly source: "cache" | "database" | "frontend" | "import" | "monitor-update"

Defined in: shared/types/events.ts:207

Source system that triggered the sync

truncated?​

readonly optional truncated?: boolean

Defined in: shared/types/events.ts:209

Indicates the backend omitted the payload due to a size budget.