@declaw/sdk 1.1.1 → 1.1.3

package/CHANGELOG.md

@@ -5,6 +5,34 @@ All notable changes to the Declaw TypeScript / JavaScript SDK are documented in
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.1.3]
+
+### Changed
+
+- **Higher-concurrency HTTP dispatcher on Node.** The SDK now installs a
+  module-level `undici.Agent` (128 connections per origin, keep-alive
+  tuned) on first use under Node, so callers fanning out many concurrent
+  requests are no longer capped by undici's default 10 connections per
+  origin. On runtimes that don't ship `undici` (browsers, Cloudflare
+  Workers, Deno) the dynamic import silently no-ops and the platform's
+  native `fetch` is used unchanged. Opt out with
+  `DECLAW_SDK_DISABLE_DISPATCHER=1` if you bring your own dispatcher.
+  `undici` is declared as an `optionalDependency`.
+
+## [1.1.2]
+
+### Fixed
+
+- **Binary-safe `files.read`.** `sandbox.files.read(path, { format: "bytes" })`
+  now returns a `Uint8Array` with the raw bytes. Previously the
+  `format` option was silently ignored: every read went through the
+  `text/plain` accept path and was UTF-8 decoded, so any byte with the
+  high bit set collapsed to the replacement character `U+FFFD` and the
+  buffer came back short of the real file length. Binary writes were
+  already routed through `PUT /files/raw` (1.0.1); this patch closes
+  the read side so PNGs, compressed archives, and other non-text blobs
+  round-trip unmodified.
+
 ## [1.1.1]
 
 ### Changed

package/dist/index.cjs

@@ -1,7 +1,9 @@
 "use strict";
+var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __export = (target, all) => {
   for (var name in all)
@@ -15,6 +17,14 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/index.ts
@@ -223,6 +233,31 @@ var CommandExitError = class extends SandboxError {
 };
 
 // src/api/client.ts
+var _dispatcherPromise;
+function getDispatcher() {
+  if (_dispatcherPromise) return _dispatcherPromise;
+  _dispatcherPromise = (async () => {
+    try {
+      if (typeof process === "undefined" || !process.versions?.node) {
+        return void 0;
+      }
+      if (process.env.DECLAW_SDK_DISABLE_DISPATCHER) {
+        return void 0;
+      }
+      const undici = await import("undici");
+      return new undici.Agent({
+        connections: 128,
+        keepAliveTimeout: 3e4,
+        keepAliveMaxTimeout: 6e4,
+        pipelining: 1,
+        connect: { keepAlive: true, keepAliveInitialDelay: 5e3 }
+      });
+    } catch {
+      return void 0;
+    }
+  })();
+  return _dispatcherPromise;
+}
 var STATUS_ERROR_MAP = {
   401: AuthenticationError,
   403: AuthenticationError,
@@ -246,6 +281,12 @@ var ApiClient = class {
   async get(path, opts) {
     return this.requestWithRetry("GET", path, opts);
   }
+  /** Send a GET request and return the response body as raw bytes. */
+  async getBytes(path, opts) {
+    const response = await this.requestWithRetry("GET", path, opts, true);
+    const buf = await response.arrayBuffer();
+    return new Uint8Array(buf);
+  }
   /** Send a POST request and return parsed JSON. */
   async post(path, opts) {
     return this.requestWithRetry("POST", path, opts);
@@ -327,12 +368,15 @@ var ApiClient = class {
           signals.push(AbortSignal.timeout(timeoutMs));
         }
         const signal = signals.length === 1 ? signals[0] : AbortSignal.any(signals);
-        const response = await fetch(url, {
+        const dispatcher = await getDispatcher();
+        const fetchOpts = {
           method,
           headers,
           body: fetchBody,
           signal
-        });
+        };
+        if (dispatcher) fetchOpts.dispatcher = dispatcher;
+        const response = await fetch(url, fetchOpts);
         if (response.status >= 500 && attempt < this.maxRetries - 1) {
           await this.delay(attempt);
           continue;
@@ -1370,15 +1414,18 @@ var Filesystem = class {
     this.sandboxId = sandboxId;
     this.client = client;
   }
-  /**
-   * Read a file's contents as a string.
-   *
-   * @param path - Absolute path to the file.
-   * @param opts - Optional user and request timeout.
-   * @returns The file contents as a string.
-   */
   async read(path, opts) {
     const user = opts?.user ?? DEFAULT_USER;
+    if (opts?.format === "bytes") {
+      return this.client.getBytes(
+        `/sandboxes/${this.sandboxId}/files`,
+        {
+          params: { path, username: user },
+          headers: { "Accept": "application/octet-stream" },
+          timeout: opts?.requestTimeout
+        }
+      );
+    }
     const result = await this.client.get(
       `/sandboxes/${this.sandboxId}/files`,
       {