@loro-dev/flock-wasm 0.1.2 → 0.1.3

package/bundler/flock_wasm.d.ts

@@ -1,12 +1,5 @@
 /* tslint:disable */
 /* eslint-disable */
-/**
- * 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(): void;
 /**
  * Drains the pending callback queue, invoking all enqueued callbacks.
  *
@@ -17,6 +10,13 @@ export function start(): void;
  * the error is propagated to JavaScript after the current batch completes.
  */
 export function callPendingEvents(): void;
+/**
+ * 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(): void;
 /**
  * The main WASM-exposed flock instance.
  *
@@ -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

@@ -205,16 +205,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.
  *
@@ -228,6 +218,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);
@@ -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

@@ -1,12 +1,5 @@
 /* tslint:disable */
 /* eslint-disable */
-/**
- * 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(): void;
 /**
  * Drains the pending callback queue, invoking all enqueued callbacks.
  *
@@ -17,6 +10,13 @@ export function start(): void;
  * the error is propagated to JavaScript after the current batch completes.
  */
 export function callPendingEvents(): void;
+/**
+ * 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(): void;
 /**
  * The main WASM-exposed flock instance.
  *
@@ -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

@@ -201,16 +201,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.
- */
-module.exports.start = function() {
-    wasm.start();
-};
-
 /**
  * Drains the pending callback queue, invoking all enqueued callbacks.
  *
@@ -224,6 +214,16 @@ module.exports.callPendingEvents = function() {
     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.
+ */
+module.exports.start = function() {
+    wasm.start();
+};
+
 function takeFromExternrefTable0(idx) {
     const value = wasm.__wbindgen_export_4.get(idx);
     wasm.__externref_table_dealloc(idx);
@@ -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.3",
   "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

@@ -1,12 +1,5 @@
 /* tslint:disable */
 /* eslint-disable */
-/**
- * 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(): void;
 /**
  * Drains the pending callback queue, invoking all enqueued callbacks.
  *
@@ -17,6 +10,13 @@ export function start(): void;
  * the error is propagated to JavaScript after the current batch completes.
  */
 export function callPendingEvents(): void;
+/**
+ * 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(): void;
 /**
  * The main WASM-exposed flock instance.
  *
@@ -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

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