@vibecook/truffle 0.2.3 → 0.3.22

package/dist/create-mesh-node.d.ts

@@ -0,0 +1,49 @@
+import { NapiNode, type NapiPeerEvent } from '@vibecook/truffle-native';
+export interface CreateMeshNodeOptions {
+    /** Node name (becomes the Tailscale hostname prefix). */
+    name: string;
+    /** Override sidecar path. If omitted, auto-resolved. */
+    sidecarPath?: string;
+    /** State directory for Tailscale. */
+    stateDir?: string;
+    /** Tailscale auth key (for headless/CI setups). */
+    authKey?: string;
+    /** Whether this node is ephemeral (removed from tailnet on stop). */
+    ephemeral?: boolean;
+    /** WebSocket listener port (0 = auto). */
+    wsPort?: number;
+    /**
+     * Auto-open the Tailscale auth URL in the default browser.
+     * Defaults to true. Set to false to handle auth manually.
+     */
+    autoAuth?: boolean;
+    /**
+     * Custom URL opener. Overrides the default browser opener.
+     * Useful in Electron where you'd use `shell.openExternal()`.
+     */
+    openUrl?: (url: string) => void;
+    /** Called when Tailscale auth is required. Receives the auth URL. */
+    onAuthRequired?: (url: string) => void;
+    /** Called for peer change events (join, leave, update, ws_connected, etc.). */
+    onPeerChange?: (event: NapiPeerEvent) => void;
+}
+/**
+ * Create and start a Truffle node with sensible defaults.
+ *
+ * - Auto-resolves the sidecar binary path
+ * - Auto-opens the Tailscale auth URL in the browser (configurable)
+ * - Provides auth and peer lifecycle callbacks
+ *
+ * @example
+ * ```ts
+ * const node = await createMeshNode({
+ *   name: 'my-app',
+ *   onPeerChange: (event) => console.log('Peer event:', event),
+ * });
+ *
+ * const peers = await node.getPeers();
+ * await node.send('peer-id', 'chat', Buffer.from(JSON.stringify({ text: 'hello' })));
+ * ```
+ */
+export declare function createMeshNode(options: CreateMeshNodeOptions): Promise<NapiNode>;
+//# sourceMappingURL=create-mesh-node.d.ts.map

package/dist/create-mesh-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-mesh-node.d.ts","sourceRoot":"","sources":["../src/create-mesh-node.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAuB,KAAK,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAG7F,MAAM,WAAW,qBAAqB;IACpC,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,qEAAqE;IACrE,cAAc,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,+EAA+E;IAC/E,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;CAC/C;AAmBD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,QAAQ,CAAC,CA2CtF"}

package/dist/create-mesh-node.js

@@ -0,0 +1,67 @@
+import { execSync } from 'node:child_process';
+import { NapiNode } from '@vibecook/truffle-native';
+import { resolveSidecarPath } from './sidecar.js';
+/**
+ * Open a URL in the system's default browser.
+ */
+function defaultOpenUrl(url) {
+    try {
+        if (process.platform === 'darwin') {
+            execSync(`open "${url}"`);
+        }
+        else if (process.platform === 'win32') {
+            execSync(`start "" "${url}"`);
+        }
+        else {
+            execSync(`xdg-open "${url}"`);
+        }
+    }
+    catch {
+        // Silently fail
+    }
+}
+/**
+ * Create and start a Truffle node with sensible defaults.
+ *
+ * - Auto-resolves the sidecar binary path
+ * - Auto-opens the Tailscale auth URL in the browser (configurable)
+ * - Provides auth and peer lifecycle callbacks
+ *
+ * @example
+ * ```ts
+ * const node = await createMeshNode({
+ *   name: 'my-app',
+ *   onPeerChange: (event) => console.log('Peer event:', event),
+ * });
+ *
+ * const peers = await node.getPeers();
+ * await node.send('peer-id', 'chat', Buffer.from(JSON.stringify({ text: 'hello' })));
+ * ```
+ */
+export async function createMeshNode(options) {
+    const { name, autoAuth = true, openUrl: customOpenUrl, onAuthRequired, onPeerChange, sidecarPath, stateDir, authKey, ephemeral, wsPort, } = options;
+    const resolvedSidecarPath = sidecarPath ?? resolveSidecarPath();
+    const node = new NapiNode();
+    const config = {
+        name,
+        sidecarPath: resolvedSidecarPath,
+        stateDir,
+        authKey,
+        ephemeral,
+        wsPort,
+    };
+    await node.start(config);
+    // Subscribe to peer events for auth handling and user callback
+    node.onPeerChange((event) => {
+        if (event.eventType === 'auth_required' && event.authUrl) {
+            if (autoAuth) {
+                const opener = customOpenUrl ?? defaultOpenUrl;
+                opener(event.authUrl);
+            }
+            onAuthRequired?.(event.authUrl);
+        }
+        onPeerChange?.(event);
+    });
+    return node;
+}
+//# sourceMappingURL=create-mesh-node.js.map

package/dist/create-mesh-node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-mesh-node.js","sourceRoot":"","sources":["../src/create-mesh-node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAA2C,MAAM,0BAA0B,CAAC;AAC7F,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AA+BlD;;GAEG;AACH,SAAS,cAAc,CAAC,GAAW;IACjC,IAAI,CAAC;QACH,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAClC,QAAQ,CAAC,SAAS,GAAG,GAAG,CAAC,CAAC;QAC5B,CAAC;aAAM,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;YACxC,QAAQ,CAAC,aAAa,GAAG,GAAG,CAAC,CAAC;QAChC,CAAC;aAAM,CAAC;YACN,QAAQ,CAAC,aAAa,GAAG,GAAG,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,gBAAgB;IAClB,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAA8B;IACjE,MAAM,EACJ,IAAI,EACJ,QAAQ,GAAG,IAAI,EACf,OAAO,EAAE,aAAa,EACtB,cAAc,EACd,YAAY,EACZ,WAAW,EACX,QAAQ,EACR,OAAO,EACP,SAAS,EACT,MAAM,GACP,GAAG,OAAO,CAAC;IAEZ,MAAM,mBAAmB,GAAG,WAAW,IAAI,kBAAkB,EAAE,CAAC;IAEhE,MAAM,IAAI,GAAG,IAAI,QAAQ,EAAE,CAAC;IAE5B,MAAM,MAAM,GAAmB;QAC7B,IAAI;QACJ,WAAW,EAAE,mBAAmB;QAChC,QAAQ;QACR,OAAO;QACP,SAAS;QACT,MAAM;KACP,CAAC;IAEF,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAEzB,+DAA+D;IAC/D,IAAI,CAAC,YAAY,CAAC,CAAC,KAAoB,EAAE,EAAE;QACzC,IAAI,KAAK,CAAC,SAAS,KAAK,eAAe,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YACzD,IAAI,QAAQ,EAAE,CAAC;gBACb,MAAM,MAAM,GAAG,aAAa,IAAI,cAAc,CAAC;gBAC/C,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACxB,CAAC;YACD,cAAc,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAClC,CAAC;QAED,YAAY,EAAE,CAAC,KAAK,CAAC,CAAC;IACxB,CAAC,CAAC,CAAC;IAEH,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/index.d.ts

@@ -1,4 +1,5 @@
-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 { NapiNode, NapiFileTransfer } from '@vibecook/truffle-native';
+export type { NapiNodeConfig, NapiNodeIdentity, NapiPeer, NapiPingResult, NapiHealthInfo, NapiPeerEvent, NapiNamespacedMessage, NapiFileOffer, NapiTransferResult, NapiTransferProgress, NapiFileTransferEvent, } from '@vibecook/truffle-native';
 export { resolveSidecarPath } from './sidecar.js';
+export { createMeshNode, type CreateMeshNodeOptions } from './create-mesh-node.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":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAGtE,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,QAAQ,EACR,cAAc,EACd,cAAc,EACd,aAAa,EACb,qBAAqB,EACrB,aAAa,EACb,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAGlD,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -1,5 +1,7 @@
 // Re-export classes (values) from the native Rust addon
-export { NapiMeshNode, NapiFileTransferAdapter, NapiMessageBus, NapiStoreSyncAdapter, } from '@vibecook/truffle-native';
+export { NapiNode, NapiFileTransfer } from '@vibecook/truffle-native';
 // Sidecar binary resolution
 export { resolveSidecarPath } from './sidecar.js';
+// High-level API
+export { createMeshNode } from './create-mesh-node.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,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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAiBtE,4BAA4B;AAC5B,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAElD,iBAAiB;AACjB,OAAO,EAAE,cAAc,EAA8B,MAAM,uBAAuB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibecook/truffle",
-  "version": "0.2.3",
+  "version": "0.3.22",
   "description": "Mesh networking for local-first apps, built on Tailscale",
   "license": "MIT",
   "author": "James Yong",
@@ -43,23 +43,23 @@
     "bin",
     "scripts"
   ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit",
+    "postinstall": "node scripts/postinstall.cjs"
+  },
   "dependencies": {
-    "@vibecook/truffle-native": "0.2.3"
+    "@vibecook/truffle-native": "workspace:*"
   },
   "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"
+    "@vibecook/truffle-sidecar-darwin-arm64": "^0.3.0",
+    "@vibecook/truffle-sidecar-darwin-x64": "^0.3.0",
+    "@vibecook/truffle-sidecar-linux-x64": "^0.3.0",
+    "@vibecook/truffle-sidecar-linux-arm64": "^0.3.0",
+    "@vibecook/truffle-sidecar-win32-x64": "^0.3.0"
   },
   "devDependencies": {
     "typescript": "^5.7.0"
-  },
-  "scripts": {
-    "build": "tsc",
-    "clean": "rm -rf dist",
-    "typecheck": "tsc --noEmit",
-    "postinstall": "node scripts/postinstall.cjs"
   }
-}
+}

package/LICENSE

@@ -1,21 +0,0 @@
-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.