@vibecook/truffle 0.1.0 → 0.2.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 James Yong
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -1,13 +1,4 @@
-export { MeshNode, createMeshNode } from '@vibecook/truffle-mesh';
-export type { MeshNodeConfig, MeshNodeEvents, MeshTimingConfig, IncomingMeshMessage } from '@vibecook/truffle-mesh';
-export { DeviceManager } from '@vibecook/truffle-mesh';
-export type { DeviceManagerEvents, DeviceIdentity } from '@vibecook/truffle-mesh';
-export { PrimaryElection } from '@vibecook/truffle-mesh';
-export type { ElectionConfig, ElectionState, PrimaryElectionEvents } from '@vibecook/truffle-mesh';
-export { MeshMessageBus } from '@vibecook/truffle-mesh';
-export { StoreSyncAdapter } from '@vibecook/truffle-store-sync';
-export type { ISyncableStore, StoreSyncAdapterConfig } from '@vibecook/truffle-store-sync';
-export { createLogger, TypedEventEmitter } from '@vibecook/truffle-types';
-export type { BaseDevice, DeviceRole, DeviceStatus, MeshMessage, MeshMessageType, MeshEnvelope, Logger, DeviceSlice, SidecarConfig, SidecarStatus, TailnetPeer, } from '@vibecook/truffle-types';
-export type { IMessageBus, BusMessage, BusMessageHandler } from '@vibecook/truffle-protocol';
+export { NapiMeshNode, NapiFileTransferAdapter, NapiMessageBus, NapiStoreSyncAdapter, } from '@vibecook/truffle-native';
+export type { NapiMeshNodeConfig, NapiMeshTimingConfig, NapiBaseDevice, NapiIncomingMessage, NapiTailnetPeer, NapiMeshEvent, NapiFileTransferAdapterConfig, NapiFileTransferOffer, NapiAdapterTransferInfo, NapiBusMessage, NapiFileTransferEvent, NapiStoreSyncConfig, NapiOutgoingSyncMessage, NapiDeviceSlice, } from '@vibecook/truffle-native';
+export { resolveSidecarPath } from './sidecar.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAClE,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AACpH,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,YAAY,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAClF,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AACnG,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAGxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,YAAY,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAG3F,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC1E,YAAY,EACV,UAAU,EACV,UAAU,EACV,YAAY,EACZ,WAAW,EACX,eAAe,EACf,YAAY,EACZ,MAAM,EACN,WAAW,EACX,aAAa,EACb,aAAa,EACb,WAAW,GACZ,MAAM,yBAAyB,CAAC;AAGjC,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,YAAY,EACZ,uBAAuB,EACvB,cAAc,EACd,oBAAoB,GACrB,MAAM,0BAA0B,CAAC;AAGlC,YAAY,EACV,kBAAkB,EAClB,oBAAoB,EACpB,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,6BAA6B,EAC7B,qBAAqB,EACrB,uBAAuB,EACvB,cAAc,EACd,qBAAqB,EACrB,mBAAmB,EACnB,uBAAuB,EACvB,eAAe,GAChB,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -1,13 +1,5 @@
-// ═══════════════════════════════════════════════════════════════════════════
-// @vibecook/truffle — Unified entry point for Truffle mesh networking
-// ═══════════════════════════════════════════════════════════════════════════
-// Mesh node (primary API)
-export { MeshNode, createMeshNode } from '@vibecook/truffle-mesh';
-export { DeviceManager } from '@vibecook/truffle-mesh';
-export { PrimaryElection } from '@vibecook/truffle-mesh';
-export { MeshMessageBus } from '@vibecook/truffle-mesh';
-// Store sync
-export { StoreSyncAdapter } from '@vibecook/truffle-store-sync';
-// Types & utilities
-export { createLogger, TypedEventEmitter } from '@vibecook/truffle-types';
+// Re-export classes (values) from the native Rust addon
+export { NapiMeshNode, NapiFileTransferAdapter, NapiMessageBus, NapiStoreSyncAdapter, } from '@vibecook/truffle-native';
+// Sidecar binary resolution
+export { resolveSidecarPath } from './sidecar.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,sEAAsE;AACtE,8EAA8E;AAE9E,0BAA0B;AAC1B,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAElE,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEvD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD,aAAa;AACb,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAGhE,oBAAoB;AACpB,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,OAAO,EACL,YAAY,EACZ,uBAAuB,EACvB,cAAc,EACd,oBAAoB,GACrB,MAAM,0BAA0B,CAAC;AAoBlC,4BAA4B;AAC5B,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC"}

package/dist/sidecar.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Sidecar binary resolution for @vibecook/truffle.
+ *
+ * Resolves the Go sidecar binary path using a 3-level fallback:
+ *   1. Platform-specific npm package (installed via optionalDependencies)
+ *   2. Postinstall-downloaded binary (fallback for --no-optional)
+ *   3. Error with clear instructions
+ *
+ * Follows the esbuild pattern for distributing platform-specific binaries.
+ */
+/**
+ * Resolve the path to the Go sidecar binary for the current platform.
+ *
+ * Resolution order:
+ *   1. Platform-specific `@vibecook/truffle-sidecar-{os}-{arch}` npm package
+ *   2. Binary downloaded by postinstall into `packages/core/bin/`
+ *
+ * @throws {Error} if no binary is found for the current platform
+ */
+export declare function resolveSidecarPath(): string;
+//# sourceMappingURL=sidecar.d.ts.map

package/dist/sidecar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidecar.d.ts","sourceRoot":"","sources":["../src/sidecar.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAiBH;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CA8B3C"}

package/dist/sidecar.js

@@ -0,0 +1,61 @@
+/**
+ * Sidecar binary resolution for @vibecook/truffle.
+ *
+ * Resolves the Go sidecar binary path using a 3-level fallback:
+ *   1. Platform-specific npm package (installed via optionalDependencies)
+ *   2. Postinstall-downloaded binary (fallback for --no-optional)
+ *   3. Error with clear instructions
+ *
+ * Follows the esbuild pattern for distributing platform-specific binaries.
+ */
+import { existsSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const require = createRequire(import.meta.url);
+const PLATFORM_PACKAGES = {
+    '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',
+};
+/**
+ * Resolve the path to the Go sidecar binary for the current platform.
+ *
+ * Resolution order:
+ *   1. Platform-specific `@vibecook/truffle-sidecar-{os}-{arch}` npm package
+ *   2. Binary downloaded by postinstall into `packages/core/bin/`
+ *
+ * @throws {Error} if no binary is found for the current platform
+ */
+export 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 (optionalDependency)
+    const pkg = PLATFORM_PACKAGES[key];
+    if (pkg) {
+        try {
+            const pkgJsonPath = require.resolve(`${pkg}/package.json`);
+            const binPath = join(dirname(pkgJsonPath), 'bin', binName);
+            if (existsSync(binPath))
+                return binPath;
+        }
+        catch {
+            // Package not installed — fall through
+        }
+    }
+    // 2. Try postinstall-downloaded binary (fallback)
+    const __dirname = dirname(fileURLToPath(import.meta.url));
+    const localBin = join(__dirname, '..', 'bin', binName);
+    if (existsSync(localBin))
+        return localBin;
+    // 3. Nothing found
+    const supported = Object.keys(PLATFORM_PACKAGES).join(', ');
+    throw new Error(`[truffle] Sidecar binary not found for platform "${key}".\n` +
+        `Supported platforms: ${supported}\n` +
+        `Try reinstalling: npm install @vibecook/truffle\n` +
+        `Or build from source: cd packages/sidecar-slim && go build -o bin/sidecar-slim`);
+}
+//# sourceMappingURL=sidecar.js.map

package/dist/sidecar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidecar.js","sourceRoot":"","sources":["../src/sidecar.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAE/C,MAAM,iBAAiB,GAA2B;IAChD,cAAc,EAAE,wCAAwC;IACxD,YAAY,EAAE,sCAAsC;IACpD,WAAW,EAAE,qCAAqC;IAClD,aAAa,EAAE,uCAAuC;IACtD,WAAW,EAAE,qCAAqC;CACnD,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB;IAChC,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;IAClD,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IACvD,MAAM,OAAO,GAAG,eAAe,GAAG,EAAE,CAAC;IAErC,4DAA4D;IAC5D,MAAM,GAAG,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;IACnC,IAAI,GAAG,EAAE,CAAC;QACR,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,GAAG,eAAe,CAAC,CAAC;YAC3D,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;YAC3D,IAAI,UAAU,CAAC,OAAO,CAAC;gBAAE,OAAO,OAAO,CAAC;QAC1C,CAAC;QAAC,MAAM,CAAC;YACP,uCAAuC;QACzC,CAAC;IACH,CAAC;IAED,kDAAkD;IAClD,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1D,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IACvD,IAAI,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,QAAQ,CAAC;IAE1C,mBAAmB;IACnB,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5D,MAAM,IAAI,KAAK,CACb,oDAAoD,GAAG,MAAM;QAC3D,wBAAwB,SAAS,IAAI;QACrC,mDAAmD;QACnD,gFAAgF,CACnF,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,17 +1,9 @@
 {
   "name": "@vibecook/truffle",
-  "version": "0.1.0",
+  "version": "0.2.3",
   "description": "Mesh networking for local-first apps, built on Tailscale",
-  "type": "module",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
-    }
-  },
   "license": "MIT",
+  "author": "James Yong",
   "repository": {
     "type": "git",
     "url": "https://github.com/jamesyong-42/truffle.git",
@@ -21,22 +13,53 @@
   "bugs": {
     "url": "https://github.com/jamesyong-42/truffle/issues"
   },
-  "files": ["dist"],
+  "keywords": [
+    "mesh",
+    "networking",
+    "tailscale",
+    "local-first",
+    "p2p",
+    "napi",
+    "rust"
+  ],
   "engines": {
     "node": ">=18"
   },
-  "scripts": {
-    "build": "tsc",
-    "clean": "rm -rf dist",
-    "typecheck": "tsc --noEmit"
+  "publishConfig": {
+    "access": "public"
+  },
+  "sideEffects": false,
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
   },
+  "files": [
+    "dist",
+    "bin",
+    "scripts"
+  ],
   "dependencies": {
-    "@vibecook/truffle-types": "workspace:*",
-    "@vibecook/truffle-protocol": "workspace:*",
-    "@vibecook/truffle-mesh": "workspace:*",
-    "@vibecook/truffle-store-sync": "workspace:*"
+    "@vibecook/truffle-native": "0.2.3"
+  },
+  "optionalDependencies": {
+    "@vibecook/truffle-sidecar-darwin-arm64": "0.1.0",
+    "@vibecook/truffle-sidecar-darwin-x64": "0.1.0",
+    "@vibecook/truffle-sidecar-linux-x64": "0.1.0",
+    "@vibecook/truffle-sidecar-linux-arm64": "0.1.0",
+    "@vibecook/truffle-sidecar-win32-x64": "0.1.0"
   },
   "devDependencies": {
     "typescript": "^5.7.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit",
+    "postinstall": "node scripts/postinstall.cjs"
   }
-}
+}

package/scripts/postinstall.cjs

@@ -0,0 +1,87 @@
+#!/usr/bin/env node
+
+/**
+ * Postinstall script for @vibecook/truffle.
+ *
+ * Verifies the sidecar binary is available via optionalDependencies.
+ * If missing (e.g., --no-optional), falls back to downloading from GitHub Releases.
+ *
+ * This follows the esbuild pattern: optionalDependencies as primary, HTTP download as fallback.
+ */
+
+/* eslint-disable @typescript-eslint/no-require-imports */
+
+const { existsSync, mkdirSync, chmodSync } = require('fs');
+const { join, dirname } = require('path');
+const { execSync } = require('child_process');
+
+const GITHUB_REPO = 'jamesyong-42/truffle';
+
+const PLATFORM_PACKAGES = {
+  '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',
+};
+
+// Go asset names use GOOS/GOARCH conventions (amd64 instead of x64)
+const GITHUB_ASSETS = {
+  'darwin-arm64': 'tsnet-sidecar-darwin-arm64',
+  'darwin-x64': 'tsnet-sidecar-darwin-amd64',
+  'linux-x64': 'tsnet-sidecar-linux-amd64',
+  'linux-arm64': 'tsnet-sidecar-linux-arm64',
+  'win32-x64': 'tsnet-sidecar-windows-amd64.exe',
+};
+
+function main() {
+  const key = `${process.platform}-${process.arch}`;
+  const pkg = PLATFORM_PACKAGES[key];
+  const ext = process.platform === 'win32' ? '.exe' : '';
+  const binName = `sidecar-slim${ext}`;
+
+  if (!pkg) {
+    console.warn(`[truffle] No prebuilt sidecar for ${key}. Build from source: cd packages/sidecar-slim && go build`);
+    return;
+  }
+
+  // Check if the optionalDependency was installed
+  try {
+    const pkgJson = require.resolve(`${pkg}/package.json`);
+    const binPath = join(dirname(pkgJson), 'bin', binName);
+    if (existsSync(binPath)) {
+      return; // All good
+    }
+  } catch {
+    // Not installed — fall through to download
+  }
+
+  // Fallback: download from GitHub Releases
+  const asset = GITHUB_ASSETS[key];
+  if (!asset) return;
+
+  const version = require('../package.json').version;
+  const url = `https://github.com/${GITHUB_REPO}/releases/download/v${version}/${asset}`;
+
+  console.log(`[truffle] Sidecar not found via npm. Downloading from GitHub Releases...`);
+
+  try {
+    const binDir = join(__dirname, '..', 'bin');
+    mkdirSync(binDir, { recursive: true });
+    const dest = join(binDir, binName);
+
+    execSync(`curl -fsSL "${url}" -o "${dest}"`, { stdio: 'pipe' });
+
+    if (process.platform !== 'win32') {
+      chmodSync(dest, 0o755);
+    }
+
+    console.log(`[truffle] Sidecar downloaded successfully.`);
+  } catch {
+    console.warn(`[truffle] Could not download sidecar binary.`);
+    console.warn(`[truffle] Download manually: ${url}`);
+    console.warn(`[truffle] Or build from source: cd packages/sidecar-slim && go build -o bin/sidecar-slim`);
+  }
+}
+
+main();