@vibecook/truffle-native 0.4.1 → 0.4.2

package/index.d.ts

@@ -1,5 +1,51 @@
 /* auto-generated by NAPI-RS */
 /* eslint-disable */
+/**
+ * A CRDT document synchronized across the mesh, exposed to JavaScript.
+ *
+ * Obtained via `NapiNode.crdtDoc(docId)`. Each document wraps a Loro
+ * `LoroDoc` with automatic peer-to-peer sync.
+ */
+export declare class NapiCrdtDoc {
+  /** Insert a key-value pair into a named map container. */
+  mapInsert(container: string, key: string, value: any): void
+  /** Delete a key from a named map container. */
+  mapDelete(container: string, key: string): void
+  /** Push a value to the end of a named list container. */
+  listPush(container: string, value: any): void
+  /** Insert a value at a specific index in a named list container. */
+  listInsert(container: string, index: number, value: any): void
+  /** Delete elements from a named list container. */
+  listDelete(container: string, index: number, len: number): void
+  /** Insert a string at a unicode position in a named text container. */
+  textInsert(container: string, pos: number, text: string): void
+  /** Delete text at a unicode position in a named text container. */
+  textDelete(container: string, pos: number, len: number): void
+  /** Increment a named counter container by the given value. */
+  counterIncrement(container: string, value: number): void
+  /** Get the deep JSON value of the entire document. */
+  getDeepValue(): any
+  /** Commit pending changes. Triggers sync to peers. */
+  commit(): void
+  /** The document identifier. */
+  docId(): string
+  /**
+   * Subscribe to document change events.
+   *
+   * The callback receives `NapiCrdtDocEvent` objects whenever a local
+   * change is applied, a remote change is received, or a peer syncs.
+   */
+  onChange(callback: (event: CrdtDocEvent) => void): void
+  /**
+   * Stop the document and cancel all event-forwarding tasks.
+   *
+   * # Safety
+   * This takes `&mut self` in an async context. The caller must ensure that
+   * no other calls are made on this NapiCrdtDoc while `stop()` is in progress.
+   */
+  stop(): Promise<void>
+}
+
 /**
  * File transfer handle exposed to JavaScript.
  *
@@ -127,6 +173,17 @@ export declare class NapiNode {
    * Multiple stores can coexist with different IDs.
    */
   syncedStore(storeId: string): NapiSyncedStore
+  /**
+   * Get a `NapiCrdtDoc` handle for CRDT document operations.
+   *
+   * Each call creates a new document instance with the given `doc_id`.
+   * The document syncs automatically with peers on namespace `"crdt:{doc_id}"`.
+   *
+   * This is intentionally **synchronous** (matching `synced_store()`).
+   * `CrdtDoc::new` is async and calls `tokio::spawn` internally; we enter
+   * the napi-rs managed Tokio runtime so the spawn hits a live reactor.
+   */
+  crdtDoc(docId: string): NapiCrdtDoc
 }
 
 /**
@@ -181,6 +238,14 @@ export declare class NapiSyncedStore {
   stop(): Promise<void>
 }
 
+/** A CRDT document change event delivered to JS. */
+export interface NapiCrdtDocEvent {
+  /** Event type: "local_change", "remote_change", "peer_synced", "peer_left". */
+  eventType: string
+  /** Peer identifier (present for remote_change, peer_synced, peer_left events). */
+  peerId?: string
+}
+
 /** An incoming file offer from a remote peer. */
 export interface NapiFileOffer {
   /** Sender's stable `device_id` (ULID) from the RFC 017 hello envelope. */

package/index.js

@@ -576,6 +576,7 @@ if (!nativeBinding) {
 }
 
 module.exports = nativeBinding
+module.exports.NapiCrdtDoc = nativeBinding.NapiCrdtDoc
 module.exports.NapiFileTransfer = nativeBinding.NapiFileTransfer
 module.exports.NapiNode = nativeBinding.NapiNode
 module.exports.NapiOfferResponder = nativeBinding.NapiOfferResponder

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibecook/truffle-native",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "description": "Mesh networking for local-first apps, built on Tailscale (native addon)",
   "main": "index.js",
   "types": "index.d.ts",