@tinycloud/sdk-services 3.8.0-beta.2 → 3.8.0-beta.22

package/dist/{scope-_HAUxOPl.d.ts → scope-BZr0QwxX.d.ts}

@@ -1,4 +1,4 @@
-import { i as RetryStats, h as Result, F as FetchFunction } from './types-DAOyIbXu.js';
+import { i as RetryStats, f as Result, F as FetchFunction } from './types-CSd0RYir.js';
 import { REPLICA_KV_STORES } from './kv/replication/contractConstants.js';
 import { ReplicaConsentAnchor, ReplicaGrantPolicy } from './kv/replication/grantPolicyTypes.js';
 
@@ -1460,6 +1460,8 @@ interface KVReplicaSpec {
     grantPolicy?: ReplicaGrantPolicy;
     /** Quota settings; absent means unbounded. */
     quota?: ReplicaQuotaSpec;
+    /** Value download policy for syncs of this handle; absent means `"eager"`. See `ReplicationOptions.contentFetch`. */
+    contentFetch?: "eager" | "lazy";
     /**
      * Called when another tab/process commits a sync for this partition (browser: the worker's
      * `committed` BroadcastChannel message). The controller emits `replication.sync` with
@@ -1842,6 +1844,11 @@ interface ReplicationOptions {
     allowSecrets?: boolean;
     /** Sign-in asks for kv/sync on each declared prefix only and never widens to a root entry that covers them. */
     syncScope?: "prefixes";
+    /**
+     * `"eager"` (default) downloads each changed value while syncing. `"lazy"` syncs entry names
+     * without downloading values; a read of a value the replica does not hold goes to the network.
+     */
+    contentFetch?: "eager" | "lazy";
     /** Background interval; default 60 seconds. */
     syncIntervalMs?: number;
     maxStalenessMs?: number;

package/dist/{scope-D7bzmU6F.d.cts → scope-DEgc9f-W.d.cts}

@@ -1,4 +1,4 @@
-import { i as RetryStats, h as Result, F as FetchFunction } from './types-DAOyIbXu.cjs';
+import { i as RetryStats, f as Result, F as FetchFunction } from './types-CSd0RYir.cjs';
 import { REPLICA_KV_STORES } from './kv/replication/contractConstants.cjs';
 import { ReplicaConsentAnchor, ReplicaGrantPolicy } from './kv/replication/grantPolicyTypes.cjs';
 
@@ -1460,6 +1460,8 @@ interface KVReplicaSpec {
     grantPolicy?: ReplicaGrantPolicy;
     /** Quota settings; absent means unbounded. */
     quota?: ReplicaQuotaSpec;
+    /** Value download policy for syncs of this handle; absent means `"eager"`. See `ReplicationOptions.contentFetch`. */
+    contentFetch?: "eager" | "lazy";
     /**
      * Called when another tab/process commits a sync for this partition (browser: the worker's
      * `committed` BroadcastChannel message). The controller emits `replication.sync` with
@@ -1842,6 +1844,11 @@ interface ReplicationOptions {
     allowSecrets?: boolean;
     /** Sign-in asks for kv/sync on each declared prefix only and never widens to a root entry that covers them. */
     syncScope?: "prefixes";
+    /**
+     * `"eager"` (default) downloads each changed value while syncing. `"lazy"` syncs entry names
+     * without downloading values; a read of a value the replica does not hold goes to the network.
+     */
+    contentFetch?: "eager" | "lazy";
     /** Background interval; default 60 seconds. */
     syncIntervalMs?: number;
     maxStalenessMs?: number;

package/dist/sql/index.cjs

@@ -770,12 +770,13 @@ var SQLService = class extends BaseService {
           request.signal
         );
         if (!response.ok) {
-          return await this.handleErrorResponse(response, "query", dbName, [action]);
+          const failure = await this.handleErrorResponse(response, "query", dbName, [action]);
+          return this.redactFailure(failure, options?.redactErrors, response.status);
         }
         const data = await response.json();
         return ok(data);
       } catch (error) {
-        return err(wrapError("sql", error));
+        return this.redactFailure(err(wrapError("sql", error)), options?.redactErrors);
       } finally {
         request.dispose();
       }
@@ -810,12 +811,13 @@ var SQLService = class extends BaseService {
           request.signal
         );
         if (!response.ok) {
-          return await this.handleErrorResponse(response, "execute", dbName, requestedActions);
+          const failure = await this.handleErrorResponse(response, "execute", dbName, requestedActions);
+          return this.redactFailure(failure, options?.redactErrors, response.status);
         }
         const data = await response.json();
         return ok(data);
       } catch (error) {
-        return err(wrapError("sql", error));
+        return this.redactFailure(err(wrapError("sql", error)), options?.redactErrors);
       } finally {
         request.dispose();
       }
@@ -836,12 +838,13 @@ var SQLService = class extends BaseService {
           request.signal
         );
         if (!response.ok) {
-          return await this.handleErrorResponse(response, "batch", dbName, requestedActions);
+          const failure = await this.handleErrorResponse(response, "batch", dbName, requestedActions);
+          return this.redactFailure(failure, options?.redactErrors, response.status);
         }
         const data = await response.json();
         return ok(data);
       } catch (error) {
-        return err(wrapError("sql", error));
+        return this.redactFailure(err(wrapError("sql", error)), options?.redactErrors);
       } finally {
         request.dispose();
       }
@@ -1037,6 +1040,18 @@ var SQLService = class extends BaseService {
       }))
     );
   }
+  redactFailure(result, redactErrors, status) {
+    if (!redactErrors || result.ok) return result;
+    const candidate = result.error.code;
+    const code = typeof candidate === "string" && Object.prototype.hasOwnProperty.call(ErrorCodes, candidate) ? candidate : ErrorCodes.SQL_ERROR;
+    const safeStatus = typeof status === "number" && Number.isInteger(status) && status >= 400 && status <= 599 ? status : void 0;
+    return err(serviceError(
+      code,
+      "SQL operation failed",
+      "sql",
+      safeStatus === void 0 ? void 0 : { meta: { status: safeStatus } }
+    ));
+  }
   async handleErrorResponse(response, operation, dbName, requestedActions) {
     const errorText = await response.text();
     const meta = responseErrorMeta(response.status, response.statusText, errorText);