nport 2.1.0 → 2.1.1

package/dist/state.js

@@ -0,0 +1,139 @@
+/**
+ * Application State Manager
+ *
+ * Singleton class that manages all runtime state for the tunnel.
+ */
+class TunnelState {
+    tunnelId = null;
+    subdomain = null;
+    port = null;
+    backendUrl = null;
+    tunnelProcess = null;
+    timeoutId = null;
+    connectionCount = 0;
+    startTime = null;
+    updateInfo = null;
+    // Network issue tracking
+    networkIssueCount = 0;
+    lastNetworkWarningTime = 0;
+    networkWarningShown = false;
+    /**
+     * Sets the tunnel connection information.
+     */
+    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();
+        }
+    }
+    /**
+     * Stores version update information.
+     */
+    setUpdateInfo(updateInfo) {
+        this.updateInfo = updateInfo;
+    }
+    /**
+     * Stores reference to the cloudflared child process.
+     */
+    setProcess(process) {
+        this.tunnelProcess = process;
+    }
+    /**
+     * Stores the auto-cleanup timeout ID.
+     */
+    setTimeout(timeoutId) {
+        this.timeoutId = timeoutId;
+    }
+    /**
+     * Clears the auto-cleanup timeout if set.
+     */
+    clearTimeout() {
+        if (this.timeoutId) {
+            clearTimeout(this.timeoutId);
+            this.timeoutId = null;
+        }
+    }
+    /**
+     * Increments the connection count and returns the new value.
+     */
+    incrementConnection() {
+        this.connectionCount++;
+        return this.connectionCount;
+    }
+    /**
+     * Checks if a tunnel is currently active.
+     */
+    hasTunnel() {
+        return this.tunnelId !== null;
+    }
+    /**
+     * Checks if the cloudflared process is running.
+     */
+    hasProcess() {
+        return this.tunnelProcess !== null && !this.tunnelProcess.killed;
+    }
+    /**
+     * Gets the tunnel duration in seconds.
+     */
+    getDurationSeconds() {
+        if (!this.startTime)
+            return 0;
+        return (Date.now() - this.startTime) / 1000;
+    }
+    /**
+     * Increments the network issue counter.
+     */
+    incrementNetworkIssue() {
+        this.networkIssueCount++;
+        return this.networkIssueCount;
+    }
+    /**
+     * Resets the network issue counter.
+     */
+    resetNetworkIssues() {
+        this.networkIssueCount = 0;
+    }
+    /**
+     * Determines if a network warning should be shown.
+     */
+    shouldShowNetworkWarning(threshold, cooldown) {
+        const now = Date.now();
+        if (this.networkIssueCount >= threshold &&
+            now - this.lastNetworkWarningTime > cooldown) {
+            this.lastNetworkWarningTime = now;
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Sets whether a network warning has been shown.
+     */
+    setNetworkWarningShown(value) {
+        this.networkWarningShown = value;
+    }
+    /**
+     * Resets all state to initial values.
+     */
+    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;
+        this.networkIssueCount = 0;
+        this.lastNetworkWarningTime = 0;
+        this.networkWarningShown = false;
+    }
+}
+/**
+ * Singleton instance
+ */
+export const state = new TunnelState();
+//# sourceMappingURL=state.js.map

package/dist/state.js.map

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

package/dist/tunnel.d.ts

@@ -0,0 +1,16 @@
+import type { TunnelConfig, ShutdownReason } from './types/index.js';
+/**
+ * Tunnel Orchestrator
+ *
+ * Main controller for the entire tunnel lifecycle.
+ */
+export declare class TunnelOrchestrator {
+    /**
+     * Starts the tunnel creation process.
+     */
+    static start(config: TunnelConfig): Promise<void>;
+    /**
+     * Gracefully shuts down the tunnel.
+     */
+    static cleanup(reason?: ShutdownReason): Promise<void>;
+}

package/dist/tunnel.js

@@ -0,0 +1,101 @@
+import ora from 'ora';
+import chalk from 'chalk';
+import fs from 'fs';
+import { CONFIG, PATHS, TUNNEL_TIMEOUT_MS } from './config.js';
+import { state } from './state.js';
+import { BinaryManager } from './binary.js';
+import { ensureCloudflared } from './bin-manager.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 the entire tunnel lifecycle.
+ */
+export class TunnelOrchestrator {
+    /**
+     * Starts the tunnel creation process.
+     */
+    static async start(config) {
+        state.setTunnel(null, config.subdomain, config.port, config.backendUrl);
+        await analytics.initialize();
+        analytics.trackCliStart(config.port, config.subdomain, CONFIG.CURRENT_VERSION);
+        UI.displayStartupBanner(config.port);
+        const updateInfo = await VersionManager.checkForUpdates();
+        state.setUpdateInfo(updateInfo);
+        // Check if binary exists, download if missing
+        if (!fs.existsSync(PATHS.BIN_PATH)) {
+            console.log(chalk.yellow('\n📦 Cloudflared binary not found. Downloading...\n'));
+            try {
+                await ensureCloudflared();
+            }
+            catch (error) {
+                analytics.trackTunnelError('binary_download_failed', error.message);
+                console.error(chalk.red(`\n❌ Failed to download cloudflared: ${error.message}`));
+                process.exit(1);
+            }
+        }
+        if (!BinaryManager.validate(PATHS.BIN_PATH)) {
+            analytics.trackTunnelError('binary_missing', 'Cloudflared binary not found');
+            await new Promise(resolve => setTimeout(resolve, 100));
+            process.exit(1);
+        }
+        const spinner = ora(lang.t('creatingTunnel', { port: config.port })).start();
+        try {
+            const tunnel = await APIClient.createTunnel(config.subdomain, config.backendUrl);
+            state.setTunnel(tunnel.tunnelId, config.subdomain, config.port, config.backendUrl);
+            analytics.trackTunnelCreated(config.subdomain, config.port);
+            spinner.stop();
+            console.log(chalk.green(`   ${lang.t('tunnelLive')}`));
+            UI.displayTunnelSuccess(tunnel.url, config.port, updateInfo);
+            const childProcess = BinaryManager.spawn(PATHS.BIN_PATH, tunnel.tunnelToken, config.port);
+            state.setProcess(childProcess);
+            BinaryManager.attachHandlers(childProcess, spinner);
+            const timeoutId = setTimeout(() => {
+                UI.displayTimeoutWarning();
+                this.cleanup('timeout');
+            }, TUNNEL_TIMEOUT_MS);
+            state.setTimeout(timeoutId);
+        }
+        catch (error) {
+            const err = error;
+            const errorType = err.message.includes('already taken')
+                ? 'subdomain_taken'
+                : 'tunnel_creation_failed';
+            analytics.trackTunnelError(errorType, err.message);
+            UI.displayError(err, spinner);
+            await new Promise(resolve => setTimeout(resolve, 100));
+            process.exit(1);
+        }
+    }
+    /**
+     * Gracefully shuts down the tunnel.
+     */
+    static async cleanup(reason = 'manual') {
+        state.clearTimeout();
+        if (!state.hasTunnel()) {
+            process.exit(0);
+        }
+        UI.displayCleanupStart();
+        const duration = state.getDurationSeconds();
+        analytics.trackTunnelShutdown(reason, duration);
+        try {
+            if (state.hasProcess() && state.tunnelProcess) {
+                state.tunnelProcess.kill();
+            }
+            if (state.subdomain && state.tunnelId) {
+                await APIClient.deleteTunnel(state.subdomain, state.tunnelId, state.backendUrl);
+            }
+            UI.displayCleanupSuccess();
+        }
+        catch {
+            UI.displayCleanupError();
+        }
+        await new Promise(resolve => setTimeout(resolve, 100));
+        process.exit(0);
+    }
+}
+//# sourceMappingURL=tunnel.js.map

package/dist/tunnel.js.map

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

package/dist/types/analytics.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Analytics type definitions
+ *
+ * These types define the structure of analytics events
+ * and tracking data.
+ */
+/**
+ * Base analytics event
+ */
+export interface AnalyticsEvent {
+    /** Event name */
+    name: string;
+    /** Event parameters */
+    params: Record<string, string | number | boolean>;
+    /** Timestamp when event occurred */
+    timestamp?: number;
+}
+/**
+ * CLI start event parameters
+ */
+export interface CliStartEventParams {
+    /** Port being tunneled */
+    port: string;
+    /** Whether a custom subdomain was provided */
+    has_custom_subdomain: boolean;
+    /** CLI version */
+    cli_version: string;
+}
+/**
+ * Tunnel created event parameters
+ */
+export interface TunnelCreatedEventParams {
+    /** Type of subdomain (random or custom) */
+    subdomain_type: 'random' | 'custom';
+    /** Port being tunneled */
+    port: string;
+}
+/**
+ * Tunnel error event parameters
+ */
+export interface TunnelErrorEventParams {
+    /** Type of error */
+    error_type: string;
+    /** Error message (truncated) */
+    error_message: string;
+}
+/**
+ * Tunnel shutdown event parameters
+ */
+export interface TunnelShutdownEventParams {
+    /** Reason for shutdown */
+    shutdown_reason: 'manual' | 'timeout' | 'error';
+    /** Duration in seconds */
+    duration_seconds: string;
+}
+/**
+ * Update available event parameters
+ */
+export interface UpdateAvailableEventParams {
+    /** Current version */
+    current_version: string;
+    /** Latest version */
+    latest_version: string;
+}
+/**
+ * System information for analytics context
+ */
+export interface SystemInfo {
+    /** Operating system platform */
+    os_platform: string;
+    /** OS version */
+    os_version: string;
+    /** CPU architecture */
+    os_arch: string;
+    /** Node.js version */
+    node_version: string;
+}
+/**
+ * GA4 Measurement Protocol payload
+ */
+export interface GA4Payload {
+    /** Client ID (user identifier) */
+    client_id: string;
+    /** Array of events */
+    events: Array<{
+        /** Event name */
+        name: string;
+        /** Event parameters */
+        params: Record<string, string | number | boolean>;
+    }>;
+}

package/dist/types/analytics.js

@@ -0,0 +1,8 @@
+/**
+ * Analytics type definitions
+ *
+ * These types define the structure of analytics events
+ * and tracking data.
+ */
+export {};
+//# sourceMappingURL=analytics.js.map

package/dist/types/analytics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.js","sourceRoot":"","sources":["../../src/types/analytics.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/types/config.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Configuration type definitions
+ *
+ * These types define the structure of application configuration,
+ * user preferences, and runtime settings.
+ */
+/**
+ * Parsed command-line arguments
+ */
+export interface ParsedArguments {
+    /** Local port to tunnel (default: 8080) */
+    port: number;
+    /** Subdomain to use (generated if not provided) */
+    subdomain: string;
+    /** Language code, 'prompt', or null */
+    language: string | null;
+    /** Custom backend URL or null */
+    backendUrl: string | null;
+    /** Backend URL to save, 'clear', or null */
+    setBackend: string | null;
+}
+/**
+ * User configuration stored in ~/.nport/config.json
+ */
+export interface UserConfig {
+    /** Preferred language code (e.g., "en", "vi") */
+    language?: string;
+    /** Custom backend URL */
+    backendUrl?: string;
+}
+/**
+ * Application constants configuration
+ */
+export interface AppConfig {
+    /** npm package name */
+    PACKAGE_NAME: string;
+    /** Current package version */
+    CURRENT_VERSION: string;
+    /** Backend API URL */
+    BACKEND_URL: string;
+    /** Default port if not specified */
+    DEFAULT_PORT: number;
+    /** Prefix for random subdomains */
+    SUBDOMAIN_PREFIX: string;
+    /** Auto-cleanup timeout in hours */
+    TUNNEL_TIMEOUT_HOURS: number;
+    /** Timeout for npm version check in ms */
+    UPDATE_CHECK_TIMEOUT: number;
+}
+/**
+ * Platform-specific configuration
+ */
+export interface PlatformConfig {
+    /** True if running on Windows */
+    IS_WINDOWS: boolean;
+    /** Binary filename ("cloudflared" or "cloudflared.exe") */
+    BIN_NAME: string;
+}
+/**
+ * File system paths configuration
+ */
+export interface PathsConfig {
+    /** Directory containing the cloudflared binary */
+    BIN_DIR: string;
+    /** Full path to the cloudflared binary */
+    BIN_PATH: string;
+}
+/**
+ * Log pattern categories for filtering cloudflared output
+ */
+export interface LogPatterns {
+    /** Patterns indicating successful connection */
+    readonly SUCCESS: readonly string[];
+    /** Patterns indicating critical errors */
+    readonly ERROR: readonly string[];
+    /** Patterns for network connectivity issues */
+    readonly NETWORK_WARNING: readonly string[];
+    /** Patterns for harmless messages to suppress */
+    readonly IGNORE: readonly string[];
+}
+/**
+ * Network warning display configuration
+ */
+export interface NetworkConfig {
+    /** Number of errors before showing warning */
+    WARNING_THRESHOLD: number;
+    /** Minimum ms between warnings */
+    WARNING_COOLDOWN: number;
+}

package/dist/types/config.js

@@ -0,0 +1,8 @@
+/**
+ * Configuration type definitions
+ *
+ * These types define the structure of application configuration,
+ * user preferences, and runtime settings.
+ */
+export {};
+//# sourceMappingURL=config.js.map

package/dist/types/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/types/i18n.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Internationalization type definitions
+ */
+/**
+ * Supported language codes
+ */
+export type LanguageCode = 'en' | 'vi';
+/**
+ * Translation keys used in the application
+ */
+export interface TranslationKeys {
+    header: string;
+    creatingTunnel: string;
+    checkingUpdates: string;
+    tunnelLive: string;
+    connection1: string;
+    connection2: string;
+    timeRemaining: string;
+    footerTitle: string;
+    footerSubtitle: string;
+    dropStar: string;
+    sendCoffee: string;
+    newVersion: string;
+    updateCommand: string;
+    tunnelShutdown: string;
+    cleaningUp: string;
+    cleanupDone: string;
+    cleanupFailed: string;
+    subdomainReleased: string;
+    serverBusy: string;
+    goodbyeTitle: string;
+    goodbyeMessage: string;
+    website: string;
+    author: string;
+    changeLanguage: string;
+    changeLanguageHint: string;
+    versionTitle: string;
+    versionSubtitle: string;
+    versionLatest: string;
+    versionAvailable: string;
+    versionUpdate: string;
+    learnMore: string;
+    languagePrompt: string;
+    languageQuestion: string;
+    languageEnglish: string;
+    languageVietnamese: string;
+    languageInvalid: string;
+    languageSaved: string;
+    networkIssueTitle: string;
+    networkIssueDesc: string;
+    networkIssueTunnel: string;
+    networkIssueReasons: string;
+    networkIssueReason1: string;
+    networkIssueReason2: string;
+    networkIssueReason3: string;
+    networkIssueFix: string;
+    networkIssueFix1: string;
+    networkIssueFix2: string;
+    networkIssueFix3: string;
+    networkIssueFix4: string;
+    networkIssueIgnore: string;
+}
+/**
+ * Translation dictionary for all languages
+ */
+export type Translations = Record<LanguageCode, TranslationKeys>;
+/**
+ * Variables that can be substituted in translation strings
+ */
+export interface TranslationVariables {
+    port?: number;
+    hours?: number;
+    version?: string;
+    [key: string]: string | number | undefined;
+}

package/dist/types/i18n.js

@@ -0,0 +1,5 @@
+/**
+ * Internationalization type definitions
+ */
+export {};
+//# sourceMappingURL=i18n.js.map

package/dist/types/i18n.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.js","sourceRoot":"","sources":["../../src/types/i18n.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/types/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * NPort - Shared Types
+ *
+ * Central export for all type definitions used across the application.
+ */
+export type { TunnelConfig, TunnelResponse, ApiResponse, CreateTunnelApiResponse, TunnelState, ShutdownReason, TunnelEvent, } from './tunnel.js';
+export type { ParsedArguments, UserConfig, AppConfig, PlatformConfig, PathsConfig, LogPatterns, NetworkConfig, } from './config.js';
+export type { AnalyticsEvent, CliStartEventParams, TunnelCreatedEventParams, TunnelErrorEventParams, TunnelShutdownEventParams, UpdateAvailableEventParams, SystemInfo, GA4Payload, } from './analytics.js';
+export type { UpdateCheckResult, NpmPackageInfo, } from './version.js';
+export type { LanguageCode, TranslationKeys, Translations, TranslationVariables, } from './i18n.js';

package/dist/types/index.js

@@ -0,0 +1,7 @@
+/**
+ * NPort - Shared Types
+ *
+ * Central export for all type definitions used across the application.
+ */
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/types/tunnel.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Tunnel-related type definitions
+ *
+ * These types define the data structures used for tunnel creation,
+ * management, and communication between CLI and backend.
+ */
+/**
+ * Configuration for creating a new tunnel
+ */
+export interface TunnelConfig {
+    /** Local port to tunnel (e.g., 3000) */
+    port: number;
+    /** Subdomain to use (e.g., "myapp" for myapp.nport.link) */
+    subdomain: string;
+    /** Custom backend URL or null for default */
+    backendUrl: string | null;
+    /** Language code or null for default */
+    language: string | null;
+}
+/**
+ * Response from the backend after creating a tunnel
+ */
+export interface TunnelResponse {
+    /** UUID of the created tunnel */
+    tunnelId: string;
+    /** Base64-encoded token for cloudflared authentication */
+    tunnelToken: string;
+    /** Full HTTPS URL of the tunnel (e.g., "https://myapp.nport.link") */
+    url: string;
+}
+/**
+ * Backend API response wrapper
+ */
+export interface ApiResponse<T = unknown> {
+    /** Whether the request was successful */
+    success: boolean;
+    /** Error message if success is false */
+    error?: string;
+    /** Response data if success is true */
+    data?: T;
+}
+/**
+ * Create tunnel API response
+ */
+export interface CreateTunnelApiResponse extends ApiResponse {
+    tunnelId?: string;
+    tunnelToken?: string;
+    url?: string;
+}
+/**
+ * Tunnel state information
+ */
+export interface TunnelState {
+    /** UUID of the current tunnel */
+    tunnelId: string | null;
+    /** Current subdomain */
+    subdomain: string | null;
+    /** Local port being tunneled */
+    port: number | null;
+    /** Custom backend URL */
+    backendUrl: string | null;
+    /** Number of established connections */
+    connectionCount: number;
+    /** Timestamp when tunnel was created */
+    startTime: number | null;
+}
+/**
+ * Shutdown reason types
+ */
+export type ShutdownReason = 'manual' | 'timeout' | 'error';
+/**
+ * Tunnel lifecycle events
+ */
+export type TunnelEvent = 'created' | 'connected' | 'disconnected' | 'error' | 'shutdown';

package/dist/types/tunnel.js

@@ -0,0 +1,8 @@
+/**
+ * Tunnel-related type definitions
+ *
+ * These types define the data structures used for tunnel creation,
+ * management, and communication between CLI and backend.
+ */
+export {};
+//# sourceMappingURL=tunnel.js.map

package/dist/types/tunnel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tunnel.js","sourceRoot":"","sources":["../../src/types/tunnel.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}