@kyneta/yjs-schema 1.2.0 → 1.3.1

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

@@ -16,18 +16,18 @@
 //   3. Reading back: doc.profiles() should return { [key]: { name, bio } }
 //   4. Sync: two peers should converge after exchanging deltas
 
-import { describe, expect, it } from "vitest"
 import {
   change,
-  createYjsDoc,
-  createYjsDocFromEntirety,
+  createDoc,
   exportEntirety,
   exportSince,
   merge,
   Schema,
   subscribe,
   version,
-} from "../index.js"
+} from "@kyneta/schema"
+import { describe, expect, it } from "vitest"
+import { yjs } from "../bind-yjs.js"
 
 // ===========================================================================
 // Schemas
@@ -60,13 +60,21 @@ const ListProfileSchema = Schema.struct({
   ),
 })
 
+// ===========================================================================
+// Bound schemas
+// ===========================================================================
+
+const BoundProfile = yjs.bind(ProfileSchema)
+const BoundPlainRecord = yjs.bind(PlainRecordSchema)
+const BoundListProfile = yjs.bind(ListProfileSchema)
+
 // ===========================================================================
 // Baseline: record-of-struct (plain, no text)
 // ===========================================================================
 
 describe("record-of-struct (plain baseline)", () => {
   it("set a record entry and read it back", () => {
-    const doc = createYjsDoc(PlainRecordSchema)
+    const doc = createDoc(BoundPlainRecord)
 
     change(doc, (d: any) => {
       d.profiles.set("alice", { displayName: "Alice", age: 30 })
@@ -79,7 +87,7 @@ describe("record-of-struct (plain baseline)", () => {
   })
 
   it("set multiple entries and read all back", () => {
-    const doc = createYjsDoc(PlainRecordSchema)
+    const doc = createDoc(BoundPlainRecord)
 
     change(doc, (d: any) => {
       d.profiles.set("alice", { displayName: "Alice", age: 30 })
@@ -94,7 +102,7 @@ describe("record-of-struct (plain baseline)", () => {
   })
 
   it("navigate into a record entry via .at()", () => {
-    const doc = createYjsDoc(PlainRecordSchema)
+    const doc = createDoc(BoundPlainRecord)
 
     change(doc, (d: any) => {
       d.profiles.set("alice", { displayName: "Alice", age: 30 })
@@ -107,14 +115,14 @@ describe("record-of-struct (plain baseline)", () => {
   })
 
   it("syncs record-of-struct between two peers via snapshot", () => {
-    const docA = createYjsDoc(PlainRecordSchema)
+    const docA = createDoc(BoundPlainRecord)
 
     change(docA, (d: any) => {
       d.profiles.set("alice", { displayName: "Alice", age: 30 })
     })
 
     const snapshot = exportEntirety(docA)
-    const docB = createYjsDocFromEntirety(PlainRecordSchema, snapshot)
+    const docB = createDoc(BoundPlainRecord, snapshot)
 
     expect(docB.profiles()).toEqual({
       alice: { displayName: "Alice", age: 30 },
@@ -122,17 +130,14 @@ describe("record-of-struct (plain baseline)", () => {
   })
 
   it("syncs record-of-struct between two peers via delta", () => {
-    const docA = createYjsDoc(PlainRecordSchema)
+    const docA = createDoc(BoundPlainRecord)
 
     change(docA, (d: any) => {
       d.profiles.set("alice", { displayName: "Alice", age: 30 })
     })
 
     // Establish docB from snapshot (avoids Yjs clientID collision)
-    const docB = createYjsDocFromEntirety(
-      PlainRecordSchema,
-      exportEntirety(docA),
-    )
+    const docB = createDoc(BoundPlainRecord, exportEntirety(docA))
 
     const v0 = version(docB)
 
@@ -157,7 +162,7 @@ describe("record-of-struct (plain baseline)", () => {
 
 describe("text-inside-struct-inside-record", () => {
   it("set a record entry with text field omitted and read it back", () => {
-    const doc = createYjsDoc(ProfileSchema)
+    const doc = createDoc(BoundProfile)
 
     change(doc, (d: any) => {
       d.profiles.set("alice", { displayName: "Alice" })
@@ -170,7 +175,7 @@ describe("text-inside-struct-inside-record", () => {
   })
 
   it("set a record entry with text field provided and read it back", () => {
-    const doc = createYjsDoc(ProfileSchema)
+    const doc = createDoc(BoundProfile)
 
     change(doc, (d: any) => {
       d.profiles.set("alice", { displayName: "Alice", bio: "Hello world" })
@@ -183,7 +188,7 @@ describe("text-inside-struct-inside-record", () => {
   })
 
   it("navigate into a record entry and read the text", () => {
-    const doc = createYjsDoc(ProfileSchema)
+    const doc = createDoc(BoundProfile)
 
     change(doc, (d: any) => {
       d.profiles.set("alice", { displayName: "Alice" })
@@ -196,7 +201,7 @@ describe("text-inside-struct-inside-record", () => {
   })
 
   it("insert text into a text field inside a record entry (field omitted at creation)", () => {
-    const doc = createYjsDoc(ProfileSchema)
+    const doc = createDoc(BoundProfile)
 
     change(doc, (d: any) => {
       d.profiles.set("alice", { displayName: "Alice" })
@@ -210,7 +215,7 @@ describe("text-inside-struct-inside-record", () => {
   })
 
   it("insert text into a text field inside a record entry (field provided at creation)", () => {
-    const doc = createYjsDoc(ProfileSchema)
+    const doc = createDoc(BoundProfile)
 
     change(doc, (d: any) => {
       d.profiles.set("alice", { displayName: "Alice", bio: "Initial" })
@@ -224,7 +229,7 @@ describe("text-inside-struct-inside-record", () => {
   })
 
   it("set multiple entries and edit text independently", () => {
-    const doc = createYjsDoc(ProfileSchema)
+    const doc = createDoc(BoundProfile)
 
     change(doc, (d: any) => {
       d.profiles.set("alice", { displayName: "Alice" })
@@ -241,7 +246,7 @@ describe("text-inside-struct-inside-record", () => {
   })
 
   it("subscribe fires on text edit inside record entry", () => {
-    const doc = createYjsDoc(ProfileSchema)
+    const doc = createDoc(BoundProfile)
 
     change(doc, (d: any) => {
       d.profiles.set("alice", { displayName: "Alice" })
@@ -260,7 +265,7 @@ describe("text-inside-struct-inside-record", () => {
   })
 
   it("syncs text-inside-record via snapshot", () => {
-    const docA = createYjsDoc(ProfileSchema)
+    const docA = createDoc(BoundProfile)
 
     change(docA, (d: any) => {
       d.profiles.set("alice", { displayName: "Alice" })
@@ -270,7 +275,7 @@ describe("text-inside-struct-inside-record", () => {
     })
 
     const snapshot = exportEntirety(docA)
-    const docB = createYjsDocFromEntirety(ProfileSchema, snapshot)
+    const docB = createDoc(BoundProfile, snapshot)
 
     expect(docB.profiles()).toEqual({
       alice: { displayName: "Alice", bio: "Collaborative bio" },
@@ -281,7 +286,7 @@ describe("text-inside-struct-inside-record", () => {
   })
 
   it("syncs text-inside-record via delta", () => {
-    const docA = createYjsDoc(ProfileSchema)
+    const docA = createDoc(BoundProfile)
 
     change(docA, (d: any) => {
       d.profiles.set("alice", { displayName: "Alice" })
@@ -290,7 +295,7 @@ describe("text-inside-struct-inside-record", () => {
     // Establish docB from snapshot (consistent with Yjs test patterns —
     // two independently-created Y.Docs may share a clientID, causing
     // silent update drops)
-    const docB = createYjsDocFromEntirety(ProfileSchema, exportEntirety(docA))
+    const docB = createDoc(BoundProfile, exportEntirety(docA))
     const v0 = version(docB)
 
     change(docA, (d: any) => {
@@ -313,13 +318,13 @@ describe("text-inside-struct-inside-record", () => {
   })
 
   it("concurrent text edits inside record entries converge", () => {
-    const docA = createYjsDoc(ProfileSchema)
+    const docA = createDoc(BoundProfile)
 
     // Sync initial state: A creates the entry, B starts from snapshot
     change(docA, (d: any) => {
       d.profiles.set("alice", { displayName: "Alice" })
     })
-    const docB = createYjsDocFromEntirety(ProfileSchema, exportEntirety(docA))
+    const docB = createDoc(BoundProfile, exportEntirety(docA))
 
     // Both peers edit concurrently
     const vA = version(docA)
@@ -353,7 +358,7 @@ describe("text-inside-struct-inside-record", () => {
 
 describe("text-inside-struct-inside-list", () => {
   it("push a struct with text field omitted and read it back", () => {
-    const doc = createYjsDoc(ListProfileSchema)
+    const doc = createDoc(BoundListProfile)
 
     change(doc, (d: any) => {
       d.players.push({ name: "Alice" })
@@ -365,7 +370,7 @@ describe("text-inside-struct-inside-list", () => {
   })
 
   it("push a struct with text field provided and read it back", () => {
-    const doc = createYjsDoc(ListProfileSchema)
+    const doc = createDoc(BoundListProfile)
 
     change(doc, (d: any) => {
       d.players.push({ name: "Alice", bio: "Hi there" })
@@ -377,7 +382,7 @@ describe("text-inside-struct-inside-list", () => {
   })
 
   it("insert text into a text field inside a list item (field omitted at creation)", () => {
-    const doc = createYjsDoc(ListProfileSchema)
+    const doc = createDoc(BoundListProfile)
 
     change(doc, (d: any) => {
       d.players.push({ name: "Alice" })
@@ -391,7 +396,7 @@ describe("text-inside-struct-inside-list", () => {
   })
 
   it("multiple list items with independent text fields", () => {
-    const doc = createYjsDoc(ListProfileSchema)
+    const doc = createDoc(BoundListProfile)
 
     change(doc, (d: any) => {
       d.players.push({ name: "Alice" })
@@ -408,17 +413,14 @@ describe("text-inside-struct-inside-list", () => {
   })
 
   it("syncs list-of-struct-with-text via delta", () => {
-    const docA = createYjsDoc(ListProfileSchema)
+    const docA = createDoc(BoundListProfile)
 
     change(docA, (d: any) => {
       d.players.push({ name: "Alice" })
     })
 
     // Establish docB from snapshot (avoids Yjs clientID collision)
-    const docB = createYjsDocFromEntirety(
-      ListProfileSchema,
-      exportEntirety(docA),
-    )
+    const docB = createDoc(BoundListProfile, exportEntirety(docA))
     const v0 = version(docB)
 
     change(docA, (d: any) => {

package/src/__tests__/substrate.test.ts

@@ -1,10 +1,20 @@
-import { change, RawPath, Schema, subscribe } from "@kyneta/schema"
+import {
+  change,
+  createDoc,
+  createRef,
+  exportEntirety,
+  exportSince,
+  merge,
+  RawPath,
+  Schema,
+  subscribe,
+  version,
+} from "@kyneta/schema"
 import { describe, expect, it } from "vitest"
 import * as Y from "yjs"
-import { createYjsDoc, createYjsDocFromEntirety } from "../create.js"
+import { yjs } from "../bind-yjs.js"
 import { ensureContainers } from "../populate.js"
-import { yjsSubstrateFactory } from "../substrate.js"
-import { exportEntirety, exportSince, merge, version } from "../sync.js"
+import { createYjsSubstrate, yjsSubstrateFactory } from "../substrate.js"
 import { YjsVersion } from "../version.js"
 
 // ===========================================================================
@@ -66,7 +76,7 @@ describe("YjsSubstrate", () => {
     })
 
     it("creates a substrate and populates via change()", () => {
-      const doc = createYjsDoc(SimpleSchema)
+      const doc = createDoc(yjs.bind(SimpleSchema))
       change(doc, (d: any) => {
         d.title.insert(0, "Hello")
         d.count.set(42)
@@ -81,7 +91,7 @@ describe("YjsSubstrate", () => {
     })
 
     it("creates a substrate with partial values (unset fields stay empty)", () => {
-      const doc = createYjsDoc(SimpleSchema)
+      const doc = createDoc(yjs.bind(SimpleSchema))
       change(doc, (d: any) => {
         d.title.insert(0, "Partial")
       })
@@ -91,7 +101,7 @@ describe("YjsSubstrate", () => {
     })
 
     it("creates a substrate with nested struct values via change()", () => {
-      const doc = createYjsDoc(FullSchema)
+      const doc = createDoc(yjs.bind(FullSchema))
       change(doc, (d: any) => {
         d.meta.author.set("Alice")
       })
@@ -99,7 +109,7 @@ describe("YjsSubstrate", () => {
     })
 
     it("creates a substrate with struct list values via change()", () => {
-      const doc = createYjsDoc(StructListSchema)
+      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 }))
@@ -114,7 +124,7 @@ describe("YjsSubstrate", () => {
 
   describe("write round-trip", () => {
     it("text insert round-trips through prepare/flush", () => {
-      const doc = createYjsDoc(SimpleSchema)
+      const doc = createDoc(yjs.bind(SimpleSchema))
       change(doc, (d: any) => {
         d.title.insert(0, "Hello")
       })
@@ -122,7 +132,7 @@ describe("YjsSubstrate", () => {
     })
 
     it("scalar set round-trips through prepare/flush", () => {
-      const doc = createYjsDoc(SimpleSchema)
+      const doc = createDoc(yjs.bind(SimpleSchema))
       change(doc, (d: any) => {
         d.count.set(42)
       })
@@ -130,7 +140,7 @@ describe("YjsSubstrate", () => {
     })
 
     it("list push round-trips through prepare/flush", () => {
-      const doc = createYjsDoc(SimpleSchema)
+      const doc = createDoc(yjs.bind(SimpleSchema))
       change(doc, (d: any) => {
         d.items.push("a")
       })
@@ -148,7 +158,7 @@ describe("YjsSubstrate", () => {
 
   describe("version tracking", () => {
     it("version advances after mutations", () => {
-      const doc = createYjsDoc(SimpleSchema)
+      const doc = createDoc(yjs.bind(SimpleSchema))
       const v1 = version(doc)
 
       change(doc, (d: any) => {
@@ -161,7 +171,7 @@ describe("YjsSubstrate", () => {
     })
 
     it("version serialize/parse round-trips", () => {
-      const doc = createYjsDoc(SimpleSchema)
+      const doc = createDoc(yjs.bind(SimpleSchema))
       change(doc, (d: any) => {
         d.title.insert(0, "Test")
         d.count.set(5)
@@ -180,7 +190,7 @@ describe("YjsSubstrate", () => {
 
   describe("export/import snapshot", () => {
     it("exports a binary payload", () => {
-      const doc = createYjsDoc(SimpleSchema)
+      const doc = createDoc(yjs.bind(SimpleSchema))
       change(doc, (d: any) => {
         d.title.insert(0, "Snapshot")
       })
@@ -190,7 +200,7 @@ describe("YjsSubstrate", () => {
     })
 
     it("reconstructs equivalent state from snapshot", () => {
-      const doc1 = createYjsDoc(SimpleSchema)
+      const doc1 = createDoc(yjs.bind(SimpleSchema))
       change(doc1, (d: any) => {
         d.title.insert(0, "Hello")
         d.count.set(42)
@@ -203,7 +213,7 @@ describe("YjsSubstrate", () => {
       })
 
       const payload = exportEntirety(doc1)
-      const doc2 = createYjsDocFromEntirety(SimpleSchema, payload)
+      const doc2 = createDoc(yjs.bind(SimpleSchema), payload)
 
       expect(doc2.title()).toBe("Hello World")
       expect(doc2.count()).toBe(42)
@@ -217,11 +227,11 @@ describe("YjsSubstrate", () => {
 
   describe("delta sync", () => {
     it("exportSince → merge syncs state", () => {
-      const doc1 = createYjsDoc(SimpleSchema)
+      const doc1 = createDoc(yjs.bind(SimpleSchema))
       change(doc1, (d: any) => {
         d.title.insert(0, "Start")
       })
-      const doc2 = createYjsDocFromEntirety(SimpleSchema, exportEntirety(doc1))
+      const doc2 = createDoc(yjs.bind(SimpleSchema), exportEntirety(doc1))
 
       const v1Before = version(doc1)
 
@@ -239,8 +249,8 @@ describe("YjsSubstrate", () => {
     })
 
     it("concurrent sync — two substrates converge after bidirectional sync", () => {
-      const doc1 = createYjsDoc(SimpleSchema)
-      const doc2 = createYjsDocFromEntirety(SimpleSchema, exportEntirety(doc1))
+      const doc1 = createDoc(yjs.bind(SimpleSchema))
+      const doc2 = createDoc(yjs.bind(SimpleSchema), exportEntirety(doc1))
 
       const v1Before = version(doc1)
       const v2Before = version(doc2)
@@ -285,11 +295,11 @@ describe("YjsSubstrate", () => {
 
   describe("changefeed", () => {
     it("fires on merge", () => {
-      const doc1 = createYjsDoc(SimpleSchema)
+      const doc1 = createDoc(yjs.bind(SimpleSchema))
       change(doc1, (d: any) => {
         d.title.insert(0, "A")
       })
-      const doc2 = createYjsDocFromEntirety(SimpleSchema, exportEntirety(doc1))
+      const doc2 = createDoc(yjs.bind(SimpleSchema), exportEntirety(doc1))
 
       const v2Before = version(doc2)
 
@@ -312,7 +322,10 @@ describe("YjsSubstrate", () => {
     it("fires on external Y.Doc mutation (raw Yjs API)", () => {
       const yjsDoc = new Y.Doc()
       ensureContainers(yjsDoc, SimpleSchema)
-      const doc = createYjsDoc(SimpleSchema, yjsDoc)
+      const doc = createRef(
+        SimpleSchema,
+        createYjsSubstrate(yjsDoc, SimpleSchema),
+      )
 
       const received: any[] = []
       subscribe(doc, (changeset: any) => {
@@ -328,7 +341,7 @@ describe("YjsSubstrate", () => {
     })
 
     it("no double-fire on kyneta local writes", () => {
-      const doc = createYjsDoc(SimpleSchema)
+      const doc = createDoc(yjs.bind(SimpleSchema))
 
       const received: any[] = []
       subscribe(doc, (changeset: any) => {
@@ -345,18 +358,15 @@ describe("YjsSubstrate", () => {
     })
 
     it("nested struct field changefeed fires on merge", () => {
-      const doc1 = createYjsDoc(StructListSchema)
-      const _doc2 = createYjsDocFromEntirety(
-        StructListSchema,
-        exportEntirety(doc1),
-      )
+      const doc1 = createDoc(yjs.bind(StructListSchema))
+      const _doc2 = createDoc(yjs.bind(StructListSchema), exportEntirety(doc1))
 
       // Add a struct item on doc1, sync to doc2
       change(doc1, (d: any) => {
         d.tasks.push({ name: "Buy milk", done: false })
       })
       const snap = exportEntirety(doc1)
-      const doc2b = createYjsDocFromEntirety(StructListSchema, snap)
+      const doc2b = createDoc(yjs.bind(StructListSchema), snap)
 
       const taskB = [...doc2b.tasks][0] as any
       expect(taskB.done()).toBe(false)
@@ -387,16 +397,13 @@ describe("YjsSubstrate", () => {
     })
 
     it("multi-key struct update fires per-field changefeeds on merge", () => {
-      const doc1 = createYjsDoc(StructListSchema)
+      const doc1 = createDoc(yjs.bind(StructListSchema))
 
       // Add a struct item, sync to doc2
       change(doc1, (d: any) => {
         d.tasks.push({ name: "Buy milk", done: false })
       })
-      const doc2 = createYjsDocFromEntirety(
-        StructListSchema,
-        exportEntirety(doc1),
-      )
+      const doc2 = createDoc(yjs.bind(StructListSchema), exportEntirety(doc1))
 
       const taskB = [...doc2.tasks][0] as any
       const v2 = version(doc2)
@@ -438,7 +445,7 @@ describe("YjsSubstrate", () => {
 
   describe("transaction support", () => {
     it("multi-op change() is atomic", () => {
-      const doc = createYjsDoc(SimpleSchema)
+      const doc = createDoc(yjs.bind(SimpleSchema))
 
       const received: any[] = []
       subscribe(doc, (changeset: any) => {
@@ -474,7 +481,7 @@ describe("YjsSubstrate", () => {
 
   describe("nested structure", () => {
     it("push struct into list, read back via navigation", () => {
-      const doc = createYjsDoc(StructListSchema)
+      const doc = createDoc(yjs.bind(StructListSchema))
 
       change(doc, (d: any) => {
         d.tasks.push({ name: "Task 1", done: false })
@@ -494,7 +501,7 @@ describe("YjsSubstrate", () => {
     })
 
     it("nested struct write round-trip", () => {
-      const doc = createYjsDoc(FullSchema)
+      const doc = createDoc(yjs.bind(FullSchema))
       change(doc, (d: any) => {
         d.meta.author.set("Alice")
       })
@@ -553,7 +560,7 @@ describe("YjsSubstrate", () => {
     })
 
     it("reconstructs from snapshot with correct state", () => {
-      const doc = createYjsDoc(SimpleSchema)
+      const doc = createDoc(yjs.bind(SimpleSchema))
       change(doc, (d: any) => {
         d.title.insert(0, "Snapshot Test")
         d.count.set(77)
@@ -561,7 +568,7 @@ describe("YjsSubstrate", () => {
       })
 
       const payload = exportEntirety(doc)
-      const doc2 = createYjsDocFromEntirety(SimpleSchema, payload)
+      const doc2 = createDoc(yjs.bind(SimpleSchema), payload)
 
       expect(doc2.title()).toBe("Snapshot Test")
       expect(doc2.count()).toBe(77)

package/src/bind-yjs.ts

@@ -1,8 +1,8 @@
 // bind-yjs — Yjs CRDT substrate namespace and factory.
 //
-// Provides the `yjs` substrate namespace (`yjs.bind()`, `yjs.replica()`,
-// `yjs.unwrap()`) and the internal factory builder that injects a
-// deterministic numeric Yjs clientID derived from the exchange's peerId.
+// Provides the `yjs` substrate namespace (`yjs.bind()`, `yjs.replica()`)
+// and the internal factory builder that injects a deterministic numeric
+// Yjs clientID derived from the exchange's peerId.
 //
 // Yjs clientID is a uint32 number. We use FNV-1a hash truncated to
 // 32 bits, mirroring the Loro binding's hashPeerId pattern but
@@ -31,9 +31,9 @@ import {
   BACKING_DOC,
   createSubstrateNamespace,
   STRUCTURAL_YJS_CLIENT_ID,
-  unwrap,
 } from "@kyneta/schema"
 import * as Y from "yjs"
+import type { YjsNativeMap } from "./native-map.js"
 import { ensureContainers } from "./populate.js"
 import {
   createYjsReplica,
@@ -142,19 +142,17 @@ function createYjsFactory(peerId: string): SubstrateFactory<YjsVersion> {
  * - `yjs.bind(schema, "ephemeral")` — ephemeral/presence broadcast
  * - `yjs.replica()` — collaborative replication (default)
  * - `yjs.replica("ephemeral")` — ephemeral replication
- * - `yjs.unwrap(ref)` — access the underlying Y.Doc
  *
  * Strategy is constrained to `CrdtStrategy` (`"collaborative" | "ephemeral"`).
  * Passing `"authoritative"` is a compile error.
+ *
+ * To access the underlying Y.Doc, use `unwrap(ref)` from `@kyneta/schema`.
  */
 /** The closed set of capability tags that the Yjs substrate supports. */
 export type YjsCaps = "text" | "json"
 
-export const yjs: SubstrateNamespace<CrdtStrategy, YjsCaps> & {
-  /** Access the underlying `Y.Doc` backing a ref. */
-  unwrap(ref: object): Y.Doc
-} = {
-  ...createSubstrateNamespace<CrdtStrategy, YjsCaps>({
+export const yjs: SubstrateNamespace<CrdtStrategy, YjsCaps, YjsNativeMap> =
+  createSubstrateNamespace<CrdtStrategy, YjsCaps, YjsNativeMap>({
     strategies: {
       collaborative: {
         factory: ctx => createYjsFactory(ctx.peerId),
@@ -166,33 +164,4 @@ export const yjs: SubstrateNamespace<CrdtStrategy, YjsCaps> & {
       },
     },
     defaultStrategy: "collaborative",
-  }),
-
-  unwrap(ref: object): Y.Doc {
-    let substrate: any
-    try {
-      substrate = unwrap(ref)
-    } catch {
-      throw new Error(
-        "yjs.unwrap() requires a ref backed by a Yjs substrate. " +
-          "Use a doc created by exchange.get() with a yjs.bind() schema, " +
-          "or by createYjsDoc().",
-      )
-    }
-
-    const doc = substrate[BACKING_DOC]
-    if (
-      !doc ||
-      typeof doc !== "object" ||
-      typeof (doc as any).getMap !== "function" ||
-      typeof (doc as any).clientID !== "number"
-    ) {
-      throw new Error(
-        "yjs.unwrap() requires a ref backed by a Yjs substrate. " +
-          "The ref has a substrate but it is not a Yjs substrate. " +
-          "Use a doc created with a yjs.bind() schema or createYjsDoc().",
-      )
-    }
-    return doc as Y.Doc
-  },
-}
+  })

package/src/change-mapping.ts

@@ -29,7 +29,12 @@ import type {
   TextChange,
   TextInstruction,
 } from "@kyneta/schema"
-import { advanceSchema, expandMapOpsToLeaves, KIND, RawPath } from "@kyneta/schema"
+import {
+  advanceSchema,
+  expandMapOpsToLeaves,
+  KIND,
+  RawPath,
+} from "@kyneta/schema"
 import * as Y from "yjs"
 import { resolveYjsType } from "./yjs-resolve.js"
 
@@ -585,4 +590,4 @@ function getFieldSchema(
 
 function pathToString(path: Path): string {
   return path.segments.map(seg => String(seg.resolve())).join(".")
-}
+}