@tinycloud/operations 0.4.0-beta.10 → 0.4.0-beta.11

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { I as InvocationTarget, a as OperationResult } from './contract-CjuEjE-M.cjs';
+import { I as InvocationTarget, a as OperationResult } from './contract-eWtDSMeI.cjs';
 
 /** The sole projection-facing execution API. */
 declare function invokeOperation(operationId: string, operationVersion: number, invocationTarget: InvocationTarget, unknownInput: unknown): Promise<OperationResult<unknown>>;

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { I as InvocationTarget, a as OperationResult } from './contract-CjuEjE-M.js';
+import { I as InvocationTarget, a as OperationResult } from './contract-eWtDSMeI.js';
 
 /** The sole projection-facing execution API. */
 declare function invokeOperation(operationId: string, operationVersion: number, invocationTarget: InvocationTarget, unknownInput: unknown): Promise<OperationResult<unknown>>;

package/dist/index.js

@@ -40,6 +40,17 @@ function operationError(code, message, options = {}) {
     ...options.details === void 0 ? {} : { details: options.details }
   };
 }
+function storageFullOperationError(error) {
+  if (typeof error !== "object" || error === null) return void 0;
+  const { code, meta } = error;
+  if (code !== "STORAGE_QUOTA_EXCEEDED" && code !== "STORAGE_LIMIT_REACHED") return void 0;
+  const account = typeof meta === "object" && meta !== null ? meta.account : void 0;
+  return operationError(
+    "STORAGE_QUOTA_EXCEEDED",
+    code === "STORAGE_LIMIT_REACHED" ? `This write is larger than the TinyCloud storage left, so nothing was written. Reading still works. ${MANAGE_STORAGE}` : `TinyCloud storage is full, so nothing was written. Reading still works. ${MANAGE_STORAGE}`,
+    { retryable: false, ...account === void 0 ? {} : { details: { account } } }
+  );
+}
 function isOperationErrorCode(value) {
   return typeof value === "string" && OPERATION_ERROR_CODES.includes(value);
 }
@@ -65,7 +76,7 @@ function sanitizeOperationError(error) {
     ...candidate.details === void 0 ? {} : { details: candidate.details }
   });
 }
-var OPERATION_ERROR_CODES, OperationInvocationError;
+var OPERATION_ERROR_CODES, MANAGE_STORAGE, OperationInvocationError;
 var init_errors = __esm({
   "src/errors.ts"() {
     "use strict";
@@ -88,6 +99,7 @@ var init_errors = __esm({
       "ENCRYPTION_NETWORK_UNRESOLVED",
       "NODE_UNREACHABLE",
       "NODE_ERROR",
+      "STORAGE_QUOTA_EXCEEDED",
       "KV_NOT_FOUND",
       "KV_PRECONDITION_FAILED",
       "KV_CONFLICT",
@@ -101,6 +113,7 @@ var init_errors = __esm({
       "OUTPUT_INVALID",
       "INTERNAL_ERROR"
     ];
+    MANAGE_STORAGE = "Do not retry: the owner must free up space or upgrade at https://account.tinycloud.xyz/billing.";
     OperationInvocationError = class extends Error {
       constructor(operationError2) {
         super(operationError2.message);
@@ -2545,6 +2558,8 @@ function kvFailure(error, action) {
   if (error.code === "KV_RESPONSE_TOO_LARGE") {
     return { status: "error", error: operationError("KV_RESPONSE_TOO_LARGE", `The TinyCloud KV value exceeds ${MAX_KV_VALUE_BYTES} bytes.`) };
   }
+  const storageFull = storageFullOperationError(error);
+  if (storageFull) return { status: "error", error: storageFull };
   return nodeFailure(action);
 }
 function nodeFailure(action) {
@@ -3163,7 +3178,7 @@ async function executeSqlDml(context, input) {
     const runtime = runtimeContext2(context);
     const space = resolveSqlSpace(runtime, input.space);
     const result = await runtimeNode2(runtime).sqlForSpace(space).db(input.database).execute(input.sql, input.params.map(decodeSqlInputValue));
-    if (!result.ok) return authorizationFailure(result.error, "execute the SQLite statement") ?? sqlMutationFailure();
+    if (!result.ok) return authorizationFailure(result.error, "execute the SQLite statement") ?? sqlMutationFailure(result.error);
     const normalized = normalizeExecuteResult(result.data);
     return {
       status: "ok",
@@ -3177,7 +3192,7 @@ async function executeSqlDml(context, input) {
     };
   } catch (error) {
     if (error instanceof OperationInvocationError) return { status: "error", error: error.operationError };
-    return authorizationFailure(error, "execute the SQLite statement") ?? sqlMutationFailure();
+    return authorizationFailure(error, "execute the SQLite statement") ?? sqlMutationFailure(error);
   }
 }
 function isSingleReadQuery(sql) {
@@ -3354,7 +3369,9 @@ function sqlServiceFailure(error, action) {
   }
   return nodeFailure2(action);
 }
-function sqlMutationFailure() {
+function sqlMutationFailure(error) {
+  const storageFull = storageFullOperationError(error);
+  if (storageFull) return { status: "error", error: storageFull };
   return {
     status: "error",
     error: operationError(
@@ -4597,8 +4614,19 @@ var SAFE_ERROR_DETAIL_POLICIES = {
   DELEGATION_HOST_MISMATCH: {
     expectedHost: safeOriginHost,
     artifactHost: safeOriginHost
+  },
+  STORAGE_QUOTA_EXCEEDED: {
+    account: safeStorageAccount
   }
 };
+function safeStorageAccount(value) {
+  if (!isRecord(value)) return void 0;
+  const { usedBytes, limitBytes, plan } = value;
+  if (!Number.isSafeInteger(usedBytes) || usedBytes < 0 || !Number.isSafeInteger(limitBytes) || limitBytes <= 0) {
+    return void 0;
+  }
+  return typeof plan === "string" && /^[A-Za-z0-9][A-Za-z0-9 _.-]{0,31}$/.test(plan) ? { usedBytes, limitBytes, plan } : { usedBytes, limitBytes };
+}
 function redactSafeErrorDetails(code, details) {
   const policy = SAFE_ERROR_DETAIL_POLICIES[code];
   if (policy === void 0) return void 0;