@jskit-ai/realtime 0.1.96 → 0.1.97

package/package.descriptor.mjs

@@ -1,7 +1,7 @@
 export default Object.freeze({
   packageVersion: 1,
   packageId: "@jskit-ai/realtime",
-  version: "0.1.96",
+  version: "0.1.97",
   kind: "runtime",
   description: "Thin, generic realtime runtime wrappers for socket.io server and client.",
   options: {
@@ -95,7 +95,7 @@ export default Object.freeze({
   mutations: {
     dependencies: {
       runtime: {
-        "@jskit-ai/kernel": "0.1.98",
+        "@jskit-ai/kernel": "0.1.99",
         "@socket.io/redis-adapter": "^8.3.0",
         "redis": "^5.8.2",
         "socket.io": "^4.8.3",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jskit-ai/realtime",
-  "version": "0.1.96",
+  "version": "0.1.97",
   "type": "module",
   "scripts": {
     "test": "node --test"
@@ -16,7 +16,7 @@
   },
   "dependencies": {
     "@socket.io/redis-adapter": "^8.3.0",
-    "@jskit-ai/kernel": "0.1.98",
+    "@jskit-ai/kernel": "0.1.99",
     "redis": "^5.8.2",
     "socket.io": "^4.8.3",
     "socket.io-client": "^4.8.3"

package/src/server/RealtimeServiceProvider.js

@@ -169,16 +169,32 @@ function buildRealtimeDispatchIndex(registrations = []) {
 
 function mergeRealtimePayload(event, payloadPatch) {
   const basePayload = event && typeof event === "object" && !Array.isArray(event) ? event : {};
+  const action = normalizeText(basePayload?.meta?.action);
+  const reason = normalizeText(basePayload?.meta?.reason);
+  const semanticPatch = {};
+  if (action) {
+    semanticPatch.action = action;
+  }
+  if (reason) {
+    semanticPatch.reason = reason;
+  }
+
   if (payloadPatch == null) {
-    return basePayload;
+    return Object.keys(semanticPatch).length > 0
+      ? {
+          ...semanticPatch,
+          ...basePayload
+        }
+      : basePayload;
   }
   if (!payloadPatch || typeof payloadPatch !== "object" || Array.isArray(payloadPatch)) {
     throw new TypeError("Realtime payload callback must return an object.");
   }
 
-  // Keep canonical domain-event fields authoritative while allowing additive metadata.
+  // Keep canonical domain-event fields and standard lifecycle metadata authoritative.
   return {
     ...payloadPatch,
+    ...semanticPatch,
     ...basePayload
   };
 }

package/test/providerRuntime.test.js

@@ -615,6 +615,8 @@ test("RealtimeServiceProvider merges custom realtime payload with canonical doma
             source: "workspace",
             entity: "settings",
             operation: "updated",
+            action: "settings-saved",
+            reason: "profile-update",
             realtime: {
               event: "workspace.settings.changed",
               payload: ({ result }) => ({
@@ -670,10 +672,14 @@ test("RealtimeServiceProvider merges custom realtime payload with canonical doma
   assert.equal(emitted.length, 1);
   assert.equal(emitted[0].room, "workspace:11");
   assert.equal(emitted[0].eventName, "workspace.settings.changed");
+  assert.equal(emitted[0].payload?.action, "settings-saved");
+  assert.equal(emitted[0].payload?.reason, "profile-update");
   assert.equal(emitted[0].payload?.workspaceSlug, "acme");
   assert.equal(emitted[0].payload?.source, "workspace");
   assert.equal(emitted[0].payload?.entity, "settings");
   assert.equal(emitted[0].payload?.operation, "updated");
+  assert.equal(emitted[0].payload?.meta?.action, "settings-saved");
+  assert.equal(emitted[0].payload?.meta?.reason, "profile-update");
   assert.equal(emitted[0].payload?.scope?.kind, "workspace");
   assert.equal(emitted[0].payload?.scope?.id, "11");
 });