@loro-dev/flock-wasm 0.1.1 → 0.1.3

package/base64/flock_wasm.js

@@ -197,16 +197,6 @@ function debugString(val) {
     // TODO we could test for more things here, like `Set`s and `Map`s.
     return className;
 }
-/**
- * Initializes the WASM module.
- *
- * This function is automatically called when the WASM module is loaded.
- * It sets up the panic hook to route Rust panics to the JavaScript console.
- */
-export function start() {
-    wasm.start();
-}
-
 /**
  * Drains the pending callback queue, invoking all enqueued callbacks.
  *
@@ -220,6 +210,16 @@ export function callPendingEvents() {
     wasm.callPendingEvents();
 }
 
+/**
+ * Initializes the WASM module.
+ *
+ * This function is automatically called when the WASM module is loaded.
+ * It sets up the panic hook to route Rust panics to the JavaScript console.
+ */
+export function start() {
+    wasm.start();
+}
+
 function takeFromExternrefTable0(idx) {
     const value = wasm.__wbindgen_export_4.get(idx);
     wasm.__externref_table_dealloc(idx);
@@ -430,8 +430,11 @@ export class RawFlock {
     /**
      * Returns the inclusive version vector for this flock.
      *
-     * The inclusive version includes all peers ever seen, even if their
-     * entries have been overridden by other peers.
+     * This vector tracks max seen clocks per peer for the current process
+     * lifetime (open/import/local writes), including peers that may no longer
+     * own visible entries.
+     *
+     * Use this vector for completeness checks, not incremental export baselines.
      *
      * # Errors
      *
@@ -617,8 +620,10 @@ export class RawFlock {
     /**
      * Returns the exclusive version vector for this flock.
      *
-     * The exclusive version only includes peers that have at least one entry
-     * in the current state (excluding tombstones and overridden entries).
+     * This vector only includes peers that currently own at least one visible
+     * entry (excluding tombstones and shadowed entries).
+     *
+     * Use this vector as the baseline for incremental export/replication.
      *
      * # Errors
      *

package/base64/index.d.ts

@@ -156,18 +156,23 @@ export declare class Flock {
     getEntry(key: KeyPart[]): EntryInfo | undefined;
     merge(other: Flock): void;
     /**
-     * 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.
+     * Returns the exclusive/visible version vector.
+     *
+     * Only peers that currently own at least one visible entry are included.
+     * This vector is consistent with current visible state and is the correct
+     * baseline for incremental export/replication.
      *
      * Use this version when sending to other peers for incremental sync.
      */
     version(): VersionVector;
     /**
-     * Returns the inclusive version vector, which includes all peers ever seen,
-     * even if their entries have been overridden by other peers.
+     * Returns the inclusive/max-seen version vector.
+     *
+     * Tracks max seen clocks per peer for this process lifetime
+     * (open/import/local writes), including peers that may no longer own visible
+     * entries.
      *
-     * Use this version when checking if you have received all data from another peer.
+     * Use this version for completeness checks, not incremental export baselines.
      */
     inclusiveVersion(): VersionVector;
     private exportJsonInternal;

package/base64/index.js

@@ -1,5 +1,5 @@
-import { RawFlock, callPendingEvents } from "./wasm";
-import { EventBatcher } from "./event-batcher";
+import { RawFlock, callPendingEvents } from "./wasm.js";
+import { EventBatcher } from "./event-batcher.js";
 export function encodeVersionVector(vector) {
     return encodeVersionVectorBinary(vector);
 }
@@ -650,9 +650,11 @@ export class Flock {
         void this.inner.merge(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.
+     * Returns the exclusive/visible version vector.
+     *
+     * Only peers that currently own at least one visible entry are included.
+     * This vector is consistent with current visible state and is the correct
+     * baseline for incremental export/replication.
      *
      * Use this version when sending to other peers for incremental sync.
      */
@@ -660,10 +662,13 @@ export class Flock {
         return decodeVersionVectorFromRaw(this.inner.version());
     }
     /**
-     * Returns the inclusive version vector, which includes all peers ever seen,
-     * even if their entries have been overridden by other peers.
+     * Returns the inclusive/max-seen version vector.
+     *
+     * Tracks max seen clocks per peer for this process lifetime
+     * (open/import/local writes), including peers that may no longer own visible
+     * entries.
      *
-     * Use this version when checking if you have received all data from another peer.
+     * Use this version for completeness checks, not incremental export baselines.
      */
     inclusiveVersion() {
         return decodeVersionVectorFromRaw(this.inner.inclusiveVersion());