@declaw/sdk 1.1.1 → 1.1.2

package/CHANGELOG.md

@@ -5,6 +5,20 @@ 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.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

@@ -246,6 +246,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);
@@ -1370,15 +1376,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`,
       {