@yorkie-js/sdk 0.7.10 → 0.7.11-rc

package/dist/yorkie-js-sdk.d.ts

@@ -495,6 +495,18 @@ declare class ChangeID {
      * doesn't have logical clocks, this ID is returned.
      */
     syncClocks(other: ChangeID): ChangeID;
+    /**
+     * `syncLamport` advances the lamport clock against the given ID without
+     * merging its version vector into the receiver's. It is the counterpart
+     * of `syncClocks` for attachments that have opted out of GC participation
+     * (see docs/design/disable-gc-on-attach.md in the server repo): the
+     * receiver does not need other actors' entries in its VV because it
+     * never produces or consumes tombstones, and dropping them keeps each
+     * subsequent local Change's VV at O(1) instead of O(num_actors).
+     * Lamport must still advance so that TimeTickets produced locally
+     * remain ordered against remote operations.
+     */
+    syncLamport(other: ChangeID): ChangeID;
     /**
      * `setClocks` sets the given clocks to this ID. This is used when the snapshot
      * is given from the server.
@@ -2925,6 +2937,7 @@ declare class Document_2<R, P extends Indexable = Indexable> implements Attachab
     private onlineClients;
     private eventStream;
     private eventStreamObserver;
+    private disableGC;
     /**
      * `history` is exposed to the user to manage undo/redo operations.
      */
@@ -3033,6 +3046,12 @@ declare class Document_2<R, P extends Indexable = Indexable> implements Attachab
      * changes the document has.
      */
     setActor(actorID: ActorID): void;
+    /**
+     * `setDisableGC` records whether this document participates in GC. The
+     * client calls this on attach so subsequent applyChange runs use the
+     * lamport-only sync path.
+     */
+    setDisableGC(disableGC: boolean): void;
     /**
      * `isEnableDevtools` returns whether devtools is enabled or not.
      */

package/dist/yorkie-js-sdk.es.js

@@ -13766,6 +13766,26 @@ class ChangeID {
     newID.versionVector.set(this.actor, lamport);
     return newID;
   }
+  /**
+   * `syncLamport` advances the lamport clock against the given ID without
+   * merging its version vector into the receiver's. It is the counterpart
+   * of `syncClocks` for attachments that have opted out of GC participation
+   * (see docs/design/disable-gc-on-attach.md in the server repo): the
+   * receiver does not need other actors' entries in its VV because it
+   * never produces or consumes tombstones, and dropping them keeps each
+   * subsequent local Change's VV at O(1) instead of O(num_actors).
+   * Lamport must still advance so that TimeTickets produced locally
+   * remain ordered against remote operations.
+   */
+  syncLamport(other) {
+    if (!other.hasClocks()) {
+      return this;
+    }
+    const lamport = other.lamport > this.lamport ? other.lamport + 1n : this.lamport + 1n;
+    const vector = this.versionVector.deepcopy();
+    vector.set(this.actor, lamport);
+    return new ChangeID(this.clientSeq, lamport, this.actor, vector);
+  }
   /**
    * `setClocks` sets the given clocks to this ID. This is used when the snapshot
    * is given from the server.
@@ -19642,6 +19662,12 @@ class Document {
   onlineClients;
   eventStream;
   eventStreamObserver;
+  // `disableGC`, when true, declares that this document does not produce or
+  // consume tombstones (see disable-gc-on-attach in the server repo). It is
+  // set by the client on Attach and consumed by applyChange to skip merging
+  // remote actors' version vectors into changeID, keeping each subsequent
+  // local Change's VV at O(1) for high-fan-out Counter workloads.
+  disableGC;
   /**
    * `history` is exposed to the user to manage undo/redo operations.
    */
@@ -19655,6 +19681,7 @@ class Document {
     this.changeID = InitialChangeID;
     this.checkpoint = InitialCheckpoint;
     this.localChanges = [];
+    this.disableGC = false;
     this.root = CRDTRoot.create();
     this.presences = /* @__PURE__ */ new Map();
     this.onlineClients = /* @__PURE__ */ new Set();
@@ -20063,6 +20090,14 @@ class Document {
     }
     this.changeID = this.changeID.setActor(actorID);
   }
+  /**
+   * `setDisableGC` records whether this document participates in GC. The
+   * client calls this on attach so subsequent applyChange runs use the
+   * lamport-only sync path.
+   */
+  setDisableGC(disableGC) {
+    this.disableGC = disableGC;
+  }
   /**
    * `isEnableDevtools` returns whether devtools is enabled or not.
    */
@@ -20301,7 +20336,7 @@ class Document {
         );
       }
     }
-    this.changeID = this.changeID.syncClocks(change.getID());
+    this.changeID = this.disableGC ? this.changeID.syncLamport(change.getID()) : this.changeID.syncClocks(change.getID());
     if (opInfos.length) {
       const rawChange = this.isEnableDevtools() ? change.toStruct() : void 0;
       events.push(
@@ -20984,7 +21019,7 @@ function createAuthInterceptor(apiKey, token) {
   };
 }
 const name = "@yorkie-js/sdk";
-const version = "0.7.10";
+const version = "0.7.11-rc";
 const pkg = {
   name,
   version
@@ -21545,6 +21580,7 @@ class Client {
           doc.setSchemaRules(converter.fromSchemaRules(res.schemaRules));
         }
         const pack = converter.fromChangePack(res.changePack);
+        doc.setDisableGC(opts.disableGC ?? false);
         doc.applyChangePack(pack);
         if (doc.getStatus() === DocStatus.Removed) {
           return doc;