@alibaba-group/opensandbox 0.1.0-dev2 → 0.1.0-dev3

package/README.md

@@ -165,6 +165,10 @@ console.log(list.items.map((s) => s.id));
 
 The `ConnectionConfig` class manages API server connection settings.
 
+Runtime notes:
+- In browsers, the SDK uses the global `fetch` implementation.
+- In Node.js, the SDK creates a dedicated internal `fetch` backed by an isolated connection pool.
+
 | Parameter | Description | Default | Environment Variable |
 | --- | --- | --- | --- |
 | `apiKey` | API key for authentication | Optional | `OPEN_SANDBOX_API_KEY` |

package/dist/adapters/sse.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../src/adapters/sse.ts"],"names":[],"mappings":"AAwBA;;;;GAIG;AACH,wBAAuB,oBAAoB,CAAC,CAAC,EAC3C,GAAG,EAAE,QAAQ,EACb,IAAI,CAAC,EAAE;IAAE,oBAAoB,CAAC,EAAE,MAAM,CAAA;CAAE,GACvC,aAAa,CAAC,CAAC,CAAC,CA2DlB"}
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../src/adapters/sse.ts"],"names":[],"mappings":"AAwBA;;;;GAIG;AACH,wBAAuB,oBAAoB,CAAC,CAAC,EAC3C,GAAG,EAAE,QAAQ,EACb,IAAI,CAAC,EAAE;IAAE,oBAAoB,CAAC,EAAE,MAAM,CAAA;CAAE,GACvC,aAAa,CAAC,CAAC,CAAC,CA8DlB"}

package/dist/adapters/sse.js

@@ -73,6 +73,8 @@ export async function* parseJsonEventStream(res, opts) {
             yield parsed;
         }
     }
+    // Flush any buffered UTF-8 bytes from the decoder.
+    buf += decoder.decode();
     // flush last line if exists
     const last = buf.trim();
     if (last) {

package/dist/config/connection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../src/config/connection.ts"],"names":[],"mappings":"AAcA,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,OAAO,CAAC;AAElD;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;;;;;;OAQG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEjC;;;OAGG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAkGD,qBAAa,gBAAgB;IAC3B,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,QAAQ,CAAC,KAAK,EAAE,OAAO,KAAK,CAAC;IAC7B;;;;;;OAMG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,KAAK,CAAC;IAChC,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAA8B;IAExD;;;;;;OAMG;gBACS,IAAI,GAAE,uBAA4B;IAmD9C,UAAU,IAAI,MAAM;CAOrB"}
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../src/config/connection.ts"],"names":[],"mappings":"AAcA,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,OAAO,CAAC;AAElD;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;;;;;;OAQG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEjC;;;OAGG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AA2KD,qBAAa,gBAAgB;IAC3B,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,QAAQ,CAAC,KAAK,EAAE,OAAO,KAAK,CAAC;IAC7B;;;;;;OAMG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,KAAK,CAAC;IAChC,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAA8B;IAExD;;;;;;OAMG;gBACS,IAAI,GAAE,uBAA4B;IAyD9C,UAAU,IAAI,MAAM;CAUrB"}

package/dist/config/connection.js

@@ -1,11 +1,11 @@
 // Copyright 2026 Alibaba Group Holding Ltd.
-// 
+//
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
 // You may obtain a copy of the License at
-// 
+//
 //     http://www.apache.org/licenses/LICENSE-2.0
-// 
+//
 // Unless required by applicable law or agreed to in writing, software
 // distributed under the License is distributed on an "AS IS" BASIS,
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
@@ -13,7 +13,7 @@
 // limitations under the License.
 function isNodeRuntime() {
     const p = globalThis?.process;
-    return !!(p?.versions?.node);
+    return !!p?.versions?.node;
 }
 function redactHeaders(headers) {
     const out = { ...headers };
@@ -35,6 +35,7 @@ function stripV1Suffix(s) {
     const trimmed = stripTrailingSlashes(s);
     return trimmed.endsWith("/v1") ? trimmed.slice(0, -3) : trimmed;
 }
+const DEFAULT_KEEPALIVE_TIMEOUT_MS = 15_000;
 function normalizeDomainBase(input) {
     // Accept a full URL and preserve its path prefix (if any).
     if (input.startsWith("http://") || input.startsWith("https://")) {
@@ -47,6 +48,42 @@ function normalizeDomainBase(input) {
     // No scheme: treat as "host[:port]" or "host[:port]/prefix" and normalize trailing "/v1" or "/".
     return { domainBase: stripV1Suffix(input) };
 }
+function createNodeFetch() {
+    if (!isNodeRuntime()) {
+        return fetch;
+    }
+    let dispatcher;
+    let dispatcherPromise = null;
+    const baseFetch = fetch;
+    return async (input, init) => {
+        dispatcherPromise ??= (async () => {
+            try {
+                const mod = await import("undici");
+                const Agent = mod
+                    .Agent;
+                if (!Agent) {
+                    return undefined;
+                }
+                dispatcher = new Agent({
+                    keepAliveTimeout: DEFAULT_KEEPALIVE_TIMEOUT_MS,
+                    keepAliveMaxTimeout: DEFAULT_KEEPALIVE_TIMEOUT_MS,
+                });
+                return dispatcher;
+            }
+            catch {
+                return undefined;
+            }
+        })();
+        if (dispatcherPromise) {
+            await dispatcherPromise;
+        }
+        if (dispatcher) {
+            const mergedInit = { ...(init ?? {}), dispatcher };
+            return baseFetch(input, mergedInit);
+        }
+        return baseFetch(input, init);
+    };
+}
 function createTimedFetch(opts) {
     const baseFetch = opts.baseFetch;
     const timeoutSeconds = opts.timeoutSeconds;
@@ -55,7 +92,9 @@ function createTimedFetch(opts) {
     const label = opts.label;
     return async (input, init) => {
         const method = init?.method ?? "GET";
-        const url = typeof input === "string" ? input : input?.toString?.() ?? String(input);
+        const url = typeof input === "string"
+            ? input
+            : input?.toString?.() ?? String(input);
         const ac = new AbortController();
         const timeoutMs = Math.floor(timeoutSeconds * 1000);
         const t = Number.isFinite(timeoutMs) && timeoutMs > 0
@@ -73,7 +112,10 @@ function createTimedFetch(opts) {
             signal: ac.signal,
         };
         if (debug) {
-            const mergedHeaders = { ...defaultHeaders, ...(init?.headers ?? {}) };
+            const mergedHeaders = {
+                ...defaultHeaders,
+                ...(init?.headers ?? {}),
+            };
             // eslint-disable-next-line no-console
             console.log(`[opensandbox:${label}] ->`, method, url, redactHeaders(mergedHeaders));
         }
@@ -126,9 +168,10 @@ export class ConnectionConfig {
         this.protocol = normalized.protocol ?? opts.protocol ?? "http";
         this.domain = normalized.domainBase;
         this.apiKey = opts.apiKey ?? envApiKey;
-        this.requestTimeoutSeconds = typeof opts.requestTimeoutSeconds === "number"
-            ? opts.requestTimeoutSeconds
-            : 30;
+        this.requestTimeoutSeconds =
+            typeof opts.requestTimeoutSeconds === "number"
+                ? opts.requestTimeoutSeconds
+                : 30;
         this.debug = !!opts.debug;
         const headers = { ...(opts.headers ?? {}) };
         // Attach API key via header unless the user already provided one.
@@ -136,14 +179,17 @@ export class ConnectionConfig {
             headers["OPEN-SANDBOX-API-KEY"] = this.apiKey;
         }
         // Best-effort user-agent (Node only).
-        if (isNodeRuntime() && this.userAgent && !headers["user-agent"] && !headers["User-Agent"]) {
+        if (isNodeRuntime() &&
+            this.userAgent &&
+            !headers["user-agent"] &&
+            !headers["User-Agent"]) {
             headers["user-agent"] = this.userAgent;
         }
         this.headers = headers;
         // Node SDK: do not expose custom fetch in ConnectionConfigOptions.
-        // Use the runtime's global fetch (Node >= 20).
-        const baseFetch = fetch;
-        const baseSseFetch = fetch;
+        // Use a node-scoped fetch with a dedicated dispatcher (keep-alive 30s).
+        const baseFetch = createNodeFetch();
+        const baseSseFetch = baseFetch;
         // Normal HTTP calls: apply requestTimeoutSeconds.
         this.fetch = createTimedFetch({
             baseFetch,
@@ -163,7 +209,8 @@ export class ConnectionConfig {
     }
     getBaseUrl() {
         // If `domain` already contains a scheme, treat it as a full base URL prefix.
-        if (this.domain.startsWith("http://") || this.domain.startsWith("https://")) {
+        if (this.domain.startsWith("http://") ||
+            this.domain.startsWith("https://")) {
             return `${stripV1Suffix(this.domain)}/v1`;
         }
         return `${this.protocol}://${stripV1Suffix(this.domain)}/v1`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alibaba-group/opensandbox",
-  "version": "0.1.0-dev2",
+  "version": "0.1.0-dev3",
   "description": "OpenSandbox TypeScript/JavaScript SDK (sandbox lifecycle + execd APIs)",
   "license": "Apache-2.0",
   "type": "module",
@@ -33,7 +33,8 @@
     "node": ">=20"
   },
   "dependencies": {
-    "openapi-fetch": "^0.13.8"
+    "openapi-fetch": "^0.13.8",
+    "undici": "^7.18.2"
   },
   "devDependencies": {
     "@eslint/js": "^9.39.2",