@tinycloud/sdk-services 2.10.0-beta.0 → 2.11.0-beta.5

package/dist/index.cjs

@@ -514,7 +514,9 @@ function createKVResponseSchema(dataSchema) {
 var GenericKVResponseSchema = createKVResponseSchema(import_zod.z.unknown());
 var KVListResponseSchema = import_zod.z.object({
   /** Array of keys matching the list criteria */
-  keys: import_zod.z.array(import_zod.z.string())
+  keys: import_zod.z.array(import_zod.z.string()),
+  truncated: import_zod.z.boolean().optional(),
+  nextCursor: import_zod.z.string().optional()
 });
 var KVListResultSchema = createResultSchema(KVListResponseSchema);
 var ServiceRequestEventSchema = import_zod.z.object({
@@ -2189,6 +2191,7 @@ var KVService = class extends BaseService {
         }
         seen.add(path);
       }
+      let requestMayHaveDispatched = false;
       try {
         const body = new FormData();
         for (let index = 0; index < items.length; index++) {
@@ -2206,14 +2209,31 @@ var KVService = class extends BaseService {
             action: KVAction.PUT
           }))
         );
-        const response = await this.context.fetch(`${this.host}/invoke`, {
+        const url = `${this.host}/invoke`;
+        const init = {
           method: "POST",
           headers,
           body,
           signal: this.combineSignals(options?.signal)
-        });
+        };
+        const fetchFn = this.context.fetch;
+        requestMayHaveDispatched = true;
+        const response = await fetchFn(url, init);
         if (!response.ok) {
-          const errorText = await response.text();
+          let errorText;
+          try {
+            errorText = await response.text();
+          } catch (textError) {
+            const cause = textError instanceof Error ? textError : new Error(String(textError));
+            return err(
+              serviceError(
+                ErrorCodes.KV_WRITE_FAILED,
+                `Failed to batch put ${items.length} key(s): ${response.status} - <response body could not be read: ${cause.message}>`,
+                "kv",
+                { cause, meta: { status: response.status, statusText: response.statusText } }
+              )
+            );
+          }
           if (response.status === 401 || response.status === 403) {
             const { resource, action } = parseAuthError(errorText);
             return err(authUnauthorizedError("kv", errorText, {
@@ -2239,19 +2259,73 @@ var KVService = class extends BaseService {
             )
           );
         }
-        const batchResponse = this.normalizeBatchPutResponse(await response.json());
-        if (!batchResponse || batchResponse.count !== batchResponse.written.length) {
+        let rawBody;
+        try {
+          rawBody = await response.json();
+        } catch (jsonError) {
+          const cause = jsonError instanceof Error ? jsonError : new Error(String(jsonError));
+          return err(
+            serviceError(
+              ErrorCodes.NETWORK_ERROR,
+              `KV batchPut response was not valid JSON: ${cause.message}`,
+              "kv",
+              {
+                cause,
+                meta: {
+                  requestMayHaveDispatched: true,
+                  responseReceived: true,
+                  status: response.status,
+                  outcome: "batch-unconfirmed"
+                }
+              }
+            )
+          );
+        }
+        const batchResponse = this.normalizeBatchPutResponse(rawBody);
+        if (!batchResponse) {
           return err(
             serviceError(
               ErrorCodes.NETWORK_ERROR,
               "KV batchPut response did not include matching written keys and count",
-              "kv"
+              "kv",
+              {
+                meta: {
+                  requestMayHaveDispatched: true,
+                  responseReceived: true,
+                  status: response.status,
+                  outcome: "batch-unconfirmed"
+                }
+              }
+            )
+          );
+        }
+        const requestedPaths = new Set(paths);
+        const writtenPaths = new Set(batchResponse.written);
+        const matchesRequest = batchResponse.count === paths.length && batchResponse.written.length === paths.length && writtenPaths.size === paths.length && batchResponse.written.every((key) => requestedPaths.has(key));
+        if (!matchesRequest) {
+          return err(
+            serviceError(
+              ErrorCodes.NETWORK_ERROR,
+              `KV batchPut response did not confirm all ${paths.length} requested key(s) were written`,
+              "kv",
+              {
+                meta: {
+                  requestMayHaveDispatched: true,
+                  responseReceived: true,
+                  status: response.status,
+                  outcome: "batch-unconfirmed"
+                }
+              }
             )
           );
         }
         return ok(batchResponse);
       } catch (error) {
-        return err(wrapError("kv", error));
+        const wrapped = wrapError("kv", error);
+        return err({
+          ...wrapped,
+          meta: { ...wrapped.meta, requestMayHaveDispatched }
+        });
       }
     });
   }
@@ -2280,7 +2354,10 @@ var KVService = class extends BaseService {
           KVAction.LIST,
           void 0,
           options?.signal,
-          options?.limit === void 0 ? void 0 : { "x-tinycloud-limit": String(options.limit) }
+          options?.limit === void 0 && options?.cursor === void 0 ? void 0 : {
+            ...options?.limit === void 0 ? {} : { "x-tinycloud-limit": String(options.limit) },
+            ...options?.cursor === void 0 ? {} : { "x-tinycloud-cursor": options.cursor }
+          }
         );
         if (!response.ok) {
           if (response.status === 401) {
@@ -2312,7 +2389,8 @@ var KVService = class extends BaseService {
         }
         return ok({
           keys,
-          ...response.headers.get("x-tinycloud-truncated") === null ? {} : { truncated: response.headers.get("x-tinycloud-truncated") === "true" }
+          ...response.headers.get("x-tinycloud-truncated") === null ? {} : { truncated: response.headers.get("x-tinycloud-truncated") === "true" },
+          ...response.headers.get("x-tinycloud-next-cursor") === null ? {} : { nextCursor: response.headers.get("x-tinycloud-next-cursor") ?? void 0 }
         });
       } catch (error) {
         return err(wrapError("kv", error));
@@ -5037,6 +5115,10 @@ var DataVaultService = class extends BaseService {
    * @returns Result with array of key names (vault/ prefix stripped)
    */
   async list(options) {
+    const page = await this.listPage(options);
+    return page.ok ? { ok: true, data: page.data.keys } : page;
+  }
+  async listPage(options) {
     return this.withTelemetry("list", options?.prefix, async () => {
       if (!this.isUnlocked) {
         return vaultError({
@@ -5054,7 +5136,9 @@ var DataVaultService = class extends BaseService {
         const listPrefix = options?.prefix ? `vault/${options.prefix}` : "vault/";
         const listResult = await this.tc.kv.list({
           prefix: listPrefix,
-          removePrefix: true
+          removePrefix: true,
+          ...options?.limit === void 0 ? {} : { limit: options.limit },
+          ...options?.cursor === void 0 ? {} : { cursor: options.cursor }
         });
         if (!listResult.ok) {
           return vaultError({
@@ -5071,7 +5155,11 @@ var DataVaultService = class extends BaseService {
             (k) => k.startsWith(userPrefix) ? k.slice(userPrefix.length) : k
           );
         }
-        return ok(keys);
+        return ok({
+          keys,
+          truncated: listResult.data.truncated === true,
+          ...listResult.data.nextCursor === void 0 ? {} : { nextCursor: listResult.data.nextCursor }
+        });
       } catch (error) {
         return vaultError({
           code: "STORAGE_ERROR",