@vuer-ai/vuer-rtc 0.8.3 → 0.8.4

package/CLAUDE.md

@@ -31,69 +31,33 @@ This ensures high-quality implementations and catches issues early.
 
 ### Deployment Process
 
-**Publishing a new version requires careful coordination between npm publish and documentation site updates.**
-
-#### Complete Deployment Workflow
-
 ```bash
-# 1. Update package version
-# Edit packages/vuer-rtc/package.json → bump version (e.g., 0.6.0)
+# 1. Update package version in packages/vuer-rtc/package.json
 
-# 2. Build and test locally
+# 2. Build and test
 pnpm build && pnpm test
 
-# 3. Commit package changes
-git add -A && git commit -m "Release v0.6.0: <summary>" && git push
+# 3. Commit and push
+git add -A && git commit -m "Release v0.x.x: <summary>" && git push
 
 # 4. Publish to npm
+cd packages/vuer-rtc
 pass otp npmjs && pnpm publish --otp $(pass otp npmjs)
+cd ../..
 
-# 5. Update documentation site
-cd vuer-rtc-docs
-# Edit package.json → update @vuer-ai/vuer-rtc to ^0.6.0
-pnpm install  # Updates pnpm-lock.yaml
-
-# 6. Commit and deploy
-git add -A && git commit -m "Update docs to v0.6.0"
-cd ..
-pnpm build  # ← IMPORTANT: Rebuild with new version
-pnpm run deploy  # ← IMPORTANT: Uses workspace deploy script, pushes to main:netlify-production
-
-# 7. WAIT for Netlify build (2-3 minutes)
-# Do NOT check the site immediately - Netlify needs time to build and deploy
+# 5. Deploy docs and server
+pnpm build && pnpm run deploy  # Netlify (main:netlify-production)
+git push heroku main            # Heroku server
 
-# 8. Verify deployment
-curl https://rtc.vuer.ai | grep "v0.6.0"
-# Or visit https://rtc.vuer.ai and check the version badge in the hero section
+# 6. Verify after 2-3 minutes
+curl https://rtc.vuer.ai | grep "v0.x.x"
 ```
 
-#### Important Notes
-
-**Why lockfile update is sufficient:**
-- The docs site uses a Vite alias that points to the LOCAL package.json:
-  ```typescript
-  // vuer-rtc-docs/vite.config.ts
-  alias: {
-    '#vuer-rtc-pkg': path.resolve(__dirname, '../packages/vuer-rtc/package.json')
-  }
-  ```
-- The VuerRTCBadge component imports version from this alias:
-  ```typescript
-  import packageJson from '#vuer-rtc-pkg';
-  const PACKAGE_VERSION = packageJson.version;
-  ```
-- This means the site reads the version from the workspace, NOT from npm
-- The lockfile change triggers Netlify rebuild, which picks up the updated local package.json
-
-**Why to use `pnpm run deploy`:**
-- The workspace has a deploy script: `"deploy": "git push origin main:netlify-production"`
-- This pushes to the correct branch that triggers Netlify deployment
-- Using manual `git push` may push to the wrong branch
-
-**Why to wait:**
-- Netlify build takes 2-3 minutes after push
-- Checking the site immediately will show stale version
-- Wait for the build to complete before verifying
+**Notes:**
+- Docs use `workspace:^` so they always point to local package
+- Version badge reads from local package.json via Vite alias
+- `pnpm run deploy` pushes to `main:netlify-production` branch
+- Netlify triggers on any commit to netlify-production branch
 
 ## Text Architecture (3-Component Design)
 

package/dist/client/textEditorHelpers.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Text Editor Helpers
+ *
+ * Helper functions to create text operations from position-based editor input.
+ * These operations include position fields that are converted to CRDT format
+ * by the text.ts handlers.
+ */
+/**
+ * Helper to create a text.insert operation from position-based input.
+ * The operation will be converted to CRDT format by the text.ts handler.
+ */
+export declare function textInsert(key: string, path: string, position: number, content: string): any;
+/**
+ * Helper to create a text.delete operation from position-based input.
+ * The operation will be converted to CRDT format by the text.ts handler.
+ */
+export declare function textDelete(key: string, path: string, position: number, length: number): any;
+/**
+ * Helper to create a text.replace operation from position-based input.
+ * The operation will be converted to CRDT format by the text.ts handler.
+ */
+export declare function textReplace(key: string, path: string, position: number, length: number, content: string): any;
+//# sourceMappingURL=textEditorHelpers.d.ts.map

package/dist/client/textEditorHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"textEditorHelpers.d.ts","sourceRoot":"","sources":["../../src/client/textEditorHelpers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;GAGG;AACH,wBAAgB,UAAU,CACxB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd,GAAG,CAQL;AAED;;;GAGG;AACH,wBAAgB,UAAU,CACxB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,GAAG,CAQL;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,GAAG,CASL"}

package/dist/client/textEditorHelpers.js

@@ -0,0 +1,48 @@
+/**
+ * Text Editor Helpers
+ *
+ * Helper functions to create text operations from position-based editor input.
+ * These operations include position fields that are converted to CRDT format
+ * by the text.ts handlers.
+ */
+/**
+ * Helper to create a text.insert operation from position-based input.
+ * The operation will be converted to CRDT format by the text.ts handler.
+ */
+export function textInsert(key, path, position, content) {
+    return {
+        ot: 'text.insert',
+        key,
+        path,
+        position,
+        value: [null, content], // [anchor, content] tuple
+    };
+}
+/**
+ * Helper to create a text.delete operation from position-based input.
+ * The operation will be converted to CRDT format by the text.ts handler.
+ */
+export function textDelete(key, path, position, length) {
+    return {
+        ot: 'text.delete',
+        key,
+        path,
+        position,
+        length,
+    };
+}
+/**
+ * Helper to create a text.replace operation from position-based input.
+ * The operation will be converted to CRDT format by the text.ts handler.
+ */
+export function textReplace(key, path, position, length, content) {
+    return {
+        ot: 'text.replace',
+        key,
+        path,
+        position,
+        length,
+        value: [null, content], // [anchor, content] tuple
+    };
+}
+//# sourceMappingURL=textEditorHelpers.js.map

package/dist/client/textEditorHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"textEditorHelpers.js","sourceRoot":"","sources":["../../src/client/textEditorHelpers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;GAGG;AACH,MAAM,UAAU,UAAU,CACxB,GAAW,EACX,IAAY,EACZ,QAAgB,EAChB,OAAe;IAEf,OAAO;QACL,EAAE,EAAE,aAAa;QACjB,GAAG;QACH,IAAI;QACJ,QAAQ;QACR,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,EAAG,0BAA0B;KACpD,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CACxB,GAAW,EACX,IAAY,EACZ,QAAgB,EAChB,MAAc;IAEd,OAAO;QACL,EAAE,EAAE,aAAa;QACjB,GAAG;QACH,IAAI;QACJ,QAAQ;QACR,MAAM;KACP,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CACzB,GAAW,EACX,IAAY,EACZ,QAAgB,EAChB,MAAc,EACd,OAAe;IAEf,OAAO;QACL,EAAE,EAAE,cAAc;QAClB,GAAG;QACH,IAAI;QACJ,QAAQ;QACR,MAAM;QACN,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,EAAG,0BAA0B;KACpD,CAAC;AACJ,CAAC"}

package/mprocs.log

@@ -0,0 +1 @@
+ERROR [mprocs::error] Error: channel closed

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vuer-ai/vuer-rtc",
-  "version": "0.8.3",
+  "version": "0.8.4",
   "private": false,
   "type": "module",
   "description": "CRDT-based real-time collaborative data structures",

package/tests/crdt/rope.test.ts

@@ -235,6 +235,52 @@ describe('TextRope', () => {
       // Verify the text is correct after the edit
       expect(getText(alice)).toContain('for in in range');
     });
+
+    it('should order items with same anchor consistently (YATA LIFO)', () => {
+      // Reproduces the scenario from message-log-1772434922593.json
+      // where items with same anchor should use consistent ordering
+      const alice = create('Alice');
+      const bob = create('Bob');
+
+      // Create a shared anchor item "X"
+      const anchorOp = insert(bob, 0, 'X');
+      apply(alice, anchorOp);
+
+      // Bob inserts "B" with anchor "X", with seq 39
+      const bobOp: any = {
+        ot: 'insert',
+        id: 'Bob:1',
+        value: ['Bob:0', 'B'],
+        seq: 39,
+        ts: Date.now() / 1000,
+      };
+
+      // Alice inserts "A" with anchor "X", with seq 54 (later)
+      const aliceOp: any = {
+        ot: 'insert',
+        id: 'Alice:0',
+        value: ['Bob:0', 'A'],
+        seq: 54,
+        ts: Date.now() / 1000 + 0.001, // Slightly later timestamp
+      };
+
+      // Apply operations locally first
+      apply(bob, bobOp);
+      apply(alice, aliceOp);
+
+      // Exchange operations - convergence test
+      apply(alice, bobOp);
+      apply(bob, aliceOp);
+
+      // Both should converge (same final text)
+      const aliceText = getText(alice);
+      const bobText = getText(bob);
+
+      expect(aliceText).toBe(bobText); // Convergence guarantee
+      // The actual order is determined by YATA algorithm with LIFO semantics
+      // Later seq (Alice:54) comes before earlier seq (Bob:39) at same position
+      expect(aliceText).toBe('XAB');
+    });
   });
 
   describe('Merge', () => {