37 lines
1.4 KiB
TypeScript
37 lines
1.4 KiB
TypeScript
|
/**
|
||
|
|
* Change-event vocabulary of the domain data form. Every durable write emits
|
||
|
|
* one event after the backend resolves durability, carrying the new snapshot
|
||
|
|
* and an operation discriminant — never the old value (a diffing consumer
|
||
|
|
* keeps its own previous snapshot). This is the event source for cross-process
|
||
|
|
* change push (RPC frames) in a later phase.
|
||
|
|
* @module @deepseek-ai/dsh-domain/src/events
|
||
|
|
*/
|
||
|
|
|
||
|
|
/** One durable domain change: a record upsert/delete or a global write. */
|
||
|
|
export interface DomainChanged {
|
||
|
|
/** Owning domain name. */
|
||
|
|
readonly domain: string
|
||
|
|
/** Table name; `''` for a global-singleton write. */
|
||
|
|
readonly table: string
|
||
|
|
/** Record key; `''` for a global-singleton write. */
|
||
|
|
readonly key: string
|
||
|
|
/** What happened: `put` covers insert and overwrite; `deleted` is a tombstone. */
|
||
|
|
readonly operation: 'put' | 'deleted'
|
||
|
|
/** The new snapshot; absent for `deleted`. */
|
||
|
|
readonly value?: unknown
|
||
|
|
}
|
||
|
|
|
||
|
|
declare module 'cordis' {
|
||
|
|
interface Events {
|
||
|
|
/**
|
||
|
|
* A domain record or the global singleton changed, emitted once per write
|
||
|
|
* strictly after the backend acknowledged durability. Events of one
|
||
|
|
* domain arrive in its write-chain order.
|
||
|
|
* @param change - domain, table (`''` for global), key (`''` for global),
|
||
|
|
* operation discriminant, and the new snapshot (absent for deletions).
|
||
|
|
* @mode emit
|
||
|
|
*/
|
||
|
|
'domain/changed'(change: DomainChanged): void
|
||
|
|
}
|
||
|
|
}
|