@quereus/plugin-sync 0.3.1

package/dist/src/metadata/keys.js

@@ -0,0 +1,390 @@
+/**
+ * Key builders for CRDT metadata storage.
+ *
+ * Key prefixes (sync-specific):
+ *   cv: - Column versions (HLC per column per row)
+ *   tb: - Tombstones (deleted row markers)
+ *   tx: - Transaction records
+ *   ps: - Peer sync state
+ *   sm: - Schema migrations
+ *   si: - Site identity
+ *   hc: - HLC clock state
+ *   cl: - Change log (HLC-indexed for efficient delta queries)
+ */
+const encoder = new TextEncoder();
+/** Key prefix bytes for sync metadata. */
+export const SYNC_KEY_PREFIX = {
+    COLUMN_VERSION: encoder.encode('cv:'),
+    TOMBSTONE: encoder.encode('tb:'),
+    TRANSACTION: encoder.encode('tx:'),
+    PEER_STATE: encoder.encode('ps:'),
+    SCHEMA_MIGRATION: encoder.encode('sm:'),
+    SITE_IDENTITY: encoder.encode('si:'),
+    HLC_STATE: encoder.encode('hc:'),
+    CHANGE_LOG: encoder.encode('cl:'),
+};
+/** Separator between key components. */
+const SEPARATOR = ':';
+/**
+ * Encode a primary key as a string for use in metadata keys.
+ * Uses JSON for simplicity and determinism.
+ */
+export function encodePK(pk) {
+    return JSON.stringify(pk);
+}
+/**
+ * Decode a primary key from its string representation.
+ */
+export function decodePK(encoded) {
+    return JSON.parse(encoded);
+}
+/**
+ * Build a column version key.
+ * Format: cv:{schema}.{table}:{pk_json}:{column}
+ */
+export function buildColumnVersionKey(schemaName, tableName, pk, column) {
+    const key = `cv:${schemaName}.${tableName}${SEPARATOR}${encodePK(pk)}${SEPARATOR}${column}`;
+    return encoder.encode(key);
+}
+/**
+ * Build a tombstone key.
+ * Format: tb:{schema}.{table}:{pk_json}
+ */
+export function buildTombstoneKey(schemaName, tableName, pk) {
+    const key = `tb:${schemaName}.${tableName}${SEPARATOR}${encodePK(pk)}`;
+    return encoder.encode(key);
+}
+/**
+ * Build a transaction record key.
+ * Format: tx:{transactionId}
+ */
+export function buildTransactionKey(transactionId) {
+    return encoder.encode(`tx:${transactionId}`);
+}
+// Base64url alphabet (RFC 4648 Section 5)
+const BASE64URL_CHARS = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_';
+/**
+ * Build a peer sync state key.
+ * Format: ps:{siteId_base64url}
+ */
+export function buildPeerStateKey(siteId) {
+    // Inline base64url encoding to avoid import cycle
+    let base64 = '';
+    for (let i = 0; i < siteId.length; i += 3) {
+        const byte1 = siteId[i];
+        const byte2 = i + 1 < siteId.length ? siteId[i + 1] : 0;
+        const byte3 = i + 2 < siteId.length ? siteId[i + 2] : 0;
+        const triplet = (byte1 << 16) | (byte2 << 8) | byte3;
+        base64 += BASE64URL_CHARS[(triplet >>> 18) & 0x3f];
+        base64 += BASE64URL_CHARS[(triplet >>> 12) & 0x3f];
+        if (i + 1 < siteId.length)
+            base64 += BASE64URL_CHARS[(triplet >>> 6) & 0x3f];
+        if (i + 2 < siteId.length)
+            base64 += BASE64URL_CHARS[triplet & 0x3f];
+    }
+    return encoder.encode(`ps:${base64}`);
+}
+/**
+ * Build a schema migration key.
+ * Format: sm:{schema}.{table}:{version}
+ */
+export function buildSchemaMigrationKey(schemaName, tableName, version) {
+    return encoder.encode(`sm:${schemaName}.${tableName}${SEPARATOR}${version.toString().padStart(10, '0')}`);
+}
+/**
+ * Build scan bounds for all column versions of a row.
+ * Returns keys to scan cv:{schema}.{table}:{pk_json}:*
+ */
+export function buildColumnVersionScanBounds(schemaName, tableName, pk) {
+    const prefix = `cv:${schemaName}.${tableName}${SEPARATOR}${encodePK(pk)}${SEPARATOR}`;
+    return {
+        gte: encoder.encode(prefix),
+        lt: incrementLastByte(encoder.encode(prefix)),
+    };
+}
+/**
+ * Build scan bounds for all tombstones in a table.
+ */
+export function buildTombstoneScanBounds(schemaName, tableName) {
+    const prefix = `tb:${schemaName}.${tableName}${SEPARATOR}`;
+    return {
+        gte: encoder.encode(prefix),
+        lt: incrementLastByte(encoder.encode(prefix)),
+    };
+}
+/**
+ * Build scan bounds for all schema migrations of a table.
+ */
+export function buildSchemaMigrationScanBounds(schemaName, tableName) {
+    const prefix = `sm:${schemaName}.${tableName}${SEPARATOR}`;
+    return {
+        gte: encoder.encode(prefix),
+        lt: incrementLastByte(encoder.encode(prefix)),
+    };
+}
+/**
+ * Increment the last byte of a key to create an exclusive upper bound.
+ */
+function incrementLastByte(key) {
+    const result = new Uint8Array(key.length);
+    result.set(key);
+    for (let i = result.length - 1; i >= 0; i--) {
+        if (result[i] < 255) {
+            result[i]++;
+            break;
+        }
+        result[i] = 0;
+    }
+    return result;
+}
+/**
+ * Build scan bounds for ALL column versions across all tables.
+ */
+export function buildAllColumnVersionsScanBounds() {
+    return {
+        gte: SYNC_KEY_PREFIX.COLUMN_VERSION,
+        lt: incrementLastByte(SYNC_KEY_PREFIX.COLUMN_VERSION),
+    };
+}
+/**
+ * Build scan bounds for ALL tombstones across all tables.
+ */
+export function buildAllTombstonesScanBounds() {
+    return {
+        gte: SYNC_KEY_PREFIX.TOMBSTONE,
+        lt: incrementLastByte(SYNC_KEY_PREFIX.TOMBSTONE),
+    };
+}
+/**
+ * Build scan bounds for ALL schema migrations across all tables.
+ */
+export function buildAllSchemaMigrationsScanBounds() {
+    return {
+        gte: SYNC_KEY_PREFIX.SCHEMA_MIGRATION,
+        lt: incrementLastByte(SYNC_KEY_PREFIX.SCHEMA_MIGRATION),
+    };
+}
+/**
+ * Parse a column version key to extract components.
+ * Key format: cv:{schema}.{table}:{pk_json}:{column}
+ */
+export function parseColumnVersionKey(key) {
+    const keyStr = new TextDecoder().decode(key);
+    if (!keyStr.startsWith('cv:'))
+        return null;
+    // cv:{schema}.{table}:{pk_json}:{column}
+    const rest = keyStr.slice(3); // Remove 'cv:'
+    const firstDot = rest.indexOf('.');
+    if (firstDot === -1)
+        return null;
+    const schema = rest.slice(0, firstDot);
+    const afterDot = rest.slice(firstDot + 1);
+    const firstColon = afterDot.indexOf(':');
+    if (firstColon === -1)
+        return null;
+    const table = afterDot.slice(0, firstColon);
+    const afterTable = afterDot.slice(firstColon + 1);
+    const lastColon = afterTable.lastIndexOf(':');
+    if (lastColon === -1)
+        return null;
+    const pkJson = afterTable.slice(0, lastColon);
+    const column = afterTable.slice(lastColon + 1);
+    try {
+        const pk = decodePK(pkJson);
+        return { schema, table, pk, column };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Parse a tombstone key to extract components.
+ * Key format: tb:{schema}.{table}:{pk_json}
+ */
+export function parseTombstoneKey(key) {
+    const keyStr = new TextDecoder().decode(key);
+    if (!keyStr.startsWith('tb:'))
+        return null;
+    // tb:{schema}.{table}:{pk_json}
+    const rest = keyStr.slice(3); // Remove 'tb:'
+    const firstDot = rest.indexOf('.');
+    if (firstDot === -1)
+        return null;
+    const schema = rest.slice(0, firstDot);
+    const afterDot = rest.slice(firstDot + 1);
+    const firstColon = afterDot.indexOf(':');
+    if (firstColon === -1)
+        return null;
+    const table = afterDot.slice(0, firstColon);
+    const pkJson = afterDot.slice(firstColon + 1);
+    try {
+        const pk = decodePK(pkJson);
+        return { schema, table, pk };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Parse a schema migration key to extract components.
+ * Key format: sm:{schema}.{table}:{version}
+ */
+export function parseSchemaMigrationKey(key) {
+    const keyStr = new TextDecoder().decode(key);
+    if (!keyStr.startsWith('sm:'))
+        return null;
+    // sm:{schema}.{table}:{version}
+    const rest = keyStr.slice(3); // Remove 'sm:'
+    const firstDot = rest.indexOf('.');
+    if (firstDot === -1)
+        return null;
+    const schema = rest.slice(0, firstDot);
+    const afterDot = rest.slice(firstDot + 1);
+    const firstColon = afterDot.indexOf(':');
+    if (firstColon === -1)
+        return null;
+    const table = afterDot.slice(0, firstColon);
+    const versionStr = afterDot.slice(firstColon + 1);
+    const version = parseInt(versionStr, 10);
+    if (isNaN(version))
+        return null;
+    return { schema, table, version };
+}
+/**
+ * Serialize an HLC to a sortable key component (26 bytes, big-endian).
+ * This format ensures lexicographic ordering matches HLC ordering.
+ */
+export function serializeHLCForKey(hlc) {
+    const buffer = new Uint8Array(26);
+    const view = new DataView(buffer.buffer);
+    // Wall time as big-endian 64-bit
+    view.setBigUint64(0, hlc.wallTime, false);
+    // Counter as big-endian 16-bit
+    view.setUint16(8, hlc.counter, false);
+    // Site ID (16 bytes)
+    buffer.set(hlc.siteId, 10);
+    return buffer;
+}
+/**
+ * Deserialize an HLC from a key component.
+ */
+export function deserializeHLCFromKey(buffer) {
+    const view = new DataView(buffer.buffer, buffer.byteOffset, buffer.byteLength);
+    const wallTime = view.getBigUint64(0, false);
+    const counter = view.getUint16(8, false);
+    const siteId = new Uint8Array(buffer.slice(10, 26));
+    return { wallTime, counter, siteId };
+}
+/**
+ * Build a change log key.
+ * Format: cl:{hlc_bytes}{type_byte}{schema}.{table}:{pk_json}:{column?}
+ *
+ * The HLC comes first to enable efficient range scans by time.
+ * type_byte: 0x01 for column change, 0x02 for delete
+ */
+export function buildChangeLogKey(hlc, entryType, schemaName, tableName, pk, column) {
+    const hlcBytes = serializeHLCForKey(hlc);
+    const typeByte = entryType === 'column' ? 0x01 : 0x02;
+    const suffix = column
+        ? `${schemaName}.${tableName}${SEPARATOR}${encodePK(pk)}${SEPARATOR}${column}`
+        : `${schemaName}.${tableName}${SEPARATOR}${encodePK(pk)}`;
+    const suffixBytes = encoder.encode(suffix);
+    // cl: (3) + hlc (26) + type (1) + suffix
+    const key = new Uint8Array(3 + 26 + 1 + suffixBytes.length);
+    key.set(SYNC_KEY_PREFIX.CHANGE_LOG, 0);
+    key.set(hlcBytes, 3);
+    key[29] = typeByte;
+    key.set(suffixBytes, 30);
+    return key;
+}
+/**
+ * Build scan bounds for change log entries after a given HLC.
+ * Returns keys to scan cl:{sinceHLC}* to end of change log.
+ */
+export function buildChangeLogScanBoundsAfter(sinceHLC) {
+    const hlcBytes = serializeHLCForKey(sinceHLC);
+    // Start just after sinceHLC
+    const gte = new Uint8Array(3 + 26);
+    gte.set(SYNC_KEY_PREFIX.CHANGE_LOG, 0);
+    gte.set(incrementHLCBytes(hlcBytes), 3);
+    return {
+        gte,
+        lt: incrementLastByte(SYNC_KEY_PREFIX.CHANGE_LOG),
+    };
+}
+/**
+ * Build scan bounds for all change log entries.
+ */
+export function buildAllChangeLogScanBounds() {
+    return {
+        gte: SYNC_KEY_PREFIX.CHANGE_LOG,
+        lt: incrementLastByte(SYNC_KEY_PREFIX.CHANGE_LOG),
+    };
+}
+/**
+ * Increment HLC bytes to get the next possible HLC key prefix.
+ */
+function incrementHLCBytes(hlcBytes) {
+    const result = new Uint8Array(hlcBytes.length);
+    result.set(hlcBytes);
+    for (let i = result.length - 1; i >= 0; i--) {
+        if (result[i] < 255) {
+            result[i]++;
+            break;
+        }
+        result[i] = 0;
+    }
+    return result;
+}
+/**
+ * Parse a change log key to extract components.
+ */
+export function parseChangeLogKey(key) {
+    // Minimum: cl: (3) + hlc (26) + type (1) + some suffix
+    if (key.length < 31)
+        return null;
+    const prefixStr = new TextDecoder().decode(key.slice(0, 3));
+    if (prefixStr !== 'cl:')
+        return null;
+    const hlcBytes = key.slice(3, 29);
+    const hlc = deserializeHLCFromKey(hlcBytes);
+    const typeByte = key[29];
+    const entryType = typeByte === 0x01 ? 'column' : 'delete';
+    const suffixStr = new TextDecoder().decode(key.slice(30));
+    // Parse suffix: {schema}.{table}:{pk_json}:{column?}
+    const firstDot = suffixStr.indexOf('.');
+    if (firstDot === -1)
+        return null;
+    const schema = suffixStr.slice(0, firstDot);
+    const afterDot = suffixStr.slice(firstDot + 1);
+    const firstColon = afterDot.indexOf(':');
+    if (firstColon === -1)
+        return null;
+    const table = afterDot.slice(0, firstColon);
+    const afterTable = afterDot.slice(firstColon + 1);
+    if (entryType === 'column') {
+        const lastColon = afterTable.lastIndexOf(':');
+        if (lastColon === -1)
+            return null;
+        const pkJson = afterTable.slice(0, lastColon);
+        const column = afterTable.slice(lastColon + 1);
+        try {
+            const pk = decodePK(pkJson);
+            return { hlc, entryType, schema, table, pk, column };
+        }
+        catch {
+            return null;
+        }
+    }
+    else {
+        // Delete entry - no column
+        try {
+            const pk = decodePK(afterTable);
+            return { hlc, entryType, schema, table, pk };
+        }
+        catch {
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=keys.js.map

package/dist/src/metadata/keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.js","sourceRoot":"","sources":["../../../src/metadata/keys.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;AAElC,0CAA0C;AAC1C,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,cAAc,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;IACrC,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;IAChC,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;IAClC,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;IACjC,gBAAgB,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;IACvC,aAAa,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;IACpC,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;IAChC,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;CACzB,CAAC;AAEX,wCAAwC;AACxC,MAAM,SAAS,GAAG,GAAG,CAAC;AAEtB;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,EAAc;IACrC,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;AAC5B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,OAAe;IACtC,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAe,CAAC;AAC3C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,UAAkB,EAClB,SAAiB,EACjB,EAAc,EACd,MAAc;IAEd,MAAM,GAAG,GAAG,MAAM,UAAU,IAAI,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC,EAAE,CAAC,GAAG,SAAS,GAAG,MAAM,EAAE,CAAC;IAC5F,OAAO,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AAC7B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAC/B,UAAkB,EAClB,SAAiB,EACjB,EAAc;IAEd,MAAM,GAAG,GAAG,MAAM,UAAU,IAAI,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;IACvE,OAAO,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AAC7B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,aAAqB;IACvD,OAAO,OAAO,CAAC,MAAM,CAAC,MAAM,aAAa,EAAE,CAAC,CAAC;AAC/C,CAAC;AAED,0CAA0C;AAC1C,MAAM,eAAe,GAAG,kEAAkE,CAAC;AAE3F;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC9C,kDAAkD;IAClD,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1C,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACxB,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACxD,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACxD,MAAM,OAAO,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC;QACrD,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,MAAM,CAAC,MAAM;YAAE,MAAM,IAAI,eAAe,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;QAC7E,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM;YAAE,MAAM,IAAI,eAAe,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IACvE,CAAC;IACD,OAAO,OAAO,CAAC,MAAM,CAAC,MAAM,MAAM,EAAE,CAAC,CAAC;AACxC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CACrC,UAAkB,EAClB,SAAiB,EACjB,OAAe;IAEf,OAAO,OAAO,CAAC,MAAM,CAAC,MAAM,UAAU,IAAI,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;AAC5G,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,4BAA4B,CAC1C,UAAkB,EAClB,SAAiB,EACjB,EAAc;IAEd,MAAM,MAAM,GAAG,MAAM,UAAU,IAAI,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC,EAAE,CAAC,GAAG,SAAS,EAAE,CAAC;IACtF,OAAO;QACL,GAAG,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC;QAC3B,EAAE,EAAE,iBAAiB,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;KAC9C,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CACtC,UAAkB,EAClB,SAAiB;IAEjB,MAAM,MAAM,GAAG,MAAM,UAAU,IAAI,SAAS,GAAG,SAAS,EAAE,CAAC;IAC3D,OAAO;QACL,GAAG,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC;QAC3B,EAAE,EAAE,iBAAiB,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;KAC9C,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,8BAA8B,CAC5C,UAAkB,EAClB,SAAiB;IAEjB,MAAM,MAAM,GAAG,MAAM,UAAU,IAAI,SAAS,GAAG,SAAS,EAAE,CAAC;IAC3D,OAAO;QACL,GAAG,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC;QAC3B,EAAE,EAAE,iBAAiB,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;KAC9C,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CAAC,GAAe;IACxC,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC1C,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAChB,KAAK,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5C,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC;YACpB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;YACZ,MAAM;QACR,CAAC;QACD,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAChB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gCAAgC;IAC9C,OAAO;QACL,GAAG,EAAE,eAAe,CAAC,cAAc;QACnC,EAAE,EAAE,iBAAiB,CAAC,eAAe,CAAC,cAAc,CAAC;KACtD,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,4BAA4B;IAC1C,OAAO;QACL,GAAG,EAAE,eAAe,CAAC,SAAS;QAC9B,EAAE,EAAE,iBAAiB,CAAC,eAAe,CAAC,SAAS,CAAC;KACjD,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kCAAkC;IAChD,OAAO;QACL,GAAG,EAAE,eAAe,CAAC,gBAAgB;QACrC,EAAE,EAAE,iBAAiB,CAAC,eAAe,CAAC,gBAAgB,CAAC;KACxD,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,GAAe;IAMnD,MAAM,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC7C,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAE3C,yCAAyC;IACzC,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe;IAC7C,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACnC,IAAI,QAAQ,KAAK,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACjC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IAEvC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;IAC1C,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACzC,IAAI,UAAU,KAAK,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;IAE5C,MAAM,UAAU,GAAG,QAAQ,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;IAClD,MAAM,SAAS,GAAG,UAAU,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAC9C,IAAI,SAAS,KAAK,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAElC,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;IAE/C,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC5B,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAe;IAK/C,MAAM,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC7C,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAE3C,gCAAgC;IAChC,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe;IAC7C,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACnC,IAAI,QAAQ,KAAK,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACjC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IAEvC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;IAC1C,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACzC,IAAI,UAAU,KAAK,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;IAE5C,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;IAE9C,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC5B,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,GAAe;IAKrD,MAAM,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC7C,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAE3C,gCAAgC;IAChC,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe;IAC7C,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACnC,IAAI,QAAQ,KAAK,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACjC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IAEvC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;IAC1C,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACzC,IAAI,UAAU,KAAK,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;IAE5C,MAAM,UAAU,GAAG,QAAQ,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;IAClD,MAAM,OAAO,GAAG,QAAQ,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAEzC,IAAI,KAAK,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IAEhC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AACpC,CAAC;AAOD;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAQ;IACzC,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC;IAClC,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACzC,iCAAiC;IACjC,IAAI,CAAC,YAAY,CAAC,CAAC,EAAE,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC1C,+BAA+B;IAC/B,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACtC,qBAAqB;IACrB,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC3B,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAkB;IACtD,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;IAC/E,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAC7C,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IACzC,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IACpD,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;AACvC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAC/B,GAAQ,EACR,SAA6B,EAC7B,UAAkB,EAClB,SAAiB,EACjB,EAAc,EACd,MAAe;IAEf,MAAM,QAAQ,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;IACzC,MAAM,QAAQ,GAAG,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IACtD,MAAM,MAAM,GAAG,MAAM;QACnB,CAAC,CAAC,GAAG,UAAU,IAAI,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC,EAAE,CAAC,GAAG,SAAS,GAAG,MAAM,EAAE;QAC9E,CAAC,CAAC,GAAG,UAAU,IAAI,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;IAC5D,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAE3C,yCAAyC;IACzC,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IAC5D,GAAG,CAAC,GAAG,CAAC,eAAe,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;IACvC,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;IACrB,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC;IACnB,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IAEzB,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,6BAA6B,CAAC,QAAa;IACzD,MAAM,QAAQ,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAC9C,4BAA4B;IAC5B,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;IACnC,GAAG,CAAC,GAAG,CAAC,eAAe,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;IACvC,GAAG,CAAC,GAAG,CAAC,iBAAiB,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;IAExC,OAAO;QACL,GAAG;QACH,EAAE,EAAE,iBAAiB,CAAC,eAAe,CAAC,UAAU,CAAC;KAClD,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,2BAA2B;IACzC,OAAO;QACL,GAAG,EAAE,eAAe,CAAC,UAAU;QAC/B,EAAE,EAAE,iBAAiB,CAAC,eAAe,CAAC,UAAU,CAAC;KAClD,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CAAC,QAAoB;IAC7C,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC/C,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACrB,KAAK,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5C,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC;YACpB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;YACZ,MAAM;QACR,CAAC;QACD,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAChB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAe;IAQ/C,uDAAuD;IACvD,IAAI,GAAG,CAAC,MAAM,GAAG,EAAE;QAAE,OAAO,IAAI,CAAC;IAEjC,MAAM,SAAS,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC5D,IAAI,SAAS,KAAK,KAAK;QAAE,OAAO,IAAI,CAAC;IAErC,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAClC,MAAM,GAAG,GAAG,qBAAqB,CAAC,QAAQ,CAAC,CAAC;IAE5C,MAAM,QAAQ,GAAG,GAAG,CAAC,EAAE,CAAC,CAAC;IACzB,MAAM,SAAS,GAAuB,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC;IAE9E,MAAM,SAAS,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;IAE1D,qDAAqD;IACrD,MAAM,QAAQ,GAAG,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACxC,IAAI,QAAQ,KAAK,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACjC,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IAE5C,MAAM,QAAQ,GAAG,SAAS,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;IAC/C,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACzC,IAAI,UAAU,KAAK,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;IAE5C,MAAM,UAAU,GAAG,QAAQ,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;IAElD,IAAI,SAAS,KAAK,QAAQ,EAAE,CAAC;QAC3B,MAAM,SAAS,GAAG,UAAU,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QAC9C,IAAI,SAAS,KAAK,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC;QAClC,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;QAC9C,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;QAC/C,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;YAC5B,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC;QACvD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;SAAM,CAAC;QACN,2BAA2B;QAC3B,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC;YAChC,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;QAC/C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/src/metadata/peer-state.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Peer sync state tracking.
+ *
+ * Tracks the last HLC we've synced to with each peer.
+ * Used to determine what changes to send during delta sync.
+ */
+import type { KVStore } from '@quereus/plugin-store';
+import { type HLC } from '../clock/hlc.js';
+import type { SiteId } from '../clock/site.js';
+/**
+ * Peer sync state record.
+ */
+export interface PeerState {
+    lastSyncHLC: HLC;
+    lastSyncTime: number;
+}
+/**
+ * Serialize peer state for storage.
+ * Format: 26 bytes HLC + 8 bytes lastSyncTime
+ */
+export declare function serializePeerState(state: PeerState): Uint8Array;
+/**
+ * Deserialize peer state from storage.
+ */
+export declare function deserializePeerState(buffer: Uint8Array): PeerState;
+/**
+ * Peer state store operations.
+ */
+export declare class PeerStateStore {
+    private readonly kv;
+    constructor(kv: KVStore);
+    /**
+     * Get the sync state for a peer.
+     */
+    getPeerState(peerSiteId: SiteId): Promise<PeerState | undefined>;
+    /**
+     * Update the sync state for a peer.
+     */
+    setPeerState(peerSiteId: SiteId, hlc: HLC): Promise<void>;
+    /**
+     * Get all known peers.
+     */
+    getAllPeers(): AsyncIterable<{
+        siteId: SiteId;
+        state: PeerState;
+    }>;
+    /**
+     * Delete peer state (e.g., when peer is no longer known).
+     */
+    deletePeerState(peerSiteId: SiteId): Promise<void>;
+}
+//# sourceMappingURL=peer-state.d.ts.map

package/dist/src/metadata/peer-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"peer-state.d.ts","sourceRoot":"","sources":["../../../src/metadata/peer-state.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,KAAK,GAAG,EAAgC,MAAM,iBAAiB,CAAC;AACzE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAI/C;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,WAAW,EAAE,GAAG,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,GAAG,UAAU,CAS/D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,CAKlE;AAED;;GAEG;AACH,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,OAAO;IAExC;;OAEG;IACG,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC;IAOtE;;OAEG;IACG,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAS/D;;OAEG;IACI,WAAW,IAAI,aAAa,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,SAAS,CAAA;KAAE,CAAC;IAmBzE;;OAEG;IACG,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAIzD"}

package/dist/src/metadata/peer-state.js

@@ -0,0 +1,87 @@
+/**
+ * Peer sync state tracking.
+ *
+ * Tracks the last HLC we've synced to with each peer.
+ * Used to determine what changes to send during delta sync.
+ */
+import { serializeHLC, deserializeHLC } from '../clock/hlc.js';
+import { buildPeerStateKey } from './keys.js';
+import { SYNC_KEY_PREFIX } from './keys.js';
+/**
+ * Serialize peer state for storage.
+ * Format: 26 bytes HLC + 8 bytes lastSyncTime
+ */
+export function serializePeerState(state) {
+    const result = new Uint8Array(34);
+    const hlcBytes = serializeHLC(state.lastSyncHLC);
+    result.set(hlcBytes, 0);
+    const view = new DataView(result.buffer);
+    view.setBigUint64(26, BigInt(state.lastSyncTime), false);
+    return result;
+}
+/**
+ * Deserialize peer state from storage.
+ */
+export function deserializePeerState(buffer) {
+    const lastSyncHLC = deserializeHLC(buffer.slice(0, 26));
+    const view = new DataView(buffer.buffer, buffer.byteOffset, buffer.byteLength);
+    const lastSyncTime = Number(view.getBigUint64(26, false));
+    return { lastSyncHLC, lastSyncTime };
+}
+/**
+ * Peer state store operations.
+ */
+export class PeerStateStore {
+    kv;
+    constructor(kv) {
+        this.kv = kv;
+    }
+    /**
+     * Get the sync state for a peer.
+     */
+    async getPeerState(peerSiteId) {
+        const key = buildPeerStateKey(peerSiteId);
+        const data = await this.kv.get(key);
+        if (!data)
+            return undefined;
+        return deserializePeerState(data);
+    }
+    /**
+     * Update the sync state for a peer.
+     */
+    async setPeerState(peerSiteId, hlc) {
+        const key = buildPeerStateKey(peerSiteId);
+        const state = {
+            lastSyncHLC: hlc,
+            lastSyncTime: Date.now(),
+        };
+        await this.kv.put(key, serializePeerState(state));
+    }
+    /**
+     * Get all known peers.
+     */
+    async *getAllPeers() {
+        const prefix = SYNC_KEY_PREFIX.PEER_STATE;
+        const lt = new Uint8Array(prefix.length);
+        lt.set(prefix);
+        lt[lt.length - 1]++;
+        for await (const entry of this.kv.iterate({ gte: prefix, lt })) {
+            // Extract site ID from key: ps:{siteId_hex}
+            const keyStr = new TextDecoder().decode(entry.key);
+            const hex = keyStr.slice(3); // Skip "ps:"
+            const siteId = new Uint8Array(16);
+            for (let i = 0; i < 16; i++) {
+                siteId[i] = parseInt(hex.slice(i * 2, i * 2 + 2), 16);
+            }
+            yield { siteId, state: deserializePeerState(entry.value) };
+        }
+    }
+    /**
+     * Delete peer state (e.g., when peer is no longer known).
+     */
+    async deletePeerState(peerSiteId) {
+        const key = buildPeerStateKey(peerSiteId);
+        await this.kv.delete(key);
+    }
+}
+//# sourceMappingURL=peer-state.js.map

package/dist/src/metadata/peer-state.js.map

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

package/dist/src/metadata/schema-migration.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Schema migration tracking for sync.
+ *
+ * Tracks DDL changes (CREATE TABLE, ALTER TABLE, etc.) with HLC timestamps.
+ * Uses first-writer-wins for conflict resolution on schema changes.
+ */
+import type { KVStore, WriteBatch } from '@quereus/plugin-store';
+import { type HLC } from '../clock/hlc.js';
+import type { SchemaMigrationType } from '../sync/protocol.js';
+/**
+ * Stored schema migration record.
+ */
+export interface StoredMigration {
+    type: SchemaMigrationType;
+    ddl: string;
+    hlc: HLC;
+    schemaVersion: number;
+}
+/**
+ * Serialize a migration for storage.
+ * Format: 26 bytes HLC + 4 bytes version + 1 byte type length + type + ddl
+ */
+export declare function serializeMigration(migration: StoredMigration): Uint8Array;
+/**
+ * Deserialize a migration from storage.
+ */
+export declare function deserializeMigration(buffer: Uint8Array): StoredMigration;
+/**
+ * Schema migration store operations.
+ */
+export declare class SchemaMigrationStore {
+    private readonly kv;
+    constructor(kv: KVStore);
+    /**
+     * Get a specific migration by version.
+     */
+    getMigration(schemaName: string, tableName: string, version: number): Promise<StoredMigration | undefined>;
+    /**
+     * Record a new migration.
+     */
+    recordMigration(schemaName: string, tableName: string, migration: StoredMigration): Promise<void>;
+    /**
+     * Record migration in a batch.
+     */
+    recordMigrationBatch(batch: WriteBatch, schemaName: string, tableName: string, migration: StoredMigration): void;
+    /**
+     * Get the current schema version for a table.
+     */
+    getCurrentVersion(schemaName: string, tableName: string): Promise<number>;
+    /**
+     * Get all migrations for a table.
+     */
+    getAllMigrations(schemaName: string, tableName: string): AsyncIterable<StoredMigration>;
+    /**
+     * Check if a migration conflicts with an existing one.
+     * Returns the existing migration if there's a conflict, undefined otherwise.
+     */
+    checkConflict(schemaName: string, tableName: string, version: number, incomingHLC: HLC): Promise<StoredMigration | undefined>;
+}
+//# sourceMappingURL=schema-migration.d.ts.map

package/dist/src/metadata/schema-migration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-migration.d.ts","sourceRoot":"","sources":["../../../src/metadata/schema-migration.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,EAAE,KAAK,GAAG,EAA4C,MAAM,iBAAiB,CAAC;AAErF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE/D;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,mBAAmB,CAAC;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,GAAG,CAAC;IACT,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,eAAe,GAAG,UAAU,CA4BzE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,UAAU,GAAG,eAAe,CAuBxE;AAED;;GAEG;AACH,qBAAa,oBAAoB;IACnB,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,OAAO;IAExC;;OAEG;IACG,YAAY,CAChB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC;IAOvC;;OAEG;IACG,eAAe,CACnB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,eAAe,GACzB,OAAO,CAAC,IAAI,CAAC;IAKhB;;OAEG;IACH,oBAAoB,CAClB,KAAK,EAAE,UAAU,EACjB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,eAAe,GACzB,IAAI;IAKP;;OAEG;IACG,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAY/E;;OAEG;IACI,gBAAgB,CACrB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,aAAa,CAAC,eAAe,CAAC;IAQjC;;;OAGG;IACG,aAAa,CACjB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,GAAG,GACf,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC;CAWxC"}