@nimbalyst/extension-sdk 0.4.0 → 0.6.0

package/dist/useCollaborativeEditor.js

@@ -139,8 +139,10 @@ export function useCollaborativeEditor(host, config) {
             return;
         let cancelled = false;
         let handle = null;
+        let starting = false;
+        let unregisterContentFlush = null;
         const tryStart = async () => {
-            if (cancelled || handle)
+            if (cancelled || handle || starting)
                 return;
             const cfg = resolveConfig(configRef.current);
             const connected = collab.getStatus() === 'connected';
@@ -149,86 +151,100 @@ export function useCollaborativeEditor(host, config) {
             // can reopen offline; only first-open seeding requires a live transport.
             if (!connected && cfg.isEmpty(collab.yDoc))
                 return;
-            // NEVER seed when the transport skipped payloads it could not decode:
-            // the Y.Doc looking empty then means "content exists but is unreadable
-            // on this client", and seeding would write a default document over the
-            // real content for every client (the "Untitled map" clobber).
-            const undecoded = collab.hasUndecodedContent?.() === true;
-            if (connected && !undecoded && cfg.isEmpty(collab.yDoc)) {
-                try {
-                    const content = await collab.loadInitialContent();
-                    if (cancelled)
-                        return;
-                    // NEVER seed from empty content. A host that has no bytes for this
-                    // document (reopen of an already-shared doc: no in-memory share
-                    // payload, no file) returns ''/empty -- seeding from that writes a
-                    // default document into the shared room and clobbers whatever the
-                    // room's real content is for every client. Fall through to bind:
-                    // the room content (or a teammate's seed) will populate the doc.
-                    if (!hasSeedableContent(content)) {
-                        console.warn('[useCollaborativeEditor] Skipping first-open seed: host returned empty initial content.');
-                    }
-                    // Re-check emptiness in case another client seeded while we were
-                    // awaiting -- they would have raced through the WebSocket and
-                    // applied their update during our await gap. Avoid double-seeding
-                    // in that case; CRDT merge would otherwise insert duplicate
-                    // content unless the seed is fully deterministic.
-                    else if (cfg.isEmpty(collab.yDoc)) {
-                        collab.yDoc.transact(() => {
-                            cfg.seed(collab.yDoc, content);
-                        }, COLLAB_INIT_ORIGIN);
-                        // Durability: the seed the user sees locally must reach the server
-                        // before this provider can tear down. flushWithAck resolves only
-                        // after a server-persisted ack; flushLocalState is the deprecated
-                        // fire-and-forget fallback for older hosts.
-                        const flushed = collab.flushWithAck
-                            ? await collab.flushWithAck()
-                            : (await collab.flushLocalState?.(), true);
-                        if (!flushed) {
-                            const err = new Error('Seed flush was not confirmed by the server before timeout; content may not have persisted.');
-                            console.warn('[useCollaborativeEditor]', err.message);
-                            setSeedError(err);
-                            collab.reportSeedOutcome?.({ ok: false, error: err });
-                            cfg.onSeedOutcome?.({ ok: false, error: err });
+            starting = true;
+            try {
+                // NEVER seed when the transport skipped payloads it could not decode:
+                // the Y.Doc looking empty then means "content exists but is unreadable
+                // on this client", and seeding would write a default document over the
+                // real content for every client (the "Untitled map" clobber).
+                const undecoded = collab.hasUndecodedContent?.() === true;
+                if (connected && !undecoded && cfg.isEmpty(collab.yDoc)) {
+                    try {
+                        const content = await collab.loadInitialContent();
+                        if (cancelled)
+                            return;
+                        // NEVER seed from empty content. A host that has no bytes for this
+                        // document (reopen of an already-shared doc: no in-memory share
+                        // payload, no file) returns ''/empty -- seeding from that writes a
+                        // default document into the shared room and clobbers whatever the
+                        // room's real content is for every client. Fall through to bind:
+                        // the room content (or a teammate's seed) will populate the doc.
+                        if (!hasSeedableContent(content)) {
+                            console.warn('[useCollaborativeEditor] Skipping first-open seed: host returned empty initial content.');
                         }
-                        else {
-                            setSeedError(null);
-                            collab.reportSeedOutcome?.({ ok: true });
-                            cfg.onSeedOutcome?.({ ok: true });
+                        // Re-check emptiness in case another client seeded while we were
+                        // awaiting -- they would have raced through the WebSocket and
+                        // applied their update during our await gap. Avoid double-seeding
+                        // in that case; CRDT merge would otherwise insert duplicate
+                        // content unless the seed is fully deterministic.
+                        else if (cfg.isEmpty(collab.yDoc)) {
+                            collab.yDoc.transact(() => {
+                                cfg.seed(collab.yDoc, content);
+                            }, COLLAB_INIT_ORIGIN);
+                            // Durability: the seed the user sees locally must reach the server
+                            // before this provider can tear down. flushWithAck resolves only
+                            // after a server-persisted ack; flushLocalState is the deprecated
+                            // fire-and-forget fallback for older hosts.
+                            const flushed = collab.flushWithAck
+                                ? await collab.flushWithAck()
+                                : (await collab.flushLocalState?.(), true);
+                            if (!flushed) {
+                                const err = new Error('Seed flush was not confirmed by the server before timeout; content may not have persisted.');
+                                console.warn('[useCollaborativeEditor]', err.message);
+                                setSeedError(err);
+                                collab.reportSeedOutcome?.({ ok: false, error: err });
+                                cfg.onSeedOutcome?.({ ok: false, error: err });
+                            }
+                            else {
+                                setSeedError(null);
+                                collab.reportSeedOutcome?.({ ok: true });
+                                cfg.onSeedOutcome?.({ ok: true });
+                            }
                         }
                     }
+                    catch (err) {
+                        console.error('[useCollaborativeEditor] Failed to load/seed initial content:', err);
+                        setSeedError(err);
+                        collab.reportSeedOutcome?.({ ok: false, error: err });
+                        cfg.onSeedOutcome?.({ ok: false, error: err });
+                        // Continue with bind -- the doc may still be usable once another
+                        // client seeds it.
+                    }
                 }
-                catch (err) {
-                    console.error('[useCollaborativeEditor] Failed to load/seed initial content:', err);
-                    setSeedError(err);
-                    collab.reportSeedOutcome?.({ ok: false, error: err });
-                    cfg.onSeedOutcome?.({ ok: false, error: err });
-                    // Continue with bind -- the doc may still be usable once another
-                    // client seeds it.
-                }
-            }
-            if (cancelled)
-                return;
-            const created = cfg.bind({
-                yDoc: collab.yDoc,
-                awareness: collab.awareness,
-                user: collab.user,
-            });
-            const resolved = created instanceof Promise ? await created : created;
-            if (cancelled) {
-                // Effect unmounted while we were awaiting the extension's
-                // imperative API. Destroy the freshly-built handle so any
-                // observers/awareness subscriptions inside it get cleaned up.
-                try {
-                    resolved.destroy();
+                if (cancelled)
+                    return;
+                const created = cfg.bind({
+                    yDoc: collab.yDoc,
+                    awareness: collab.awareness,
+                    user: collab.user,
+                });
+                const resolved = created instanceof Promise ? await created : created;
+                if (cancelled) {
+                    // Effect unmounted while we were awaiting the extension's
+                    // imperative API. Destroy the freshly-built handle so any
+                    // observers/awareness subscriptions inside it get cleaned up.
+                    try {
+                        resolved.destroy();
+                    }
+                    catch (err) {
+                        console.error('[useCollaborativeEditor] post-cancel destroy failed:', err);
+                    }
+                    return;
                 }
-                catch (err) {
-                    console.error('[useCollaborativeEditor] post-cancel destroy failed:', err);
+                handle = resolved;
+                // A binding that debounces its local pushes holds the newest edit
+                // outside the CRDT. Hand the host a drain so it can complete a write
+                // before reporting it done -- notably after a mutating AI tool, which
+                // otherwise returns success while the edit is still in the debounce.
+                if (typeof handle.syncNow === 'function') {
+                    const syncNow = handle.syncNow.bind(handle);
+                    unregisterContentFlush = collab.registerContentFlush?.(syncNow) ?? null;
                 }
-                return;
+                setBinding(handle);
+            }
+            finally {
+                starting = false;
             }
-            handle = resolved;
-            setBinding(handle);
         };
         void tryStart();
         const unsubscribe = collab.onStatusChange(() => {
@@ -237,6 +253,8 @@ export function useCollaborativeEditor(host, config) {
         return () => {
             cancelled = true;
             unsubscribe();
+            unregisterContentFlush?.();
+            unregisterContentFlush = null;
             if (handle) {
                 handle.destroy();
                 handle = null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nimbalyst/extension-sdk",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "description": "SDK for building Nimbalyst extensions",
   "repository": {
     "type": "git",
@@ -17,7 +17,7 @@
     "./dist/validate.js": "./dist/validate.browser.js"
   },
   "nimbalyst": {
-    "minAppVersion": "0.70.0"
+    "minAppVersion": "0.78.0"
   },
   "publishConfig": {
     "access": "public"
@@ -33,6 +33,14 @@
       "types": "./dist/collab/index.d.ts",
       "import": "./dist/collab/index.js"
     },
+    "./agents": {
+      "types": "./dist/agents/index.d.ts",
+      "import": "./dist/agents/index.js"
+    },
+    "./types/editor": {
+      "types": "./dist/types/editor.d.ts",
+      "import": "./dist/types/editor.js"
+    },
     "./vite": {
       "types": "./dist/vite.d.ts",
       "import": "./dist/vite.js"
@@ -52,6 +60,10 @@
     "./file-mask": {
       "types": "./dist/fileMask.d.ts",
       "import": "./dist/fileMask.js"
+    },
+    "./git-operation-log": {
+      "types": "./dist/gitOperationLog.d.ts",
+      "import": "./dist/gitOperationLog.js"
     }
   },
   "files": [