@quereus/plugin-sync 0.3.1

package/dist/src/clock/site.js

@@ -0,0 +1,137 @@
+/**
+ * Site ID management - unique identifier for each replica.
+ *
+ * Site IDs are 16-byte UUIDs that uniquely identify a replica in the
+ * distributed system. They are used for:
+ * - Breaking ties in HLC comparison
+ * - Tracking which changes came from which replica
+ * - Peer-to-peer sync state tracking
+ */
+/**
+ * Generate a new random site ID (UUID v4).
+ */
+export function generateSiteId() {
+    const id = new Uint8Array(16);
+    // Use crypto.getRandomValues if available (browser and Node 19+)
+    if (typeof crypto !== 'undefined' && crypto.getRandomValues) {
+        crypto.getRandomValues(id);
+    }
+    else {
+        // Fallback for older Node.js
+        for (let i = 0; i < 16; i++) {
+            id[i] = Math.floor(Math.random() * 256);
+        }
+    }
+    // Set version to 4 (random UUID)
+    id[6] = (id[6] & 0x0f) | 0x40;
+    // Set variant to RFC 4122
+    id[8] = (id[8] & 0x3f) | 0x80;
+    return id;
+}
+// Base64url alphabet (RFC 4648 Section 5)
+const BASE64URL_CHARS = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_';
+/**
+ * Convert a Uint8Array to base64url encoding (no padding).
+ */
+export function toBase64Url(bytes) {
+    let result = '';
+    for (let i = 0; i < bytes.length; i += 3) {
+        const byte1 = bytes[i];
+        const byte2 = i + 1 < bytes.length ? bytes[i + 1] : 0;
+        const byte3 = i + 2 < bytes.length ? bytes[i + 2] : 0;
+        const triplet = (byte1 << 16) | (byte2 << 8) | byte3;
+        result += BASE64URL_CHARS[(triplet >>> 18) & 0x3f];
+        result += BASE64URL_CHARS[(triplet >>> 12) & 0x3f];
+        if (i + 1 < bytes.length) {
+            result += BASE64URL_CHARS[(triplet >>> 6) & 0x3f];
+        }
+        if (i + 2 < bytes.length) {
+            result += BASE64URL_CHARS[triplet & 0x3f];
+        }
+    }
+    return result;
+}
+/**
+ * Convert a base64url string to Uint8Array.
+ */
+export function fromBase64Url(str) {
+    // Build reverse lookup table
+    const lookup = {};
+    for (let i = 0; i < BASE64URL_CHARS.length; i++) {
+        lookup[BASE64URL_CHARS[i]] = i;
+    }
+    // Calculate output length (no padding in base64url)
+    const len = str.length;
+    const outputLen = Math.floor((len * 3) / 4);
+    const result = new Uint8Array(outputLen);
+    let writePos = 0;
+    for (let i = 0; i < len; i += 4) {
+        const c1 = lookup[str[i]] ?? 0;
+        const c2 = lookup[str[i + 1]] ?? 0;
+        const c3 = i + 2 < len ? lookup[str[i + 2]] ?? 0 : 0;
+        const c4 = i + 3 < len ? lookup[str[i + 3]] ?? 0 : 0;
+        const triplet = (c1 << 18) | (c2 << 12) | (c3 << 6) | c4;
+        if (writePos < outputLen)
+            result[writePos++] = (triplet >>> 16) & 0xff;
+        if (writePos < outputLen)
+            result[writePos++] = (triplet >>> 8) & 0xff;
+        if (writePos < outputLen)
+            result[writePos++] = triplet & 0xff;
+    }
+    return result;
+}
+/**
+ * Convert site ID to base64url string for serialization.
+ * 16 bytes → 22 characters (no padding).
+ */
+export function siteIdToBase64(siteId) {
+    return toBase64Url(siteId);
+}
+/**
+ * Parse site ID from base64url string.
+ */
+export function siteIdFromBase64(base64) {
+    if (base64.length !== 22) {
+        throw new Error(`Invalid site ID base64 length: ${base64.length}, expected 22`);
+    }
+    return fromBase64Url(base64);
+}
+/**
+ * Compare two site IDs for equality.
+ */
+export function siteIdEquals(a, b) {
+    if (a.length !== b.length)
+        return false;
+    for (let i = 0; i < a.length; i++) {
+        if (a[i] !== b[i])
+            return false;
+    }
+    return true;
+}
+/**
+ * Storage key for site identity.
+ */
+export const SITE_ID_KEY = 'si:';
+/**
+ * Serialize site identity for storage.
+ */
+export function serializeSiteIdentity(identity) {
+    const buffer = new Uint8Array(24); // 16 bytes siteId + 8 bytes timestamp
+    buffer.set(identity.siteId, 0);
+    const view = new DataView(buffer.buffer);
+    view.setBigUint64(16, BigInt(identity.createdAt), false);
+    return buffer;
+}
+/**
+ * Deserialize site identity from storage.
+ */
+export function deserializeSiteIdentity(buffer) {
+    if (buffer.length !== 24) {
+        throw new Error(`Invalid site identity buffer length: ${buffer.length}, expected 24`);
+    }
+    const siteId = new Uint8Array(buffer.slice(0, 16));
+    const view = new DataView(buffer.buffer, buffer.byteOffset, buffer.byteLength);
+    const createdAt = Number(view.getBigUint64(16, false));
+    return { siteId, createdAt };
+}
+//# sourceMappingURL=site.js.map

package/dist/src/clock/site.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"site.js","sourceRoot":"","sources":["../../../src/clock/site.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH;;GAEG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,EAAE,GAAG,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC;IAE9B,iEAAiE;IACjE,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC,eAAe,EAAE,CAAC;QAC5D,MAAM,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;IAC7B,CAAC;SAAM,CAAC;QACN,6BAA6B;QAC7B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;YAC5B,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IAED,iCAAiC;IACjC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAC9B,0BAA0B;IAC1B,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAE9B,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,0CAA0C;AAC1C,MAAM,eAAe,GAAG,kEAAkE,CAAC;AAE3F;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,KAAiB;IAC3C,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACzC,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACvB,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACtD,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAEtD,MAAM,OAAO,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC;QAErD,MAAM,IAAI,eAAe,CAAC,CAAC,OAAO,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;QACnD,MAAM,IAAI,eAAe,CAAC,CAAC,OAAO,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;QACnD,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;YACzB,MAAM,IAAI,eAAe,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;QACpD,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;YACzB,MAAM,IAAI,eAAe,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,6BAA6B;IAC7B,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,eAAe,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAChD,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACjC,CAAC;IAED,oDAAoD;IACpD,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC;IACvB,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,SAAS,CAAC,CAAC;IAEzC,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAChC,MAAM,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC/B,MAAM,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACnC,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACrD,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAErD,MAAM,OAAO,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC;QAEzD,IAAI,QAAQ,GAAG,SAAS;YAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,OAAO,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;QACvE,IAAI,QAAQ,GAAG,SAAS;YAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,OAAO,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC;QACtE,IAAI,QAAQ,GAAG,SAAS;YAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,GAAG,OAAO,GAAG,IAAI,CAAC;IAChE,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC;AAC7B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAc;IAC7C,IAAI,MAAM,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,kCAAkC,MAAM,CAAC,MAAM,eAAe,CAAC,CAAC;IAClF,CAAC;IACD,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,CAAS,EAAE,CAAS;IAC/C,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IACxC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;IAClC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,CAAC;AAUjC;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAAsB;IAC1D,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC,CAAE,sCAAsC;IAC1E,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAE/B,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACzC,IAAI,CAAC,YAAY,CAAC,EAAE,EAAE,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,KAAK,CAAC,CAAC;IAEzD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAAkB;IACxD,IAAI,MAAM,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,wCAAwC,MAAM,CAAC,MAAM,eAAe,CAAC,CAAC;IACxF,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IACnD,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;IAC/E,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC;IAEvD,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;AAC/B,CAAC"}

package/dist/src/create-sync-module.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Factory function to create a sync-enabled store module.
+ *
+ * This wraps an existing store module (LevelDB or IndexedDB) with
+ * CRDT sync capabilities.
+ */
+import type { KVStore, StoreEventEmitter } from '@quereus/plugin-store';
+import type { TableSchema } from '@quereus/quereus';
+import { SyncEventEmitterImpl } from './sync/events.js';
+import { type SyncConfig, type ApplyToStoreCallback } from './sync/protocol.js';
+import type { SyncManager } from './sync/manager.js';
+/**
+ * Function to get table schema by name.
+ * Used to map column indices to column names for sync.
+ */
+export type GetTableSchemaCallback = (schemaName: string, tableName: string) => TableSchema | undefined;
+/**
+ * Result of creating a sync module.
+ */
+export interface CreateSyncModuleResult {
+    /** The sync manager for sync operations */
+    syncManager: SyncManager;
+    /** Event emitter for reactive UI integration */
+    syncEvents: SyncEventEmitterImpl;
+}
+/**
+ * Options for creating a sync module.
+ */
+export interface CreateSyncModuleOptions extends Partial<SyncConfig> {
+    /**
+     * Callback for applying remote changes to the store.
+     *
+     * When provided, the SyncManager will call this to apply data and schema
+     * changes from remote replicas. The store should emit events with
+     * `remote: true` when this is called.
+     *
+     * If not provided, the SyncManager will only update CRDT metadata
+     * and emit sync events, but will not modify actual data. The application
+     * is responsible for applying changes separately.
+     */
+    applyToStore?: ApplyToStoreCallback;
+    /**
+     * Callback for getting table schema by name.
+     *
+     * When provided, the SyncManager uses this to get actual column names
+     * for sync. This is required for proper column-level CRDT tracking.
+     *
+     * If not provided, column names will be derived from row indices (col_0,
+     * col_1, etc.), which may not match across replicas if table schemas differ.
+     */
+    getTableSchema?: GetTableSchemaCallback;
+}
+/**
+ * Create a sync-enabled module.
+ *
+ * This function:
+ * 1. Creates a SyncManager that tracks CRDT metadata
+ * 2. Subscribes to store events to record changes
+ * 3. Returns the sync manager and event emitter for UI integration
+ *
+ * @param kv - The KV store to use for metadata storage
+ * @param storeEvents - The store's event emitter
+ * @param config - Optional sync configuration
+ *
+ * @example
+ * ```typescript
+ * import { LevelDBStore, StoreEventEmitter } from '@quereus/plugin-store';
+ * import { createSyncModule } from '@quereus/plugin-sync';
+ *
+ * const storeEvents = new StoreEventEmitter();
+ * const kv = await LevelDBStore.open({ path: './data' });
+ *
+ * const { syncManager, syncEvents } = await createSyncModule(kv, storeEvents);
+ *
+ * // Subscribe to sync events for UI
+ * syncEvents.onRemoteChange((event) => {
+ *   console.log('Remote changes:', event.changes.length);
+ * });
+ *
+ * // Use syncManager for sync operations
+ * const changes = await syncManager.getChangesSince(peerSiteId, lastHLC);
+ * ```
+ */
+export declare function createSyncModule(kv: KVStore, storeEvents: StoreEventEmitter, options?: CreateSyncModuleOptions): Promise<CreateSyncModuleResult>;
+//# sourceMappingURL=create-sync-module.d.ts.map

package/dist/src/create-sync-module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-sync-module.d.ts","sourceRoot":"","sources":["../../src/create-sync-module.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AACxE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAuB,KAAK,UAAU,EAAE,KAAK,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AACrG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,WAAW,GAAG,SAAS,CAAC;AAExG;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,2CAA2C;IAC3C,WAAW,EAAE,WAAW,CAAC;IACzB,gDAAgD;IAChD,UAAU,EAAE,oBAAoB,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,uBAAwB,SAAQ,OAAO,CAAC,UAAU,CAAC;IAClE;;;;;;;;;;OAUG;IACH,YAAY,CAAC,EAAE,oBAAoB,CAAC;IAEpC;;;;;;;;OAQG;IACH,cAAc,CAAC,EAAE,sBAAsB,CAAC;CACzC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAsB,gBAAgB,CACpC,EAAE,EAAE,OAAO,EACX,WAAW,EAAE,iBAAiB,EAC9B,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,sBAAsB,CAAC,CAuBjC"}

package/dist/src/create-sync-module.js

@@ -0,0 +1,54 @@
+/**
+ * Factory function to create a sync-enabled store module.
+ *
+ * This wraps an existing store module (LevelDB or IndexedDB) with
+ * CRDT sync capabilities.
+ */
+import { SyncManagerImpl } from './sync/sync-manager-impl.js';
+import { SyncEventEmitterImpl } from './sync/events.js';
+import { DEFAULT_SYNC_CONFIG } from './sync/protocol.js';
+/**
+ * Create a sync-enabled module.
+ *
+ * This function:
+ * 1. Creates a SyncManager that tracks CRDT metadata
+ * 2. Subscribes to store events to record changes
+ * 3. Returns the sync manager and event emitter for UI integration
+ *
+ * @param kv - The KV store to use for metadata storage
+ * @param storeEvents - The store's event emitter
+ * @param config - Optional sync configuration
+ *
+ * @example
+ * ```typescript
+ * import { LevelDBStore, StoreEventEmitter } from '@quereus/plugin-store';
+ * import { createSyncModule } from '@quereus/plugin-sync';
+ *
+ * const storeEvents = new StoreEventEmitter();
+ * const kv = await LevelDBStore.open({ path: './data' });
+ *
+ * const { syncManager, syncEvents } = await createSyncModule(kv, storeEvents);
+ *
+ * // Subscribe to sync events for UI
+ * syncEvents.onRemoteChange((event) => {
+ *   console.log('Remote changes:', event.changes.length);
+ * });
+ *
+ * // Use syncManager for sync operations
+ * const changes = await syncManager.getChangesSince(peerSiteId, lastHLC);
+ * ```
+ */
+export async function createSyncModule(kv, storeEvents, options = {}) {
+    const { applyToStore, getTableSchema, ...configOverrides } = options;
+    const fullConfig = {
+        ...DEFAULT_SYNC_CONFIG,
+        ...configOverrides,
+    };
+    const syncEvents = new SyncEventEmitterImpl();
+    const syncManager = await SyncManagerImpl.create(kv, storeEvents, fullConfig, syncEvents, applyToStore, getTableSchema);
+    return {
+        syncManager,
+        syncEvents,
+    };
+}
+//# sourceMappingURL=create-sync-module.js.map

package/dist/src/create-sync-module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-sync-module.js","sourceRoot":"","sources":["../../src/create-sync-module.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAA8C,MAAM,oBAAoB,CAAC;AAgDrG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,EAAW,EACX,WAA8B,EAC9B,UAAmC,EAAE;IAErC,MAAM,EAAE,YAAY,EAAE,cAAc,EAAE,GAAG,eAAe,EAAE,GAAG,OAAO,CAAC;IAErE,MAAM,UAAU,GAAe;QAC7B,GAAG,mBAAmB;QACtB,GAAG,eAAe;KACnB,CAAC;IAEF,MAAM,UAAU,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAE9C,MAAM,WAAW,GAAG,MAAM,eAAe,CAAC,MAAM,CAC9C,EAAE,EACF,WAAW,EACX,UAAU,EACV,UAAU,EACV,YAAY,EACZ,cAAc,CACf,CAAC;IAEF,OAAO;QACL,WAAW;QACX,UAAU;KACX,CAAC;AACJ,CAAC"}

package/dist/src/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Sync Plugin for Quereus
+ *
+ * Provides multi-master CRDT replication with automatic conflict resolution.
+ *
+ * Features:
+ * - Fully automatic: All tables are CRDT-enabled without opt-in
+ * - Column-level LWW: Fine-grained conflict resolution
+ * - Transport agnostic: Bring your own WebSocket/HTTP/WebRTC
+ * - Reactive hooks: UI integration for real-time updates
+ * - Offline-first: Works with local changes that sync later
+ *
+ * Usage:
+ *   import { createSyncModule } from '@quereus/plugin-sync';
+ *   import { LevelDBModule, StoreEventEmitter } from '@quereus/plugin-store';
+ *
+ *   const storeEvents = new StoreEventEmitter();
+ *   const store = new LevelDBModule(storeEvents);
+ *   const { syncModule, syncManager, syncEvents } = createSyncModule(store, storeEvents);
+ *
+ *   db.registerVtabModule('store', syncModule);
+ */
+export { type HLC, HLCManager, compareHLC, hlcEquals, createHLC, serializeHLC, deserializeHLC, type SerializedHLC, hlcToJson, hlcFromJson, type SiteId, generateSiteId, siteIdToBase64, siteIdFromBase64, toBase64Url, fromBase64Url, siteIdEquals, type SiteIdentity, serializeSiteIdentity, deserializeSiteIdentity, SITE_ID_KEY, } from './clock/index.js';
+export { type ColumnChange, type RowDeletion, type Change, type SchemaMigrationType, type SchemaMigration, type ChangeSet, type ApplyResult, type ColumnVersionEntry, type TableSnapshot, type Snapshot, type PeerSyncState, type SnapshotChunkType, type SnapshotHeaderChunk, type SnapshotTableStartChunk, type SnapshotColumnVersionsChunk, type SnapshotTableEndChunk, type SnapshotSchemaMigrationChunk, type SnapshotFooterChunk, type SnapshotChunk, type SnapshotProgress, type ApplyToStoreOptions, type DataChangeToApply, type SchemaChangeToApply, type ApplyToStoreResult, type ApplyToStoreCallback, type SyncConfig, DEFAULT_SYNC_CONFIG, } from './sync/protocol.js';
+export { type SyncManager, type SnapshotCheckpoint } from './sync/manager.js';
+export { SyncManagerImpl } from './sync/sync-manager-impl.js';
+export { createStoreAdapter, type SyncStoreAdapterOptions } from './sync/store-adapter.js';
+export { createSyncModule, type CreateSyncModuleResult, type CreateSyncModuleOptions, type GetTableSchemaCallback, } from './create-sync-module.js';
+export { type RemoteChangeEvent, type LocalChangeEvent, type ConflictEvent, type SyncState, type Unsubscribe, type SyncEventEmitter, SyncEventEmitterImpl, } from './sync/events.js';
+export { SYNC_KEY_PREFIX, buildColumnVersionKey, buildTombstoneKey, buildTransactionKey, buildPeerStateKey, buildSchemaMigrationKey, buildColumnVersionScanBounds, buildTombstoneScanBounds, buildSchemaMigrationScanBounds, encodePK, decodePK, type ColumnVersion, ColumnVersionStore, serializeColumnVersion, deserializeColumnVersion, type Tombstone, TombstoneStore, serializeTombstone, deserializeTombstone, type PeerState, PeerStateStore, serializePeerState, deserializePeerState, type SchemaVersion, type SchemaVersionType, type SchemaChangeOperation, SchemaVersionStore, buildSchemaVersionKey, buildSchemaVersionScanBounds, buildAllSchemaVersionsScanBounds, serializeSchemaVersion, deserializeSchemaVersion, parseSchemaVersionKey, getDestructiveness, getOperationDestructiveness, shouldApplySchemaChangeByOperation, } from './metadata/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,EAEL,KAAK,GAAG,EACR,UAAU,EACV,UAAU,EACV,SAAS,EACT,SAAS,EACT,YAAY,EACZ,cAAc,EAEd,KAAK,aAAa,EAClB,SAAS,EACT,WAAW,EAEX,KAAK,MAAM,EACX,cAAc,EAEd,cAAc,EACd,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,YAAY,EACZ,KAAK,YAAY,EACjB,qBAAqB,EACrB,uBAAuB,EACvB,WAAW,GACZ,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,MAAM,EAEX,KAAK,mBAAmB,EACxB,KAAK,eAAe,EAEpB,KAAK,SAAS,EAEd,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,QAAQ,EACb,KAAK,aAAa,EAElB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,EAC5B,KAAK,2BAA2B,EAChC,KAAK,qBAAqB,EAC1B,KAAK,4BAA4B,EACjC,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAClB,KAAK,gBAAgB,EAErB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EAEzB,KAAK,UAAU,EACf,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAG9D,OAAO,EAAE,kBAAkB,EAAE,KAAK,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAG3F,OAAO,EACL,gBAAgB,EAChB,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,GAC5B,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAEL,eAAe,EACf,qBAAqB,EACrB,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EACjB,uBAAuB,EACvB,4BAA4B,EAC5B,wBAAwB,EACxB,8BAA8B,EAC9B,QAAQ,EACR,QAAQ,EAER,KAAK,aAAa,EAClB,kBAAkB,EAClB,sBAAsB,EACtB,wBAAwB,EAExB,KAAK,SAAS,EACd,cAAc,EACd,kBAAkB,EAClB,oBAAoB,EAEpB,KAAK,SAAS,EACd,cAAc,EACd,kBAAkB,EAClB,oBAAoB,EAEpB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,kBAAkB,EAClB,qBAAqB,EACrB,4BAA4B,EAC5B,gCAAgC,EAChC,sBAAsB,EACtB,wBAAwB,EACxB,qBAAqB,EAErB,kBAAkB,EAClB,2BAA2B,EAC3B,kCAAkC,GACnC,MAAM,qBAAqB,CAAC"}

package/dist/src/index.js

@@ -0,0 +1,42 @@
+/**
+ * Sync Plugin for Quereus
+ *
+ * Provides multi-master CRDT replication with automatic conflict resolution.
+ *
+ * Features:
+ * - Fully automatic: All tables are CRDT-enabled without opt-in
+ * - Column-level LWW: Fine-grained conflict resolution
+ * - Transport agnostic: Bring your own WebSocket/HTTP/WebRTC
+ * - Reactive hooks: UI integration for real-time updates
+ * - Offline-first: Works with local changes that sync later
+ *
+ * Usage:
+ *   import { createSyncModule } from '@quereus/plugin-sync';
+ *   import { LevelDBModule, StoreEventEmitter } from '@quereus/plugin-store';
+ *
+ *   const storeEvents = new StoreEventEmitter();
+ *   const store = new LevelDBModule(storeEvents);
+ *   const { syncModule, syncManager, syncEvents } = createSyncModule(store, storeEvents);
+ *
+ *   db.registerVtabModule('store', syncModule);
+ */
+// Clock module
+export { HLCManager, compareHLC, hlcEquals, createHLC, serializeHLC, deserializeHLC, hlcToJson, hlcFromJson, generateSiteId, 
+// Base64url encoding
+siteIdToBase64, siteIdFromBase64, toBase64Url, fromBase64Url, siteIdEquals, serializeSiteIdentity, deserializeSiteIdentity, SITE_ID_KEY, } from './clock/index.js';
+// Sync protocol types
+export { DEFAULT_SYNC_CONFIG, } from './sync/protocol.js';
+export { SyncManagerImpl } from './sync/sync-manager-impl.js';
+// Store adapter for applying remote changes
+export { createStoreAdapter } from './sync/store-adapter.js';
+// Factory function
+export { createSyncModule, } from './create-sync-module.js';
+// Reactive events
+export { SyncEventEmitterImpl, } from './sync/events.js';
+// Metadata storage
+export { 
+// Key builders
+SYNC_KEY_PREFIX, buildColumnVersionKey, buildTombstoneKey, buildTransactionKey, buildPeerStateKey, buildSchemaMigrationKey, buildColumnVersionScanBounds, buildTombstoneScanBounds, buildSchemaMigrationScanBounds, encodePK, decodePK, ColumnVersionStore, serializeColumnVersion, deserializeColumnVersion, TombstoneStore, serializeTombstone, deserializeTombstone, PeerStateStore, serializePeerState, deserializePeerState, SchemaVersionStore, buildSchemaVersionKey, buildSchemaVersionScanBounds, buildAllSchemaVersionsScanBounds, serializeSchemaVersion, deserializeSchemaVersion, parseSchemaVersionKey, 
+// Most destructive wins
+getDestructiveness, getOperationDestructiveness, shouldApplySchemaChangeByOperation, } from './metadata/index.js';
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,eAAe;AACf,OAAO,EAGL,UAAU,EACV,UAAU,EACV,SAAS,EACT,SAAS,EACT,YAAY,EACZ,cAAc,EAGd,SAAS,EACT,WAAW,EAGX,cAAc;AACd,qBAAqB;AACrB,cAAc,EACd,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,YAAY,EAEZ,qBAAqB,EACrB,uBAAuB,EACvB,WAAW,GACZ,MAAM,kBAAkB,CAAC;AAE1B,sBAAsB;AACtB,OAAO,EAkCL,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAI5B,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAE9D,4CAA4C;AAC5C,OAAO,EAAE,kBAAkB,EAAgC,MAAM,yBAAyB,CAAC;AAE3F,mBAAmB;AACnB,OAAO,EACL,gBAAgB,GAIjB,MAAM,yBAAyB,CAAC;AAEjC,kBAAkB;AAClB,OAAO,EAOL,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAE1B,mBAAmB;AACnB,OAAO;AACL,eAAe;AACf,eAAe,EACf,qBAAqB,EACrB,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EACjB,uBAAuB,EACvB,4BAA4B,EAC5B,wBAAwB,EACxB,8BAA8B,EAC9B,QAAQ,EACR,QAAQ,EAGR,kBAAkB,EAClB,sBAAsB,EACtB,wBAAwB,EAGxB,cAAc,EACd,kBAAkB,EAClB,oBAAoB,EAGpB,cAAc,EACd,kBAAkB,EAClB,oBAAoB,EAKpB,kBAAkB,EAClB,qBAAqB,EACrB,4BAA4B,EAC5B,gCAAgC,EAChC,sBAAsB,EACtB,wBAAwB,EACxB,qBAAqB;AACrB,wBAAwB;AACxB,kBAAkB,EAClB,2BAA2B,EAC3B,kCAAkC,GACnC,MAAM,qBAAqB,CAAC"}

package/dist/src/metadata/change-log.d.ts

@@ -0,0 +1,67 @@
+/**
+ * HLC-indexed change log for efficient delta sync.
+ *
+ * The change log stores references to changes indexed by HLC timestamp,
+ * enabling efficient getChangesSince() queries without scanning all data.
+ */
+import type { KVStore, WriteBatch } from '@quereus/plugin-store';
+import type { SqlValue } from '@quereus/quereus';
+import type { HLC } from '../clock/hlc.js';
+import { type ChangeLogEntryType } from './keys.js';
+/**
+ * Change log entry stored in KV.
+ */
+export interface ChangeLogEntry {
+    readonly hlc: HLC;
+    readonly entryType: ChangeLogEntryType;
+    readonly schema: string;
+    readonly table: string;
+    readonly pk: SqlValue[];
+    readonly column?: string;
+}
+/**
+ * Change log store for HLC-indexed change tracking.
+ *
+ * Each mutation (column update or row deletion) creates an entry in the
+ * change log, keyed by HLC. This allows efficient range scans to find
+ * all changes since a given timestamp.
+ */
+export declare class ChangeLogStore {
+    private readonly kv;
+    constructor(kv: KVStore);
+    /**
+     * Record a column change in the change log.
+     */
+    recordColumnChange(hlc: HLC, schema: string, table: string, pk: SqlValue[], column: string): Promise<void>;
+    /**
+     * Record a column change in a batch.
+     */
+    recordColumnChangeBatch(batch: WriteBatch, hlc: HLC, schema: string, table: string, pk: SqlValue[], column: string): void;
+    /**
+     * Record a row deletion in the change log.
+     */
+    recordDeletion(hlc: HLC, schema: string, table: string, pk: SqlValue[]): Promise<void>;
+    /**
+     * Record a row deletion in a batch.
+     */
+    recordDeletionBatch(batch: WriteBatch, hlc: HLC, schema: string, table: string, pk: SqlValue[]): void;
+    /**
+     * Get all change log entries after a given HLC.
+     * Returns entries in HLC order (oldest first).
+     */
+    getChangesSince(sinceHLC: HLC): AsyncIterable<ChangeLogEntry>;
+    /**
+     * Get all change log entries.
+     */
+    getAllChanges(): AsyncIterable<ChangeLogEntry>;
+    /**
+     * Delete change log entries up to a given HLC.
+     * Used for pruning old entries after they've been synced to all peers.
+     */
+    pruneEntriesBefore(beforeHLC: HLC): Promise<number>;
+    /**
+     * Delete a specific change log entry (used during snapshot application).
+     */
+    deleteEntryBatch(batch: WriteBatch, hlc: HLC, entryType: ChangeLogEntryType, schema: string, table: string, pk: SqlValue[], column?: string): void;
+}
+//# sourceMappingURL=change-log.d.ts.map

package/dist/src/metadata/change-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"change-log.d.ts","sourceRoot":"","sources":["../../../src/metadata/change-log.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAKL,KAAK,kBAAkB,EACxB,MAAM,WAAW,CAAC;AAEnB;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC;IAClB,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,EAAE,QAAQ,EAAE,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,OAAO;IAExC;;OAEG;IACG,kBAAkB,CACtB,GAAG,EAAE,GAAG,EACR,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,EAAE,EAAE,QAAQ,EAAE,EACd,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC;IAMhB;;OAEG;IACH,uBAAuB,CACrB,KAAK,EAAE,UAAU,EACjB,GAAG,EAAE,GAAG,EACR,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,EAAE,EAAE,QAAQ,EAAE,EACd,MAAM,EAAE,MAAM,GACb,IAAI;IAKP;;OAEG;IACG,cAAc,CAClB,GAAG,EAAE,GAAG,EACR,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,EAAE,EAAE,QAAQ,EAAE,GACb,OAAO,CAAC,IAAI,CAAC;IAKhB;;OAEG;IACH,mBAAmB,CACjB,KAAK,EAAE,UAAU,EACjB,GAAG,EAAE,GAAG,EACR,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,EAAE,EAAE,QAAQ,EAAE,GACb,IAAI;IAKP;;;OAGG;IACI,eAAe,CAAC,QAAQ,EAAE,GAAG,GAAG,aAAa,CAAC,cAAc,CAAC;IAUpE;;OAEG;IACI,aAAa,IAAI,aAAa,CAAC,cAAc,CAAC;IAUrD;;;OAGG;IACG,kBAAkB,CAAC,SAAS,EAAE,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC;IAuBzD;;OAEG;IACH,gBAAgB,CACd,KAAK,EAAE,UAAU,EACjB,GAAG,EAAE,GAAG,EACR,SAAS,EAAE,kBAAkB,EAC7B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,EAAE,EAAE,QAAQ,EAAE,EACd,MAAM,CAAC,EAAE,MAAM,GACd,IAAI;CAIR"}

package/dist/src/metadata/change-log.js

@@ -0,0 +1,107 @@
+/**
+ * HLC-indexed change log for efficient delta sync.
+ *
+ * The change log stores references to changes indexed by HLC timestamp,
+ * enabling efficient getChangesSince() queries without scanning all data.
+ */
+import { buildChangeLogKey, buildChangeLogScanBoundsAfter, buildAllChangeLogScanBounds, parseChangeLogKey, } from './keys.js';
+/**
+ * Change log store for HLC-indexed change tracking.
+ *
+ * Each mutation (column update or row deletion) creates an entry in the
+ * change log, keyed by HLC. This allows efficient range scans to find
+ * all changes since a given timestamp.
+ */
+export class ChangeLogStore {
+    kv;
+    constructor(kv) {
+        this.kv = kv;
+    }
+    /**
+     * Record a column change in the change log.
+     */
+    async recordColumnChange(hlc, schema, table, pk, column) {
+        const key = buildChangeLogKey(hlc, 'column', schema, table, pk, column);
+        // Value is empty - all info is in the key
+        await this.kv.put(key, new Uint8Array(0));
+    }
+    /**
+     * Record a column change in a batch.
+     */
+    recordColumnChangeBatch(batch, hlc, schema, table, pk, column) {
+        const key = buildChangeLogKey(hlc, 'column', schema, table, pk, column);
+        batch.put(key, new Uint8Array(0));
+    }
+    /**
+     * Record a row deletion in the change log.
+     */
+    async recordDeletion(hlc, schema, table, pk) {
+        const key = buildChangeLogKey(hlc, 'delete', schema, table, pk);
+        await this.kv.put(key, new Uint8Array(0));
+    }
+    /**
+     * Record a row deletion in a batch.
+     */
+    recordDeletionBatch(batch, hlc, schema, table, pk) {
+        const key = buildChangeLogKey(hlc, 'delete', schema, table, pk);
+        batch.put(key, new Uint8Array(0));
+    }
+    /**
+     * Get all change log entries after a given HLC.
+     * Returns entries in HLC order (oldest first).
+     */
+    async *getChangesSince(sinceHLC) {
+        const bounds = buildChangeLogScanBoundsAfter(sinceHLC);
+        for await (const entry of this.kv.iterate(bounds)) {
+            const parsed = parseChangeLogKey(entry.key);
+            if (parsed) {
+                yield parsed;
+            }
+        }
+    }
+    /**
+     * Get all change log entries.
+     */
+    async *getAllChanges() {
+        const bounds = buildAllChangeLogScanBounds();
+        for await (const entry of this.kv.iterate(bounds)) {
+            const parsed = parseChangeLogKey(entry.key);
+            if (parsed) {
+                yield parsed;
+            }
+        }
+    }
+    /**
+     * Delete change log entries up to a given HLC.
+     * Used for pruning old entries after they've been synced to all peers.
+     */
+    async pruneEntriesBefore(beforeHLC) {
+        const bounds = buildAllChangeLogScanBounds();
+        const batch = this.kv.batch();
+        let count = 0;
+        for await (const entry of this.kv.iterate(bounds)) {
+            const parsed = parseChangeLogKey(entry.key);
+            if (!parsed)
+                continue;
+            // Compare HLCs - stop when we reach entries >= beforeHLC
+            if (parsed.hlc.wallTime > beforeHLC.wallTime)
+                break;
+            if (parsed.hlc.wallTime === beforeHLC.wallTime) {
+                if (parsed.hlc.counter >= beforeHLC.counter)
+                    break;
+            }
+            batch.delete(entry.key);
+            count++;
+        }
+        await batch.write();
+        return count;
+    }
+    /**
+     * Delete a specific change log entry (used during snapshot application).
+     */
+    deleteEntryBatch(batch, hlc, entryType, schema, table, pk, column) {
+        const key = buildChangeLogKey(hlc, entryType, schema, table, pk, column);
+        batch.delete(key);
+    }
+}
+//# sourceMappingURL=change-log.js.map

package/dist/src/metadata/change-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"change-log.js","sourceRoot":"","sources":["../../../src/metadata/change-log.ts"],"names":[],"mappings":"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"}

package/dist/src/metadata/column-version.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Column version tracking for LWW conflict resolution.
+ *
+ * Each column of each row has an associated HLC timestamp.
+ * When merging changes, the column with the higher HLC wins.
+ */
+import type { SqlValue } from '@quereus/quereus';
+import type { KVStore, WriteBatch } from '@quereus/plugin-store';
+import { type HLC } from '../clock/hlc.js';
+/**
+ * Column version record stored in the KV store.
+ */
+export interface ColumnVersion {
+    hlc: HLC;
+    value: SqlValue;
+}
+/**
+ * Serialize a column version for storage.
+ * Format: 26 bytes HLC + JSON value
+ */
+export declare function serializeColumnVersion(cv: ColumnVersion): Uint8Array;
+/**
+ * Deserialize a column version from storage.
+ */
+export declare function deserializeColumnVersion(buffer: Uint8Array): ColumnVersion;
+/**
+ * Column version store operations.
+ */
+export declare class ColumnVersionStore {
+    private readonly kv;
+    constructor(kv: KVStore);
+    /**
+     * Get the version of a specific column.
+     */
+    getColumnVersion(schemaName: string, tableName: string, pk: SqlValue[], column: string): Promise<ColumnVersion | undefined>;
+    /**
+     * Set the version of a specific column.
+     */
+    setColumnVersion(schemaName: string, tableName: string, pk: SqlValue[], column: string, version: ColumnVersion): Promise<void>;
+    /**
+     * Set column version in a batch.
+     */
+    setColumnVersionBatch(batch: WriteBatch, schemaName: string, tableName: string, pk: SqlValue[], column: string, version: ColumnVersion): void;
+    /**
+     * Get all column versions for a row.
+     */
+    getRowVersions(schemaName: string, tableName: string, pk: SqlValue[]): Promise<Map<string, ColumnVersion>>;
+    /**
+     * Delete all column versions for a row.
+     */
+    deleteRowVersions(schemaName: string, tableName: string, pk: SqlValue[]): Promise<void>;
+    /**
+     * Check if a column write should be applied (LWW comparison).
+     * Returns true if the incoming HLC is newer than the current version.
+     */
+    shouldApplyWrite(schemaName: string, tableName: string, pk: SqlValue[], column: string, incomingHLC: HLC): Promise<boolean>;
+}
+//# sourceMappingURL=column-version.d.ts.map

package/dist/src/metadata/column-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"column-version.d.ts","sourceRoot":"","sources":["../../../src/metadata/column-version.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,EAAE,KAAK,GAAG,EAA4C,MAAM,iBAAiB,CAAC;AAGrF;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,GAAG,CAAC;IACT,KAAK,EAAE,QAAQ,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,aAAa,GAAG,UAAU,CASpE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,UAAU,GAAG,aAAa,CAK1E;AAED;;GAEG;AACH,qBAAa,kBAAkB;IACjB,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,OAAO;IAExC;;OAEG;IACG,gBAAgB,CACpB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,EAAE,EAAE,QAAQ,EAAE,EACd,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC;IAOrC;;OAEG;IACG,gBAAgB,CACpB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,EAAE,EAAE,QAAQ,EAAE,EACd,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,IAAI,CAAC;IAKhB;;OAEG;IACH,qBAAqB,CACnB,KAAK,EAAE,UAAU,EACjB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,EAAE,EAAE,QAAQ,EAAE,EACd,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,aAAa,GACrB,IAAI;IAKP;;OAEG;IACG,cAAc,CAClB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,EAAE,EAAE,QAAQ,EAAE,GACb,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAgBtC;;OAEG;IACG,iBAAiB,CACrB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,EAAE,EAAE,QAAQ,EAAE,GACb,OAAO,CAAC,IAAI,CAAC;IAWhB;;;OAGG;IACG,gBAAgB,CACpB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,EAAE,EAAE,QAAQ,EAAE,EACd,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,GAAG,GACf,OAAO,CAAC,OAAO,CAAC;CAKpB"}