@almadar/std 16.9.1 → 16.10.0

package/dist/registry/core/atoms/std-notify-on-event.orb

@@ -1,7 +1,7 @@
 {
   "name": "std-notify-on-event",
-  "version": "1.1.0",
-  "description": "std-notify-on-event — event-driven notification dispatcher. Listens for the generic `EventOccurred` sentinel (rename via traitOverrides.events to the real event, e.g. ContactSaved). Resolves recipient from `recipients` (first entry; fan-out is a future extension) or falls back to `@user.id`. Skips dispatch when the recipient is in `suppressionList`. Emits in-app `notify` when `notifyChannel` is `\"in-app\"`, or persists a `NotificationRecord` row for out-of-band delivery when channel is `\"email\"` or `\"sms\"`.",
+  "version": "1.2.0",
+  "description": "std-notify-on-event — cross-orbital wiring atom. Subscribes to events from another orbital (e.g. CheckoutOrbital emits OrderPlaced, OrderRecordOrbital reacts via this atom) and dispatches a notification. Use when one orbital needs to react to or be notified about events that happen in another orbital — the wiring goes through this atom's `EventOccurred` listener which the molecule renames via traitOverrides.events to the upstream event name. Resolves recipient from `recipients` (first entry; multi-recipient fan-out is a future extension) or falls back to `@user.id`. Skips dispatch when the recipient is in `suppressionList`. Emits in-app `notify` when `notifyChannel` is `\"in-app\"`, or persists a `NotificationRecord` row for out-of-band delivery when channel is `\"email\"` or `\"sms\"`.",
   "orbitals": [
     {
       "name": "NotifyOnEventOrbital",
@@ -211,11 +211,11 @@
                         "NotificationRecord",
                         {
                           "recipient": "@entity.recipient",
-                          "message": "@config.template",
                           "channel": "@config.notifyChannel",
-                          "severity": "@config.severity",
                           "dispatched": false,
-                          "recordedAt": 0.0
+                          "severity": "@config.severity",
+                          "recordedAt": 0.0,
+                          "message": "@config.template"
                         }
                       ]
                     ]
@@ -224,10 +224,10 @@
                     "emit",
                     "NotificationDispatched",
                     {
-                      "severity": "@config.severity",
                       "message": "@config.template",
                       "recipient": "@entity.recipient",
-                      "channel": "@config.notifyChannel"
+                      "channel": "@config.notifyChannel",
+                      "severity": "@config.severity"
                     }
                   ]
                 ]
@@ -235,23 +235,33 @@
             ]
           },
           "config": {
-            "notifyChannel": {
+            "template": {
               "type": "string",
-              "default": "in-app",
-              "label": "Channel",
-              "description": "Delivery channel: in-app, email, or sms",
-              "tier": "domain"
+              "default": "",
+              "label": "Message template",
+              "description": "Text shown to the recipient; supports payload interpolation",
+              "synonyms": "notification text, message body, alert text",
+              "tier": "presentation"
             },
-            "suppressionList": {
+            "listensFor": {
               "type": "[string]",
               "default": [],
-              "label": "Suppression list",
-              "description": "Recipient ids/addresses to skip (e.g. unsubscribed users). Suppression check runs before dispatch.",
+              "label": "Trigger events",
+              "description": "Event names that should fire a notification. Set this to the upstream event name (e.g. OrderPlaced, CheckoutCompleted) so this atom listens for events from the orbital that emits them. The orbital owning this trait reacts whenever the named event fires anywhere in the schema.",
+              "synonyms": "subscribe to event, listen for event, react to event, watch for, wire upstream event, observe event from another orbital, cross-orbital subscription, on-event trigger",
               "tier": "domain",
               "items": {
                 "type": "string"
               }
             },
+            "severity": {
+              "type": "string",
+              "default": "info",
+              "label": "Severity",
+              "description": "info, success, warning, or error — controls styling",
+              "synonyms": "alert level, priority, urgency",
+              "tier": "domain"
+            },
             "frequencyCapPerWeek": {
               "type": "number",
               "default": 0.0,
@@ -259,25 +269,20 @@
               "description": "Max sends per (channel, recipient) per rolling 7-day window. 0 = uncapped. WIRING DEFERRED: needs stateful history query (gap — docs/Almadar_Std_Factories.md).",
               "tier": "domain"
             },
-            "severity": {
+            "notifyChannel": {
               "type": "string",
-              "default": "info",
-              "label": "Severity",
-              "description": "info, success, warning, or error — controls styling",
+              "default": "in-app",
+              "label": "Channel",
+              "description": "Delivery channel: in-app, email, or sms",
+              "synonyms": "delivery method, notification channel, send via, dispatch through",
               "tier": "domain"
             },
-            "template": {
-              "type": "string",
-              "default": "",
-              "label": "Message template",
-              "description": "Text shown to the recipient; supports payload interpolation",
-              "tier": "presentation"
-            },
-            "listensFor": {
+            "suppressionList": {
               "type": "[string]",
               "default": [],
-              "label": "Trigger events",
-              "description": "Event names that should fire a notification",
+              "label": "Suppression list",
+              "description": "Recipient ids/addresses to skip (e.g. unsubscribed users). Suppression check runs before dispatch.",
+              "synonyms": "block list, unsubscribed, opt-out list",
               "tier": "domain",
               "items": {
                 "type": "string"
@@ -286,8 +291,8 @@
             "quietHours": {
               "type": "QuietHoursSpec",
               "default": {
-                "end": "",
-                "start": ""
+                "start": "",
+                "end": ""
               },
               "label": "Quiet hours",
               "description": "Local-time window during which dispatch is suppressed. Both start and end required to activate. WIRING DEFERRED: needs @now-aware time comparison primitive (gap — docs/Almadar_Std_Factories.md).",
@@ -310,6 +315,7 @@
               "default": [],
               "label": "Recipients",
               "description": "Recipient ids/addresses. v1.1 uses the first entry; multi-recipient fan-out lands in v1.2 (gap). When empty, falls back to the authenticated user.",
+              "synonyms": "targets, addressees, notify to",
               "tier": "domain",
               "items": {
                 "type": "string"