@push.rocks/smartvpn 1.0.3

package/dist_ts/smartvpn.classes.vpnserver.js

@@ -0,0 +1,85 @@
+import * as plugins from './smartvpn.plugins.js';
+import { VpnBridge } from './smartvpn.classes.vpnbridge.js';
+/**
+ * VPN Server — manages a smartvpn daemon in server mode.
+ */
+export class VpnServer extends plugins.events.EventEmitter {
+    constructor(options) {
+        super();
+        this.options = options;
+        this.bridge = new VpnBridge({
+            transport: options.transport,
+            mode: 'server',
+        });
+        // Forward bridge events
+        this.bridge.on('exit', (code, signal) => {
+            this.emit('exit', { code, signal });
+        });
+        this.bridge.on('reconnected', () => {
+            this.emit('reconnected');
+        });
+    }
+    /**
+     * Start the daemon bridge (spawn or connect).
+     */
+    async start(config) {
+        const started = await this.bridge.start();
+        if (!started) {
+            throw new Error('VpnServer: failed to start daemon bridge');
+        }
+        const cfg = config || this.options.config;
+        if (cfg) {
+            await this.bridge.sendCommand('start', { config: cfg });
+        }
+    }
+    /**
+     * Stop the VPN server.
+     */
+    async stopServer() {
+        await this.bridge.sendCommand('stop', {});
+    }
+    /**
+     * Get server status.
+     */
+    async getStatus() {
+        return this.bridge.sendCommand('getStatus', {});
+    }
+    /**
+     * Get server statistics.
+     */
+    async getStatistics() {
+        return this.bridge.sendCommand('getStatistics', {});
+    }
+    /**
+     * List connected clients.
+     */
+    async listClients() {
+        const result = await this.bridge.sendCommand('listClients', {});
+        return result.clients;
+    }
+    /**
+     * Disconnect a specific client.
+     */
+    async disconnectClient(clientId) {
+        await this.bridge.sendCommand('disconnectClient', { clientId });
+    }
+    /**
+     * Generate a new Noise keypair.
+     */
+    async generateKeypair() {
+        return this.bridge.sendCommand('generateKeypair', {});
+    }
+    /**
+     * Stop the daemon bridge.
+     */
+    stop() {
+        this.bridge.stop();
+    }
+    /**
+     * Whether the bridge is running.
+     */
+    get running() {
+        return this.bridge.running;
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic21hcnR2cG4uY2xhc3Nlcy52cG5zZXJ2ZXIuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90cy9zbWFydHZwbi5jbGFzc2VzLnZwbnNlcnZlci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssT0FBTyxNQUFNLHVCQUF1QixDQUFDO0FBQ2pELE9BQU8sRUFBRSxTQUFTLEVBQUUsTUFBTSxpQ0FBaUMsQ0FBQztBQVc1RDs7R0FFRztBQUNILE1BQU0sT0FBTyxTQUFVLFNBQVEsT0FBTyxDQUFDLE1BQU0sQ0FBQyxZQUFZO0lBSXhELFlBQVksT0FBMEI7UUFDcEMsS0FBSyxFQUFFLENBQUM7UUFDUixJQUFJLENBQUMsT0FBTyxHQUFHLE9BQU8sQ0FBQztRQUN2QixJQUFJLENBQUMsTUFBTSxHQUFHLElBQUksU0FBUyxDQUFxQjtZQUM5QyxTQUFTLEVBQUUsT0FBTyxDQUFDLFNBQVM7WUFDNUIsSUFBSSxFQUFFLFFBQVE7U0FDZixDQUFDLENBQUM7UUFFSCx3QkFBd0I7UUFDeEIsSUFBSSxDQUFDLE1BQU0sQ0FBQyxFQUFFLENBQUMsTUFBTSxFQUFFLENBQUMsSUFBbUIsRUFBRSxNQUFxQixFQUFFLEVBQUU7WUFDcEUsSUFBSSxDQUFDLElBQUksQ0FBQyxNQUFNLEVBQUUsRUFBRSxJQUFJLEVBQUUsTUFBTSxFQUFFLENBQUMsQ0FBQztRQUN0QyxDQUFDLENBQUMsQ0FBQztRQUNILElBQUksQ0FBQyxNQUFNLENBQUMsRUFBRSxDQUFDLGFBQWEsRUFBRSxHQUFHLEVBQUU7WUFDakMsSUFBSSxDQUFDLElBQUksQ0FBQyxhQUFhLENBQUMsQ0FBQztRQUMzQixDQUFDLENBQUMsQ0FBQztJQUNMLENBQUM7SUFFRDs7T0FFRztJQUNJLEtBQUssQ0FBQyxLQUFLLENBQUMsTUFBeUI7UUFDMUMsTUFBTSxPQUFPLEdBQUcsTUFBTSxJQUFJLENBQUMsTUFBTSxDQUFDLEtBQUssRUFBRSxDQUFDO1FBQzFDLElBQUksQ0FBQyxPQUFPLEVBQUUsQ0FBQztZQUNiLE1BQU0sSUFBSSxLQUFLLENBQUMsMENBQTBDLENBQUMsQ0FBQztRQUM5RCxDQUFDO1FBQ0QsTUFBTSxHQUFHLEdBQUcsTUFBTSxJQUFJLElBQUksQ0FBQyxPQUFPLENBQUMsTUFBTSxDQUFDO1FBQzFDLElBQUksR0FBRyxFQUFFLENBQUM7WUFDUixNQUFNLElBQUksQ0FBQyxNQUFNLENBQUMsV0FBVyxDQUFDLE9BQU8sRUFBRSxFQUFFLE1BQU0sRUFBRSxHQUFHLEVBQUUsQ0FBQyxDQUFDO1FBQzFELENBQUM7SUFDSCxDQUFDO0lBRUQ7O09BRUc7SUFDSSxLQUFLLENBQUMsVUFBVTtRQUNyQixNQUFNLElBQUksQ0FBQyxNQUFNLENBQUMsV0FBVyxDQUFDLE1BQU0sRUFBRSxFQUEyQixDQUFDLENBQUM7SUFDckUsQ0FBQztJQUVEOztPQUVHO0lBQ0ksS0FBSyxDQUFDLFNBQVM7UUFDcEIsT0FBTyxJQUFJLENBQUMsTUFBTSxDQUFDLFdBQVcsQ0FBQyxXQUFXLEVBQUUsRUFBMkIsQ0FBQyxDQUFDO0lBQzNFLENBQUM7SUFFRDs7T0FFRztJQUNJLEtBQUssQ0FBQyxhQUFhO1FBQ3hCLE9BQU8sSUFBSSxDQUFDLE1BQU0sQ0FBQyxXQUFXLENBQUMsZUFBZSxFQUFFLEVBQTJCLENBQUMsQ0FBQztJQUMvRSxDQUFDO0lBRUQ7O09BRUc7SUFDSSxLQUFLLENBQUMsV0FBVztRQUN0QixNQUFNLE1BQU0sR0FBRyxNQUFNLElBQUksQ0FBQyxNQUFNLENBQUMsV0FBVyxDQUFDLGFBQWEsRUFBRSxFQUEyQixDQUFDLENBQUM7UUFDekYsT0FBTyxNQUFNLENBQUMsT0FBTyxDQUFDO0lBQ3hCLENBQUM7SUFFRDs7T0FFRztJQUNJLEtBQUssQ0FBQyxnQkFBZ0IsQ0FBQyxRQUFnQjtRQUM1QyxNQUFNLElBQUksQ0FBQyxNQUFNLENBQUMsV0FBVyxDQUFDLGtCQUFrQixFQUFFLEVBQUUsUUFBUSxFQUFFLENBQUMsQ0FBQztJQUNsRSxDQUFDO0lBRUQ7O09BRUc7SUFDSSxLQUFLLENBQUMsZUFBZTtRQUMxQixPQUFPLElBQUksQ0FBQyxNQUFNLENBQUMsV0FBVyxDQUFDLGlCQUFpQixFQUFFLEVBQTJCLENBQUMsQ0FBQztJQUNqRixDQUFDO0lBRUQ7O09BRUc7SUFDSSxJQUFJO1FBQ1QsSUFBSSxDQUFDLE1BQU0sQ0FBQyxJQUFJLEVBQUUsQ0FBQztJQUNyQixDQUFDO0lBRUQ7O09BRUc7SUFDSCxJQUFXLE9BQU87UUFDaEIsT0FBTyxJQUFJLENBQUMsTUFBTSxDQUFDLE9BQU8sQ0FBQztJQUM3QixDQUFDO0NBQ0YifQ==

package/dist_ts/smartvpn.interfaces.d.ts

@@ -0,0 +1,167 @@
+export interface IVpnTransportStdio {
+    transport: 'stdio';
+}
+export interface IVpnTransportSocket {
+    transport: 'socket';
+    socketPath: string;
+    autoReconnect?: boolean;
+    reconnectBaseDelayMs?: number;
+    reconnectMaxDelayMs?: number;
+    maxReconnectAttempts?: number;
+}
+export type TVpnTransportOptions = IVpnTransportStdio | IVpnTransportSocket;
+export interface IVpnClientConfig {
+    /** Server WebSocket URL, e.g. wss://vpn.example.com/tunnel */
+    serverUrl: string;
+    /** Server's static public key (base64) for Noise NK handshake */
+    serverPublicKey: string;
+    /** Optional DNS servers to use while connected */
+    dns?: string[];
+    /** Optional MTU for the TUN device */
+    mtu?: number;
+    /** Keepalive interval in seconds (default: 30) */
+    keepaliveIntervalSecs?: number;
+}
+export interface IVpnClientOptions {
+    transport: TVpnTransportOptions;
+    config?: IVpnClientConfig;
+}
+export interface IVpnServerConfig {
+    /** Listen address for WebSocket, e.g. 0.0.0.0:443 */
+    listenAddr: string;
+    /** TLS certificate PEM (optional — can be behind reverse proxy) */
+    tlsCert?: string;
+    /** TLS private key PEM */
+    tlsKey?: string;
+    /** Server's Noise static private key (base64) */
+    privateKey: string;
+    /** Server's Noise static public key (base64) */
+    publicKey: string;
+    /** IP subnet for VPN clients, e.g. 10.8.0.0/24 */
+    subnet: string;
+    /** DNS servers pushed to clients */
+    dns?: string[];
+    /** MTU for TUN device */
+    mtu?: number;
+    /** Keepalive interval in seconds (default: 30) */
+    keepaliveIntervalSecs?: number;
+    /** Enable NAT/masquerade for client traffic */
+    enableNat?: boolean;
+}
+export interface IVpnServerOptions {
+    transport: TVpnTransportOptions;
+    config?: IVpnServerConfig;
+}
+export type TVpnConnectionState = 'disconnected' | 'connecting' | 'handshaking' | 'connected' | 'reconnecting' | 'error';
+export interface IVpnStatus {
+    state: TVpnConnectionState;
+    assignedIp?: string;
+    serverAddr?: string;
+    connectedSince?: string;
+    lastError?: string;
+}
+export interface IVpnStatistics {
+    bytesSent: number;
+    bytesReceived: number;
+    packetsSent: number;
+    packetsReceived: number;
+    keepalivesSent: number;
+    keepalivesReceived: number;
+    uptimeSeconds: number;
+}
+export interface IVpnClientInfo {
+    clientId: string;
+    assignedIp: string;
+    connectedSince: string;
+    bytesSent: number;
+    bytesReceived: number;
+}
+export interface IVpnServerStatistics extends IVpnStatistics {
+    activeClients: number;
+    totalConnections: number;
+}
+export interface IVpnKeypair {
+    publicKey: string;
+    privateKey: string;
+}
+export type TVpnClientCommands = {
+    connect: {
+        params: {
+            config: IVpnClientConfig;
+        };
+        result: {
+            assignedIp: string;
+        };
+    };
+    disconnect: {
+        params: Record<string, never>;
+        result: void;
+    };
+    getStatus: {
+        params: Record<string, never>;
+        result: IVpnStatus;
+    };
+    getStatistics: {
+        params: Record<string, never>;
+        result: IVpnStatistics;
+    };
+};
+export type TVpnServerCommands = {
+    start: {
+        params: {
+            config: IVpnServerConfig;
+        };
+        result: void;
+    };
+    stop: {
+        params: Record<string, never>;
+        result: void;
+    };
+    getStatus: {
+        params: Record<string, never>;
+        result: IVpnStatus;
+    };
+    getStatistics: {
+        params: Record<string, never>;
+        result: IVpnServerStatistics;
+    };
+    listClients: {
+        params: Record<string, never>;
+        result: {
+            clients: IVpnClientInfo[];
+        };
+    };
+    disconnectClient: {
+        params: {
+            clientId: string;
+        };
+        result: void;
+    };
+    generateKeypair: {
+        params: Record<string, never>;
+        result: IVpnKeypair;
+    };
+};
+export type TVpnPlatform = 'linux' | 'macos' | 'windows' | 'unknown';
+export interface IVpnServiceUnit {
+    platform: TVpnPlatform;
+    content: string;
+    installPath: string;
+}
+export interface IVpnEventMap {
+    'status': IVpnStatus;
+    'error': {
+        message: string;
+        code?: string;
+    };
+    'client-connected': IVpnClientInfo;
+    'client-disconnected': {
+        clientId: string;
+        reason?: string;
+    };
+    'exit': {
+        code: number | null;
+        signal: string | null;
+    };
+    'reconnected': void;
+}

package/dist_ts/smartvpn.interfaces.js

@@ -0,0 +1,5 @@
+// ============================================================================
+// Transport options
+// ============================================================================
+export {};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic21hcnR2cG4uaW50ZXJmYWNlcy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3RzL3NtYXJ0dnBuLmludGVyZmFjZXMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsK0VBQStFO0FBQy9FLG9CQUFvQjtBQUNwQiwrRUFBK0UifQ==

package/dist_ts/smartvpn.paths.d.ts

@@ -0,0 +1 @@
+export declare const packageDir: string;

package/dist_ts/smartvpn.paths.js

@@ -0,0 +1,3 @@
+import * as plugins from './smartvpn.plugins.js';
+export const packageDir = plugins.path.join(plugins.smartpath.get.dirnameFromImportMetaUrl(import.meta.url), '../');
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic21hcnR2cG4ucGF0aHMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90cy9zbWFydHZwbi5wYXRocy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssT0FBTyxNQUFNLHVCQUF1QixDQUFDO0FBRWpELE1BQU0sQ0FBQyxNQUFNLFVBQVUsR0FBRyxPQUFPLENBQUMsSUFBSSxDQUFDLElBQUksQ0FDekMsT0FBTyxDQUFDLFNBQVMsQ0FBQyxHQUFHLENBQUMsd0JBQXdCLENBQUMsTUFBTSxDQUFDLElBQUksQ0FBQyxHQUFHLENBQUMsRUFDL0QsS0FBSyxDQUNOLENBQUMifQ==

package/dist_ts/smartvpn.plugins.d.ts

@@ -0,0 +1,9 @@
+import * as path from 'path';
+import * as fs from 'fs';
+import * as os from 'os';
+import * as url from 'url';
+import * as events from 'events';
+export { path, fs, os, url, events };
+import * as smartpath from '@push.rocks/smartpath';
+import * as smartrust from '@push.rocks/smartrust';
+export { smartpath, smartrust };

package/dist_ts/smartvpn.plugins.js

@@ -0,0 +1,12 @@
+// node native
+import * as path from 'path';
+import * as fs from 'fs';
+import * as os from 'os';
+import * as url from 'url';
+import * as events from 'events';
+export { path, fs, os, url, events };
+// @push.rocks
+import * as smartpath from '@push.rocks/smartpath';
+import * as smartrust from '@push.rocks/smartrust';
+export { smartpath, smartrust };
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic21hcnR2cG4ucGx1Z2lucy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3RzL3NtYXJ0dnBuLnBsdWdpbnMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsY0FBYztBQUNkLE9BQU8sS0FBSyxJQUFJLE1BQU0sTUFBTSxDQUFDO0FBQzdCLE9BQU8sS0FBSyxFQUFFLE1BQU0sSUFBSSxDQUFDO0FBQ3pCLE9BQU8sS0FBSyxFQUFFLE1BQU0sSUFBSSxDQUFDO0FBQ3pCLE9BQU8sS0FBSyxHQUFHLE1BQU0sS0FBSyxDQUFDO0FBQzNCLE9BQU8sS0FBSyxNQUFNLE1BQU0sUUFBUSxDQUFDO0FBRWpDLE9BQU8sRUFBRSxJQUFJLEVBQUUsRUFBRSxFQUFFLEVBQUUsRUFBRSxHQUFHLEVBQUUsTUFBTSxFQUFFLENBQUM7QUFFckMsY0FBYztBQUNkLE9BQU8sS0FBSyxTQUFTLE1BQU0sdUJBQXVCLENBQUM7QUFDbkQsT0FBTyxLQUFLLFNBQVMsTUFBTSx1QkFBdUIsQ0FBQztBQUVuRCxPQUFPLEVBQUUsU0FBUyxFQUFFLFNBQVMsRUFBRSxDQUFDIn0=

package/license.md

@@ -0,0 +1,21 @@
+# MIT License
+
+Copyright (c) 2024 Task Venture Capital GmbH
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@push.rocks/smartvpn",
+  "version": "1.0.3",
+  "private": false,
+  "description": "A VPN solution with TypeScript control plane and Rust data plane daemon",
+  "type": "module",
+  "exports": {
+    ".": "./dist_ts/index.js"
+  },
+  "main": "dist_ts/index.js",
+  "typings": "dist_ts/index.d.ts",
+  "scripts": {
+    "build": "(tsbuild tsfolders --allowimplicitany) && (tsrust)",
+    "test": "tstest test/ --verbose",
+    "buildDocs": "tsdoc"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://code.foss.global/push.rocks/smartvpn.git"
+  },
+  "keywords": [
+    "vpn",
+    "wireguard",
+    "typescript",
+    "rust",
+    "tunnel",
+    "networking"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@push.rocks/smartrust": "^1.3.0",
+    "@push.rocks/smartpath": "^5.0.18"
+  },
+  "devDependencies": {
+    "@git.zone/tsbuild": "^2.2.12",
+    "@git.zone/tsrun": "^1.3.3",
+    "@git.zone/tstest": "^1.0.96",
+    "@git.zone/tsrust": "^1.0.29",
+    "@types/node": "^22.0.0"
+  },
+  "files": [
+    "ts/**/*",
+    "dist_ts/**/*",
+    "dist_rust/**/*",
+    "assets/**/*",
+    "readme.md",
+    "license.md"
+  ],
+  "browserslist": [
+    "last 1 chrome versions"
+  ]
+}