@gonvex/protocol 0.5.2-staging.2 → 0.5.2-staging.21

package/README.md

@@ -42,3 +42,5 @@ The package includes:
 ## Documentation
 
 Full docs live at https://desarso.github.io/gonvex/
+
+[Public tenant authentication adds `public: true` to an `auth` frame](../../docs/public-functions.md).

package/dist/index.d.ts

@@ -58,6 +58,7 @@ export type FunctionManifestEntry = {
     args?: ModuleSchema;
     result?: ModuleSchema;
     internal?: boolean;
+    public?: boolean;
     delivery?: "oneShot" | "live" | "replica";
     dependencies?: FunctionDependencies;
     replica?: ReplicaCollectionDefinition;
@@ -149,13 +150,19 @@ export type LiveQueryPlan = {
 };
 export type FilterOperator = "contains" | "notContains" | "equals" | "notEquals" | "startsWith" | "endsWith" | "empty" | "notEmpty" | "oneOf" | "lessThan" | "lessThanOrEqual" | "greaterThan" | "greaterThanOrEqual" | "inRange";
 export type LiveExpression = {
-    operator: "eq" | "neq" | "gt" | "gte" | "lt" | "lte" | "in" | "contains" | "containsInsensitive" | "range" | "and" | "or" | "not" | "server";
+    operator: "eq" | "neq" | "gt" | "gte" | "lt" | "lte" | "in" | "contains" | "containsInsensitive" | "range" | "and" | "or" | "not" | "server" | "inRelation" | "arrayContains";
     column?: string;
     value?: LiveValue;
     valueTo?: LiveValue;
     children?: LiveExpression[];
+    relation?: {
+        table: string;
+        column: string;
+        where?: LiveExpression;
+    };
 };
 export type LiveValue = {
+    context?: "account.id" | "member.id" | "tenant.id";
     argument?: string;
     literal?: JsonValue;
 };
@@ -234,6 +241,10 @@ export type ReducerCallRequest = {
     trace?: MessageTrace;
     /** Stable key for a replayable command; see the `reducer.call` message. */
     idempotencyKey?: string;
+    artifactHash?: string;
+    clientContract?: number;
+    receiptPath?: string;
+    intentEntropy?: string;
 };
 export type ReplicaOpenRequest = {
     id: string;
@@ -285,11 +296,13 @@ export type GonvexManifest = {
 };
 export type ClientMessage = {
     type: "auth";
+    clientContract?: number;
     id: string;
     token?: string;
     project?: string;
     tenant?: string;
     controlOnly?: boolean;
+    public?: boolean;
     device?: BrowserTelemetryInfo;
     capabilities?: ClientCapabilities;
 } | {
@@ -340,6 +353,10 @@ export type ClientMessage = {
      * every duplicate delivery.
      */
     idempotencyKey?: string;
+    artifactHash?: string;
+    clientContract?: number;
+    receiptPath?: string;
+    intentEntropy?: string;
 } | {
     type: "reducer.callMany";
     calls: ReducerCallRequest[];
@@ -377,6 +394,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[];
@@ -571,6 +600,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;
@@ -584,6 +617,10 @@ export type ServerMessage = {
     path?: string;
     error: string;
     trace?: MessageTrace;
+} | {
+    type: "client.updateRequired";
+    reason: string;
+    contract: number;
 } | {
     type: "system.reload";
     reason: string;

package/package.json

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