@kedataindo/docflow-core 0.0.71 → 0.0.72

package/dist/index.js

@@ -10,6 +10,10 @@ import {
   trimContextAfter,
   trimContextBefore
 } from "./chunk-HMOWKFPE.js";
+import {
+  collaborationExtensions,
+  createCollaboration
+} from "./chunk-XJG72F7M.js";
 
 // src/Editor.ts
 import { Extension as Extension5, Editor as TiptapEditor } from "@tiptap/core";
@@ -64,143 +68,6 @@ function createActionMap(editor, plugins) {
   return map;
 }
 
-// src/Collaboration.ts
-import { Collaboration } from "@tiptap/extension-collaboration";
-import { CollaborationCursor } from "@tiptap/extension-collaboration-cursor";
-import { Awareness } from "y-protocols/awareness";
-import { IndexeddbPersistence } from "y-indexeddb";
-import { WebrtcProvider } from "y-webrtc";
-import { WebsocketProvider } from "y-websocket";
-import * as Y from "yjs";
-var LOCAL_SIGNALING = ["ws://localhost:4444"];
-var warnedLocalSignaling = false;
-function resolveSignalingUrls(signaling) {
-  if (signaling && signaling.length > 0) return signaling;
-  if (!warnedLocalSignaling) {
-    warnedLocalSignaling = true;
-    console.warn(
-      '[docflow] webrtc provider has no `signaling` configured \u2014 falling back to localhost-only sync (ws://localhost:4444 + same-browser tabs). For production self-host, run your own signaling server and pass `signaling`, or use `provider: "websocket"` with your own websocketUrl.'
-    );
-  }
-  return LOCAL_SIGNALING;
-}
-var LOCAL_PRESENT_DEFAULT = true;
-function createAwarenessStates(awareness) {
-  const states = [];
-  awareness.getStates().forEach((state, clientId) => {
-    const raw = state;
-    states.push({
-      clientId,
-      user: raw.user ?? { name: "", color: "" },
-      cursor: raw.cursor ?? null,
-      // `present` defaults to true for backwards compat (legacy states
-      // don't set it) and for the local user (always considered present
-      // until PR2 toggles it off).
-      present: raw.present ?? LOCAL_PRESENT_DEFAULT
-    });
-  });
-  return states;
-}
-function createCollaboration(options) {
-  const ydoc = new Y.Doc();
-  if (options.initialStorageState) {
-    Y.applyUpdate(ydoc, options.initialStorageState);
-  }
-  let persistence;
-  if (options.offline) {
-    persistence = new IndexeddbPersistence(`docflow-${options.room}`, ydoc);
-  }
-  let provider = null;
-  if (options.provider === "webrtc") {
-    provider = new WebrtcProvider(options.room, ydoc, {
-      signaling: resolveSignalingUrls(options.signaling)
-    });
-  } else if (options.provider === "websocket") {
-    if (!options.websocketUrl) {
-      throw new Error('[Collaboration] websocketUrl is required when provider is "websocket"');
-    }
-    provider = new WebsocketProvider(options.websocketUrl, options.room, ydoc);
-  }
-  const awareness = provider?.awareness ?? new Awareness(ydoc);
-  awareness.setLocalStateField("user", options.user);
-  let emitCursor = options.emitCursor ?? true;
-  const setLocalCursorEnabled = (enabled) => {
-    if (emitCursor === enabled) return;
-    emitCursor = enabled;
-    if (!enabled) {
-      awareness.setLocalStateField("cursor", null);
-    }
-    awareness.setLocalStateField("emitCursor", enabled);
-  };
-  awareness.setLocalStateField("present", true);
-  awareness.setLocalStateField("emitCursor", emitCursor);
-  let awarenessHandler;
-  if (options.onAwarenessChange) {
-    const notify = () => {
-      options.onAwarenessChange?.(createAwarenessStates(awareness));
-    };
-    awarenessHandler = notify;
-    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) => {
-        let settled = false;
-        const done = () => {
-          if (settled) return;
-          settled = true;
-          resolve();
-        };
-        if (ws.synced) {
-          done();
-          return;
-        }
-        ws.once("sync", done);
-        ws.once("synced", done);
-        setTimeout(done, 5e3);
-      })
-    );
-  }
-  const whenReady = readyParts.length === 0 ? Promise.resolve() : Promise.all(readyParts).then(() => void 0);
-  const destroy = () => {
-    if (awarenessHandler) {
-      awareness.off("change", awarenessHandler);
-    }
-    awareness.setLocalState(null);
-    provider?.destroy?.();
-    awareness.destroy?.();
-    void persistence?.destroy();
-    ydoc.destroy();
-  };
-  return { ydoc, provider, awareness, persistence, whenReady, destroy, setLocalCursorEnabled };
-}
-function collaborationExtensions(options) {
-  const setup = "ydoc" in options ? options : createCollaboration(options);
-  const extensions = [
-    Collaboration.configure({ document: setup.ydoc })
-  ];
-  if (setup.provider) {
-    extensions.push(
-      CollaborationCursor.configure({
-        provider: setup.provider,
-        user: setup.awareness.getLocalState()?.user ?? { name: "", color: "" }
-      })
-    );
-  }
-  return extensions;
-}
-
 // src/BlockAttributes.ts
 import { Extension } from "@tiptap/core";
 import { Plugin, PluginKey } from "@tiptap/pm/state";
@@ -262,6 +129,42 @@ var BlockAttributesExtension = Extension.create({
   }
 });
 
+// src/collab/seedEmptyFragment.ts
+import * as Y from "yjs";
+var PROVISIONAL_SEED_ORIGIN = "docflow:provisional-seed";
+function isPristineEmptyParagraph(element) {
+  return element.length === 0 && Object.keys(element.getAttributes()).length === 0;
+}
+function seedEmptyFragment(doc, field = "default") {
+  const fragment = doc.getXmlFragment(field);
+  const paragraph = new Y.XmlElement("paragraph");
+  const observer = (_events, transaction) => {
+    if (transaction.origin === PROVISIONAL_SEED_ORIGIN) return;
+    if (paragraph.parent !== fragment) return;
+    if (!isPristineEmptyParagraph(paragraph)) return;
+    if (fragment.length < 2) return;
+    const index = fragment.toArray().indexOf(paragraph);
+    if (index === -1) return;
+    doc.transact(() => {
+      fragment.delete(index);
+    }, PROVISIONAL_SEED_ORIGIN);
+  };
+  let disposed = false;
+  const dispose = () => {
+    if (disposed) return;
+    disposed = true;
+    fragment.unobserveDeep(observer);
+  };
+  if (fragment.length > 0) {
+    return { seeded: false, dispose };
+  }
+  fragment.observeDeep(observer);
+  doc.transact(() => {
+    fragment.insert(0, [paragraph]);
+  }, PROVISIONAL_SEED_ORIGIN);
+  return { seeded: true, dispose };
+}
+
 // src/EditorContext.ts
 import { Extension as Extension2 } from "@tiptap/core";
 var EditorContextExtension = Extension2.create({
@@ -1579,7 +1482,7 @@ function createEditor(options = {}) {
     content: options.content ? migrateContent(options.content) : options.content
   };
   const plugins = migratedOptions.plugins ?? [];
-  const collaborationSetup = !migratedOptions.collaboration ? void 0 : "ydoc" in migratedOptions.collaboration ? migratedOptions.collaboration : createCollaboration(migratedOptions.collaboration);
+  const collaborationSetup = migratedOptions.collaboration;
   const performanceMonitor = migratedOptions.debug ? createPerformanceMonitor() : void 0;
   let tiptapEditor = createTiptapEditor(migratedOptions, plugins, collaborationSetup);
   let pluginActions = createActionMap(tiptapEditor, plugins);
@@ -1980,9 +1883,18 @@ function createTiptapEditor(options, plugins, collaborationSetup) {
   ];
   const content = options.collaboration ? void 0 : options.content;
   if (options.collaboration && collaborationSetup) {
+    const seed = seedEmptyFragment(collaborationSetup.ydoc);
+    if (seed.seeded) {
+      extensions.push(
+        Extension5.create({
+          name: "provisionalSeedCleanup",
+          onDestroy: () => seed.dispose()
+        })
+      );
+    }
     extensions = [...extensions, ...collaborationExtensions(collaborationSetup)];
   }
-  return new TiptapEditor({
+  const tiptapEditor = new TiptapEditor({
     element: options.target,
     content,
     extensions,
@@ -1997,6 +1909,7 @@ function createTiptapEditor(options, plugins, collaborationSetup) {
       transformPastedHTML: sanitizePastedHTML
     }
   });
+  return tiptapEditor;
 }
 
 // src/FontSize.ts
@@ -2108,113 +2021,6 @@ var FontSizeExtension = Extension6.create({
     };
   }
 });
-
-// src/SubdocumentProvider.ts
-import { Awareness as AwarenessClass } from "y-protocols/awareness";
-import { WebsocketProvider as WebsocketProvider2 } from "y-websocket";
-import * as Y2 from "yjs";
-var SubdocumentProvider = class {
-  parentDoc;
-  subdocs;
-  awareness;
-  options;
-  states = /* @__PURE__ */ new Map();
-  activeQueue = [];
-  parentProvider = null;
-  constructor(options) {
-    this.options = {
-      maxActive: options.maxActive ?? 5,
-      onStateChange: options.onStateChange ?? (() => {
-      }),
-      ...options
-    };
-    this.parentDoc = new Y2.Doc();
-    this.subdocs = this.parentDoc.getMap("subdocs");
-    this.awareness = new AwarenessClass(this.parentDoc);
-    this.awareness.setLocalStateField("user", this.options.user);
-    this.parentProvider = new WebsocketProvider2(
-      this.options.websocketUrl,
-      `${this.options.roomPrefix}/_parent`,
-      this.parentDoc
-    );
-  }
-  /** Create a new subdocument. Does NOT activate it. */
-  createSubdoc(id, initialState) {
-    if (this.states.has(id)) return this.states.get(id).doc;
-    const doc = new Y2.Doc();
-    if (initialState) Y2.applyUpdate(doc, initialState);
-    doc.getXmlFragment("default");
-    this.subdocs.set(id, doc);
-    this.states.set(id, {
-      id,
-      doc,
-      provider: null,
-      active: false
-    });
-    this.options.onStateChange(this.getAllStates());
-    return doc;
-  }
-  /** Activate a subdocument — connects it to the network for live sync. */
-  activate(id) {
-    const state = this.states.get(id);
-    if (!state || state.active) return;
-    if (this.activeQueue.length >= this.options.maxActive) {
-      const oldest = this.activeQueue.shift();
-      if (oldest) this.deactivate(oldest);
-    }
-    const doc = state.doc;
-    const roomName = `${this.options.roomPrefix}/${id}`;
-    const provider = new WebsocketProvider2(
-      this.options.websocketUrl,
-      roomName,
-      doc
-    );
-    provider.awareness.setLocalStateField("user", this.options.user);
-    state.provider = provider;
-    state.active = true;
-    this.activeQueue.push(id);
-    this.options.onStateChange(this.getAllStates());
-  }
-  /** Deactivate a subdocument — disconnects it from the network. */
-  deactivate(id) {
-    const state = this.states.get(id);
-    if (!state || !state.active) return;
-    state.provider?.destroy();
-    state.provider = null;
-    state.active = false;
-    const idx = this.activeQueue.indexOf(id);
-    if (idx >= 0) this.activeQueue.splice(idx, 1);
-    this.options.onStateChange(this.getAllStates());
-  }
-  /** Get the Y.XmlFragment for a subdocument. */
-  getFragment(id) {
-    const doc = this.states.get(id)?.doc ?? this.subdocs.get(id);
-    if (!doc) return null;
-    return doc.getXmlFragment("default");
-  }
-  /** Check if a subdocument is currently active (syncing). */
-  isActive(id) {
-    return this.states.get(id)?.active ?? false;
-  }
-  /** Get all subdocument states. */
-  getAllStates() {
-    return Array.from(this.states.values());
-  }
-  /** Get IDs of all active subdocuments. */
-  getActiveIds() {
-    return [...this.activeQueue];
-  }
-  /** Destroy all subdocuments and providers. */
-  destroy() {
-    for (const [id] of this.states) {
-      this.deactivate(id);
-    }
-    this.parentProvider?.destroy();
-    this.parentDoc.destroy();
-    this.states.clear();
-    this.activeQueue.length = 0;
-  }
-};
 export {
   BlockAttributesExtension,
   CONTEXT_CHAR_CAP,
@@ -2225,7 +2031,6 @@ export {
   PaginationPlus,
   PerformanceMonitor,
   SearchAndReplaceExtension,
-  SubdocumentProvider,
   buildAIPrompt,
   clearSearch,
   collaborationExtensions,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@kedataindo/docflow-core",
   "license": "UNLICENSED",
-  "version": "0.0.71",
+  "version": "0.0.72",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -16,6 +16,11 @@
       "types": "./dist/ai/index.d.ts",
       "import": "./dist/ai/index.js",
       "require": "./dist/ai/index.cjs"
+    },
+    "./collab": {
+      "types": "./dist/collab/index.d.ts",
+      "import": "./dist/collab/index.js",
+      "require": "./dist/collab/index.cjs"
     }
   },
   "publishConfig": {