@quereus/sync 0.3.4

package/dist/src/sync/sync-manager-impl.d.ts

@@ -0,0 +1,106 @@
+/**
+ * SyncManager implementation.
+ *
+ * Coordinates CRDT metadata tracking and sync operations.
+ */
+import type { KVStore, StoreEventEmitter } from '@quereus/store';
+import type { TableSchema } from '@quereus/quereus';
+/**
+ * Callback to get table schema by name.
+ * Used to map column indices to actual column names.
+ */
+export type GetTableSchemaCallback = (schemaName: string, tableName: string) => TableSchema | undefined;
+import { type HLC } from '../clock/hlc.js';
+import { type SiteId } from '../clock/site.js';
+import type { SyncManager, SnapshotCheckpoint } from './manager.js';
+import type { SyncConfig, ChangeSet, ApplyResult, Snapshot, SnapshotChunk, SnapshotProgress, ApplyToStoreCallback } from './protocol.js';
+import { SyncEventEmitterImpl } from './events.js';
+/**
+ * Implementation of SyncManager.
+ */
+export declare class SyncManagerImpl implements SyncManager {
+    private readonly kv;
+    private readonly config;
+    private readonly hlcManager;
+    private readonly columnVersions;
+    private readonly tombstones;
+    private readonly peerStates;
+    private readonly changeLog;
+    private readonly schemaMigrations;
+    private readonly syncEvents;
+    private readonly applyToStore?;
+    private readonly getTableSchema?;
+    private pendingChanges;
+    private currentTransactionId;
+    private constructor();
+    /**
+     * Create a new SyncManager, initializing or loading site identity.
+     *
+     * @param kv - KV store for sync metadata
+     * @param storeEvents - Store event emitter to subscribe to local changes
+     * @param config - Sync configuration
+     * @param syncEvents - Sync event emitter for UI integration
+     * @param applyToStore - Optional callback for applying remote changes to the store
+     * @param getTableSchema - Optional callback for getting table schema by name
+     */
+    static create(kv: KVStore, storeEvents: StoreEventEmitter, config: SyncConfig, syncEvents: SyncEventEmitterImpl, applyToStore?: ApplyToStoreCallback, getTableSchema?: GetTableSchemaCallback): Promise<SyncManagerImpl>;
+    getSiteId(): SiteId;
+    getCurrentHLC(): HLC;
+    /**
+     * Handle a data change event from the store.
+     * Records CRDT metadata for the change.
+     * Skips remote events to prevent duplicate recording.
+     */
+    private handleDataChange;
+    /**
+     * Handle a schema change event from the store.
+     * Records schema migrations for sync.
+     * Skips remote events to prevent duplicate recording.
+     */
+    private handleSchemaChange;
+    private recordColumnVersions;
+    private persistHLCState;
+    getChangesSince(peerSiteId: SiteId, sinceHLC?: HLC): Promise<ChangeSet[]>;
+    /**
+     * Fallback: collect all changes when no sinceHLC is provided.
+     */
+    private collectAllChanges;
+    applyChanges(changes: ChangeSet[]): Promise<ApplyResult>;
+    /**
+     * Resolve CRDT conflicts for a change WITHOUT writing metadata.
+     * This is phase 1 of the two-phase apply: resolve first, then after
+     * data is written to store, call commitChangeMetadata to persist CRDT state.
+     *
+     * Write order (for crash safety):
+     * 1. Resolve all changes (this method) - no writes
+     * 2. Apply data to store (applyToStore callback)
+     * 3. Commit CRDT metadata (commitChangeMetadata)
+     *
+     * If crash occurs after data but before metadata, re-sync will re-apply
+     * the same changes. Since CRDT operations are idempotent (same HLC → same
+     * LWW outcome), this is safe.
+     */
+    private resolveChange;
+    /**
+     * Commit CRDT metadata for resolved changes.
+     * This is phase 2 of the two-phase apply: called AFTER data is written to store.
+     */
+    private commitChangeMetadata;
+    canDeltaSync(peerSiteId: SiteId, sinceHLC: HLC): Promise<boolean>;
+    getSnapshot(): Promise<Snapshot>;
+    applySnapshot(snapshot: Snapshot): Promise<void>;
+    updatePeerSyncState(peerSiteId: SiteId, hlc: HLC): Promise<void>;
+    getPeerSyncState(peerSiteId: SiteId): Promise<HLC | undefined>;
+    pruneTombstones(): Promise<number>;
+    /**
+     * Get the sync event emitter for UI integration.
+     */
+    getEventEmitter(): SyncEventEmitterImpl;
+    getSnapshotStream(chunkSize?: number): AsyncIterable<SnapshotChunk>;
+    applySnapshotStream(chunks: AsyncIterable<SnapshotChunk>, onProgress?: (progress: SnapshotProgress) => void): Promise<void>;
+    getSnapshotCheckpoint(snapshotId: string): Promise<SnapshotCheckpoint | undefined>;
+    private saveSnapshotCheckpoint;
+    private clearSnapshotCheckpoint;
+    resumeSnapshotStream(checkpoint: SnapshotCheckpoint): AsyncIterable<SnapshotChunk>;
+}
+//# sourceMappingURL=sync-manager-impl.d.ts.map

package/dist/src/sync/sync-manager-impl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-manager-impl.d.ts","sourceRoot":"","sources":["../../../src/sync/sync-manager-impl.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAsC,MAAM,gBAAgB,CAAC;AACrG,OAAO,KAAK,EAAiB,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEnE;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,WAAW,GAAG,SAAS,CAAC;AACxG,OAAO,EAAc,KAAK,GAAG,EAAc,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAEL,KAAK,MAAM,EAKZ,MAAM,kBAAkB,CAAC;AAiB1B,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,KAAK,EACV,UAAU,EACV,SAAS,EAIT,WAAW,EACX,QAAQ,EAIR,aAAa,EACb,gBAAgB,EAOhB,oBAAoB,EAGrB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,oBAAoB,EAAsB,MAAM,aAAa,CAAC;AAoBvE;;GAEG;AACH,qBAAa,eAAgB,YAAW,WAAW;IACjD,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAU;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IACpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAqB;IACpD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAiB;IAC5C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAiB;IAC5C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiB;IAC3C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAuB;IACxD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAuB;IAClD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAuB;IACrD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAyB;IAGzD,OAAO,CAAC,cAAc,CAAgB;IACtC,OAAO,CAAC,oBAAoB,CAAuB;IAEnD,OAAO;IAqBP;;;;;;;;;OASG;WACU,MAAM,CACjB,EAAE,EAAE,OAAO,EACX,WAAW,EAAE,iBAAiB,EAC9B,MAAM,EAAE,UAAU,EAClB,UAAU,EAAE,oBAAoB,EAChC,YAAY,CAAC,EAAE,oBAAoB,EACnC,cAAc,CAAC,EAAE,sBAAsB,GACtC,OAAO,CAAC,eAAe,CAAC;IAuC3B,SAAS,IAAI,MAAM;IAInB,aAAa,IAAI,GAAG;IAIpB;;;;OAIG;YACW,gBAAgB;IA4D9B;;;;OAIG;YACW,kBAAkB;YAsDlB,oBAAoB;YAmEpB,eAAe;IASvB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAwH/E;;OAEG;YACW,iBAAiB;IAiDzB,YAAY,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC;IAmI9D;;;;;;;;;;;;;OAaG;YACW,aAAa;IA0G3B;;;OAGG;YACW,oBAAoB;IAqE5B,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC;IAkBjE,WAAW,IAAI,OAAO,CAAC,QAAQ,CAAC;IAiFhC,aAAa,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAiIhD,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhE,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,GAAG,SAAS,CAAC;IAK9D,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC;IAmBxC;;OAEG;IACH,eAAe,IAAI,oBAAoB;IAQhC,iBAAiB,CAAC,SAAS,GAAE,MAAoC,GAAG,aAAa,CAAC,aAAa,CAAC;IAqIjG,mBAAmB,CACvB,MAAM,EAAE,aAAa,CAAC,aAAa,CAAC,EACpC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI,GAChD,OAAO,CAAC,IAAI,CAAC;IAiNV,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC;YAoB1E,sBAAsB;YActB,uBAAuB;IAK9B,oBAAoB,CAAC,UAAU,EAAE,kBAAkB,GAAG,aAAa,CAAC,aAAa,CAAC;CA2I1F"}