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

package/dist/index.d.cts

@@ -1,7 +1,7 @@
-import { a as IServiceContext, c as InvokeFunction, d as InvokeAnyFunction, F as FetchFunction, S as ServiceSession, e as RetryPolicy, T as TelemetryConfig, I as IService, E as EventHandler, b as ServiceError, R as Result, P as PermissionHint, f as StorageQuotaInfo } from './types-DAY1O1kW.cjs';
-export { g as ErrorCode, h as ErrorCodes, i as FetchRequestInit, j as FetchResponse, k as InvocationFact, l as InvocationFacts, m as InvokeAnyEntry, n as ServiceErrorEvent, o as ServiceHeaders, p as ServiceRequestEvent, q as ServiceResponseEvent, r as ServiceRetryEvent, s as TelemetryEventHandler, t as TelemetryEvents, u as TelemetrySpanEvent, v as defaultRetryPolicy, w as err, x as ok, y as serviceError } from './types-DAY1O1kW.cjs';
+import { a as IServiceContext, c as InvokeFunction, d as InvokeAnyFunction, F as FetchFunction, S as ServiceSession, e as RetryPolicy, T as TelemetryConfig, I as IService, E as EventHandler, b as ServiceError, R as Result, P as PermissionHint, f as StorageQuotaInfo } from './types-KCcgZiab.cjs';
+export { g as ErrorCode, h as ErrorCodes, i as FetchRequestInit, j as FetchResponse, k as InvocationFact, l as InvocationFacts, m as InvokeAnyEntry, n as ServiceErrorEvent, o as ServiceHeaders, p as ServiceRequestEvent, q as ServiceResponseEvent, r as ServiceRetryEvent, s as TelemetryEventHandler, t as TelemetryEvents, u as TelemetrySpanEvent, v as defaultRetryPolicy, w as err, x as ok, y as serviceError } from './types-KCcgZiab.cjs';
 import { z } from 'zod';
-import { B as BaseService } from './BaseService-BwBU5CQ4.cjs';
+import { B as BaseService } from './BaseService-DxSU4U-v.cjs';
 import { IKVService } from './kv/index.cjs';
 export { DEFAULT_SIGNED_READ_URL_EXPIRY_MS, IPrefixedKVService, KVAction, KVActionType, KVBatchPutItem, KVBatchPutOptions, KVBatchPutResponse, KVCreateSignedReadUrlOptions, KVDeleteOptions, KVGetOptions, KVHeadOptions, KVListOptions, KVListResponse, KVPutOptions, KVResponse, KVResponseHeaders, KVService, KVServiceConfig, KVSignedReadUrlResponse, PrefixedKVService } from './kv/index.cjs';
 export { BatchOptions, BatchResponse, DatabaseHandle, ExecuteOptions, ExecuteResponse, IDatabaseHandle, ISQLMigrations, ISQLService, QueryOptions, QueryResponse, SQLAction, SQLActionType, SQLMigrations, SQLService, SQLServiceConfig, SqlMigration, SqlMigrationApplyOptions, SqlMigrationApplyResponse, SqlStatement, SqlValue } from './sql/index.cjs';

package/dist/index.d.ts

@@ -1,7 +1,7 @@
-import { a as IServiceContext, c as InvokeFunction, d as InvokeAnyFunction, F as FetchFunction, S as ServiceSession, e as RetryPolicy, T as TelemetryConfig, I as IService, E as EventHandler, b as ServiceError, R as Result, P as PermissionHint, f as StorageQuotaInfo } from './types-DAY1O1kW.js';
-export { g as ErrorCode, h as ErrorCodes, i as FetchRequestInit, j as FetchResponse, k as InvocationFact, l as InvocationFacts, m as InvokeAnyEntry, n as ServiceErrorEvent, o as ServiceHeaders, p as ServiceRequestEvent, q as ServiceResponseEvent, r as ServiceRetryEvent, s as TelemetryEventHandler, t as TelemetryEvents, u as TelemetrySpanEvent, v as defaultRetryPolicy, w as err, x as ok, y as serviceError } from './types-DAY1O1kW.js';
+import { a as IServiceContext, c as InvokeFunction, d as InvokeAnyFunction, F as FetchFunction, S as ServiceSession, e as RetryPolicy, T as TelemetryConfig, I as IService, E as EventHandler, b as ServiceError, R as Result, P as PermissionHint, f as StorageQuotaInfo } from './types-KCcgZiab.js';
+export { g as ErrorCode, h as ErrorCodes, i as FetchRequestInit, j as FetchResponse, k as InvocationFact, l as InvocationFacts, m as InvokeAnyEntry, n as ServiceErrorEvent, o as ServiceHeaders, p as ServiceRequestEvent, q as ServiceResponseEvent, r as ServiceRetryEvent, s as TelemetryEventHandler, t as TelemetryEvents, u as TelemetrySpanEvent, v as defaultRetryPolicy, w as err, x as ok, y as serviceError } from './types-KCcgZiab.js';
 import { z } from 'zod';
-import { B as BaseService } from './BaseService-CnPTKR5G.js';
+import { B as BaseService } from './BaseService-BiYeqCRT.js';
 import { IKVService } from './kv/index.js';
 export { DEFAULT_SIGNED_READ_URL_EXPIRY_MS, IPrefixedKVService, KVAction, KVActionType, KVBatchPutItem, KVBatchPutOptions, KVBatchPutResponse, KVCreateSignedReadUrlOptions, KVDeleteOptions, KVGetOptions, KVHeadOptions, KVListOptions, KVListResponse, KVPutOptions, KVResponse, KVResponseHeaders, KVService, KVServiceConfig, KVSignedReadUrlResponse, PrefixedKVService } from './kv/index.js';
 export { BatchOptions, BatchResponse, DatabaseHandle, ExecuteOptions, ExecuteResponse, IDatabaseHandle, ISQLMigrations, ISQLService, QueryOptions, QueryResponse, SQLAction, SQLActionType, SQLMigrations, SQLService, SQLServiceConfig, SqlMigration, SqlMigrationApplyOptions, SqlMigrationApplyResponse, SqlStatement, SqlValue } from './sql/index.js';

package/dist/index.js

@@ -13,6 +13,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",
@@ -1470,7 +1473,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,
@@ -1478,9 +1481,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)
     });
@@ -1662,13 +1666,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) {
@@ -1686,6 +1698,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,
@@ -1717,6 +1737,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 {
@@ -1724,7 +1751,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) {
@@ -1737,6 +1768,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,
@@ -1872,6 +1919,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;
@@ -1881,7 +1935,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) {
@@ -1911,7 +1966,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));
       }
@@ -1931,7 +1989,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) {
@@ -1947,6 +2006,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,
@@ -1956,7 +2031,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));
       }
@@ -2276,10 +2354,17 @@ var SQLService = class extends BaseService {
         return err(authRequiredError("sql"));
       }
       try {
+        const body = {
+          action: "query",
+          sql,
+          params: serializeSqlValues(params ?? [])
+        };
+        if (options?.maxRows !== void 0) body.maxRows = options.maxRows;
+        if (options?.maxBytes !== void 0) body.maxBytes = options.maxBytes;
         const response = await this.invokeSQL(
           dbName,
           this.actionForSql(sql, SQLAction.READ),
-          { action: "query", sql, params: params ?? [] },
+          body,
           options?.signal
         );
         if (!response.ok) {
@@ -2301,7 +2386,7 @@ var SQLService = class extends BaseService {
         const body = {
           action: "execute",
           sql,
-          params: params ?? []
+          params: serializeSqlValues(params ?? [])
         };
         if (options?.schema) {
           body.schema = options.schema;
@@ -2626,6 +2711,11 @@ function validateMigrationOptions(options) {
   }
   return null;
 }
+function serializeSqlValues(values) {
+  return values.map(
+    (value) => value instanceof Uint8Array ? Array.from(value) : value
+  );
+}
 function migrationKey(namespace, id) {
   return `${encodeURIComponent(namespace)}:${encodeURIComponent(id)}`;
 }