@kedataindo/docflow-core 0.0.34 → 0.0.36

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);
@@ -1523,7 +1541,7 @@ function createEditor(options = {}) {
     content: options.content ? migrateContent(options.content) : options.content
   };
   const plugins = migratedOptions.plugins ?? [];
-  const collaborationSetup = migratedOptions.collaboration ? createCollaboration(migratedOptions.collaboration) : void 0;
+  const collaborationSetup = !migratedOptions.collaboration ? void 0 : "ydoc" in migratedOptions.collaboration ? migratedOptions.collaboration : createCollaboration(migratedOptions.collaboration);
   const performanceMonitor = migratedOptions.debug ? createPerformanceMonitor() : void 0;
   let tiptapEditor = createTiptapEditor(migratedOptions, plugins, collaborationSetup);
   let pluginActions = createActionMap(tiptapEditor, plugins);

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.
@@ -191,7 +201,7 @@ interface EditorOptions {
     plugins?: DocsEditorPlugin[];
     editable?: boolean;
     onUpdate?: (json: object) => void;
-    collaboration?: CollaborationOptions;
+    collaboration?: CollaborationOptions | CollaborationSetup;
     getPageMap?: () => Map<number, {
         page: number;
         blockIndex: number;

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.
@@ -191,7 +201,7 @@ interface EditorOptions {
     plugins?: DocsEditorPlugin[];
     editable?: boolean;
     onUpdate?: (json: object) => void;
-    collaboration?: CollaborationOptions;
+    collaboration?: CollaborationOptions | CollaborationSetup;
     getPageMap?: () => Map<number, {
         page: number;
         blockIndex: number;

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);
@@ -1465,7 +1483,7 @@ function createEditor(options = {}) {
     content: options.content ? migrateContent(options.content) : options.content
   };
   const plugins = migratedOptions.plugins ?? [];
-  const collaborationSetup = migratedOptions.collaboration ? createCollaboration(migratedOptions.collaboration) : void 0;
+  const collaborationSetup = !migratedOptions.collaboration ? void 0 : "ydoc" in migratedOptions.collaboration ? migratedOptions.collaboration : createCollaboration(migratedOptions.collaboration);
   const performanceMonitor = migratedOptions.debug ? createPerformanceMonitor() : void 0;
   let tiptapEditor = createTiptapEditor(migratedOptions, plugins, collaborationSetup);
   let pluginActions = createActionMap(tiptapEditor, plugins);

package/package.json

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