@vuer-ai/vuer-rtc-server 0.2.3 → 0.4.1

package/tests/e2e/latency.test.ts

@@ -9,19 +9,25 @@ import { describe, it, expect, beforeEach, afterEach } from '@jest/globals';
 import { createTestServer, type TestServer } from './helpers/createTestServer.js';
 import { waitForConvergence, assertGraphsEqual } from './helpers/assertions.js';
 import type { GraphStore } from '@vuer-ai/vuer-rtc';
+import { getText } from '@vuer-ai/vuer-rtc';
+
+/** Safe wrapper to get text content from node properties (which are typed as unknown) */
+function getNodeText(content: unknown): string {
+  return getText(content as any);
+}
 
 // ── Helpers ───────────────────────────────────────────────────
 
 /** Insert a scene root + a mesh node so property ops have a target. */
 function seedGraph(store: GraphStore): void {
   store.edit({
-    otype: 'node.insert',
+    ot: 'node.insert',
     key: '',
     path: 'children',
     value: { key: 'scene', tag: 'Scene', name: 'Scene' },
   });
   store.edit({
-    otype: 'node.insert',
+    ot: 'node.insert',
     key: 'scene',
     path: 'children',
     value: {
@@ -38,19 +44,19 @@ function seedGraph(store: GraphStore): void {
 /** Insert a scene root + a text doc node. */
 function seedTextGraph(store: GraphStore): void {
   store.edit({
-    otype: 'node.insert',
+    ot: 'node.insert',
     key: '',
     path: 'children',
     value: { key: 'scene', tag: 'Scene', name: 'Scene' },
   });
   store.edit({
-    otype: 'node.insert',
+    ot: 'node.insert',
     key: 'scene',
     path: 'children',
     value: { key: 'text-doc', tag: 'Text', name: 'Doc' },
   });
   store.edit({
-    otype: 'text.init',
+    ot: 'text.init',
     key: 'text-doc',
     path: 'content',
   });
@@ -80,7 +86,7 @@ describe('latency', () => {
     await waitForConvergence([clientA.store, clientB.store], 5000);
 
     clientA.store.edit({
-      otype: 'vector3.set',
+      ot: 'vector3.set',
       key: 'cube-1',
       path: 'position',
       value: [10, 20, 30],
@@ -106,13 +112,13 @@ describe('latency', () => {
 
     // Both edit concurrently
     clientA.store.edit({
-      otype: 'vector3.set',
+      ot: 'vector3.set',
       key: 'cube-1',
       path: 'position',
       value: [1, 0, 0],
     });
     clientB.store.edit({
-      otype: 'vector3.set',
+      ot: 'vector3.set',
       key: 'cube-1',
       path: 'position',
       value: [0, 1, 0],
@@ -139,13 +145,13 @@ describe('latency', () => {
 
     // A edits position, B edits opacity — no conflict
     clientA.store.edit({
-      otype: 'vector3.set',
+      ot: 'vector3.set',
       key: 'cube-1',
       path: 'position',
       value: [5, 5, 5],
     });
     clientB.store.edit({
-      otype: 'number.set',
+      ot: 'number.set',
       key: 'cube-1',
       path: 'opacity',
       value: 0.3,
@@ -176,7 +182,7 @@ describe('latency', () => {
     // Client A sends 10 rapid number.add ops
     for (let i = 0; i < 10; i++) {
       clientA.store.edit({
-        otype: 'number.add',
+        ot: 'number.add',
         key: 'cube-1',
         path: 'opacity',
         value: 1,
@@ -206,19 +212,19 @@ describe('latency', () => {
 
     // All three edit concurrently
     clientA.store.edit({
-      otype: 'vector3.set',
+      ot: 'vector3.set',
       key: 'cube-1',
       path: 'position',
       value: [1, 0, 0],
     });
     clientB.store.edit({
-      otype: 'number.set',
+      ot: 'number.set',
       key: 'cube-1',
       path: 'opacity',
       value: 0.5,
     });
     clientC.store.edit({
-      otype: 'node.insert',
+      ot: 'node.insert',
       key: 'scene',
       path: 'children',
       value: { key: 'sphere-1', tag: 'Mesh', name: 'Sphere' },
@@ -250,7 +256,7 @@ describe('latency', () => {
     await waitForConvergence([clientA.store, clientB.store], 5000);
 
     clientA.store.edit({
-      otype: 'vector3.set',
+      ot: 'vector3.set',
       key: 'cube-1',
       path: 'position',
       value: [42, 42, 42],
@@ -284,26 +290,26 @@ describe('latency', () => {
 
     // Client A inserts "Hello"
     clientA.store.edit({
-      otype: 'text.insert',
+      ot: 'text.insert',
       key: 'text-doc',
       path: 'content',
       position: 0,
-      value: 'Hello',
+      value: [null, 'Hello'],
     });
     clientA.store.commit('A types Hello');
 
     await waitForConvergence([clientA.store, clientB.store], 5000);
 
-    const contentB = clientB.store.getState().graph.nodes['text-doc'].content;
+    const contentB = getNodeText(clientB.store.getState().graph.nodes['text-doc'].content);
     expect(contentB).toBe('Hello');
 
     // Client B appends " World" (after seeing A's edit)
     clientB.store.edit({
-      otype: 'text.insert',
+      ot: 'text.insert',
       key: 'text-doc',
       path: 'content',
       position: 5,
-      value: ' World',
+      value: [null, ' World'],
     });
     clientB.store.commit('B types World');
 
@@ -312,7 +318,7 @@ describe('latency', () => {
     const graphA = clientA.store.getState().graph;
     const graphB = clientB.store.getState().graph;
     assertGraphsEqual(graphA, graphB);
-    expect(graphA.nodes['text-doc'].content).toBe('Hello World');
+    expect(getNodeText(graphA.nodes['text-doc'].content)).toBe('Hello World');
   });
 
   // ── 8. High latency text edits (regression test) ────────────
@@ -330,11 +336,11 @@ describe('latency', () => {
     const chars = 'abcdef';
     for (let i = 0; i < chars.length; i++) {
       clientA.store.edit({
-        otype: 'text.insert',
+        ot: 'text.insert',
         key: 'text-doc',
         path: 'content',
         position: i,
-        value: chars[i],
+        value: [null, chars[i]],
       });
       clientA.store.commit(`type ${chars[i]}`);
     }
@@ -346,8 +352,8 @@ describe('latency', () => {
     assertGraphsEqual(graphA, graphB);
 
     // Both clients should have exactly "abcdef" — no duplication
-    expect(graphA.nodes['text-doc'].content).toBe('abcdef');
-    expect(graphB.nodes['text-doc'].content).toBe('abcdef');
+    expect(getNodeText(graphA.nodes['text-doc'].content)).toBe('abcdef');
+    expect(getNodeText(graphB.nodes['text-doc'].content)).toBe('abcdef');
   });
 
   // ── 9. Concurrent node inserts produce deterministic children order ──
@@ -360,11 +366,11 @@ describe('latency', () => {
     await waitForConvergence([clientA.store, clientB.store], 5000);
 
     const sceneKey = Object.values(clientA.store.getState().graph.nodes)
-      .find((n) => n.tag === 'Scene' && !n._crdt?.deletedAt)!.key;
+      .find((n) => n.tag === 'Scene' && !(n._crdt as any)?.deletedAt)!.key;
 
     // Both clients insert a sphere concurrently (before seeing each other's ops)
     clientA.store.edit({
-      otype: 'node.insert',
+      ot: 'node.insert',
       key: sceneKey,
       path: 'children',
       value: { key: 'sphere-a', tag: 'Mesh', name: 'Sphere A' },
@@ -372,7 +378,7 @@ describe('latency', () => {
     clientA.store.commit('insert sphere A');
 
     clientB.store.edit({
-      otype: 'node.insert',
+      ot: 'node.insert',
       key: sceneKey,
       path: 'children',
       value: { key: 'sphere-b', tag: 'Mesh', name: 'Sphere B' },
@@ -404,9 +410,9 @@ describe('latency', () => {
 
     // Client A inserts a sphere before previous ops are acked
     clientA.store.edit({
-      otype: 'node.insert',
+      ot: 'node.insert',
       key: Object.values(clientA.store.getState().graph.nodes)
-        .find((n) => n.tag === 'Scene' && !n._crdt?.deletedAt)!.key,
+        .find((n) => n.tag === 'Scene' && !(n._crdt as any)?.deletedAt)!.key,
       path: 'children',
       value: { key: 'sphere-hi-lat', tag: 'Mesh', name: 'Sphere' },
     });
@@ -435,11 +441,11 @@ describe('latency', () => {
     const textA = 'does this work?';
     for (let i = 0; i < textA.length; i++) {
       clientA.store.edit({
-        otype: 'text.insert',
+        ot: 'text.insert',
         key: 'text-doc',
         path: 'content',
         position: i,
-        value: textA[i],
+        value: [null, textA[i]],
       });
       clientA.store.commit(`A types '${textA[i]}'`);
     }
@@ -448,11 +454,11 @@ describe('latency', () => {
     const textB = '\n1. \n2. \n3. ';
     for (let i = 0; i < textB.length; i++) {
       clientB.store.edit({
-        otype: 'text.insert',
+        ot: 'text.insert',
         key: 'text-doc',
         path: 'content',
         position: i,
-        value: textB[i],
+        value: [null, textB[i]],
       });
       clientB.store.commit(`B types '${textB[i]}'`);
     }
@@ -464,8 +470,8 @@ describe('latency', () => {
     assertGraphsEqual(graphA, graphB);
 
     // Both must see the same text content (exact order is CRDT-determined)
-    expect(graphA.nodes['text-doc'].content).toBe(
-      graphB.nodes['text-doc'].content,
+    expect(getNodeText(graphA.nodes['text-doc'].content)).toBe(
+      getNodeText(graphB.nodes['text-doc'].content),
     );
   });
 
@@ -480,21 +486,21 @@ describe('latency', () => {
 
     // A types "Hello" at position 0
     clientA.store.edit({
-      otype: 'text.insert',
+      ot: 'text.insert',
       key: 'text-doc',
       path: 'content',
       position: 0,
-      value: 'Hello',
+      value: [null, 'Hello'],
     });
     clientA.store.commit('A types Hello');
 
     // B types "World" at position 0 (concurrently, before seeing A's edit)
     clientB.store.edit({
-      otype: 'text.insert',
+      ot: 'text.insert',
       key: 'text-doc',
       path: 'content',
       position: 0,
-      value: 'World',
+      value: [null, 'World'],
     });
     clientB.store.commit('B types World');
 
@@ -505,7 +511,7 @@ describe('latency', () => {
     assertGraphsEqual(graphA, graphB);
 
     // Both should have both words (exact order is CRDT-determined)
-    const content = graphA.nodes['text-doc'].content;
+    const content = getNodeText(graphA.nodes['text-doc'].content);
     expect(content).toContain('Hello');
     expect(content).toContain('World');
   });

package/tests/e2e/packet-loss.test.ts

@@ -14,13 +14,13 @@ import type { GraphStore } from '@vuer-ai/vuer-rtc';
 
 function seedGraph(store: GraphStore): void {
   store.edit({
-    otype: 'node.insert',
+    ot: 'node.insert',
     key: '',
     path: 'children',
     value: { key: 'scene', tag: 'Scene', name: 'Scene' },
   });
   store.edit({
-    otype: 'node.insert',
+    ot: 'node.insert',
     key: 'scene',
     path: 'children',
     value: {
@@ -90,7 +90,7 @@ describe('packet-loss', () => {
     // B has 50% drop — acks from server may be lost
 
     clientA.store.edit({
-      otype: 'vector3.set',
+      ot: 'vector3.set',
       key: 'cube-1',
       path: 'position',
       value: [10, 20, 30],
@@ -98,7 +98,7 @@ describe('packet-loss', () => {
     clientA.store.commit('move cube');
 
     clientB.store.edit({
-      otype: 'number.set',
+      ot: 'number.set',
       key: 'cube-1',
       path: 'opacity',
       value: 0.7,
@@ -156,7 +156,7 @@ describe('packet-loss', () => {
 
     // Make an edit and commit
     clientA.store.edit({
-      otype: 'vector3.set',
+      ot: 'vector3.set',
       key: 'cube-1',
       path: 'position',
       value: [99, 99, 99],
@@ -199,7 +199,7 @@ describe('packet-loss', () => {
     // For deterministic behavior, we just retry until converged
 
     clientA.store.edit({
-      otype: 'number.add',
+      ot: 'number.add',
       key: 'cube-1',
       path: 'opacity',
       value: 5,

package/tests/e2e/relay.test.ts

@@ -16,13 +16,13 @@ import type { GraphStore, CRDTMessage } from '@vuer-ai/vuer-rtc';
 /** Insert a scene root + a mesh node so property ops have a target. */
 function seedGraph(store: GraphStore): void {
   store.edit({
-    otype: 'node.insert',
+    ot: 'node.insert',
     key: '',
     path: 'children',
     value: { key: 'scene', tag: 'Scene', name: 'Scene' },
   });
   store.edit({
-    otype: 'node.insert',
+    ot: 'node.insert',
     key: 'scene',
     path: 'children',
     value: {
@@ -63,7 +63,7 @@ describe('relay', () => {
 
     // Client A edits position
     clientA.store.edit({
-      otype: 'vector3.set',
+      ot: 'vector3.set',
       key: 'cube-1',
       path: 'position',
       value: [1, 2, 3],
@@ -98,7 +98,7 @@ describe('relay', () => {
 
     // Now make an edit and commit
     clientA.store.edit({
-      otype: 'vector3.set',
+      ot: 'vector3.set',
       key: 'cube-1',
       path: 'position',
       value: [5, 5, 5],
@@ -132,7 +132,7 @@ describe('relay', () => {
 
     // Client A edits and commits
     clientA.store.edit({
-      otype: 'vector3.set',
+      ot: 'vector3.set',
       key: 'cube-1',
       path: 'position',
       value: [10, 20, 30],
@@ -184,7 +184,7 @@ describe('relay', () => {
 
     // Client A sends multiple commits
     clientA.store.edit({
-      otype: 'vector3.set',
+      ot: 'vector3.set',
       key: 'cube-1',
       path: 'position',
       value: [1, 0, 0],
@@ -192,7 +192,7 @@ describe('relay', () => {
     clientA.store.commit('move 1');
 
     clientA.store.edit({
-      otype: 'vector3.set',
+      ot: 'vector3.set',
       key: 'cube-1',
       path: 'position',
       value: [2, 0, 0],
@@ -200,7 +200,7 @@ describe('relay', () => {
     clientA.store.commit('move 2');
 
     clientA.store.edit({
-      otype: 'vector3.set',
+      ot: 'vector3.set',
       key: 'cube-1',
       path: 'position',
       value: [3, 0, 0],
@@ -231,7 +231,7 @@ describe('relay', () => {
 
     // Client A edits position
     clientA.store.edit({
-      otype: 'vector3.set',
+      ot: 'vector3.set',
       key: 'cube-1',
       path: 'position',
       value: [7, 8, 9],

package/tests/e2e/sync-perf.test.ts

@@ -14,13 +14,13 @@ import { waitFor, waitForConvergence, assertGraphsEqual } from './helpers/assert
 
 function seedGraph(store: GraphStore): void {
   store.edit({
-    otype: 'node.insert',
+    ot: 'node.insert',
     key: '',
     path: 'children',
     value: { key: 'scene', tag: 'Scene', name: 'Scene' },
   });
   store.edit({
-    otype: 'node.insert',
+    ot: 'node.insert',
     key: 'scene',
     path: 'children',
     value: {
@@ -38,7 +38,7 @@ function seedGraph(store: GraphStore): void {
 function generateEdits(store: GraphStore, n: number): void {
   for (let i = 0; i < n; i++) {
     store.edit({
-      otype: 'vector3.set',
+      ot: 'vector3.set',
       key: 'cube-1',
       path: 'position',
       value: [i, i * 2, i * 3],
@@ -222,7 +222,7 @@ describe('sync-perf', () => {
     for (let i = 0; i < N_CLIENTS; i++) {
       for (let j = 0; j < EDITS_PER_CLIENT; j++) {
         clients[i].store.edit({
-          otype: 'number.set',
+          ot: 'number.set',
           key: 'cube-1',
           path: `prop_${i}_${j}`,
           value: i * 1000 + j,
@@ -299,7 +299,7 @@ describe('sync-perf', () => {
       for (let i = 0; i < BATCH_SIZE; i++) {
         const idx = batch * BATCH_SIZE + i;
         clientA.store.edit({
-          otype: 'number.set',
+          ot: 'number.set',
           key: 'cube-1',
           path: `val_${idx % 100}`,
           value: idx,

package/tests/e2e/sync-reconciliation.test.ts

@@ -14,13 +14,13 @@ import type { GraphStore } from '@vuer-ai/vuer-rtc';
 
 function seedGraph(store: GraphStore): void {
   store.edit({
-    otype: 'node.insert',
+    ot: 'node.insert',
     key: '',
     path: 'children',
     value: { key: 'scene', tag: 'Scene', name: 'Scene' },
   });
   store.edit({
-    otype: 'node.insert',
+    ot: 'node.insert',
     key: 'scene',
     path: 'children',
     value: {
@@ -95,7 +95,7 @@ describe('sync-reconciliation', () => {
 
     // A makes property edits (commutative, safe for out-of-order replay)
     clientA.store.edit({
-      otype: 'vector3.set',
+      ot: 'vector3.set',
       key: 'cube-1',
       path: 'position',
       value: [10, 20, 30],
@@ -103,7 +103,7 @@ describe('sync-reconciliation', () => {
     clientA.store.commit('move cube');
 
     clientA.store.edit({
-      otype: 'number.set',
+      ot: 'number.set',
       key: 'cube-1',
       path: 'opacity',
       value: 0.5,
@@ -198,7 +198,7 @@ describe('sync-reconciliation', () => {
 
     // Both make edits (some may be dropped)
     clientA.store.edit({
-      otype: 'vector3.set',
+      ot: 'vector3.set',
       key: 'cube-1',
       path: 'position',
       value: [99, 88, 77],
@@ -206,7 +206,7 @@ describe('sync-reconciliation', () => {
     clientA.store.commit('move');
 
     clientB.store.edit({
-      otype: 'number.set',
+      ot: 'number.set',
       key: 'cube-1',
       path: 'opacity',
       value: 0.3,

package/tests/e2e/text-sync.test.ts

@@ -16,13 +16,13 @@ import type { GraphStore } from '@vuer-ai/vuer-rtc';
 /** Insert a scene root + a text node so text ops have a target. */
 function seedTextGraph(store: GraphStore): void {
   store.edit({
-    otype: 'node.insert',
+    ot: 'node.insert',
     key: '',
     path: 'children',
     value: { key: 'scene', tag: 'Scene', name: 'Scene' },
   });
   store.edit({
-    otype: 'node.insert',
+    ot: 'node.insert',
     key: 'scene',
     path: 'children',
     value: { key: 'text-doc', tag: 'Text', name: 'Doc' },
@@ -58,7 +58,7 @@ describe('text-sync', () => {
 
     // Init text on the text-doc node
     clientA.store.edit({
-      otype: 'text.init',
+      ot: 'text.init',
       key: 'text-doc',
       path: 'content',
       value: '',
@@ -68,7 +68,7 @@ describe('text-sync', () => {
 
     // Insert "Hello"
     clientA.store.edit({
-      otype: 'text.insert',
+      ot: 'text.insert',
       key: 'text-doc',
       path: 'content',
       position: 0,
@@ -83,8 +83,8 @@ describe('text-sync', () => {
     const graphB = clientB.store.getState().graph;
 
     assertGraphsEqual(graphA, graphB);
-    expect(graphA.nodes['text-doc'].content).toBe('Hello');
-    expect(graphB.nodes['text-doc'].content).toBe('Hello');
+    expect(String(graphA.nodes['text-doc'].content)).toBe('Hello');
+    expect(String(graphB.nodes['text-doc'].content)).toBe('Hello');
   });
 
   // ── 2. Text edits recover via sync after packet loss ────────
@@ -102,7 +102,7 @@ describe('text-sync', () => {
 
     // Alice inits text and types while Bob has 100% drop rate
     clientA.store.edit({
-      otype: 'text.init',
+      ot: 'text.init',
       key: 'text-doc',
       path: 'content',
       value: '',
@@ -111,7 +111,7 @@ describe('text-sync', () => {
     await tick();
 
     clientA.store.edit({
-      otype: 'text.insert',
+      ot: 'text.insert',
       key: 'text-doc',
       path: 'content',
       position: 0,
@@ -135,7 +135,7 @@ describe('text-sync', () => {
     const graphB = clientB.store.getState().graph;
 
     assertGraphsEqual(graphA, graphB);
-    expect(graphB.nodes['text-doc'].content).toBe('Hello');
+    expect(String(graphB.nodes['text-doc'].content)).toBe('Hello');
   });
 
   // ── 3. Concurrent text edits converge ─────────────────────
@@ -150,7 +150,7 @@ describe('text-sync', () => {
 
     // Both clients init text
     clientA.store.edit({
-      otype: 'text.init',
+      ot: 'text.init',
       key: 'text-doc',
       path: 'content',
       value: '',
@@ -160,7 +160,7 @@ describe('text-sync', () => {
 
     // Both clients type concurrently (before seeing each other's edits)
     clientA.store.edit({
-      otype: 'text.insert',
+      ot: 'text.insert',
       key: 'text-doc',
       path: 'content',
       position: 0,
@@ -168,7 +168,7 @@ describe('text-sync', () => {
     } as any);
 
     clientB.store.edit({
-      otype: 'text.insert',
+      ot: 'text.insert',
       key: 'text-doc',
       path: 'content',
       position: 0,
@@ -189,8 +189,8 @@ describe('text-sync', () => {
     assertGraphsEqual(graphA, graphB);
 
     // Both "AAA" and "BBB" should be present in the final text
-    const textA = graphA.nodes['text-doc'].content as string;
-    const textB = graphB.nodes['text-doc'].content as string;
+    const textA = String(graphA.nodes['text-doc'].content);
+    const textB = String(graphB.nodes['text-doc'].content);
     expect(textA).toBe(textB);
     expect(textA).toContain('AAA');
     expect(textA).toContain('BBB');