@noy-db/hub 0.2.0-pre.8 → 0.3.0-pre.1

package/dist/strategy-BSxFXGzb.d.ts

@@ -1,110 +0,0 @@
-/**
- * CRDT state types, merge logic, and build helpers.
- * per-collection CRDT mode: 'lww-map' | 'rga' | 'yjs'
- *
- * The encrypted envelope wraps the CRDT state (not the resolved snapshot).
- * Adapters only ever see ciphertext. `collection.get(id)` returns the
- * resolved snapshot; `collection.getRaw(id)` returns the full CRDT state.
- */
-/** Per-collection CRDT mode. */
-type CrdtMode = 'lww-map' | 'rga' | 'yjs';
-/**
- * Per-field last-write-wins registers.
- * Each field carries its latest value and the ISO timestamp of the last write.
- * Merge: for each field, keep the entry with the lexicographically higher `ts`.
- */
-interface LwwMapState {
-    readonly _crdt: 'lww-map';
-    readonly fields: Record<string, {
-        readonly v: unknown;
-        readonly ts: string;
-    }>;
-}
-/**
- * Simplified Replicated Growable Array.
- * Items are assigned stable NID (noy-db id) strings on first insertion.
- * Deleted items are tracked as tombstones so concurrent removals commute.
- *
- * The resolved snapshot is the ordered list of non-tombstoned `v` values.
- */
-interface RgaState {
-    readonly _crdt: 'rga';
-    readonly items: ReadonlyArray<{
-        readonly nid: string;
-        readonly v: unknown;
-    }>;
-    readonly tombstones: readonly string[];
-}
-/**
- * Yjs binary state marker. `update` is base64(Y.encodeStateAsUpdate()).
- * Core stores and retrieves the blob opaquely. `@noy-db/yjs` is responsible
- * for encoding, decoding, and merging via `Y.mergeUpdates`.
- * Core falls back to last-write-wins (higher `_v`) for conflict resolution.
- */
-interface YjsState {
-    readonly _crdt: 'yjs';
-    /** base64-encoded Y.encodeStateAsUpdate() bytes. */
-    readonly update: string;
-}
-type CrdtState = LwwMapState | RgaState | YjsState;
-/**
- * Resolve a CRDT state into the end-user record snapshot.
- *
- * - `lww-map` → `Record<string, unknown>` (field values extracted from registers)
- * - `rga`     → `unknown[]` (non-tombstoned items in insertion order)
- * - `yjs`     → `string` (base64 update blob; use @noy-db/yjs for a Y.Doc)
- */
-declare function resolveCrdtSnapshot(state: CrdtState): unknown;
-/**
- * Merge two CRDT states produced by concurrent writes.
- * Called by the collection-level conflict resolver registered with SyncEngine.
- *
- * For `yjs`: core cannot merge Yjs without importing the `yjs` package.
- * The caller must handle that case by falling back to the higher-`_v` envelope.
- */
-declare function mergeCrdtStates(a: CrdtState, b: CrdtState): CrdtState;
-/**
- * Build (or update) an lww-map state from a new record.
- *
- * All fields in the new record win at timestamp `now`.
- * Fields present in the existing state but absent from the new record
- * are preserved (they were written by another device).
- */
-declare function buildLwwMapState(record: Record<string, unknown>, existing: LwwMapState | undefined, now: string): LwwMapState;
-/**
- * Build (or update) an RGA state from a new array.
- *
- * Existing items are matched to new elements by deep-equality of their `v`.
- * Unmatched existing items are tombstoned. New elements that have no existing
- * match get a fresh NID via `generateNid()`.
- */
-declare function buildRgaState(arr: unknown[], existing: RgaState | undefined, generateNid: () => string): RgaState;
-
-/**
- * Strategy seam between core Collection and the optional CRDT
- * subsystem. Core imports `CrdtStrategy` as a TYPE-ONLY symbol and
- * `NO_CRDT` as a minimal runtime stub.
- *
- * The state-construction / merge / snapshot-resolution helpers —
- * `buildLwwMapState`, `buildRgaState`, `mergeCrdtStates`,
- * `resolveCrdtSnapshot` — are only reachable from `withCrdt()` in
- * `./active.ts`, which is only exported through the `@noy-db/hub/crdt`
- * subpath. Consumers without CRDT mode configured never pull the
- * ~221 LOC into their bundle.
- *
- * @internal
- */
-
-/**
- * Seam interface. `@internal`.
- *
- * @internal
- */
-interface CrdtStrategy {
-    buildLwwMapState(record: Record<string, unknown>, previous: LwwMapState | undefined, now: string): LwwMapState;
-    buildRgaState(items: readonly unknown[], previous: RgaState | undefined, idGen: () => string): RgaState;
-    mergeCrdtStates(local: CrdtState, remote: CrdtState): CrdtState;
-    resolveCrdtSnapshot(state: CrdtState): unknown;
-}
-
-export { type CrdtStrategy as C, type LwwMapState as L, type RgaState as R, type YjsState as Y, type CrdtMode as a, type CrdtState as b, buildLwwMapState as c, buildRgaState as d, mergeCrdtStates as m, resolveCrdtSnapshot as r };