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

package/dist/index.cjs

@@ -1113,6 +1113,31 @@ var KVService = class extends BaseService {
     }
     return void 0;
   }
+  /**
+   * Classify a KV 404 by reading the response body once.
+   *
+   * The server returns 404 both for a genuinely missing key AND for an
+   * un-hosted space (body "Space not found"). Previously get/head/delete
+   * collapsed every 404 to KV_NOT_FOUND before reading the body, so an
+   * un-hosted-space read was indistinguishable from a missing key. We now
+   * preserve status + the "Space not found" body for the un-hosted case (so the
+   * CLI/SDK can normalize it to SPACE_NOT_HOSTED, matching put/list/sql), and
+   * fall through to KV_NOT_FOUND for a real missing key.
+   */
+  async classifyNotFound(response, key) {
+    const errorText = await response.text();
+    if (/space not found/i.test(errorText)) {
+      return err(
+        serviceError(
+          ErrorCodes.KV_NOT_FOUND,
+          `KV ${response.status} - ${errorText}`,
+          "kv",
+          { meta: { status: response.status, statusText: response.statusText } }
+        )
+      );
+    }
+    return err(serviceError(ErrorCodes.KV_NOT_FOUND, `Key not found: ${key}`, "kv"));
+  }
   /**
    * Get the full path with optional prefix.
    *
@@ -1163,6 +1188,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 +1289,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();
     }
@@ -1324,13 +1384,7 @@ var KVService = class extends BaseService {
             }));
           }
           if (response.status === 404) {
-            return err(
-              serviceError(
-                ErrorCodes.KV_NOT_FOUND,
-                `Key not found: ${key}`,
-                "kv"
-              )
-            );
+            return this.classifyNotFound(response, key);
           }
           const errorText = await response.text();
           return err(
@@ -1342,7 +1396,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 +1419,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,
@@ -1592,13 +1645,7 @@ var KVService = class extends BaseService {
             }));
           }
           if (response.status === 404) {
-            return err(
-              serviceError(
-                ErrorCodes.KV_NOT_FOUND,
-                `Key not found: ${key}`,
-                "kv"
-              )
-            );
+            return this.classifyNotFound(response, key);
           }
           const errorText = await response.text();
           return err(
@@ -1643,13 +1690,7 @@ var KVService = class extends BaseService {
             }));
           }
           if (response.status === 404) {
-            return err(
-              serviceError(
-                ErrorCodes.KV_NOT_FOUND,
-                `Key not found: ${key}`,
-                "kv"
-              )
-            );
+            return this.classifyNotFound(response, key);
           }
           const errorText = await response.text();
           return err(