braid-text 0.2.76 → 0.2.78

package/.claude/settings.local.json

@@ -4,7 +4,9 @@
       "Bash(node test/test.js:*)",
       "Bash(node:*)",
       "Bash(git add:*)",
-      "Bash(git commit -m \"$(cat <<''EOF''\n0.2.74 - updates url-file-db to 0.0.19\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>\nEOF\n)\")"
+      "Bash(git commit -m \"$(cat <<''EOF''\n0.2.74 - updates url-file-db to 0.0.19\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>\nEOF\n)\")",
+      "Bash(git push)",
+      "Bash(npm publish:*)"
     ],
     "deny": [],
     "ask": []

package/index.js

@@ -17,25 +17,37 @@ function create_braid_text() {
     let max_encoded_key_size = 240
 
     braid_text.sync = async (a, b, options = {}) => {
-        var unsync_cbs = []
-        options.my_unsync = () => unsync_cbs.forEach(cb => cb())
-
         if (!options.merge_type) options.merge_type = 'dt'
 
         if ((a instanceof URL) === (b instanceof URL)) {
+            // Both are URLs or both are local keys
+            var a_first_put, b_first_put
+            var a_first_put_promise = new Promise(done => a_first_put = done)
+            var b_first_put_promise = new Promise(done => b_first_put = done)
+
             var a_ops = {
-                subscribe: update => braid_text.put(b, update),
+                signal: options.signal,
+                subscribe: update => {
+                    update.signal = options.signal
+                    braid_text.put(b, update).then(a_first_put)
+                },
                 merge_type: options.merge_type,
             }
-            braid_text.get(a, a_ops)
-            unsync_cbs.push(() => braid_text.forget(a, a_ops))
+            braid_text.get(a, a_ops).then(x =>
+                x || b_first_put_promise.then(() =>
+                    braid_text.get(a, a_ops)))
 
             var b_ops = {
-                subscribe: update => braid_text.put(a, update),
+                signal: options.signal,
+                subscribe: update => {
+                    update.signal = options.signal
+                    braid_text.put(a, update).then(b_first_put)
+                },
                 merge_type: options.merge_type,
             }
-            braid_text.get(b, b_ops)
-            unsync_cbs.push(() => braid_text.forget(b, b_ops))
+            braid_text.get(b, b_ops).then(x =>
+                x || a_first_put_promise.then(() =>
+                    braid_text.get(b, b_ops)))
         } else {
             // make a=local and b=remote (swap if not)
             if (a instanceof URL) { let swap = a; a = b; b = swap }
@@ -78,12 +90,15 @@ function create_braid_text() {
             }
 
             var closed
-            var disconnect
-            unsync_cbs.push(() => {
+            var disconnect = () => {}
+            options.signal?.addEventListener('abort', () => {
                 closed = true
                 disconnect()
             })
 
+            var local_first_put
+            var local_first_put_promise = new Promise(done => local_first_put = done)
+
             connect()
             async function connect() {
                 if (options.on_connect) options.on_connect()
@@ -91,9 +106,7 @@ function create_braid_text() {
                 if (closed) return
 
                 var ac = new AbortController()
-                var disconnect_cbs = [() => ac.abort()]
-
-                disconnect = () => disconnect_cbs.forEach(cb => cb())
+                disconnect = () => ac.abort()
 
                 try {
                     // fork-point
@@ -142,9 +155,11 @@ function create_braid_text() {
 
                     // local -> remote
                     var a_ops = {
+                        signal: ac.signal,
                         subscribe: update => {
                             update.signal = ac.signal
                             braid_text.put(b, update).then((x) => {
+                                local_first_put()
                                 extend_fork_point(update)
                             }).catch(e => {
                                 if (e.name === 'AbortError') {
@@ -155,20 +170,26 @@ function create_braid_text() {
                     }
                     if (resource.meta.fork_point)
                         a_ops.parents = resource.meta.fork_point
-                    disconnect_cbs.push(() => braid_text.forget(a, a_ops))
                     braid_text.get(a, a_ops)
 
                     // remote -> local
                     var b_ops = {
+                        signal: ac.signal,
                         dont_retry: true,
                         subscribe: async update => {
                             await braid_text.put(a, update)
                             extend_fork_point(update)
                         },
                     }
-                    disconnect_cbs.push(() => braid_text.forget(b, b_ops))
-                    // NOTE: this should not return, but it might throw
-                    await braid_text.get(b, b_ops)
+                    // Handle case where remote doesn't exist yet - wait for local to create it
+                    var remote_result = await braid_text.get(b, b_ops)
+                    if (remote_result === null) {
+                        // Remote doesn't exist yet, wait for local to put something
+                        await local_first_put_promise
+                        disconnect()
+                        connect()
+                    }
+                    // NOTE: if remote exists, this should not return, but it might throw
                 } catch (e) {
                     if (closed) return
 
@@ -176,7 +197,7 @@ function create_braid_text() {
                     console.log(`disconnected, retrying in 1 second`)
                     setTimeout(connect, 1000)
                 }
-            }            
+            }
         }
     }
 
@@ -463,7 +484,21 @@ function create_braid_text() {
         throw new Error("unknown")
     }
 
-    braid_text.delete = async (key) => {
+    braid_text.delete = async (key, options) => {
+        if (!options) options = {}
+
+        // Handle URL - make a DELETE request
+        if (key instanceof URL) {
+            var params = {
+                method: 'DELETE',
+                signal: options.signal,
+            }
+            for (var x of ['headers', 'peer'])
+                if (options[x] != null) params[x] = options[x]
+
+            return await braid_fetch(key.href, params)
+        }
+
         // Accept either a key string or a resource object
         let resource = (typeof key == 'string') ? await get_resource(key) : key
         await resource.delete()
@@ -482,19 +517,21 @@ function create_braid_text() {
         if (key instanceof URL) {
             if (!options) options = {}
 
-            options.my_abort = new AbortController()
-
             var params = {
-                signal: options.my_abort.signal,
+                signal: options.signal,
                 subscribe: !!options.subscribe,
                 heartbeats: 120,
             }
-            if (!options.dont_retry) params.retry = () => true
+            if (!options.dont_retry) {
+                params.retry = (res) => res.status !== 404
+            }
             for (var x of ['headers', 'parents', 'version', 'peer'])
                 if (options[x] != null) params[x] = options[x]
 
             var res = await braid_fetch(key.href, params)
 
+            if (res.status === 404) return null
+
             if (options.subscribe) {
                 if (options.dont_retry) {
                     var error_happened
@@ -583,6 +620,8 @@ function create_braid_text() {
 
                 options.my_last_sent_version = x.version
                 resource.simpleton_clients.add(options)
+                options.signal?.addEventListener('abort', () =>
+                    resource.simpleton_clients.delete(options))
             } else {
 
                 if (options.accept_encoding?.match(/updates\s*\((.*)\)/)?.[1].split(',').map(x=>x.trim()).includes('dt')) {
@@ -630,22 +669,12 @@ function create_braid_text() {
                 }
 
                 resource.clients.add(options)
+                options.signal?.addEventListener('abort', () =>
+                    resource.clients.delete(options))
             }
         }
     }
 
-    braid_text.forget = async (key, options) => {
-        if (!options) throw new Error('options is required')
-
-        if (key instanceof URL) return options.my_abort.abort()
-
-        let resource = (typeof key == 'string') ? await get_resource(key) : key
-
-        if (options.merge_type != "dt")
-            resource.simpleton_clients.delete(options)
-        else resource.clients.delete(options)
-    }
-
     braid_text.put = async (key, options) => {
         if (options.version) {
             validate_version_array(options.version)
@@ -657,14 +686,9 @@ function create_braid_text() {
         }
 
         if (key instanceof URL) {
-            options.my_abort = new AbortController()
-            if (options.signal)
-                options.signal.addEventListener('abort', () =>
-                    options.my_abort.abort())
-
             var params = {
                 method: 'PUT',
-                signal: options.my_abort.signal,
+                signal: options.signal,
                 retry: () => true,
             }
             for (var x of ['headers', 'parents', 'version', 'peer', 'body', 'patches'])

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "braid-text",
-  "version": "0.2.76",
+  "version": "0.2.78",
   "description": "Library for collaborative text over http using braid.",
   "author": "Braid Working Group",
   "repository": "braid-org/braid-text",

package/test/fuzz-test.js

@@ -270,16 +270,20 @@ async function main() {
 
             // try getting updates from middle_doc to doc
             if (!v_eq(middle_v, doc_v)) {
-                var o
+                var ac = new AbortController()
                 await new Promise(async done => {
-                    o = {merge_type: 'dt', parents: middle_v, subscribe: async update => {
-                        await braid_text.put('middle_doc', update)
-                        middle_v = (await braid_text.get_resource('middle_doc')).version
-                        if (v_eq(doc_v, middle_v)) done()
-                    }}
-                    braid_text.get('doc', o)
+                    braid_text.get('doc', {
+                        signal: ac.signal,
+                        merge_type: 'dt',
+                        parents: middle_v,
+                        subscribe: async update => {
+                            await braid_text.put('middle_doc', update)
+                            middle_v = (await braid_text.get_resource('middle_doc')).version
+                            if (v_eq(doc_v, middle_v)) done()
+                        }
+                    })
                 })
-                await braid_text.forget('doc', o)
+                ac.abort()
             }
 
             if (await braid_text.get('middle_doc') != await braid_text.get('doc')) throw new Error('bad')

package/test/tests.js

@@ -50,13 +50,14 @@ runTest(
             method: 'PUT',
             body: `void (async () => {
                 var count = 0
-                var ops
-                braid_text.sync('/${key}', new URL('http://localhost:8889/have_error'), ops = {
+                var ac = new AbortController()
+                braid_text.sync('/${key}', new URL('http://localhost:8889/have_error'), {
+                    signal: ac.signal,
                     on_connect: () => {
                         count++
                         if (count === 2) {
                             res.end('it reconnected!')
-                            ops.my_unsync()
+                            ac.abort()
                         }
                     }
                 })
@@ -201,13 +202,14 @@ runTest(
             method: 'PUT',
             body: `void (async () => {
                 var count = 0
-                var ops
-                braid_text.sync('/${key_a}', new URL('http://localhost:8889/have_error'), ops = {
+                var ac = new AbortController()
+                braid_text.sync('/${key_a}', new URL('http://localhost:8889/have_error'), {
+                    signal: ac.signal,
                     on_connect: () => {
                         count++
                         if (count === 2) {
                             res.end('it reconnected!')
-                            ops.my_unsync()
+                            ac.abort()
                         }
                     }
                 })
@@ -265,10 +267,10 @@ runTest(
         var r = await braid_fetch(`/eval`, {
             method: 'PUT',
             body: `void (async () => {
-                var ops = {}
-                braid_text.sync('/${key_a}', '/${key_b}', ops)
+                var ac = new AbortController()
+                braid_text.sync('/${key_a}', '/${key_b}', {signal: ac.signal})
                 await new Promise(done => setTimeout(done, 100))
-                ops.my_unsync()
+                ac.abort()
                 res.end('')
             })()`
         })
@@ -283,10 +285,10 @@ runTest(
         var r = await braid_fetch(`/eval`, {
             method: 'PUT',
             body: `void (async () => {
-                var ops = {}
-                braid_text.sync('/${key_a}', new URL('http://localhost:8889/${key_b}'), ops)
+                var ac = new AbortController()
+                braid_text.sync('/${key_a}', new URL('http://localhost:8889/${key_b}'), {signal: ac.signal})
                 await new Promise(done => setTimeout(done, 100))
-                ops.my_unsync()
+                ac.abort()
                 res.end('')
             })()`
         })
@@ -456,14 +458,15 @@ runTest(
             method: 'PUT',
             body: `void (async () => {
                 var url = new URL('http://localhost:8889/${key}')
+                var ac = new AbortController()
                 var update = await new Promise(done => {
-                    var o = {
+                    braid_text.get(url, {
+                        signal: ac.signal,
                         subscribe: update => {
-                            braid_text.forget(url, o)
+                            ac.abort()
                             done(update)
                         }
-                    }
-                    braid_text.get(url, o)
+                    })
                 })
                 res.end(update.body)
             })()`
@@ -1896,6 +1899,95 @@ runTest(
     'ok'
 )
 
+runTest(
+    "test braid_text.delete(url)",
+    async () => {
+        var key = 'test-' + Math.random().toString(36).slice(2)
+
+        // Create a resource first
+        await braid_fetch(`/${key}`, {
+            method: 'PUT',
+            body: 'hello there'
+        })
+
+        // Verify it exists
+        let r1 = await braid_fetch(`/${key}`)
+        if ((await r1.text()) !== 'hello there') return 'Resource not created properly'
+
+        // Delete using braid_text.delete(url)
+        var r = await braid_fetch(`/eval`, {
+            method: 'PUT',
+            body: `void (async () => {
+                await braid_text.delete(new URL('http://localhost:8889/${key}'))
+                res.end('deleted')
+            })()`
+        })
+        if (!r.ok) return 'delete failed: ' + r.status
+        if ((await r.text()) !== 'deleted') return 'delete did not complete'
+
+        // Verify it's deleted (should be empty)
+        let r2 = await braid_fetch(`/${key}`)
+        return 'got: ' + (await r2.text())
+    },
+    'got: '
+)
+
+runTest(
+    "test braid_text.get(url) returns null for 404",
+    async () => {
+        // Use the /404 endpoint that always returns 404
+        var r = await braid_fetch(`/eval`, {
+            method: 'PUT',
+            body: `void (async () => {
+                var result = await braid_text.get(new URL('http://localhost:8889/404'))
+                res.end(result === null ? 'null' : 'not null: ' + result)
+            })()`
+        })
+        return await r.text()
+    },
+    'null'
+)
+
+runTest(
+    "test braid_text.sync handles remote not existing yet",
+    async () => {
+        var local_key = 'test-local-' + Math.random().toString(36).slice(2)
+        var remote_key = 'test-remote-' + Math.random().toString(36).slice(2)
+
+        // Start sync between a local key and a remote URL that doesn't exist yet
+        // The sync should wait for local to create something, then push to remote
+        var r = await braid_fetch(`/eval`, {
+            method: 'PUT',
+            body: `void (async () => {
+                var ac = new AbortController()
+
+                // Start sync - remote doesn't exist yet
+                braid_text.sync('/${local_key}', new URL('http://localhost:8889/${remote_key}'), {
+                    signal: ac.signal
+                })
+
+                // Wait a bit then put something locally
+                await new Promise(done => setTimeout(done, 100))
+                await braid_text.put('/${local_key}', { body: 'created locally' })
+
+                // Wait for sync to propagate
+                await new Promise(done => setTimeout(done, 200))
+
+                // Stop sync
+                ac.abort()
+
+                res.end('done')
+            })()`
+        })
+        if (!r.ok) return 'eval failed: ' + r.status
+
+        // Check that remote now has the content
+        var r2 = await braid_fetch(`/${remote_key}`)
+        return await r2.text()
+    },
+    'created locally'
+)
+
 runTest(
     "test getting a binary update from a subscription",
     async () => {