@vibecook/truffle-native 0.1.0

package/index.d.ts

@@ -0,0 +1,312 @@
+/* auto-generated by NAPI-RS */
+/* eslint-disable */
+/**
+ * NapiFileTransferAdapter - Node.js wrapper for file transfer signaling.
+ *
+ * Handles file transfer offer/accept/reject/cancel via the mesh message bus.
+ * Progress events use the broadcast channel (drops allowed for lag recovery).
+ */
+export declare class NapiFileTransferAdapter {
+  /**
+   * Create a new FileTransferAdapter.
+   *
+   * Sets up the underlying FileTransferManager and adapter with default TCP dial.
+   */
+  constructor(config: NapiFileTransferAdapterConfig)
+  /**
+   * 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).
+   *
+   * Only one subscriber allowed. Progress events may be dropped if the JS
+   * handler is slow (broadcast channel). Critical events are never dropped.
+   */
+  onEvent(callback: (err: null | Error, event: NapiFileTransferEvent) => void): void
+  /**
+   * Subscribe to outgoing bus messages.
+   *
+   * 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.
+   */
+  onBusMessage(callback: (err: null | Error, message: NapiBusMessage) => void): void
+  /**
+   * Start forwarding manager events to the adapter.
+   *
+   * The FileTransferManager emits events (progress, complete, error) that
+   * the adapter needs to process. Call this once after construction.
+   */
+  startManagerEvents(): void
+}
+
+/**
+ * NapiMeshNode - Node.js wrapper for truffle-core MeshNode.
+ *
+ * SAFETY: No panics in any method. All errors returned via napi::Result.
+ * Event delivery uses ThreadsafeFunction with Blocking mode.
+ */
+export declare class NapiMeshNode {
+  /**
+   * Create a new MeshNode.
+   *
+   * The `config` parameter matches the TypeScript `MeshNodeConfig` interface.
+   */
+  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>
+  /**
+   * Send a mesh envelope to a specific device.
+   * Returns true if the message was sent successfully.
+   */
+  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>
+  /**
+   * Subscribe to mesh events.
+   *
+   * 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 NapiMeshEvent objects with event_type, device_id, and payload.
+   */
+  onEvent(callback: (err: null | Error, event: NapiMeshEvent) => void): void
+}
+
+/**
+ * NapiMessageBus - Node.js wrapper for MeshMessageBus.
+ *
+ * Provides namespace-based pub/sub for application-level messages.
+ */
+export declare class NapiMessageBus {
+  /** Get all subscribed namespaces. */
+  subscribedNamespaces(): Promise<Array<string>>
+  /** Dispose the message bus, clearing all handlers. */
+  dispose(): Promise<void>
+}
+
+/**
+ * NapiStoreSyncAdapter - Node.js wrapper for cross-device state sync.
+ *
+ * In the JS layer, stores are registered via the SyncableStore trait.
+ * For NAPI, we expose the adapter's lifecycle and message handling.
+ */
+export declare class NapiStoreSyncAdapter {
+  /**
+   * Create a new StoreSyncAdapter.
+   *
+   * Note: In the NAPI layer, stores must be registered separately.
+   * This constructor creates the adapter with an empty store list.
+   */
+  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>
+  /**
+   * Subscribe to outgoing sync messages.
+   *
+   * The callback receives messages that should be broadcast to all devices
+   * via the mesh message bus.
+   */
+  onOutgoing(callback: (err: null | Error, message: NapiOutgoingSyncMessage) => void): void
+}
+
+/** Transfer info returned to JS. */
+export interface NapiAdapterTransferInfo {
+  transferId: string
+  direction: string
+  state: string
+  peerDeviceId: string
+  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
+}
+
+/** Outgoing bus message (sent from adapter to be relayed via mesh). */
+export interface NapiBusMessage {
+  targetDeviceId: string
+  messageType: string
+  payload: string
+}
+
+/** Device slice (JS representation). */
+export interface NapiDeviceSlice {
+  deviceId: string
+  data: any
+  updatedAt: number
+  version: number
+}
+
+/** 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
+}
+
+/** File transfer event delivered to JS. */
+export interface NapiFileTransferEvent {
+  eventType: string
+  transferId?: string
+  payload: any
+}
+
+/** 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
+}
+
+/** An incoming mesh message from a peer (JS representation). */
+export interface NapiIncomingMessage {
+  from?: string
+  connectionId: string
+  namespace: string
+  msgType: string
+  payload: any
+}
+
+/** A mesh event delivered to JS via ThreadsafeFunction. */
+export interface NapiMeshEvent {
+  eventType: string
+  deviceId?: string
+  payload: any
+}
+
+/** 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
+}
+
+/** Timing configuration for the mesh. */
+export interface NapiMeshTimingConfig {
+  announceIntervalMs?: number
+  discoveryTimeoutMs?: number
+  electionTimeoutMs?: number
+  primaryLossGraceMs?: number
+  heartbeatPingMs?: number
+  heartbeatTimeoutMs?: number
+}
+
+/** Outgoing sync message delivered to JS for broadcasting. */
+export interface NapiOutgoingSyncMessage {
+  msgType: string
+  payload: any
+}
+
+/** Store sync configuration (JS representation). */
+export interface NapiStoreSyncConfig {
+  localDeviceId: string
+}
+
+/** Tailnet peer info (JS representation). */
+export interface NapiTailnetPeer {
+  id: string
+  hostname: string
+  dnsName: string
+  tailscaleIps: Array<string>
+  online: boolean
+  os?: string
+}

package/index.js

@@ -0,0 +1,582 @@
+// prettier-ignore
+/* eslint-disable */
+// @ts-nocheck
+/* auto-generated by NAPI-RS */
+
+const { readFileSync } = require('node:fs')
+let nativeBinding = null
+const loadErrors = []
+
+const isMusl = () => {
+  let musl = false
+  if (process.platform === 'linux') {
+    musl = isMuslFromFilesystem()
+    if (musl === null) {
+      musl = isMuslFromReport()
+    }
+    if (musl === null) {
+      musl = isMuslFromChildProcess()
+    }
+  }
+  return musl
+}
+
+const isFileMusl = (f) => f.includes('libc.musl-') || f.includes('ld-musl-')
+
+const isMuslFromFilesystem = () => {
+  try {
+    return readFileSync('/usr/bin/ldd', 'utf-8').includes('musl')
+  } catch {
+    return null
+  }
+}
+
+const isMuslFromReport = () => {
+  let report = null
+  if (typeof process.report?.getReport === 'function') {
+    process.report.excludeNetwork = true
+    report = process.report.getReport()
+  }
+  if (!report) {
+    return null
+  }
+  if (report.header && report.header.glibcVersionRuntime) {
+    return false
+  }
+  if (Array.isArray(report.sharedObjects)) {
+    if (report.sharedObjects.some(isFileMusl)) {
+      return true
+    }
+  }
+  return false
+}
+
+const isMuslFromChildProcess = () => {
+  try {
+    return require('child_process').execSync('ldd --version', { encoding: 'utf8' }).includes('musl')
+  } catch (e) {
+    // If we reach this case, we don't know if the system is musl or not, so is better to just fallback to false
+    return false
+  }
+}
+
+function requireNative() {
+  if (process.env.NAPI_RS_NATIVE_LIBRARY_PATH) {
+    try {
+      return require(process.env.NAPI_RS_NATIVE_LIBRARY_PATH);
+    } catch (err) {
+      loadErrors.push(err)
+    }
+  } else if (process.platform === 'android') {
+    if (process.arch === 'arm64') {
+      try {
+        return require('./truffle.android-arm64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      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.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'arm') {
+      try {
+        return require('./truffle.android-arm-eabi.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      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.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on Android ${process.arch}`))
+    }
+  } else if (process.platform === 'win32') {
+    if (process.arch === 'x64') {
+      if (process.config?.variables?.shlib_suffix === 'dll.a' || process.config?.variables?.node_target_type === 'shared_library') {
+        try {
+        return require('./truffle.win32-x64-gnu.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      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.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      } else {
+        try {
+        return require('./truffle.win32-x64-msvc.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      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.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      }
+    } else if (process.arch === 'ia32') {
+      try {
+        return require('./truffle.win32-ia32-msvc.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      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.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'arm64') {
+      try {
+        return require('./truffle.win32-arm64-msvc.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      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.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on Windows: ${process.arch}`))
+    }
+  } else if (process.platform === 'darwin') {
+    try {
+      return require('./truffle.darwin-universal.node')
+    } catch (e) {
+      loadErrors.push(e)
+    }
+    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.`)
+      }
+      return binding
+    } catch (e) {
+      loadErrors.push(e)
+    }
+    if (process.arch === 'x64') {
+      try {
+        return require('./truffle.darwin-x64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      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.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'arm64') {
+      try {
+        return require('./truffle.darwin-arm64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      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.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on macOS: ${process.arch}`))
+    }
+  } else if (process.platform === 'freebsd') {
+    if (process.arch === 'x64') {
+      try {
+        return require('./truffle.freebsd-x64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      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.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'arm64') {
+      try {
+        return require('./truffle.freebsd-arm64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      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.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on FreeBSD: ${process.arch}`))
+    }
+  } else if (process.platform === 'linux') {
+    if (process.arch === 'x64') {
+      if (isMusl()) {
+        try {
+          return require('./truffle.linux-x64-musl.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        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.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      } else {
+        try {
+          return require('./truffle.linux-x64-gnu.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        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.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      }
+    } else if (process.arch === 'arm64') {
+      if (isMusl()) {
+        try {
+          return require('./truffle.linux-arm64-musl.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        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.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      } else {
+        try {
+          return require('./truffle.linux-arm64-gnu.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        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.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      }
+    } else if (process.arch === 'arm') {
+      if (isMusl()) {
+        try {
+          return require('./truffle.linux-arm-musleabihf.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        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.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      } else {
+        try {
+          return require('./truffle.linux-arm-gnueabihf.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        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.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      }
+    } else if (process.arch === 'loong64') {
+      if (isMusl()) {
+        try {
+          return require('./truffle.linux-loong64-musl.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        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.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      } else {
+        try {
+          return require('./truffle.linux-loong64-gnu.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        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.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      }
+    } else if (process.arch === 'riscv64') {
+      if (isMusl()) {
+        try {
+          return require('./truffle.linux-riscv64-musl.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        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.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      } else {
+        try {
+          return require('./truffle.linux-riscv64-gnu.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        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.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      }
+    } else if (process.arch === 'ppc64') {
+      try {
+        return require('./truffle.linux-ppc64-gnu.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      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.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 's390x') {
+      try {
+        return require('./truffle.linux-s390x-gnu.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      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.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on Linux: ${process.arch}`))
+    }
+  } else if (process.platform === 'openharmony') {
+    if (process.arch === 'arm64') {
+      try {
+        return require('./truffle.openharmony-arm64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      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.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'x64') {
+      try {
+        return require('./truffle.openharmony-x64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      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.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'arm') {
+      try {
+        return require('./truffle.openharmony-arm.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      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.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on OpenHarmony: ${process.arch}`))
+    }
+  } else {
+    loadErrors.push(new Error(`Unsupported OS: ${process.platform}, architecture: ${process.arch}`))
+  }
+}
+
+nativeBinding = requireNative()
+
+if (!nativeBinding || process.env.NAPI_RS_FORCE_WASI) {
+  let wasiBinding = null
+  let wasiBindingError = null
+  try {
+    wasiBinding = require('./truffle.wasi.cjs')
+    nativeBinding = wasiBinding
+  } catch (err) {
+    if (process.env.NAPI_RS_FORCE_WASI) {
+      wasiBindingError = err
+    }
+  }
+  if (!nativeBinding || process.env.NAPI_RS_FORCE_WASI) {
+    try {
+      wasiBinding = require('@vibecook/truffle-native-wasm32-wasi')
+      nativeBinding = wasiBinding
+    } catch (err) {
+      if (process.env.NAPI_RS_FORCE_WASI) {
+        if (!wasiBindingError) {
+          wasiBindingError = err
+        } else {
+          wasiBindingError.cause = err
+        }
+        loadErrors.push(err)
+      }
+    }
+  }
+  if (process.env.NAPI_RS_FORCE_WASI === 'error' && !wasiBinding) {
+    const error = new Error('WASI binding not found and NAPI_RS_FORCE_WASI is set to error')
+    error.cause = wasiBindingError
+    throw error
+  }
+}
+
+if (!nativeBinding) {
+  if (loadErrors.length > 0) {
+    throw new Error(
+      `Cannot find native binding. ` +
+        `npm has a bug related to optional dependencies (https://github.com/npm/cli/issues/4828). ` +
+        'Please try `npm i` again after removing both package-lock.json and node_modules directory.',
+      {
+        cause: loadErrors.reduce((err, cur) => {
+          cur.cause = err
+          return cur
+        }),
+      },
+    )
+  }
+  throw new Error(`Failed to load native binding`)
+}
+
+module.exports = nativeBinding
+module.exports.NapiFileTransferAdapter = nativeBinding.NapiFileTransferAdapter
+module.exports.NapiMeshNode = nativeBinding.NapiMeshNode
+module.exports.NapiMessageBus = nativeBinding.NapiMessageBus
+module.exports.NapiStoreSyncAdapter = nativeBinding.NapiStoreSyncAdapter

package/package.json

@@ -0,0 +1,75 @@
+{
+  "name": "@vibecook/truffle-native",
+  "version": "0.1.0",
+  "description": "Mesh networking for local-first apps, built on Tailscale (native addon)",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "license": "MIT",
+  "author": "James Yong",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jamesyong-42/truffle.git",
+    "directory": "crates/truffle-napi"
+  },
+  "homepage": "https://github.com/jamesyong-42/truffle#readme",
+  "bugs": {
+    "url": "https://github.com/jamesyong-42/truffle/issues"
+  },
+  "keywords": [
+    "mesh",
+    "networking",
+    "tailscale",
+    "local-first",
+    "p2p",
+    "napi",
+    "rust"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "sideEffects": false,
+  "files": [
+    "index.js",
+    "index.d.ts",
+    "*.node"
+  ],
+  "napi": {
+    "binaryName": "truffle",
+    "targets": [
+      "x86_64-apple-darwin",
+      "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"
+    ]
+  },
+  "devDependencies": {
+    "@napi-rs/cli": "^3.0.0"
+  },
+  "scripts": {
+    "build": "napi build --platform --release",
+    "build:debug": "napi build --platform",
+    "prepublishOnly": "napi prepublish -t npm",
+    "artifacts": "napi artifacts"
+  },
+  "optionalDependencies": {
+    "@vibecook/truffle-native-darwin-x64": "0.1.0",
+    "@vibecook/truffle-native-darwin-arm64": "0.1.0",
+    "@vibecook/truffle-native-linux-x64-gnu": "0.1.0",
+    "@vibecook/truffle-native-linux-arm64-gnu": "0.1.0",
+    "@vibecook/truffle-native-linux-x64-musl": "0.1.0",
+    "@vibecook/truffle-native-linux-arm64-musl": "0.1.0",
+    "@vibecook/truffle-native-android-arm64": "0.1.0",
+    "@vibecook/truffle-native-win32-x64-msvc": "0.1.0",
+    "@vibecook/truffle-native-win32-arm64-msvc": "0.1.0",
+    "@vibecook/truffle-native-linux-arm-gnueabihf": "0.1.0"
+  }
+}