@tinycloud/sdk-services 2.7.0 → 2.8.0-beta.0

package/dist/internal/decrypt-transport-response-error.d.cts

@@ -1,4 +1,4 @@
-import { P as PermissionHint } from '../types-DAY1O1kW.cjs';
+import { P as PermissionHint } from '../types-KCcgZiab.cjs';
 
 /** A reachable node returned an HTTP failure for a decrypt request. */
 declare class DecryptTransportResponseError extends Error {

package/dist/internal/decrypt-transport-response-error.d.ts

@@ -1,4 +1,4 @@
-import { P as PermissionHint } from '../types-DAY1O1kW.js';
+import { P as PermissionHint } from '../types-KCcgZiab.js';
 
 /** A reachable node returned an HTTP failure for a decrypt request. */
 declare class DecryptTransportResponseError extends Error {

package/dist/kv/index.cjs

@@ -42,6 +42,9 @@ var ErrorCodes = {
   // KV-specific errors
   KV_NOT_FOUND: "KV_NOT_FOUND",
   KV_WRITE_FAILED: "KV_WRITE_FAILED",
+  KV_PRECONDITION_FAILED: "KV_PRECONDITION_FAILED",
+  KV_CONFLICT: "KV_CONFLICT",
+  KV_RESPONSE_TOO_LARGE: "KV_RESPONSE_TOO_LARGE",
   // SQL-specific errors
   SQL_ERROR: "SQL_ERROR",
   SQL_PERMISSION_DENIED: "SQL_PERMISSION_DENIED",
@@ -643,7 +646,7 @@ var KVService = class extends BaseService {
    * @param signal - Optional abort signal
    * @returns Fetch response
    */
-  async invokeOperation(path, action, body, signal) {
+  async invokeOperation(path, action, body, signal, extraHeaders) {
     const session = this.context.session;
     const headers = this.context.invoke(
       session,
@@ -651,9 +654,10 @@ var KVService = class extends BaseService {
       path,
       action
     );
+    const requestHeaders = Array.isArray(headers) ? [...headers, ...Object.entries(extraHeaders ?? {})] : { ...headers, ...extraHeaders };
     return this.context.fetch(`${this.host}/invoke`, {
       method: "POST",
-      headers,
+      headers: requestHeaders,
       body,
       signal: this.combineSignals(signal)
     });
@@ -835,13 +839,21 @@ var KVService = class extends BaseService {
       if (!this.requireAuth()) {
         return err(authRequiredError("kv"));
       }
+      if (options?.maxResponseBytes !== void 0 && (!Number.isSafeInteger(options.maxResponseBytes) || options.maxResponseBytes <= 0)) {
+        return err(serviceError(
+          ErrorCodes.INVALID_INPUT,
+          "KV maxResponseBytes must be a positive safe integer",
+          "kv"
+        ));
+      }
       const path = this.getFullPath(key, options?.prefix);
       try {
         const response = await this.invokeOperation(
           path,
           KVAction.GET,
           void 0,
-          options?.signal
+          options?.signal,
+          options?.maxResponseBytes === void 0 ? void 0 : { "x-tinycloud-max-response-bytes": String(options.maxResponseBytes) }
         );
         if (!response.ok) {
           if (response.status === 401 || response.status === 403) {
@@ -859,6 +871,14 @@ var KVService = class extends BaseService {
             return this.classifyNotFound(response, key);
           }
           const errorText = await response.text();
+          if (response.status === 413) {
+            return err(serviceError(
+              ErrorCodes.KV_RESPONSE_TOO_LARGE,
+              `KV value at key "${key}" exceeds the requested response limit`,
+              "kv",
+              { meta: { status: response.status, statusText: response.statusText } }
+            ));
+          }
           return err(
             serviceError(
               ErrorCodes.NETWORK_ERROR,
@@ -890,6 +910,13 @@ var KVService = class extends BaseService {
       if (!this.requireAuth()) {
         return err(authRequiredError("kv"));
       }
+      if (options?.ifMatch !== void 0 && options.ifNoneMatch !== void 0) {
+        return err(serviceError(
+          ErrorCodes.INVALID_INPUT,
+          "KV put cannot combine ifMatch and ifNoneMatch",
+          "kv"
+        ));
+      }
       const path = this.getFullPath(key, options?.prefix);
       const body = this.serializePutValue(value, options?.contentType);
       try {
@@ -897,7 +924,11 @@ var KVService = class extends BaseService {
           path,
           KVAction.PUT,
           body,
-          options?.signal
+          options?.signal,
+          {
+            ...options?.ifMatch === void 0 ? {} : { "if-match": options.ifMatch },
+            ...options?.ifNoneMatch === void 0 ? {} : { "if-none-match": options.ifNoneMatch }
+          }
         );
         if (!response.ok) {
           if (response.status === 401) {
@@ -910,6 +941,22 @@ var KVService = class extends BaseService {
             }));
           }
           const errorText = await response.text();
+          if (response.status === 412) {
+            return err(serviceError(
+              ErrorCodes.KV_PRECONDITION_FAILED,
+              `KV precondition failed for key "${key}"`,
+              "kv",
+              { meta: { status: response.status, statusText: response.statusText } }
+            ));
+          }
+          if (response.status === 503 && (options?.ifMatch !== void 0 || options?.ifNoneMatch !== void 0)) {
+            return err(serviceError(
+              ErrorCodes.KV_CONFLICT,
+              `Concurrent KV update conflicted for key "${key}"`,
+              "kv",
+              { meta: { status: response.status, statusText: response.statusText } }
+            ));
+          }
           const quotaError = this.handleQuotaErrorResponse(
             response,
             errorText,
@@ -1045,6 +1092,13 @@ var KVService = class extends BaseService {
       if (!this.requireAuth()) {
         return err(authRequiredError("kv"));
       }
+      if (options?.limit !== void 0 && (!Number.isInteger(options.limit) || options.limit < 1 || options.limit > 1e3)) {
+        return err(serviceError(
+          ErrorCodes.INVALID_INPUT,
+          "KV list limit must be an integer from 1 through 1000",
+          "kv"
+        ));
+      }
       let listPath = options?.prefix ?? this._config.prefix ?? "";
       if (options?.path) {
         listPath = listPath ? `${listPath}/${options.path}` : options.path;
@@ -1054,7 +1108,8 @@ var KVService = class extends BaseService {
           listPath,
           KVAction.LIST,
           void 0,
-          options?.signal
+          options?.signal,
+          options?.limit === void 0 ? void 0 : { "x-tinycloud-limit": String(options.limit) }
         );
         if (!response.ok) {
           if (response.status === 401) {
@@ -1084,7 +1139,10 @@ var KVService = class extends BaseService {
             (key) => key.startsWith(prefixWithSlash) ? key.slice(prefixWithSlash.length) : key
           );
         }
-        return ok({ keys });
+        return ok({
+          keys,
+          ...response.headers.get("x-tinycloud-truncated") === null ? {} : { truncated: response.headers.get("x-tinycloud-truncated") === "true" }
+        });
       } catch (error) {
         return err(wrapError("kv", error));
       }
@@ -1104,7 +1162,8 @@ var KVService = class extends BaseService {
           path,
           KVAction.DELETE,
           void 0,
-          options?.signal
+          options?.signal,
+          options?.ifMatch === void 0 ? void 0 : { "if-match": options.ifMatch }
         );
         if (!response.ok) {
           if (response.status === 401) {
@@ -1120,6 +1179,22 @@ var KVService = class extends BaseService {
             return this.classifyNotFound(response, key);
           }
           const errorText = await response.text();
+          if (response.status === 412) {
+            return err(serviceError(
+              ErrorCodes.KV_PRECONDITION_FAILED,
+              `KV precondition failed for key "${key}"`,
+              "kv",
+              { meta: { status: response.status, statusText: response.statusText } }
+            ));
+          }
+          if (response.status === 503 && options?.ifMatch !== void 0) {
+            return err(serviceError(
+              ErrorCodes.KV_CONFLICT,
+              `Concurrent KV delete conflicted for key "${key}"`,
+              "kv",
+              { meta: { status: response.status, statusText: response.statusText } }
+            ));
+          }
           return err(
             serviceError(
               ErrorCodes.NETWORK_ERROR,
@@ -1129,7 +1204,10 @@ var KVService = class extends BaseService {
             )
           );
         }
-        return ok(void 0);
+        return ok({
+          data: void 0,
+          headers: this.createResponseHeaders(response.headers)
+        });
       } catch (error) {
         return err(wrapError("kv", error));
       }