@loro-dev/flock 4.0.0 → 4.2.0

package/src/index.ts

@@ -11,6 +11,7 @@ import {
   import_json_ffi,
   import_json_str_ffi,
   version_ffi,
+  inclusiveVersion_ffi,
   get_max_physical_time_ffi,
   peer_id_ffi,
   kv_to_json_ffi,
@@ -372,16 +373,19 @@ function decodeUnsignedLeb128(
   offset: number,
 ): [number, number] {
   let result = 0;
-  let shift = 0;
+  let multiplier = 1;
   let consumed = 0;
   while (offset + consumed < bytes.length) {
     const byte = bytes[offset + consumed];
     consumed += 1;
-    result |= (byte & 0x7f) << shift;
+    // Use arithmetic instead of bitwise operations to avoid 32-bit overflow.
+    // JavaScript bitwise operators convert to 32-bit signed integers,
+    // which breaks for values >= 2^31.
+    result += (byte & 0x7f) * multiplier;
     if ((byte & 0x80) === 0) {
       break;
     }
-    shift += 7;
+    multiplier *= 128;
   }
   return [result, consumed];
 }
@@ -967,10 +971,27 @@ export class Flock {
     merge(this.inner, other.inner);
   }
 
+  /**
+   * Returns the exclusive version vector, which only includes peers that have
+   * at least one entry in the current state. This is consistent with the state
+   * after export and re-import.
+   *
+   * Use this version when sending to other peers for incremental sync.
+   */
   version(): VersionVector {
     return decodeVersionVectorFromRaw(version_ffi(this.inner));
   }
 
+  /**
+   * Returns the inclusive version vector, which includes all peers ever seen,
+   * even if their entries have been overridden by other peers.
+   *
+   * Use this version when checking if you have received all data from another peer.
+   */
+  inclusiveVersion(): VersionVector {
+    return decodeVersionVectorFromRaw(inclusiveVersion_ffi(this.inner));
+  }
+
   private exportJsonInternal(
     from?: VersionVector,
     pruneTombstonesBefore?: number,