nport 2.0.7 → 2.1.0

package/src/analytics.js

@@ -1,265 +0,0 @@
-// ============================================================================
-// Firebase Analytics for CLI
-// Using Google Analytics 4 Measurement Protocol
-// ============================================================================
-
-import axios from "axios";
-import { createHash, randomUUID } from "crypto";
-import os from "os";
-import fs from "fs";
-import path from "path";
-import { fileURLToPath } from "url";
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(path.dirname(__filename));
-
-// Firebase/GA4 Configuration (from website/home.html)
-// Full Firebase config for reference (if needed for future features)
-const FIREBASE_WEB_CONFIG = {
-  apiKey: "AIzaSyArRxHZJUt4o2RxiLqX1yDSkuUd6ZFy45I",
-  authDomain: "nport-link.firebaseapp.com",
-  projectId: "nport-link",
-  storageBucket: "nport-link.firebasestorage.app",
-  messagingSenderId: "515584605320",
-  appId: "1:515584605320:web:88daabc8d77146c6e7f33d",
-  measurementId: "G-8MYXZL6PGD"
-};
-
-// Analytics-specific config (for GA4 Measurement Protocol)
-const FIREBASE_CONFIG = {
-  measurementId: FIREBASE_WEB_CONFIG.measurementId,
-  apiSecret: process.env.NPORT_ANALYTICS_SECRET || "YOUR_API_SECRET_HERE", // Get from Firebase Console
-};
-
-// Analytics Configuration
-const ANALYTICS_CONFIG = {
-  enabled: true, // Can be disabled by environment variable
-  debug: process.env.NPORT_DEBUG === "true",
-  timeout: 2000, // Don't block CLI for too long
-  userIdFile: path.join(os.homedir(), ".nport", "analytics-id"),
-};
-
-// ============================================================================
-// Analytics Manager
-// ============================================================================
-
-class AnalyticsManager {
-  constructor() {
-    this.userId = null;
-    this.sessionId = null;
-    this.disabled = false;
-    
-    // Disable analytics if environment variable is set
-    if (process.env.NPORT_ANALYTICS === "false") {
-      this.disabled = true;
-    }
-  }
-
-  /**
-   * Initialize analytics - must be called before tracking
-   */
-  async initialize() {
-    if (this.disabled) return;
-
-    // Check if API secret is configured
-    if (!FIREBASE_CONFIG.apiSecret || FIREBASE_CONFIG.apiSecret === "YOUR_API_SECRET_HERE") {
-      if (ANALYTICS_CONFIG.debug) {
-        console.warn("[Analytics] API secret not configured. Analytics disabled.");
-        console.warn("[Analytics] Set NPORT_ANALYTICS_SECRET environment variable.");
-      }
-      this.disabled = true;
-      return;
-    }
-
-    try {
-      this.userId = await this.getUserId();
-      this.sessionId = this.generateSessionId();
-      
-      if (ANALYTICS_CONFIG.debug) {
-        console.log("[Analytics] Initialized successfully");
-        console.log("[Analytics] User ID:", this.userId.substring(0, 8) + "...");
-      }
-    } catch (error) {
-      if (ANALYTICS_CONFIG.debug) {
-        console.error("[Analytics] Initialization failed:", error.message);
-      }
-      this.disabled = true;
-    }
-  }
-
-  /**
-   * Get or create a persistent user ID
-   */
-  async getUserId() {
-    try {
-      // Ensure .nport directory exists
-      const configDir = path.join(os.homedir(), ".nport");
-      if (!fs.existsSync(configDir)) {
-        fs.mkdirSync(configDir, { recursive: true });
-      }
-
-      // Try to read existing user ID
-      if (fs.existsSync(ANALYTICS_CONFIG.userIdFile)) {
-        const userId = fs.readFileSync(ANALYTICS_CONFIG.userIdFile, "utf8").trim();
-        if (userId) return userId;
-      }
-
-      // Generate new anonymous user ID
-      const userId = this.generateAnonymousId();
-      
-      // Save for future use
-      fs.writeFileSync(ANALYTICS_CONFIG.userIdFile, userId, "utf8");
-      
-      return userId;
-    } catch (error) {
-      // If file operations fail, use session-based ID
-      return this.generateAnonymousId();
-    }
-  }
-
-  /**
-   * Generate anonymous user ID based on machine characteristics
-   */
-  generateAnonymousId() {
-    const machineId = [
-      os.hostname(),
-      os.platform(),
-      os.arch(),
-      os.homedir(),
-    ].join("-");
-    
-    return createHash("sha256").update(machineId).digest("hex").substring(0, 32);
-  }
-
-  /**
-   * Generate session ID
-   */
-  generateSessionId() {
-    return randomUUID();
-  }
-
-  /**
-   * Track an event
-   */
-  async trackEvent(eventName, params = {}) {
-    if (this.disabled || !ANALYTICS_CONFIG.enabled) return;
-
-    try {
-      const payload = this.buildPayload(eventName, params);
-      
-      // Send to GA4 Measurement Protocol (non-blocking)
-      axios.post(
-        `https://www.google-analytics.com/mp/collect?measurement_id=${FIREBASE_CONFIG.measurementId}&api_secret=${FIREBASE_CONFIG.apiSecret}`,
-        payload,
-        {
-          timeout: ANALYTICS_CONFIG.timeout,
-          headers: { "Content-Type": "application/json" },
-        }
-      ).catch((error) => {
-        // Silently fail - don't interrupt CLI operations
-        if (ANALYTICS_CONFIG.debug) {
-          console.error("[Analytics] Failed to send event:", error.message);
-        }
-      });
-
-      if (ANALYTICS_CONFIG.debug) {
-        console.log("[Analytics] Event tracked:", eventName, params);
-      }
-    } catch (error) {
-      // Silently fail
-      if (ANALYTICS_CONFIG.debug) {
-        console.error("[Analytics] Error tracking event:", error.message);
-      }
-    }
-  }
-
-  /**
-   * Build GA4 Measurement Protocol payload
-   */
-  buildPayload(eventName, params) {
-    return {
-      client_id: this.userId,
-      events: [
-        {
-          name: eventName,
-          params: {
-            session_id: this.sessionId,
-            engagement_time_msec: "100",
-            ...this.getSystemInfo(),
-            ...params,
-          },
-        },
-      ],
-    };
-  }
-
-  /**
-   * Get system information for context
-   */
-  getSystemInfo() {
-    return {
-      os_platform: os.platform(),
-      os_version: os.release(),
-      os_arch: os.arch(),
-      node_version: process.version,
-    };
-  }
-
-  /**
-   * Track CLI start
-   */
-  async trackCliStart(port, subdomain, version) {
-    await this.trackEvent("cli_start", {
-      port: String(port),
-      has_custom_subdomain: subdomain && !subdomain.startsWith("user-"),
-      cli_version: version,
-    });
-  }
-
-  /**
-   * Track tunnel creation
-   */
-  async trackTunnelCreated(subdomain, port) {
-    await this.trackEvent("tunnel_created", {
-      subdomain_type: subdomain.startsWith("user-") ? "random" : "custom",
-      port: String(port),
-    });
-  }
-
-  /**
-   * Track tunnel error
-   */
-  async trackTunnelError(errorType, errorMessage) {
-    await this.trackEvent("tunnel_error", {
-      error_type: errorType,
-      error_message: errorMessage.substring(0, 100), // Limit length
-    });
-  }
-
-  /**
-   * Track tunnel shutdown
-   */
-  async trackTunnelShutdown(reason, durationSeconds) {
-    await this.trackEvent("tunnel_shutdown", {
-      shutdown_reason: reason, // "manual", "timeout", "error"
-      duration_seconds: String(Math.floor(durationSeconds)),
-    });
-  }
-
-  /**
-   * Track CLI update notification shown
-   */
-  async trackUpdateAvailable(currentVersion, latestVersion) {
-    await this.trackEvent("update_available", {
-      current_version: currentVersion,
-      latest_version: latestVersion,
-    });
-  }
-}
-
-// ============================================================================
-// Export singleton instance
-// ============================================================================
-
-export const analytics = new AnalyticsManager();
-

package/src/api.js

@@ -1,104 +0,0 @@
-import axios from "axios";
-import chalk from "chalk";
-import { CONFIG } from "./config.js";
-import { state } from "./state.js";
-
-/**
- * API Client
- * Handles communication with the NPort backend service
- */
-export class APIClient {
-  static async createTunnel(subdomain, backendUrl = null) {
-    const url = backendUrl || CONFIG.BACKEND_URL;
-    try {
-      const { data } = await axios.post(url, { subdomain });
-
-      if (!data.success) {
-        throw new Error(data.error || "Unknown error from backend");
-      }
-
-      return {
-        tunnelId: data.tunnelId,
-        tunnelToken: data.tunnelToken,
-        url: data.url,
-      };
-    } catch (error) {
-      throw this.handleError(error, subdomain);
-    }
-  }
-
-  static async deleteTunnel(subdomain, tunnelId, backendUrl = null) {
-    const url = backendUrl || CONFIG.BACKEND_URL;
-    await axios.delete(url, {
-      data: { subdomain, tunnelId },
-    });
-  }
-
-  static handleError(error, subdomain) {
-    if (error.response?.data?.error) {
-      const errorMsg = error.response.data.error;
-
-      // Check for protected subdomain (reserved for production services)
-      if (errorMsg.includes("SUBDOMAIN_PROTECTED:")) {
-        return new Error(
-          `Subdomain "${subdomain}" is already taken or in use.\n\n` +
-            chalk.yellow(`💡 Try one of these options:\n`) +
-            chalk.gray(`   1. Choose a different subdomain: `) +
-            chalk.cyan(`nport ${state.port || CONFIG.DEFAULT_PORT} -s ${subdomain}-v2\n`) +
-            chalk.gray(`   2. Use a random subdomain:       `) +
-            chalk.cyan(`nport ${state.port || CONFIG.DEFAULT_PORT}\n`) +
-            chalk.gray(
-              `   3. Wait a few minutes and retry if you just stopped a tunnel with this name`
-            )
-        );
-      }
-
-      // Check for subdomain in use (active tunnel)
-      if (
-        errorMsg.includes("SUBDOMAIN_IN_USE:") ||
-        errorMsg.includes("currently in use") ||
-        errorMsg.includes("already exists and is currently active")
-      ) {
-        return new Error(
-          chalk.red(`✗ Subdomain "${subdomain}" is already in use!\n\n`) +
-            chalk.yellow(`💡 This subdomain is currently being used by another active tunnel.\n\n`) +
-            chalk.white(`Choose a different subdomain:\n`) +
-            chalk.gray(`   1. Add a suffix:     `) +
-            chalk.cyan(`nport ${state.port || CONFIG.DEFAULT_PORT} -s ${subdomain}-2\n`) +
-            chalk.gray(`   2. Try a variation:  `) +
-            chalk.cyan(`nport ${state.port || CONFIG.DEFAULT_PORT} -s my-${subdomain}\n`) +
-            chalk.gray(`   3. Use random name:  `) +
-            chalk.cyan(`nport ${state.port || CONFIG.DEFAULT_PORT}\n`)
-        );
-      }
-
-      // Check for duplicate tunnel error (other Cloudflare errors)
-      if (
-        errorMsg.includes("already have a tunnel") ||
-        errorMsg.includes("[1013]")
-      ) {
-        return new Error(
-          `Subdomain "${subdomain}" is already taken or in use.\n\n` +
-            chalk.yellow(`💡 Try one of these options:\n`) +
-            chalk.gray(`   1. Choose a different subdomain: `) +
-            chalk.cyan(`nport ${state.port || CONFIG.DEFAULT_PORT} -s ${subdomain}-v2\n`) +
-            chalk.gray(`   2. Use a random subdomain:       `) +
-            chalk.cyan(`nport ${state.port || CONFIG.DEFAULT_PORT}\n`) +
-            chalk.gray(
-              `   3. Wait a few minutes and retry if you just stopped a tunnel with this name`
-            )
-        );
-      }
-
-      return new Error(`Backend Error: ${errorMsg}`);
-    }
-
-    if (error.response) {
-      const errorMsg = JSON.stringify(error.response.data, null, 2);
-      return new Error(`Backend Error: ${errorMsg}`);
-    }
-
-    return error;
-  }
-}
-

package/src/args.js

@@ -1,122 +0,0 @@
-import { CONFIG } from "./config.js";
-
-/**
- * Command Line Argument Parser
- * Handles parsing of CLI arguments for port, subdomain, language, and backend URL
- */
-export class ArgumentParser {
-  static parse(argv) {
-    const port = this.parsePort(argv);
-    const subdomain = this.parseSubdomain(argv);
-    const language = this.parseLanguage(argv);
-    const backendUrl = this.parseBackendUrl(argv);
-    const setBackend = this.parseSetBackend(argv);
-    return { port, subdomain, language, backendUrl, setBackend };
-  }
-
-  static parsePort(argv) {
-    const portArg = parseInt(argv[0]);
-    return portArg || CONFIG.DEFAULT_PORT;
-  }
-
-  static parseSubdomain(argv) {
-    // Try all subdomain formats
-    const formats = [
-      () => this.findFlagWithEquals(argv, "--subdomain="),
-      () => this.findFlagWithEquals(argv, "-s="),
-      () => this.findFlagWithValue(argv, "--subdomain"),
-      () => this.findFlagWithValue(argv, "-s"),
-    ];
-
-    for (const format of formats) {
-      const subdomain = format();
-      if (subdomain) return subdomain;
-    }
-
-    return this.generateRandomSubdomain();
-  }
-
-  static parseLanguage(argv) {
-    // Check if --language flag exists without value (to trigger prompt)
-    if (argv.includes('--language') || argv.includes('--lang') || argv.includes('-l')) {
-      const langIndex = argv.indexOf('--language') !== -1 ? argv.indexOf('--language') :
-                        argv.indexOf('--lang') !== -1 ? argv.indexOf('--lang') :
-                        argv.indexOf('-l');
-      
-      // If flag is present but next arg is another flag or doesn't exist, return 'prompt'
-      const nextArg = argv[langIndex + 1];
-      if (!nextArg || nextArg.startsWith('-')) {
-        return 'prompt';
-      }
-    }
-
-    // Try language flag formats: --language=en, --lang=en, -l en
-    const formats = [
-      () => this.findFlagWithEquals(argv, "--language="),
-      () => this.findFlagWithEquals(argv, "--lang="),
-      () => this.findFlagWithEquals(argv, "-l="),
-      () => this.findFlagWithValue(argv, "--language"),
-      () => this.findFlagWithValue(argv, "--lang"),
-      () => this.findFlagWithValue(argv, "-l"),
-    ];
-
-    for (const format of formats) {
-      const language = format();
-      if (language) return language;
-    }
-
-    return null; // No language specified
-  }
-
-  static parseBackendUrl(argv) {
-    // Try backend URL flag formats: --backend=url, --backend url, -b url
-    const formats = [
-      () => this.findFlagWithEquals(argv, "--backend="),
-      () => this.findFlagWithEquals(argv, "-b="),
-      () => this.findFlagWithValue(argv, "--backend"),
-      () => this.findFlagWithValue(argv, "-b"),
-    ];
-
-    for (const format of formats) {
-      const url = format();
-      if (url) return url;
-    }
-
-    return null; // No backend URL specified
-  }
-
-  static parseSetBackend(argv) {
-    // Try set-backend flag formats: --set-backend=url, --set-backend url
-    const formats = [
-      () => this.findFlagWithEquals(argv, "--set-backend="),
-      () => this.findFlagWithValue(argv, "--set-backend"),
-    ];
-
-    for (const format of formats) {
-      const url = format();
-      if (url) return url;
-    }
-
-    // Check if --set-backend flag exists without value (to clear)
-    if (argv.includes('--set-backend')) {
-      return 'clear';
-    }
-
-    return null; // No set-backend specified
-  }
-
-  static findFlagWithEquals(argv, flag) {
-    const arg = argv.find((a) => a.startsWith(flag));
-    return arg ? arg.split("=")[1] : null;
-  }
-
-  static findFlagWithValue(argv, flag) {
-    const index = argv.indexOf(flag);
-    return index !== -1 && argv[index + 1] ? argv[index + 1] : null;
-  }
-
-  static generateRandomSubdomain() {
-    return `${CONFIG.SUBDOMAIN_PREFIX}${Math.floor(Math.random() * 10000)}`;
-  }
-}
-