nport 2.1.0 → 2.1.1

package/CHANGELOG.md

@@ -5,6 +5,23 @@ All notable changes to NPort will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.1.1] - 2026-01-27
+
+### Fixed
+- 🐛 **NPM Package Build**: Fixed missing `dist/` folder in published package
+  - Added build step to npm-publish workflow before publishing
+  - Package now includes compiled JavaScript files correctly
+
+### Added
+- 🚀 **CI/CD Workflows**: Added GitHub Actions for automated deployments
+  - `ci.yml`: Runs tests on push to main and pull requests
+  - `deploy-server.yml`: Auto-deploys Cloudflare Worker on server changes
+  - `deploy-website.yml`: Auto-deploys website to Cloudflare Pages on changes
+- 🧪 **Server Test Configuration**: Fixed Vitest config for CI environment
+  - Added miniflare bindings for test environment variables
+  - Tests now pass in CI without `.dev.vars` file
+- ⚙️ **Wrangler Configuration**: Added `preview_urls` setting to suppress warnings
+
 ## [2.1.0] - 2026-01-27
 
 ### Added

package/dist/analytics.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Analytics Manager
+ */
+declare class AnalyticsManager {
+    private userId;
+    private sessionId;
+    private disabled;
+    constructor();
+    /**
+     * Initializes analytics.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Gets or creates a persistent user ID.
+     */
+    private getUserId;
+    /**
+     * Generates an anonymous user ID.
+     */
+    private generateAnonymousId;
+    /**
+     * Generates a session ID.
+     */
+    private generateSessionId;
+    /**
+     * Tracks an event.
+     */
+    private trackEvent;
+    /**
+     * Builds GA4 payload.
+     */
+    private buildPayload;
+    /**
+     * Gets system information.
+     */
+    private getSystemInfo;
+    /**
+     * Tracks CLI start.
+     */
+    trackCliStart(port: number, subdomain: string, version: string): void;
+    /**
+     * Tracks tunnel creation.
+     */
+    trackTunnelCreated(subdomain: string, port: number): void;
+    /**
+     * Tracks tunnel error.
+     */
+    trackTunnelError(errorType: string, errorMessage: string): void;
+    /**
+     * Tracks tunnel shutdown.
+     */
+    trackTunnelShutdown(reason: string, durationSeconds: number): void;
+    /**
+     * Tracks update available.
+     */
+    trackUpdateAvailable(currentVersion: string, latestVersion: string): void;
+}
+export declare const analytics: AnalyticsManager;
+export {};

package/dist/analytics.js

@@ -0,0 +1,193 @@
+import axios from 'axios';
+import { createHash, randomUUID } from 'crypto';
+import os from 'os';
+import fs from 'fs';
+import path from 'path';
+import { ANALYTICS_TIMEOUT } from './constants.js';
+/**
+ * Firebase/GA4 Configuration
+ */
+const FIREBASE_CONFIG = {
+    measurementId: 'G-8MYXZL6PGD',
+    apiSecret: process.env.NPORT_ANALYTICS_SECRET || 'YOUR_API_SECRET_HERE',
+};
+const ANALYTICS_CONFIG = {
+    enabled: true,
+    debug: process.env.NPORT_DEBUG === 'true',
+    timeout: ANALYTICS_TIMEOUT,
+    userIdFile: path.join(os.homedir(), '.nport', 'analytics-id'),
+};
+/**
+ * Analytics Manager
+ */
+class AnalyticsManager {
+    userId = null;
+    sessionId = null;
+    disabled = false;
+    constructor() {
+        if (process.env.NPORT_ANALYTICS === 'false') {
+            this.disabled = true;
+        }
+    }
+    /**
+     * Initializes analytics.
+     */
+    async initialize() {
+        if (this.disabled)
+            return;
+        if (!FIREBASE_CONFIG.apiSecret || FIREBASE_CONFIG.apiSecret === 'YOUR_API_SECRET_HERE') {
+            if (ANALYTICS_CONFIG.debug) {
+                console.warn('[Analytics] API secret not configured. Analytics disabled.');
+            }
+            this.disabled = true;
+            return;
+        }
+        try {
+            this.userId = await this.getUserId();
+            this.sessionId = this.generateSessionId();
+            if (ANALYTICS_CONFIG.debug) {
+                console.log('[Analytics] Initialized successfully');
+            }
+        }
+        catch {
+            this.disabled = true;
+        }
+    }
+    /**
+     * Gets or creates a persistent user ID.
+     */
+    async getUserId() {
+        try {
+            const configDir = path.join(os.homedir(), '.nport');
+            if (!fs.existsSync(configDir)) {
+                fs.mkdirSync(configDir, { recursive: true });
+            }
+            if (fs.existsSync(ANALYTICS_CONFIG.userIdFile)) {
+                const userId = fs.readFileSync(ANALYTICS_CONFIG.userIdFile, 'utf8').trim();
+                if (userId)
+                    return userId;
+            }
+            const userId = this.generateAnonymousId();
+            fs.writeFileSync(ANALYTICS_CONFIG.userIdFile, userId, 'utf8');
+            return userId;
+        }
+        catch {
+            return this.generateAnonymousId();
+        }
+    }
+    /**
+     * Generates an anonymous user ID.
+     */
+    generateAnonymousId() {
+        const machineId = [
+            os.hostname(),
+            os.platform(),
+            os.arch(),
+            os.homedir(),
+        ].join('-');
+        return createHash('sha256').update(machineId).digest('hex').substring(0, 32);
+    }
+    /**
+     * Generates a session ID.
+     */
+    generateSessionId() {
+        return randomUUID();
+    }
+    /**
+     * Tracks an event.
+     */
+    async trackEvent(eventName, params = {}) {
+        if (this.disabled || !ANALYTICS_CONFIG.enabled || !this.userId)
+            return;
+        try {
+            const payload = this.buildPayload(eventName, params);
+            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(() => {
+                // Silently fail
+            });
+        }
+        catch {
+            // Silently fail
+        }
+    }
+    /**
+     * Builds GA4 payload.
+     */
+    buildPayload(eventName, params) {
+        return {
+            client_id: this.userId,
+            events: [
+                {
+                    name: eventName,
+                    params: {
+                        session_id: this.sessionId,
+                        engagement_time_msec: '100',
+                        ...this.getSystemInfo(),
+                        ...params,
+                    },
+                },
+            ],
+        };
+    }
+    /**
+     * Gets system information.
+     */
+    getSystemInfo() {
+        return {
+            os_platform: os.platform(),
+            os_version: os.release(),
+            os_arch: os.arch(),
+            node_version: process.version,
+        };
+    }
+    /**
+     * Tracks CLI start.
+     */
+    trackCliStart(port, subdomain, version) {
+        this.trackEvent('cli_start', {
+            port: String(port),
+            has_custom_subdomain: subdomain && !subdomain.startsWith('user-'),
+            cli_version: version,
+        });
+    }
+    /**
+     * Tracks tunnel creation.
+     */
+    trackTunnelCreated(subdomain, port) {
+        this.trackEvent('tunnel_created', {
+            subdomain_type: subdomain.startsWith('user-') ? 'random' : 'custom',
+            port: String(port),
+        });
+    }
+    /**
+     * Tracks tunnel error.
+     */
+    trackTunnelError(errorType, errorMessage) {
+        this.trackEvent('tunnel_error', {
+            error_type: errorType,
+            error_message: errorMessage.substring(0, 100),
+        });
+    }
+    /**
+     * Tracks tunnel shutdown.
+     */
+    trackTunnelShutdown(reason, durationSeconds) {
+        this.trackEvent('tunnel_shutdown', {
+            shutdown_reason: reason,
+            duration_seconds: String(Math.floor(durationSeconds)),
+        });
+    }
+    /**
+     * Tracks update available.
+     */
+    trackUpdateAvailable(currentVersion, latestVersion) {
+        this.trackEvent('update_available', {
+            current_version: currentVersion,
+            latest_version: latestVersion,
+        });
+    }
+}
+export const analytics = new AnalyticsManager();
+//# sourceMappingURL=analytics.js.map

package/dist/analytics.js.map

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

package/dist/api.d.ts

@@ -0,0 +1,20 @@
+import type { TunnelResponse } from './types/index.js';
+/**
+ * API Client
+ *
+ * Handles all communication with the NPort backend service.
+ */
+export declare class APIClient {
+    /**
+     * Creates a new Cloudflare tunnel via the backend API.
+     */
+    static createTunnel(subdomain: string, backendUrl?: string | null): Promise<TunnelResponse>;
+    /**
+     * Deletes an existing tunnel.
+     */
+    static deleteTunnel(subdomain: string, tunnelId: string, backendUrl?: string | null): Promise<void>;
+    /**
+     * Transforms API errors into user-friendly messages.
+     */
+    private static handleError;
+}

package/dist/api.js

@@ -0,0 +1,85 @@
+import axios from 'axios';
+import chalk from 'chalk';
+import { CONFIG } from './config.js';
+import { state } from './state.js';
+/**
+ * API Client
+ *
+ * Handles all communication with the NPort backend service.
+ */
+export class APIClient {
+    /**
+     * Creates a new Cloudflare tunnel via the backend API.
+     */
+    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);
+        }
+    }
+    /**
+     * Deletes an existing tunnel.
+     */
+    static async deleteTunnel(subdomain, tunnelId, backendUrl = null) {
+        const url = backendUrl || CONFIG.BACKEND_URL;
+        await axios.delete(url, {
+            data: { subdomain, tunnelId },
+        });
+    }
+    /**
+     * Transforms API errors into user-friendly messages.
+     */
+    static handleError(error, subdomain) {
+        const errorMsg = error.response?.data?.error;
+        if (errorMsg) {
+            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'));
+            }
+            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`));
+            }
+            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) {
+            return new Error(`Backend Error: ${JSON.stringify(error.response.data, null, 2)}`);
+        }
+        return error;
+    }
+}
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

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

package/dist/args.d.ts

@@ -0,0 +1,44 @@
+import type { ParsedArguments } from './types/index.js';
+/**
+ * Command Line Argument Parser
+ *
+ * Handles parsing of CLI arguments for the NPort command.
+ */
+export declare class ArgumentParser {
+    /**
+     * Parses command-line arguments into a configuration object.
+     */
+    static parse(argv: string[]): ParsedArguments;
+    /**
+     * Extracts the port number from arguments.
+     */
+    static parsePort(argv: string[]): number;
+    /**
+     * Extracts the subdomain from arguments.
+     */
+    static parseSubdomain(argv: string[]): string;
+    /**
+     * Extracts the language setting from arguments.
+     */
+    static parseLanguage(argv: string[]): string | null;
+    /**
+     * Extracts the backend URL from arguments.
+     */
+    static parseBackendUrl(argv: string[]): string | null;
+    /**
+     * Extracts the set-backend command from arguments.
+     */
+    static parseSetBackend(argv: string[]): string | null;
+    /**
+     * Finds a flag with value in --flag=value format.
+     */
+    private static findFlagWithEquals;
+    /**
+     * Finds a flag with value in --flag value format.
+     */
+    private static findFlagWithValue;
+    /**
+     * Generates a random subdomain.
+     */
+    private static generateRandomSubdomain;
+}

package/dist/args.js

@@ -0,0 +1,127 @@
+import { CONFIG } from './config.js';
+/**
+ * Command Line Argument Parser
+ *
+ * Handles parsing of CLI arguments for the NPort command.
+ */
+export class ArgumentParser {
+    /**
+     * Parses command-line arguments into a configuration object.
+     */
+    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 };
+    }
+    /**
+     * Extracts the port number from arguments.
+     */
+    static parsePort(argv) {
+        const portArg = parseInt(argv[0], 10);
+        return portArg || CONFIG.DEFAULT_PORT;
+    }
+    /**
+     * Extracts the subdomain from arguments.
+     */
+    static parseSubdomain(argv) {
+        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();
+    }
+    /**
+     * Extracts the language setting from arguments.
+     */
+    static parseLanguage(argv) {
+        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');
+            const nextArg = argv[langIndex + 1];
+            if (!nextArg || nextArg.startsWith('-')) {
+                return 'prompt';
+            }
+        }
+        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;
+    }
+    /**
+     * Extracts the backend URL from arguments.
+     */
+    static parseBackendUrl(argv) {
+        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;
+    }
+    /**
+     * Extracts the set-backend command from arguments.
+     */
+    static parseSetBackend(argv) {
+        const formats = [
+            () => this.findFlagWithEquals(argv, '--set-backend='),
+            () => this.findFlagWithValue(argv, '--set-backend'),
+        ];
+        for (const format of formats) {
+            const url = format();
+            if (url)
+                return url;
+        }
+        if (argv.includes('--set-backend')) {
+            return 'clear';
+        }
+        return null;
+    }
+    /**
+     * Finds a flag with value in --flag=value format.
+     */
+    static findFlagWithEquals(argv, flag) {
+        const arg = argv.find((a) => a.startsWith(flag));
+        return arg ? arg.split('=')[1] : null;
+    }
+    /**
+     * Finds a flag with value in --flag value format.
+     */
+    static findFlagWithValue(argv, flag) {
+        const index = argv.indexOf(flag);
+        return index !== -1 && argv[index + 1] ? argv[index + 1] : null;
+    }
+    /**
+     * Generates a random subdomain.
+     */
+    static generateRandomSubdomain() {
+        return `${CONFIG.SUBDOMAIN_PREFIX}${Math.floor(Math.random() * 10000)}`;
+    }
+}
+//# sourceMappingURL=args.js.map

package/dist/args.js.map

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

package/dist/bin-manager.d.ts

@@ -0,0 +1 @@
+export declare function ensureCloudflared(): Promise<string>;