@gonvex/protocol 0.5.2-staging.14 → 0.5.2-staging.16

package/dist/index.d.ts

@@ -392,6 +392,18 @@ export type ClientMessage = {
     trace?: MessageTrace;
     device?: BrowserTelemetryInfo;
 };
+/**
+ * Machine-readable disposition of a failed Reducer call.
+ *
+ * - `rejected`: the Reducer refused the intent (application throw, validation,
+ *   permission, conflict). Retrying the same call cannot succeed.
+ * - `transient`: infrastructure failed and the transaction rolled back. The
+ *   same idempotency key may be retried.
+ * - `update_required`: the client's Reducer artifact or contract is stale.
+ * - `unauthenticated`: the connection has no usable tenant session. Keep the
+ *   intent, re-authenticate, and retry.
+ */
+export type ReducerErrorClass = "rejected" | "transient" | "update_required" | "unauthenticated";
 export type ServerMessage = {
     type: "query.batch";
     messages: ServerMessage[];
@@ -586,6 +598,10 @@ export type ServerMessage = {
     path?: string;
     error: string;
     trace?: MessageTrace;
+    /** Absent from runtimes before 0.5.2-staging.15; treat absence as a legacy rejection. */
+    class?: ReducerErrorClass;
+    /** True when the same call (same idempotency key) may succeed later. */
+    retryable?: boolean;
 } | {
     type: "action.result";
     id: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gonvex/protocol",
-  "version": "0.5.2-staging.14",
+  "version": "0.5.2-staging.16",
   "type": "module",
   "publishConfig": {
     "access": "public"