omniwire 3.0.1 → 3.1.1

package/dist/mesh/omnimesh.d.ts

@@ -0,0 +1,85 @@
+export interface OmniMeshPeer {
+    readonly id: string;
+    readonly publicKey: string;
+    readonly endpoint?: string;
+    readonly meshIp: string;
+    readonly allowedIps: string;
+    readonly latestHandshake?: number;
+    readonly transferRx?: number;
+    readonly transferTx?: number;
+    readonly keepalive?: number;
+    readonly os: 'linux' | 'windows' | 'darwin';
+    readonly tags?: readonly string[];
+    readonly online?: boolean;
+}
+export interface OmniMeshConfig {
+    readonly interfaceName: string;
+    readonly meshSubnet: string;
+    readonly listenPort: number;
+    readonly dns?: readonly string[];
+    readonly mtu?: number;
+    readonly fwmark?: number;
+    readonly preUp?: string;
+    readonly postUp?: string;
+    readonly preDown?: string;
+    readonly postDown?: string;
+}
+export interface OmniMeshStatus {
+    readonly interfaceName: string;
+    readonly publicKey: string;
+    readonly listenPort: number;
+    readonly peers: readonly OmniMeshPeer[];
+    readonly meshIp: string;
+    readonly uptime: string;
+}
+export interface KeyPair {
+    readonly privateKey: string;
+    readonly publicKey: string;
+    readonly presharedKey?: string;
+}
+export declare function detectOS(): 'linux' | 'windows' | 'darwin';
+/** Generate WireGuard key pair commands per OS */
+export declare function genKeysCmd(os: 'linux' | 'windows' | 'darwin'): string;
+/** Parse key generation output */
+export declare function parseKeys(stdout: string): KeyPair;
+/** Build WireGuard config file content */
+export declare function buildWgConfig(localPeer: {
+    privateKey: string;
+    meshIp: string;
+    listenPort: number;
+}, peers: readonly OmniMeshPeer[], config?: Partial<OmniMeshConfig>, presharedKeys?: Record<string, string>): string;
+/** Get WireGuard config path per OS */
+export declare function wgConfigPath(os: 'linux' | 'windows' | 'darwin', iface: string): string;
+/** Build command to bring interface up */
+export declare function bringUpCmd(os: 'linux' | 'windows' | 'darwin', iface: string): string;
+/** Build command to bring interface down */
+export declare function bringDownCmd(os: 'linux' | 'windows' | 'darwin', iface: string): string;
+/** Build command to get WireGuard status */
+export declare function statusCmd(os: 'linux' | 'windows' | 'darwin', iface: string): string;
+/** Parse `wg show` output into structured peers */
+export declare function parseWgShow(stdout: string): OmniMeshStatus;
+/** Build command to add a peer dynamically (no restart) */
+export declare function addPeerCmd(iface: string, peer: OmniMeshPeer, psk?: string): string;
+/** Build command to remove a peer dynamically */
+export declare function removePeerCmd(iface: string, publicKey: string): string;
+/** Build command to install WireGuard per OS */
+export declare function installCmd(os: 'linux' | 'windows' | 'darwin'): string;
+/** Build command to check if WireGuard is installed */
+export declare function checkInstalledCmd(os: 'linux' | 'windows' | 'darwin'): string;
+/** Build NAT traversal PostUp rules (iptables/nftables) */
+export declare function natTraversalPostUp(iface: string, publicIface?: string): string;
+/** Build NAT traversal PostDown rules */
+export declare function natTraversalPostDown(iface: string, publicIface?: string): string;
+/** Build command to rotate keys for a peer */
+export declare function rotateKeyCmd(iface: string, os: 'linux' | 'windows' | 'darwin'): string;
+/** Build monitoring/health check command */
+export declare function healthCheckCmd(iface: string, peers: readonly string[]): string;
+/** Build STUN/endpoint discovery command for NAT'd peers */
+export declare function stunDiscoverCmd(): string;
+/** Generate a mesh topology config for N peers (hub-and-spoke or full-mesh) */
+export declare function generateMeshTopology(peers: readonly {
+    id: string;
+    meshIp: string;
+    publicKey: string;
+    endpoint?: string;
+}[], topology?: 'full-mesh' | 'hub-spoke', hubId?: string): Map<string, OmniMeshPeer[]>;

package/dist/mesh/omnimesh.js

@@ -0,0 +1,307 @@
+// OmniMesh — Cross-platform WireGuard mesh network for OmniWire
+// Manages peer discovery, key rotation, NAT traversal, and mesh topology
+// Supports: Linux (wg-quick/networkd), Windows (wireguard.exe), macOS (wg-quick/brew)
+// --- Cross-platform command builders ---
+export function detectOS() {
+    const p = process.platform;
+    if (p === 'win32')
+        return 'windows';
+    if (p === 'darwin')
+        return 'darwin';
+    return 'linux';
+}
+/** Generate WireGuard key pair commands per OS */
+export function genKeysCmd(os) {
+    if (os === 'windows') {
+        // wireguard.exe uses wg.exe for keygen on Windows
+        return [
+            'cd %TEMP%',
+            'wg genkey > omnimesh_priv.key',
+            'type omnimesh_priv.key | wg pubkey > omnimesh_pub.key',
+            'wg genpsk > omnimesh_psk.key',
+            'echo PRIV: & type omnimesh_priv.key',
+            'echo PUB: & type omnimesh_pub.key',
+            'echo PSK: & type omnimesh_psk.key',
+        ].join(' && ');
+    }
+    // Linux/macOS
+    return [
+        'priv=$(wg genkey)',
+        'pub=$(echo "$priv" | wg pubkey)',
+        'psk=$(wg genpsk)',
+        'echo "PRIV:$priv"',
+        'echo "PUB:$pub"',
+        'echo "PSK:$psk"',
+    ].join('; ');
+}
+/** Parse key generation output */
+export function parseKeys(stdout) {
+    const lines = stdout.split('\n').map((l) => l.trim()).filter(Boolean);
+    let privateKey = '', publicKey = '', presharedKey = '';
+    for (const line of lines) {
+        if (line.startsWith('PRIV:'))
+            privateKey = line.slice(5).trim();
+        else if (line.startsWith('PUB:'))
+            publicKey = line.slice(4).trim();
+        else if (line.startsWith('PSK:'))
+            presharedKey = line.slice(4).trim();
+    }
+    return { privateKey, publicKey, presharedKey: presharedKey || undefined };
+}
+/** Build WireGuard config file content */
+export function buildWgConfig(localPeer, peers, config = {}, presharedKeys) {
+    const lines = ['[Interface]'];
+    lines.push(`PrivateKey = ${localPeer.privateKey}`);
+    lines.push(`Address = ${localPeer.meshIp}/24`);
+    lines.push(`ListenPort = ${localPeer.listenPort}`);
+    if (config.dns?.length)
+        lines.push(`DNS = ${config.dns.join(', ')}`);
+    if (config.mtu)
+        lines.push(`MTU = ${config.mtu}`);
+    if (config.fwmark)
+        lines.push(`FwMark = ${config.fwmark}`);
+    if (config.postUp)
+        lines.push(`PostUp = ${config.postUp}`);
+    if (config.postDown)
+        lines.push(`PostDown = ${config.postDown}`);
+    if (config.preUp)
+        lines.push(`PreUp = ${config.preUp}`);
+    if (config.preDown)
+        lines.push(`PreDown = ${config.preDown}`);
+    for (const peer of peers) {
+        lines.push('');
+        lines.push('[Peer]');
+        lines.push(`# ${peer.id}`);
+        lines.push(`PublicKey = ${peer.publicKey}`);
+        const psk = presharedKeys?.[peer.id];
+        if (psk)
+            lines.push(`PresharedKey = ${psk}`);
+        lines.push(`AllowedIPs = ${peer.allowedIps}`);
+        if (peer.endpoint)
+            lines.push(`Endpoint = ${peer.endpoint}`);
+        lines.push(`PersistentKeepalive = ${peer.keepalive ?? 25}`);
+    }
+    return lines.join('\n') + '\n';
+}
+/** Get WireGuard config path per OS */
+export function wgConfigPath(os, iface) {
+    switch (os) {
+        case 'linux': return `/etc/wireguard/${iface}.conf`;
+        case 'darwin': return `/usr/local/etc/wireguard/${iface}.conf`;
+        case 'windows': return `C:\\Program Files\\WireGuard\\Data\\Configurations\\${iface}.conf.dpapi`;
+    }
+}
+/** Build command to bring interface up */
+export function bringUpCmd(os, iface) {
+    switch (os) {
+        case 'linux': return `wg-quick up ${iface} 2>&1 || (systemctl start wg-quick@${iface} 2>&1)`;
+        case 'darwin': return `wg-quick up ${iface} 2>&1`;
+        case 'windows': return `"C:\\Program Files\\WireGuard\\wireguard.exe" /installtunnelservice ${iface} 2>&1`;
+    }
+}
+/** Build command to bring interface down */
+export function bringDownCmd(os, iface) {
+    switch (os) {
+        case 'linux': return `wg-quick down ${iface} 2>&1 || (systemctl stop wg-quick@${iface} 2>&1)`;
+        case 'darwin': return `wg-quick down ${iface} 2>&1`;
+        case 'windows': return `"C:\\Program Files\\WireGuard\\wireguard.exe" /uninstalltunnelservice ${iface} 2>&1`;
+    }
+}
+/** Build command to get WireGuard status */
+export function statusCmd(os, iface) {
+    if (os === 'windows') {
+        return `wg show ${iface} 2>&1`;
+    }
+    return `wg show ${iface} 2>&1; echo "---addr---"; ip -4 addr show ${iface} 2>/dev/null || ifconfig ${iface} 2>/dev/null`;
+}
+/** Parse `wg show` output into structured peers */
+export function parseWgShow(stdout) {
+    const lines = stdout.split('\n');
+    let interfaceName = '', publicKey = '', listenPort = 0, meshIp = '';
+    const peers = [];
+    let currentPeer = null;
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (trimmed.startsWith('interface:'))
+            interfaceName = trimmed.split(':')[1]?.trim() ?? '';
+        else if (trimmed.startsWith('public key:') && !currentPeer)
+            publicKey = trimmed.split(':').slice(1).join(':').trim();
+        else if (trimmed.startsWith('listening port:'))
+            listenPort = parseInt(trimmed.split(':')[1]?.trim() ?? '0');
+        else if (trimmed.startsWith('peer:')) {
+            if (currentPeer?.publicKey)
+                peers.push(currentPeer);
+            currentPeer = { publicKey: trimmed.split(':').slice(1).join(':').trim(), os: 'linux', id: '', meshIp: '', allowedIps: '' };
+        }
+        else if (currentPeer) {
+            if (trimmed.startsWith('endpoint:'))
+                currentPeer.endpoint = trimmed.split(':').slice(1).join(':').trim();
+            else if (trimmed.startsWith('allowed ips:')) {
+                const ips = trimmed.split(':').slice(1).join(':').trim();
+                currentPeer.allowedIps = ips;
+                currentPeer.meshIp = ips.split('/')[0] ?? '';
+            }
+            else if (trimmed.startsWith('latest handshake:'))
+                currentPeer.latestHandshake = Date.now();
+            else if (trimmed.startsWith('transfer:')) {
+                const parts = trimmed.split(':')[1]?.trim().split(',') ?? [];
+                currentPeer.transferRx = parseTransferBytes(parts[0] ?? '');
+                currentPeer.transferTx = parseTransferBytes(parts[1] ?? '');
+            }
+            else if (trimmed.startsWith('persistent keepalive:')) {
+                currentPeer.keepalive = parseInt(trimmed.split(':')[1]?.trim() ?? '25');
+            }
+        }
+        // Parse address from ip addr output
+        if (trimmed.startsWith('inet ') && trimmed.includes('/')) {
+            meshIp = trimmed.split(' ')[1]?.split('/')[0] ?? '';
+        }
+    }
+    if (currentPeer?.publicKey)
+        peers.push(currentPeer);
+    return { interfaceName, publicKey, listenPort, peers, meshIp, uptime: '' };
+}
+function parseTransferBytes(s) {
+    const trimmed = s.trim();
+    const match = trimmed.match(/([\d.]+)\s*(B|KiB|MiB|GiB|TiB)/);
+    if (!match)
+        return 0;
+    const val = parseFloat(match[1]);
+    const unit = match[2];
+    const multipliers = { B: 1, KiB: 1024, MiB: 1048576, GiB: 1073741824, TiB: 1099511627776 };
+    return Math.round(val * (multipliers[unit] ?? 1));
+}
+/** Build command to add a peer dynamically (no restart) */
+export function addPeerCmd(iface, peer, psk) {
+    const parts = [`wg set ${iface} peer ${peer.publicKey}`];
+    parts.push(`allowed-ips ${peer.allowedIps}`);
+    if (peer.endpoint)
+        parts.push(`endpoint ${peer.endpoint}`);
+    parts.push(`persistent-keepalive ${peer.keepalive ?? 25}`);
+    if (psk)
+        parts.push(`preshared-key <(echo "${psk}")`);
+    return parts.join(' ');
+}
+/** Build command to remove a peer dynamically */
+export function removePeerCmd(iface, publicKey) {
+    return `wg set ${iface} peer ${publicKey} remove`;
+}
+/** Build command to install WireGuard per OS */
+export function installCmd(os) {
+    switch (os) {
+        case 'linux': return 'apt-get update && apt-get install -y wireguard wireguard-tools 2>&1 || yum install -y wireguard-tools 2>&1 || dnf install -y wireguard-tools 2>&1 || pacman -S --noconfirm wireguard-tools 2>&1';
+        case 'darwin': return 'brew install wireguard-tools 2>&1';
+        case 'windows': return 'winget install WireGuard.WireGuard --accept-source-agreements --accept-package-agreements 2>&1 || choco install wireguard -y 2>&1';
+    }
+}
+/** Build command to check if WireGuard is installed */
+export function checkInstalledCmd(os) {
+    if (os === 'windows')
+        return 'where wg 2>NUL && echo "INSTALLED" || echo "NOT_INSTALLED"';
+    return 'which wg >/dev/null 2>&1 && echo "INSTALLED" || echo "NOT_INSTALLED"';
+}
+/** Build NAT traversal PostUp rules (iptables/nftables) */
+export function natTraversalPostUp(iface, publicIface = 'eth0') {
+    return [
+        `iptables -A FORWARD -i ${iface} -j ACCEPT`,
+        `iptables -A FORWARD -o ${iface} -j ACCEPT`,
+        `iptables -t nat -A POSTROUTING -o ${publicIface} -j MASQUERADE`,
+    ].join('; ');
+}
+/** Build NAT traversal PostDown rules */
+export function natTraversalPostDown(iface, publicIface = 'eth0') {
+    return [
+        `iptables -D FORWARD -i ${iface} -j ACCEPT`,
+        `iptables -D FORWARD -o ${iface} -j ACCEPT`,
+        `iptables -t nat -D POSTROUTING -o ${publicIface} -j MASQUERADE`,
+    ].join('; ');
+}
+/** Build command to rotate keys for a peer */
+export function rotateKeyCmd(iface, os) {
+    if (os === 'windows') {
+        return 'echo "Key rotation on Windows requires config file update + tunnel restart"';
+    }
+    return [
+        'NEW_PRIV=$(wg genkey)',
+        'NEW_PUB=$(echo "$NEW_PRIV" | wg pubkey)',
+        `wg set ${iface} private-key <(echo "$NEW_PRIV")`,
+        'echo "PRIV:$NEW_PRIV"',
+        'echo "PUB:$NEW_PUB"',
+    ].join('; ');
+}
+/** Build monitoring/health check command */
+export function healthCheckCmd(iface, peers) {
+    const pings = peers.map((ip) => `(ping -c1 -W2 ${ip} >/dev/null 2>&1 && echo "OK ${ip}" || echo "FAIL ${ip}")`);
+    return [
+        `wg show ${iface} latest-handshakes 2>/dev/null`,
+        `echo "---pings---"`,
+        ...pings,
+        `echo "---transfer---"`,
+        `wg show ${iface} transfer 2>/dev/null`,
+    ].join('; ');
+}
+/** Build STUN/endpoint discovery command for NAT'd peers */
+export function stunDiscoverCmd() {
+    return [
+        '# Discover public endpoint via STUN',
+        'stun_servers="stun.l.google.com:19302 stun1.l.google.com:19302 stun.cloudflare.com:3478"',
+        'for s in $stun_servers; do',
+        '  result=$(stun $s 2>/dev/null | grep -i "mapped" | head -1)',
+        '  [ -n "$result" ] && { echo "STUN:$result"; break; }',
+        'done',
+        '# Fallback: curl-based IP detection',
+        'echo "PUBLIC_IP:$(curl -s --max-time 3 https://api.ipify.org 2>/dev/null || curl -s --max-time 3 https://ifconfig.me 2>/dev/null)"',
+    ].join('\n');
+}
+/** Generate a mesh topology config for N peers (hub-and-spoke or full-mesh) */
+export function generateMeshTopology(peers, topology = 'full-mesh', hubId) {
+    const result = new Map();
+    if (topology === 'full-mesh') {
+        // Every peer connects to every other peer
+        for (const peer of peers) {
+            const others = peers
+                .filter((p) => p.id !== peer.id)
+                .map((p) => ({
+                id: p.id,
+                publicKey: p.publicKey,
+                endpoint: p.endpoint,
+                meshIp: p.meshIp,
+                allowedIps: `${p.meshIp}/32`,
+                keepalive: 25,
+                os: 'linux',
+            }));
+            result.set(peer.id, others);
+        }
+    }
+    else {
+        // Hub-and-spoke: only hub connects to all, spokes connect only to hub
+        const hub = peers.find((p) => p.id === (hubId ?? peers[0]?.id));
+        if (!hub)
+            return result;
+        const spokes = peers.filter((p) => p.id !== hub.id);
+        // Hub gets all spokes
+        result.set(hub.id, spokes.map((s) => ({
+            id: s.id,
+            publicKey: s.publicKey,
+            endpoint: s.endpoint,
+            meshIp: s.meshIp,
+            allowedIps: `${s.meshIp}/32`,
+            keepalive: 25,
+            os: 'linux',
+        })));
+        // Each spoke gets only the hub
+        for (const spoke of spokes) {
+            result.set(spoke.id, [{
+                    id: hub.id,
+                    publicKey: hub.publicKey,
+                    endpoint: hub.endpoint,
+                    meshIp: hub.meshIp,
+                    allowedIps: '10.10.0.0/24', // Route all mesh traffic through hub
+                    keepalive: 25,
+                    os: 'linux',
+                }]);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=omnimesh.js.map

package/dist/mesh/omnimesh.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"omnimesh.js","sourceRoot":"","sources":["../../src/mesh/omnimesh.ts"],"names":[],"mappings":"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"}

package/dist/update.d.ts

@@ -1,17 +1,38 @@
-interface UpdateResult {
+export type UpdateSource = 'npm' | 'github' | 'auto';
+export interface UpdateResult {
     readonly currentVersion: string;
     readonly latestVersion: string;
     readonly updated: boolean;
     readonly message: string;
+    readonly source?: UpdateSource;
 }
-/** Check if a newer version is available on npm */
-export declare function checkForUpdate(): Promise<{
+interface UpdateState {
+    lastCheck: number;
+    lastVersion: string;
+    autoUpdateEnabled: boolean;
+    source: UpdateSource;
+    checkIntervalMs: number;
+}
+/** Check for update from best available source */
+export declare function checkForUpdate(source?: UpdateSource): Promise<{
     current: string;
     latest: string;
     updateAvailable: boolean;
+    source: UpdateSource;
 }>;
 /** Self-update OmniWire to the latest version */
-export declare function selfUpdate(): Promise<UpdateResult>;
+export declare function selfUpdate(source?: UpdateSource): Promise<UpdateResult>;
+/** Start auto-update background checker */
+export declare function startAutoUpdate(intervalMs?: number, onUpdate?: (result: UpdateResult) => void): void;
+/** Stop auto-update background checker */
+export declare function stopAutoUpdate(): void;
+/** Check if auto-update is enabled */
+export declare function isAutoUpdateEnabled(): boolean;
+/** Get auto-update state info */
+export declare function getAutoUpdateState(): UpdateState & {
+    currentVersion: string;
+    timerActive: boolean;
+};
 /** Get system info for diagnostics */
 export declare function getSystemInfo(): Record<string, string>;
 export {};