@cryptforge/key-exchange 0.1.0 → 0.2.0

package/README.md

@@ -103,6 +103,61 @@ src/
 - WebSocket-based communication for web/browser
 - Hyperswarm support for server-to-server
 
+## Vite Plugin (Electron Main Process)
+
+When building Electron apps with Vite, native Node.js modules need to be externalized to prevent bundling errors. The package includes a Vite plugin that automatically handles this for you.
+
+### Usage
+
+```typescript
+// vite.main.config.ts (for Electron main process)
+import { defineConfig } from "vite";
+import { cryptforgeMainPlugin } from "@cryptforge/key-exchange/vite";
+
+export default defineConfig({
+  plugins: [cryptforgeMainPlugin()],
+  // ... rest of your config
+});
+```
+
+### What it does
+
+The plugin automatically externalizes these native modules:
+- `hyperswarm`, `hyperdht`, `udx-native`, `utp-native`
+- `sodium-native`, `hypercore`, `hypercore-crypto`
+- `random-access-file`, `compact-encoding`, `b4a`
+- `@cryptforge/key-exchange`
+
+### Without the plugin
+
+If you prefer manual configuration or need to customize, you can add externals manually:
+
+```typescript
+export default defineConfig({
+  build: {
+    rollupOptions: {
+      external: [
+        "hyperswarm",
+        "hyperdht",
+        "udx-native",
+        // ... other native modules
+      ],
+    },
+  },
+});
+```
+
+### Important Notes
+
+- ⚠️ **Only use this plugin for Electron main process builds**
+- ✅ The plugin merges with your existing `external` configuration
+- ✅ Works with both array and function forms of `external`
+- ✅ Supports custom build tools that use Rollup
+
+## Additional Documentation
+
+- **[USAGE_EXAMPLES.md](./USAGE_EXAMPLES.md)** - Additional usage examples for different environments
+
 ## License
 
 ISC

package/dist/electron-main.d.mts

@@ -35,7 +35,7 @@ declare class CoreTransportLogic {
     getDeviceInfo(): Promise<DeviceInfo>;
     getHostname(): Promise<string>;
     connectPresence(topic: string): Promise<void>;
-    broadcastClientState(id: string, state: ClientConnectionState): void;
+    broadcastClientState(id: string, state: ClientConnectionState, name?: string, isHeartbeat?: boolean): void;
 }
 
 export { CoreTransportLogic, setupKeyExchangeHandlers };

package/dist/electron-main.d.ts

@@ -35,7 +35,7 @@ declare class CoreTransportLogic {
     getDeviceInfo(): Promise<DeviceInfo>;
     getHostname(): Promise<string>;
     connectPresence(topic: string): Promise<void>;
-    broadcastClientState(id: string, state: ClientConnectionState): void;
+    broadcastClientState(id: string, state: ClientConnectionState, name?: string, isHeartbeat?: boolean): void;
 }
 
 export { CoreTransportLogic, setupKeyExchangeHandlers };

package/dist/electron-main.js

@@ -71,16 +71,9 @@ function useNetworkPresence(onUpdate, onRequest) {
   const swarm = new import_hyperswarm.default();
   swarm.on("connection", (connection) => {
     const name = import_b4a.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_b4a.default.toString(
-          connection.remotePublicKey,
-          "hex"
-        )}`
-      );
       connections.splice(connections.indexOf(connection), 1);
       const id = deviceIDs.get(import_b4a.default.toString(connection.remotePublicKey, "hex"));
       if (id) {
@@ -93,17 +86,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_b4a.default.toString(connection.remotePublicKey, "hex"),
           payload.id
@@ -123,46 +117,35 @@ function useNetworkPresence(onUpdate, onRequest) {
   });
   const connections = [];
   const connect = async (topic, id) => {
-    console.log("Presence: connecting to topic: ", topic);
     const key = import_b4a.default.from(topic, "hex");
-    console.log("key: ", key);
     const discovery = swarm.join(key, { client: true, server: true });
-    console.log("got discovery:  ");
     const publicKey = import_b4a.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_b4a.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);
@@ -513,7 +496,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",
@@ -686,8 +669,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);
   }
 };
 
@@ -740,9 +723,9 @@ var KeyTransportMain = class {
   connectPresence = async (topic) => {
     return this.core.connectPresence(topic);
   };
-  broadcastClientState = async (id, state) => {
+  broadcastClientState = async (id, state, name, isHeartbeat) => {
     this.peers.set(id, state);
-    this.core.broadcastClientState(id, state);
+    this.core.broadcastClientState(id, state, name, isHeartbeat);
   };
   onClientStateRequest = async (_callback) => {
   };
@@ -794,8 +777,8 @@ var setupKeyExchangeHandlers = () => {
   });
   import_electron2.ipcMain.handle(
     MESSAGES.broadcastClientState,
-    async (_event, id, state) => {
-      return transport.broadcastClientState(id, state);
+    async (_event, id, state, name, isHeartbeat) => {
+      return transport.broadcastClientState(id, state, name, isHeartbeat);
     }
   );
 };

package/dist/electron-main.mjs

@@ -34,16 +34,9 @@ function useNetworkPresence(onUpdate, onRequest) {
   const swarm = new Hyperswarm();
   swarm.on("connection", (connection) => {
     const name = b4a.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 ${b4a.toString(
-          connection.remotePublicKey,
-          "hex"
-        )}`
-      );
       connections.splice(connections.indexOf(connection), 1);
       const id = deviceIDs.get(b4a.toString(connection.remotePublicKey, "hex"));
       if (id) {
@@ -56,17 +49,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(
           b4a.toString(connection.remotePublicKey, "hex"),
           payload.id
@@ -86,46 +80,35 @@ function useNetworkPresence(onUpdate, onRequest) {
   });
   const connections = [];
   const connect = async (topic, id) => {
-    console.log("Presence: connecting to topic: ", topic);
     const key = b4a.from(topic, "hex");
-    console.log("key: ", key);
     const discovery = swarm.join(key, { client: true, server: true });
-    console.log("got discovery:  ");
     const publicKey = b4a.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:", b4a.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);
@@ -476,7 +459,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",
@@ -649,8 +632,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);
   }
 };
 
@@ -703,9 +686,9 @@ var KeyTransportMain = class {
   connectPresence = async (topic) => {
     return this.core.connectPresence(topic);
   };
-  broadcastClientState = async (id, state) => {
+  broadcastClientState = async (id, state, name, isHeartbeat) => {
     this.peers.set(id, state);
-    this.core.broadcastClientState(id, state);
+    this.core.broadcastClientState(id, state, name, isHeartbeat);
   };
   onClientStateRequest = async (_callback) => {
   };
@@ -757,8 +740,8 @@ var setupKeyExchangeHandlers = () => {
   });
   ipcMain.handle(
     MESSAGES.broadcastClientState,
-    async (_event, id, state) => {
-      return transport.broadcastClientState(id, state);
+    async (_event, id, state, name, isHeartbeat) => {
+      return transport.broadcastClientState(id, state, name, isHeartbeat);
     }
   );
 };

package/dist/electron-preload.js

@@ -97,7 +97,7 @@ var setupKeyExchangePreloadAPI = () => {
     getDeviceInfo: () => import_electron.ipcRenderer.invoke(MESSAGES.getDeviceInfo),
     getHostname: () => import_electron.ipcRenderer.invoke(MESSAGES.getHostname),
     connectPresence: (topic) => import_electron.ipcRenderer.invoke(MESSAGES.connectPresence, topic),
-    broadcastClientState: (id, state) => import_electron.ipcRenderer.invoke(MESSAGES.broadcastClientState, id, state),
+    broadcastClientState: (id, state, name, isHeartbeat) => import_electron.ipcRenderer.invoke(MESSAGES.broadcastClientState, id, state, name, isHeartbeat),
     onClientStateRequest: (callback) => import_electron.ipcRenderer.on(
       MESSAGES.onClientStateRequest,
       (_event) => callback()

package/dist/electron-preload.mjs

@@ -71,7 +71,7 @@ var setupKeyExchangePreloadAPI = () => {
     getDeviceInfo: () => ipcRenderer.invoke(MESSAGES.getDeviceInfo),
     getHostname: () => ipcRenderer.invoke(MESSAGES.getHostname),
     connectPresence: (topic) => ipcRenderer.invoke(MESSAGES.connectPresence, topic),
-    broadcastClientState: (id, state) => ipcRenderer.invoke(MESSAGES.broadcastClientState, id, state),
+    broadcastClientState: (id, state, name, isHeartbeat) => ipcRenderer.invoke(MESSAGES.broadcastClientState, id, state, name, isHeartbeat),
     onClientStateRequest: (callback) => ipcRenderer.on(
       MESSAGES.onClientStateRequest,
       (_event) => callback()

package/dist/electron-renderer.d.mts

@@ -25,7 +25,7 @@ interface KeyExchangeElectronAPI {
     getDeviceInfo: () => Promise<Record<string, any>>;
     getHostname: () => Promise<string>;
     connectPresence: (topic: string) => Promise<void>;
-    broadcastClientState: (id: string, state: ClientConnectionState) => Promise<void>;
+    broadcastClientState: (id: string, state: ClientConnectionState, name?: string, isHeartbeat?: boolean) => Promise<void>;
     onClientStateRequest: (callback: () => void) => Promise<() => void>;
     onClientStateUpdate: (callback: (response: {
         id: string;
@@ -61,7 +61,7 @@ declare class KeyTransportRenderer implements KeyTransportAdapter {
     getDeviceInfo: () => Promise<Record<string, any>>;
     getHostname: () => Promise<string>;
     connectPresence: (topic: string) => Promise<void>;
-    broadcastClientState: (id: string, state: ClientConnectionState) => Promise<void>;
+    broadcastClientState: (id: string, state: ClientConnectionState, name?: string, isHeartbeat?: boolean) => Promise<void>;
     onClientStateRequest: (callback: () => void) => Promise<() => void>;
     onClientStateUpdate: (callback: (response: {
         id: string;

package/dist/electron-renderer.d.ts

@@ -25,7 +25,7 @@ interface KeyExchangeElectronAPI {
     getDeviceInfo: () => Promise<Record<string, any>>;
     getHostname: () => Promise<string>;
     connectPresence: (topic: string) => Promise<void>;
-    broadcastClientState: (id: string, state: ClientConnectionState) => Promise<void>;
+    broadcastClientState: (id: string, state: ClientConnectionState, name?: string, isHeartbeat?: boolean) => Promise<void>;
     onClientStateRequest: (callback: () => void) => Promise<() => void>;
     onClientStateUpdate: (callback: (response: {
         id: string;
@@ -61,7 +61,7 @@ declare class KeyTransportRenderer implements KeyTransportAdapter {
     getDeviceInfo: () => Promise<Record<string, any>>;
     getHostname: () => Promise<string>;
     connectPresence: (topic: string) => Promise<void>;
-    broadcastClientState: (id: string, state: ClientConnectionState) => Promise<void>;
+    broadcastClientState: (id: string, state: ClientConnectionState, name?: string, isHeartbeat?: boolean) => Promise<void>;
     onClientStateRequest: (callback: () => void) => Promise<() => void>;
     onClientStateUpdate: (callback: (response: {
         id: string;

package/dist/electron-renderer.js

@@ -81,8 +81,8 @@ var KeyTransportRenderer = class {
   connectPresence = async (topic) => {
     return window.keyExchangeElectronAPI.connectPresence(topic);
   };
-  broadcastClientState = async (id, state) => {
-    return window.keyExchangeElectronAPI.broadcastClientState(id, state);
+  broadcastClientState = async (id, state, name, isHeartbeat) => {
+    return window.keyExchangeElectronAPI.broadcastClientState(id, state, name, isHeartbeat);
   };
   onClientStateRequest = async (callback) => {
     return window.keyExchangeElectronAPI.onClientStateRequest(callback);

package/dist/electron-renderer.mjs

@@ -54,8 +54,8 @@ var KeyTransportRenderer = class {
   connectPresence = async (topic) => {
     return window.keyExchangeElectronAPI.connectPresence(topic);
   };
-  broadcastClientState = async (id, state) => {
-    return window.keyExchangeElectronAPI.broadcastClientState(id, state);
+  broadcastClientState = async (id, state, name, isHeartbeat) => {
+    return window.keyExchangeElectronAPI.broadcastClientState(id, state, name, isHeartbeat);
   };
   onClientStateRequest = async (callback) => {
     return window.keyExchangeElectronAPI.onClientStateRequest(callback);

package/dist/index.d.mts

@@ -40,7 +40,7 @@ declare class KeyTransportClient implements KeyTransportAdapter {
     getDeviceInfo: () => Promise<Record<string, any>>;
     getHostname: () => Promise<string>;
     connectPresence: (topic: string) => Promise<void>;
-    broadcastClientState: (id: string, state: ClientConnectionState) => Promise<void>;
+    broadcastClientState: (id: string, state: ClientConnectionState, name?: string, isHeartbeat?: boolean) => Promise<void>;
     onClientStateRequest: (callback: () => void) => Promise<() => void>;
     onClientStateUpdate: (callback: (response: {
         id: string;
@@ -62,4 +62,48 @@ declare class KeyTransportClient implements KeyTransportAdapter {
     isConnected: () => boolean;
 }
 
-export { KeyTransportClient };
+/**
+ * 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, KeyTransportClient, type LinkedDevice };

package/dist/index.d.ts

@@ -40,7 +40,7 @@ declare class KeyTransportClient implements KeyTransportAdapter {
     getDeviceInfo: () => Promise<Record<string, any>>;
     getHostname: () => Promise<string>;
     connectPresence: (topic: string) => Promise<void>;
-    broadcastClientState: (id: string, state: ClientConnectionState) => Promise<void>;
+    broadcastClientState: (id: string, state: ClientConnectionState, name?: string, isHeartbeat?: boolean) => Promise<void>;
     onClientStateRequest: (callback: () => void) => Promise<() => void>;
     onClientStateUpdate: (callback: (response: {
         id: string;
@@ -62,4 +62,48 @@ declare class KeyTransportClient implements KeyTransportAdapter {
     isConnected: () => boolean;
 }
 
-export { KeyTransportClient };
+/**
+ * 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, KeyTransportClient, type LinkedDevice };

package/dist/index.js

@@ -195,6 +195,7 @@ var require_eventemitter3 = __commonJS({
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  DevicePairingManager: () => DevicePairingManager,
   KeyTransportClient: () => KeyTransportClient
 });
 module.exports = __toCommonJS(index_exports);
@@ -508,11 +509,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;
@@ -580,7 +581,99 @@ 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);
+  };
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  DevicePairingManager,
   KeyTransportClient
 });