@evolu/common 8.12.0 → 8.14.0

package/src/local-first/Protocol.ts

@@ -465,8 +465,9 @@ export interface ProtocolWriteKeyError
   extends OwnerError, Typed<"ProtocolWriteKeyError"> {}
 
 /**
- * Error indicating a serious relay-side write failure. Clients should log this
- * error and show a generic sync error to the user.
+ * Error indicating a serious relay-side write failure. Sync state shows it as
+ * the failure of that relay's route; apps show a generic sync error for the
+ * owner's `Error` status.
  */
 export interface ProtocolWriteError
   extends OwnerError, Typed<"ProtocolWriteError"> {}
@@ -489,8 +490,9 @@ export interface ProtocolQuotaError
   extends OwnerError, Typed<"ProtocolQuotaError"> {}
 
 /**
- * Error indicating a serious relay-side synchronization failure. Clients should
- * log this error and show a generic sync error to the user.
+ * Error indicating a serious relay-side synchronization failure. Sync state
+ * shows it as the failure of that relay's route; apps show a generic sync error
+ * for the owner's `Error` status.
  */
 export interface ProtocolSyncError
   extends OwnerError, Typed<"ProtocolSyncError"> {}
@@ -1286,13 +1288,9 @@ export const applyProtocolMessageAsRelay =
           );
 
           if (!result.ok) {
-            const isQuotaError = result.error.type === "StorageQuotaError";
-            if (!isQuotaError) run.deps.console.error(result.error);
             const message = createProtocolMessageBuffer(ownerId, {
               messageType: MessageType.Response,
-              errorCode: isQuotaError
-                ? ProtocolErrorCode.QuotaError
-                : ProtocolErrorCode.WriteError,
+              errorCode: ProtocolErrorCode.QuotaError,
             }).unwrap();
             return ok({ type: "Response", message });
           }

package/src/local-first/Schema.ts

@@ -43,7 +43,7 @@ import {
   type withDefault,
 } from "../Type.ts";
 import type { CompileTimeError, Simplify } from "../Types.ts";
-import type { Evolu, maxMutationSize } from "./Evolu.ts";
+import type { Evolu, EvoluErrorDep, maxMutationSize } from "./Evolu.ts";
 import type { AppOwner, OwnerIdBytes } from "./Owner.ts";
 import {
   OwnerEncryptionKey,
@@ -514,7 +514,13 @@ export interface MutationOptions {
    * Called after the mutation's changes are stored and subscribed queries
    * reflect them. Useful for follow-up work (e.g., notifications, navigation)
    * after insert, update, or upsert. It never runs when the database is
-   * unavailable.
+   * unavailable or the mutation could not be stored, which
+   * {@link EvoluErrorDep.evoluError} reports.
+   *
+   * An Evolu instance stores its mutations in batches, each in one transaction.
+   * A batch holds the mutations made before Evolu sends it in a microtask,
+   * usually one synchronous block, and {@link Evolu.requestSync} sends it early.
+   * When one mutation cannot be stored, none of its batch is.
    *
    * Stored does not always mean visible. A change quarantined for
    * {@link QuarantineReason.TimestampDrift} is stored in