agentic-qe 2.7.4 → 2.8.0

package/dist/edge/p2p/crdt/LWWRegister.d.ts

@@ -0,0 +1,200 @@
+/**
+ * LWW-Register (Last-Writer-Wins Register) CRDT Implementation
+ *
+ * A state-based CRDT that resolves conflicts using timestamps.
+ * The most recent write (highest timestamp) wins during merge.
+ * Replica ID is used as a tiebreaker for equal timestamps.
+ *
+ * @module edge/p2p/crdt/LWWRegister
+ * @version 1.0.0
+ */
+import { ReplicaId, WallTimestamp, CRDTState, CRDTMetadata, SerializedVectorClock, SerializedLWWRegisterState, MergeResult, CRDTDelta, CRDT } from './types';
+import { VectorClock } from './VectorClock';
+/**
+ * Last-Writer-Wins Register CRDT.
+ *
+ * Properties:
+ * - Stores a single value with associated timestamp
+ * - Conflicts resolved by comparing timestamps
+ * - Higher replica ID wins ties (deterministic)
+ * - Strongly eventually consistent
+ *
+ * @example
+ * ```typescript
+ * const register = new LWWRegister<string>('replica-1', 'name');
+ *
+ * register.set('Alice');
+ * register.set('Bob');
+ *
+ * console.log(register.value()); // 'Bob'
+ *
+ * // Merge with remote state
+ * register.merge(remoteState);
+ * ```
+ */
+export declare class LWWRegister<T> implements CRDT<T | undefined, SerializedLWWRegisterState<T>> {
+    /** Unique identifier for this register */
+    private readonly id;
+    /** Local replica ID */
+    private readonly replicaId;
+    /** Current value */
+    private currentValue;
+    /** Timestamp of current value */
+    private timestamp;
+    /** Replica that set current value */
+    private valueReplica;
+    /** Vector clock for versioning */
+    private vectorClock;
+    /** Metadata */
+    private metadata;
+    /** Sequence number for deltas */
+    private sequenceNumber;
+    /** Last delta clock for delta generation */
+    private lastDeltaClock;
+    /** Custom comparison function for timestamps */
+    private readonly compareTimestamp;
+    /**
+     * Create a new LWW-Register
+     *
+     * @param replicaId - Local replica identifier
+     * @param id - Unique register identifier
+     * @param initialValue - Optional initial value
+     * @param compareTimestamp - Optional custom timestamp comparison
+     */
+    constructor(replicaId: ReplicaId, id: string, initialValue?: T, compareTimestamp?: (a: WallTimestamp, b: WallTimestamp) => number);
+    /**
+     * Get the current value
+     *
+     * @returns Current value or undefined if not set
+     */
+    value(): T | undefined;
+    /**
+     * Set a new value with automatic timestamp
+     *
+     * @param value - New value to set
+     * @returns The set value
+     */
+    set(value: T): T;
+    /**
+     * Set a new value with explicit timestamp
+     *
+     * @param value - New value to set
+     * @param timestamp - Timestamp for this write
+     * @returns The set value
+     */
+    setWithTimestamp(value: T, timestamp: WallTimestamp): T;
+    /**
+     * Get the timestamp of the current value
+     *
+     * @returns Timestamp
+     */
+    getTimestamp(): WallTimestamp;
+    /**
+     * Get the replica that set the current value
+     *
+     * @returns Replica ID
+     */
+    getValueReplica(): ReplicaId;
+    /**
+     * Check if register has a value
+     *
+     * @returns True if value is set
+     */
+    hasValue(): boolean;
+    /**
+     * Clear the register value
+     *
+     * @returns Previous value
+     */
+    clear(): T | undefined;
+    /**
+     * Get the serializable state of this register
+     *
+     * @returns CRDT state
+     */
+    state(): CRDTState<SerializedLWWRegisterState<T>>;
+    /**
+     * Restore an LWW-Register from serialized state
+     *
+     * @param state - Serialized state
+     * @param replicaId - Local replica ID
+     * @returns Restored register
+     */
+    static fromState<T>(state: CRDTState<SerializedLWWRegisterState<T>>, replicaId: ReplicaId): LWWRegister<T>;
+    /**
+     * Determine if a new write should update the value
+     *
+     * @param newTimestamp - Timestamp of new value
+     * @param newReplica - Replica proposing new value
+     * @returns True if should update
+     */
+    private shouldUpdate;
+    /**
+     * Merge with another LWW-Register state
+     *
+     * The value with the highest timestamp wins.
+     * Equal timestamps are resolved by comparing replica IDs.
+     *
+     * @param other - Other register state to merge
+     * @returns Merge result
+     */
+    merge(other: CRDTState<SerializedLWWRegisterState<T>>): MergeResult<SerializedLWWRegisterState<T>>;
+    /**
+     * Generate a delta update since the last sync
+     *
+     * @param since - Vector clock of last sync (optional)
+     * @returns Delta update or null if no changes
+     */
+    generateDelta(since?: SerializedVectorClock): CRDTDelta<SerializedLWWRegisterState<T>> | null;
+    /**
+     * Apply a delta update
+     *
+     * @param delta - Delta to apply
+     * @returns True if applied successfully
+     */
+    applyDelta(delta: CRDTDelta<SerializedLWWRegisterState<T>>): boolean;
+    /**
+     * Create a deep copy of this register
+     *
+     * @returns Cloned register
+     */
+    clone(): LWWRegister<T>;
+    /**
+     * Get the register ID
+     *
+     * @returns Register ID
+     */
+    getId(): string;
+    /**
+     * Get the local replica ID
+     *
+     * @returns Replica ID
+     */
+    getReplicaId(): ReplicaId;
+    /**
+     * Get the vector clock
+     *
+     * @returns Vector clock copy
+     */
+    getVectorClock(): VectorClock;
+    /**
+     * Get metadata
+     *
+     * @returns Metadata copy
+     */
+    getMetadata(): CRDTMetadata;
+    /**
+     * Check if this register equals another
+     *
+     * @param other - Register to compare
+     * @returns True if values and timestamps are equal
+     */
+    equals(other: LWWRegister<T>): boolean;
+    /**
+     * String representation for debugging
+     *
+     * @returns Debug string
+     */
+    toString(): string;
+}
+//# sourceMappingURL=LWWRegister.d.ts.map

package/dist/edge/p2p/crdt/LWWRegister.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LWWRegister.d.ts","sourceRoot":"","sources":["../../../../src/edge/p2p/crdt/LWWRegister.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EACL,SAAS,EACT,aAAa,EAEb,SAAS,EACT,YAAY,EACZ,qBAAqB,EACrB,0BAA0B,EAC1B,WAAW,EAMX,SAAS,EAGT,IAAI,EAGL,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAM5C;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,WAAW,CAAC,CAAC,CAAE,YAAW,IAAI,CAAC,CAAC,GAAG,SAAS,EAAE,0BAA0B,CAAC,CAAC,CAAC,CAAC;IACvF,0CAA0C;IAC1C,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAS;IAE5B,uBAAuB;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IAEtC,oBAAoB;IACpB,OAAO,CAAC,YAAY,CAAgB;IAEpC,iCAAiC;IACjC,OAAO,CAAC,SAAS,CAAgB;IAEjC,qCAAqC;IACrC,OAAO,CAAC,YAAY,CAAY;IAEhC,kCAAkC;IAClC,OAAO,CAAC,WAAW,CAAc;IAEjC,eAAe;IACf,OAAO,CAAC,QAAQ,CAAe;IAE/B,iCAAiC;IACjC,OAAO,CAAC,cAAc,CAAS;IAE/B,4CAA4C;IAC5C,OAAO,CAAC,cAAc,CAAc;IAEpC,gDAAgD;IAChD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAiD;IAElF;;;;;;;OAOG;gBAED,SAAS,EAAE,SAAS,EACpB,EAAE,EAAE,MAAM,EACV,YAAY,CAAC,EAAE,CAAC,EAChB,gBAAgB,CAAC,EAAE,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,aAAa,KAAK,MAAM;IA6BnE;;;;OAIG;IACH,KAAK,IAAI,CAAC,GAAG,SAAS;IAItB;;;;;OAKG;IACH,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC;IAIhB;;;;;;OAMG;IACH,gBAAgB,CAAC,KAAK,EAAE,CAAC,EAAE,SAAS,EAAE,aAAa,GAAG,CAAC;IAmBvD;;;;OAIG;IACH,YAAY,IAAI,aAAa;IAI7B;;;;OAIG;IACH,eAAe,IAAI,SAAS;IAI5B;;;;OAIG;IACH,QAAQ,IAAI,OAAO;IAInB;;;;OAIG;IACH,KAAK,IAAI,CAAC,GAAG,SAAS;IAgBtB;;;;OAIG;IACH,KAAK,IAAI,SAAS,CAAC,0BAA0B,CAAC,CAAC,CAAC,CAAC;IAgBjD;;;;;;OAMG;IACH,MAAM,CAAC,SAAS,CAAC,CAAC,EAChB,KAAK,EAAE,SAAS,CAAC,0BAA0B,CAAC,CAAC,CAAC,CAAC,EAC/C,SAAS,EAAE,SAAS,GACnB,WAAW,CAAC,CAAC,CAAC;IAgCjB;;;;;;OAMG;IACH,OAAO,CAAC,YAAY;IAcpB;;;;;;;;OAQG;IACH,KAAK,CAAC,KAAK,EAAE,SAAS,CAAC,0BAA0B,CAAC,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,0BAA0B,CAAC,CAAC,CAAC,CAAC;IA+FlG;;;;;OAKG;IACH,aAAa,CAAC,KAAK,CAAC,EAAE,qBAAqB,GAAG,SAAS,CAAC,0BAA0B,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI;IAsC7F;;;;;OAKG;IACH,UAAU,CAAC,KAAK,EAAE,SAAS,CAAC,0BAA0B,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO;IAuCpE;;;;OAIG;IACH,KAAK,IAAI,WAAW,CAAC,CAAC,CAAC;IAYvB;;;;OAIG;IACH,KAAK,IAAI,MAAM;IAIf;;;;OAIG;IACH,YAAY,IAAI,SAAS;IAIzB;;;;OAIG;IACH,cAAc,IAAI,WAAW;IAI7B;;;;OAIG;IACH,WAAW,IAAI,YAAY;IAI3B;;;;;OAKG;IACH,MAAM,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,OAAO;IAiBtC;;;;OAIG;IACH,QAAQ,IAAI,MAAM;CAMnB"}

package/dist/edge/p2p/crdt/LWWRegister.js

@@ -0,0 +1,456 @@
+"use strict";
+/**
+ * LWW-Register (Last-Writer-Wins Register) CRDT Implementation
+ *
+ * A state-based CRDT that resolves conflicts using timestamps.
+ * The most recent write (highest timestamp) wins during merge.
+ * Replica ID is used as a tiebreaker for equal timestamps.
+ *
+ * @module edge/p2p/crdt/LWWRegister
+ * @version 1.0.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LWWRegister = void 0;
+const types_1 = require("./types");
+const VectorClock_1 = require("./VectorClock");
+// ============================================
+// LWWRegister Class
+// ============================================
+/**
+ * Last-Writer-Wins Register CRDT.
+ *
+ * Properties:
+ * - Stores a single value with associated timestamp
+ * - Conflicts resolved by comparing timestamps
+ * - Higher replica ID wins ties (deterministic)
+ * - Strongly eventually consistent
+ *
+ * @example
+ * ```typescript
+ * const register = new LWWRegister<string>('replica-1', 'name');
+ *
+ * register.set('Alice');
+ * register.set('Bob');
+ *
+ * console.log(register.value()); // 'Bob'
+ *
+ * // Merge with remote state
+ * register.merge(remoteState);
+ * ```
+ */
+class LWWRegister {
+    /**
+     * Create a new LWW-Register
+     *
+     * @param replicaId - Local replica identifier
+     * @param id - Unique register identifier
+     * @param initialValue - Optional initial value
+     * @param compareTimestamp - Optional custom timestamp comparison
+     */
+    constructor(replicaId, id, initialValue, compareTimestamp) {
+        this.id = id;
+        this.replicaId = replicaId;
+        this.currentValue = initialValue;
+        this.timestamp = initialValue !== undefined ? Date.now() : 0;
+        this.valueReplica = replicaId;
+        this.vectorClock = new VectorClock_1.VectorClock(replicaId);
+        this.sequenceNumber = 0;
+        this.lastDeltaClock = this.vectorClock.clone();
+        this.compareTimestamp = compareTimestamp ?? ((a, b) => a - b);
+        const now = Date.now();
+        this.metadata = {
+            createdAt: now,
+            updatedAt: now,
+            mergeCount: 0,
+            lastModifiedBy: replicaId,
+        };
+        if (initialValue !== undefined) {
+            this.vectorClock.increment();
+        }
+    }
+    // ============================================
+    // Core Operations
+    // ============================================
+    /**
+     * Get the current value
+     *
+     * @returns Current value or undefined if not set
+     */
+    value() {
+        return this.currentValue;
+    }
+    /**
+     * Set a new value with automatic timestamp
+     *
+     * @param value - New value to set
+     * @returns The set value
+     */
+    set(value) {
+        return this.setWithTimestamp(value, Date.now());
+    }
+    /**
+     * Set a new value with explicit timestamp
+     *
+     * @param value - New value to set
+     * @param timestamp - Timestamp for this write
+     * @returns The set value
+     */
+    setWithTimestamp(value, timestamp) {
+        // For local writes, always accept if timestamp is >= current
+        // (same replica can always update its own value)
+        // For remote writes (via merge), use shouldUpdate for proper LWW semantics
+        const shouldAccept = timestamp >= this.timestamp;
+        if (shouldAccept) {
+            this.currentValue = value;
+            this.timestamp = timestamp;
+            this.valueReplica = this.replicaId;
+            this.vectorClock.increment();
+            this.metadata.updatedAt = Date.now();
+            this.metadata.lastModifiedBy = this.replicaId;
+            this.sequenceNumber++;
+        }
+        return this.currentValue;
+    }
+    /**
+     * Get the timestamp of the current value
+     *
+     * @returns Timestamp
+     */
+    getTimestamp() {
+        return this.timestamp;
+    }
+    /**
+     * Get the replica that set the current value
+     *
+     * @returns Replica ID
+     */
+    getValueReplica() {
+        return this.valueReplica;
+    }
+    /**
+     * Check if register has a value
+     *
+     * @returns True if value is set
+     */
+    hasValue() {
+        return this.currentValue !== undefined;
+    }
+    /**
+     * Clear the register value
+     *
+     * @returns Previous value
+     */
+    clear() {
+        const prev = this.currentValue;
+        this.currentValue = undefined;
+        this.timestamp = Date.now();
+        this.valueReplica = this.replicaId;
+        this.vectorClock.increment();
+        this.metadata.updatedAt = Date.now();
+        this.metadata.lastModifiedBy = this.replicaId;
+        this.sequenceNumber++;
+        return prev;
+    }
+    // ============================================
+    // State Management
+    // ============================================
+    /**
+     * Get the serializable state of this register
+     *
+     * @returns CRDT state
+     */
+    state() {
+        return {
+            type: types_1.CRDTType.LWWRegister,
+            id: this.id,
+            vectorClock: this.vectorClock.serialize(),
+            origin: this.replicaId,
+            value: {
+                value: this.currentValue,
+                timestamp: this.timestamp,
+                replica: this.valueReplica,
+            },
+            metadata: { ...this.metadata },
+            stateVersion: 1,
+        };
+    }
+    /**
+     * Restore an LWW-Register from serialized state
+     *
+     * @param state - Serialized state
+     * @param replicaId - Local replica ID
+     * @returns Restored register
+     */
+    static fromState(state, replicaId) {
+        if (state.type !== types_1.CRDTType.LWWRegister) {
+            throw new types_1.CRDTError(`Invalid CRDT type: expected ${types_1.CRDTType.LWWRegister}, got ${state.type}`, types_1.CRDTErrorCode.InvalidType, state.id);
+        }
+        const register = new LWWRegister(replicaId, state.id);
+        // Restore value
+        register.currentValue = state.value.value;
+        register.timestamp = state.value.timestamp;
+        register.valueReplica = state.value.replica;
+        // Restore vector clock
+        register.vectorClock = VectorClock_1.VectorClock.fromSerialized(state.vectorClock, replicaId);
+        // Restore metadata
+        register.metadata = { ...state.metadata };
+        return register;
+    }
+    // ============================================
+    // Merge Operations
+    // ============================================
+    /**
+     * Determine if a new write should update the value
+     *
+     * @param newTimestamp - Timestamp of new value
+     * @param newReplica - Replica proposing new value
+     * @returns True if should update
+     */
+    shouldUpdate(newTimestamp, newReplica) {
+        const cmp = this.compareTimestamp(newTimestamp, this.timestamp);
+        if (cmp > 0) {
+            // New timestamp is higher
+            return true;
+        }
+        else if (cmp === 0) {
+            // Equal timestamps, use replica ID as tiebreaker
+            return newReplica > this.valueReplica;
+        }
+        return false;
+    }
+    /**
+     * Merge with another LWW-Register state
+     *
+     * The value with the highest timestamp wins.
+     * Equal timestamps are resolved by comparing replica IDs.
+     *
+     * @param other - Other register state to merge
+     * @returns Merge result
+     */
+    merge(other) {
+        const startTime = Date.now();
+        const conflicts = [];
+        if (other.type !== types_1.CRDTType.LWWRegister) {
+            throw new types_1.CRDTError(`Cannot merge different CRDT types`, types_1.CRDTErrorCode.InvalidType, this.id);
+        }
+        if (other.id !== this.id) {
+            throw new types_1.CRDTError(`Cannot merge different CRDT instances`, types_1.CRDTErrorCode.InvalidState, this.id);
+        }
+        const otherValue = other.value;
+        let localChanged = false;
+        // Check for concurrent writes (potential conflict)
+        const otherClock = VectorClock_1.VectorClock.fromSerialized(other.vectorClock, this.replicaId);
+        if (this.vectorClock.isConcurrent(otherClock)) {
+            // Record conflict
+            const conflict = {
+                conflictId: `${this.id}-${Date.now()}`,
+                crdtId: this.id,
+                conflictType: types_1.ConflictType.ConcurrentUpdate,
+                field: 'value',
+                localValue: this.currentValue,
+                remoteValue: otherValue.value,
+                localClock: this.vectorClock.serialize(),
+                remoteClock: other.vectorClock,
+                detectedAt: Date.now(),
+            };
+            // Determine winner
+            const winner = this.shouldUpdate(otherValue.timestamp, otherValue.replica)
+                ? 'remote'
+                : 'local';
+            conflict.resolution = {
+                strategy: types_1.ResolutionStrategy.LastWriterWins,
+                resolvedValue: winner === 'remote' ? otherValue.value : this.currentValue,
+                winner: winner === 'remote' ? otherValue.replica : this.valueReplica,
+                reason: `LWW: ${winner} has ${winner === 'remote' ? 'later' : 'earlier or equal'} timestamp`,
+                automatic: true,
+                resolvedAt: Date.now(),
+            };
+            conflicts.push(conflict);
+        }
+        // Apply LWW merge
+        if (this.shouldUpdate(otherValue.timestamp, otherValue.replica)) {
+            this.currentValue = otherValue.value;
+            this.timestamp = otherValue.timestamp;
+            this.valueReplica = otherValue.replica;
+            localChanged = true;
+        }
+        // Merge vector clocks
+        this.vectorClock.merge(otherClock);
+        // Update metadata
+        this.metadata.mergeCount++;
+        this.metadata.updatedAt = Date.now();
+        if (localChanged) {
+            this.metadata.lastModifiedBy = other.origin;
+        }
+        const stats = {
+            duration: Date.now() - startTime,
+            entriesMerged: 1,
+            autoResolved: conflicts.length,
+            tombstonesProcessed: 0,
+            memoryDelta: 0,
+        };
+        return {
+            success: true,
+            mergedState: this.state(),
+            localChanged,
+            conflicts,
+            stats,
+        };
+    }
+    // ============================================
+    // Delta Operations
+    // ============================================
+    /**
+     * Generate a delta update since the last sync
+     *
+     * @param since - Vector clock of last sync (optional)
+     * @returns Delta update or null if no changes
+     */
+    generateDelta(since) {
+        const sinceClock = since
+            ? VectorClock_1.VectorClock.fromSerialized(since, this.replicaId)
+            : this.lastDeltaClock;
+        // Check if there are any changes
+        if (!this.vectorClock.happenedAfter(sinceClock) &&
+            !this.vectorClock.isConcurrent(sinceClock)) {
+            return null;
+        }
+        const operations = [{
+                op: types_1.DeltaOpType.Set,
+                value: {
+                    value: this.currentValue,
+                    timestamp: this.timestamp,
+                    replica: this.valueReplica,
+                },
+                timestamp: this.timestamp,
+                replica: this.valueReplica,
+            }];
+        const delta = {
+            crdtId: this.id,
+            type: types_1.CRDTType.LWWRegister,
+            origin: this.replicaId,
+            vectorClock: this.vectorClock.serialize(),
+            operations,
+            sequenceNumber: this.sequenceNumber,
+            generatedAt: Date.now(),
+        };
+        // Update last delta clock
+        this.lastDeltaClock = this.vectorClock.clone();
+        return delta;
+    }
+    /**
+     * Apply a delta update
+     *
+     * @param delta - Delta to apply
+     * @returns True if applied successfully
+     */
+    applyDelta(delta) {
+        if (delta.type !== types_1.CRDTType.LWWRegister) {
+            return false;
+        }
+        if (delta.crdtId !== this.id) {
+            return false;
+        }
+        let changed = false;
+        for (const op of delta.operations) {
+            if (op.op === types_1.DeltaOpType.Set && op.value && op.timestamp && op.replica) {
+                if (this.shouldUpdate(op.timestamp, op.replica)) {
+                    this.currentValue = op.value.value;
+                    this.timestamp = op.timestamp;
+                    this.valueReplica = op.replica;
+                    changed = true;
+                }
+            }
+        }
+        if (changed) {
+            const deltaClock = VectorClock_1.VectorClock.fromSerialized(delta.vectorClock, this.replicaId);
+            this.vectorClock.merge(deltaClock);
+            this.metadata.updatedAt = Date.now();
+            this.metadata.lastModifiedBy = delta.origin;
+        }
+        return changed;
+    }
+    // ============================================
+    // Utility Methods
+    // ============================================
+    /**
+     * Create a deep copy of this register
+     *
+     * @returns Cloned register
+     */
+    clone() {
+        const cloned = new LWWRegister(this.replicaId, this.id);
+        cloned.currentValue = this.currentValue;
+        cloned.timestamp = this.timestamp;
+        cloned.valueReplica = this.valueReplica;
+        cloned.vectorClock = this.vectorClock.clone();
+        cloned.metadata = { ...this.metadata };
+        cloned.sequenceNumber = this.sequenceNumber;
+        cloned.lastDeltaClock = this.lastDeltaClock.clone();
+        return cloned;
+    }
+    /**
+     * Get the register ID
+     *
+     * @returns Register ID
+     */
+    getId() {
+        return this.id;
+    }
+    /**
+     * Get the local replica ID
+     *
+     * @returns Replica ID
+     */
+    getReplicaId() {
+        return this.replicaId;
+    }
+    /**
+     * Get the vector clock
+     *
+     * @returns Vector clock copy
+     */
+    getVectorClock() {
+        return this.vectorClock.clone();
+    }
+    /**
+     * Get metadata
+     *
+     * @returns Metadata copy
+     */
+    getMetadata() {
+        return { ...this.metadata };
+    }
+    /**
+     * Check if this register equals another
+     *
+     * @param other - Register to compare
+     * @returns True if values and timestamps are equal
+     */
+    equals(other) {
+        if (this.id !== other.id) {
+            return false;
+        }
+        if (this.timestamp !== other.timestamp) {
+            return false;
+        }
+        if (this.valueReplica !== other.valueReplica) {
+            return false;
+        }
+        // Deep compare values
+        return JSON.stringify(this.currentValue) === JSON.stringify(other.currentValue);
+    }
+    /**
+     * String representation for debugging
+     *
+     * @returns Debug string
+     */
+    toString() {
+        const valueStr = this.currentValue !== undefined
+            ? JSON.stringify(this.currentValue).slice(0, 50)
+            : 'undefined';
+        return `LWWRegister{id=${this.id}, value=${valueStr}, ts=${this.timestamp}, replica=${this.valueReplica}}`;
+    }
+}
+exports.LWWRegister = LWWRegister;
+//# sourceMappingURL=LWWRegister.js.map

package/dist/edge/p2p/crdt/LWWRegister.js.map

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