botsync 0.1.0 → 0.2.0

package/dist/commands/init.js

@@ -51,6 +51,7 @@ const crypto_1 = require("crypto");
 const config_js_1 = require("../config.js");
 const syncthing_js_1 = require("../syncthing.js");
 const passphrase_js_1 = require("../passphrase.js");
+const heartbeat_js_1 = require("../heartbeat.js");
 const ui = __importStar(require("../ui.js"));
 /**
  * Pick a random port in the ephemeral range for the Syncthing REST API.
@@ -87,11 +88,17 @@ async function init() {
     spin.succeed();
     const deviceId = await (0, syncthing_js_1.getDeviceId)();
     (0, config_js_1.writeConfig)({ apiKey, apiPort, deviceId });
+    // Step 5b: Generate network ID and start heartbeat
+    const networkId = (0, crypto_1.randomUUID)();
+    (0, config_js_1.writeNetworkId)(networkId);
+    (0, heartbeat_js_1.startHeartbeat)();
+    ui.stepDone("Network registered");
     // Step 6: Register with relay and display the code
     ui.gap();
     const { code, isRelay } = await (0, passphrase_js_1.createCode)({
         deviceId,
         folders: config_js_1.FOLDERS.map((f) => f.id),
+        networkId,
     });
     if (isRelay) {
         ui.passphraseBox(code, `npx botsync join ${code}`);
@@ -103,6 +110,8 @@ async function init() {
         ui.passphraseBox(code, `npx botsync join ${code.substring(0, 20)}...`);
     }
     ui.gap();
+    ui.info(`Dashboard: https://botsync.io/dashboard#${networkId}`);
+    ui.gap();
     // Step 7: Wait for the joining device to connect and auto-accept it
     const peerSpin = ui.spinner("Waiting for peer...");
     const accepted = await waitForPeer(apiKey, apiPort, peerSpin);

package/dist/commands/join.js

@@ -51,6 +51,7 @@ const crypto_1 = require("crypto");
 const config_js_1 = require("../config.js");
 const syncthing_js_1 = require("../syncthing.js");
 const passphrase_js_1 = require("../passphrase.js");
+const heartbeat_js_1 = require("../heartbeat.js");
 const ui = __importStar(require("../ui.js"));
 async function join(passphrase) {
     ui.header();
@@ -58,10 +59,12 @@ async function join(passphrase) {
     const spin0 = ui.spinner("Resolving pairing code...");
     let remoteId;
     let folders;
+    let networkId;
     try {
         const data = await (0, passphrase_js_1.resolveCode)(passphrase);
         remoteId = data.deviceId;
         folders = data.folders;
+        networkId = data.networkId;
         spin0.succeed();
     }
     catch (err) {
@@ -102,5 +105,14 @@ async function join(passphrase) {
         await (0, syncthing_js_1.addDeviceToFolder)(folderId, remoteId);
     }
     spin2.stop();
-    ui.connected(remoteId);
+    // Save network ID (inherited from init side) and start heartbeat
+    if (networkId) {
+        (0, config_js_1.writeNetworkId)(networkId);
+        (0, heartbeat_js_1.startHeartbeat)();
+        ui.connected(remoteId);
+        ui.info(`Dashboard: https://botsync.io/dashboard#${networkId}`);
+    }
+    else {
+        ui.connected(remoteId);
+    }
 }

package/dist/config.d.ts

@@ -19,6 +19,7 @@ export declare const FOLDERS: {
     id: string;
     path: string;
 }[];
+export declare const NETWORK_FILE: string;
 /** Runtime config shape — everything we need to talk to Syncthing */
 export interface BotsyncConfig {
     apiKey: string;
@@ -29,3 +30,7 @@ export interface BotsyncConfig {
 export declare function readConfig(): BotsyncConfig | null;
 /** Write config to disk. Creates parent dirs if needed. */
 export declare function writeConfig(config: BotsyncConfig): void;
+/** Read the network ID, or return null if not yet assigned */
+export declare function readNetworkId(): string | null;
+/** Write the network ID to disk. */
+export declare function writeNetworkId(networkId: string): void;

package/dist/config.js

@@ -10,9 +10,11 @@
  * and PID so that all commands can talk to the running Syncthing instance.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FOLDERS = exports.PID_FILE = exports.CONFIG_FILE = exports.SYNCTHING_BIN = exports.SYNCTHING_BIN_DIR = exports.SYNCTHING_CONFIG_DIR = exports.BOTSYNC_DIR = exports.SYNC_DIR = void 0;
+exports.NETWORK_FILE = exports.FOLDERS = exports.PID_FILE = exports.CONFIG_FILE = exports.SYNCTHING_BIN = exports.SYNCTHING_BIN_DIR = exports.SYNCTHING_CONFIG_DIR = exports.BOTSYNC_DIR = exports.SYNC_DIR = void 0;
 exports.readConfig = readConfig;
 exports.writeConfig = writeConfig;
+exports.readNetworkId = readNetworkId;
+exports.writeNetworkId = writeNetworkId;
 const fs_1 = require("fs");
 const path_1 = require("path");
 const os_1 = require("os");
@@ -38,6 +40,8 @@ exports.FOLDERS = [
     { id: "botsync-deliverables", path: (0, path_1.join)(exports.SYNC_DIR, "deliverables") },
     { id: "botsync-inbox", path: (0, path_1.join)(exports.SYNC_DIR, "inbox") },
 ];
+// Network identity file — stores the network ID for dashboard visibility
+exports.NETWORK_FILE = (0, path_1.join)(exports.BOTSYNC_DIR, "network.json");
 /** Read the config file, or return null if it doesn't exist */
 function readConfig() {
     try {
@@ -53,3 +57,19 @@ function writeConfig(config) {
     (0, fs_1.mkdirSync)(exports.BOTSYNC_DIR, { recursive: true });
     (0, fs_1.writeFileSync)(exports.CONFIG_FILE, JSON.stringify(config, null, 2));
 }
+/** Read the network ID, or return null if not yet assigned */
+function readNetworkId() {
+    try {
+        const raw = (0, fs_1.readFileSync)(exports.NETWORK_FILE, "utf-8");
+        const data = JSON.parse(raw);
+        return data.networkId || null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Write the network ID to disk. */
+function writeNetworkId(networkId) {
+    (0, fs_1.mkdirSync)(exports.BOTSYNC_DIR, { recursive: true });
+    (0, fs_1.writeFileSync)(exports.NETWORK_FILE, JSON.stringify({ networkId }, null, 2));
+}

package/dist/heartbeat.d.ts

@@ -0,0 +1,14 @@
+/**
+ * heartbeat.ts — Periodic heartbeat to the botsync relay.
+ *
+ * Sends device info every 60s so the dashboard at botsync.io/dashboard
+ * can show connected devices. The relay stores each heartbeat in KV
+ * with a 5-minute TTL — if we stop heartbeating, we disappear.
+ *
+ * The heartbeat runs in the background and never throws — a failed
+ * heartbeat just means we're invisible on the dashboard for a cycle.
+ */
+/** Start the heartbeat loop. Sends one immediately, then every 60s. */
+export declare function startHeartbeat(): void;
+/** Stop the heartbeat loop. */
+export declare function stopHeartbeat(): void;

package/dist/heartbeat.js

@@ -0,0 +1,73 @@
+"use strict";
+/**
+ * heartbeat.ts — Periodic heartbeat to the botsync relay.
+ *
+ * Sends device info every 60s so the dashboard at botsync.io/dashboard
+ * can show connected devices. The relay stores each heartbeat in KV
+ * with a 5-minute TTL — if we stop heartbeating, we disappear.
+ *
+ * The heartbeat runs in the background and never throws — a failed
+ * heartbeat just means we're invisible on the dashboard for a cycle.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startHeartbeat = startHeartbeat;
+exports.stopHeartbeat = stopHeartbeat;
+const os_1 = require("os");
+const config_js_1 = require("./config.js");
+const RELAY_URL = "https://relay.botsync.io";
+const HEARTBEAT_INTERVAL_MS = 60_000;
+let heartbeatTimer = null;
+/** Send a single heartbeat to the relay. */
+async function sendHeartbeat() {
+    const config = (0, config_js_1.readConfig)();
+    const networkId = (0, config_js_1.readNetworkId)();
+    if (!config?.deviceId || !networkId)
+        return;
+    try {
+        await fetch(`${RELAY_URL}/network/${encodeURIComponent(networkId)}/heartbeat`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({
+                deviceId: config.deviceId,
+                name: (0, os_1.hostname)(),
+                os: process.platform,
+                version: getVersion(),
+            }),
+            signal: AbortSignal.timeout(5000),
+        });
+    }
+    catch {
+        // Silent fail — dashboard visibility is best-effort
+    }
+}
+/** Start the heartbeat loop. Sends one immediately, then every 60s. */
+function startHeartbeat() {
+    if (heartbeatTimer)
+        return; // Already running
+    // Fire immediately so the device shows up right away
+    sendHeartbeat();
+    heartbeatTimer = setInterval(sendHeartbeat, HEARTBEAT_INTERVAL_MS);
+    // Don't let the heartbeat timer keep the process alive if
+    // everything else is done (shouldn't happen since Syncthing
+    // daemon is the main keep-alive, but just in case)
+    if (heartbeatTimer.unref) {
+        heartbeatTimer.unref();
+    }
+}
+/** Stop the heartbeat loop. */
+function stopHeartbeat() {
+    if (heartbeatTimer) {
+        clearInterval(heartbeatTimer);
+        heartbeatTimer = null;
+    }
+}
+/** Read package version, fallback to 0.0.0 */
+function getVersion() {
+    try {
+        const pkg = require("../package.json");
+        return pkg.version || "0.0.0";
+    }
+    catch {
+        return "0.0.0";
+    }
+}

package/dist/passphrase.d.ts

@@ -12,6 +12,7 @@
 export interface PassphraseData {
     deviceId: string;
     folders: string[];
+    networkId?: string;
 }
 /**
  * Register a device ID with the relay and get a short code.

package/dist/passphrase.js

@@ -32,7 +32,7 @@ async function createCode(data) {
         const res = await fetch(`${RELAY_URL}/pair`, {
             method: "POST",
             headers: { "Content-Type": "application/json" },
-            body: JSON.stringify({ deviceId: data.deviceId }),
+            body: JSON.stringify({ deviceId: data.deviceId, networkId: data.networkId }),
             signal: AbortSignal.timeout(5000),
         });
         if (res.ok) {
@@ -64,11 +64,12 @@ async function resolveCode(code) {
             const body = (await res.json());
             throw new Error(body.error || `Relay returned ${res.status}`);
         }
-        const { deviceId } = (await res.json());
+        const { deviceId, networkId } = (await res.json());
         // Folders are always the standard set — no need to encode them
         return {
             deviceId,
             folders: ["botsync-shared", "botsync-deliverables", "botsync-inbox"],
+            networkId: networkId || undefined,
         };
     }
     // Legacy base58 fallback

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "botsync",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "P2P file sync for AI agents. Syncthing under the hood. Two commands.",
   "bin": {
-    "botsync": "./dist/cli.js"
+    "botsync": "dist/cli.js"
   },
   "scripts": {
     "build": "tsc",
@@ -20,7 +20,7 @@
   "homepage": "https://botsync.io",
   "repository": {
     "type": "git",
-    "url": "https://github.com/hashbranch/botsync"
+    "url": "git+https://github.com/hashbranch/botsync.git"
   },
   "license": "MIT",
   "files": [