nport 2.0.4 → 2.0.6

package/src/lang.js

@@ -0,0 +1,263 @@
+import fs from "fs";
+import path from "path";
+import os from "os";
+import readline from "readline";
+import { configManager } from "./config-manager.js";
+
+// ============================================================================
+// Language Translations
+// ============================================================================
+
+const TRANSLATIONS = {
+  en: {
+    // Header
+    header: "N P O R T  ⚡️  Free & Open Source from Vietnam ❤️",
+    
+    // Spinners
+    creatingTunnel: "Creating tunnel for port {port}...",
+    checkingUpdates: "Checking for updates...",
+    
+    // Success messages
+    tunnelLive: "🚀 WE LIVE BABY!",
+    connection1: "   ✔ [1/2] Connection established...",
+    connection2: "   ✔ [2/2] Compression enabled...",
+    timeRemaining: "⏱️  Time:     {hours}h remaining",
+    
+    // Footer
+    footerTitle: "🔥 KEEP THE VIBE ALIVE?",
+    footerSubtitle: "(Made with ❤️  in Vietnam)",
+    dropStar: "⭐️  Drop a Star:   ",
+    sendCoffee: "☕️  Buy Coffee:    ",
+    newVersion: "🚨 NEW VERSION (v{version}) detected!",
+    updateCommand: "> npm install -g nport@latest",
+    
+    // Cleanup
+    tunnelShutdown: "🛑 TUNNEL SHUTDOWN.",
+    cleaningUp: "Cleaning up... ",
+    cleanupDone: "Done.",
+    cleanupFailed: "Failed.",
+    subdomainReleased: "Subdomain...   Released. 🗑️",
+    serverBusy: "(Server might be down or busy)",
+    
+    // Goodbye
+    goodbyeTitle: "👋 BEFORE YOU GO...",
+    goodbyeMessage: "Thanks for using NPort!",
+    website: "🌐 Website:     ",
+    author: "👤 Author:      ",
+    changeLanguage: "🌍 Language:    ",
+    changeLanguageHint: "nport --language",
+    
+    // Version
+    versionTitle: "NPort v{version}",
+    versionSubtitle: "Free & open source ngrok alternative",
+    versionLatest: "✔ You're running the latest version!",
+    versionAvailable: "🚨 New version available: v{version}",
+    versionUpdate: "Update now: ",
+    learnMore: "Learn more: ",
+    
+    // Language selection
+    languagePrompt: "\n🌍 Language Selection / Chọn ngôn ngữ\n",
+    languageQuestion: "Choose your language (1-2): ",
+    languageEnglish: "1. English",
+    languageVietnamese: "2. Tiếng Việt (Vietnamese)",
+    languageInvalid: "Invalid choice. Using English by default.",
+    languageSaved: "✔ Language preference saved!",
+  },
+  
+  vi: {
+    // Header
+    header: "N P O R T  ⚡️  Việt Nam Mãi Đỉnh ❤️",
+    
+    // Spinners
+    creatingTunnel: "🛠️ Đang khởi động cổng {port}... Chuẩn bị bay nào!",
+    checkingUpdates: "🔍 Đang dò la bản cập nhật mới... Đợi tí sắp có quà!",
+    
+    // Success messages
+    tunnelLive: "🚀 BẬT MODE TỐC HÀNH! ĐANG BAY RỒI NÈ!",
+    connection1: "   ✔ [1/2] Đang cắm dây mạng vũ trụ...",
+    connection2: "   ✔ [2/2] Đang bơm siêu nén khí tốc độ ánh sáng...",
+    timeRemaining: "⏱️  Tăng tốc thần sầu: Còn {hours}h để quẩy!",
+    
+    // Footer
+    footerTitle: "🔥 LƯU DANH SỬ SÁCH! ĐỪNG QUÊN STAR ⭐️",
+    footerSubtitle: "(Made in Việt Nam, chuẩn không cần chỉnh! ❤️)",
+    dropStar: "⭐️  Thả Star: ",
+    sendCoffee: "☕️  Tặng Coffee: ",
+    newVersion: "🚀 BẢN MỚI (v{version}) vừa hạ cánh!",
+    updateCommand: "💡 Gõ liền: npm install -g nport@latest",
+    
+    // Cleanup
+    tunnelShutdown: "🛑 Đã tới giờ 'chốt' deal rồi cả nhà ơi...",
+    cleaningUp: "Đang dọn dẹp chiến trường... 🧹",
+    cleanupDone: "Xịn xò! Đã dọn xong rồi nè.",
+    cleanupFailed: "Oằn trời, dọn không nổi!",
+    subdomainReleased: "Subdomain...   Xí xoá! Tạm biệt nhé 🗑️✨",
+    serverBusy: "(Có thể server đang bận order trà sữa)",
+    
+    // Goodbye
+    goodbyeTitle: "👋 GẶP LẠI BẠN Ở ĐƯỜNG BĂNG KHÁC...",
+    goodbyeMessage: "Cảm ơn đã quẩy NPort! Lần sau chơi tiếp nha 😘",
+    website: "🌐 Sân chơi chính: ",
+    author: "👤 Nhà tài trợ: ",
+    changeLanguage: "🌍 Đổi ngôn ngữ: ",
+    changeLanguageHint: "nport --language",
+    
+    // Version
+    versionTitle: "NPort v{version}",
+    versionSubtitle: "Hơn cả Ngrok - Ma-de in Ziệt Nam",
+    versionLatest: "🎉 Chúc mừng! Đang cùng server với bản mới nhất!",
+    versionAvailable: "🌟 Vèo vèo: Có bản mới v{version} vừa cập bến!",
+    versionUpdate: "Update khẩn trương lẹ làng: ",
+    learnMore: "Khám phá thêm cho nóng: ",
+    
+    // Language selection
+    languagePrompt: "\n🌍 Chọn lựa ngôn ngữ ngay bên dưới nào!\n",
+    languageQuestion: "Chớp lấy một lựa chọn nha (1-2): ",
+    languageEnglish: "1. English (Chuẩn quốc tế!)",
+    languageVietnamese: "2. Tiếng Việt (Đỉnh của chóp)",
+    languageInvalid: "Ơ hơ, chọn sai rồi! Mặc định Tiếng Việt luôn cho nóng.",
+    languageSaved: "🎯 Xong rồi! Lưu ngôn ngữ thành công!",
+  }
+};
+
+// ============================================================================
+// Language Manager
+// ============================================================================
+
+class LanguageManager {
+  constructor() {
+    this.currentLanguage = "en";
+    this.availableLanguages = ["en", "vi"];
+  }
+
+  /**
+   * Get translation string with variable substitution
+   * @param {string} key - Translation key
+   * @param {object} vars - Variables to substitute
+   * @returns {string} Translated string
+   */
+  t(key, vars = {}) {
+    const translations = TRANSLATIONS[this.currentLanguage] || TRANSLATIONS.en;
+    let text = translations[key] || TRANSLATIONS.en[key] || key;
+    
+    // Replace variables like {port}, {version}, etc.
+    Object.keys(vars).forEach(varKey => {
+      text = text.replace(`{${varKey}}`, vars[varKey]);
+    });
+    
+    return text;
+  }
+
+  /**
+   * Load saved language preference
+   * @returns {string|null} Saved language code or null
+   */
+  loadLanguagePreference() {
+    const lang = configManager.getLanguage();
+    if (lang && this.availableLanguages.includes(lang)) {
+      return lang;
+    }
+    return null;
+  }
+
+  /**
+   * Save language preference
+   * @param {string} lang - Language code to save
+   */
+  saveLanguagePreference(lang) {
+    configManager.setLanguage(lang);
+  }
+
+  /**
+   * Set current language
+   * @param {string} lang - Language code
+   */
+  setLanguage(lang) {
+    if (this.availableLanguages.includes(lang)) {
+      this.currentLanguage = lang;
+      return true;
+    }
+    return false;
+  }
+
+  /**
+   * Get current language
+   * @returns {string} Current language code
+   */
+  getLanguage() {
+    return this.currentLanguage;
+  }
+
+  /**
+   * Prompt user to select language
+   * @returns {Promise<string>} Selected language code
+   */
+  async promptLanguageSelection() {
+    return new Promise((resolve) => {
+      const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout
+      });
+
+      console.log(this.t("languagePrompt"));
+      console.log(`   ${this.t("languageEnglish")}`);
+      console.log(`   ${this.t("languageVietnamese")}\n`);
+
+      rl.question(`${this.t("languageQuestion")}`, (answer) => {
+        rl.close();
+        
+        const choice = answer.trim();
+        let selectedLang = "en";
+        
+        if (choice === "1") {
+          selectedLang = "en";
+        } else if (choice === "2") {
+          selectedLang = "vi";
+        } else {
+          console.log(`\n${this.t("languageInvalid")}\n`);
+        }
+        
+        this.setLanguage(selectedLang);
+        this.saveLanguagePreference(selectedLang);
+        console.log(`${this.t("languageSaved")}\n`);
+        
+        resolve(selectedLang);
+      });
+    });
+  }
+
+  /**
+   * Initialize language - load from config or prompt user
+   * @param {string|null} cliLanguage - Language from CLI argument (or 'prompt' to force prompt)
+   * @returns {Promise<string>} Selected language code
+   */
+  async initialize(cliLanguage = null) {
+    // Priority 1: CLI argument with value (e.g., --language en)
+    if (cliLanguage && cliLanguage !== 'prompt' && this.setLanguage(cliLanguage)) {
+      this.saveLanguagePreference(cliLanguage);
+      return cliLanguage;
+    }
+
+    // Priority 2: Force prompt if --language flag without value
+    if (cliLanguage === 'prompt') {
+      return await this.promptLanguageSelection();
+    }
+
+    // Priority 3: Saved preference
+    const savedLang = this.loadLanguagePreference();
+    if (savedLang) {
+      this.setLanguage(savedLang);
+      return savedLang;
+    }
+
+    // Priority 4: Prompt user on first run
+    return await this.promptLanguageSelection();
+  }
+}
+
+// ============================================================================
+// Export singleton instance
+// ============================================================================
+
+export const lang = new LanguageManager();
+

package/src/state.js

@@ -0,0 +1,79 @@
+/**
+ * Application State Manager
+ * Manages tunnel state including connection info, process, and timers
+ */
+class TunnelState {
+  constructor() {
+    this.tunnelId = null;
+    this.subdomain = null;
+    this.port = null;
+    this.backendUrl = null;
+    this.tunnelProcess = null;
+    this.timeoutId = null;
+    this.connectionCount = 0;
+    this.startTime = null;
+    this.updateInfo = null;
+  }
+
+  setTunnel(tunnelId, subdomain, port, backendUrl = null) {
+    this.tunnelId = tunnelId;
+    this.subdomain = subdomain;
+    this.port = port;
+    this.backendUrl = backendUrl;
+    if (!this.startTime) {
+      this.startTime = Date.now();
+    }
+  }
+
+  setUpdateInfo(updateInfo) {
+    this.updateInfo = updateInfo;
+  }
+
+  setProcess(process) {
+    this.tunnelProcess = process;
+  }
+
+  setTimeout(timeoutId) {
+    this.timeoutId = timeoutId;
+  }
+
+  clearTimeout() {
+    if (this.timeoutId) {
+      clearTimeout(this.timeoutId);
+      this.timeoutId = null;
+    }
+  }
+
+  incrementConnection() {
+    this.connectionCount++;
+    return this.connectionCount;
+  }
+
+  hasTunnel() {
+    return this.tunnelId !== null;
+  }
+
+  hasProcess() {
+    return this.tunnelProcess && !this.tunnelProcess.killed;
+  }
+
+  getDurationSeconds() {
+    if (!this.startTime) return 0;
+    return (Date.now() - this.startTime) / 1000;
+  }
+
+  reset() {
+    this.clearTimeout();
+    this.tunnelId = null;
+    this.subdomain = null;
+    this.port = null;
+    this.backendUrl = null;
+    this.tunnelProcess = null;
+    this.connectionCount = 0;
+    this.startTime = null;
+    this.updateInfo = null;
+  }
+}
+
+export const state = new TunnelState();
+

package/src/tunnel.js

@@ -0,0 +1,116 @@
+import ora from "ora";
+import chalk from "chalk";
+import { CONFIG, PATHS, TUNNEL_TIMEOUT_MS } from "./config.js";
+import { state } from "./state.js";
+import { BinaryManager } from "./binary.js";
+import { APIClient } from "./api.js";
+import { VersionManager } from "./version.js";
+import { UI } from "./ui.js";
+import { analytics } from "./analytics.js";
+import { lang } from "./lang.js";
+
+/**
+ * Tunnel Orchestrator
+ * Main controller for tunnel lifecycle management
+ */
+export class TunnelOrchestrator {
+  static async start(config) {
+    state.setTunnel(null, config.subdomain, config.port, config.backendUrl);
+
+    // Initialize analytics
+    await analytics.initialize();
+
+    // Track CLI start
+    analytics.trackCliStart(config.port, config.subdomain, CONFIG.CURRENT_VERSION);
+
+    // Display UI
+    UI.displayStartupBanner(config.port);
+
+    // Check for updates
+    const updateInfo = await VersionManager.checkForUpdates();
+    state.setUpdateInfo(updateInfo);
+
+    // Validate binary
+    if (!BinaryManager.validate(PATHS.BIN_PATH)) {
+      analytics.trackTunnelError("binary_missing", "Cloudflared binary not found");
+      // Give analytics a moment to send before exiting
+      await new Promise(resolve => setTimeout(resolve, 100));
+      process.exit(1);
+    }
+
+    const spinner = ora(lang.t("creatingTunnel", { port: config.port })).start();
+
+    try {
+      // Create tunnel
+      const tunnel = await APIClient.createTunnel(config.subdomain, config.backendUrl);
+      state.setTunnel(tunnel.tunnelId, config.subdomain, config.port, config.backendUrl);
+
+      // Track successful tunnel creation
+      analytics.trackTunnelCreated(config.subdomain, config.port);
+
+      spinner.stop();
+      console.log(chalk.green(`   ${lang.t("tunnelLive")}`));
+      UI.displayTunnelSuccess(tunnel.url, config.port, updateInfo);
+
+      // Spawn cloudflared
+      const process = BinaryManager.spawn(
+        PATHS.BIN_PATH,
+        tunnel.tunnelToken,
+        config.port
+      );
+      state.setProcess(process);
+      BinaryManager.attachHandlers(process, spinner);
+
+      // Set timeout
+      const timeoutId = setTimeout(() => {
+        UI.displayTimeoutWarning();
+        this.cleanup("timeout");
+      }, TUNNEL_TIMEOUT_MS);
+      state.setTimeout(timeoutId);
+    } catch (error) {
+      // Track tunnel creation error
+      const errorType = error.message.includes("already taken") 
+        ? "subdomain_taken" 
+        : "tunnel_creation_failed";
+      analytics.trackTunnelError(errorType, error.message);
+
+      UI.displayError(error, spinner);
+      // Give analytics a moment to send before exiting
+      await new Promise(resolve => setTimeout(resolve, 100));
+      process.exit(1);
+    }
+  }
+
+  static async cleanup(reason = "manual") {
+    state.clearTimeout();
+
+    if (!state.hasTunnel()) {
+      process.exit(0);
+    }
+
+    UI.displayCleanupStart();
+
+    // Track tunnel shutdown with duration
+    const duration = state.getDurationSeconds();
+    analytics.trackTunnelShutdown(reason, duration);
+
+    try {
+      // Kill process
+      if (state.hasProcess()) {
+        state.tunnelProcess.kill();
+      }
+
+      // Delete tunnel
+      await APIClient.deleteTunnel(state.subdomain, state.tunnelId, state.backendUrl);
+      UI.displayCleanupSuccess();
+    } catch (err) {
+      UI.displayCleanupError();
+    }
+
+    // Give analytics a moment to send (non-blocking)
+    await new Promise(resolve => setTimeout(resolve, 100));
+
+    process.exit(0);
+  }
+}
+

package/src/ui.js

@@ -0,0 +1,103 @@
+import chalk from "chalk";
+import { CONFIG } from "./config.js";
+import { lang } from "./lang.js";
+
+/**
+ * UI Display Manager
+ * Handles all console output and user interface with multilingual support
+ */
+export class UI {
+  static displayProjectInfo() {
+    const line = "─".repeat(56);
+    const headerText = lang.t("header");
+    // Calculate proper padding (accounting for emojis which take visual space)
+    const visualLength = 59; // Target visual width
+    const padding = " ".repeat(Math.max(0, visualLength - headerText.length - 4));
+    
+    console.log(chalk.gray(`\n ╭${line}╮`));
+    console.log(chalk.cyan.bold(` │  ${headerText}`) + padding + chalk.gray("│"));
+    console.log(chalk.gray(` ╰${line}╯\n`));
+  }
+
+  static displayStartupBanner(port) {
+    this.displayProjectInfo();
+  }
+
+  static displayTunnelSuccess(url, port, updateInfo) {
+    console.log(); // Extra spacing
+    console.log(chalk.cyan.bold(`   👉  ${url}  👈\n`));
+    console.log(chalk.gray("   " + "─".repeat(54) + "\n"));
+    console.log(chalk.gray(`   ${lang.t("timeRemaining", { hours: CONFIG.TUNNEL_TIMEOUT_HOURS })}\n`));
+  }
+  
+  static displayFooter(updateInfo) {
+    console.log(chalk.gray("   " + "─".repeat(54) + "\n"));
+    console.log(chalk.yellow.bold(`   ${lang.t("footerTitle")}\n`));
+    console.log(chalk.gray(`      ${lang.t("footerSubtitle")}\n`));
+    console.log(chalk.cyan(`   ${lang.t("dropStar")}`) + chalk.white("https://github.com/tuanngocptn/nport"));
+    console.log(chalk.yellow(`   ${lang.t("sendCoffee")}`) + chalk.white("https://buymeacoffee.com/tuanngocptn"));
+    
+    if (updateInfo && updateInfo.shouldUpdate) {
+      console.log(chalk.red.bold(`\n   ${lang.t("newVersion", { version: updateInfo.latest })}`));
+      console.log(chalk.gray("      ") + chalk.cyan(lang.t("updateCommand")));
+    }
+    console.log();
+  }
+
+  static displayTimeoutWarning() {
+    console.log(
+      chalk.yellow(
+        `\n⏰ Tunnel has been running for ${CONFIG.TUNNEL_TIMEOUT_HOURS} hours.`
+      )
+    );
+    console.log(chalk.yellow("   Automatically shutting down..."));
+  }
+
+  static displayError(error, spinner = null) {
+    if (spinner) {
+      spinner.fail("Failed to connect to server.");
+    }
+    console.error(chalk.red(error.message));
+  }
+
+  static displayCleanupStart() {
+    console.log(chalk.red.bold(`\n\n   ${lang.t("tunnelShutdown")}\n`));
+    process.stdout.write(chalk.gray(`      ${lang.t("cleaningUp")}`));
+  }
+
+  static displayCleanupSuccess() {
+    console.log(chalk.green(lang.t("cleanupDone")));
+    console.log(chalk.gray(`      ${lang.t("subdomainReleased")}\n`));
+    this.displayGoodbye();
+  }
+
+  static displayCleanupError() {
+    console.log(chalk.red(lang.t("cleanupFailed")));
+    console.log(chalk.gray(`      ${lang.t("serverBusy")}\n`));
+    this.displayGoodbye();
+  }
+
+  static displayGoodbye() {
+    console.log(chalk.gray("   " + "─".repeat(54) + "\n"));
+    console.log(chalk.cyan.bold(`   ${lang.t("goodbyeTitle")}\n`));
+    console.log(chalk.gray(`      ${lang.t("goodbyeMessage")}\n`));
+    console.log(chalk.cyan(`      ${lang.t("website")}`) + chalk.white("https://nport.link"));
+    console.log(chalk.cyan(`      ${lang.t("author")}`) + chalk.white("Nick Pham (https://github.com/tuanngocptn)"));
+    console.log(chalk.cyan(`      ${lang.t("changeLanguage")}`) + chalk.yellow(lang.t("changeLanguageHint")));
+    console.log();
+  }
+
+  static displayVersion(current, updateInfo) {
+    console.log(chalk.cyan.bold(`\n${lang.t("versionTitle", { version: current })}`));
+    console.log(chalk.gray(`${lang.t("versionSubtitle")}\n`));
+    
+    if (updateInfo && updateInfo.shouldUpdate) {
+      console.log(chalk.yellow(lang.t("versionAvailable", { version: updateInfo.latest })));
+      console.log(chalk.cyan(lang.t("versionUpdate")) + chalk.white(`npm install -g nport@latest\n`));
+    } else {
+      console.log(chalk.green(`${lang.t("versionLatest")}\n`));
+    }
+    
+    console.log(chalk.gray(lang.t("learnMore")) + chalk.cyan("https://nport.link\n"));
+  }
+}

package/src/version.js

@@ -0,0 +1,56 @@
+import axios from "axios";
+import { CONFIG } from "./config.js";
+import { analytics } from "./analytics.js";
+
+/**
+ * Version Manager
+ * Handles version checking and update notifications
+ */
+export class VersionManager {
+  static async checkForUpdates() {
+    try {
+      const response = await axios.get(
+        `https://registry.npmjs.org/${CONFIG.PACKAGE_NAME}/latest`,
+        { timeout: CONFIG.UPDATE_CHECK_TIMEOUT }
+      );
+
+      const latestVersion = response.data.version;
+      const shouldUpdate =
+        this.compareVersions(latestVersion, CONFIG.CURRENT_VERSION) > 0;
+
+      // Track update notification if available
+      if (shouldUpdate) {
+        analytics.trackUpdateAvailable(CONFIG.CURRENT_VERSION, latestVersion);
+      }
+
+      return {
+        current: CONFIG.CURRENT_VERSION,
+        latest: latestVersion,
+        shouldUpdate,
+      };
+    } catch (error) {
+      // Silently fail if can't check for updates
+      return null;
+    }
+  }
+
+  static compareVersions(v1, v2) {
+    const parts1 = v1.split(".").map(Number);
+    const parts2 = v2.split(".").map(Number);
+
+    // Compare up to the maximum length of both version arrays
+    const maxLength = Math.max(parts1.length, parts2.length);
+
+    for (let i = 0; i < maxLength; i++) {
+      // Treat missing parts as 0 (e.g., "1.0" is "1.0.0")
+      const part1 = parts1[i] || 0;
+      const part2 = parts2[i] || 0;
+
+      if (part1 > part2) return 1;
+      if (part1 < part2) return -1;
+    }
+
+    return 0;
+  }
+}
+