@kyneta/yjs-schema 1.7.0 → 2.0.0

package/src/__tests__/record-text-spike.test.ts

@@ -17,7 +17,7 @@
 //   4. Sync: two peers should converge after exchanging deltas
 
 import {
-  change,
+  batch,
   createDoc,
   exportEntirety,
   exportSince,
@@ -76,7 +76,7 @@ describe("record-of-struct (plain baseline)", () => {
   it("set a record entry and read it back", () => {
     const doc = createDoc(BoundPlainRecord)
 
-    change(doc, (d: any) => {
+    batch(doc, (d: any) => {
       d.profiles.set("alice", { displayName: "Alice", age: 30 })
     })
 
@@ -89,7 +89,7 @@ describe("record-of-struct (plain baseline)", () => {
   it("set multiple entries and read all back", () => {
     const doc = createDoc(BoundPlainRecord)
 
-    change(doc, (d: any) => {
+    batch(doc, (d: any) => {
       d.profiles.set("alice", { displayName: "Alice", age: 30 })
       d.profiles.set("bob", { displayName: "Bob", age: 25 })
     })
@@ -104,7 +104,7 @@ describe("record-of-struct (plain baseline)", () => {
   it("navigate into a record entry via .at()", () => {
     const doc = createDoc(BoundPlainRecord)
 
-    change(doc, (d: any) => {
+    batch(doc, (d: any) => {
       d.profiles.set("alice", { displayName: "Alice", age: 30 })
     })
 
@@ -117,7 +117,7 @@ describe("record-of-struct (plain baseline)", () => {
   it("syncs record-of-struct between two peers via snapshot", () => {
     const docA = createDoc(BoundPlainRecord)
 
-    change(docA, (d: any) => {
+    batch(docA, (d: any) => {
       d.profiles.set("alice", { displayName: "Alice", age: 30 })
     })
 
@@ -132,7 +132,7 @@ describe("record-of-struct (plain baseline)", () => {
   it("syncs record-of-struct between two peers via delta", () => {
     const docA = createDoc(BoundPlainRecord)
 
-    change(docA, (d: any) => {
+    batch(docA, (d: any) => {
       d.profiles.set("alice", { displayName: "Alice", age: 30 })
     })
 
@@ -141,7 +141,7 @@ describe("record-of-struct (plain baseline)", () => {
 
     const v0 = version(docB)
 
-    change(docA, (d: any) => {
+    batch(docA, (d: any) => {
       d.profiles.set("bob", { displayName: "Bob", age: 25 })
     })
 
@@ -164,7 +164,7 @@ describe("text-inside-struct-inside-record", () => {
   it("set a record entry with text field omitted and read it back", () => {
     const doc = createDoc(BoundProfile)
 
-    change(doc, (d: any) => {
+    batch(doc, (d: any) => {
       d.profiles.set("alice", { displayName: "Alice" })
     })
 
@@ -177,7 +177,7 @@ describe("text-inside-struct-inside-record", () => {
   it("set a record entry with text field provided and read it back", () => {
     const doc = createDoc(BoundProfile)
 
-    change(doc, (d: any) => {
+    batch(doc, (d: any) => {
       d.profiles.set("alice", { displayName: "Alice", bio: "Hello world" })
     })
 
@@ -190,7 +190,7 @@ describe("text-inside-struct-inside-record", () => {
   it("navigate into a record entry and read the text", () => {
     const doc = createDoc(BoundProfile)
 
-    change(doc, (d: any) => {
+    batch(doc, (d: any) => {
       d.profiles.set("alice", { displayName: "Alice" })
     })
 
@@ -203,11 +203,11 @@ describe("text-inside-struct-inside-record", () => {
   it("insert text into a text field inside a record entry (field omitted at creation)", () => {
     const doc = createDoc(BoundProfile)
 
-    change(doc, (d: any) => {
+    batch(doc, (d: any) => {
       d.profiles.set("alice", { displayName: "Alice" })
     })
 
-    change(doc, (d: any) => {
+    batch(doc, (d: any) => {
       d.profiles.at("alice").bio.insert(0, "Hello world")
     })
 
@@ -217,11 +217,11 @@ describe("text-inside-struct-inside-record", () => {
   it("insert text into a text field inside a record entry (field provided at creation)", () => {
     const doc = createDoc(BoundProfile)
 
-    change(doc, (d: any) => {
+    batch(doc, (d: any) => {
       d.profiles.set("alice", { displayName: "Alice", bio: "Initial" })
     })
 
-    change(doc, (d: any) => {
+    batch(doc, (d: any) => {
       d.profiles.at("alice").bio.insert(7, " bio")
     })
 
@@ -231,12 +231,12 @@ describe("text-inside-struct-inside-record", () => {
   it("set multiple entries and edit text independently", () => {
     const doc = createDoc(BoundProfile)
 
-    change(doc, (d: any) => {
+    batch(doc, (d: any) => {
       d.profiles.set("alice", { displayName: "Alice" })
       d.profiles.set("bob", { displayName: "Bob" })
     })
 
-    change(doc, (d: any) => {
+    batch(doc, (d: any) => {
       d.profiles.at("alice").bio.insert(0, "Alice's bio")
       d.profiles.at("bob").bio.insert(0, "Bob's bio")
     })
@@ -248,7 +248,7 @@ describe("text-inside-struct-inside-record", () => {
   it("subscribe fires on text edit inside record entry", () => {
     const doc = createDoc(BoundProfile)
 
-    change(doc, (d: any) => {
+    batch(doc, (d: any) => {
       d.profiles.set("alice", { displayName: "Alice" })
     })
 
@@ -257,7 +257,7 @@ describe("text-inside-struct-inside-record", () => {
       fired = true
     })
 
-    change(doc, (d: any) => {
+    batch(doc, (d: any) => {
       d.profiles.at("alice").bio.insert(0, "Hello")
     })
 
@@ -267,10 +267,10 @@ describe("text-inside-struct-inside-record", () => {
   it("syncs text-inside-record via snapshot", () => {
     const docA = createDoc(BoundProfile)
 
-    change(docA, (d: any) => {
+    batch(docA, (d: any) => {
       d.profiles.set("alice", { displayName: "Alice" })
     })
-    change(docA, (d: any) => {
+    batch(docA, (d: any) => {
       d.profiles.at("alice").bio.insert(0, "Collaborative bio")
     })
 
@@ -288,7 +288,7 @@ describe("text-inside-struct-inside-record", () => {
   it("syncs text-inside-record via delta", () => {
     const docA = createDoc(BoundProfile)
 
-    change(docA, (d: any) => {
+    batch(docA, (d: any) => {
       d.profiles.set("alice", { displayName: "Alice" })
     })
 
@@ -298,7 +298,7 @@ describe("text-inside-struct-inside-record", () => {
     const docB = createDoc(BoundProfile, exportEntirety(docA))
     const v0 = version(docB)
 
-    change(docA, (d: any) => {
+    batch(docA, (d: any) => {
       d.profiles.at("alice").bio.insert(0, "Hello from A")
     })
 
@@ -311,7 +311,7 @@ describe("text-inside-struct-inside-record", () => {
     })
 
     // Text on B is functional — can insert independently
-    change(docB, (d: any) => {
+    batch(docB, (d: any) => {
       d.profiles.at("alice").bio.insert(12, "!")
     })
     expect((docB as any).profiles.at("alice").bio()).toBe("Hello from A!")
@@ -321,7 +321,7 @@ describe("text-inside-struct-inside-record", () => {
     const docA = createDoc(BoundProfile)
 
     // Sync initial state: A creates the entry, B starts from snapshot
-    change(docA, (d: any) => {
+    batch(docA, (d: any) => {
       d.profiles.set("alice", { displayName: "Alice" })
     })
     const docB = createDoc(BoundProfile, exportEntirety(docA))
@@ -330,10 +330,10 @@ describe("text-inside-struct-inside-record", () => {
     const vA = version(docA)
     const vB = version(docB)
 
-    change(docA, (d: any) => {
+    batch(docA, (d: any) => {
       d.profiles.at("alice").bio.insert(0, "Hello ")
     })
-    change(docB, (d: any) => {
+    batch(docB, (d: any) => {
       d.profiles.at("alice").bio.insert(0, "World")
     })
 
@@ -360,7 +360,7 @@ describe("text-inside-struct-inside-list", () => {
   it("push a struct with text field omitted and read it back", () => {
     const doc = createDoc(BoundListProfile)
 
-    change(doc, (d: any) => {
+    batch(doc, (d: any) => {
       d.players.push({ name: "Alice" })
     })
 
@@ -372,7 +372,7 @@ describe("text-inside-struct-inside-list", () => {
   it("push a struct with text field provided and read it back", () => {
     const doc = createDoc(BoundListProfile)
 
-    change(doc, (d: any) => {
+    batch(doc, (d: any) => {
       d.players.push({ name: "Alice", bio: "Hi there" })
     })
 
@@ -384,11 +384,11 @@ describe("text-inside-struct-inside-list", () => {
   it("insert text into a text field inside a list item (field omitted at creation)", () => {
     const doc = createDoc(BoundListProfile)
 
-    change(doc, (d: any) => {
+    batch(doc, (d: any) => {
       d.players.push({ name: "Alice" })
     })
 
-    change(doc, (d: any) => {
+    batch(doc, (d: any) => {
       d.players.at(0).bio.insert(0, "Alice's bio")
     })
 
@@ -398,12 +398,12 @@ describe("text-inside-struct-inside-list", () => {
   it("multiple list items with independent text fields", () => {
     const doc = createDoc(BoundListProfile)
 
-    change(doc, (d: any) => {
+    batch(doc, (d: any) => {
       d.players.push({ name: "Alice" })
       d.players.push({ name: "Bob" })
     })
 
-    change(doc, (d: any) => {
+    batch(doc, (d: any) => {
       d.players.at(0).bio.insert(0, "Alice's bio")
       d.players.at(1).bio.insert(0, "Bob's bio")
     })
@@ -415,7 +415,7 @@ describe("text-inside-struct-inside-list", () => {
   it("syncs list-of-struct-with-text via delta", () => {
     const docA = createDoc(BoundListProfile)
 
-    change(docA, (d: any) => {
+    batch(docA, (d: any) => {
       d.players.push({ name: "Alice" })
     })
 
@@ -423,7 +423,7 @@ describe("text-inside-struct-inside-list", () => {
     const docB = createDoc(BoundListProfile, exportEntirety(docA))
     const v0 = version(docB)
 
-    change(docA, (d: any) => {
+    batch(docA, (d: any) => {
       d.players.at(0).bio.insert(0, "Synced bio")
     })
 

package/src/__tests__/substrate.test.ts

@@ -1,5 +1,5 @@
 import {
-  change,
+  batch,
   createDoc,
   createRef,
   exportEntirety,
@@ -8,6 +8,7 @@ import {
   RawPath,
   Schema,
   subscribe,
+  unwrap,
   version,
 } from "@kyneta/schema"
 import { describe, expect, it } from "vitest"
@@ -75,16 +76,16 @@ describe("YjsSubstrate", () => {
       expect(substrate.reader.read(RawPath.empty.field("items"))).toEqual([])
     })
 
-    it("creates a substrate and populates via change()", () => {
+    it("creates a substrate and populates via batch()", () => {
       const doc = createDoc(yjs.bind(SimpleSchema))
-      change(doc, (d: any) => {
+      batch(doc, (d: any) => {
         d.title.insert(0, "Hello")
         d.count.set(42)
       })
-      // Separate change() calls for list pushes to preserve order
+      // Separate batch() calls for list pushes to preserve order
       // (Yjs reverses order within a single transaction)
-      change(doc, (d: any) => d.items.push("a"))
-      change(doc, (d: any) => d.items.push("b"))
+      batch(doc, (d: any) => d.items.push("a"))
+      batch(doc, (d: any) => d.items.push("b"))
       expect(doc.title()).toBe("Hello")
       expect(doc.count()).toBe(42)
       expect(doc.items()).toEqual(["a", "b"])
@@ -92,7 +93,7 @@ describe("YjsSubstrate", () => {
 
     it("creates a substrate with partial values (unset fields stay empty)", () => {
       const doc = createDoc(yjs.bind(SimpleSchema))
-      change(doc, (d: any) => {
+      batch(doc, (d: any) => {
         d.title.insert(0, "Partial")
       })
       expect(doc.title()).toBe("Partial")
@@ -100,19 +101,19 @@ describe("YjsSubstrate", () => {
       expect(doc.items()).toEqual([])
     })
 
-    it("creates a substrate with nested struct values via change()", () => {
+    it("creates a substrate with nested struct values via batch()", () => {
       const doc = createDoc(yjs.bind(FullSchema))
-      change(doc, (d: any) => {
+      batch(doc, (d: any) => {
         d.meta.author.set("Alice")
       })
       expect(doc.meta.author()).toBe("Alice")
     })
 
-    it("creates a substrate with struct list values via change()", () => {
+    it("creates a substrate with struct list values via batch()", () => {
       const doc = createDoc(yjs.bind(StructListSchema))
-      // Separate change() calls for list pushes to preserve order
-      change(doc, (d: any) => d.tasks.push({ name: "Task 1", done: false }))
-      change(doc, (d: any) => d.tasks.push({ name: "Task 2", done: true }))
+      // Separate batch() calls for list pushes to preserve order
+      batch(doc, (d: any) => d.tasks.push({ name: "Task 1", done: false }))
+      batch(doc, (d: any) => d.tasks.push({ name: "Task 2", done: true }))
       expect((doc.tasks.at(0) as any).name()).toBe("Task 1")
       expect((doc.tasks.at(1) as any).done()).toBe(true)
     })
@@ -125,7 +126,7 @@ describe("YjsSubstrate", () => {
   describe("write round-trip", () => {
     it("text insert round-trips through prepare/flush", () => {
       const doc = createDoc(yjs.bind(SimpleSchema))
-      change(doc, (d: any) => {
+      batch(doc, (d: any) => {
         d.title.insert(0, "Hello")
       })
       expect(doc.title()).toBe("Hello")
@@ -133,7 +134,7 @@ describe("YjsSubstrate", () => {
 
     it("scalar set round-trips through prepare/flush", () => {
       const doc = createDoc(yjs.bind(SimpleSchema))
-      change(doc, (d: any) => {
+      batch(doc, (d: any) => {
         d.count.set(42)
       })
       expect(doc.count()).toBe(42)
@@ -141,10 +142,10 @@ describe("YjsSubstrate", () => {
 
     it("list push round-trips through prepare/flush", () => {
       const doc = createDoc(yjs.bind(SimpleSchema))
-      change(doc, (d: any) => {
+      batch(doc, (d: any) => {
         d.items.push("a")
       })
-      change(doc, (d: any) => {
+      batch(doc, (d: any) => {
         d.items.push("b")
       })
       expect(doc.items()).toEqual(["a", "b"])
@@ -161,7 +162,7 @@ describe("YjsSubstrate", () => {
       const doc = createDoc(yjs.bind(SimpleSchema))
       const v1 = version(doc)
 
-      change(doc, (d: any) => {
+      batch(doc, (d: any) => {
         d.title.insert(0, "Hi")
       })
       const v2 = version(doc)
@@ -172,7 +173,7 @@ describe("YjsSubstrate", () => {
 
     it("version serialize/parse round-trips", () => {
       const doc = createDoc(yjs.bind(SimpleSchema))
-      change(doc, (d: any) => {
+      batch(doc, (d: any) => {
         d.title.insert(0, "Test")
         d.count.set(5)
       })
@@ -185,12 +186,12 @@ describe("YjsSubstrate", () => {
 
     it("version changes after a delete-only mutation", () => {
       const doc = createDoc(yjs.bind(SimpleSchema))
-      change(doc, (d: any) => {
+      batch(doc, (d: any) => {
         d.title.insert(0, "hello")
       })
       const vAfterInsert = version(doc)
 
-      change(doc, (d: any) => {
+      batch(doc, (d: any) => {
         d.title.delete(1, 1)
       })
       const vAfterDelete = version(doc)
@@ -209,7 +210,7 @@ describe("YjsSubstrate", () => {
   describe("export/import snapshot", () => {
     it("exports a binary payload", () => {
       const doc = createDoc(yjs.bind(SimpleSchema))
-      change(doc, (d: any) => {
+      batch(doc, (d: any) => {
         d.title.insert(0, "Snapshot")
       })
       const payload = exportEntirety(doc)
@@ -219,14 +220,14 @@ describe("YjsSubstrate", () => {
 
     it("reconstructs equivalent state from snapshot", () => {
       const doc1 = createDoc(yjs.bind(SimpleSchema))
-      change(doc1, (d: any) => {
+      batch(doc1, (d: any) => {
         d.title.insert(0, "Hello")
         d.count.set(42)
       })
-      // Separate change() calls for list pushes to preserve order
-      change(doc1, (d: any) => d.items.push("a"))
-      change(doc1, (d: any) => d.items.push("b"))
-      change(doc1, (d: any) => {
+      // Separate batch() calls for list pushes to preserve order
+      batch(doc1, (d: any) => d.items.push("a"))
+      batch(doc1, (d: any) => d.items.push("b"))
+      batch(doc1, (d: any) => {
         d.title.insert(5, " World")
       })
 
@@ -246,14 +247,14 @@ describe("YjsSubstrate", () => {
   describe("delta sync", () => {
     it("exportSince → merge syncs state", () => {
       const doc1 = createDoc(yjs.bind(SimpleSchema))
-      change(doc1, (d: any) => {
+      batch(doc1, (d: any) => {
         d.title.insert(0, "Start")
       })
       const doc2 = createDoc(yjs.bind(SimpleSchema), exportEntirety(doc1))
 
       const v1Before = version(doc1)
 
-      change(doc1, (d: any) => {
+      batch(doc1, (d: any) => {
         d.title.insert(5, " Edited")
         d.count.set(99)
       })
@@ -274,10 +275,10 @@ describe("YjsSubstrate", () => {
       const v2Before = version(doc2)
 
       // Independent mutations
-      change(doc1, (d: any) => {
+      batch(doc1, (d: any) => {
         d.title.insert(0, "A")
       })
-      change(doc2, (d: any) => {
+      batch(doc2, (d: any) => {
         d.count.set(7)
       })
 
@@ -314,14 +315,14 @@ describe("YjsSubstrate", () => {
   describe("changefeed", () => {
     it("fires on merge", () => {
       const doc1 = createDoc(yjs.bind(SimpleSchema))
-      change(doc1, (d: any) => {
+      batch(doc1, (d: any) => {
         d.title.insert(0, "A")
       })
       const doc2 = createDoc(yjs.bind(SimpleSchema), exportEntirety(doc1))
 
       const v2Before = version(doc2)
 
-      change(doc1, (d: any) => {
+      batch(doc1, (d: any) => {
         d.count.set(42)
       })
 
@@ -366,7 +367,7 @@ describe("YjsSubstrate", () => {
         received.push(changeset)
       })
 
-      change(doc, (d: any) => {
+      batch(doc, (d: any) => {
         d.count.set(42)
       })
 
@@ -380,7 +381,7 @@ describe("YjsSubstrate", () => {
       const _doc2 = createDoc(yjs.bind(StructListSchema), exportEntirety(doc1))
 
       // Add a struct item on doc1, sync to doc2
-      change(doc1, (d: any) => {
+      batch(doc1, (d: any) => {
         d.tasks.push({ name: "Buy milk", done: false })
       })
       const snap = exportEntirety(doc1)
@@ -397,7 +398,7 @@ describe("YjsSubstrate", () => {
       const unsub = cf.subscribe((cs: unknown) => fieldChanges.push(cs))
 
       // Toggle done on doc1
-      change(doc1, (d: any) => {
+      batch(doc1, (d: any) => {
         d.tasks.at(0).done.set(true)
       })
 
@@ -418,7 +419,7 @@ describe("YjsSubstrate", () => {
       const doc1 = createDoc(yjs.bind(StructListSchema))
 
       // Add a struct item, sync to doc2
-      change(doc1, (d: any) => {
+      batch(doc1, (d: any) => {
         d.tasks.push({ name: "Buy milk", done: false })
       })
       const doc2 = createDoc(yjs.bind(StructListSchema), exportEntirety(doc1))
@@ -434,8 +435,8 @@ describe("YjsSubstrate", () => {
       const unsub1 = cfName.subscribe((cs: unknown) => nameChanges.push(cs))
       const unsub2 = cfDone.subscribe((cs: unknown) => doneChanges.push(cs))
 
-      // Update both fields in a single change() on doc1
-      change(doc1, (d: any) => {
+      // Update both fields in a single batch() on doc1
+      batch(doc1, (d: any) => {
         const task = d.tasks.at(0)
         task.name.set("Buy oat milk")
         task.done.set(true)
@@ -462,7 +463,7 @@ describe("YjsSubstrate", () => {
   // -------------------------------------------------------------------------
 
   describe("transaction support", () => {
-    it("multi-op change() is atomic", () => {
+    it("multi-op batch() is atomic", () => {
       const doc = createDoc(yjs.bind(SimpleSchema))
 
       const received: any[] = []
@@ -470,7 +471,7 @@ describe("YjsSubstrate", () => {
         received.push(changeset)
       })
 
-      change(doc, (d: any) => {
+      batch(doc, (d: any) => {
         d.title.insert(0, "Hello")
         d.count.set(42)
         d.items.push("a")
@@ -501,7 +502,7 @@ describe("YjsSubstrate", () => {
     it("push struct into list, read back via navigation", () => {
       const doc = createDoc(yjs.bind(StructListSchema))
 
-      change(doc, (d: any) => {
+      batch(doc, (d: any) => {
         d.tasks.push({ name: "Task 1", done: false })
       })
 
@@ -509,7 +510,7 @@ describe("YjsSubstrate", () => {
       expect((doc.tasks.at(0) as any).name()).toBe("Task 1")
       expect((doc.tasks.at(0) as any).done()).toBe(false)
 
-      change(doc, (d: any) => {
+      batch(doc, (d: any) => {
         d.tasks.push({ name: "Task 2", done: true })
       })
 
@@ -520,12 +521,12 @@ describe("YjsSubstrate", () => {
 
     it("nested struct write round-trip", () => {
       const doc = createDoc(yjs.bind(FullSchema))
-      change(doc, (d: any) => {
+      batch(doc, (d: any) => {
         d.meta.author.set("Alice")
       })
       expect(doc.meta.author()).toBe("Alice")
 
-      change(doc, (d: any) => {
+      batch(doc, (d: any) => {
         d.meta.author.set("Bob")
       })
 
@@ -579,7 +580,7 @@ describe("YjsSubstrate", () => {
 
     it("reconstructs from snapshot with correct state", () => {
       const doc = createDoc(yjs.bind(SimpleSchema))
-      change(doc, (d: any) => {
+      batch(doc, (d: any) => {
         d.title.insert(0, "Snapshot Test")
         d.count.set(77)
         d.items.push("x")
@@ -612,17 +613,17 @@ describe("YjsSubstrate", () => {
   // Re-entrant write during merge replay
   // -------------------------------------------------------------------------
   //
-  // A subscriber that calls `change(doc, ...)` while delivering a sync
+  // A subscriber that calls `batch(doc, ...)` while delivering a sync
   // merge must reach Yjs — otherwise the substrate stalls and the
   // subscriber loops on stale state until the lease budget trips.
   // Context: jj:qpultxsw.
 
   describe("re-entrant write during merge replay", () => {
-    it("subscriber's local change() inside a merge-replay batch lands in Yjs", () => {
+    it("subscriber's local batch() inside a merge-replay batch lands in Yjs", () => {
       const docA = createDoc(yjs.bind(SimpleSchema))
       const docB = createDoc(yjs.bind(SimpleSchema))
 
-      change(docA, (d: any) => {
+      batch(docA, (d: any) => {
         d.title.insert(0, "seed")
       })
       merge(docB, exportEntirety(docA), { origin: "sync" })
@@ -634,14 +635,14 @@ describe("YjsSubstrate", () => {
       subscribe(docB.title, () => {
         if (writes === 0 && (docB.title() as string) === "seedmore") {
           writes++
-          change(docB, (d: any) => {
+          batch(docB, (d: any) => {
             d.count.set(42)
           })
         }
       })
 
       const v0 = version(docB)
-      change(docA, (d: any) => {
+      batch(docA, (d: any) => {
         d.title.insert((d.title() as string).length, "more")
       })
       const delta = exportSince(docA, v0)!
@@ -652,4 +653,58 @@ describe("YjsSubstrate", () => {
       expect(writes).toBe(1)
     })
   })
+
+  // -------------------------------------------------------------------------
+  // Origin-free discriminator tests
+  // -------------------------------------------------------------------------
+
+  describe("origin-free discriminator", () => {
+    it("options.origin survives to transaction.origin", () => {
+      const doc = createDoc(yjs.bind(SimpleSchema))
+      const native = unwrap(doc) as Y.Doc
+
+      let capturedOrigin: string | undefined = "not-called"
+      native.on("afterTransaction", tr => {
+        capturedOrigin = tr.origin
+      })
+
+      batch(doc, d => d.title.insert(0, "x"), { origin: "undo" })
+      expect(capturedOrigin).toBe("undo")
+    })
+
+    it("external wrapping kyneta is correctly classified as own", () => {
+      const doc = createDoc(yjs.bind(SimpleSchema))
+
+      let kynetaFires = 0
+      subscribe(doc, () => {
+        kynetaFires++
+      })
+
+      const native = unwrap(doc) as Y.Doc
+      native.transact(() => {
+        batch(doc, d => d.title.insert(0, "x"))
+      }, "external")
+
+      // Should fire exactly once (captured via wrappedPrepare),
+      // and NOT twice (the bridge should skip the external transaction
+      // because the inner kyneta transact marked the transaction).
+      expect(kynetaFires).toBe(1)
+    })
+
+    it("external raw transact with any string origin is bridged", () => {
+      const doc = createDoc(yjs.bind(SimpleSchema))
+
+      let kynetaFires = 0
+      subscribe(doc, () => {
+        kynetaFires++
+      })
+
+      const native = unwrap(doc) as Y.Doc
+      native.transact(() => {
+        native.getMap("root").set("title", "ext")
+      }, "kyneta-prepare")
+
+      expect(kynetaFires).toBe(1)
+    })
+  })
 })

package/src/bind-yjs.ts

@@ -168,5 +168,5 @@ export const yjs: BindingTarget<YjsLaws, YjsNativeMap> = createBindingTarget<
 >({
   factory: ctx => createYjsFactory(ctx.peerId, ctx.binding),
   replicaFactory: yjsReplicaFactory,
-  syncProtocol: SYNC_COLLABORATIVE,
+  syncMode: SYNC_COLLABORATIVE,
 })