@almadar/std 16.181.0 → 16.183.0

package/behaviors/registry/infra/atoms/std-notification-center.orb

@@ -0,0 +1,1621 @@
+{
+  "description": "std-notification-center — per-user notification preferences, web-push subscriptions, and the digest drain for suppressed notifications. Owns the two owner-scoped stores std-notify-on-event consults at dispatch time: NotificationPreference rows (per event key: mode instant/digest/off, channel override, per-user quiet hours) and PushSubscription rows (captured via the browser/push-subscribe flow — the shared service worker + PushManager subscription, persisted as flat endpoint/p256dh/auth credentials). The DigestDrain trait is the delivery half of every suppression std-notify-on-event records: an hourly cron tick scans NotificationRecord audit rows left undispatched for digest/quiet-hours reasons and at least `minAgeHours` old, delivers each by email (the digest channel), and marks it dispatched — the reminder-scheduler self-driving scan loop verbatim. Compose alongside std-notify-on-event: the listener suppresses and records, this atom captures subscriptions, edits preferences, and drains.",
+  "ledger": {
+    "entries": {
+      "ent_01M0M65FFF0G1ZEE15D76BK6XK": {
+        "bakedName": "NotificationPreference",
+        "curName": "NotificationPreference",
+        "id": "ent_01M0M65FFF0G1ZEE15D76BK6XK",
+        "kind": "entity",
+        "owner": "workspace",
+        "renames": []
+      },
+      "ent_01M0M65FFFBR45A2QA3ZWP1HD4": {
+        "bakedName": "PushSubscription",
+        "curName": "PushSubscription",
+        "id": "ent_01M0M65FFFBR45A2QA3ZWP1HD4",
+        "kind": "entity",
+        "owner": "workspace",
+        "renames": []
+      },
+      "ent_01M0M65FFFQ3XBF85WBE2VSWMY": {
+        "bakedName": "NotificationRecord",
+        "curName": "NotificationRecord",
+        "id": "ent_01M0M65FFFQ3XBF85WBE2VSWMY",
+        "kind": "entity",
+        "owner": "workspace",
+        "renames": []
+      },
+      "ent_01M0M65FFFZGACVWJYWZ3AE6ZZ": {
+        "bakedName": "DigestRunView",
+        "curName": "DigestRunView",
+        "id": "ent_01M0M65FFFZGACVWJYWZ3AE6ZZ",
+        "kind": "entity",
+        "owner": "workspace",
+        "renames": []
+      },
+      "evt_01M0M65FFF0QM818V9HGCCN1VA": {
+        "bakedName": "DIGEST_STEPPED",
+        "curName": "DIGEST_STEPPED",
+        "id": "evt_01M0M65FFF0QM818V9HGCCN1VA",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M0M65FFF9APPJEKH9Y561YA4",
+        "renames": []
+      },
+      "evt_01M0M65FFF1C1VHHNW8CYAE5W5": {
+        "bakedName": "SUBSCRIBE_PUSH",
+        "curName": "SUBSCRIBE_PUSH",
+        "id": "evt_01M0M65FFF1C1VHHNW8CYAE5W5",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M0M65FFF4P6SDTP06Z8M22C2",
+        "renames": []
+      },
+      "evt_01M0M65FFF1K04JNAZHABZTEHE": {
+        "bakedName": "DIGEST_ITEM_SENT",
+        "curName": "DIGEST_ITEM_SENT",
+        "id": "evt_01M0M65FFF1K04JNAZHABZTEHE",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M0M65FFF9APPJEKH9Y561YA4",
+        "renames": []
+      },
+      "evt_01M0M65FFF3VJFCFJW2MFTQ33R": {
+        "bakedName": "UPDATE_PREFERENCE",
+        "curName": "UPDATE_PREFERENCE",
+        "id": "evt_01M0M65FFF3VJFCFJW2MFTQ33R",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M0M65FFFH69MBB0G62CE4NHC",
+        "renames": []
+      },
+      "evt_01M0M65FFF7XGSZAATT13F5G5Z": {
+        "bakedName": "PREFERENCE_SAVED",
+        "curName": "PREFERENCE_SAVED",
+        "id": "evt_01M0M65FFF7XGSZAATT13F5G5Z",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M0M65FFFH69MBB0G62CE4NHC",
+        "renames": []
+      },
+      "evt_01M0M65FFFD1RTHPARJ5HZCKGZ": {
+        "bakedName": "SAVE_PREFERENCE",
+        "curName": "SAVE_PREFERENCE",
+        "id": "evt_01M0M65FFFD1RTHPARJ5HZCKGZ",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M0M65FFFH69MBB0G62CE4NHC",
+        "renames": []
+      },
+      "evt_01M0M65FFFD96C401APVT4PSDX": {
+        "bakedName": "PUSH_SAVED",
+        "curName": "PUSH_SAVED",
+        "id": "evt_01M0M65FFFD96C401APVT4PSDX",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M0M65FFF4P6SDTP06Z8M22C2",
+        "renames": []
+      },
+      "evt_01M0M65FFFG5RH4AMKM6PRC7D9": {
+        "bakedName": "PREFERENCE_SAVE_FAILED",
+        "curName": "PREFERENCE_SAVE_FAILED",
+        "id": "evt_01M0M65FFFG5RH4AMKM6PRC7D9",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M0M65FFFH69MBB0G62CE4NHC",
+        "renames": []
+      },
+      "evt_01M0M65FFFGSKNV146RNQW7CGC": {
+        "bakedName": "DELETE_PREFERENCE",
+        "curName": "DELETE_PREFERENCE",
+        "id": "evt_01M0M65FFFGSKNV146RNQW7CGC",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M0M65FFFH69MBB0G62CE4NHC",
+        "renames": []
+      },
+      "evt_01M0M65FFFKR8G9TZW4WES7CAT": {
+        "bakedName": "PUSH_SUBSCRIBED",
+        "curName": "PUSH_SUBSCRIBED",
+        "id": "evt_01M0M65FFFKR8G9TZW4WES7CAT",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M0M65FFF4P6SDTP06Z8M22C2",
+        "renames": []
+      },
+      "evt_01M0M65FFFKTWQWBWKXQ33881V": {
+        "bakedName": "PUSH_SAVE_FAILED",
+        "curName": "PUSH_SAVE_FAILED",
+        "id": "evt_01M0M65FFFKTWQWBWKXQ33881V",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M0M65FFF4P6SDTP06Z8M22C2",
+        "renames": []
+      },
+      "evt_01M0M65FFFS4TZ2J5V874NFENP": {
+        "bakedName": "PREFERENCE_DELETED",
+        "curName": "PREFERENCE_DELETED",
+        "id": "evt_01M0M65FFFS4TZ2J5V874NFENP",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M0M65FFFH69MBB0G62CE4NHC",
+        "renames": []
+      },
+      "evt_01M0M65FFFTXQ7Y0YV9XY3X1A5": {
+        "bakedName": "DIGEST_FAILED",
+        "curName": "DIGEST_FAILED",
+        "id": "evt_01M0M65FFFTXQ7Y0YV9XY3X1A5",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M0M65FFF9APPJEKH9Y561YA4",
+        "renames": []
+      },
+      "evt_01M0M65FFFW27HPBWGDZ9Z9RPC": {
+        "bakedName": "PUSH_SUBSCRIBE_FAILED",
+        "curName": "PUSH_SUBSCRIBE_FAILED",
+        "id": "evt_01M0M65FFFW27HPBWGDZ9Z9RPC",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M0M65FFF4P6SDTP06Z8M22C2",
+        "renames": []
+      },
+      "evt_01M0M65FFFX5V7JGP2T5AXQS76": {
+        "bakedName": "DIGEST_ROWS_LOADED",
+        "curName": "DIGEST_ROWS_LOADED",
+        "id": "evt_01M0M65FFFX5V7JGP2T5AXQS76",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M0M65FFF9APPJEKH9Y561YA4",
+        "renames": []
+      },
+      "orb_01M0M65FFF1A3816MJVC21AJN9": {
+        "bakedName": "NotificationCenterOrbital",
+        "curName": "NotificationCenterOrbital",
+        "id": "orb_01M0M65FFF1A3816MJVC21AJN9",
+        "kind": "orbital",
+        "owner": "workspace",
+        "renames": []
+      },
+      "pag_01M0M65FFF4BYKP02HV3REFA10": {
+        "bakedName": "PushSubscribePage",
+        "curName": "PushSubscribePage",
+        "id": "pag_01M0M65FFF4BYKP02HV3REFA10",
+        "kind": "page",
+        "owner": "workspace",
+        "renames": []
+      },
+      "pag_01M0M65FFFK9K643YBXKERZRMH": {
+        "bakedName": "NotificationPreferencesPage",
+        "curName": "NotificationPreferencesPage",
+        "id": "pag_01M0M65FFFK9K643YBXKERZRMH",
+        "kind": "page",
+        "owner": "workspace",
+        "renames": []
+      },
+      "pag_01M0M74SY2KDDK1TM4B3HQPZ99": {
+        "bakedName": "NotificationDigestPage",
+        "curName": "NotificationDigestPage",
+        "id": "pag_01M0M74SY2KDDK1TM4B3HQPZ99",
+        "kind": "page",
+        "owner": "workspace",
+        "renames": []
+      },
+      "trt_01M0M65FFF4P6SDTP06Z8M22C2": {
+        "bakedName": "PushSubscriber",
+        "curName": "PushSubscriber",
+        "id": "trt_01M0M65FFF4P6SDTP06Z8M22C2",
+        "kind": "trait",
+        "owner": "workspace",
+        "renames": []
+      },
+      "trt_01M0M65FFF9APPJEKH9Y561YA4": {
+        "bakedName": "DigestDrain",
+        "curName": "DigestDrain",
+        "id": "trt_01M0M65FFF9APPJEKH9Y561YA4",
+        "kind": "trait",
+        "owner": "workspace",
+        "renames": []
+      },
+      "trt_01M0M65FFFH69MBB0G62CE4NHC": {
+        "bakedName": "PreferenceEditor",
+        "curName": "PreferenceEditor",
+        "id": "trt_01M0M65FFFH69MBB0G62CE4NHC",
+        "kind": "trait",
+        "owner": "workspace",
+        "renames": []
+      }
+    },
+    "schemaVersion": 1
+  },
+  "name": "std-notification-center",
+  "orbitals": [
+    {
+      "auxiliaryEntities": [
+        {
+          "collection": "pushSubscriptions",
+          "fields": [
+            {
+              "name": "id",
+              "required": true,
+              "type": "string"
+            },
+            {
+              "default": "",
+              "description": "Owner of this browser push subscription. Owner-scoped access predicates belong to the binding organism's [identity] roster, as with NotificationPreference.",
+              "name": "userId",
+              "synonyms": "user, owner, account",
+              "type": "string"
+            },
+            {
+              "default": "",
+              "description": "Push service endpoint URL for this subscription.",
+              "name": "endpoint",
+              "synonyms": "push url, subscription endpoint",
+              "type": "string"
+            },
+            {
+              "default": "",
+              "description": "Client public key (p256dh) of the subscription.",
+              "name": "p256dh",
+              "synonyms": "public key",
+              "type": "string"
+            },
+            {
+              "default": "",
+              "description": "Auth secret of the subscription.",
+              "name": "auth",
+              "synonyms": "auth secret",
+              "type": "string"
+            },
+            {
+              "default": 0.0,
+              "description": "When this subscription was captured.",
+              "name": "createdAt",
+              "synonyms": "subscribed at, created",
+              "type": "number"
+            },
+            {
+              "default": "",
+              "description": "Scratch: last subscribe-flow failure shown to the user; blank = none.",
+              "name": "lastError",
+              "synonyms": "subscribe error, failure reason",
+              "type": "string"
+            }
+          ],
+          "id": "ent_01M0M65FFFBR45A2QA3ZWP1HD4",
+          "name": "PushSubscription",
+          "persistence": "persistent"
+        },
+        {
+          "collection": "notifications",
+          "fields": [
+            {
+              "name": "id",
+              "required": true,
+              "type": "string"
+            },
+            {
+              "default": "",
+              "description": "The identifier of the entity receiving the notification.",
+              "name": "recipient",
+              "synonyms": "user, target, receiver, destination",
+              "type": "string"
+            },
+            {
+              "default": "in-app",
+              "description": "The delivery method for the notification (e.g., email, SMS, in-app).",
+              "name": "channel",
+              "synonyms": "delivery, medium, type",
+              "type": "string"
+            },
+            {
+              "default": "",
+              "description": "The content of the notification message.",
+              "name": "message",
+              "synonyms": "text, content, body",
+              "type": "string"
+            },
+            {
+              "default": "info",
+              "description": "Indicates the importance or urgency level of the notification.",
+              "name": "severity",
+              "synonyms": "priority, level, importance",
+              "type": "string"
+            },
+            {
+              "default": false,
+              "description": "Indicates whether the notification has been successfully sent.",
+              "name": "dispatched",
+              "synonyms": "sent, delivered, status",
+              "type": "boolean"
+            },
+            {
+              "default": "",
+              "description": "Suppression reason or delivery failure detail when dispatched is false.",
+              "name": "error",
+              "synonyms": "error message, failure reason, dispatch error",
+              "type": "string"
+            },
+            {
+              "default": 0.0,
+              "description": "Timestamp indicating when the notification record was created.",
+              "name": "recordedAt",
+              "synonyms": "creation time, timestamp, date, when",
+              "type": "number"
+            }
+          ],
+          "id": "ent_01M0M65FFFQ3XBF85WBE2VSWMY",
+          "name": "NotificationRecord",
+          "persistence": "persistent"
+        },
+        {
+          "fields": [
+            {
+              "name": "id",
+              "required": true,
+              "type": "string"
+            },
+            {
+              "default": "",
+              "description": "Scratch: id of the audit row the drain loop is currently delivering.",
+              "name": "headId",
+              "synonyms": "current id, cursor",
+              "type": "string"
+            },
+            {
+              "default": "",
+              "description": "Scratch: recipient of the row being delivered.",
+              "name": "headRecipient",
+              "synonyms": "current recipient",
+              "type": "string"
+            },
+            {
+              "default": "",
+              "description": "Scratch: message of the row being delivered.",
+              "name": "headMessage",
+              "synonyms": "current message",
+              "type": "string"
+            },
+            {
+              "default": 0.0,
+              "description": "Number of rows delivered in the current drain cycle.",
+              "name": "drainedCount",
+              "synonyms": "delivered count, processed",
+              "type": "number"
+            },
+            {
+              "default": "",
+              "description": "Last drain failure; blank = none.",
+              "name": "lastError",
+              "synonyms": "drain error, failure",
+              "type": "string"
+            }
+          ],
+          "id": "ent_01M0M65FFFZGACVWJYWZ3AE6ZZ",
+          "name": "DigestRunView",
+          "persistence": "runtime"
+        }
+      ],
+      "entity": {
+        "collection": "notificationPreferences",
+        "fields": [
+          {
+            "name": "id",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "default": "",
+            "description": "Owner of this preference row — rows are meant to be private to their owner. Access predicates need an [identity] roster, so the binding organism (which declares one) owns the @read/@update scoping; the generic atom cannot.",
+            "name": "userId",
+            "synonyms": "user, owner, account",
+            "type": "string"
+          },
+          {
+            "default": "",
+            "description": "Event key this preference applies to (matches a listener's eventKey); blank = all events.",
+            "name": "eventType",
+            "synonyms": "event, trigger, subscription, topic",
+            "type": "string"
+          },
+          {
+            "default": "instant",
+            "description": "Delivery mode: instant (default), digest (deferred to the drain cycle), or off (muted).",
+            "name": "mode",
+            "synonyms": "delivery mode, frequency, cadence, mute, defer",
+            "type": "string",
+            "values": [
+              "instant",
+              "digest",
+              "off"
+            ]
+          },
+          {
+            "default": "",
+            "description": "Channel override for this user (in-app/email/sms/push/webhook); blank = the listener's configured channel.",
+            "name": "channel",
+            "synonyms": "preferred channel, delivery method",
+            "type": "string"
+          },
+          {
+            "default": 0.0,
+            "description": "Per-user quiet-hours start (hour 0-23); equal to quietEndHour = disabled.",
+            "name": "quietStartHour",
+            "synonyms": "quiet start, do not disturb from",
+            "type": "number"
+          },
+          {
+            "default": 0.0,
+            "description": "Per-user quiet-hours end (hour 0-23); equal to quietStartHour = disabled.",
+            "name": "quietEndHour",
+            "synonyms": "quiet end, do not disturb until",
+            "type": "number"
+          }
+        ],
+        "id": "ent_01M0M65FFF0G1ZEE15D76BK6XK",
+        "name": "NotificationPreference",
+        "persistence": "persistent"
+      },
+      "id": "orb_01M0M65FFF1A3816MJVC21AJN9",
+      "name": "NotificationCenterOrbital",
+      "pages": [
+        {
+          "id": "pag_01M0M65FFFK9K643YBXKERZRMH",
+          "name": "NotificationPreferencesPage",
+          "path": "/notifications/preferences",
+          "traits": [
+            {
+              "ref": "PreferenceEditor",
+              "refId": "trt_01M0M65FFFH69MBB0G62CE4NHC"
+            }
+          ]
+        },
+        {
+          "id": "pag_01M0M65FFF4BYKP02HV3REFA10",
+          "name": "PushSubscribePage",
+          "path": "/notifications/subscribe",
+          "traits": [
+            {
+              "ref": "PushSubscriber",
+              "refId": "trt_01M0M65FFF4P6SDTP06Z8M22C2"
+            }
+          ]
+        },
+        {
+          "id": "pag_01M0M74SY2KDDK1TM4B3HQPZ99",
+          "name": "NotificationDigestPage",
+          "path": "/notifications/digest",
+          "traits": [
+            {
+              "ref": "DigestDrain",
+              "refId": "trt_01M0M65FFF9APPJEKH9Y561YA4"
+            }
+          ]
+        }
+      ],
+      "traits": [
+        {
+          "category": "lifecycle",
+          "emits": [
+            {
+              "description": "browser/push-subscribe resolved with the flat subscription credentials in `result`",
+              "event": "PUSH_SUBSCRIBED",
+              "eventId": "evt_01M0M65FFFKR8G9TZW4WES7CAT",
+              "payloadSchema": [
+                {
+                  "name": "result",
+                  "properties": [
+                    {
+                      "name": "endpoint",
+                      "type": "string"
+                    },
+                    {
+                      "name": "p256dh",
+                      "type": "string"
+                    },
+                    {
+                      "name": "auth",
+                      "type": "string"
+                    }
+                  ],
+                  "type": "object"
+                }
+              ],
+              "tier": "secondary"
+            },
+            {
+              "description": "Push API unavailable, permission denied, or the host has no VAPID key",
+              "event": "PUSH_SUBSCRIBE_FAILED",
+              "eventId": "evt_01M0M65FFFW27HPBWGDZ9Z9RPC",
+              "payloadSchema": [
+                {
+                  "name": "error",
+                  "required": true,
+                  "type": "string"
+                }
+              ],
+              "tier": "secondary"
+            },
+            {
+              "description": "Subscription row persisted for the current user",
+              "event": "PUSH_SAVED",
+              "eventId": "evt_01M0M65FFFD96C401APVT4PSDX",
+              "payloadSchema": [
+                {
+                  "name": "id",
+                  "required": true,
+                  "type": "string"
+                }
+              ],
+              "tier": "secondary"
+            },
+            {
+              "description": "Persisting the subscription row failed",
+              "event": "PUSH_SAVE_FAILED",
+              "eventId": "evt_01M0M65FFFKTWQWBWKXQ33881V",
+              "payloadSchema": [
+                {
+                  "name": "error",
+                  "required": true,
+                  "type": "string"
+                }
+              ],
+              "tier": "secondary"
+            }
+          ],
+          "entityRefIds": {
+            "PushSubscription": "ent_01M0M65FFFBR45A2QA3ZWP1HD4"
+          },
+          "id": "trt_01M0M65FFF4P6SDTP06Z8M22C2",
+          "linkedEntity": "PushSubscription",
+          "linkedEntityId": "ent_01M0M65FFFBR45A2QA3ZWP1HD4",
+          "name": "PushSubscriber",
+          "scope": "instance",
+          "stateMachine": {
+            "events": [
+              {
+                "id": "evt_01M0M65FFF1C1VHHNW8CYAE5W5",
+                "key": "SUBSCRIBE_PUSH",
+                "name": "Subscribe Push"
+              },
+              {
+                "description": "browser/push-subscribe resolved with the flat subscription credentials in `result`",
+                "id": "evt_01M0M65FFFKR8G9TZW4WES7CAT",
+                "key": "PUSH_SUBSCRIBED",
+                "name": "Push Subscribed",
+                "payloadSchema": [
+                  {
+                    "name": "result",
+                    "properties": [
+                      {
+                        "name": "endpoint",
+                        "type": "string"
+                      },
+                      {
+                        "name": "p256dh",
+                        "type": "string"
+                      },
+                      {
+                        "name": "auth",
+                        "type": "string"
+                      }
+                    ],
+                    "type": "object"
+                  }
+                ],
+                "tier": "secondary"
+              },
+              {
+                "description": "Subscription row persisted for the current user",
+                "id": "evt_01M0M65FFFD96C401APVT4PSDX",
+                "key": "PUSH_SAVED",
+                "name": "Push Saved",
+                "payloadSchema": [
+                  {
+                    "name": "id",
+                    "required": true,
+                    "type": "string"
+                  }
+                ],
+                "tier": "secondary"
+              },
+              {
+                "description": "Push API unavailable, permission denied, or the host has no VAPID key",
+                "id": "evt_01M0M65FFFW27HPBWGDZ9Z9RPC",
+                "key": "PUSH_SUBSCRIBE_FAILED",
+                "name": "Push Subscribe Failed",
+                "payloadSchema": [
+                  {
+                    "name": "error",
+                    "required": true,
+                    "type": "string"
+                  }
+                ],
+                "tier": "secondary"
+              },
+              {
+                "description": "Persisting the subscription row failed",
+                "id": "evt_01M0M65FFFKTWQWBWKXQ33881V",
+                "key": "PUSH_SAVE_FAILED",
+                "name": "Push Save Failed",
+                "payloadSchema": [
+                  {
+                    "name": "error",
+                    "required": true,
+                    "type": "string"
+                  }
+                ],
+                "tier": "secondary"
+              }
+            ],
+            "states": [
+              {
+                "isInitial": true,
+                "name": "idle"
+              }
+            ],
+            "transitions": [
+              {
+                "effects": [
+                  [
+                    "browser/push-subscribe",
+                    {
+                      "emit": {
+                        "failure": "PUSH_SUBSCRIBE_FAILED",
+                        "success": "PUSH_SUBSCRIBED"
+                      }
+                    }
+                  ]
+                ],
+                "event": "SUBSCRIBE_PUSH",
+                "eventId": "evt_01M0M65FFF1C1VHHNW8CYAE5W5",
+                "from": "idle",
+                "to": "idle"
+              },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.lastError",
+                    ""
+                  ],
+                  [
+                    "persist",
+                    "create",
+                    "PushSubscription",
+                    {
+                      "auth": "@payload.result.auth",
+                      "createdAt": "@now",
+                      "endpoint": "@payload.result.endpoint",
+                      "p256dh": "@payload.result.p256dh",
+                      "userId": "@user.id"
+                    },
+                    {
+                      "emit": {
+                        "failure": "PUSH_SAVE_FAILED",
+                        "success": "PUSH_SAVED"
+                      }
+                    }
+                  ]
+                ],
+                "event": "PUSH_SUBSCRIBED",
+                "eventId": "evt_01M0M65FFFKR8G9TZW4WES7CAT",
+                "from": "idle",
+                "to": "idle"
+              },
+              {
+                "effects": [
+                  [
+                    "notify",
+                    "success",
+                    "Push notifications enabled on this browser"
+                  ]
+                ],
+                "event": "PUSH_SAVED",
+                "eventId": "evt_01M0M65FFFD96C401APVT4PSDX",
+                "from": "idle",
+                "to": "idle"
+              },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.lastError",
+                    "@payload.error"
+                  ],
+                  [
+                    "notify",
+                    "warning",
+                    "Could not enable push notifications"
+                  ]
+                ],
+                "event": "PUSH_SUBSCRIBE_FAILED",
+                "eventId": "evt_01M0M65FFFW27HPBWGDZ9Z9RPC",
+                "from": "idle",
+                "to": "idle"
+              },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.lastError",
+                    "@payload.error"
+                  ],
+                  [
+                    "notify",
+                    "warning",
+                    "Could not save the push subscription"
+                  ]
+                ],
+                "event": "PUSH_SAVE_FAILED",
+                "eventId": "evt_01M0M65FFFKTWQWBWKXQ33881V",
+                "from": "idle",
+                "to": "idle"
+              }
+            ]
+          }
+        },
+        {
+          "category": "lifecycle",
+          "emits": [
+            {
+              "description": "Preference row persisted",
+              "event": "PREFERENCE_SAVED",
+              "eventId": "evt_01M0M65FFF7XGSZAATT13F5G5Z",
+              "payloadSchema": [
+                {
+                  "name": "id",
+                  "required": true,
+                  "type": "string"
+                }
+              ],
+              "tier": "secondary"
+            },
+            {
+              "description": "Preference row removed",
+              "event": "PREFERENCE_DELETED",
+              "eventId": "evt_01M0M65FFFS4TZ2J5V874NFENP",
+              "payloadSchema": [
+                {
+                  "name": "id",
+                  "required": true,
+                  "type": "string"
+                }
+              ],
+              "tier": "secondary"
+            },
+            {
+              "description": "Preference persist failed",
+              "event": "PREFERENCE_SAVE_FAILED",
+              "eventId": "evt_01M0M65FFFG5RH4AMKM6PRC7D9",
+              "payloadSchema": [
+                {
+                  "name": "error",
+                  "required": true,
+                  "type": "string"
+                }
+              ],
+              "tier": "secondary"
+            }
+          ],
+          "entityRefIds": {
+            "NotificationPreference": "ent_01M0M65FFF0G1ZEE15D76BK6XK"
+          },
+          "id": "trt_01M0M65FFFH69MBB0G62CE4NHC",
+          "linkedEntity": "NotificationPreference",
+          "linkedEntityId": "ent_01M0M65FFF0G1ZEE15D76BK6XK",
+          "name": "PreferenceEditor",
+          "scope": "instance",
+          "stateMachine": {
+            "events": [
+              {
+                "id": "evt_01M0M65FFFD1RTHPARJ5HZCKGZ",
+                "key": "SAVE_PREFERENCE",
+                "name": "Save Preference",
+                "payloadSchema": [
+                  {
+                    "name": "eventType",
+                    "type": "string"
+                  },
+                  {
+                    "name": "mode",
+                    "type": "string"
+                  },
+                  {
+                    "name": "channel",
+                    "type": "string"
+                  },
+                  {
+                    "name": "quietStartHour",
+                    "type": "number"
+                  },
+                  {
+                    "name": "quietEndHour",
+                    "type": "number"
+                  }
+                ]
+              },
+              {
+                "id": "evt_01M0M65FFF3VJFCFJW2MFTQ33R",
+                "key": "UPDATE_PREFERENCE",
+                "name": "Update Preference",
+                "payloadSchema": [
+                  {
+                    "name": "id",
+                    "type": "string"
+                  },
+                  {
+                    "name": "eventType",
+                    "type": "string"
+                  },
+                  {
+                    "name": "mode",
+                    "type": "string"
+                  },
+                  {
+                    "name": "channel",
+                    "type": "string"
+                  },
+                  {
+                    "name": "quietStartHour",
+                    "type": "number"
+                  },
+                  {
+                    "name": "quietEndHour",
+                    "type": "number"
+                  }
+                ]
+              },
+              {
+                "id": "evt_01M0M65FFFGSKNV146RNQW7CGC",
+                "key": "DELETE_PREFERENCE",
+                "name": "Delete Preference",
+                "payloadSchema": [
+                  {
+                    "name": "id",
+                    "type": "string"
+                  }
+                ]
+              },
+              {
+                "description": "Preference row persisted",
+                "id": "evt_01M0M65FFF7XGSZAATT13F5G5Z",
+                "key": "PREFERENCE_SAVED",
+                "name": "Preference Saved",
+                "payloadSchema": [
+                  {
+                    "name": "id",
+                    "required": true,
+                    "type": "string"
+                  }
+                ],
+                "tier": "secondary"
+              },
+              {
+                "description": "Preference row removed",
+                "id": "evt_01M0M65FFFS4TZ2J5V874NFENP",
+                "key": "PREFERENCE_DELETED",
+                "name": "Preference Deleted",
+                "payloadSchema": [
+                  {
+                    "name": "id",
+                    "required": true,
+                    "type": "string"
+                  }
+                ],
+                "tier": "secondary"
+              },
+              {
+                "description": "Preference persist failed",
+                "id": "evt_01M0M65FFFG5RH4AMKM6PRC7D9",
+                "key": "PREFERENCE_SAVE_FAILED",
+                "name": "Preference Save Failed",
+                "payloadSchema": [
+                  {
+                    "name": "error",
+                    "required": true,
+                    "type": "string"
+                  }
+                ],
+                "tier": "secondary"
+              }
+            ],
+            "states": [
+              {
+                "isInitial": true,
+                "name": "idle"
+              }
+            ],
+            "transitions": [
+              {
+                "effects": [
+                  [
+                    "persist",
+                    "create",
+                    "NotificationPreference",
+                    {
+                      "channel": "@payload.channel",
+                      "eventType": "@payload.eventType",
+                      "mode": "@payload.mode",
+                      "quietEndHour": "@payload.quietEndHour",
+                      "quietStartHour": "@payload.quietStartHour",
+                      "userId": "@user.id"
+                    },
+                    {
+                      "emit": {
+                        "failure": "PREFERENCE_SAVE_FAILED",
+                        "success": "PREFERENCE_SAVED"
+                      }
+                    }
+                  ]
+                ],
+                "event": "SAVE_PREFERENCE",
+                "eventId": "evt_01M0M65FFFD1RTHPARJ5HZCKGZ",
+                "from": "idle",
+                "to": "idle"
+              },
+              {
+                "effects": [
+                  [
+                    "persist",
+                    "update",
+                    "NotificationPreference",
+                    {
+                      "channel": "@payload.channel",
+                      "eventType": "@payload.eventType",
+                      "id": "@payload.id",
+                      "mode": "@payload.mode",
+                      "quietEndHour": "@payload.quietEndHour",
+                      "quietStartHour": "@payload.quietStartHour"
+                    },
+                    {
+                      "emit": {
+                        "failure": "PREFERENCE_SAVE_FAILED",
+                        "success": "PREFERENCE_SAVED"
+                      }
+                    }
+                  ]
+                ],
+                "event": "UPDATE_PREFERENCE",
+                "eventId": "evt_01M0M65FFF3VJFCFJW2MFTQ33R",
+                "from": "idle",
+                "to": "idle"
+              },
+              {
+                "effects": [
+                  [
+                    "persist",
+                    "delete",
+                    "NotificationPreference",
+                    "@payload.id",
+                    {
+                      "emit": {
+                        "failure": "PREFERENCE_SAVE_FAILED",
+                        "success": "PREFERENCE_DELETED"
+                      }
+                    }
+                  ]
+                ],
+                "event": "DELETE_PREFERENCE",
+                "eventId": "evt_01M0M65FFFGSKNV146RNQW7CGC",
+                "from": "idle",
+                "to": "idle"
+              },
+              {
+                "effects": [
+                  [
+                    "notify",
+                    "success",
+                    "Notification preference saved"
+                  ]
+                ],
+                "event": "PREFERENCE_SAVED",
+                "eventId": "evt_01M0M65FFF7XGSZAATT13F5G5Z",
+                "from": "idle",
+                "to": "idle"
+              },
+              {
+                "effects": [
+                  [
+                    "notify",
+                    "info",
+                    "Notification preference removed"
+                  ]
+                ],
+                "event": "PREFERENCE_DELETED",
+                "eventId": "evt_01M0M65FFFS4TZ2J5V874NFENP",
+                "from": "idle",
+                "to": "idle"
+              },
+              {
+                "effects": [
+                  [
+                    "notify",
+                    "warning",
+                    "Could not save the notification preference"
+                  ]
+                ],
+                "event": "PREFERENCE_SAVE_FAILED",
+                "eventId": "evt_01M0M65FFFG5RH4AMKM6PRC7D9",
+                "from": "idle",
+                "to": "idle"
+              }
+            ]
+          }
+        },
+        {
+          "category": "lifecycle",
+          "config": {
+            "digestEnabled": {
+              "default": false,
+              "description": "Drain suppressed notifications (digest-deferred and quiet-hours audit rows) on the hourly cycle. Off by default.",
+              "label": "Deliver digests",
+              "synonyms": "enable digest, digest mode, batch notifications, daily summary, drain suppressed",
+              "tier": "infra",
+              "type": "boolean"
+            },
+            "digestSubject": {
+              "default": "Notification digest",
+              "description": "Subject line for drained digest deliveries.",
+              "label": "Digest email subject",
+              "synonyms": "digest title, summary subject, email subject",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "minAgeHours": {
+              "default": 1.0,
+              "description": "Only drain audit rows at least this many hours old, so quiet-hours suppressions are not redelivered inside their window.",
+              "label": "Minimum age (hours)",
+              "synonyms": "delay, drain delay, hold for, batch window",
+              "tier": "infra",
+              "type": "number"
+            }
+          },
+          "emits": [
+            {
+              "description": "Undispatched digest/quiet-hours audit rows past minAgeHours, oldest batch first",
+              "event": "DIGEST_ROWS_LOADED",
+              "eventId": "evt_01M0M65FFFX5V7JGP2T5AXQS76",
+              "payloadSchema": [
+                {
+                  "name": "data",
+                  "type": "[NotifRow]"
+                }
+              ],
+              "tier": "secondary"
+            },
+            {
+              "description": "email.send result for the current digest row",
+              "event": "DIGEST_ITEM_SENT",
+              "eventId": "evt_01M0M65FFF1K04JNAZHABZTEHE",
+              "payloadSchema": [
+                {
+                  "name": "id",
+                  "required": true,
+                  "type": "string"
+                },
+                {
+                  "name": "status",
+                  "required": true,
+                  "type": "string"
+                }
+              ],
+              "tier": "secondary"
+            },
+            {
+              "description": "Current row marked dispatched; drives the next loop pass",
+              "event": "DIGEST_STEPPED",
+              "eventId": "evt_01M0M65FFF0QM818V9HGCCN1VA",
+              "payloadSchema": [
+                {
+                  "name": "id",
+                  "required": true,
+                  "type": "string"
+                }
+              ],
+              "tier": "secondary"
+            },
+            {
+              "description": "Digest scan / delivery / persist failed — the cycle stops until the next tick",
+              "event": "DIGEST_FAILED",
+              "eventId": "evt_01M0M65FFFTXQ7Y0YV9XY3X1A5",
+              "payloadSchema": [
+                {
+                  "name": "error",
+                  "required": true,
+                  "type": "string"
+                }
+              ],
+              "tier": "secondary"
+            }
+          ],
+          "entityRefIds": {
+            "DigestRunView": "ent_01M0M65FFFZGACVWJYWZ3AE6ZZ",
+            "NotificationRecord": "ent_01M0M65FFFQ3XBF85WBE2VSWMY"
+          },
+          "id": "trt_01M0M65FFF9APPJEKH9Y561YA4",
+          "linkedEntity": "DigestRunView",
+          "linkedEntityId": "ent_01M0M65FFFZGACVWJYWZ3AE6ZZ",
+          "name": "DigestDrain",
+          "scope": "instance",
+          "stateMachine": {
+            "events": [
+              {
+                "description": "Undispatched digest/quiet-hours audit rows past minAgeHours, oldest batch first",
+                "id": "evt_01M0M65FFFX5V7JGP2T5AXQS76",
+                "key": "DIGEST_ROWS_LOADED",
+                "name": "Digest Rows Loaded",
+                "payloadSchema": [
+                  {
+                    "name": "data",
+                    "properties": [
+                      {
+                        "name": "id",
+                        "type": "string"
+                      },
+                      {
+                        "name": "recipient",
+                        "type": "string"
+                      },
+                      {
+                        "name": "channel",
+                        "type": "string"
+                      },
+                      {
+                        "name": "message",
+                        "type": "string"
+                      },
+                      {
+                        "name": "severity",
+                        "type": "string"
+                      },
+                      {
+                        "name": "dispatched",
+                        "type": "boolean"
+                      },
+                      {
+                        "name": "error",
+                        "type": "string"
+                      },
+                      {
+                        "name": "recordedAt",
+                        "type": "number"
+                      }
+                    ],
+                    "type": "[object]"
+                  }
+                ],
+                "tier": "secondary"
+              },
+              {
+                "description": "Digest scan / delivery / persist failed — the cycle stops until the next tick",
+                "id": "evt_01M0M65FFFTXQ7Y0YV9XY3X1A5",
+                "key": "DIGEST_FAILED",
+                "name": "Digest Failed",
+                "payloadSchema": [
+                  {
+                    "name": "error",
+                    "required": true,
+                    "type": "string"
+                  }
+                ],
+                "tier": "secondary"
+              },
+              {
+                "description": "email.send result for the current digest row",
+                "id": "evt_01M0M65FFF1K04JNAZHABZTEHE",
+                "key": "DIGEST_ITEM_SENT",
+                "name": "Digest Item Sent",
+                "payloadSchema": [
+                  {
+                    "name": "id",
+                    "required": true,
+                    "type": "string"
+                  },
+                  {
+                    "name": "status",
+                    "required": true,
+                    "type": "string"
+                  }
+                ],
+                "tier": "secondary"
+              },
+              {
+                "description": "Current row marked dispatched; drives the next loop pass",
+                "id": "evt_01M0M65FFF0QM818V9HGCCN1VA",
+                "key": "DIGEST_STEPPED",
+                "name": "Digest Stepped",
+                "payloadSchema": [
+                  {
+                    "name": "id",
+                    "required": true,
+                    "type": "string"
+                  }
+                ],
+                "tier": "secondary"
+              }
+            ],
+            "states": [
+              {
+                "isInitial": true,
+                "name": "idle"
+              },
+              {
+                "name": "draining"
+              }
+            ],
+            "transitions": [
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.headId",
+                    [
+                      "object/get",
+                      [
+                        "array/first",
+                        "@payload.data"
+                      ],
+                      "id"
+                    ]
+                  ],
+                  [
+                    "set",
+                    "@entity.headRecipient",
+                    [
+                      "object/get",
+                      [
+                        "array/first",
+                        "@payload.data"
+                      ],
+                      "recipient"
+                    ]
+                  ],
+                  [
+                    "set",
+                    "@entity.headMessage",
+                    [
+                      "object/get",
+                      [
+                        "array/first",
+                        "@payload.data"
+                      ],
+                      "message"
+                    ]
+                  ],
+                  [
+                    "call-service",
+                    "email",
+                    "send",
+                    {
+                      "body": "@entity.headMessage",
+                      "from": "",
+                      "subject": "@config.digestSubject",
+                      "to": "@entity.headRecipient"
+                    },
+                    {
+                      "emit": {
+                        "failure": "DIGEST_FAILED",
+                        "success": "DIGEST_ITEM_SENT"
+                      }
+                    }
+                  ]
+                ],
+                "event": "DIGEST_ROWS_LOADED",
+                "eventId": "evt_01M0M65FFFX5V7JGP2T5AXQS76",
+                "from": "idle",
+                "guard": [
+                  "and",
+                  "@config.digestEnabled",
+                  [
+                    ">",
+                    [
+                      "array/len",
+                      "@payload.data"
+                    ],
+                    0.0
+                  ]
+                ],
+                "to": "draining"
+              },
+              {
+                "event": "DIGEST_ROWS_LOADED",
+                "eventId": "evt_01M0M65FFFX5V7JGP2T5AXQS76",
+                "from": "idle",
+                "guard": [
+                  "=",
+                  [
+                    "array/len",
+                    "@payload.data"
+                  ],
+                  0.0
+                ],
+                "to": "idle"
+              },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.lastError",
+                    "@payload.error"
+                  ]
+                ],
+                "event": "DIGEST_FAILED",
+                "eventId": "evt_01M0M65FFFTXQ7Y0YV9XY3X1A5",
+                "from": "idle",
+                "to": "idle"
+              },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.drainedCount",
+                    [
+                      "+",
+                      "@entity.drainedCount",
+                      1.0
+                    ]
+                  ],
+                  [
+                    "persist",
+                    "update",
+                    "NotificationRecord",
+                    {
+                      "dispatched": true,
+                      "id": "@entity.headId"
+                    },
+                    {
+                      "emit": {
+                        "failure": "DIGEST_FAILED",
+                        "success": "DIGEST_STEPPED"
+                      }
+                    }
+                  ]
+                ],
+                "event": "DIGEST_ITEM_SENT",
+                "eventId": "evt_01M0M65FFF1K04JNAZHABZTEHE",
+                "from": "draining",
+                "to": "draining"
+              },
+              {
+                "effects": [
+                  [
+                    "fetch",
+                    "NotificationRecord",
+                    {
+                      "emit": {
+                        "failure": "DIGEST_FAILED",
+                        "success": "DIGEST_ROWS_LOADED"
+                      },
+                      "filter": [
+                        "and",
+                        [
+                          "=",
+                          [
+                            "object/get",
+                            "@entity",
+                            "dispatched"
+                          ],
+                          false
+                        ],
+                        [
+                          "or",
+                          [
+                            "=",
+                            [
+                              "object/get",
+                              "@entity",
+                              "error"
+                            ],
+                            "digest-deferred"
+                          ],
+                          [
+                            "=",
+                            [
+                              "object/get",
+                              "@entity",
+                              "error"
+                            ],
+                            "quiet-hours"
+                          ]
+                        ],
+                        [
+                          "<",
+                          [
+                            "object/get",
+                            "@entity",
+                            "recordedAt"
+                          ],
+                          [
+                            "-",
+                            "@now",
+                            [
+                              "*",
+                              "@config.minAgeHours",
+                              3600000.0
+                            ]
+                          ]
+                        ]
+                      ]
+                    }
+                  ]
+                ],
+                "event": "DIGEST_STEPPED",
+                "eventId": "evt_01M0M65FFF0QM818V9HGCCN1VA",
+                "from": "draining",
+                "to": "draining"
+              },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.headId",
+                    [
+                      "object/get",
+                      [
+                        "array/first",
+                        "@payload.data"
+                      ],
+                      "id"
+                    ]
+                  ],
+                  [
+                    "set",
+                    "@entity.headRecipient",
+                    [
+                      "object/get",
+                      [
+                        "array/first",
+                        "@payload.data"
+                      ],
+                      "recipient"
+                    ]
+                  ],
+                  [
+                    "set",
+                    "@entity.headMessage",
+                    [
+                      "object/get",
+                      [
+                        "array/first",
+                        "@payload.data"
+                      ],
+                      "message"
+                    ]
+                  ],
+                  [
+                    "call-service",
+                    "email",
+                    "send",
+                    {
+                      "body": "@entity.headMessage",
+                      "from": "",
+                      "subject": "@config.digestSubject",
+                      "to": "@entity.headRecipient"
+                    },
+                    {
+                      "emit": {
+                        "failure": "DIGEST_FAILED",
+                        "success": "DIGEST_ITEM_SENT"
+                      }
+                    }
+                  ]
+                ],
+                "event": "DIGEST_ROWS_LOADED",
+                "eventId": "evt_01M0M65FFFX5V7JGP2T5AXQS76",
+                "from": "draining",
+                "guard": [
+                  ">",
+                  [
+                    "array/len",
+                    "@payload.data"
+                  ],
+                  0.0
+                ],
+                "to": "draining"
+              },
+              {
+                "event": "DIGEST_ROWS_LOADED",
+                "eventId": "evt_01M0M65FFFX5V7JGP2T5AXQS76",
+                "from": "draining",
+                "guard": [
+                  "=",
+                  [
+                    "array/len",
+                    "@payload.data"
+                  ],
+                  0.0
+                ],
+                "to": "idle"
+              },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.lastError",
+                    "@payload.error"
+                  ]
+                ],
+                "event": "DIGEST_FAILED",
+                "eventId": "evt_01M0M65FFFTXQ7Y0YV9XY3X1A5",
+                "from": "draining",
+                "to": "idle"
+              }
+            ]
+          },
+          "ticks": [
+            {
+              "effects": [
+                [
+                  "fetch",
+                  "NotificationRecord",
+                  {
+                    "emit": {
+                      "failure": "DIGEST_FAILED",
+                      "success": "DIGEST_ROWS_LOADED"
+                    },
+                    "filter": [
+                      "and",
+                      [
+                        "=",
+                        [
+                          "object/get",
+                          "@entity",
+                          "dispatched"
+                        ],
+                        false
+                      ],
+                      [
+                        "or",
+                        [
+                          "=",
+                          [
+                            "object/get",
+                            "@entity",
+                            "error"
+                          ],
+                          "digest-deferred"
+                        ],
+                        [
+                          "=",
+                          [
+                            "object/get",
+                            "@entity",
+                            "error"
+                          ],
+                          "quiet-hours"
+                        ]
+                      ],
+                      [
+                        "<",
+                        [
+                          "object/get",
+                          "@entity",
+                          "recordedAt"
+                        ],
+                        [
+                          "-",
+                          "@now",
+                          [
+                            "*",
+                            "@config.minAgeHours",
+                            3600000.0
+                          ]
+                        ]
+                      ]
+                    ]
+                  }
+                ]
+              ],
+              "interval": "0 * * * *",
+              "name": "digestCycle"
+            }
+          ]
+        }
+      ]
+    }
+  ],
+  "schemaVersion": 1,
+  "version": "1.0.0"
+}