@loro-dev/flock-wasm 0.1.2 → 0.1.4

package/bundler/flock_wasm.d.ts

@@ -120,8 +120,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
    *
@@ -231,8 +234,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/bundler/flock_wasm_bg.js

@@ -438,8 +438,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
      *
@@ -625,8 +628,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/bundler/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/bundler/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());

package/nodejs/flock_wasm.d.ts

@@ -120,8 +120,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
    *
@@ -231,8 +234,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/nodejs/flock_wasm.js

@@ -434,8 +434,11 @@ 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
      *
@@ -621,8 +624,10 @@ 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/nodejs/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/nodejs/index.js

@@ -655,9 +655,11 @@ 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.
      */
@@ -665,10 +667,13 @@ 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());

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@loro-dev/flock-wasm",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "WASM bindings for flock-rs.",
   "type": "module",
   "sideEffects": false,
@@ -30,6 +30,7 @@
   "devDependencies": {
     "@types/node": "^22.0.0",
     "typescript": "^5.9.0",
+    "vite-plugin-wasm": "^3.5.0",
     "vitest": "^3.2.4"
   },
   "license": "AGPL-3.0-only",

package/web/flock_wasm.d.ts

@@ -120,8 +120,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
    *
@@ -231,8 +234,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/web/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/web/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/web/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());