@yushaw/sanqian-sdk 0.3.21 → 0.3.23

package/dist/index.mjs

@@ -502,6 +502,8 @@ var SanqianSDK = class _SanqianSDK {
   ]);
   // Connection promise for deduplication (prevents multiple concurrent connect attempts)
   connectingPromise = null;
+  // HTTP readiness promise for deduplication (prevents concurrent discovery/launch)
+  httpReadyPromise = null;
   // Reconnect reference count - when > 0, auto-reconnect is enabled
   // This allows multiple components to request persistent connections
   reconnectRefCount = 0;
@@ -628,6 +630,38 @@ var SanqianSDK = class _SanqianSDK {
     const token = info?.token;
     return token ? { "X-App-Token": token } : {};
   }
+  async ensureHttpReady() {
+    if (this.connectionInfo || this.config.connectionInfo) {
+      return;
+    }
+    if (this.httpReadyPromise) {
+      this.log("HTTP readiness already in progress, waiting...");
+      return this.httpReadyPromise;
+    }
+    this.httpReadyPromise = this.doEnsureHttpReady();
+    try {
+      await this.httpReadyPromise;
+    } finally {
+      this.httpReadyPromise = null;
+    }
+  }
+  async doEnsureHttpReady() {
+    const discovery = await this.getDiscovery();
+    let info = discovery.read();
+    if (!info) {
+      if (!this.config.autoLaunchSanqian) {
+        throw createSDKError("NOT_RUNNING" /* NOT_RUNNING */);
+      }
+      this.log("Sanqian not running, attempting to launch for HTTP API...");
+      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();
+    }
+    this.connectionInfo = info;
+  }
   /**
    * Get the port number for the Sanqian backend
    * @throws Error if not connected
@@ -639,6 +673,14 @@ var SanqianSDK = class _SanqianSDK {
     }
     return info.port;
   }
+  /**
+   * Get the HTTP base URL for Sanqian backend.
+   *
+   * @throws Error if connection info is not available
+   */
+  getBaseUrl() {
+    return this.getHttpBaseUrl();
+  }
   constructor(config) {
     const requestedSecurityLevel = this.normalizeRequestedSecurityLevel(
       config.requestedSecurityLevel
@@ -1529,26 +1571,10 @@ var SanqianSDK = class _SanqianSDK {
    */
   async doFullConnect() {
     this.log("Starting full connection flow...");
-    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 */);
-        }
-      }
+    await this.ensureHttpReady();
+    const info = this.connectionInfo || this.config.connectionInfo;
+    if (!info) {
+      throw createSDKError("NOT_RUNNING" /* NOT_RUNNING */);
     }
     await this.connectWithInfo(info);
   }
@@ -2437,7 +2463,7 @@ var SanqianSDK = class _SanqianSDK {
   // Channels
   // ============================================
   async listChannelPlugins() {
-    await this.ensureReady();
+    await this.ensureHttpReady();
     const url = `${this.getHttpBaseUrl()}/api/channels/plugins`;
     const response = await fetch(url, { headers: this.getHttpAuthHeaders() });
     if (!response.ok) {
@@ -2446,7 +2472,7 @@ var SanqianSDK = class _SanqianSDK {
     return response.json();
   }
   async listChannelAccounts() {
-    await this.ensureReady();
+    await this.ensureHttpReady();
     const url = `${this.getHttpBaseUrl()}/api/channels/accounts`;
     const response = await fetch(url, { headers: this.getHttpAuthHeaders() });
     if (!response.ok) {
@@ -2455,7 +2481,7 @@ var SanqianSDK = class _SanqianSDK {
     return response.json();
   }
   async createChannelAccount(req) {
-    await this.ensureReady();
+    await this.ensureHttpReady();
     const url = `${this.getHttpBaseUrl()}/api/channels/accounts`;
     const response = await fetch(url, {
       method: "POST",
@@ -2469,7 +2495,7 @@ var SanqianSDK = class _SanqianSDK {
     return response.json();
   }
   async getChannelAccount(id) {
-    await this.ensureReady();
+    await this.ensureHttpReady();
     const url = `${this.getHttpBaseUrl()}/api/channels/accounts/${encodeURIComponent(id)}`;
     const response = await fetch(url, { headers: this.getHttpAuthHeaders() });
     if (!response.ok) {
@@ -2478,7 +2504,7 @@ var SanqianSDK = class _SanqianSDK {
     return response.json();
   }
   async updateChannelAccount(id, req) {
-    await this.ensureReady();
+    await this.ensureHttpReady();
     const url = `${this.getHttpBaseUrl()}/api/channels/accounts/${encodeURIComponent(id)}`;
     const response = await fetch(url, {
       method: "PUT",
@@ -2492,7 +2518,7 @@ var SanqianSDK = class _SanqianSDK {
     return response.json();
   }
   async deleteChannelAccount(id) {
-    await this.ensureReady();
+    await this.ensureHttpReady();
     const url = `${this.getHttpBaseUrl()}/api/channels/accounts/${encodeURIComponent(id)}`;
     const response = await fetch(url, { method: "DELETE", headers: this.getHttpAuthHeaders() });
     if (!response.ok) {
@@ -2500,7 +2526,7 @@ var SanqianSDK = class _SanqianSDK {
     }
   }
   async startChannelAccount(id) {
-    await this.ensureReady();
+    await this.ensureHttpReady();
     const url = `${this.getHttpBaseUrl()}/api/channels/accounts/${encodeURIComponent(id)}/start`;
     const response = await fetch(url, { method: "POST", headers: this.getHttpAuthHeaders() });
     if (!response.ok) {
@@ -2510,7 +2536,7 @@ var SanqianSDK = class _SanqianSDK {
     return response.json();
   }
   async stopChannelAccount(id) {
-    await this.ensureReady();
+    await this.ensureHttpReady();
     const url = `${this.getHttpBaseUrl()}/api/channels/accounts/${encodeURIComponent(id)}/stop`;
     const response = await fetch(url, { method: "POST", headers: this.getHttpAuthHeaders() });
     if (!response.ok) {
@@ -2519,7 +2545,7 @@ var SanqianSDK = class _SanqianSDK {
     return response.json();
   }
   async getChannelStatus(id) {
-    await this.ensureReady();
+    await this.ensureHttpReady();
     const url = `${this.getHttpBaseUrl()}/api/channels/accounts/${encodeURIComponent(id)}/status`;
     const response = await fetch(url, { headers: this.getHttpAuthHeaders() });
     if (!response.ok) {
@@ -2528,7 +2554,7 @@ var SanqianSDK = class _SanqianSDK {
     return response.json();
   }
   async probeChannelAccount(id) {
-    await this.ensureReady();
+    await this.ensureHttpReady();
     const url = `${this.getHttpBaseUrl()}/api/channels/accounts/${encodeURIComponent(id)}/probe`;
     const response = await fetch(url, { method: "POST", headers: this.getHttpAuthHeaders() });
     if (!response.ok) {
@@ -2537,8 +2563,32 @@ var SanqianSDK = class _SanqianSDK {
     }
     return response.json();
   }
+  async probeChannelConfig(req) {
+    await this.ensureHttpReady();
+    const url = `${this.getHttpBaseUrl()}/api/channels/probe-config`;
+    const response = await fetch(url, {
+      method: "POST",
+      headers: { ...this.getHttpAuthHeaders(), "Content-Type": "application/json" },
+      body: JSON.stringify(req)
+    });
+    if (!response.ok) {
+      const detail = await response.text();
+      throw createSDKError("REQUEST_FAILED" /* REQUEST_FAILED */, `Failed to probe channel config: ${detail}`);
+    }
+    return response.json();
+  }
+  async getChannelConfigSchema(channelType) {
+    await this.ensureHttpReady();
+    const url = `${this.getHttpBaseUrl()}/api/channels/plugins/${encodeURIComponent(channelType)}/config-schema`;
+    const response = await fetch(url, { headers: this.getHttpAuthHeaders() });
+    if (!response.ok) {
+      const detail = await response.text();
+      throw createSDKError("REQUEST_FAILED" /* REQUEST_FAILED */, `Failed to get channel config schema: ${detail}`);
+    }
+    return response.json();
+  }
   async listChannelBindings(accountId) {
-    await this.ensureReady();
+    await this.ensureHttpReady();
     const params = accountId ? `?account_id=${encodeURIComponent(accountId)}` : "";
     const url = `${this.getHttpBaseUrl()}/api/channels/bindings${params}`;
     const response = await fetch(url, { headers: this.getHttpAuthHeaders() });
@@ -2548,7 +2598,7 @@ var SanqianSDK = class _SanqianSDK {
     return response.json();
   }
   async createChannelBinding(req) {
-    await this.ensureReady();
+    await this.ensureHttpReady();
     const url = `${this.getHttpBaseUrl()}/api/channels/bindings`;
     const response = await fetch(url, {
       method: "POST",
@@ -2562,7 +2612,7 @@ var SanqianSDK = class _SanqianSDK {
     return response.json();
   }
   async updateChannelBinding(id, req) {
-    await this.ensureReady();
+    await this.ensureHttpReady();
     const url = `${this.getHttpBaseUrl()}/api/channels/bindings/${encodeURIComponent(id)}`;
     const response = await fetch(url, {
       method: "PUT",
@@ -2576,7 +2626,7 @@ var SanqianSDK = class _SanqianSDK {
     return response.json();
   }
   async deleteChannelBinding(id) {
-    await this.ensureReady();
+    await this.ensureHttpReady();
     const url = `${this.getHttpBaseUrl()}/api/channels/bindings/${encodeURIComponent(id)}`;
     const response = await fetch(url, { method: "DELETE", headers: this.getHttpAuthHeaders() });
     if (!response.ok) {
@@ -2584,7 +2634,7 @@ var SanqianSDK = class _SanqianSDK {
     }
   }
   async sendChannelMessage(req) {
-    await this.ensureReady();
+    await this.ensureHttpReady();
     const url = `${this.getHttpBaseUrl()}/api/channels/send`;
     const response = await fetch(url, {
       method: "POST",