@omindu/yaksha 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Omindu Dissanayaka
+
+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/bin/yaksha.js

@@ -0,0 +1,329 @@
+#!/usr/bin/env node
+'use strict';
+
+/**
+ * Yaksha VPN CLI Tool
+ * Command-line interface for server and client management
+ */
+
+const yaksha = require('../src');
+const crypto = require('crypto');
+
+// Parse command-line arguments
+const args = process.argv.slice(2);
+const command = args[0];
+
+function printUsage() {
+  console.log(`
+Yaksha VPN Protocol v1.1.0
+Usage: yaksha <command> [options]
+
+Commands:
+  server              Start VPN server
+  client              Start VPN client
+  keygen              Generate encryption key pair
+  benchmark           Run performance benchmarks
+  config              Launch configuration wizard
+
+Server Options:
+  --port <port>       Server port (default: 8443)
+  --host <host>       Bind address (default: 0.0.0.0)
+  --security <level>  Security level: low, medium, high, custom (default: medium)
+  --auth <method>     Auth method: password, token, certificate (default: token)
+  --config <file>     Load configuration from file
+  --log <level>       Log level: debug, info, warn, error (default: info)
+  --daemon            Run as daemon (Unix only)
+
+Client Options:
+  --server <address>  Server address (required)
+  --port <port>       Server port (default: 8443)
+  --security <level>  Security level: low, medium, high, custom (default: medium)
+  --token <token>     Authentication token
+  --user <username>   Username (for password auth)
+  --pass <password>   Password (for password auth)
+  --config <file>     Load configuration from file
+  --log <level>       Log level: debug, info, warn, error (default: info)
+
+Note: For custom security level, use --config <file> with customSecurityConfig
+
+Examples:
+  yaksha server --port 8443 --security high
+  yaksha client --server vpn.example.com --token abc123
+  yaksha server --security custom --config custom-security.json
+  yaksha keygen
+  yaksha benchmark
+
+For more information: https://github.com/OminduDissanayaka/Yaksha
+  `);
+}
+
+function parseOptions(args) {
+  const options = {};
+  
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    
+    if (arg.startsWith('--')) {
+      const key = arg.slice(2);
+      const value = args[i + 1];
+      
+      if (value && !value.startsWith('--')) {
+        options[key] = value;
+        i++;
+      } else {
+        options[key] = true;
+      }
+    }
+  }
+  
+  return options;
+}
+
+async function startServer(options) {
+  console.log('Starting Yaksha VPN Server...\n');
+  
+  const serverOptions = {
+    port: parseInt(options.port) || 8443,
+    host: options.host || '0.0.0.0',
+    securityLevel: options.security || 'medium',
+    authMethod: options.auth || 'token',
+    logLevel: options.log || 'info'
+  };
+
+  // Load config file if specified
+  if (options.config) {
+    const config = new yaksha.Config();
+    config.loadFromFile(options.config);
+    Object.assign(serverOptions, config.getAll());
+  }
+
+  const server = yaksha.createServer(serverOptions);
+
+  // Set up authentication (simplified - for demo purposes)
+  if (serverOptions.authMethod === 'token') {
+    const token = crypto.randomBytes(16).toString('hex');
+    server.auth.registerToken('demo-client', token);
+    console.log(`Generated authentication token: ${token}`);
+    console.log('Share this token with clients\n');
+  }
+
+  // Event handlers
+  server.on('listening', (info) => {
+    console.log(`✓ Server listening on ${info.host}:${info.port}`);
+    console.log(`✓ Security level: ${serverOptions.securityLevel.toUpperCase()}`);
+    console.log(`✓ Auth method: ${serverOptions.authMethod}`);
+    console.log('\nPress Ctrl+C to stop\n');
+  });
+
+  server.on('connection', (sessionId, address) => {
+    console.log(`[${new Date().toISOString()}] New connection: ${address} (session: ${sessionId})`);
+  });
+
+  server.on('disconnection', (sessionId, address) => {
+    console.log(`[${new Date().toISOString()}] Disconnected: ${address} (session: ${sessionId})`);
+  });
+
+  server.on('error', (error) => {
+    console.error(`[ERROR] ${error.message}`);
+  });
+
+  // Start server
+  try {
+    await server.start();
+  } catch (error) {
+    console.error(`Failed to start server: ${error.message}`);
+    process.exit(1);
+  }
+
+  // Handle shutdown
+  process.on('SIGINT', async () => {
+    console.log('\nShutting down server...');
+    await server.stop();
+    console.log('Server stopped');
+    process.exit(0);
+  });
+
+  process.on('SIGTERM', async () => {
+    await server.stop();
+    process.exit(0);
+  });
+}
+
+async function startClient(options) {
+  console.log('Starting Yaksha VPN Client...\n');
+  
+  if (!options.server) {
+    console.error('Error: --server is required');
+    process.exit(1);
+  }
+
+  const clientOptions = {
+    server: options.server,
+    port: parseInt(options.port) || 8443,
+    securityLevel: options.security || 'medium',
+    autoReconnect: true,
+    logLevel: options.log || 'info',
+    authCredentials: {}
+  };
+
+  // Set up authentication credentials
+  if (options.token) {
+    clientOptions.authCredentials = {
+      identifier: 'demo-client',
+      token: options.token
+    };
+  } else if (options.user && options.pass) {
+    clientOptions.authCredentials = {
+      username: options.user,
+      password: options.pass
+    };
+  }
+
+  // Load config file if specified
+  if (options.config) {
+    const config = new yaksha.Config();
+    config.loadFromFile(options.config);
+    Object.assign(clientOptions, config.getAll());
+  }
+
+  const client = yaksha.createClient(clientOptions);
+
+  // Event handlers
+  client.on('connected', (info) => {
+    console.log(`✓ Connected to ${info.server}`);
+    console.log(`✓ Session ID: ${info.sessionId}`);
+    console.log(`✓ Security level: ${clientOptions.securityLevel.toUpperCase()}`);
+    console.log('\nVPN tunnel established\nPress Ctrl+C to disconnect\n');
+  });
+
+  client.on('disconnected', () => {
+    console.log(`[${new Date().toISOString()}] Disconnected from server`);
+  });
+
+  client.on('reconnecting', (attempt, delay) => {
+    console.log(`[${new Date().toISOString()}] Reconnecting... (attempt ${attempt}, delay ${delay}ms)`);
+  });
+
+  client.on('data', (data) => {
+    console.log(`[${new Date().toISOString()}] Received ${data.length} bytes`);
+  });
+
+  client.on('error', (error) => {
+    console.error(`[ERROR] ${error.message}`);
+  });
+
+  // Connect to server
+  try {
+    await client.connect();
+  } catch (error) {
+    console.error(`Failed to connect: ${error.message}`);
+    process.exit(1);
+  }
+
+  // Handle shutdown
+  process.on('SIGINT', async () => {
+    console.log('\nDisconnecting...');
+    await client.disconnect();
+    console.log('Disconnected');
+    process.exit(0);
+  });
+
+  process.on('SIGTERM', async () => {
+    await client.disconnect();
+    process.exit(0);
+  });
+
+  // Display stats every 10 seconds
+  setInterval(() => {
+    const stats = client.getStats();
+    console.log(`\n[STATS] Uptime: ${Math.floor(stats.uptime / 1000)}s | Sent: ${stats.bytesSent}B | Received: ${stats.bytesReceived}B | Packets: ${stats.packetsSent}/${stats.packetsReceived}`);
+  }, 10000);
+}
+
+function generateKeyPair() {
+  console.log('Generating X25519 key pair...\n');
+  
+  const nacl = require('tweetnacl');
+  const keyPair = nacl.box.keyPair();
+  
+  console.log('Public Key:', Buffer.from(keyPair.publicKey).toString('hex'));
+  console.log('Private Key:', Buffer.from(keyPair.secretKey).toString('hex'));
+  console.log('\nKeep your private key secure and never share it!\n');
+}
+
+async function runBenchmark() {
+  console.log('Running Yaksha VPN Performance Benchmarks...\n');
+  
+  const Benchmark = require('benchmark');
+  const suite = new Benchmark.Suite;
+
+  // Encryption benchmark
+  const encryption = new yaksha.Encryption('medium');
+  encryption.generateKeys();
+  const testData = crypto.randomBytes(1024);
+
+  suite
+    .add('Encryption (1KB)', function() {
+      encryption.encrypt(testData);
+    })
+    .add('Protocol Serialization', function() {
+      const protocol = new yaksha.Protocol();
+      protocol.serialize(0x02, testData, 12345, 1);
+    })
+    .on('cycle', function(event) {
+      console.log(String(event.target));
+    })
+    .on('complete', function() {
+      console.log('\nBenchmark complete');
+    })
+    .run({ 'async': true });
+}
+
+function launchConfigWizard() {
+  console.log('Yaksha Configuration Wizard\n');
+  console.log('This feature is not yet implemented.');
+  console.log('Please create a config file manually or use command-line options.\n');
+}
+
+// Main command router
+async function main() {
+  if (args.length === 0 || command === 'help' || command === '--help' || command === '-h') {
+    printUsage();
+    process.exit(0);
+  }
+
+  const options = parseOptions(args.slice(1));
+
+  switch (command) {
+    case 'server':
+      await startServer(options);
+      break;
+
+    case 'client':
+      await startClient(options);
+      break;
+
+    case 'keygen':
+      generateKeyPair();
+      break;
+
+    case 'benchmark':
+      await runBenchmark();
+      break;
+
+    case 'config':
+      launchConfigWizard();
+      break;
+
+    default:
+      console.error(`Unknown command: ${command}`);
+      console.log('Run "yaksha help" for usage information');
+      process.exit(1);
+  }
+}
+
+// Run CLI
+main().catch((error) => {
+  console.error('Fatal error:', error.message);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@omindu/yaksha",
+  "version": "1.0.0",
+  "description": "Lightning-fast, lightweight VPN protocol library with advanced firewall bypass capabilities",
+  "main": "src/index.js",
+  "bin": {
+    "yaksha": "./bin/yaksha.js"
+  },
+  "scripts": {
+    "start": "node bin/yaksha.js"
+  },
+  "author": "Omindu Dissanayaka",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/OminduDissanayaka/Yaksha.git"
+  },
+  "bugs": {
+    "url": "https://github.com/OminduDissanayaka/Yaksha/issues"
+  },
+  "homepage": "https://github.com/OminduDissanayaka/Yaksha#readme",
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "dependencies": {
+    "tweetnacl": "^1.0.3"
+  }
+}