@quereus/plugin-sync 0.3.1 → 0.3.3

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

@@ -1,87 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,60 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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"}

package/dist/src/metadata/schema-migration.js

@@ -1,126 +0,0 @@
-/**
- * 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 { serializeHLC, deserializeHLC, compareHLC } from '../clock/hlc.js';
-import { buildSchemaMigrationKey, buildSchemaMigrationScanBounds } from './keys.js';
-/**
- * Serialize a migration for storage.
- * Format: 26 bytes HLC + 4 bytes version + 1 byte type length + type + ddl
- */
-export function serializeMigration(migration) {
-    const encoder = new TextEncoder();
-    const typeBytes = encoder.encode(migration.type);
-    const ddlBytes = encoder.encode(migration.ddl);
-    const hlcBytes = serializeHLC(migration.hlc);
-    const buffer = new Uint8Array(26 + 4 + 1 + typeBytes.length + ddlBytes.length);
-    let offset = 0;
-    // HLC (26 bytes)
-    buffer.set(hlcBytes, offset);
-    offset += 26;
-    // Schema version (4 bytes, big-endian)
-    const view = new DataView(buffer.buffer);
-    view.setUint32(offset, migration.schemaVersion, false);
-    offset += 4;
-    // Type length (1 byte) + type
-    buffer[offset] = typeBytes.length;
-    offset += 1;
-    buffer.set(typeBytes, offset);
-    offset += typeBytes.length;
-    // DDL (rest of buffer)
-    buffer.set(ddlBytes, offset);
-    return buffer;
-}
-/**
- * Deserialize a migration from storage.
- */
-export function deserializeMigration(buffer) {
-    const decoder = new TextDecoder();
-    let offset = 0;
-    // HLC (26 bytes)
-    const hlc = deserializeHLC(buffer.slice(0, 26));
-    offset += 26;
-    // Schema version (4 bytes)
-    const view = new DataView(buffer.buffer, buffer.byteOffset, buffer.byteLength);
-    const schemaVersion = view.getUint32(offset, false);
-    offset += 4;
-    // Type length + type
-    const typeLength = buffer[offset];
-    offset += 1;
-    const type = decoder.decode(buffer.slice(offset, offset + typeLength));
-    offset += typeLength;
-    // DDL
-    const ddl = decoder.decode(buffer.slice(offset));
-    return { type, ddl, hlc, schemaVersion };
-}
-/**
- * Schema migration store operations.
- */
-export class SchemaMigrationStore {
-    kv;
-    constructor(kv) {
-        this.kv = kv;
-    }
-    /**
-     * Get a specific migration by version.
-     */
-    async getMigration(schemaName, tableName, version) {
-        const key = buildSchemaMigrationKey(schemaName, tableName, version);
-        const data = await this.kv.get(key);
-        if (!data)
-            return undefined;
-        return deserializeMigration(data);
-    }
-    /**
-     * Record a new migration.
-     */
-    async recordMigration(schemaName, tableName, migration) {
-        const key = buildSchemaMigrationKey(schemaName, tableName, migration.schemaVersion);
-        await this.kv.put(key, serializeMigration(migration));
-    }
-    /**
-     * Record migration in a batch.
-     */
-    recordMigrationBatch(batch, schemaName, tableName, migration) {
-        const key = buildSchemaMigrationKey(schemaName, tableName, migration.schemaVersion);
-        batch.put(key, serializeMigration(migration));
-    }
-    /**
-     * Get the current schema version for a table.
-     */
-    async getCurrentVersion(schemaName, tableName) {
-        const bounds = buildSchemaMigrationScanBounds(schemaName, tableName);
-        let maxVersion = 0;
-        for await (const entry of this.kv.iterate({ ...bounds, reverse: true, limit: 1 })) {
-            const migration = deserializeMigration(entry.value);
-            maxVersion = migration.schemaVersion;
-        }
-        return maxVersion;
-    }
-    /**
-     * Get all migrations for a table.
-     */
-    async *getAllMigrations(schemaName, tableName) {
-        const bounds = buildSchemaMigrationScanBounds(schemaName, tableName);
-        for await (const entry of this.kv.iterate(bounds)) {
-            yield deserializeMigration(entry.value);
-        }
-    }
-    /**
-     * Check if a migration conflicts with an existing one.
-     * Returns the existing migration if there's a conflict, undefined otherwise.
-     */
-    async checkConflict(schemaName, tableName, version, incomingHLC) {
-        const existing = await this.getMigration(schemaName, tableName, version);
-        if (!existing)
-            return undefined;
-        // First-writer-wins: if existing has lower HLC, it wins
-        if (compareHLC(existing.hlc, incomingHLC) < 0) {
-            return existing; // Existing wins, return it as the conflict winner
-        }
-        return undefined; // Incoming wins or they're equal
-    }
-}
-//# sourceMappingURL=schema-migration.js.map

package/dist/src/metadata/schema-migration.js.map

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

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

@@ -1,163 +0,0 @@
-/**
- * Column-level schema versioning for sync.
- *
- * Tracks the HLC timestamp of each column's definition to enable
- * "most destructive wins" conflict resolution for schema changes.
- *
- * Key format: sv:{schema}.{table}:{column}
- * Value: HLC (26 bytes) + 1 byte type + type-specific data
- *
- * Column types:
- * - 0x01: Regular column (type affinity, nullable, default)
- * - 0x02: Dropped column (tombstone)
- * - 0x03: Table-level (for CREATE/DROP TABLE)
- *
- * Destructiveness hierarchy (higher wins in conflicts):
- * - DROP TABLE/COLUMN: 3 (most destructive)
- * - ALTER COLUMN: 2
- * - ADD COLUMN/CREATE TABLE: 1 (least destructive)
- */
-import type { KVStore, WriteBatch } from '@quereus/plugin-store';
-import { type HLC } from '../clock/hlc.js';
-/** Schema version entry types. */
-export type SchemaVersionType = 'column' | 'dropped' | 'table';
-/**
- * Schema version entry for a column or table.
- */
-export interface SchemaVersion {
-    hlc: HLC;
-    type: SchemaVersionType;
-    /** Column type affinity (for column type). */
-    affinity?: string;
-    /** Whether column is nullable (for column type). */
-    nullable?: boolean;
-    /** Default value expression (for column type). */
-    defaultExpr?: string;
-    /** DDL statement (for table type). */
-    ddl?: string;
-}
-/**
- * Build a schema version key.
- * Format: sv:{schema}.{table}:{column}
- * For table-level entries, column is '__table__'.
- */
-export declare function buildSchemaVersionKey(schemaName: string, tableName: string, columnName?: string): Uint8Array;
-/**
- * Build scan bounds for all schema versions of a table.
- */
-export declare function buildSchemaVersionScanBounds(schemaName: string, tableName: string): {
-    gte: Uint8Array;
-    lt: Uint8Array;
-};
-/**
- * Build scan bounds for ALL schema versions across all tables.
- */
-export declare function buildAllSchemaVersionsScanBounds(): {
-    gte: Uint8Array;
-    lt: Uint8Array;
-};
-/**
- * Serialize a schema version for storage.
- */
-export declare function serializeSchemaVersion(version: SchemaVersion): Uint8Array;
-/**
- * Deserialize a schema version from storage.
- */
-export declare function deserializeSchemaVersion(buffer: Uint8Array): SchemaVersion;
-/**
- * Parse a schema version key to extract components.
- */
-export declare function parseSchemaVersionKey(key: Uint8Array): {
-    schema: string;
-    table: string;
-    column: string;
-} | null;
-/**
- * Schema version store operations.
- */
-export declare class SchemaVersionStore {
-    private readonly kv;
-    constructor(kv: KVStore);
-    /**
-     * Get the schema version for a column.
-     */
-    getColumnVersion(schemaName: string, tableName: string, columnName: string): Promise<SchemaVersion | undefined>;
-    /**
-     * Get the schema version for a table.
-     */
-    getTableVersion(schemaName: string, tableName: string): Promise<SchemaVersion | undefined>;
-    /**
-     * Set the schema version for a column.
-     */
-    setColumnVersion(schemaName: string, tableName: string, columnName: string, version: SchemaVersion): Promise<void>;
-    /**
-     * Set the schema version for a column in a batch.
-     */
-    setColumnVersionBatch(batch: WriteBatch, schemaName: string, tableName: string, columnName: string, version: SchemaVersion): void;
-    /**
-     * Set the schema version for a table.
-     */
-    setTableVersion(schemaName: string, tableName: string, version: SchemaVersion): Promise<void>;
-    /**
-     * Get all column versions for a table.
-     */
-    getAllColumnVersions(schemaName: string, tableName: string): AsyncIterable<{
-        column: string;
-        version: SchemaVersion;
-    }>;
-    /**
-     * Get all schema versions across all tables.
-     */
-    getAllSchemaVersions(): AsyncIterable<{
-        schema: string;
-        table: string;
-        column: string;
-        version: SchemaVersion;
-    }>;
-    /**
-     * Check if a schema change should be applied based on HLC comparison.
-     * Returns true if the incoming change should win.
-     */
-    shouldApplyChange(schemaName: string, tableName: string, columnName: string, incomingHLC: HLC): Promise<boolean>;
-    /**
-     * Check if a schema change should be applied using "most destructive wins" semantics.
-     *
-     * When two schema changes conflict (same HLC or concurrent changes):
-     * 1. More destructive changes win over less destructive ones
-     * 2. If same destructiveness, higher HLC wins
-     *
-     * Destructiveness hierarchy:
-     * - DROP (column or table): 3
-     * - ALTER (type change, constraint change): 2
-     * - ADD (new column, create table): 1
-     *
-     * @returns true if the incoming change should be applied
-     */
-    shouldApplySchemaChange(schemaName: string, tableName: string, columnName: string, incomingVersion: SchemaVersion): Promise<boolean>;
-}
-/**
- * Get the destructiveness level of a schema version type.
- * Higher values are more destructive.
- */
-export declare function getDestructiveness(type: SchemaVersionType): number;
-/**
- * Schema change operation types for more granular destructiveness.
- */
-export type SchemaChangeOperation = 'drop_table' | 'drop_column' | 'alter_column' | 'add_column' | 'create_table';
-/**
- * Get the destructiveness level of a schema change operation.
- * Higher values are more destructive.
- */
-export declare function getOperationDestructiveness(operation: SchemaChangeOperation): number;
-/**
- * Determine if an incoming schema change should be applied based on
- * "most destructive wins" semantics.
- *
- * @param incomingOp The incoming schema change operation
- * @param incomingHLC The HLC of the incoming change
- * @param existingOp The existing schema change operation (if any)
- * @param existingHLC The HLC of the existing change (if any)
- * @returns true if the incoming change should be applied
- */
-export declare function shouldApplySchemaChangeByOperation(incomingOp: SchemaChangeOperation, incomingHLC: HLC, existingOp?: SchemaChangeOperation, existingHLC?: HLC): boolean;
-//# sourceMappingURL=schema-version.d.ts.map

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

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