@cryptforge/key-exchange 0.1.0

package/README.md

@@ -0,0 +1,108 @@
+# @cryptforge/key-exchange
+
+Key exchange package for CryptForge SDK. Provides secure key exchange functionality across different environments: browser, Node.js server, and Electron.
+
+## Installation
+
+```bash
+npm install @cryptforge/key-exchange
+```
+
+## Usage
+
+This package provides **separate entry points** for different environments to ensure safe usage without mixing incompatible APIs.
+
+### Browser/Web Client
+
+```typescript
+import { KeyTransportClient } from "@cryptforge/key-exchange";
+
+const client = new KeyTransportClient("ws://localhost:3001");
+const broadcastId = await client.enableBroadcast();
+```
+
+### Node.js Server
+
+```typescript
+import { KeyExchangeServer } from "@cryptforge/key-exchange/server";
+
+const server = new KeyExchangeServer();
+await server.start();
+```
+
+### Electron
+
+Electron has three separate contexts that must not be mixed:
+
+#### Main Process (Node.js environment)
+
+```typescript
+// In your main.js or main.ts
+import {} from /* your exports */ "@cryptforge/key-exchange/electron-main";
+
+// Main process code with access to Node.js and Electron APIs
+```
+
+#### Preload Script (Isolated context)
+
+```typescript
+// In your preload.js or preload.ts
+import {} from /* your exports */ "@cryptforge/key-exchange/electron-preload";
+
+// Preload script that bridges main and renderer processes
+// Use contextBridge to safely expose APIs to renderer
+```
+
+#### Renderer Process (Browser-like environment)
+
+```typescript
+// In your renderer/app code
+import {} from /* your exports */ "@cryptforge/key-exchange/electron-renderer";
+
+// Renderer process code - browser-like environment
+```
+
+## Architecture
+
+### Why Separate Entry Points?
+
+Each environment has different capabilities and restrictions:
+
+- **Browser (`/`)**: No Node.js APIs, WebSocket only
+- **Server (`/server`)**: Full Node.js APIs, can use hyperswarm
+- **Electron Main (`/electron-main`)**: Node.js + Electron main process APIs
+- **Electron Preload (`/electron-preload`)**: Limited Node.js APIs in isolated context
+- **Electron Renderer (`/electron-renderer`)**: Browser-like with IPC to main process
+
+Mixing these would cause runtime errors or security issues.
+
+## Project Structure
+
+```
+src/
+├── index.ts              # Browser/web client entry point
+├── server.ts             # Node.js server entry point
+├── electron-main.ts      # Electron main process entry point
+├── electron-preload.ts   # Electron preload script entry point
+├── electron-renderer.ts  # Electron renderer process entry point
+├── client/               # Browser client implementation
+├── server/               # Server implementation
+├── electron/
+│   ├── main/            # Electron main process code
+│   ├── preload/         # Electron preload script code
+│   └── renderer/        # Electron renderer process code
+└── types/               # Shared TypeScript types
+```
+
+## Features
+
+- Secure key exchange protocol
+- Browser and Node.js support
+- Full Electron support (main, preload, renderer)
+- TypeScript support with full type definitions
+- WebSocket-based communication for web/browser
+- Hyperswarm support for server-to-server
+
+## License
+
+ISC

package/dist/electron-main.d.mts

@@ -0,0 +1,41 @@
+import { OnSetupEventCallback, StoredIdentity, ClientConnectionState } from '@cryptforge/core';
+
+declare const setupKeyExchangeHandlers: () => void;
+
+interface DeviceInfo {
+    id: string;
+    name: string;
+}
+
+/**
+ * Core transport logic that can be shared across different transport implementations.
+ * This class contains all the business logic without any transport-specific code.
+ */
+declare class CoreTransportLogic {
+    private syncServer;
+    private syncClient;
+    private presence;
+    private deviceInfo?;
+    private handleEvent;
+    private presenceConnected;
+    constructor(handleEvent?: OnSetupEventCallback);
+    private initializeDeviceInfo;
+    private onStateUpdate;
+    private onStateRequest;
+    private delay;
+    enableBroadcast(): Promise<string>;
+    connect(topic: string, name: string, app: string): Promise<void>;
+    requestKeystore(pin: string): Promise<void>;
+    approveRequest(data: {
+        identity: StoredIdentity;
+        appId: number;
+    }): Promise<void>;
+    denyRequest(): Promise<void>;
+    disableBroadcast(): Promise<void>;
+    getDeviceInfo(): Promise<DeviceInfo>;
+    getHostname(): Promise<string>;
+    connectPresence(topic: string): Promise<void>;
+    broadcastClientState(id: string, state: ClientConnectionState): void;
+}
+
+export { CoreTransportLogic, setupKeyExchangeHandlers };

package/dist/electron-main.d.ts

@@ -0,0 +1,41 @@
+import { OnSetupEventCallback, StoredIdentity, ClientConnectionState } from '@cryptforge/core';
+
+declare const setupKeyExchangeHandlers: () => void;
+
+interface DeviceInfo {
+    id: string;
+    name: string;
+}
+
+/**
+ * Core transport logic that can be shared across different transport implementations.
+ * This class contains all the business logic without any transport-specific code.
+ */
+declare class CoreTransportLogic {
+    private syncServer;
+    private syncClient;
+    private presence;
+    private deviceInfo?;
+    private handleEvent;
+    private presenceConnected;
+    constructor(handleEvent?: OnSetupEventCallback);
+    private initializeDeviceInfo;
+    private onStateUpdate;
+    private onStateRequest;
+    private delay;
+    enableBroadcast(): Promise<string>;
+    connect(topic: string, name: string, app: string): Promise<void>;
+    requestKeystore(pin: string): Promise<void>;
+    approveRequest(data: {
+        identity: StoredIdentity;
+        appId: number;
+    }): Promise<void>;
+    denyRequest(): Promise<void>;
+    disableBroadcast(): Promise<void>;
+    getDeviceInfo(): Promise<DeviceInfo>;
+    getHostname(): Promise<string>;
+    connectPresence(topic: string): Promise<void>;
+    broadcastClientState(id: string, state: ClientConnectionState): void;
+}
+
+export { CoreTransportLogic, setupKeyExchangeHandlers };