nport 2.0.7 → 2.1.1

package/dist/lang.js

@@ -0,0 +1,217 @@
+import readline from 'readline';
+import { AVAILABLE_LANGUAGES } from './constants.js';
+import { configManager } from './config-manager.js';
+/**
+ * Translation strings for all supported languages
+ */
+const TRANSLATIONS = {
+    en: {
+        header: 'N P O R T  ⚡️  Free & Open Source from Vietnam ❤️',
+        creatingTunnel: 'Creating tunnel for port {port}...',
+        checkingUpdates: 'Checking for updates...',
+        tunnelLive: '🚀 WE LIVE BABY!',
+        connection1: '   ✔ [1/2] Connection established...',
+        connection2: '   ✔ [2/2] Compression enabled...',
+        timeRemaining: '⏱️  Time:     {hours}h remaining',
+        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',
+        tunnelShutdown: '🛑 TUNNEL SHUTDOWN.',
+        cleaningUp: 'Cleaning up... ',
+        cleanupDone: 'Done.',
+        cleanupFailed: 'Failed.',
+        subdomainReleased: 'Subdomain...   Released. 🗑️',
+        serverBusy: '(Server might be down or busy)',
+        goodbyeTitle: '👋 BEFORE YOU GO...',
+        goodbyeMessage: 'Thanks for using NPort!',
+        website: '🌐 Website:     ',
+        author: '👤 Author:      ',
+        changeLanguage: '🌍 Language:    ',
+        changeLanguageHint: 'nport --language',
+        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: ',
+        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!',
+        networkIssueTitle: '\n⚠️  NETWORK CONNECTIVITY ISSUE DETECTED',
+        networkIssueDesc: '   Cloudflared is having trouble maintaining a stable connection to Cloudflare\'s edge servers.',
+        networkIssueTunnel: '   📡 Your tunnel is still working, but connection quality may be affected.',
+        networkIssueReasons: '\n   💡 Possible reasons:',
+        networkIssueReason1: '      • Unstable internet connection or high packet loss',
+        networkIssueReason2: '      • Firewall/Router blocking UDP traffic (QUIC protocol)',
+        networkIssueReason3: '      • ISP throttling or network congestion',
+        networkIssueFix: '\n   🔧 What to try:',
+        networkIssueFix1: '      • Check your internet connection stability',
+        networkIssueFix2: '      • Try connecting from a different network',
+        networkIssueFix3: '      • Disable VPN/Proxy if you\'re using one',
+        networkIssueFix4: '      • The tunnel will automatically fallback to HTTP/2 if QUIC fails',
+        networkIssueIgnore: '\n   ℹ️  This is usually not critical - your tunnel should continue working normally.\n',
+    },
+    vi: {
+        header: 'N P O R T  ⚡️  Việt Nam Mãi Đỉnh ❤️',
+        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à!',
+        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!',
+        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',
+        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)',
+        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',
+        versionTitle: 'NPort v{version}',
+        versionSubtitle: 'Hơn cả Ngrok - Ma-de in Việ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: ',
+        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!',
+        networkIssueTitle: '\n⚠️  PHÁT HIỆN VẤN ĐỀ MẠNG',
+        networkIssueDesc: '   Cloudflared đang gặp khó khăn khi giữ kết nối ổn định tới Cloudflare edge servers.',
+        networkIssueTunnel: '   📡 Tunnel của bạn vẫn hoạt động, nhưng chất lượng kết nối có thể bị ảnh hưởng.',
+        networkIssueReasons: '\n   💡 Có thể do:',
+        networkIssueReason1: '      • Mạng internet không ổn định hoặc mất gói tin',
+        networkIssueReason2: '      • Firewall/Router chặn UDP traffic (giao thức QUIC)',
+        networkIssueReason3: '      • Nhà mạng throttle hoặc tắc nghẽn mạng',
+        networkIssueFix: '\n   🔧 Thử các cách sau:',
+        networkIssueFix1: '      • Kiểm tra kết nối internet của bạn',
+        networkIssueFix2: '      • Thử đổi sang mạng khác (ví dụ: 4G/5G)',
+        networkIssueFix3: '      • Tắt VPN/Proxy nếu đang bật',
+        networkIssueFix4: '      • Tunnel sẽ tự động chuyển sang HTTP/2 nếu QUIC fail',
+        networkIssueIgnore: '\n   ℹ️  Lỗi này thường không nghiêm trọng - tunnel vẫn hoạt động bình thường.\n',
+    }
+};
+/**
+ * Language Manager
+ */
+class LanguageManager {
+    currentLanguage = 'en';
+    availableLanguages = AVAILABLE_LANGUAGES;
+    /**
+     * Gets a translated string with variable substitution.
+     */
+    t(key, vars = {}) {
+        const translations = TRANSLATIONS[this.currentLanguage] || TRANSLATIONS.en;
+        let text = translations[key] || TRANSLATIONS.en[key] || key;
+        Object.keys(vars).forEach(varKey => {
+            const value = vars[varKey];
+            if (value !== undefined) {
+                text = text.replace(`{${varKey}}`, String(value));
+            }
+        });
+        return text;
+    }
+    /**
+     * Loads saved language preference.
+     */
+    loadLanguagePreference() {
+        const lang = configManager.getLanguage();
+        if (lang && this.availableLanguages.includes(lang)) {
+            return lang;
+        }
+        return null;
+    }
+    /**
+     * Saves language preference.
+     */
+    saveLanguagePreference(lang) {
+        configManager.setLanguage(lang);
+    }
+    /**
+     * Sets the current language.
+     */
+    setLanguage(lang) {
+        if (this.availableLanguages.includes(lang)) {
+            this.currentLanguage = lang;
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Gets the current language code.
+     */
+    getLanguage() {
+        return this.currentLanguage;
+    }
+    /**
+     * Prompts user to select a language.
+     */
+    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);
+            });
+        });
+    }
+    /**
+     * Initializes the language system.
+     */
+    async initialize(cliLanguage = null) {
+        if (cliLanguage && cliLanguage !== 'prompt' && this.setLanguage(cliLanguage)) {
+            this.saveLanguagePreference(cliLanguage);
+            return cliLanguage;
+        }
+        if (cliLanguage === 'prompt') {
+            return await this.promptLanguageSelection();
+        }
+        const savedLang = this.loadLanguagePreference();
+        if (savedLang) {
+            this.setLanguage(savedLang);
+            return savedLang;
+        }
+        return await this.promptLanguageSelection();
+    }
+}
+export const lang = new LanguageManager();
+//# sourceMappingURL=lang.js.map

package/dist/lang.js.map

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

package/dist/state.d.ts

@@ -0,0 +1,82 @@
+import type { ChildProcess } from 'child_process';
+import type { UpdateCheckResult } from './types/index.js';
+/**
+ * Application State Manager
+ *
+ * Singleton class that manages all runtime state for the tunnel.
+ */
+declare class TunnelState {
+    tunnelId: string | null;
+    subdomain: string | null;
+    port: number | null;
+    backendUrl: string | null;
+    tunnelProcess: ChildProcess | null;
+    private timeoutId;
+    connectionCount: number;
+    startTime: number | null;
+    updateInfo: UpdateCheckResult | null;
+    private networkIssueCount;
+    private lastNetworkWarningTime;
+    networkWarningShown: boolean;
+    /**
+     * Sets the tunnel connection information.
+     */
+    setTunnel(tunnelId: string | null, subdomain: string, port: number, backendUrl?: string | null): void;
+    /**
+     * Stores version update information.
+     */
+    setUpdateInfo(updateInfo: UpdateCheckResult | null): void;
+    /**
+     * Stores reference to the cloudflared child process.
+     */
+    setProcess(process: ChildProcess): void;
+    /**
+     * Stores the auto-cleanup timeout ID.
+     */
+    setTimeout(timeoutId: ReturnType<typeof setTimeout>): void;
+    /**
+     * Clears the auto-cleanup timeout if set.
+     */
+    clearTimeout(): void;
+    /**
+     * Increments the connection count and returns the new value.
+     */
+    incrementConnection(): number;
+    /**
+     * Checks if a tunnel is currently active.
+     */
+    hasTunnel(): boolean;
+    /**
+     * Checks if the cloudflared process is running.
+     */
+    hasProcess(): boolean;
+    /**
+     * Gets the tunnel duration in seconds.
+     */
+    getDurationSeconds(): number;
+    /**
+     * Increments the network issue counter.
+     */
+    incrementNetworkIssue(): number;
+    /**
+     * Resets the network issue counter.
+     */
+    resetNetworkIssues(): void;
+    /**
+     * Determines if a network warning should be shown.
+     */
+    shouldShowNetworkWarning(threshold: number, cooldown: number): boolean;
+    /**
+     * Sets whether a network warning has been shown.
+     */
+    setNetworkWarningShown(value: boolean): void;
+    /**
+     * Resets all state to initial values.
+     */
+    reset(): void;
+}
+/**
+ * Singleton instance
+ */
+export declare const state: TunnelState;
+export {};

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>;
+    }>;
+}