@tinycloud/sdk-services 2.3.0 → 2.4.0-beta.1

package/dist/index.cjs

@@ -1163,6 +1163,38 @@ var KVService = class extends BaseService {
       signal: this.combineSignals(signal)
     });
   }
+  /**
+   * Serialize a single put value into a fetch body.
+   *
+   * Binary values (Blob/ArrayBuffer/typed-array, incl. Node Buffer) are sent as
+   * raw bytes (as a Blob) so they round-trip byte-identically — without this a
+   * Buffer would be JSON.stringify'd into `{"type":"Buffer","data":[...]}`.
+   * Strings are returned unchanged (preserving prior behavior); other values are
+   * JSON-encoded. `contentType` overrides the inferred type for binary values.
+   */
+  serializePutValue(value, contentType) {
+    if (value instanceof Blob) {
+      if (!contentType || value.type === contentType) {
+        return value;
+      }
+      return new Blob([value], { type: contentType });
+    }
+    if (value instanceof ArrayBuffer) {
+      return new Blob([value], {
+        type: contentType ?? "application/octet-stream"
+      });
+    }
+    if (ArrayBuffer.isView(value)) {
+      const view = new Uint8Array(value.buffer, value.byteOffset, value.byteLength);
+      return new Blob([view], {
+        type: contentType ?? "application/octet-stream"
+      });
+    }
+    if (typeof value === "string") {
+      return contentType ? new Blob([value], { type: contentType }) : value;
+    }
+    return JSON.stringify(value);
+  }
   serializeBatchPutValue(item) {
     const contentType = item.contentType;
     if (item.value instanceof Blob) {
@@ -1232,10 +1264,13 @@ var KVService = class extends BaseService {
    * @param raw - Whether to return raw text
    * @returns Parsed data
    */
-  async parseResponse(response, raw = false) {
+  async parseResponse(response, raw = false, binary = false) {
     if (!response.ok) {
       return void 0;
     }
+    if (binary) {
+      return new Uint8Array(await response.arrayBuffer());
+    }
     if (raw) {
       return await response.text();
     }
@@ -1342,7 +1377,11 @@ var KVService = class extends BaseService {
             )
           );
         }
-        const data = await this.parseResponse(response, options?.raw);
+        const data = await this.parseResponse(
+          response,
+          options?.raw,
+          options?.binary
+        );
         return ok({
           data,
           headers: this.createResponseHeaders(response.headers)
@@ -1361,12 +1400,7 @@ var KVService = class extends BaseService {
         return err(authRequiredError("kv"));
       }
       const path = this.getFullPath(key, options?.prefix);
-      let body;
-      if (typeof value === "string") {
-        body = value;
-      } else {
-        body = JSON.stringify(value);
-      }
+      const body = this.serializePutValue(value, options?.contentType);
       try {
         const response = await this.invokeOperation(
           path,