@vibecook/truffle-react 0.4.1 → 0.4.2

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export { useMesh, type UseMeshResult } from './use-mesh.js';
 export { useAuth, type UseAuthResult, type AuthStatus } from './use-auth.js';
 export { useSyncedStore, type UseSyncedStoreResult, type Slice, type StoreEvent, } from './use-synced-store.js';
+export { useCrdtDoc, type UseCrdtDocResult } from './use-crdt-doc.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,EAAE,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAC7E,OAAO,EACL,cAAc,EACd,KAAK,oBAAoB,EACzB,KAAK,KAAK,EACV,KAAK,UAAU,GAChB,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,EAAE,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAC7E,OAAO,EACL,cAAc,EACd,KAAK,oBAAoB,EACzB,KAAK,KAAK,EACV,KAAK,UAAU,GAChB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,KAAK,gBAAgB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -1,4 +1,5 @@
 export { useMesh } from './use-mesh.js';
 export { useAuth } from './use-auth.js';
 export { useSyncedStore, } from './use-synced-store.js';
+export { useCrdtDoc } from './use-crdt-doc.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAsB,MAAM,eAAe,CAAC;AAC5D,OAAO,EAAE,OAAO,EAAuC,MAAM,eAAe,CAAC;AAC7E,OAAO,EACL,cAAc,GAIf,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAsB,MAAM,eAAe,CAAC;AAC5D,OAAO,EAAE,OAAO,EAAuC,MAAM,eAAe,CAAC;AAC7E,OAAO,EACL,cAAc,GAIf,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAyB,MAAM,mBAAmB,CAAC"}

package/dist/use-crdt-doc.d.ts

@@ -0,0 +1,54 @@
+import type { NapiNode } from '@vibecook/truffle';
+/** Shape of the NAPI CrdtDoc instance returned by `node.crdtDoc()`. */
+interface NapiCrdtDoc {
+    getDeepValue(): Record<string, unknown>;
+    commit(): void;
+    docId(): string;
+    mapInsert(container: string, key: string, value: unknown): void;
+    mapDelete(container: string, key: string): void;
+    listPush(container: string, value: unknown): void;
+    listInsert(container: string, index: number, value: unknown): void;
+    listDelete(container: string, index: number, len: number): void;
+    textInsert(container: string, pos: number, text: string): void;
+    textDelete(container: string, pos: number, len: number): void;
+    counterIncrement(container: string, value: number): void;
+    onChange(callback: (event: CrdtDocEvent) => void): void;
+    stop(): Promise<void>;
+}
+/** Events emitted by the CRDT document. */
+interface CrdtDocEvent {
+    eventType: 'local_change' | 'remote_change' | 'peer_synced' | 'peer_left';
+    peerId?: string;
+}
+export interface UseCrdtDocResult {
+    /** The NapiCrdtDoc instance, or null before initialization completes. */
+    doc: NapiCrdtDoc | null;
+    /** Reactive snapshot of the full document state (from `doc.getDeepValue()`). */
+    value: Record<string, unknown>;
+    /** True after the doc is created and the initial value has been loaded. */
+    isReady: boolean;
+}
+/**
+ * React hook for a Truffle CRDT document.
+ *
+ * Provides reactive access to a Loro-backed CRDT document that is
+ * automatically synchronized across the mesh. The returned `value`
+ * updates on every local or remote change.
+ *
+ * @example
+ * ```tsx
+ * const { doc, value, isReady } = useCrdtDoc(node, 'my-doc');
+ *
+ * // Write to the document
+ * if (doc) {
+ *   doc.mapInsert('root', 'title', 'Hello');
+ *   doc.commit();
+ * }
+ *
+ * // Read the reactive state
+ * console.log(value); // { root: { title: 'Hello' } }
+ * ```
+ */
+export declare function useCrdtDoc(node: NapiNode | null, docId: string): UseCrdtDocResult;
+export {};
+//# sourceMappingURL=use-crdt-doc.d.ts.map

package/dist/use-crdt-doc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-crdt-doc.d.ts","sourceRoot":"","sources":["../src/use-crdt-doc.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAMlD,uEAAuE;AACvE,UAAU,WAAW;IACnB,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,MAAM,IAAI,IAAI,CAAC;IACf,KAAK,IAAI,MAAM,CAAC;IAChB,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IAChE,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAChD,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IAClD,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IACnE,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAChE,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/D,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9D,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACzD,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GAAG,IAAI,CAAC;IACxD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED,2CAA2C;AAC3C,UAAU,YAAY;IACpB,SAAS,EAAE,cAAc,GAAG,eAAe,GAAG,aAAa,GAAG,WAAW,CAAC;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,yEAAyE;IACzE,GAAG,EAAE,WAAW,GAAG,IAAI,CAAC;IACxB,gFAAgF;IAChF,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,2EAA2E;IAC3E,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,gBAAgB,CAmEjF"}

package/dist/use-crdt-doc.js

@@ -0,0 +1,85 @@
+import { useEffect, useRef, useState } from 'react';
+/**
+ * React hook for a Truffle CRDT document.
+ *
+ * Provides reactive access to a Loro-backed CRDT document that is
+ * automatically synchronized across the mesh. The returned `value`
+ * updates on every local or remote change.
+ *
+ * @example
+ * ```tsx
+ * const { doc, value, isReady } = useCrdtDoc(node, 'my-doc');
+ *
+ * // Write to the document
+ * if (doc) {
+ *   doc.mapInsert('root', 'title', 'Hello');
+ *   doc.commit();
+ * }
+ *
+ * // Read the reactive state
+ * console.log(value); // { root: { title: 'Hello' } }
+ * ```
+ */
+export function useCrdtDoc(node, docId) {
+    const [doc, setDoc] = useState(null);
+    const [value, setValue] = useState({});
+    const [isReady, setIsReady] = useState(false);
+    const docRef = useRef(null);
+    useEffect(() => {
+        if (!node) {
+            setDoc(null);
+            setValue({});
+            setIsReady(false);
+            return;
+        }
+        let cancelled = false;
+        // Track the pending doc so cleanup can reach it even if the await
+        // hasn't resolved yet (fixes leak on rapid node/docId changes).
+        let pendingDoc = null;
+        const init = async () => {
+            try {
+                // `crdtDoc` is not in the generated .d.ts yet (it was added after
+                // the last NAPI binding generation), so we cast through `any`.
+                const d = node.crdtDoc(docId);
+                pendingDoc = d;
+                if (cancelled) {
+                    await d.stop();
+                    return;
+                }
+                docRef.current = d;
+                setDoc(d);
+                // Load initial value
+                const initial = d.getDeepValue();
+                if (!cancelled) {
+                    setValue(initial ?? {});
+                    setIsReady(true);
+                }
+                // Subscribe to local + remote changes
+                d.onChange((_event) => {
+                    if (cancelled)
+                        return;
+                    const updated = d.getDeepValue();
+                    setValue(updated ?? {});
+                });
+            }
+            catch (err) {
+                console.error('useCrdtDoc: failed to initialize', err);
+            }
+        };
+        init();
+        return () => {
+            cancelled = true;
+            const docToStop = docRef.current ?? pendingDoc;
+            if (docToStop) {
+                docToStop.stop().catch(() => { });
+            }
+            docRef.current = null;
+            pendingDoc = null;
+            setDoc(null);
+            setValue({});
+            setIsReady(false);
+        };
+    }, [node, docId]);
+    return { doc, value, isReady };
+}
+//# sourceMappingURL=use-crdt-doc.js.map

package/dist/use-crdt-doc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-crdt-doc.js","sourceRoot":"","sources":["../src/use-crdt-doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAuCpD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,UAAU,CAAC,IAAqB,EAAE,KAAa;IAC7D,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,GAAG,QAAQ,CAAqB,IAAI,CAAC,CAAC;IACzD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAA0B,EAAE,CAAC,CAAC;IAChE,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAG,MAAM,CAAqB,IAAI,CAAC,CAAC;IAEhD,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,CAAC,IAAI,CAAC,CAAC;YACb,QAAQ,CAAC,EAAE,CAAC,CAAC;YACb,UAAU,CAAC,KAAK,CAAC,CAAC;YAClB,OAAO;QACT,CAAC;QAED,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,kEAAkE;QAClE,gEAAgE;QAChE,IAAI,UAAU,GAAuB,IAAI,CAAC;QAE1C,MAAM,IAAI,GAAG,KAAK,IAAI,EAAE;YACtB,IAAI,CAAC;gBACH,kEAAkE;gBAClE,+DAA+D;gBAC/D,MAAM,CAAC,GAAiB,IAAY,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;gBACpD,UAAU,GAAG,CAAC,CAAC;gBACf,IAAI,SAAS,EAAE,CAAC;oBACd,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;oBACf,OAAO;gBACT,CAAC;gBACD,MAAM,CAAC,OAAO,GAAG,CAAC,CAAC;gBACnB,MAAM,CAAC,CAAC,CAAC,CAAC;gBAEV,qBAAqB;gBACrB,MAAM,OAAO,GAAG,CAAC,CAAC,YAAY,EAAE,CAAC;gBACjC,IAAI,CAAC,SAAS,EAAE,CAAC;oBACf,QAAQ,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;oBACxB,UAAU,CAAC,IAAI,CAAC,CAAC;gBACnB,CAAC;gBAED,sCAAsC;gBACtC,CAAC,CAAC,QAAQ,CAAC,CAAC,MAAoB,EAAE,EAAE;oBAClC,IAAI,SAAS;wBAAE,OAAO;oBACtB,MAAM,OAAO,GAAG,CAAC,CAAC,YAAY,EAAE,CAAC;oBACjC,QAAQ,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;gBAC1B,CAAC,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC,KAAK,CAAC,kCAAkC,EAAE,GAAG,CAAC,CAAC;YACzD,CAAC;QACH,CAAC,CAAC;QAEF,IAAI,EAAE,CAAC;QAEP,OAAO,GAAG,EAAE;YACV,SAAS,GAAG,IAAI,CAAC;YACjB,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,IAAI,UAAU,CAAC;YAC/C,IAAI,SAAS,EAAE,CAAC;gBACd,SAAS,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YACnC,CAAC;YACD,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;YACtB,UAAU,GAAG,IAAI,CAAC;YAClB,MAAM,CAAC,IAAI,CAAC,CAAC;YACb,QAAQ,CAAC,EAAE,CAAC,CAAC;YACb,UAAU,CAAC,KAAK,CAAC,CAAC;QACpB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IAElB,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AACjC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibecook/truffle-react",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "description": "React hooks for Truffle mesh networking",
   "license": "MIT",
   "author": "James Yong",
@@ -42,7 +42,7 @@
     "dist"
   ],
   "dependencies": {
-    "@vibecook/truffle": "0.4.1"
+    "@vibecook/truffle": "0.4.2"
   },
   "peerDependencies": {
     "react": ">=18"