@yushaw/sanqian-sdk 0.2.9 → 0.2.11

package/dist/index.mjs

@@ -1,272 +1,293 @@
-// src/client.ts
-import WebSocket from "ws";
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __esm = (fn, res) => function __init() {
+  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
 
 // src/discovery.ts
+var discovery_exports = {};
+__export(discovery_exports, {
+  DiscoveryManager: () => DiscoveryManager
+});
 import { existsSync, readFileSync, watch } from "fs";
 import { homedir, platform } from "os";
 import { join } from "path";
 import { spawn, execSync } from "child_process";
-var DiscoveryManager = class {
-  connectionInfo = null;
-  watcher = null;
-  onChange = null;
-  pollInterval = null;
-  /**
-   * Cached executable path from last successful connection.json read.
-   * Persists even when Sanqian is not running, for use in auto-launch.
-   */
-  cachedExecutable = null;
-  /**
-   * Get the path to connection.json
-   */
-  getConnectionFilePath() {
-    return join(homedir(), ".sanqian", "runtime", "connection.json");
-  }
-  /**
-   * Read and validate connection info
-   *
-   * Returns null if:
-   * - File doesn't exist
-   * - File is invalid JSON
-   * - Process is not running
-   */
-  read() {
-    const filePath = this.getConnectionFilePath();
-    if (!existsSync(filePath)) {
-      return null;
-    }
-    try {
-      const content = readFileSync(filePath, "utf-8");
-      const info = JSON.parse(content);
-      if (!info.port || !info.token || !info.pid) {
-        return null;
-      }
-      if (info.executable) {
-        this.cachedExecutable = info.executable;
-      }
-      if (!this.isProcessRunning(info.pid)) {
-        return null;
+var DiscoveryManager;
+var init_discovery = __esm({
+  "src/discovery.ts"() {
+    "use strict";
+    DiscoveryManager = class {
+      connectionInfo = null;
+      watcher = null;
+      onChange = null;
+      pollInterval = null;
+      /**
+       * Cached executable path from last successful connection.json read.
+       * Persists even when Sanqian is not running, for use in auto-launch.
+       */
+      cachedExecutable = null;
+      /**
+       * Get the path to connection.json
+       */
+      getConnectionFilePath() {
+        return join(homedir(), ".sanqian", "runtime", "connection.json");
       }
-      this.connectionInfo = info;
-      return info;
-    } catch {
-      return null;
-    }
-  }
-  /**
-   * Start watching for connection file changes
-   */
-  startWatching(onChange) {
-    this.onChange = onChange;
-    const dir = join(homedir(), ".sanqian", "runtime");
-    if (!existsSync(dir)) {
-      this.pollInterval = setInterval(() => {
-        if (existsSync(dir)) {
-          if (this.pollInterval) {
-            clearInterval(this.pollInterval);
-            this.pollInterval = null;
+      /**
+       * Read and validate connection info
+       *
+       * Returns null if:
+       * - File doesn't exist
+       * - File is invalid JSON
+       * - Process is not running
+       */
+      read() {
+        const filePath = this.getConnectionFilePath();
+        if (!existsSync(filePath)) {
+          return null;
+        }
+        try {
+          const content = readFileSync(filePath, "utf-8");
+          const info = JSON.parse(content);
+          if (!info.port || !info.token || !info.pid) {
+            return null;
+          }
+          if (info.executable) {
+            this.cachedExecutable = info.executable;
           }
-          this.setupWatcher(dir);
+          if (!this.isProcessRunning(info.pid)) {
+            return null;
+          }
+          this.connectionInfo = info;
+          return info;
+        } catch {
+          return null;
         }
-      }, 2e3);
-      return;
-    }
-    this.setupWatcher(dir);
-  }
-  setupWatcher(dir) {
-    try {
-      this.watcher = watch(dir, (event, filename) => {
-        if (filename === "connection.json") {
-          setTimeout(() => {
-            const newInfo = this.read();
-            const oldInfoStr = JSON.stringify(this.connectionInfo);
-            const newInfoStr = JSON.stringify(newInfo);
-            if (oldInfoStr !== newInfoStr) {
-              this.connectionInfo = newInfo;
-              this.onChange?.(newInfo);
+      }
+      /**
+       * Start watching for connection file changes
+       */
+      startWatching(onChange) {
+        this.onChange = onChange;
+        const dir = join(homedir(), ".sanqian", "runtime");
+        if (!existsSync(dir)) {
+          this.pollInterval = setInterval(() => {
+            if (existsSync(dir)) {
+              if (this.pollInterval) {
+                clearInterval(this.pollInterval);
+                this.pollInterval = null;
+              }
+              this.setupWatcher(dir);
             }
-          }, 100);
+          }, 2e3);
+          return;
         }
-      });
-    } catch (e) {
-      console.error("Failed to watch connection file:", e);
-    }
-  }
-  /**
-   * Stop watching
-   */
-  stopWatching() {
-    if (this.pollInterval) {
-      clearInterval(this.pollInterval);
-      this.pollInterval = null;
-    }
-    this.watcher?.close();
-    this.watcher = null;
-    this.onChange = null;
-  }
-  /**
-   * Check if a process is running by PID
-   *
-   * Cross-platform implementation:
-   * - macOS/Linux: process.kill(pid, 0) works correctly
-   * - Windows: process.kill(pid, 0) can give false positives due to PID reuse,
-   *   so we use tasklist command for reliable checking
-   */
-  isProcessRunning(pid) {
-    try {
-      if (platform() === "win32") {
+        this.setupWatcher(dir);
+      }
+      setupWatcher(dir) {
         try {
-          const result = execSync(`tasklist /FI "PID eq ${pid}" /NH`, {
-            encoding: "utf-8",
-            stdio: ["pipe", "pipe", "pipe"]
+          this.watcher = watch(dir, (event, filename) => {
+            if (filename === "connection.json") {
+              setTimeout(() => {
+                const newInfo = this.read();
+                const oldInfoStr = JSON.stringify(this.connectionInfo);
+                const newInfoStr = JSON.stringify(newInfo);
+                if (oldInfoStr !== newInfoStr) {
+                  this.connectionInfo = newInfo;
+                  this.onChange?.(newInfo);
+                }
+              }, 100);
+            }
           });
-          const trimmed = result.trim();
-          if (!trimmed || trimmed.toUpperCase().startsWith("INFO")) {
-            return false;
+        } catch (e) {
+          console.error("Failed to watch connection file:", e);
+        }
+      }
+      /**
+       * Stop watching
+       */
+      stopWatching() {
+        if (this.pollInterval) {
+          clearInterval(this.pollInterval);
+          this.pollInterval = null;
+        }
+        this.watcher?.close();
+        this.watcher = null;
+        this.onChange = null;
+      }
+      /**
+       * Check if a process is running by PID
+       *
+       * Cross-platform implementation:
+       * - macOS/Linux: process.kill(pid, 0) works correctly
+       * - Windows: process.kill(pid, 0) can give false positives due to PID reuse,
+       *   so we use tasklist command for reliable checking
+       */
+      isProcessRunning(pid) {
+        try {
+          if (platform() === "win32") {
+            try {
+              const result = execSync(`tasklist /FI "PID eq ${pid}" /NH`, {
+                encoding: "utf-8",
+                stdio: ["pipe", "pipe", "pipe"]
+              });
+              const trimmed = result.trim();
+              if (!trimmed || trimmed.toUpperCase().startsWith("INFO")) {
+                return false;
+              }
+              return new RegExp(`\\b${pid}\\b`).test(trimmed);
+            } catch {
+              return false;
+            }
+          } else {
+            process.kill(pid, 0);
+            return true;
           }
-          return new RegExp(`\\b${pid}\\b`).test(trimmed);
         } catch {
           return false;
         }
-      } else {
-        process.kill(pid, 0);
-        return true;
       }
-    } catch {
-      return false;
-    }
-  }
-  /**
-   * Get cached connection info (may be stale)
-   */
-  getCached() {
-    return this.connectionInfo;
-  }
-  /**
-   * Build WebSocket URL from connection info
-   */
-  buildWebSocketUrl(info) {
-    return `ws://127.0.0.1:${info.port}${info.ws_path}?token=${info.token}`;
-  }
-  /**
-   * Build HTTP base URL from connection info
-   */
-  buildHttpUrl(info) {
-    return `http://127.0.0.1:${info.port}`;
-  }
-  /**
-   * Find Sanqian executable path
-   * Searches in standard installation locations for each platform
-   */
-  findSanqianPath(customPath) {
-    if (customPath) {
-      if (existsSync(customPath)) {
-        return customPath;
+      /**
+       * Get cached connection info (may be stale)
+       */
+      getCached() {
+        return this.connectionInfo;
       }
-      console.warn(`[SDK] Custom Sanqian path not found: ${customPath}`);
-      return null;
-    }
-    const os = platform();
-    const searchPaths = [];
-    if (os === "darwin") {
-      searchPaths.push(
-        // Production: installed app
-        "/Applications/Sanqian.app/Contents/MacOS/Sanqian",
-        join(homedir(), "Applications/Sanqian.app/Contents/MacOS/Sanqian"),
-        // Development: electron-builder output
-        join(homedir(), "dev/sanqian/dist/mac-arm64/Sanqian.app/Contents/MacOS/Sanqian"),
-        join(homedir(), "dev/sanqian/dist/mac/Sanqian.app/Contents/MacOS/Sanqian")
-      );
-    } else if (os === "win32") {
-      const programFiles = process.env.PROGRAMFILES || "C:\\Program Files";
-      const programFilesX86 = process.env["PROGRAMFILES(X86)"] || "C:\\Program Files (x86)";
-      const localAppData = process.env.LOCALAPPDATA || join(homedir(), "AppData", "Local");
-      searchPaths.push(
-        // Production: NSIS installer uses lowercase directory name from package.json "name"
-        join(localAppData, "Programs", "sanqian", "Sanqian.exe"),
-        // Legacy/alternative paths with uppercase
-        join(localAppData, "Programs", "Sanqian", "Sanqian.exe"),
-        join(programFiles, "Sanqian", "Sanqian.exe"),
-        join(programFilesX86, "Sanqian", "Sanqian.exe"),
-        // Development: electron-builder output
-        join(homedir(), "dev", "sanqian", "dist", "win-unpacked", "Sanqian.exe")
-      );
-    } else {
-      searchPaths.push(
-        "/usr/bin/sanqian",
-        "/usr/local/bin/sanqian",
-        join(homedir(), ".local/bin/sanqian"),
-        "/opt/Sanqian/sanqian",
-        // Development
-        join(homedir(), "dev/sanqian/dist/linux-unpacked/sanqian")
-      );
-    }
-    for (const path of searchPaths) {
-      if (existsSync(path)) {
-        return path;
+      /**
+       * Build WebSocket URL from connection info
+       */
+      buildWebSocketUrl(info) {
+        const wsPath = info.ws_path || "/ws/apps";
+        return `ws://127.0.0.1:${info.port}${wsPath}?token=${info.token}`;
       }
-    }
-    return null;
-  }
-  /**
-   * Launch Sanqian in hidden/tray mode
-   * Returns true if launch was initiated successfully
-   *
-   * Priority for finding Sanqian executable:
-   * 1. customPath parameter (if provided)
-   * 2. Cached executable from connection.json (most reliable)
-   * 3. Search in standard installation locations (fallback)
-   */
-  launchSanqian(customPath) {
-    let sanqianPath = null;
-    if (customPath) {
-      sanqianPath = this.findSanqianPath(customPath);
-    } else if (this.cachedExecutable && existsSync(this.cachedExecutable)) {
-      sanqianPath = this.cachedExecutable;
-      console.log(`[SDK] Using cached executable: ${sanqianPath}`);
-    } else {
-      sanqianPath = this.findSanqianPath();
-    }
-    if (!sanqianPath) {
-      console.error("[SDK] Sanqian executable not found");
-      return false;
-    }
-    console.log(`[SDK] Launching Sanqian from: ${sanqianPath}`);
-    try {
-      const os = platform();
-      if (os === "darwin") {
-        const appPath = sanqianPath.replace(
-          "/Contents/MacOS/Sanqian",
-          ""
-        );
-        spawn("open", ["-g", "-a", appPath, "--args", "--hidden"], {
-          detached: true,
-          stdio: "ignore"
-        }).unref();
-      } else {
-        spawn(sanqianPath, ["--hidden"], {
-          detached: true,
-          stdio: "ignore",
-          // On Windows, hide the console window
-          ...os === "win32" && {
-            windowsHide: true,
-            shell: false
+      /**
+       * Build HTTP base URL from connection info
+       */
+      buildHttpUrl(info) {
+        return `http://127.0.0.1:${info.port}`;
+      }
+      /**
+       * Find Sanqian executable path
+       * Searches in standard installation locations for each platform
+       */
+      findSanqianPath(customPath) {
+        if (customPath) {
+          if (existsSync(customPath)) {
+            return customPath;
+          }
+          console.warn(`[SDK] Custom Sanqian path not found: ${customPath}`);
+          return null;
+        }
+        const os = platform();
+        const searchPaths = [];
+        if (os === "darwin") {
+          searchPaths.push(
+            // Production: installed app
+            "/Applications/Sanqian.app/Contents/MacOS/Sanqian",
+            join(homedir(), "Applications/Sanqian.app/Contents/MacOS/Sanqian"),
+            // Development: electron-builder output
+            join(homedir(), "dev/sanqian/dist/mac-arm64/Sanqian.app/Contents/MacOS/Sanqian"),
+            join(homedir(), "dev/sanqian/dist/mac/Sanqian.app/Contents/MacOS/Sanqian")
+          );
+        } else if (os === "win32") {
+          const programFiles = process.env.PROGRAMFILES || "C:\\Program Files";
+          const programFilesX86 = process.env["PROGRAMFILES(X86)"] || "C:\\Program Files (x86)";
+          const localAppData = process.env.LOCALAPPDATA || join(homedir(), "AppData", "Local");
+          searchPaths.push(
+            // Production: NSIS installer uses lowercase directory name from package.json "name"
+            join(localAppData, "Programs", "sanqian", "Sanqian.exe"),
+            // Legacy/alternative paths with uppercase
+            join(localAppData, "Programs", "Sanqian", "Sanqian.exe"),
+            join(programFiles, "Sanqian", "Sanqian.exe"),
+            join(programFilesX86, "Sanqian", "Sanqian.exe"),
+            // Development: electron-builder output
+            join(homedir(), "dev", "sanqian", "dist", "win-unpacked", "Sanqian.exe")
+          );
+        } else {
+          searchPaths.push(
+            "/usr/bin/sanqian",
+            "/usr/local/bin/sanqian",
+            join(homedir(), ".local/bin/sanqian"),
+            "/opt/Sanqian/sanqian",
+            // Development
+            join(homedir(), "dev/sanqian/dist/linux-unpacked/sanqian")
+          );
+        }
+        for (const path of searchPaths) {
+          if (existsSync(path)) {
+            return path;
           }
-        }).unref();
+        }
+        return null;
       }
-      return true;
-    } catch (e) {
-      console.error("[SDK] Failed to launch Sanqian:", e);
-      return false;
-    }
-  }
-  /**
-   * Check if Sanqian is running
-   */
-  isSanqianRunning() {
-    return this.read() !== null;
+      /**
+       * Launch Sanqian in hidden/tray mode
+       * Returns true if launch was initiated successfully
+       *
+       * Priority for finding Sanqian executable:
+       * 1. customPath parameter (if provided)
+       * 2. Cached executable from connection.json (most reliable)
+       * 3. Search in standard installation locations (fallback)
+       */
+      launchSanqian(customPath) {
+        let sanqianPath = null;
+        if (customPath) {
+          sanqianPath = this.findSanqianPath(customPath);
+        } else if (this.cachedExecutable && existsSync(this.cachedExecutable)) {
+          sanqianPath = this.cachedExecutable;
+          console.log(`[SDK] Using cached executable: ${sanqianPath}`);
+        } else {
+          sanqianPath = this.findSanqianPath();
+        }
+        if (!sanqianPath) {
+          console.error("[SDK] Sanqian executable not found");
+          return false;
+        }
+        console.log(`[SDK] Launching Sanqian from: ${sanqianPath}`);
+        try {
+          const os = platform();
+          if (os === "darwin") {
+            const appPath = sanqianPath.replace(
+              "/Contents/MacOS/Sanqian",
+              ""
+            );
+            spawn("open", ["-g", "-a", appPath, "--args", "--hidden"], {
+              detached: true,
+              stdio: "ignore"
+            }).unref();
+          } else {
+            spawn(sanqianPath, ["--hidden"], {
+              detached: true,
+              stdio: "ignore",
+              // On Windows, hide the console window
+              ...os === "win32" && {
+                windowsHide: true,
+                shell: false
+              }
+            }).unref();
+          }
+          return true;
+        } catch (e) {
+          console.error("[SDK] Failed to launch Sanqian:", e);
+          return false;
+        }
+      }
+      /**
+       * Check if Sanqian is running
+       */
+      isSanqianRunning() {
+        return this.read() !== null;
+      }
+    };
   }
-};
+});
+
+// src/client.ts
+import WebSocket from "isomorphic-ws";
 
 // src/errors.ts
 var SANQIAN_WEBSITE = "https://sanqian.io";
@@ -437,7 +458,8 @@ function createSDKError(code, details) {
 // src/client.ts
 var SanqianSDK = class _SanqianSDK {
   config;
-  discovery;
+  // DiscoveryManager is only initialized in Node.js environments (when connectionInfo is not provided)
+  discovery = null;
   ws = null;
   connectionInfo = null;
   state = {
@@ -493,11 +515,10 @@ var SanqianSDK = class _SanqianSDK {
       autoLaunchSanqian: true,
       ...config
     };
-    this.discovery = new DiscoveryManager();
     for (const tool of config.tools) {
       this.toolHandlers.set(tool.name, tool.handler);
     }
-    this.launchedBySanqian = typeof process !== "undefined" && process.env?.SANQIAN_NO_RECONNECT === "1";
+    this.launchedBySanqian = typeof process !== "undefined" && (process.env?.SANQIAN_LAUNCHED === "1" || process.env?.SANQIAN_NO_RECONNECT === "1");
     if (this.launchedBySanqian) {
       this.log("Detected launch by Sanqian, will connect immediately without auto-reconnect");
       setTimeout(() => {
@@ -507,6 +528,26 @@ var SanqianSDK = class _SanqianSDK {
       }, 0);
     }
   }
+  /**
+   * Build WebSocket URL from connection info
+   * This is inlined to avoid importing DiscoveryManager in browser environments
+   */
+  buildWebSocketUrl(info) {
+    const wsPath = info.ws_path || "/ws/apps";
+    return `ws://127.0.0.1:${info.port}${wsPath}?token=${info.token}`;
+  }
+  /**
+   * Lazily initialize DiscoveryManager (only in Node.js environments)
+   * This uses dynamic import to avoid bundling Node.js APIs in browser builds
+   */
+  async getDiscovery() {
+    if (this.discovery) {
+      return this.discovery;
+    }
+    const { DiscoveryManager: DiscoveryManager2 } = await Promise.resolve().then(() => (init_discovery(), discovery_exports));
+    this.discovery = new DiscoveryManager2();
+    return this.discovery;
+  }
   // ============================================
   // Lifecycle
   // ============================================
@@ -530,7 +571,7 @@ var SanqianSDK = class _SanqianSDK {
    */
   async connectWithInfo(info) {
     this.connectionInfo = info;
-    const url = this.discovery.buildWebSocketUrl(info);
+    const url = this.buildWebSocketUrl(info);
     return new Promise((resolve, reject) => {
       this.log(`Connecting to ${url}`);
       this.ws = new WebSocket(url);
@@ -538,7 +579,7 @@ var SanqianSDK = class _SanqianSDK {
         reject(createSDKError("CONNECTION_TIMEOUT" /* CONNECTION_TIMEOUT */));
         this.ws?.close();
       }, 1e4);
-      this.ws.on("open", async () => {
+      this.ws.onopen = async () => {
         clearTimeout(connectTimeout);
         this.log("WebSocket connected");
         this.state.connected = true;
@@ -550,24 +591,28 @@ var SanqianSDK = class _SanqianSDK {
         } catch (e) {
           reject(e);
         }
-      });
-      this.ws.on("close", (code, reason) => {
-        this.log(`WebSocket closed: ${code} ${reason.toString()}`);
-        this.handleDisconnect(reason.toString());
-      });
-      this.ws.on("error", (error) => {
+      };
+      this.ws.onclose = (event) => {
+        const reasonRaw = event.reason;
+        const reason = typeof reasonRaw === "string" ? reasonRaw : reasonRaw?.toString() || "";
+        this.log(`WebSocket closed: ${event.code} ${reason}`);
+        this.handleDisconnect(reason);
+      };
+      this.ws.onerror = (event) => {
+        const error = event.error || new Error("WebSocket error");
         console.error("[SDK] WebSocket error:", error);
         this.state.lastError = error;
         this.emit("error", error);
-      });
-      this.ws.on("message", (data) => {
+      };
+      this.ws.onmessage = (event) => {
         try {
-          const message = JSON.parse(data.toString());
+          const data = typeof event.data === "string" ? event.data : event.data.toString();
+          const message = JSON.parse(data);
           this.handleMessage(message);
         } catch (e) {
           this.warn("Failed to parse message:", e);
         }
-      });
+      };
     });
   }
   /**
@@ -576,7 +621,7 @@ var SanqianSDK = class _SanqianSDK {
   async disconnect() {
     this.stopHeartbeat();
     this.stopReconnect();
-    this.discovery.stopWatching();
+    this.discovery?.stopWatching();
     if (this.ws) {
       this.ws.close(1e3, "Client disconnect");
       this.ws = null;
@@ -952,18 +997,25 @@ var SanqianSDK = class _SanqianSDK {
    */
   async doFullConnect() {
     this.log("Starting full connection flow...");
-    let info = this.discovery.read();
-    if (!info) {
-      if (this.config.autoLaunchSanqian) {
-        this.log("Sanqian not running, attempting to launch...");
-        const launched = this.discovery.launchSanqian(this.config.sanqianPath);
-        if (!launched) {
-          throw createSDKError("NOT_INSTALLED" /* NOT_INSTALLED */);
+    let info = null;
+    if (this.config.connectionInfo) {
+      this.log("Using pre-configured connection info (browser mode)");
+      info = this.config.connectionInfo;
+    } else {
+      const discovery = await this.getDiscovery();
+      info = discovery.read();
+      if (!info) {
+        if (this.config.autoLaunchSanqian) {
+          this.log("Sanqian not running, attempting to launch...");
+          const launched = discovery.launchSanqian(this.config.sanqianPath);
+          if (!launched) {
+            throw createSDKError("NOT_INSTALLED" /* NOT_INSTALLED */);
+          }
+          this.log("Sanqian launch initiated, waiting for startup...");
+          info = await this.waitForSanqianStartup();
+        } else {
+          throw createSDKError("NOT_RUNNING" /* NOT_RUNNING */);
         }
-        this.log("Sanqian launch initiated, waiting for startup...");
-        info = await this.waitForSanqianStartup();
-      } else {
-        throw createSDKError("NOT_RUNNING" /* NOT_RUNNING */);
       }
     }
     await this.connectWithInfo(info);
@@ -974,8 +1026,9 @@ var SanqianSDK = class _SanqianSDK {
   async waitForSanqianStartup(timeout = 12e4) {
     const startTime = Date.now();
     const pollInterval = 500;
+    const discovery = await this.getDiscovery();
     while (Date.now() - startTime < timeout) {
-      const info = this.discovery.read();
+      const info = discovery.read();
       if (info) {
         this.log("Sanqian started, connection info available");
         return info;
@@ -1324,6 +1377,20 @@ var SanqianSDK = class _SanqianSDK {
     });
     return this.on(event, onceWrapper);
   }
+  /**
+   * Remove all event listeners
+   *
+   * Call this to prevent memory leaks when disposing the SDK instance.
+   * If event is specified, only removes listeners for that event.
+   */
+  removeAllListeners(event) {
+    if (event) {
+      this.eventListeners.delete(event);
+    } else {
+      this.eventListeners.clear();
+    }
+    return this;
+  }
   emit(event, ...args) {
     const listeners = this.eventListeners.get(event);
     if (listeners) {
@@ -1424,6 +1491,9 @@ var Conversation = class {
     });
   }
 };
+
+// src/index.ts
+init_discovery();
 export {
   Conversation,
   DiscoveryManager,