@cryptforge/key-exchange 0.1.0 → 0.2.0

package/dist/index.mjs

@@ -495,11 +495,11 @@ var KeyTransportClient = class {
       throw error;
     }
   };
-  broadcastClientState = async (id, state) => {
+  broadcastClientState = async (id, state, name, isHeartbeat) => {
     console.log("KeyTransportClient.broadcastClientState");
     this.peers.set(id, state);
     try {
-      await this.sendRequest(MESSAGES.broadcastClientState, { id, state });
+      await this.sendRequest(MESSAGES.broadcastClientState, { id, state, name, isHeartbeat });
     } catch (error) {
       console.error("Failed to broadcast client state:", error);
       throw error;
@@ -567,6 +567,98 @@ var KeyTransportClient = class {
     return this.ws !== null && this.ws.readyState === WebSocket.OPEN;
   };
 };
+
+// src/devicePairing.ts
+var DevicePairingManager = class {
+  storageKey;
+  constructor(identityId) {
+    this.storageKey = `cryptforge:identity:${identityId}:linked-devices`;
+  }
+  /**
+   * Get all linked devices for this app
+   */
+  getLinkedDevices = () => {
+    try {
+      const stored = localStorage.getItem(this.storageKey);
+      return stored ? JSON.parse(stored) : [];
+    } catch (error) {
+      console.error("Failed to load linked devices:", error);
+      return [];
+    }
+  };
+  /**
+   * Add a device to the linked devices list
+   * Called after successful key exchange
+   */
+  addLinkedDevice = (device) => {
+    try {
+      const devices = this.getLinkedDevices();
+      const existing = devices.find((d) => d.id === device.id);
+      if (existing) {
+        existing.name = device.name;
+      } else {
+        devices.push({
+          id: device.id,
+          name: device.name,
+          linkedAt: Date.now()
+        });
+      }
+      localStorage.setItem(this.storageKey, JSON.stringify(devices));
+    } catch (error) {
+      console.error("Failed to add linked device:", error);
+    }
+  };
+  /**
+   * Remove a device from the linked devices list
+   * For future use when user wants to unlink a device
+   */
+  removeLinkedDevice = (id) => {
+    try {
+      const devices = this.getLinkedDevices().filter((d) => d.id !== id);
+      localStorage.setItem(this.storageKey, JSON.stringify(devices));
+      console.log(`Removed linked device: ${id}`);
+    } catch (error) {
+      console.error("Failed to remove linked device:", error);
+    }
+  };
+  /**
+   * Update the hostname of a device (system-level name)
+   */
+  updateDeviceName = (id, name) => {
+    try {
+      const devices = this.getLinkedDevices();
+      const device = devices.find((d) => d.id === id);
+      if (device) {
+        device.name = name;
+        localStorage.setItem(this.storageKey, JSON.stringify(devices));
+      }
+    } catch (error) {
+      console.error("Failed to update device name:", error);
+    }
+  };
+  /**
+   * Set a custom user-defined name for a device
+   */
+  setCustomName = (id, customName) => {
+    try {
+      const devices = this.getLinkedDevices();
+      const device = devices.find((d) => d.id === id);
+      if (device) {
+        device.customName = customName.trim() || void 0;
+        localStorage.setItem(this.storageKey, JSON.stringify(devices));
+      }
+    } catch (error) {
+      console.error("Failed to set custom device name:", error);
+    }
+  };
+  /**
+   * Check if a device is linked
+   */
+  isLinked = (id) => {
+    return this.getLinkedDevices().some((d) => d.id === id);
+  };
+};
 export {
+  DevicePairingManager,
   KeyTransportClient
 };

package/dist/server.d.mts

@@ -43,4 +43,48 @@ declare class KeyTransportServer {
     getPort: () => number;
 }
 
-export { KeyTransportServer, useKeyExchangeServer };
+/**
+ * Manages linked devices (devices that have completed key exchange)
+ * Stores device info in localStorage scoped per app
+ */
+interface LinkedDevice {
+    id: string;
+    name: string;
+    customName?: string;
+    linkedAt: number;
+}
+declare class DevicePairingManager {
+    private storageKey;
+    constructor(identityId: string);
+    /**
+     * Get all linked devices for this app
+     */
+    getLinkedDevices: () => LinkedDevice[];
+    /**
+     * Add a device to the linked devices list
+     * Called after successful key exchange
+     */
+    addLinkedDevice: (device: {
+        id: string;
+        name: string;
+    }) => void;
+    /**
+     * Remove a device from the linked devices list
+     * For future use when user wants to unlink a device
+     */
+    removeLinkedDevice: (id: string) => void;
+    /**
+     * Update the hostname of a device (system-level name)
+     */
+    updateDeviceName: (id: string, name: string) => void;
+    /**
+     * Set a custom user-defined name for a device
+     */
+    setCustomName: (id: string, customName: string) => void;
+    /**
+     * Check if a device is linked
+     */
+    isLinked: (id: string) => boolean;
+}
+
+export { DevicePairingManager, KeyTransportServer, type LinkedDevice, useKeyExchangeServer };

package/dist/server.d.ts

@@ -43,4 +43,48 @@ declare class KeyTransportServer {
     getPort: () => number;
 }
 
-export { KeyTransportServer, useKeyExchangeServer };
+/**
+ * Manages linked devices (devices that have completed key exchange)
+ * Stores device info in localStorage scoped per app
+ */
+interface LinkedDevice {
+    id: string;
+    name: string;
+    customName?: string;
+    linkedAt: number;
+}
+declare class DevicePairingManager {
+    private storageKey;
+    constructor(identityId: string);
+    /**
+     * Get all linked devices for this app
+     */
+    getLinkedDevices: () => LinkedDevice[];
+    /**
+     * Add a device to the linked devices list
+     * Called after successful key exchange
+     */
+    addLinkedDevice: (device: {
+        id: string;
+        name: string;
+    }) => void;
+    /**
+     * Remove a device from the linked devices list
+     * For future use when user wants to unlink a device
+     */
+    removeLinkedDevice: (id: string) => void;
+    /**
+     * Update the hostname of a device (system-level name)
+     */
+    updateDeviceName: (id: string, name: string) => void;
+    /**
+     * Set a custom user-defined name for a device
+     */
+    setCustomName: (id: string, customName: string) => void;
+    /**
+     * Check if a device is linked
+     */
+    isLinked: (id: string) => boolean;
+}
+
+export { DevicePairingManager, KeyTransportServer, type LinkedDevice, useKeyExchangeServer };

package/dist/server.js

@@ -30,6 +30,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/server.ts
 var server_exports = {};
 __export(server_exports, {
+  DevicePairingManager: () => DevicePairingManager,
   KeyTransportServer: () => KeyTransportServer,
   useKeyExchangeServer: () => useKeyExchangeServer
 });
@@ -275,7 +276,7 @@ function useKeyExchangeServer(onEvent) {
     });
   };
   const completeSetupSuccess = async () => {
-    console.log("sending compltion message to client");
+    console.log("sending completion message to client");
     sendResponse({
       to: [client],
       header: "Setup Succeeded",
@@ -329,16 +330,9 @@ function useNetworkPresence(onUpdate, onRequest) {
   const swarm = new import_hyperswarm.default();
   swarm.on("connection", (connection) => {
     const name = import_b4a3.default.toString(connection.remotePublicKey, "hex");
-    console.log("Presence: * got a connection from:", name, "*");
     connections.push(connection);
     sendStateRequestMessage(connection);
     connection.once("close", () => {
-      console.log(
-        `Presence: Connection closed.  Removing connection ${import_b4a3.default.toString(
-          connection.remotePublicKey,
-          "hex"
-        )}`
-      );
       connections.splice(connections.indexOf(connection), 1);
       const id = deviceIDs.get(import_b4a3.default.toString(connection.remotePublicKey, "hex"));
       if (id) {
@@ -351,17 +345,18 @@ function useNetworkPresence(onUpdate, onRequest) {
       try {
         parsedData = JSON.parse(data);
       } catch (error) {
-        console.error("Error parsing data:", error);
+        console.error("Error parsing presence data:", error);
         return;
       }
       const header = parsedData;
-      console.log(
-        "Presence: got data for ",
-        connection.publicKey.toString("hex")
-      );
       if (header.type === "update") {
         const payload = parsedData;
-        onUpdate({ id: payload.id, state: payload.state });
+        onUpdate({
+          id: payload.id,
+          state: payload.state,
+          name: payload.name,
+          isHeartbeat: payload.isHeartbeat
+        });
         deviceIDs.set(
           import_b4a3.default.toString(connection.remotePublicKey, "hex"),
           payload.id
@@ -381,46 +376,35 @@ function useNetworkPresence(onUpdate, onRequest) {
   });
   const connections = [];
   const connect = async (topic, id) => {
-    console.log("Presence: connecting to topic: ", topic);
     const key = import_b4a3.default.from(topic, "hex");
-    console.log("key: ", key);
     const discovery = swarm.join(key, { client: true, server: true });
-    console.log("got discovery:  ");
     const publicKey = import_b4a3.default.toString(
       discovery.swarm.keyPair?.publicKey || discovery.swarm.publicKey || Buffer.alloc(32),
       "hex"
     );
-    console.log("Presence: public key is ", publicKey);
     deviceIDs.set(publicKey, id);
-    discovery.flushed().then(() => {
-      console.log("Presence: joined topic:", import_b4a3.default.toString(key, "hex"));
-    });
+    await discovery.flushed();
   };
   const sendStateRequestMessage = async (connection) => {
     const message = {
       type: "request"
     };
     const payload = JSON.stringify(message);
-    console.log(
-      "sending state request message to: ",
-      connection.publicKey.toString("hex")
-    );
     connection.write(payload);
   };
-  const receiveStatusMessage = async (id, state) => {
-    return broadcastStatusMessage(id, state);
+  const receiveStatusMessage = async (id, state, name, isHeartbeat) => {
+    return broadcastStatusMessage(id, state, name, isHeartbeat);
   };
-  const broadcastStatusMessage = (id, state) => {
-    console.log(`server got connection state message for ${id}: `, state);
+  const broadcastStatusMessage = (id, state, name, isHeartbeat) => {
     const message = {
       type: "update",
       id,
-      state
+      state,
+      name,
+      isHeartbeat
     };
-    console.log("active connections: ", connections.length);
     const payload = JSON.stringify(message);
     for (const connection of connections) {
-      console.log("sending message to: ", connection.publicKey.toString("hex"));
       connection.write(payload);
     }
     onUpdate(message);
@@ -688,8 +672,8 @@ var CoreTransportLogic = class {
     await this.presence.connect(topicHash, deviceInfo.id);
     this.presenceConnected = true;
   }
-  broadcastClientState(id, state) {
-    this.presence.receiveStatusMessage(id, state);
+  broadcastClientState(id, state, name, isHeartbeat) {
+    this.presence.receiveStatusMessage(id, state, name, isHeartbeat);
   }
 };
 
@@ -892,7 +876,7 @@ var KeyTransportServer = class {
         case MESSAGES.broadcastClientState:
           this.logger?.log("\u{1F4E1} Broadcasting client state...");
           try {
-            this.core.broadcastClientState(requestData.id, requestData.state);
+            this.core.broadcastClientState(requestData.id, requestData.state, requestData.isHeartbeat);
             this.sendResponse(ws, type, requestId, { success: true });
           } catch (error) {
             this.sendResponse(ws, type, requestId, null, {
@@ -933,8 +917,100 @@ var KeyTransportServer = class {
     return this.port;
   };
 };
+
+// src/devicePairing.ts
+var DevicePairingManager = class {
+  storageKey;
+  constructor(identityId) {
+    this.storageKey = `cryptforge:identity:${identityId}:linked-devices`;
+  }
+  /**
+   * Get all linked devices for this app
+   */
+  getLinkedDevices = () => {
+    try {
+      const stored = localStorage.getItem(this.storageKey);
+      return stored ? JSON.parse(stored) : [];
+    } catch (error) {
+      console.error("Failed to load linked devices:", error);
+      return [];
+    }
+  };
+  /**
+   * Add a device to the linked devices list
+   * Called after successful key exchange
+   */
+  addLinkedDevice = (device) => {
+    try {
+      const devices = this.getLinkedDevices();
+      const existing = devices.find((d) => d.id === device.id);
+      if (existing) {
+        existing.name = device.name;
+      } else {
+        devices.push({
+          id: device.id,
+          name: device.name,
+          linkedAt: Date.now()
+        });
+      }
+      localStorage.setItem(this.storageKey, JSON.stringify(devices));
+    } catch (error) {
+      console.error("Failed to add linked device:", error);
+    }
+  };
+  /**
+   * Remove a device from the linked devices list
+   * For future use when user wants to unlink a device
+   */
+  removeLinkedDevice = (id) => {
+    try {
+      const devices = this.getLinkedDevices().filter((d) => d.id !== id);
+      localStorage.setItem(this.storageKey, JSON.stringify(devices));
+      console.log(`Removed linked device: ${id}`);
+    } catch (error) {
+      console.error("Failed to remove linked device:", error);
+    }
+  };
+  /**
+   * Update the hostname of a device (system-level name)
+   */
+  updateDeviceName = (id, name) => {
+    try {
+      const devices = this.getLinkedDevices();
+      const device = devices.find((d) => d.id === id);
+      if (device) {
+        device.name = name;
+        localStorage.setItem(this.storageKey, JSON.stringify(devices));
+      }
+    } catch (error) {
+      console.error("Failed to update device name:", error);
+    }
+  };
+  /**
+   * Set a custom user-defined name for a device
+   */
+  setCustomName = (id, customName) => {
+    try {
+      const devices = this.getLinkedDevices();
+      const device = devices.find((d) => d.id === id);
+      if (device) {
+        device.customName = customName.trim() || void 0;
+        localStorage.setItem(this.storageKey, JSON.stringify(devices));
+      }
+    } catch (error) {
+      console.error("Failed to set custom device name:", error);
+    }
+  };
+  /**
+   * Check if a device is linked
+   */
+  isLinked = (id) => {
+    return this.getLinkedDevices().some((d) => d.id === id);
+  };
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  DevicePairingManager,
   KeyTransportServer,
   useKeyExchangeServer
 });

package/dist/server.mjs

@@ -238,7 +238,7 @@ function useKeyExchangeServer(onEvent) {
     });
   };
   const completeSetupSuccess = async () => {
-    console.log("sending compltion message to client");
+    console.log("sending completion message to client");
     sendResponse({
       to: [client],
       header: "Setup Succeeded",
@@ -292,16 +292,9 @@ function useNetworkPresence(onUpdate, onRequest) {
   const swarm = new Hyperswarm();
   swarm.on("connection", (connection) => {
     const name = b4a3.toString(connection.remotePublicKey, "hex");
-    console.log("Presence: * got a connection from:", name, "*");
     connections.push(connection);
     sendStateRequestMessage(connection);
     connection.once("close", () => {
-      console.log(
-        `Presence: Connection closed.  Removing connection ${b4a3.toString(
-          connection.remotePublicKey,
-          "hex"
-        )}`
-      );
       connections.splice(connections.indexOf(connection), 1);
       const id = deviceIDs.get(b4a3.toString(connection.remotePublicKey, "hex"));
       if (id) {
@@ -314,17 +307,18 @@ function useNetworkPresence(onUpdate, onRequest) {
       try {
         parsedData = JSON.parse(data);
       } catch (error) {
-        console.error("Error parsing data:", error);
+        console.error("Error parsing presence data:", error);
         return;
       }
       const header = parsedData;
-      console.log(
-        "Presence: got data for ",
-        connection.publicKey.toString("hex")
-      );
       if (header.type === "update") {
         const payload = parsedData;
-        onUpdate({ id: payload.id, state: payload.state });
+        onUpdate({
+          id: payload.id,
+          state: payload.state,
+          name: payload.name,
+          isHeartbeat: payload.isHeartbeat
+        });
         deviceIDs.set(
           b4a3.toString(connection.remotePublicKey, "hex"),
           payload.id
@@ -344,46 +338,35 @@ function useNetworkPresence(onUpdate, onRequest) {
   });
   const connections = [];
   const connect = async (topic, id) => {
-    console.log("Presence: connecting to topic: ", topic);
     const key = b4a3.from(topic, "hex");
-    console.log("key: ", key);
     const discovery = swarm.join(key, { client: true, server: true });
-    console.log("got discovery:  ");
     const publicKey = b4a3.toString(
       discovery.swarm.keyPair?.publicKey || discovery.swarm.publicKey || Buffer.alloc(32),
       "hex"
     );
-    console.log("Presence: public key is ", publicKey);
     deviceIDs.set(publicKey, id);
-    discovery.flushed().then(() => {
-      console.log("Presence: joined topic:", b4a3.toString(key, "hex"));
-    });
+    await discovery.flushed();
   };
   const sendStateRequestMessage = async (connection) => {
     const message = {
       type: "request"
     };
     const payload = JSON.stringify(message);
-    console.log(
-      "sending state request message to: ",
-      connection.publicKey.toString("hex")
-    );
     connection.write(payload);
   };
-  const receiveStatusMessage = async (id, state) => {
-    return broadcastStatusMessage(id, state);
+  const receiveStatusMessage = async (id, state, name, isHeartbeat) => {
+    return broadcastStatusMessage(id, state, name, isHeartbeat);
   };
-  const broadcastStatusMessage = (id, state) => {
-    console.log(`server got connection state message for ${id}: `, state);
+  const broadcastStatusMessage = (id, state, name, isHeartbeat) => {
     const message = {
       type: "update",
       id,
-      state
+      state,
+      name,
+      isHeartbeat
     };
-    console.log("active connections: ", connections.length);
     const payload = JSON.stringify(message);
     for (const connection of connections) {
-      console.log("sending message to: ", connection.publicKey.toString("hex"));
       connection.write(payload);
     }
     onUpdate(message);
@@ -651,8 +634,8 @@ var CoreTransportLogic = class {
     await this.presence.connect(topicHash, deviceInfo.id);
     this.presenceConnected = true;
   }
-  broadcastClientState(id, state) {
-    this.presence.receiveStatusMessage(id, state);
+  broadcastClientState(id, state, name, isHeartbeat) {
+    this.presence.receiveStatusMessage(id, state, name, isHeartbeat);
   }
 };
 
@@ -855,7 +838,7 @@ var KeyTransportServer = class {
         case MESSAGES.broadcastClientState:
           this.logger?.log("\u{1F4E1} Broadcasting client state...");
           try {
-            this.core.broadcastClientState(requestData.id, requestData.state);
+            this.core.broadcastClientState(requestData.id, requestData.state, requestData.isHeartbeat);
             this.sendResponse(ws, type, requestId, { success: true });
           } catch (error) {
             this.sendResponse(ws, type, requestId, null, {
@@ -896,7 +879,99 @@ var KeyTransportServer = class {
     return this.port;
   };
 };
+
+// src/devicePairing.ts
+var DevicePairingManager = class {
+  storageKey;
+  constructor(identityId) {
+    this.storageKey = `cryptforge:identity:${identityId}:linked-devices`;
+  }
+  /**
+   * Get all linked devices for this app
+   */
+  getLinkedDevices = () => {
+    try {
+      const stored = localStorage.getItem(this.storageKey);
+      return stored ? JSON.parse(stored) : [];
+    } catch (error) {
+      console.error("Failed to load linked devices:", error);
+      return [];
+    }
+  };
+  /**
+   * Add a device to the linked devices list
+   * Called after successful key exchange
+   */
+  addLinkedDevice = (device) => {
+    try {
+      const devices = this.getLinkedDevices();
+      const existing = devices.find((d) => d.id === device.id);
+      if (existing) {
+        existing.name = device.name;
+      } else {
+        devices.push({
+          id: device.id,
+          name: device.name,
+          linkedAt: Date.now()
+        });
+      }
+      localStorage.setItem(this.storageKey, JSON.stringify(devices));
+    } catch (error) {
+      console.error("Failed to add linked device:", error);
+    }
+  };
+  /**
+   * Remove a device from the linked devices list
+   * For future use when user wants to unlink a device
+   */
+  removeLinkedDevice = (id) => {
+    try {
+      const devices = this.getLinkedDevices().filter((d) => d.id !== id);
+      localStorage.setItem(this.storageKey, JSON.stringify(devices));
+      console.log(`Removed linked device: ${id}`);
+    } catch (error) {
+      console.error("Failed to remove linked device:", error);
+    }
+  };
+  /**
+   * Update the hostname of a device (system-level name)
+   */
+  updateDeviceName = (id, name) => {
+    try {
+      const devices = this.getLinkedDevices();
+      const device = devices.find((d) => d.id === id);
+      if (device) {
+        device.name = name;
+        localStorage.setItem(this.storageKey, JSON.stringify(devices));
+      }
+    } catch (error) {
+      console.error("Failed to update device name:", error);
+    }
+  };
+  /**
+   * Set a custom user-defined name for a device
+   */
+  setCustomName = (id, customName) => {
+    try {
+      const devices = this.getLinkedDevices();
+      const device = devices.find((d) => d.id === id);
+      if (device) {
+        device.customName = customName.trim() || void 0;
+        localStorage.setItem(this.storageKey, JSON.stringify(devices));
+      }
+    } catch (error) {
+      console.error("Failed to set custom device name:", error);
+    }
+  };
+  /**
+   * Check if a device is linked
+   */
+  isLinked = (id) => {
+    return this.getLinkedDevices().some((d) => d.id === id);
+  };
+};
 export {
+  DevicePairingManager,
   KeyTransportServer,
   useKeyExchangeServer
 };

package/dist/vite.d.mts

@@ -0,0 +1,23 @@
+import { Plugin } from 'vite';
+
+/**
+ * Vite plugin that automatically externalizes native Node.js modules
+ * required by @cryptforge/key-exchange for Electron main process builds.
+ *
+ * This prevents Vite from trying to bundle native modules, which would fail.
+ *
+ * @example
+ * ```ts
+ * // vite.main.config.ts
+ * import { defineConfig } from "vite";
+ * import { cryptforgeMainPlugin } from "@cryptforge/key-exchange/vite";
+ *
+ * export default defineConfig({
+ *   plugins: [cryptforgeMainPlugin()],
+ *   // ... rest of config
+ * });
+ * ```
+ */
+declare const cryptforgeMainPlugin: () => Plugin;
+
+export { cryptforgeMainPlugin };