@portel/photon 1.4.0 → 1.5.1

package/dist/photons/tunnel.photon.js

@@ -0,0 +1,269 @@
+/**
+ * Tunnel - Expose local servers to the internet
+ * @description Multi-provider tunneling for remote access to Beam and local services
+ * @internal
+ */
+import { spawn, execSync } from 'child_process';
+// Track active tunnels
+const activeTunnels = new Map();
+export default class Tunnel {
+    /**
+     * Check available tunnel providers
+     * @icon 🔍
+     */
+    async status() {
+        const providers = [
+            {
+                name: 'localtunnel',
+                available: true, // Always available via npx
+                note: 'Ready (uses npx, no install needed)',
+            },
+            {
+                name: 'ngrok',
+                available: this._checkCommand('ngrok'),
+                install: 'brew install ngrok  OR  https://ngrok.com/download',
+            },
+            {
+                name: 'cloudflared',
+                available: this._checkCommand('cloudflared'),
+                install: 'brew install cloudflared  OR  https://developers.cloudflare.com/cloudflare-one/connections/connect-apps/install-and-setup/installation',
+            },
+        ];
+        return {
+            providers,
+            activeTunnels: Array.from(activeTunnels.values()).map((t) => t.info),
+        };
+    }
+    /**
+     * Start a tunnel to expose Beam to the internet
+     * @icon 🚀
+     * @param provider Tunnel provider to use
+     */
+    async *start({ provider = 'localtunnel', } = {}) {
+        // Auto-detect Beam port from environment
+        const port = parseInt(process.env.BEAM_PORT || '3117', 10);
+        // Check if tunnel already exists for this port
+        if (activeTunnels.has(port)) {
+            const existing = activeTunnels.get(port);
+            const publicIp = await this._getPublicIp();
+            return {
+                message: `Tunnel already active on port ${port}`,
+                url: existing.info.url,
+                link: existing.info.url,
+                password: existing.info.provider === 'localtunnel' ? publicIp : undefined,
+                provider: existing.info.provider,
+                port,
+            };
+        }
+        yield { step: 'starting', message: `Starting ${provider} tunnel for Beam (port ${port})...` };
+        try {
+            let url;
+            let process;
+            switch (provider) {
+                case 'ngrok':
+                    if (!this._checkCommand('ngrok')) {
+                        throw new Error('ngrok not installed. Run: brew install ngrok');
+                    }
+                    ({ url, process } = await this._startNgrok(port));
+                    break;
+                case 'cloudflared':
+                    if (!this._checkCommand('cloudflared')) {
+                        throw new Error('cloudflared not installed. Run: brew install cloudflared');
+                    }
+                    ({ url, process } = await this._startCloudflared(port));
+                    break;
+                case 'localtunnel':
+                default:
+                    ({ url, process } = await this._startLocaltunnel(port));
+                    break;
+            }
+            // Fetch public IP (needed for localtunnel password)
+            const publicIp = await this._getPublicIp();
+            const info = {
+                provider,
+                port,
+                url,
+                pid: process.pid,
+                startedAt: new Date(),
+            };
+            activeTunnels.set(port, { process, info });
+            return {
+                message: `Tunnel started successfully`,
+                url,
+                link: url,
+                password: provider === 'localtunnel' ? publicIp : undefined,
+                provider,
+                port,
+            };
+        }
+        catch (error) {
+            throw new Error(error.message);
+        }
+    }
+    /**
+     * Stop a tunnel
+     * @icon ⏹️
+     * @param port Port of the tunnel to stop
+     */
+    async stop({ port, }) {
+        const tunnel = activeTunnels.get(port);
+        if (!tunnel) {
+            return { stopped: false, message: `No active tunnel on port ${port}` };
+        }
+        tunnel.process.kill();
+        activeTunnels.delete(port);
+        return {
+            stopped: true,
+            message: `Stopped ${tunnel.info.provider} tunnel on port ${port}`,
+        };
+    }
+    /**
+     * Stop all active tunnels
+     * @icon ⏹️
+     */
+    async stopAll() {
+        const count = activeTunnels.size;
+        for (const [port, tunnel] of activeTunnels) {
+            tunnel.process.kill();
+            activeTunnels.delete(port);
+        }
+        return {
+            stopped: count,
+            message: count > 0 ? `Stopped ${count} tunnel(s)` : 'No active tunnels',
+        };
+    }
+    /**
+     * List active tunnels
+     * @icon 📋
+     */
+    async list() {
+        return {
+            tunnels: Array.from(activeTunnels.values()).map((t) => t.info),
+        };
+    }
+    // ============================================
+    // Provider Implementations
+    // ============================================
+    _checkCommand(cmd) {
+        try {
+            execSync(`which ${cmd}`, { stdio: 'ignore' });
+            return true;
+        }
+        catch {
+            return false; // command not found
+        }
+    }
+    async _getPublicIp() {
+        // Try multiple services in order
+        const services = ['https://api.ipify.org', 'https://ifconfig.me/ip', 'https://icanhazip.com'];
+        for (const service of services) {
+            try {
+                const result = execSync(`curl -s --max-time 3 ${service}`, {
+                    encoding: 'utf-8',
+                    timeout: 5000,
+                });
+                const ip = result.trim();
+                if (ip && /^\d+\.\d+\.\d+\.\d+$/.test(ip)) {
+                    return ip;
+                }
+            }
+            catch {
+                continue;
+            }
+        }
+        return 'unknown';
+    }
+    async _startLocaltunnel(port) {
+        return new Promise((resolve, reject) => {
+            const proc = spawn('npx', ['localtunnel', '--port', String(port)], {
+                stdio: ['ignore', 'pipe', 'pipe'],
+            });
+            let output = '';
+            const timeout = setTimeout(() => {
+                reject(new Error('Timeout waiting for localtunnel URL'));
+            }, 30000);
+            proc.stdout?.on('data', (data) => {
+                output += data.toString();
+                // localtunnel outputs: "your url is: https://xxx.loca.lt"
+                const match = output.match(/your url is: (https?:\/\/[^\s]+)/i);
+                if (match) {
+                    clearTimeout(timeout);
+                    resolve({ url: match[1], process: proc });
+                }
+            });
+            proc.stderr?.on('data', (data) => {
+                const err = data.toString();
+                if (err.includes('error')) {
+                    clearTimeout(timeout);
+                    reject(new Error(err));
+                }
+            });
+            proc.on('error', (err) => {
+                clearTimeout(timeout);
+                reject(err);
+            });
+            proc.on('close', (code) => {
+                if (code !== 0 && !output.includes('your url is')) {
+                    clearTimeout(timeout);
+                    reject(new Error(`localtunnel exited with code ${code}`));
+                }
+            });
+        });
+    }
+    async _startNgrok(port) {
+        return new Promise((resolve, reject) => {
+            const proc = spawn('ngrok', ['http', String(port), '--log', 'stdout'], {
+                stdio: ['ignore', 'pipe', 'pipe'],
+            });
+            let output = '';
+            const timeout = setTimeout(() => {
+                reject(new Error('Timeout waiting for ngrok URL'));
+            }, 15000);
+            proc.stdout?.on('data', (data) => {
+                output += data.toString();
+                // ngrok outputs JSON logs, look for the URL
+                const match = output.match(/url=(https?:\/\/[^\s"]+\.ngrok[^\s"]*)/i);
+                if (match) {
+                    clearTimeout(timeout);
+                    resolve({ url: match[1], process: proc });
+                }
+            });
+            proc.stderr?.on('data', (data) => {
+                output += data.toString();
+            });
+            proc.on('error', (err) => {
+                clearTimeout(timeout);
+                reject(err);
+            });
+        });
+    }
+    async _startCloudflared(port) {
+        return new Promise((resolve, reject) => {
+            const proc = spawn('cloudflared', ['tunnel', '--url', `http://localhost:${port}`], {
+                stdio: ['ignore', 'pipe', 'pipe'],
+            });
+            let output = '';
+            const timeout = setTimeout(() => {
+                reject(new Error('Timeout waiting for cloudflared URL'));
+            }, 30000);
+            // cloudflared outputs to stderr
+            proc.stderr?.on('data', (data) => {
+                output += data.toString();
+                // Look for the trycloudflare.com URL
+                const match = output.match(/(https?:\/\/[^\s]+\.trycloudflare\.com)/i);
+                if (match) {
+                    clearTimeout(timeout);
+                    resolve({ url: match[1], process: proc });
+                }
+            });
+            proc.stdout?.on('data', (data) => {
+                output += data.toString();
+            });
+            proc.on('error', (err) => {
+                clearTimeout(timeout);
+                reject(err);
+            });
+        });
+    }
+}
+//# sourceMappingURL=tunnel.photon.js.map

package/dist/photons/tunnel.photon.js.map

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

package/dist/photons/tunnel.photon.ts

@@ -0,0 +1,345 @@
+/**
+ * Tunnel - Expose local servers to the internet
+ * @description Multi-provider tunneling for remote access to Beam and local services
+ * @internal
+ */
+
+import { spawn, execSync, ChildProcess } from 'child_process';
+
+interface TunnelInfo {
+  provider: string;
+  port: number;
+  url: string;
+  pid: number;
+  startedAt: Date;
+}
+
+// Track active tunnels
+const activeTunnels: Map<number, { process: ChildProcess; info: TunnelInfo }> = new Map();
+
+export default class Tunnel {
+  /**
+   * Check available tunnel providers
+   * @icon 🔍
+   */
+  async status(): Promise<{
+    providers: Array<{
+      name: string;
+      available: boolean;
+      install?: string;
+      note?: string;
+    }>;
+    activeTunnels: TunnelInfo[];
+  }> {
+    const providers = [
+      {
+        name: 'localtunnel',
+        available: true, // Always available via npx
+        note: 'Ready (uses npx, no install needed)',
+      },
+      {
+        name: 'ngrok',
+        available: this._checkCommand('ngrok'),
+        install: 'brew install ngrok  OR  https://ngrok.com/download',
+      },
+      {
+        name: 'cloudflared',
+        available: this._checkCommand('cloudflared'),
+        install:
+          'brew install cloudflared  OR  https://developers.cloudflare.com/cloudflare-one/connections/connect-apps/install-and-setup/installation',
+      },
+    ];
+
+    return {
+      providers,
+      activeTunnels: Array.from(activeTunnels.values()).map((t) => t.info),
+    };
+  }
+
+  /**
+   * Start a tunnel to expose Beam to the internet
+   * @icon 🚀
+   * @param provider Tunnel provider to use
+   */
+  async *start({
+    provider = 'localtunnel',
+  }: {
+    /** Provider: localtunnel, ngrok, or cloudflared */
+    provider?: 'localtunnel' | 'ngrok' | 'cloudflared';
+  } = {}): AsyncGenerator<
+    { step: string; message: string },
+    {
+      message: string;
+      url: string;
+      link: string;
+      provider: string;
+      port: number;
+      password?: string;
+    }
+  > {
+    // Auto-detect Beam port from environment
+    const port = parseInt(process.env.BEAM_PORT || '3117', 10);
+
+    // Check if tunnel already exists for this port
+    if (activeTunnels.has(port)) {
+      const existing = activeTunnels.get(port)!;
+      const publicIp = await this._getPublicIp();
+      return {
+        message: `Tunnel already active on port ${port}`,
+        url: existing.info.url,
+        link: existing.info.url,
+        password: existing.info.provider === 'localtunnel' ? publicIp : undefined,
+        provider: existing.info.provider,
+        port,
+      };
+    }
+
+    yield { step: 'starting', message: `Starting ${provider} tunnel for Beam (port ${port})...` };
+
+    try {
+      let url: string;
+      let process: ChildProcess;
+
+      switch (provider) {
+        case 'ngrok':
+          if (!this._checkCommand('ngrok')) {
+            throw new Error('ngrok not installed. Run: brew install ngrok');
+          }
+          ({ url, process } = await this._startNgrok(port));
+          break;
+
+        case 'cloudflared':
+          if (!this._checkCommand('cloudflared')) {
+            throw new Error('cloudflared not installed. Run: brew install cloudflared');
+          }
+          ({ url, process } = await this._startCloudflared(port));
+          break;
+
+        case 'localtunnel':
+        default:
+          ({ url, process } = await this._startLocaltunnel(port));
+          break;
+      }
+
+      // Fetch public IP (needed for localtunnel password)
+      const publicIp = await this._getPublicIp();
+
+      const info: TunnelInfo = {
+        provider,
+        port,
+        url,
+        pid: process.pid!,
+        startedAt: new Date(),
+      };
+
+      activeTunnels.set(port, { process, info });
+
+      return {
+        message: `Tunnel started successfully`,
+        url,
+        link: url,
+        password: provider === 'localtunnel' ? publicIp : undefined,
+        provider,
+        port,
+      };
+    } catch (error: any) {
+      throw new Error(error.message);
+    }
+  }
+
+  /**
+   * Stop a tunnel
+   * @icon ⏹️
+   * @param port Port of the tunnel to stop
+   */
+  async stop({
+    port,
+  }: {
+    /** Port of the tunnel to stop */
+    port: number;
+  }): Promise<{ stopped: boolean; message: string }> {
+    const tunnel = activeTunnels.get(port);
+
+    if (!tunnel) {
+      return { stopped: false, message: `No active tunnel on port ${port}` };
+    }
+
+    tunnel.process.kill();
+    activeTunnels.delete(port);
+
+    return {
+      stopped: true,
+      message: `Stopped ${tunnel.info.provider} tunnel on port ${port}`,
+    };
+  }
+
+  /**
+   * Stop all active tunnels
+   * @icon ⏹️
+   */
+  async stopAll(): Promise<{ stopped: number; message: string }> {
+    const count = activeTunnels.size;
+
+    for (const [port, tunnel] of activeTunnels) {
+      tunnel.process.kill();
+      activeTunnels.delete(port);
+    }
+
+    return {
+      stopped: count,
+      message: count > 0 ? `Stopped ${count} tunnel(s)` : 'No active tunnels',
+    };
+  }
+
+  /**
+   * List active tunnels
+   * @icon 📋
+   */
+  async list(): Promise<{ tunnels: TunnelInfo[] }> {
+    return {
+      tunnels: Array.from(activeTunnels.values()).map((t) => t.info),
+    };
+  }
+
+  // ============================================
+  // Provider Implementations
+  // ============================================
+
+  private _checkCommand(cmd: string): boolean {
+    try {
+      execSync(`which ${cmd}`, { stdio: 'ignore' });
+      return true;
+    } catch {
+      return false; // command not found
+    }
+  }
+
+  private async _getPublicIp(): Promise<string> {
+    // Try multiple services in order
+    const services = ['https://api.ipify.org', 'https://ifconfig.me/ip', 'https://icanhazip.com'];
+
+    for (const service of services) {
+      try {
+        const result = execSync(`curl -s --max-time 3 ${service}`, {
+          encoding: 'utf-8',
+          timeout: 5000,
+        });
+        const ip = result.trim();
+        if (ip && /^\d+\.\d+\.\d+\.\d+$/.test(ip)) {
+          return ip;
+        }
+      } catch {
+        continue;
+      }
+    }
+    return 'unknown';
+  }
+
+  private async _startLocaltunnel(port: number): Promise<{ url: string; process: ChildProcess }> {
+    return new Promise((resolve, reject) => {
+      const proc = spawn('npx', ['localtunnel', '--port', String(port)], {
+        stdio: ['ignore', 'pipe', 'pipe'],
+      });
+
+      let output = '';
+      const timeout = setTimeout(() => {
+        reject(new Error('Timeout waiting for localtunnel URL'));
+      }, 30000);
+
+      proc.stdout?.on('data', (data) => {
+        output += data.toString();
+        // localtunnel outputs: "your url is: https://xxx.loca.lt"
+        const match = output.match(/your url is: (https?:\/\/[^\s]+)/i);
+        if (match) {
+          clearTimeout(timeout);
+          resolve({ url: match[1], process: proc });
+        }
+      });
+
+      proc.stderr?.on('data', (data) => {
+        const err = data.toString();
+        if (err.includes('error')) {
+          clearTimeout(timeout);
+          reject(new Error(err));
+        }
+      });
+
+      proc.on('error', (err) => {
+        clearTimeout(timeout);
+        reject(err);
+      });
+
+      proc.on('close', (code) => {
+        if (code !== 0 && !output.includes('your url is')) {
+          clearTimeout(timeout);
+          reject(new Error(`localtunnel exited with code ${code}`));
+        }
+      });
+    });
+  }
+
+  private async _startNgrok(port: number): Promise<{ url: string; process: ChildProcess }> {
+    return new Promise((resolve, reject) => {
+      const proc = spawn('ngrok', ['http', String(port), '--log', 'stdout'], {
+        stdio: ['ignore', 'pipe', 'pipe'],
+      });
+
+      let output = '';
+      const timeout = setTimeout(() => {
+        reject(new Error('Timeout waiting for ngrok URL'));
+      }, 15000);
+
+      proc.stdout?.on('data', (data) => {
+        output += data.toString();
+        // ngrok outputs JSON logs, look for the URL
+        const match = output.match(/url=(https?:\/\/[^\s"]+\.ngrok[^\s"]*)/i);
+        if (match) {
+          clearTimeout(timeout);
+          resolve({ url: match[1], process: proc });
+        }
+      });
+
+      proc.stderr?.on('data', (data) => {
+        output += data.toString();
+      });
+
+      proc.on('error', (err) => {
+        clearTimeout(timeout);
+        reject(err);
+      });
+    });
+  }
+
+  private async _startCloudflared(port: number): Promise<{ url: string; process: ChildProcess }> {
+    return new Promise((resolve, reject) => {
+      const proc = spawn('cloudflared', ['tunnel', '--url', `http://localhost:${port}`], {
+        stdio: ['ignore', 'pipe', 'pipe'],
+      });
+
+      let output = '';
+      const timeout = setTimeout(() => {
+        reject(new Error('Timeout waiting for cloudflared URL'));
+      }, 30000);
+
+      // cloudflared outputs to stderr
+      proc.stderr?.on('data', (data) => {
+        output += data.toString();
+        // Look for the trycloudflare.com URL
+        const match = output.match(/(https?:\/\/[^\s]+\.trycloudflare\.com)/i);
+        if (match) {
+          clearTimeout(timeout);
+          resolve({ url: match[1], process: proc });
+        }
+      });
+
+      proc.stdout?.on('data', (data) => {
+        output += data.toString();
+      });
+
+      proc.on('error', (err) => {
+        clearTimeout(timeout);
+        reject(err);
+      });
+    });
+  }
+}

package/dist/security-scanner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"security-scanner.d.ts","sourceRoot":"","sources":["../src/security-scanner.ts"],"names":[],"mappings":"AAAA;;GAEG;AAUH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,GAAG,KAAK,GAAG,UAAU,GAAG,MAAM,GAAG,UAAU,CAAC;IAC5D,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,iBAAiB,EAAE,CAAC;IACrC,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,qBAAqB,EAAE,CAAC;IACtC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,eAAe;IAC1B;;OAEG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC;IAoChF;;OAEG;YACW,eAAe;IAuC7B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA2B9B;;OAEG;IACG,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAqB9D;;OAEG;IACH,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAU3C;;OAEG;IACH,iBAAiB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM;CAsBlD"}
+{"version":3,"file":"security-scanner.d.ts","sourceRoot":"","sources":["../src/security-scanner.ts"],"names":[],"mappings":"AAAA;;GAEG;AAsBH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,GAAG,KAAK,GAAG,UAAU,GAAG,MAAM,GAAG,UAAU,CAAC;IAC5D,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,iBAAiB,EAAE,CAAC;IACrC,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,qBAAqB,EAAE,CAAC;IACtC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,eAAe;IAC1B;;OAEG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC;IA4ChF;;OAEG;YACW,eAAe;IA0C7B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA2B9B;;OAEG;IACG,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAoB9D;;OAEG;IACH,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAe3C;;OAEG;IACH,iBAAiB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM;CAsBlD"}