@loro-dev/flock-wasm 0.1.2 → 0.1.4

package/base64/flock_wasm.js

@@ -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

@@ -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());