@kedataindo/docflow-core 0.0.34 → 0.0.35

package/dist/index.cjs

@@ -201,6 +201,24 @@ function createCollaboration(options) {
     awareness.on("change", notify);
     notify();
   }
+  const readyParts = [];
+  if (persistence) {
+    readyParts.push(
+      persistence.whenSynced.then(
+        () => void 0,
+        () => void 0
+      )
+    );
+  }
+  if (provider && options.provider === "websocket") {
+    const ws = provider;
+    readyParts.push(
+      new Promise((resolve) => {
+        ws.once("sync", () => resolve());
+      })
+    );
+  }
+  const whenReady = readyParts.length === 0 ? Promise.resolve() : Promise.all(readyParts).then(() => void 0);
   const destroy = () => {
     if (awarenessHandler) {
       awareness.off("change", awarenessHandler);
@@ -211,7 +229,7 @@ function createCollaboration(options) {
     void persistence?.destroy();
     ydoc.destroy();
   };
-  return { ydoc, provider, awareness, persistence, destroy, setLocalCursorEnabled };
+  return { ydoc, provider, awareness, persistence, whenReady, destroy, setLocalCursorEnabled };
 }
 function collaborationExtensions(options) {
   const setup = "ydoc" in options ? options : createCollaboration(options);

package/dist/index.d.cts

@@ -99,6 +99,16 @@ interface CollaborationSetup {
      * use it as a seed source.
      */
     persistence?: IndexeddbPersistence;
+    /**
+     * Issue #117 — resolves after BOTH the offline mirror (if `offline`) AND
+     * the provider's first sync (if `websocket`) have completed. Hosts MUST
+     * `await setup.whenReady` before binding the editor, otherwise the
+     * TipTap view can render against the IndexedDB cache before the
+     * authoritative server state arrives, briefly showing — and on a
+     * disconnected peer potentially re-broadcasting — nodes the server has
+     * since deleted. Resolves immediately when neither side applies.
+     */
+    whenReady: Promise<void>;
     destroy: () => void;
     /**
      * Phase 9 PR2 — toggle the local cursor emission + present flag.

package/dist/index.d.ts

@@ -99,6 +99,16 @@ interface CollaborationSetup {
      * use it as a seed source.
      */
     persistence?: IndexeddbPersistence;
+    /**
+     * Issue #117 — resolves after BOTH the offline mirror (if `offline`) AND
+     * the provider's first sync (if `websocket`) have completed. Hosts MUST
+     * `await setup.whenReady` before binding the editor, otherwise the
+     * TipTap view can render against the IndexedDB cache before the
+     * authoritative server state arrives, briefly showing — and on a
+     * disconnected peer potentially re-broadcasting — nodes the server has
+     * since deleted. Resolves immediately when neither side applies.
+     */
+    whenReady: Promise<void>;
     destroy: () => void;
     /**
      * Phase 9 PR2 — toggle the local cursor emission + present flag.

package/dist/index.js

@@ -143,6 +143,24 @@ function createCollaboration(options) {
     awareness.on("change", notify);
     notify();
   }
+  const readyParts = [];
+  if (persistence) {
+    readyParts.push(
+      persistence.whenSynced.then(
+        () => void 0,
+        () => void 0
+      )
+    );
+  }
+  if (provider && options.provider === "websocket") {
+    const ws = provider;
+    readyParts.push(
+      new Promise((resolve) => {
+        ws.once("sync", () => resolve());
+      })
+    );
+  }
+  const whenReady = readyParts.length === 0 ? Promise.resolve() : Promise.all(readyParts).then(() => void 0);
   const destroy = () => {
     if (awarenessHandler) {
       awareness.off("change", awarenessHandler);
@@ -153,7 +171,7 @@ function createCollaboration(options) {
     void persistence?.destroy();
     ydoc.destroy();
   };
-  return { ydoc, provider, awareness, persistence, destroy, setLocalCursorEnabled };
+  return { ydoc, provider, awareness, persistence, whenReady, destroy, setLocalCursorEnabled };
 }
 function collaborationExtensions(options) {
   const setup = "ydoc" in options ? options : createCollaboration(options);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@kedataindo/docflow-core",
   "license": "UNLICENSED",
-  "version": "0.0.34",
+  "version": "0.0.35",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",