@vibecook/truffle-native 0.4.1 → 0.4.3

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.
  *
@@ -120,6 +166,8 @@ export declare class NapiNode {
   onMessage(namespace: string, callback: (msg: NamespacedMessage) => void): void
   /** Get a `NapiFileTransfer` handle for file transfer operations. */
   fileTransfer(): NapiFileTransfer
+  /** Get a `NapiProxy` handle for reverse proxy operations. */
+  proxy(): NapiProxy
   /**
    * Get a `NapiSyncedStore` handle for synchronized state operations.
    *
@@ -127,6 +175,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
 }
 
 /**
@@ -142,6 +201,32 @@ export declare class NapiOfferResponder {
   reject(reason: string): Promise<void>
 }
 
+/**
+ * Reverse proxy handle exposed to JavaScript.
+ *
+ * Obtained via `NapiNode.proxy()`. Holds an `Arc<Node>` to create
+ * fresh `Proxy` handles on each method call (the Rust `Proxy` borrows
+ * `&Node`, so we can't store it across JS boundaries).
+ */
+export declare class NapiProxy {
+  /**
+   * Add a reverse proxy that forwards traffic from a TLS port on the mesh
+   * to a local target.
+   */
+  add(config: NapiProxyConfig): Promise<NapiProxyInfo>
+  /** Remove a reverse proxy by ID. */
+  remove(id: string): Promise<void>
+  /** List all active proxies on this node. */
+  list(): Promise<Array<NapiProxyInfo>>
+  /**
+   * Subscribe to proxy lifecycle events.
+   *
+   * The callback receives `NapiProxyEvent` objects whenever a proxy
+   * starts, stops, or encounters an error.
+   */
+  onEvent(callback: (event: NapiProxyEvent) => void): void
+}
+
 /**
  * Synchronized store handle exposed to JavaScript.
  *
@@ -181,6 +266,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. */
@@ -354,6 +447,53 @@ export interface NapiPingResult {
   peerAddr?: string
 }
 
+/** Configuration for adding a reverse proxy, received from JavaScript. */
+export interface NapiProxyConfig {
+  /** Unique identifier (user-chosen or auto-generated). */
+  id: string
+  /** Human-readable name for the proxy. */
+  name: string
+  /** Port on which the proxy listens on the tailnet (NAPI uses i32). */
+  listenPort: number
+  /** Target host (default: "localhost"). */
+  targetHost?: string
+  /** Target port (the local service port). */
+  targetPort: number
+  /** Target scheme: "http" or "https" (default: "http"). */
+  targetScheme?: string
+  /** Whether to announce this proxy on the mesh for discovery (default: true). */
+  announce?: boolean
+}
+
+/** A proxy lifecycle event delivered to JavaScript. */
+export interface NapiProxyEvent {
+  /** Event type: "started", "stopped", "error". */
+  eventType: string
+  /** Proxy ID. */
+  id: string
+  /** Fully qualified URL (present for "started" events). */
+  url?: string
+  /** Listen port (present for "started" events). */
+  listenPort?: number
+  /** Error code (present for "error" events). */
+  code?: string
+  /** Error message (present for "error" events). */
+  message?: string
+}
+
+/** Information about a running or configured proxy, returned to JavaScript. */
+export interface NapiProxyInfo {
+  id: string
+  name: string
+  listenPort: number
+  targetHost: string
+  targetPort: number
+  targetScheme: string
+  url: string
+  /** Status: "starting", "running", "stopped", or "error: <message>". */
+  status: string
+}
+
 /** A versioned slice of data owned by a single device. */
 export interface NapiSlice {
   /**

package/index.js

@@ -576,7 +576,9 @@ 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
+module.exports.NapiProxy = nativeBinding.NapiProxy
 module.exports.NapiSyncedStore = nativeBinding.NapiSyncedStore

package/package.json

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