@wanosoft/wanolink 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Wanosoft
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,62 @@
+# Wanolink
+
+> Simple localhost tunneling powered by Cloudflare
+
+## Installation
+
+```bash
+npm install -g @wanosoft/wanolink
+```
+
+## Quick Start
+
+```bash
+# Authenticate (first time only)
+wanolink auth
+
+# Expose port 3000
+wanolink 3000
+
+# With custom subdomain
+wanolink 3000 -s myapp
+# → https://myapp.wanosoft.link
+```
+
+## CLI Options
+
+```bash
+wanolink <port> [options]
+```
+
+| Option | Description |
+|--------|-------------|
+| `-s, --subdomain` | Custom subdomain |
+| `-t, --timeout` | Timeout in hours (default: 4, 0 = unlimited) |
+| `-h, --help` | Show help |
+| `auth` | Authenticate with token |
+| `logout` | Remove saved token |
+
+## Examples
+
+```bash
+# Unlimited duration
+wanolink 3000 -s myapp -t 0
+
+# Custom timeout (2 hours)
+wanolink 8080 --timeout 2
+```
+
+## Features
+
+- ⚡ Instant setup
+- � HTTPS via Cloudflare
+- 🌐 Custom subdomains
+- 💻 Cross-platform (Windows, macOS, Linux)
+
+## Credits
+
+Based on [nport](https://www.npmjs.com/package/nport)
+
+## License
+
+MIT

package/analytics.js

@@ -0,0 +1,227 @@
+// ============================================================================
+// Analytics for CLI (Optional)
+// 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(__filename);
+
+// Analytics-specific config (for GA4 Measurement Protocol)
+const FIREBASE_CONFIG = {
+  measurementId: process.env.WANOLINK_GA_MEASUREMENT_ID || "",
+  apiSecret: process.env.WANOLINK_ANALYTICS_SECRET || "",
+};
+
+// Analytics Configuration
+const ANALYTICS_CONFIG = {
+  enabled: true,
+  debug: process.env.WANOLINK_DEBUG === "true",
+  timeout: 2000,
+  userIdFile: path.join(os.homedir(), ".wanolink-analytics"),
+};
+
+// ============================================================================
+// Analytics Manager
+// ============================================================================
+
+class AnalyticsManager {
+  constructor() {
+    this.userId = null;
+    this.sessionId = null;
+    this.disabled = false;
+
+    // Disable analytics if environment variable is set
+    if (process.env.WANOLINK_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.measurementId) {
+      this.disabled = true;
+      return;
+    }
+
+    try {
+      this.userId = await this.getUserId();
+      this.sessionId = this.generateSessionId();
+
+      if (ANALYTICS_CONFIG.debug) {
+        console.log("[Analytics] Initialized successfully");
+      }
+    } 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 {
+      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 (error) {
+      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);
+
+      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(() => { });
+
+      if (ANALYTICS_CONFIG.debug) {
+        console.log("[Analytics] Event tracked:", eventName, params);
+      }
+    } catch (error) {
+      // Silently fail
+    }
+  }
+
+  /**
+   * 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),
+    });
+  }
+
+  /**
+   * Track tunnel shutdown
+   */
+  async trackTunnelShutdown(reason, durationSeconds) {
+    await this.trackEvent("tunnel_shutdown", {
+      shutdown_reason: reason,
+      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();