@voltro/protocol 0.52.0 → 0.54.0

package/dist/rest.d.ts

@@ -230,6 +230,8 @@ declare interface IdempotencyStore {
 declare interface InsertTarget<Input = unknown, Row = unknown, Item = Record<string, unknown>> extends NestedTargetFields<Input> {
     readonly table: string;
     readonly op: 'insert';
+    /** Declared junction relations — see {@link TargetRelations}. */
+    readonly relations?: TargetRelations | undefined;
     readonly order?: 'prepend' | 'append' | undefined;
     /**
      * Build the optimistic row from the mutation input. The framework
@@ -998,11 +1000,29 @@ declare type Subject = typeof Subject.Type;
 
 declare type Target<Input = unknown, Row = unknown> = TargetSpec<Input, Row> | ReadonlyArray<TargetSpec<Input, Row>>;
 
+/**
+ * Declared many-to-many RELATIONS of a write target: `{ inputField:
+ * junctionTable }`. After the executor succeeds — inside the SAME
+ * transaction — the framework reconciles the junction's links for the
+ * written row against `input[inputField]` (an array of target ids) via the
+ * diff-based `store.relationLinks`, so a form's multi-reference field saves
+ * in one mutation with no hand-written junction code. The anchor column is
+ * derived from the junction's `reference()` targets (a self-junction is
+ * refused, never guessed).
+ *
+ * An ABSENT input field leaves the links untouched (absent ≠ empty — an
+ * empty array is the explicit "clear them all"). The row id is the
+ * executor's `output.id`, falling back to `input.id`.
+ */
+declare type TargetRelations = Readonly<Record<string, string>>;
+
 declare type TargetSpec<Input = unknown, Row = unknown> = InsertTarget<Input, Row> | UpdateTarget<Input, Row> | DeleteTarget<Input>;
 
 declare interface UpdateTarget<Input = unknown, Row = unknown, Item = Record<string, unknown>> extends NestedTargetFields<Input> {
     readonly table: string;
     readonly op: 'update';
+    /** Declared junction relations — see {@link TargetRelations}. */
+    readonly relations?: TargetRelations | undefined;
     /** Identify the row(s) to patch. Default: `input.id`. Return an ARRAY to patch
      *  MANY rows/items in one mutation (a bulk edit — where the per-item
      *  parallel-write race lived). */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voltro/protocol",
-  "version": "0.52.0",
+  "version": "0.54.0",
   "description": "The Voltro wire + plugin contract — defineQuery/Mutation/Action/Stream, definePlugin, sessions / JWT / API-keys, and the RPC protocol.",
   "keywords": [
     "voltro",
@@ -54,8 +54,8 @@
   },
   "dependencies": {
     "@effect/sql": "^0.52.0",
-    "@voltro/database": "0.52.0",
-    "@voltro/logger": "0.52.0",
+    "@voltro/database": "0.54.0",
+    "@voltro/logger": "0.54.0",
     "jose": "^6.2.8"
   },
   "peerDependencies": {