dandelion-mesh 1.0.0

package/build/main/mesh/DandelionMesh.js

@@ -0,0 +1,368 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DandelionMesh = void 0;
+const CryptoService_1 = require("../crypto/CryptoService");
+const RaftNode_1 = require("../raft/RaftNode");
+const InMemoryRaftLog_1 = require("../raft/log/InMemoryRaftLog");
+/**
+ * DandelionMesh — a fault-tolerant P2P mesh network for browser applications.
+ *
+ * Combines three layers:
+ * - **Transport** (default: PeerJS) — handles peer-to-peer WebRTC connections.
+ * - **Crypto** — RSA-OAEP + AES-256-GCM hybrid encryption for private messages.
+ * - **Raft consensus** — leader election and totally-ordered log replication.
+ *
+ * All application messages (public broadcasts and encrypted private messages)
+ * flow through the Raft log, guaranteeing every peer sees the same events in
+ * the same order. Non-leader peers forward proposals to the current leader.
+ *
+ * ## Events
+ *
+ * | Event            | Payload                              | When                                       |
+ * |------------------|--------------------------------------|---------------------------------------------|
+ * | `ready`          | `localPeerId: string`                | Transport is open and Raft has started       |
+ * | `message`        | `MeshMessage<T>, replay: boolean`    | A committed log entry is delivered           |
+ * | `peersChanged`   | `peers: string[]`                    | A peer connects or disconnects               |
+ * | `leaderChanged`  | `leaderId: string \| null`           | Raft leader changes                          |
+ * | `error`          | `Error`                              | Transport-level error                        |
+ *
+ * @typeParam T - The application-level payload type for messages.
+ *
+ * @example
+ * ```ts
+ * const transport = new PeerJSTransport({ peerId: 'alice' });
+ * const mesh = new DandelionMesh<GameAction>(transport, {
+ *   bootstrapPeers: ['bob', 'charlie'],
+ * });
+ *
+ * mesh.on('ready', (id) => console.log('My ID:', id));
+ * mesh.on('message', (msg) => {
+ *   if (msg.type === 'public')  console.log(msg.sender, msg.data);
+ *   if (msg.type === 'private') console.log('secret from', msg.sender);
+ * });
+ *
+ * await mesh.sendPublic({ action: 'bet', amount: 100 });
+ * await mesh.sendPrivate('bob', { cards: ['Ah', 'Kd'] });
+ * ```
+ *
+ * @example Providing a pre-generated crypto key bundle
+ * ```ts
+ * const bundle = await generateKeyBundle(2048);
+ * const mesh = new DandelionMesh(transport, { cryptoKeyBundle: bundle });
+ * ```
+ */
+class DandelionMesh {
+    constructor(transport, options) {
+        var _a, _b, _c, _d;
+        this.raftNode = null;
+        this.cryptoBundle = null;
+        this.peerPublicKeys = new Map();
+        this.pendingKeyWaiters = new Map();
+        this.lastAppliedIndex = 0;
+        this.listeners = {
+            ready: new Set(),
+            message: new Set(),
+            peersChanged: new Set(),
+            leaderChanged: new Set(),
+            error: new Set(),
+        };
+        // --- Transport event handlers ---
+        this.onTransportOpen = (peerId) => {
+            this.localPeerId = peerId;
+            // Connect to bootstrap peers
+            for (const bp of this.bootstrapPeers) {
+                if (bp !== peerId) {
+                    this.transport.connect(bp);
+                }
+            }
+            // Initialize Raft node
+            this.raftNode = new RaftNode_1.RaftNode(peerId, this.raftLog, this.raftOptions);
+            this.raftNode.sendMessage = (toPeerId, message) => {
+                this.transport
+                    .send(toPeerId, this.wireMessage('raft', message))
+                    .catch(() => {
+                    // Peer may have disconnected; non-fatal
+                });
+            };
+            this.raftNode.on('committed', this.onRaftCommitted);
+            this.raftNode.on('leaderChanged', (leaderId) => {
+                this.emit('leaderChanged', leaderId);
+            });
+            // Start Raft with currently connected peers
+            this.raftNode.start(this.transport.connectedPeers);
+            this.emit('ready', peerId);
+            // Propose our public key through Raft so all peers (including
+            // those joining later) receive it via log replay.
+            this.proposePublicKey();
+        };
+        this.onPeerConnected = (_remotePeerId) => {
+            var _a;
+            // Update Raft cluster membership
+            (_a = this.raftNode) === null || _a === void 0 ? void 0 : _a.updatePeers(this.transport.connectedPeers);
+            this.emit('peersChanged', this.peers);
+        };
+        this.onPeerDisconnected = (_remotePeerId) => {
+            var _a;
+            (_a = this.raftNode) === null || _a === void 0 ? void 0 : _a.updatePeers(this.transport.connectedPeers);
+            this.emit('peersChanged', this.peers);
+        };
+        this.onTransportMessage = (fromPeerId, data) => {
+            var _a;
+            const wire = data;
+            if (!wire || !wire.channel)
+                return;
+            if (wire.channel === 'raft') {
+                (_a = this.raftNode) === null || _a === void 0 ? void 0 : _a.handleMessage(fromPeerId, wire.payload);
+            }
+            else if (wire.channel === 'control') {
+                this.handleControlMessage(wire.payload);
+            }
+        };
+        this.onTransportError = (error) => {
+            this.emit('error', error);
+        };
+        // --- Raft commit handler ---
+        this.onRaftCommitted = (entry, index) => {
+            const isReplay = index <= this.lastAppliedIndex;
+            const cmd = entry.command;
+            switch (cmd._meshType) {
+                case 'public':
+                    this.emit('message', {
+                        type: 'public',
+                        sender: cmd.sender,
+                        data: cmd.data,
+                    }, isReplay);
+                    break;
+                case 'encrypted':
+                    this.handleEncryptedCommit(cmd, isReplay);
+                    break;
+                case 'publicKey': {
+                    if (!this.peerPublicKeys.has(cmd.peerId)) {
+                        const keyPromise = (0, CryptoService_1.importPublicKey)(cmd.jwk);
+                        this.peerPublicKeys.set(cmd.peerId, keyPromise);
+                        // Notify any pending sendPrivate calls waiting for this key
+                        const waiters = this.pendingKeyWaiters.get(cmd.peerId);
+                        if (waiters) {
+                            for (const resolve of waiters) {
+                                resolve(keyPromise);
+                            }
+                            this.pendingKeyWaiters.delete(cmd.peerId);
+                        }
+                    }
+                    break;
+                }
+            }
+            if (!isReplay) {
+                this.lastAppliedIndex = index;
+            }
+        };
+        this.transport = transport;
+        this.modulusLength = (_a = options === null || options === void 0 ? void 0 : options.modulusLength) !== null && _a !== void 0 ? _a : 4096;
+        this.raftOptions = (_b = options === null || options === void 0 ? void 0 : options.raft) !== null && _b !== void 0 ? _b : {};
+        this.raftLog =
+            (_c = options === null || options === void 0 ? void 0 : options.raftLog) !== null && _c !== void 0 ? _c : new InMemoryRaftLog_1.InMemoryRaftLog();
+        this.bootstrapPeers = (_d = options === null || options === void 0 ? void 0 : options.bootstrapPeers) !== null && _d !== void 0 ? _d : [];
+        this.lastAppliedIndex = this.raftLog.length();
+        // Use provided key bundle or generate a new one
+        this.cryptoReady = ((options === null || options === void 0 ? void 0 : options.cryptoKeyBundle)
+            ? Promise.resolve(options.cryptoKeyBundle)
+            : (0, CryptoService_1.generateKeyBundle)(this.modulusLength)).then((bundle) => {
+            this.cryptoBundle = bundle;
+            return bundle;
+        });
+        // Wire up transport events
+        this.transport.on('open', this.onTransportOpen);
+        this.transport.on('peerConnected', this.onPeerConnected);
+        this.transport.on('peerDisconnected', this.onPeerDisconnected);
+        this.transport.on('message', this.onTransportMessage);
+        this.transport.on('error', this.onTransportError);
+    }
+    // --- Public API ---
+    /** Send a public (broadcast) message through the Raft cluster */
+    async sendPublic(data) {
+        if (!this.raftNode || !this.localPeerId)
+            return false;
+        const entry = {
+            _meshType: 'public',
+            sender: this.localPeerId,
+            data,
+        };
+        if (this.raftNode.isLeader()) {
+            return this.raftNode.propose(entry);
+        }
+        // Forward to leader
+        const leaderId = this.raftNode.getLeaderId();
+        if (!leaderId)
+            return false;
+        const propose = { _meshType: 'propose', command: entry };
+        await this.transport.send(leaderId, this.wireMessage('control', propose));
+        return true;
+    }
+    /** Send an encrypted private message through the Raft cluster */
+    async sendPrivate(recipientPeerId, data) {
+        if (!this.raftNode || !this.localPeerId)
+            return false;
+        const recipientKey = await this.getOrAwaitPublicKey(recipientPeerId);
+        const plaintext = new TextEncoder().encode(JSON.stringify(data));
+        const payload = await (0, CryptoService_1.encrypt)(plaintext, recipientKey);
+        const entry = {
+            _meshType: 'encrypted',
+            sender: this.localPeerId,
+            recipient: recipientPeerId,
+            payload,
+        };
+        if (this.raftNode.isLeader()) {
+            return this.raftNode.propose(entry);
+        }
+        // Forward to leader
+        const leaderId = this.raftNode.getLeaderId();
+        if (!leaderId)
+            return false;
+        const propose = { _meshType: 'propose', command: entry };
+        await this.transport.send(leaderId, this.wireMessage('control', propose));
+        return true;
+    }
+    /** Get all connected peer IDs (including self) */
+    get peers() {
+        const connected = [...this.transport.connectedPeers];
+        if (this.localPeerId)
+            connected.unshift(this.localPeerId);
+        return connected;
+    }
+    /** Get the current Raft leader ID */
+    get leaderId() {
+        var _a, _b;
+        return (_b = (_a = this.raftNode) === null || _a === void 0 ? void 0 : _a.getLeaderId()) !== null && _b !== void 0 ? _b : null;
+    }
+    /** Whether this node is the Raft leader */
+    get isLeader() {
+        var _a, _b;
+        return (_b = (_a = this.raftNode) === null || _a === void 0 ? void 0 : _a.isLeader()) !== null && _b !== void 0 ? _b : false;
+    }
+    /** The local peer ID (available after 'ready') */
+    get peerId() {
+        return this.localPeerId;
+    }
+    /** Register an event listener */
+    on(event, listener) {
+        this.listeners[event].add(listener);
+    }
+    /** Remove an event listener */
+    off(event, listener) {
+        this.listeners[event].delete(listener);
+    }
+    /** Shut down the mesh: stop Raft, close transport */
+    close() {
+        var _a;
+        (_a = this.raftNode) === null || _a === void 0 ? void 0 : _a.destroy();
+        this.transport.off('open', this.onTransportOpen);
+        this.transport.off('peerConnected', this.onPeerConnected);
+        this.transport.off('peerDisconnected', this.onPeerDisconnected);
+        this.transport.off('message', this.onTransportMessage);
+        this.transport.off('error', this.onTransportError);
+        this.transport.close();
+    }
+    // --- Control message handling ---
+    handleControlMessage(msg) {
+        var _a;
+        switch (msg._meshType) {
+            case 'propose': {
+                // A non-leader peer is forwarding a command to us (the leader)
+                if ((_a = this.raftNode) === null || _a === void 0 ? void 0 : _a.isLeader()) {
+                    this.raftNode.propose(msg.command);
+                }
+                break;
+            }
+        }
+    }
+    async handleEncryptedCommit(cmd, isReplay) {
+        if (!this.localPeerId)
+            return;
+        // Only the intended recipient decrypts
+        if (cmd.recipient !== this.localPeerId)
+            return;
+        if (!this.cryptoBundle) {
+            await this.cryptoReady;
+        }
+        try {
+            const plaintext = await (0, CryptoService_1.decrypt)(cmd.payload, this.cryptoBundle.privateKey);
+            const data = JSON.parse(new TextDecoder().decode(plaintext));
+            this.emit('message', {
+                type: 'private',
+                sender: cmd.sender,
+                recipient: cmd.recipient,
+                data,
+            }, isReplay);
+        }
+        catch (err) {
+            // Not for us or decryption failed — this is expected for other recipients
+        }
+    }
+    // --- Key management ---
+    async proposePublicKey() {
+        if (!this.cryptoBundle) {
+            await this.cryptoReady;
+        }
+        if (!this.localPeerId || !this.cryptoBundle || !this.raftNode)
+            return;
+        // Wait until a leader is available
+        if (!this.raftNode.isLeader() && !this.raftNode.getLeaderId()) {
+            await new Promise((resolve) => {
+                const onLeader = (leaderId) => {
+                    if (leaderId) {
+                        this.off('leaderChanged', onLeader);
+                        resolve();
+                    }
+                };
+                this.on('leaderChanged', onLeader);
+            });
+        }
+        if (!this.raftNode)
+            return;
+        const announcement = {
+            _meshType: 'publicKey',
+            peerId: this.localPeerId,
+            jwk: this.cryptoBundle.publicKeyJwk,
+        };
+        if (this.raftNode.isLeader()) {
+            this.raftNode.propose(announcement);
+        }
+        else {
+            const leaderId = this.raftNode.getLeaderId();
+            if (!leaderId)
+                return;
+            const propose = {
+                _meshType: 'propose',
+                command: announcement,
+            };
+            this.transport
+                .send(leaderId, this.wireMessage('control', propose))
+                .catch(() => { });
+        }
+    }
+    async getOrAwaitPublicKey(peerId) {
+        const existing = this.peerPublicKeys.get(peerId);
+        if (existing)
+            return existing;
+        // Wait for the key to arrive via Raft commit
+        return new Promise((resolve) => {
+            let waiters = this.pendingKeyWaiters.get(peerId);
+            if (!waiters) {
+                waiters = [];
+                this.pendingKeyWaiters.set(peerId, waiters);
+            }
+            waiters.push((keyPromise) => resolve(keyPromise));
+        });
+    }
+    // --- Helpers ---
+    wireMessage(channel, payload) {
+        return { channel, payload };
+    }
+    emit(event, ...args) {
+        for (const listener of this.listeners[event]) {
+            listener(...args);
+        }
+    }
+}
+exports.DandelionMesh = DandelionMesh;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiRGFuZGVsaW9uTWVzaC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9tZXNoL0RhbmRlbGlvbk1lc2gudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7O0FBQUEsMkRBTWlDO0FBQ2pDLCtDQUE2RDtBQUM3RCxpRUFBOEQ7QUF1QzlEOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0dBOENHO0FBQ0gsTUFBYSxhQUFhO0lBMkJ4QixZQUFZLFNBQW9CLEVBQUUsT0FBOEI7O1FBeEJ4RCxhQUFRLEdBQXVDLElBQUksQ0FBQztRQUlwRCxpQkFBWSxHQUEyQixJQUFJLENBQUM7UUFDbkMsbUJBQWMsR0FBRyxJQUFJLEdBQUcsRUFBOEIsQ0FBQztRQUN2RCxzQkFBaUIsR0FBRyxJQUFJLEdBQUcsRUFHekMsQ0FBQztRQUtJLHFCQUFnQixHQUFHLENBQUMsQ0FBQztRQUVaLGNBQVMsR0FBbUI7WUFDM0MsS0FBSyxFQUFFLElBQUksR0FBRyxFQUFFO1lBQ2hCLE9BQU8sRUFBRSxJQUFJLEdBQUcsRUFBRTtZQUNsQixZQUFZLEVBQUUsSUFBSSxHQUFHLEVBQUU7WUFDdkIsYUFBYSxFQUFFLElBQUksR0FBRyxFQUFFO1lBQ3hCLEtBQUssRUFBRSxJQUFJLEdBQUcsRUFBRTtTQUNqQixDQUFDO1FBb0lGLG1DQUFtQztRQUUzQixvQkFBZSxHQUFHLENBQUMsTUFBYyxFQUFRLEVBQUU7WUFDakQsSUFBSSxDQUFDLFdBQVcsR0FBRyxNQUFNLENBQUM7WUFFMUIsNkJBQTZCO1lBQzdCLEtBQUssTUFBTSxFQUFFLElBQUksSUFBSSxDQUFDLGNBQWMsRUFBRTtnQkFDcEMsSUFBSSxFQUFFLEtBQUssTUFBTSxFQUFFO29CQUNqQixJQUFJLENBQUMsU0FBUyxDQUFDLE9BQU8sQ0FBQyxFQUFFLENBQUMsQ0FBQztpQkFDNUI7YUFDRjtZQUVELHVCQUF1QjtZQUN2QixJQUFJLENBQUMsUUFBUSxHQUFHLElBQUksbUJB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

package/build/main/mesh/types.d.ts

@@ -0,0 +1,58 @@
+import { EncryptedPayload } from '../crypto/CryptoService';
+export interface PublicMessage<T = unknown> {
+    type: 'public';
+    sender: string;
+    data: T;
+}
+export interface PrivateMessage<T = unknown> {
+    type: 'private';
+    sender: string;
+    recipient: string;
+    data: T;
+}
+export type MeshMessage<T = unknown> = PublicMessage<T> | PrivateMessage<T>;
+/** Broadcast of a peer's RSA public key */
+export interface PublicKeyAnnouncement {
+    _meshType: 'publicKey';
+    peerId: string;
+    jwk: JsonWebKey;
+}
+/** An encrypted private message (the Raft log entry payload for private messages) */
+export interface EncryptedPrivateMessage {
+    _meshType: 'encrypted';
+    sender: string;
+    recipient: string;
+    payload: EncryptedPayload;
+}
+/** A public message log entry */
+export interface PublicMessageEntry<T = unknown> {
+    _meshType: 'public';
+    sender: string;
+    data: T;
+}
+/** Union of all Raft log command types */
+export type MeshLogCommand<T = unknown> = PublicMessageEntry<T> | EncryptedPrivateMessage | PublicKeyAnnouncement;
+/** A proposal forwarded from a non-leader to the leader */
+export interface ProposeMessage<T = unknown> {
+    _meshType: 'propose';
+    command: MeshLogCommand<T>;
+}
+/** Internal transport-level messages (not replicated via Raft) */
+export type MeshControlMessage<T = unknown> = ProposeMessage<T>;
+/** Wrapper to distinguish Raft messages from mesh control messages on the wire */
+export interface WireMessage {
+    channel: 'raft' | 'control';
+    payload: unknown;
+}
+export interface DandelionMeshEvents<T = unknown> {
+    /** Local peer is ready */
+    ready: (localPeerId: string) => void;
+    /** A message was committed and delivered */
+    message: (message: MeshMessage<T>, replay: boolean) => void;
+    /** The set of connected peer IDs changed */
+    peersChanged: (peers: string[]) => void;
+    /** The cluster leader changed */
+    leaderChanged: (leaderId: string | null) => void;
+    /** An error occurred */
+    error: (error: Error) => void;
+}

package/build/main/mesh/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHlwZXMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvbWVzaC90eXBlcy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiIn0=

package/build/main/raft/RaftNode.d.ts

@@ -0,0 +1,87 @@
+import { RaftLog } from './log/RaftLog';
+import { RaftMessage, RaftNodeEvents, RaftRole } from './types';
+export interface RaftNodeOptions {
+    /** Minimum election timeout in ms (default 2000) */
+    electionTimeoutMin?: number;
+    /** Maximum election timeout in ms (default 4000) */
+    electionTimeoutMax?: number;
+    /** Heartbeat interval in ms (default 400) */
+    heartbeatInterval?: number;
+}
+/**
+ * Core Raft consensus node.
+ *
+ * This class implements the Raft algorithm for leader election and log
+ * replication. It is transport-agnostic — the caller must wire up
+ * `sendMessage` to deliver RPCs, and call `handleMessage` when RPCs arrive.
+ *
+ * Log indices are 1-based per the Raft paper.
+ */
+export declare class RaftNode<T = unknown> {
+    readonly id: string;
+    private role;
+    private currentTerm;
+    private votedFor;
+    private leaderId;
+    private commitIndex;
+    private lastApplied;
+    private nextIndex;
+    private matchIndex;
+    private electionTimer;
+    private heartbeatTimer;
+    private readonly electionTimeoutMin;
+    private readonly electionTimeoutMax;
+    private readonly heartbeatInterval;
+    private peers;
+    private votesReceived;
+    private readonly log;
+    /** Called by the node to send an RPC to a peer — must be wired up externally */
+    sendMessage: (toPeerId: string, message: RaftMessage<T>) => void;
+    private readonly eventListeners;
+    private destroyed;
+    constructor(id: string, log: RaftLog<T>, options?: RaftNodeOptions);
+    /** Start the node (begin election timer as follower) */
+    start(peerIds: string[]): void;
+    /** Update the cluster membership dynamically (e.g. when peers join/leave) */
+    updatePeers(peerIds: string[]): void;
+    /** Submit a command to be replicated. Only succeeds on the leader. */
+    propose(command: T): boolean;
+    /** Handle an incoming Raft RPC message from a peer */
+    handleMessage(fromPeerId: string, message: RaftMessage<T>): void;
+    /** Get current role */
+    getRole(): RaftRole;
+    /** Get current term */
+    getCurrentTerm(): number;
+    /** Get the current leader ID (null if unknown) */
+    getLeaderId(): string | null;
+    /** Get the commit index */
+    getCommitIndex(): number;
+    /** Check if this node is the leader */
+    isLeader(): boolean;
+    /** Register an event listener */
+    on<E extends keyof RaftNodeEvents<T>>(event: E, listener: RaftNodeEvents<T>[E]): void;
+    /** Remove an event listener */
+    off<E extends keyof RaftNodeEvents<T>>(event: E, listener: RaftNodeEvents<T>[E]): void;
+    /** Stop all timers and clean up */
+    destroy(): void;
+    private becomeFollower;
+    private becomeCandidate;
+    private becomeLeader;
+    private handleRequestVote;
+    private handleRequestVoteResult;
+    /** Check if a candidate's log is at least as up-to-date as ours */
+    private isLogUpToDate;
+    private handleAppendEntries;
+    private handleAppendEntriesResult;
+    private sendAppendEntriesToAll;
+    private sendAppendEntriesTo;
+    /** Advance commitIndex if a majority of matchIndex values allow it */
+    private advanceCommitIndex;
+    /** Apply all committed but not-yet-applied entries */
+    private applyCommitted;
+    private resetElectionTimer;
+    private clearElectionTimer;
+    private clearHeartbeatTimer;
+    private persistState;
+    private emit;
+}