@vibecook/truffle-native 0.1.1 → 0.3.22

package/helpers.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Resolve the sidecar binary path for the current platform.
+ * @returns Absolute path to the sidecar binary.
+ * @throws If the binary cannot be found.
+ */
+export declare function resolveSidecarPath(): string;
+
+/**
+ * Open a URL in the system's default browser.
+ * Works cross-platform (macOS, Linux, Windows).
+ */
+export declare function openUrl(url: string): void;

package/helpers.js

@@ -0,0 +1,79 @@
+const { execSync } = require('node:child_process');
+const path = require('node:path');
+const fs = require('node:fs');
+
+/**
+ * Resolve the sidecar binary path for the current platform.
+ *
+ * Resolution order:
+ * 1. Platform-specific npm package (@vibecook/truffle-sidecar-{platform}-{arch})
+ * 2. Local workspace bin directories (for development)
+ *
+ * @returns {string} Absolute path to the sidecar binary.
+ * @throws {Error} If the binary cannot be found.
+ */
+function resolveSidecarPath() {
+  const key = `${process.platform}-${process.arch}`;
+  const ext = process.platform === 'win32' ? '.exe' : '';
+  const binName = `sidecar-slim${ext}`;
+
+  // 1. Try platform-specific npm package
+  const platformPackages = {
+    'darwin-arm64': '@vibecook/truffle-sidecar-darwin-arm64',
+    'darwin-x64': '@vibecook/truffle-sidecar-darwin-x64',
+    'linux-x64': '@vibecook/truffle-sidecar-linux-x64',
+    'linux-arm64': '@vibecook/truffle-sidecar-linux-arm64',
+    'win32-x64': '@vibecook/truffle-sidecar-win32-x64',
+  };
+  const pkg = platformPackages[key];
+  if (pkg) {
+    try {
+      const pkgJsonPath = require.resolve(`${pkg}/package.json`);
+      const binPath = path.join(path.dirname(pkgJsonPath), 'bin', binName);
+      if (fs.existsSync(binPath)) return binPath;
+    } catch {}
+  }
+
+  // 2. Try workspace locations (local dev)
+  // Walk up from this file's directory looking for packages/core/bin or packages/sidecar-slim/bin
+  let dir = __dirname;
+  for (let i = 0; i < 5; i++) {
+    const coreBin = path.join(dir, 'packages', 'core', 'bin', binName);
+    if (fs.existsSync(coreBin)) return coreBin;
+    const slimBin = path.join(dir, 'packages', 'sidecar-slim', 'bin', binName);
+    if (fs.existsSync(slimBin)) return slimBin;
+    const parent = path.dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+
+  const supported = Object.keys(platformPackages).join(', ');
+  throw new Error(
+    `Truffle sidecar binary not found for ${key}. ` +
+    `Supported platforms: ${supported}. ` +
+    `Install the platform package: npm install ${platformPackages[key] || '@vibecook/truffle-sidecar-<platform>'}`
+  );
+}
+
+/**
+ * Open a URL in the system's default browser.
+ * Works cross-platform (macOS, Linux, Windows).
+ *
+ * @param {string} url - The URL to open.
+ */
+function openUrl(url) {
+  const platform = process.platform;
+  try {
+    if (platform === 'darwin') {
+      execSync(`open "${url}"`);
+    } else if (platform === 'win32') {
+      execSync(`start "" "${url}"`);
+    } else {
+      execSync(`xdg-open "${url}"`);
+    }
+  } catch {
+    // Silently fail — caller can handle errors via the auth event
+  }
+}
+
+module.exports = { resolveSidecarPath, openUrl };

package/index.d.ts

@@ -1,312 +1,366 @@
 /* auto-generated by NAPI-RS */
 /* eslint-disable */
 /**
- * NapiFileTransferAdapter - Node.js wrapper for file transfer signaling.
+ * File transfer handle exposed to JavaScript.
  *
- * Handles file transfer offer/accept/reject/cancel via the mesh message bus.
- * Progress events use the broadcast channel (drops allowed for lag recovery).
+ * Obtained via `NapiNode.fileTransfer()`. Holds an `Arc<Node>` to create
+ * fresh `FileTransfer` handles on each method call (the Rust `FileTransfer`
+ * borrows `&Node`, so we can't store it across JS boundaries).
  */
-export declare class NapiFileTransferAdapter {
+export declare class NapiFileTransfer {
   /**
-   * Create a new FileTransferAdapter.
+   * Send a file to a peer.
    *
-   * Sets up the underlying FileTransferManager and adapter with default TCP dial.
+   * Resolves with transfer result on success.
    */
-  constructor(config: NapiFileTransferAdapterConfig)
+  sendFile(peerId: string, localPath: string, remotePath: string): Promise<NapiTransferResult>
   /**
-   * Initiate sending a file to a target device.
-   * Returns the transfer ID.
-   */
-  sendFile(targetDeviceId: string, filePath: string): Promise<string>
-  /** Accept an incoming file transfer offer. */
-  acceptTransfer(offer: NapiFileTransferOffer, savePath?: string | undefined | null): Promise<void>
-  /** Reject an incoming file transfer offer. */
-  rejectTransfer(offer: NapiFileTransferOffer, reason: string): Promise<void>
-  /** Cancel an active transfer. */
-  cancelTransfer(transferId: string): Promise<void>
-  /** Get all tracked transfers. */
-  getTransfers(): Promise<Array<NapiAdapterTransferInfo>>
-  /**
-   * Handle an incoming message from the mesh bus.
-   * Call this when a file-transfer namespace message arrives.
-   */
-  handleBusMessage(msgType: string, payload: any): Promise<void>
-  /**
-   * Subscribe to adapter events (offers, progress, completed, failed, cancelled).
+   * Pull (download) a file from a remote peer.
    *
-   * Only one subscriber allowed. Progress events may be dropped if the JS
-   * handler is slow (broadcast channel). Critical events are never dropped.
+   * Resolves with transfer result on success.
    */
-  onEvent(callback: (err: null | Error, event: NapiFileTransferEvent) => void): void
+  pullFile(peerId: string, remotePath: string, localPath: string): Promise<NapiTransferResult>
+  /** Auto-accept all incoming file offers, saving files to `output_dir`. */
+  autoAccept(outputDir: string): Promise<void>
+  /** Auto-reject all incoming file offers. */
+  autoReject(): Promise<void>
   /**
-   * Subscribe to outgoing bus messages.
+   * Subscribe to incoming file offers with a callback.
+   *
+   * The callback receives a `NapiFileOffer`. Use `autoAccept()` or
+   * `autoReject()` for automated handling, or use `onOffer()` for
+   * manual inspection of offers.
+   * Subscribe to incoming file offers with a callback.
    *
-   * The adapter generates outgoing messages (OFFER, ACCEPT, REJECT, CANCEL)
-   * that must be sent via the mesh message bus. This callback delivers them
-   * so the JS layer can relay them.
+   * The callback receives `(offer, responder)` — call `responder.accept(path)`
+   * or `responder.reject(reason)` to handle the offer. If neither is called
+   * within 60 seconds, the offer is auto-rejected.
    */
-  onBusMessage(callback: (err: null | Error, message: NapiBusMessage) => void): void
+  onOffer(callback: (offer: FileOffer, responder: NapiOfferResponder) => void): void
   /**
-   * Start forwarding manager events to the adapter.
+   * Subscribe to file transfer events.
    *
-   * The FileTransferManager emits events (progress, complete, error) that
-   * the adapter needs to process. Call this once after construction.
+   * The callback receives `NapiFileTransferEvent` objects for all
+   * transfer lifecycle events (hashing, progress, completed, failed, etc.).
    */
-  startManagerEvents(): void
+  onEvent(callback: (event: FileTransferEvent) => void): void
+  /** Set the maximum allowed transfer size in bytes. */
+  setMaxTransferSize(bytes: number): void
 }
 
 /**
- * NapiMeshNode - Node.js wrapper for truffle-core MeshNode.
+ * The main truffle node exposed to JavaScript.
  *
- * SAFETY: No panics in any method. All errors returned via napi::Result.
- * Event delivery uses ThreadsafeFunction with Blocking mode.
+ * Lifecycle:
+ * 1. `new NapiNode()` — creates an empty wrapper.
+ * 2. `await node.start(config)` — builds and starts the underlying `Node<TailscaleProvider>`.
+ * 3. Use `getPeers()`, `send()`, `onPeerChange()`, etc.
+ * 4. `await node.stop()` — shuts down the node.
  */
-export declare class NapiMeshNode {
+export declare class NapiNode {
+  /** Create a new (unstarted) NapiNode. */
+  constructor()
   /**
-   * Create a new MeshNode.
+   * Start the node with the given configuration.
    *
-   * The `config` parameter matches the TypeScript `MeshNodeConfig` interface.
+   * Resolves when the Tailscale sidecar is connected and the node is ready.
+   *
+   * # Safety
+   * This takes `&mut self` in an async context. The caller must ensure that
+   * no other calls are made on this NapiNode while `start()` is in progress.
+   */
+  start(config: NapiNodeConfig): Promise<void>
+  /**
+   * Stop the node and release all resources.
+   *
+   * # Safety
+   * This takes `&mut self` in an async context. The caller must ensure that
+   * no other calls are made on this NapiNode while `stop()` is in progress.
    */
-  constructor(config: NapiMeshNodeConfig)
-  /** Start the mesh node. */
-  start(): Promise<void>
-  /** Stop the mesh node. */
   stop(): Promise<void>
-  /** Check if the node is running. */
-  isRunning(): Promise<boolean>
-  /** Get the local device info. */
-  localDevice(): Promise<NapiBaseDevice>
-  /** Get the local device ID. */
-  deviceId(): Promise<string>
-  /** Get all known devices. */
-  devices(): Promise<Array<NapiBaseDevice>>
-  /** Get a device by ID. */
-  deviceById(id: string): Promise<NapiBaseDevice | null>
-  /** Check if this node is the primary. */
-  isPrimary(): Promise<boolean>
-  /** Get the current primary device ID. */
-  primaryId(): Promise<string | null>
-  /** Get the current role as a string ("primary" or "secondary"). */
-  role(): Promise<string>
+  /** Get the local node's identity. */
+  getLocalInfo(): NapiNodeIdentity
+  /** Get all known peers. */
+  getPeers(): Promise<Array<NapiPeer>>
+  /** Resolve a peer identifier (name or ID) to the canonical node ID. */
+  resolvePeerId(peerId: string): Promise<string>
+  /** Ping a peer and return latency info. */
+  ping(peerId: string): Promise<NapiPingResult>
+  /** Get health information from the network layer. */
+  health(): Promise<NapiHealthInfo>
+  /** Send a namespaced message to a specific peer. */
+  send(peerId: string, namespace: string, data: Buffer): Promise<void>
+  /** Broadcast a namespaced message to all connected peers. */
+  broadcast(namespace: string, data: Buffer): Promise<void>
   /**
-   * Send a mesh envelope to a specific device.
-   * Returns true if the message was sent successfully.
+   * Subscribe to peer change events.
+   *
+   * The callback receives `NapiPeerEvent` objects whenever peers
+   * join, leave, connect, disconnect, or update.
    */
-  sendEnvelope(deviceId: string, namespace: string, msgType: string, payload: any): Promise<boolean>
-  /** Broadcast a mesh envelope to all connected devices. */
-  broadcastEnvelope(namespace: string, msgType: string, payload: any): Promise<void>
-  /** Get the message bus for namespace-based pub/sub. */
-  messageBus(): NapiMessageBus
-  /** Handle tailnet peers update from the sidecar. */
-  handleTailnetPeers(peers: Array<NapiTailnetPeer>): Promise<void>
-  /** Set the local device as online with its Tailscale IP. */
-  setLocalOnline(tailscaleIp: string, dnsName?: string | undefined | null): Promise<void>
+  onPeerChange(callback: (event: PeerEvent) => void): void
   /**
-   * Subscribe to mesh events.
+   * Subscribe to messages on a specific namespace.
    *
-   * Uses ThreadsafeFunction with Blocking mode per RFC 003:
-   * - Critical events (device join/leave, election, errors) are never dropped
-   * - If the JS event queue is full, Rust waits rather than dropping events
+   * The callback receives `NapiNamespacedMessage` objects.
+   */
+  onMessage(namespace: string, callback: (msg: NamespacedMessage) => void): void
+  /** Get a `NapiFileTransfer` handle for file transfer operations. */
+  fileTransfer(): NapiFileTransfer
+  /**
+   * Get a `NapiSyncedStore` handle for synchronized state operations.
    *
-   * The callback receives NapiMeshEvent objects with event_type, device_id, and payload.
+   * Each call creates a new store instance with the given `store_id`.
+   * Multiple stores can coexist with different IDs.
    */
-  onEvent(callback: (err: null | Error, event: NapiMeshEvent) => void): void
+  syncedStore(storeId: string): NapiSyncedStore
 }
 
 /**
- * NapiMessageBus - Node.js wrapper for MeshMessageBus.
+ * Responder for accepting or rejecting a file offer from JS.
  *
- * Provides namespace-based pub/sub for application-level messages.
+ * The responder is consumed on the first call to `accept()` or `reject()`.
+ * If neither is called, the offer times out after 60 seconds.
  */
-export declare class NapiMessageBus {
-  /** Get all subscribed namespaces. */
-  subscribedNamespaces(): Promise<Array<string>>
-  /** Dispose the message bus, clearing all handlers. */
-  dispose(): Promise<void>
+export declare class NapiOfferResponder {
+  /** Accept the file offer, saving to the specified path. */
+  accept(savePath: string): Promise<void>
+  /** Reject the file offer with a reason. */
+  reject(reason: string): Promise<void>
 }
 
 /**
- * NapiStoreSyncAdapter - Node.js wrapper for cross-device state sync.
+ * Synchronized store handle exposed to JavaScript.
  *
- * In the JS layer, stores are registered via the SyncableStore trait.
- * For NAPI, we expose the adapter's lifecycle and message handling.
+ * Obtained via `NapiNode.syncedStore(storeId)`. Each store instance manages
+ * device-owned slices of JSON data that are automatically synchronized
+ * across the mesh.
  */
-export declare class NapiStoreSyncAdapter {
+export declare class NapiSyncedStore {
+  /** Update this device's data in the store. */
+  set(data: any): Promise<void>
+  /** Get this device's current data, or `null` if `set()` hasn't been called. */
+  local(): Promise<any | null>
+  /** Get a specific peer's slice by device ID. */
+  get(deviceId: string): Promise<NapiSlice | null>
+  /** Get all slices (local + remote) as an array. */
+  all(): Promise<Array<NapiSlice>>
+  /** Get all device IDs that have data in this store. */
+  deviceIds(): Promise<Array<string>>
+  /** The store identifier. */
+  storeId(): string
+  /** Current local version number. */
+  version(): number
   /**
-   * Create a new StoreSyncAdapter.
+   * Subscribe to store change events.
    *
-   * Note: In the NAPI layer, stores must be registered separately.
-   * This constructor creates the adapter with an empty store list.
+   * The callback receives `NapiStoreEvent` objects whenever local data
+   * changes, a peer's data is updated, or a peer is removed.
    */
-  constructor(config: NapiStoreSyncConfig)
-  /** Start syncing. */
-  start(): Promise<void>
-  /** Stop syncing. */
-  stop(): Promise<void>
-  /** Dispose the adapter. */
-  dispose(): Promise<void>
-  /** Handle an incoming sync message from a remote device. */
-  handleSyncMessage(from: string | undefined | null, msgType: string, payload: any): Promise<void>
-  /** Handle a device going offline. */
-  handleDeviceOffline(deviceId: string): Promise<void>
-  /** Handle a new device being discovered. */
-  handleDeviceDiscovered(deviceId: string): Promise<void>
-  /** Notify that a local store changed (triggers sync broadcast). */
-  handleLocalChanged(storeId: string, slice: NapiDeviceSlice): Promise<void>
+  onChange(callback: (event: StoreEvent) => void): void
   /**
-   * Subscribe to outgoing sync messages.
+   * Stop the store and cancel all event-forwarding tasks.
    *
-   * The callback receives messages that should be broadcast to all devices
-   * via the mesh message bus.
+   * # Safety
+   * This takes `&mut self` in an async context. The caller must ensure that
+   * no other calls are made on this NapiSyncedStore while `stop()` is in progress.
    */
-  onOutgoing(callback: (err: null | Error, message: NapiOutgoingSyncMessage) => void): void
+  stop(): Promise<void>
 }
 
-/** Transfer info returned to JS. */
-export interface NapiAdapterTransferInfo {
-  transferId: string
-  direction: string
-  state: string
-  peerDeviceId: string
+/** An incoming file offer from a remote peer. */
+export interface NapiFileOffer {
+  /** Stable node ID of the sending peer. */
+  fromPeer: string
+  /** Human-readable name of the sending peer. */
+  fromName: string
+  /** File name being offered. */
   fileName: string
-  fileSize: number
-  bytesTransferred: number
-  percent: number
-  bytesPerSecond: number
-  eta: number
-}
-
-/** A device in the mesh network (JS representation). */
-export interface NapiBaseDevice {
-  id: string
-  deviceType: string
-  name: string
-  tailscaleHostname: string
-  tailscaleDnsName?: string
-  tailscaleIp?: string
-  role?: string
-  status: string
-  capabilities: Array<string>
-  metadata?: any
-  lastSeen?: number
-  startedAt?: number
-  os?: string
-  latencyMs?: number
+  /** File size in bytes. */
+  size: number
+  /** Expected SHA-256 hash (hex). */
+  sha256: string
+  /** Suggested save path from the sender. */
+  suggestedPath: string
+  /** Unique token for this transfer. */
+  token: string
 }
 
-/** Outgoing bus message (sent from adapter to be relayed via mesh). */
-export interface NapiBusMessage {
-  targetDeviceId: string
-  messageType: string
-  payload: string
+/** Events emitted by the file transfer subsystem. */
+export interface NapiFileTransferEvent {
+  /**
+   * Event type: "offer_received", "hashing", "waiting_for_accept",
+   * "progress", "completed", "rejected", "failed".
+   */
+  eventType: string
+  /** Transfer token (if applicable). */
+  token?: string
+  /** File name (if applicable). */
+  fileName?: string
+  /** Direction: "send" or "receive" (if applicable). */
+  direction?: string
+  /** Progress info (present for "progress" events). */
+  progress?: NapiTransferProgress
+  /** Offer info (present for "offer_received" events). */
+  offer?: NapiFileOffer
+  /** Bytes transferred (present for "completed" events). */
+  bytesTransferred?: number
+  /** SHA-256 hash (present for "completed" events). */
+  sha256?: string
+  /** Elapsed seconds (present for "completed" events). */
+  elapsedSecs?: number
+  /** Reason for rejection or failure. */
+  reason?: string
+  /** Bytes hashed so far (present for "hashing" events). */
+  bytesHashed?: number
+  /** Total bytes to hash (present for "hashing" events). */
+  totalBytes?: number
 }
 
-/** Device slice (JS representation). */
-export interface NapiDeviceSlice {
-  deviceId: string
-  data: any
-  updatedAt: number
-  version: number
+/** Health information from the network layer. */
+export interface NapiHealthInfo {
+  /** Current backend state (e.g., "Running", "NeedsLogin"). */
+  state: string
+  /** Key expiry timestamp (RFC 3339), if applicable. */
+  keyExpiry?: string
+  /** Active health warnings. */
+  warnings: Array<string>
+  /** Whether the network is fully operational. */
+  healthy: boolean
 }
 
-/** File transfer adapter configuration (JS representation). */
-export interface NapiFileTransferAdapterConfig {
-  /** Local device ID. */
-  deviceId: string
-  /** Local address for file transfers (e.g. "host.ts.net:9417"). */
-  localAddr: string
-  /** Default output directory for received files. */
-  outputDir: string
-  /** Maximum file size in bytes. */
-  maxFileSize?: number
-  /** Max concurrent incoming transfers. */
-  maxConcurrentRecv?: number
-  /** Progress event interval in milliseconds. */
-  progressIntervalMs?: number
-  /** Progress event byte threshold. */
-  progressBytes?: number
+/** A message received on a specific namespace. */
+export interface NapiNamespacedMessage {
+  /** Stable node ID of the sender. */
+  from: string
+  /** Namespace the message was sent on. */
+  namespace: string
+  /** Application-defined message type. */
+  msgType: string
+  /** Opaque JSON payload (as a JS value via serde). */
+  payload: any
+  /** Millisecond Unix timestamp from the sender, if set. */
+  timestamp?: number
 }
 
-/** File transfer event delivered to JS. */
-export interface NapiFileTransferEvent {
-  eventType: string
-  transferId?: string
-  payload: any
+/** Configuration for starting a Node. */
+export interface NapiNodeConfig {
+  /** Human-readable node name (used as Tailscale hostname). */
+  name: string
+  /** Path to the Go sidecar binary. */
+  sidecarPath: string
+  /** Tailscale state directory. Defaults to `/tmp/truffle-{name}`. */
+  stateDir?: string
+  /** Tailscale auth key for headless authentication. */
+  authKey?: string
+  /** Whether the node is ephemeral (auto-removed from tailnet on shutdown). */
+  ephemeral?: boolean
+  /** WebSocket listen port. Defaults to 9417. */
+  wsPort?: number
 }
 
-/** File transfer offer (JS representation, for accept/reject). */
-export interface NapiFileTransferOffer {
-  transferId: string
-  senderDeviceId: string
-  senderAddr: string
-  fileName: string
-  fileSize: number
-  fileSha256: string
-  token: string
+/** Identity of the local node. */
+export interface NapiNodeIdentity {
+  /** Stable node ID. */
+  id: string
+  /** Hostname on the network. */
+  hostname: string
+  /** Human-readable display name. */
+  name: string
+  /** DNS name on the tailnet, if available. */
+  dnsName?: string
+  /** Tailscale IP address as a string, if available. */
+  ip?: string
 }
 
-/** An incoming mesh message from a peer (JS representation). */
-export interface NapiIncomingMessage {
-  from?: string
-  connectionId: string
-  namespace: string
-  msgType: string
-  payload: any
+/** A peer as seen by application code. */
+export interface NapiPeer {
+  /** Stable node ID. */
+  id: string
+  /** Human-readable name (hostname). */
+  name: string
+  /** Network IP address as a string. */
+  ip: string
+  /** Whether the peer is online (from Layer 3). */
+  online: boolean
+  /** Whether there is an active WebSocket connection. */
+  wsConnected: boolean
+  /** Connection type description (e.g., "direct" or "relay:ord"). */
+  connectionType: string
+  /** Operating system, if known. */
+  os?: string
+  /** Last time the peer was seen online (RFC 3339 string). */
+  lastSeen?: string
 }
 
-/** A mesh event delivered to JS via ThreadsafeFunction. */
-export interface NapiMeshEvent {
+/** A peer change event delivered to JS. */
+export interface NapiPeerEvent {
+  /** Event type: "joined", "left", "updated", "ws_connected", "ws_disconnected", "auth_required". */
   eventType: string
-  deviceId?: string
-  payload: any
+  /** Peer ID (present for peer events, empty for auth_required). */
+  peerId: string
+  /** Full peer info (present for joined/updated events). */
+  peer?: NapiPeer
+  /** Auth URL (present only for auth_required events). */
+  authUrl?: string
 }
 
-/** Configuration for creating a MeshNode. */
-export interface NapiMeshNodeConfig {
-  deviceId: string
-  deviceName: string
-  deviceType: string
-  hostnamePrefix: string
-  /**
-   * Path to the Go sidecar binary. Optional — use `resolveSidecarPath()`
-   * from `@vibecook/truffle` for automatic platform detection.
-   */
-  sidecarPath?: string
-  stateDir?: string
-  authKey?: string
-  preferPrimary?: boolean
-  staticPath?: string
-  capabilities?: Array<string>
-  timing?: NapiMeshTimingConfig
+/** Result of a network-level ping. */
+export interface NapiPingResult {
+  /** Round-trip latency in milliseconds. */
+  latencyMs: number
+  /** Connection type description (e.g., "direct" or "relay:sfo"). */
+  connection: string
+  /** Direct peer endpoint address, if available. */
+  peerAddr?: string
 }
 
-/** Timing configuration for the mesh. */
-export interface NapiMeshTimingConfig {
-  announceIntervalMs?: number
-  discoveryTimeoutMs?: number
-  electionTimeoutMs?: number
-  primaryLossGraceMs?: number
-  heartbeatPingMs?: number
-  heartbeatTimeoutMs?: number
+/** A versioned slice of data owned by a single device. */
+export interface NapiSlice {
+  /** Device that owns this slice (stable node ID). */
+  deviceId: string
+  /** The data (JSON value). */
+  data: any
+  /** Monotonically increasing version (per-device). */
+  version: number
+  /** When this version was created (Unix milliseconds). */
+  updatedAt: number
 }
 
-/** Outgoing sync message delivered to JS for broadcasting. */
-export interface NapiOutgoingSyncMessage {
-  msgType: string
-  payload: any
+/** A store change event delivered to JS. */
+export interface NapiStoreEvent {
+  /** Event type: "local_changed", "peer_updated", "peer_removed". */
+  eventType: string
+  /** Device ID (present for peer_updated/peer_removed events). */
+  deviceId?: string
+  /** Data payload (present for local_changed/peer_updated events). */
+  data?: any
+  /** Version number (present for peer_updated events). */
+  version?: number
 }
 
-/** Store sync configuration (JS representation). */
-export interface NapiStoreSyncConfig {
-  localDeviceId: string
+/** Progress update for an in-flight file transfer. */
+export interface NapiTransferProgress {
+  /** Unique token for this transfer. */
+  token: string
+  /** Direction: "send" or "receive". */
+  direction: string
+  /** File name being transferred. */
+  fileName: string
+  /** Bytes transferred so far. */
+  bytesTransferred: number
+  /** Total file size in bytes. */
+  totalBytes: number
+  /** Current transfer speed in bytes per second. */
+  speedBps: number
 }
 
-/** Tailnet peer info (JS representation). */
-export interface NapiTailnetPeer {
-  id: string
-  hostname: string
-  dnsName: string
-  tailscaleIps: Array<string>
-  online: boolean
-  os?: string
+/** Result of a completed file transfer. */
+export interface NapiTransferResult {
+  /** Number of bytes transferred. */
+  bytesTransferred: number
+  /** SHA-256 hash of the transferred file. */
+  sha256: string
+  /** Elapsed time in seconds. */
+  elapsedSecs: number
 }

package/index.js

@@ -77,8 +77,8 @@ function requireNative() {
       try {
         const binding = require('@vibecook/truffle-native-android-arm64')
         const bindingPackageVersion = require('@vibecook/truffle-native-android-arm64/package.json').version
-        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.3.17' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.3.17 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -93,8 +93,8 @@ function requireNative() {
       try {
         const binding = require('@vibecook/truffle-native-android-arm-eabi')
         const bindingPackageVersion = require('@vibecook/truffle-native-android-arm-eabi/package.json').version
-        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.3.17' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.3.17 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -114,8 +114,8 @@ function requireNative() {
       try {
         const binding = require('@vibecook/truffle-native-win32-x64-gnu')
         const bindingPackageVersion = require('@vibecook/truffle-native-win32-x64-gnu/package.json').version
-        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.3.17' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.3.17 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -130,8 +130,8 @@ function requireNative() {
       try {
         const binding = require('@vibecook/truffle-native-win32-x64-msvc')
         const bindingPackageVersion = require('@vibecook/truffle-native-win32-x64-msvc/package.json').version
-        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.3.17' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.3.17 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -147,8 +147,8 @@ function requireNative() {
       try {
         const binding = require('@vibecook/truffle-native-win32-ia32-msvc')
         const bindingPackageVersion = require('@vibecook/truffle-native-win32-ia32-msvc/package.json').version
-        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.3.17' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.3.17 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -163,8 +163,8 @@ function requireNative() {
       try {
         const binding = require('@vibecook/truffle-native-win32-arm64-msvc')
         const bindingPackageVersion = require('@vibecook/truffle-native-win32-arm64-msvc/package.json').version
-        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.3.17' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.3.17 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -182,8 +182,8 @@ function requireNative() {
     try {
       const binding = require('@vibecook/truffle-native-darwin-universal')
       const bindingPackageVersion = require('@vibecook/truffle-native-darwin-universal/package.json').version
-      if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-        throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+      if (bindingPackageVersion !== '0.3.17' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+        throw new Error(`Native binding package version mismatch, expected 0.3.17 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
       }
       return binding
     } catch (e) {
@@ -198,8 +198,8 @@ function requireNative() {
       try {
         const binding = require('@vibecook/truffle-native-darwin-x64')
         const bindingPackageVersion = require('@vibecook/truffle-native-darwin-x64/package.json').version
-        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.3.17' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.3.17 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -214,8 +214,8 @@ function requireNative() {
       try {
         const binding = require('@vibecook/truffle-native-darwin-arm64')
         const bindingPackageVersion = require('@vibecook/truffle-native-darwin-arm64/package.json').version
-        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.3.17' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.3.17 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -234,8 +234,8 @@ function requireNative() {
       try {
         const binding = require('@vibecook/truffle-native-freebsd-x64')
         const bindingPackageVersion = require('@vibecook/truffle-native-freebsd-x64/package.json').version
-        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.3.17' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.3.17 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -250,8 +250,8 @@ function requireNative() {
       try {
         const binding = require('@vibecook/truffle-native-freebsd-arm64')
         const bindingPackageVersion = require('@vibecook/truffle-native-freebsd-arm64/package.json').version
-        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.3.17' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.3.17 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -271,8 +271,8 @@ function requireNative() {
         try {
           const binding = require('@vibecook/truffle-native-linux-x64-musl')
           const bindingPackageVersion = require('@vibecook/truffle-native-linux-x64-musl/package.json').version
-          if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.3.17' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.3.17 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -287,8 +287,8 @@ function requireNative() {
         try {
           const binding = require('@vibecook/truffle-native-linux-x64-gnu')
           const bindingPackageVersion = require('@vibecook/truffle-native-linux-x64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.3.17' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.3.17 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -305,8 +305,8 @@ function requireNative() {
         try {
           const binding = require('@vibecook/truffle-native-linux-arm64-musl')
           const bindingPackageVersion = require('@vibecook/truffle-native-linux-arm64-musl/package.json').version
-          if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.3.17' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.3.17 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -321,8 +321,8 @@ function requireNative() {
         try {
           const binding = require('@vibecook/truffle-native-linux-arm64-gnu')
           const bindingPackageVersion = require('@vibecook/truffle-native-linux-arm64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.3.17' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.3.17 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -339,8 +339,8 @@ function requireNative() {
         try {
           const binding = require('@vibecook/truffle-native-linux-arm-musleabihf')
           const bindingPackageVersion = require('@vibecook/truffle-native-linux-arm-musleabihf/package.json').version
-          if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.3.17' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.3.17 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -355,8 +355,8 @@ function requireNative() {
         try {
           const binding = require('@vibecook/truffle-native-linux-arm-gnueabihf')
           const bindingPackageVersion = require('@vibecook/truffle-native-linux-arm-gnueabihf/package.json').version
-          if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.3.17' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.3.17 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -373,8 +373,8 @@ function requireNative() {
         try {
           const binding = require('@vibecook/truffle-native-linux-loong64-musl')
           const bindingPackageVersion = require('@vibecook/truffle-native-linux-loong64-musl/package.json').version
-          if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.3.17' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.3.17 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -389,8 +389,8 @@ function requireNative() {
         try {
           const binding = require('@vibecook/truffle-native-linux-loong64-gnu')
           const bindingPackageVersion = require('@vibecook/truffle-native-linux-loong64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.3.17' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.3.17 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -407,8 +407,8 @@ function requireNative() {
         try {
           const binding = require('@vibecook/truffle-native-linux-riscv64-musl')
           const bindingPackageVersion = require('@vibecook/truffle-native-linux-riscv64-musl/package.json').version
-          if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.3.17' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.3.17 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -423,8 +423,8 @@ function requireNative() {
         try {
           const binding = require('@vibecook/truffle-native-linux-riscv64-gnu')
           const bindingPackageVersion = require('@vibecook/truffle-native-linux-riscv64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.3.17' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.3.17 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -440,8 +440,8 @@ function requireNative() {
       try {
         const binding = require('@vibecook/truffle-native-linux-ppc64-gnu')
         const bindingPackageVersion = require('@vibecook/truffle-native-linux-ppc64-gnu/package.json').version
-        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.3.17' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.3.17 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -456,8 +456,8 @@ function requireNative() {
       try {
         const binding = require('@vibecook/truffle-native-linux-s390x-gnu')
         const bindingPackageVersion = require('@vibecook/truffle-native-linux-s390x-gnu/package.json').version
-        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.3.17' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.3.17 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -476,8 +476,8 @@ function requireNative() {
       try {
         const binding = require('@vibecook/truffle-native-openharmony-arm64')
         const bindingPackageVersion = require('@vibecook/truffle-native-openharmony-arm64/package.json').version
-        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.3.17' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.3.17 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -492,8 +492,8 @@ function requireNative() {
       try {
         const binding = require('@vibecook/truffle-native-openharmony-x64')
         const bindingPackageVersion = require('@vibecook/truffle-native-openharmony-x64/package.json').version
-        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.3.17' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.3.17 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -508,8 +508,8 @@ function requireNative() {
       try {
         const binding = require('@vibecook/truffle-native-openharmony-arm')
         const bindingPackageVersion = require('@vibecook/truffle-native-openharmony-arm/package.json').version
-        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.3.17' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.3.17 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -576,7 +576,7 @@ if (!nativeBinding) {
 }
 
 module.exports = nativeBinding
-module.exports.NapiFileTransferAdapter = nativeBinding.NapiFileTransferAdapter
-module.exports.NapiMeshNode = nativeBinding.NapiMeshNode
-module.exports.NapiMessageBus = nativeBinding.NapiMessageBus
-module.exports.NapiStoreSyncAdapter = nativeBinding.NapiStoreSyncAdapter
+module.exports.NapiFileTransfer = nativeBinding.NapiFileTransfer
+module.exports.NapiNode = nativeBinding.NapiNode
+module.exports.NapiOfferResponder = nativeBinding.NapiOfferResponder
+module.exports.NapiSyncedStore = nativeBinding.NapiSyncedStore

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibecook/truffle-native",
-  "version": "0.1.1",
+  "version": "0.3.22",
   "description": "Mesh networking for local-first apps, built on Tailscale (native addon)",
   "main": "index.js",
   "types": "index.d.ts",
@@ -34,8 +34,20 @@
   "files": [
     "index.js",
     "index.d.ts",
+    "helpers.js",
+    "helpers.d.ts",
     "*.node"
   ],
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "default": "./index.js"
+    },
+    "./helpers": {
+      "types": "./helpers.d.ts",
+      "default": "./helpers.js"
+    }
+  },
   "napi": {
     "binaryName": "truffle",
     "targets": [
@@ -43,12 +55,7 @@
       "aarch64-apple-darwin",
       "x86_64-unknown-linux-gnu",
       "aarch64-unknown-linux-gnu",
-      "x86_64-unknown-linux-musl",
-      "aarch64-unknown-linux-musl",
-      "aarch64-linux-android",
-      "x86_64-pc-windows-msvc",
-      "aarch64-pc-windows-msvc",
-      "armv7-unknown-linux-gnueabihf"
+      "x86_64-pc-windows-msvc"
     ]
   },
   "devDependencies": {
@@ -59,17 +66,5 @@
     "build:debug": "napi build --platform",
     "prepublishOnly": "napi prepublish -t npm",
     "artifacts": "napi artifacts"
-  },
-  "optionalDependencies": {
-    "@vibecook/truffle-native-darwin-x64": "0.1.1",
-    "@vibecook/truffle-native-darwin-arm64": "0.1.1",
-    "@vibecook/truffle-native-linux-x64-gnu": "0.1.1",
-    "@vibecook/truffle-native-linux-arm64-gnu": "0.1.1",
-    "@vibecook/truffle-native-linux-x64-musl": "0.1.1",
-    "@vibecook/truffle-native-linux-arm64-musl": "0.1.1",
-    "@vibecook/truffle-native-android-arm64": "0.1.1",
-    "@vibecook/truffle-native-win32-x64-msvc": "0.1.1",
-    "@vibecook/truffle-native-win32-arm64-msvc": "0.1.1",
-    "@vibecook/truffle-native-linux-arm-gnueabihf": "0.1.1"
   }
 }