@lark-sh/client 0.1.9 → 0.1.10

package/dist/index.d.mts

@@ -391,6 +391,13 @@ interface ConnectOptions {
      * - 'webtransport': Force WebTransport only (fails if unavailable)
      */
     transport?: TransportType;
+    /**
+     * Timeout for WebTransport connection attempt in milliseconds.
+     * If WebTransport doesn't connect within this time, falls back to WebSocket.
+     * Only applies when transport is 'auto'.
+     * Default: 2000 (2 seconds)
+     */
+    webtransportTimeout?: number;
 }
 interface AuthInfo {
     uid: string;

package/dist/index.d.ts

@@ -391,6 +391,13 @@ interface ConnectOptions {
      * - 'webtransport': Force WebTransport only (fails if unavailable)
      */
     transport?: TransportType;
+    /**
+     * Timeout for WebTransport connection attempt in milliseconds.
+     * If WebTransport doesn't connect within this time, falls back to WebSocket.
+     * Only applies when transport is 'auto'.
+     * Default: 2000 (2 seconds)
+     */
+    webtransportTimeout?: number;
 }
 interface AuthInfo {
     uid: string;

package/dist/index.js

@@ -405,18 +405,31 @@ async function createTransport(wsUrl, transportOptions, options = {}) {
   if (shouldTryWebTransport) {
     const wtUrl = wsUrlToWtUrl(wsUrl);
     const wtTransport = new WebTransportClient(transportOptions);
+    const timeout = options.webtransportTimeout ?? 2e3;
+    let timeoutId;
+    const timeoutPromise = new Promise((_, reject) => {
+      timeoutId = setTimeout(() => reject(new Error("WebTransport connection timeout")), timeout);
+    });
     try {
-      await wtTransport.connect(wtUrl);
+      await Promise.race([wtTransport.connect(wtUrl), timeoutPromise]);
       return {
         transport: wtTransport,
         type: "webtransport",
         url: wtUrl
       };
     } catch (err) {
+      try {
+        wtTransport.close();
+      } catch {
+      }
       if (preferredType === "webtransport") {
         throw err;
       }
       console.warn("WebTransport connection failed, falling back to WebSocket:", err);
+    } finally {
+      if (timeoutId !== void 0) {
+        clearTimeout(timeoutId);
+      }
     }
   }
   const wsTransport = new WebSocketTransport(transportOptions);
@@ -2803,7 +2816,10 @@ var LarkDatabase = class {
           onClose: this.handleClose.bind(this),
           onError: this.handleError.bind(this)
         },
-        { transport: options.transport }
+        {
+          transport: options.transport,
+          webtransportTimeout: options.webtransportTimeout
+        }
       );
       this.transport = transportResult.transport;
       this._transportType = transportResult.type;