@kubun/with-apollo 0.17.1 → 0.17.2

package/lib/index.d.ts

@@ -1,3 +1,18 @@
 import { ApolloLink } from '@apollo/client';
 import type { GraphQLSource } from '@kubun/protocol';
+/**
+ * The connector operation-envelope ids a mutation carries (see
+ * `GraphQLOperationParams.operationID`): required on a connector action
+ * mutation, the same pair on every retry of one user intent, a new pair for a
+ * new intent.
+ */
+export type OperationEnvelope = {
+    operationID: string;
+    deterministicEventID: string;
+};
+/**
+ * The Apollo operation `context` that carries an operation envelope to the
+ * link, for a mutation (`client.mutate({ context })` / `useMutation`).
+ */
+export declare function operationEnvelopeContext(envelope: OperationEnvelope): Record<string, unknown>;
 export declare function createLink(source: GraphQLSource): ApolloLink;

package/lib/index.js

@@ -1,5 +1,32 @@
 import { ApolloLink, Observable } from '@apollo/client';
 import { getMainDefinition, print } from '@apollo/client/utilities';
+const OPERATION_ENVELOPE_KEY = 'kubunOperationEnvelope';
+/**
+ * The Apollo operation `context` that carries an operation envelope to the
+ * link, for a mutation (`client.mutate({ context })` / `useMutation`).
+ */ export function operationEnvelopeContext(envelope) {
+    return {
+        [OPERATION_ENVELOPE_KEY]: {
+            operationID: envelope.operationID,
+            deterministicEventID: envelope.deterministicEventID
+        }
+    };
+}
+// The operation envelope an operation's context carries, each id only when it
+// is a string.
+function operationEnvelopeFrom(context) {
+    const envelope = context[OPERATION_ENVELOPE_KEY];
+    const operationID = envelope?.operationID;
+    const deterministicEventID = envelope?.deterministicEventID;
+    return {
+        ...typeof operationID === 'string' ? {
+            operationID
+        } : {},
+        ...typeof deterministicEventID === 'string' ? {
+            deterministicEventID
+        } : {}
+    };
+}
 function toObservable(promise) {
     return new Observable((observer)=>{
         promise.then((result)=>{
@@ -75,7 +102,10 @@ export function createLink(source) {
         }
         // query or mutation -- route to the appropriate source method
         if (definition.operation === 'mutation') {
-            return toObservable(source.mutate(params));
+            return toObservable(source.mutate({
+                ...params,
+                ...operationEnvelopeFrom(operation.getContext())
+            }));
         }
         return toObservable(source.query(params));
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubun/with-apollo",
-  "version": "0.17.1",
+  "version": "0.17.2",
   "keywords": [],
   "license": "see LICENSE.md",
   "sideEffects": false,
@@ -15,16 +15,16 @@
     "LICENSE.md"
   ],
   "dependencies": {
-    "@apollo/client": "^4.3.0",
+    "@apollo/client": "^4.3.1",
     "graphql": "^17.0.2"
   },
   "devDependencies": {
     "@enkaku/transport": "^0.21.0",
-    "@kubun/client": "^0.17.1",
-    "@kubun/engine": "^0.17.1",
-    "@kubun/plugin-service-server": "^0.17.0",
-    "@kubun/protocol": "^0.17.0",
-    "@kubun/service-graph-api": "^0.17.1",
+    "@kubun/client": "^0.17.2",
+    "@kubun/engine": "^0.17.2",
+    "@kubun/plugin-service-server": "^0.17.1",
+    "@kubun/protocol": "^0.17.1",
+    "@kubun/service-graph-api": "^0.17.2",
     "@kubun/test-utils": "^0.0.0"
   },
   "publishConfig": {