@happyvertical/smrt-messages 0.55.9 → 0.55.11

package/dist/manifest.json

@@ -2,7 +2,7 @@
   "version": "1.0.0",
   "timestamp": 0,
   "packageName": "@happyvertical/smrt-messages",
-  "packageVersion": "0.55.9",
+  "packageVersion": "0.55.11",
   "objects": {
     "@happyvertical/smrt-messages:AccountCollection": {
       "name": "accountcollection",
@@ -11245,6 +11245,204 @@
     }
   },
   "moduleType": "smrt",
+  "recipes": [
+    {
+      "id": "messages.mailbox",
+      "className": "MailboxRecipe",
+      "label": "Mailbox",
+      "summary": "Read and compose email from your connected accounts.",
+      "synonyms": [
+        "email",
+        "inbox",
+        "mail"
+      ],
+      "models": [
+        "@happyvertical/smrt-messages:Email",
+        "@happyvertical/smrt-messages:EmailAccount"
+      ],
+      "nav": [
+        {
+          "label": "Mailbox",
+          "model": "@happyvertical/smrt-messages:Email",
+          "icon": "folder",
+          "description": "Read email from your connected accounts.",
+          "key": "mailbox",
+          "noun": "email"
+        },
+        {
+          "label": "Failed sends",
+          "model": "@happyvertical/smrt-messages:Email",
+          "icon": "fileText",
+          "description": "Review email whose last send attempt failed.",
+          "key": "failed-sends",
+          "noun": "email",
+          "filter": {
+            "field": "sendStatus",
+            "value": "failed"
+          }
+        }
+      ],
+      "requires": [],
+      "group": {
+        "id": "messages",
+        "label": "Messaging",
+        "summary": "Choose email and personal updates independently."
+      },
+      "section": {
+        "id": "messages",
+        "label": "Messaging",
+        "icon": "folder",
+        "description": "Read email and keep up with updates addressed to you."
+      },
+      "help": {
+        "markdown": "## Your mailbox\nRead messages, open a conversation, or compose an email using a connected account.\nChoose the sender account, add recipients, and check the subject and message before sending.\n\n## Failed sends\nUse Failed sends to review email whose last send attempt failed. Returning to the mailbox shows all email again.\nCheck the failure and sender connection before retrying through your application. This view does not resend email automatically.\n\n## Preview\nThe playground uses fictional messages. Sending and saving are mocked and never contact a mail server.\n\n## Connect an account\nYour application administrator connects an authorized email provider on the server. Real sending and mailbox synchronization require that connection; a preview does not verify delivery.\n",
+        "fieldRefs": []
+      },
+      "surfaces": [
+        {
+          "kind": "route",
+          "path": "/messages/mailbox",
+          "export": "@happyvertical/smrt-messages/svelte#MessageList",
+          "label": "Mailbox"
+        },
+        {
+          "kind": "playground",
+          "export": "@happyvertical/smrt-messages/svelte#MailboxDemo",
+          "label": "Mailbox with mocked sending"
+        }
+      ],
+      "providers": [
+        {
+          "id": "email-inbox",
+          "kind": "email",
+          "options": [
+            "imap",
+            "pop3",
+            "gmail"
+          ],
+          "required": true
+        },
+        {
+          "id": "email-send",
+          "kind": "email",
+          "options": [
+            "smtp",
+            "gmail"
+          ],
+          "required": false
+        }
+      ],
+      "runtime": "both",
+      "demoSeed": {
+        "data": {
+          "accounts": [
+            {
+              "id": "demo-account",
+              "name": "Demo Inbox",
+              "providerType": "email",
+              "email": "you@example.com",
+              "isActive": true
+            }
+          ],
+          "messages": [
+            {
+              "id": "demo-welcome",
+              "type": "email",
+              "accountId": "demo-account",
+              "subject": "Welcome to your mailbox",
+              "body": "Fictional mail. Sending is mocked; nothing leaves this browser.",
+              "senderName": "Demo colleague",
+              "senderAddress": "colleague@example.com",
+              "recipientAddresses": [
+                {
+                  "address": "you@example.com"
+                }
+              ],
+              "date": "2026-01-01T12:00:00Z",
+              "isRead": false,
+              "isFlagged": false,
+              "hasAttachments": false
+            }
+          ]
+        }
+      },
+      "demo": {
+        "mode": "server",
+        "reasons": [
+          "Needs a server because its package depends on @happyvertical/smrt-profiles, @happyvertical/smrt-secrets, @happyvertical/smrt-tenancy, @happyvertical/smrt-users, which do not build for a browser (#3617, #3624, #3626, #3627)."
+        ]
+      }
+    },
+    {
+      "id": "messages.notifications",
+      "className": "NotificationsRecipe",
+      "label": "Notifications",
+      "summary": "See updates addressed to you and mark them read.",
+      "synonyms": [
+        "alerts",
+        "notification bell"
+      ],
+      "models": [
+        "@happyvertical/smrt-messages:UserNotification"
+      ],
+      "nav": [],
+      "requires": [],
+      "group": {
+        "id": "messages",
+        "label": "Messaging",
+        "summary": "Choose email and personal updates independently."
+      },
+      "section": {
+        "id": "messages",
+        "label": "Messaging",
+        "icon": "folder",
+        "description": "Read email and keep up with updates addressed to you."
+      },
+      "help": {
+        "markdown": "## Notifications\nOpen the notification bell to see updates addressed to you. Unread updates have a visible marker.\nChoose Mark read for one update or Mark all read for every unread update in your authorized accounts.\nFollow a notification link to open its related record when one is available.\n\n## Availability\nNotifications are scoped to the signed-in person. Your application connects the notification provider and may enable live updates. If loading fails, try again after the connection returns.\n",
+        "fieldRefs": []
+      },
+      "surfaces": [
+        {
+          "kind": "shell-widget",
+          "slot": "header.end",
+          "export": "@happyvertical/smrt-svelte/notifications#NotificationBell",
+          "label": "Notifications"
+        }
+      ],
+      "providers": [
+        {
+          "id": "notifications",
+          "kind": "notifications",
+          "options": [
+            "user-notification-service"
+          ],
+          "required": true
+        }
+      ],
+      "runtime": "both",
+      "demoSeed": {
+        "data": {
+          "items": [
+            {
+              "id": "demo-notification",
+              "title": "You were mentioned",
+              "body": "A fictional update for the demo user.",
+              "occurredAt": "2026-01-01T12:00:00Z",
+              "severity": "info",
+              "readAt": null
+            }
+          ]
+        }
+      },
+      "demo": {
+        "mode": "server",
+        "reasons": [
+          "Needs a server because its package depends on @happyvertical/smrt-profiles, @happyvertical/smrt-secrets, @happyvertical/smrt-tenancy, @happyvertical/smrt-users, which do not build for a browser (#3617, #3624, #3626, #3627)."
+        ]
+      }
+    }
+  ],
   "smrtDependencies": [
     "@happyvertical/smrt-core",
     "@happyvertical/smrt-ledgers",

package/dist/playground.js

@@ -76,6 +76,15 @@ var playground_default = {
 	description: MESSAGES_MODULE_META.description,
 	moduleMeta: MESSAGES_MODULE_META,
 	entries: [
+		{
+			id: "mailbox",
+			title: "Mailbox",
+			description: "Interactive fictional inbox. Compose and send are mocked; no mail is delivered.",
+			loadComponent: () => import("./svelte/components/MailboxDemo.svelte"),
+			order: 0,
+			props: {},
+			modes: { mock: { label: "Mock sending" } }
+		},
 		{
 			id: "account-list",
 			title: "Account List",

package/dist/playground.js.map

@@ -1 +1 @@
-{"version":3,"file":"playground.js","names":[],"sources":["../src/svelte/playground.ts"],"sourcesContent":["import { MESSAGES_MODULE_META } from '../ui.js';\n\nconst noop = () => {};\n\nconst sampleAccounts = [\n  {\n    id: 'account-editorial',\n    name: 'Editorial Inbox',\n    email: 'editorial@example.com',\n    providerType: 'email',\n    isActive: true,\n    unreadCount: 12,\n    totalCount: 438,\n    lastSyncAt: '2026-03-21T16:12:00.000Z',\n  },\n  {\n    id: 'account-social',\n    name: 'Community Slack',\n    providerType: 'slack',\n    isActive: true,\n    unreadCount: 3,\n    totalCount: 91,\n    lastSyncAt: '2026-03-21T16:05:00.000Z',\n  },\n];\n\nconst sampleAttachments = [\n  {\n    id: 'attachment-proof',\n    filename: 'proofing-notes.pdf',\n    contentType: 'application/pdf',\n    size: 248512,\n  },\n];\n\nconst sampleMessages = [\n  {\n    id: 'message-1',\n    type: 'email',\n    accountId: 'account-editorial',\n    subject: 'Governance review complete',\n    body: 'The editorial governance review is complete and the draft is ready for publication.',\n    senderName: 'Taylor Rowan',\n    senderAddress: 'taylor@example.com',\n    recipientAddresses: [\n      { address: 'editorial@example.com', name: 'Editorial Desk' },\n    ],\n    ccAddresses: [{ address: 'governance@example.com', name: 'Governance' }],\n    threadId: 'thread-1',\n    isRead: true,\n    isFlagged: false,\n    hasAttachments: true,\n    attachments: sampleAttachments,\n    date: '2026-03-21T15:30:00.000Z',\n    folderPath: 'Inbox',\n    labels: ['governance', 'release'],\n    sendStatus: 'sent',\n  },\n  {\n    id: 'message-2',\n    type: 'slack',\n    accountId: 'account-social',\n    subject: 'Release coordination',\n    body: 'Can we confirm the package rollout order for this afternoon?',\n    senderName: 'Jordan Lee',\n    senderAddress: 'jordan@example.com',\n    recipientAddresses: [{ address: '#release-coordination' }],\n    isRead: false,\n    isFlagged: true,\n    hasAttachments: false,\n    date: '2026-03-21T16:02:00.000Z',\n    folderPath: 'Slack / release-coordination',\n    meta: {\n      channelName: 'release-coordination',\n    },\n  },\n];\n\nconst loadAccountList = () => import('./components/AccountList.svelte');\nconst loadComposeForm = () => import('./components/ComposeForm.svelte');\nconst loadMessageDetail = () => import('./components/MessageDetail.svelte');\nconst loadMessageList = () => import('./components/MessageList.svelte');\n\nexport default {\n  packageName: '@happyvertical/smrt-messages',\n  displayName: MESSAGES_MODULE_META.displayName,\n  description: MESSAGES_MODULE_META.description,\n  moduleMeta: MESSAGES_MODULE_META,\n  entries: [\n    {\n      id: 'account-list',\n      title: 'Account List',\n      description:\n        'Connected messaging accounts with sync state and unread counts.',\n      loadComponent: loadAccountList,\n      order: 1,\n      props: {\n        accounts: sampleAccounts,\n        onaccountclick: noop,\n        onsync: noop,\n        onremove: noop,\n      },\n      modes: {\n        mock: {\n          label: 'Mock',\n        },\n      },\n    },\n    {\n      id: 'message-list',\n      title: 'Message List',\n      description:\n        'Inbox-style message listing with selection, account context, and type-aware cards.',\n      loadComponent: loadMessageList,\n      order: 2,\n      props: {\n        messages: sampleMessages,\n        activeMessageId: 'message-1',\n        accounts: sampleAccounts,\n        showAccount: true,\n        onmessageclick: noop,\n        onselect: noop,\n        onflag: noop,\n      },\n      modes: {\n        mock: {\n          label: 'Mock',\n        },\n      },\n    },\n    {\n      id: 'message-detail',\n      title: 'Message Detail',\n      description:\n        'Full message view for reading, attachments, and follow-up actions.',\n      loadComponent: loadMessageDetail,\n      order: 3,\n      props: {\n        message: sampleMessages[0],\n        attachments: sampleAttachments,\n        account: sampleAccounts[0],\n        onreply: noop,\n        onforward: noop,\n        ondelete: noop,\n      },\n      modes: {\n        mock: {\n          label: 'Mock',\n        },\n      },\n    },\n    {\n      id: 'compose-form',\n      title: 'Compose Form',\n      description:\n        'Channel-aware compose experience for email, Slack, and short-form posts.',\n      loadComponent: loadComposeForm,\n      order: 4,\n      props: {\n        type: 'email',\n        accounts: sampleAccounts,\n        initialState: {\n          accountId: 'account-editorial',\n          to: [\n            { address: 'ops@example.com', name: 'Operations', isValid: true },\n          ],\n          subject: 'Launch checklist follow-up',\n          body: 'Please confirm the remaining package rollout items for issue #1047.',\n        },\n        onsend: noop,\n        onsavedraft: noop,\n        ondiscard: noop,\n      },\n      modes: {\n        mock: {\n          label: 'Mock',\n        },\n      },\n    },\n  ],\n};\n"],"mappings":";;AAEA,IAAM,aAAa,CAAC;AAEpB,IAAM,iBAAiB,CACrB;CACE,IAAI;CACJ,MAAM;CACN,OAAO;CACP,cAAc;CACd,UAAU;CACV,aAAa;CACb,YAAY;CACZ,YAAY;AACd,GACA;CACE,IAAI;CACJ,MAAM;CACN,cAAc;CACd,UAAU;CACV,aAAa;CACb,YAAY;CACZ,YAAY;AACd,CACF;AAEA,IAAM,oBAAoB,CACxB;CACE,IAAI;CACJ,UAAU;CACV,aAAa;CACb,MAAM;AACR,CACF;AAEA,IAAM,iBAAiB,CACrB;CACE,IAAI;CACJ,MAAM;CACN,WAAW;CACX,SAAS;CACT,MAAM;CACN,YAAY;CACZ,eAAe;CACf,oBAAoB,CAClB;EAAE,SAAS;EAAyB,MAAM;CAAiB,CAC7D;CACA,aAAa,CAAC;EAAE,SAAS;EAA0B,MAAM;CAAa,CAAC;CACvE,UAAU;CACV,QAAQ;CACR,WAAW;CACX,gBAAgB;CAChB,aAAa;CACb,MAAM;CACN,YAAY;CACZ,QAAQ,CAAC,cAAc,SAAS;CAChC,YAAY;AACd,GACA;CACE,IAAI;CACJ,MAAM;CACN,WAAW;CACX,SAAS;CACT,MAAM;CACN,YAAY;CACZ,eAAe;CACf,oBAAoB,CAAC,EAAE,SAAS,wBAAwB,CAAC;CACzD,QAAQ;CACR,WAAW;CACX,gBAAgB;CAChB,MAAM;CACN,YAAY;CACZ,MAAM,EACJ,aAAa,uBACf;AACF,CACF;AAEA,IAAM,wBAAwB,OAAO;AACrC,IAAM,wBAAwB,OAAO;AACrC,IAAM,0BAA0B,OAAO;AACvC,IAAM,wBAAwB,OAAO;AAErC,IAAA,qBAAe;CACb,aAAa;CACb,aAAa,qBAAqB;CAClC,aAAa,qBAAqB;CAClC,YAAY;CACZ,SAAS;EACP;GACE,IAAI;GACJ,OAAO;GACP,aACE;GACF,eAAe;GACf,OAAO;GACP,OAAO;IACL,UAAU;IACV,gBAAgB;IAChB,QAAQ;IACR,UAAU;GACZ;GACA,OAAO,EACL,MAAM,EACJ,OAAO,OACT,EACF;EACF;EACA;GACE,IAAI;GACJ,OAAO;GACP,aACE;GACF,eAAe;GACf,OAAO;GACP,OAAO;IACL,UAAU;IACV,iBAAiB;IACjB,UAAU;IACV,aAAa;IACb,gBAAgB;IAChB,UAAU;IACV,QAAQ;GACV;GACA,OAAO,EACL,MAAM,EACJ,OAAO,OACT,EACF;EACF;EACA;GACE,IAAI;GACJ,OAAO;GACP,aACE;GACF,eAAe;GACf,OAAO;GACP,OAAO;IACL,SAAS,eAAe;IACxB,aAAa;IACb,SAAS,eAAe;IACxB,SAAS;IACT,WAAW;IACX,UAAU;GACZ;GACA,OAAO,EACL,MAAM,EACJ,OAAO,OACT,EACF;EACF;EACA;GACE,IAAI;GACJ,OAAO;GACP,aACE;GACF,eAAe;GACf,OAAO;GACP,OAAO;IACL,MAAM;IACN,UAAU;IACV,cAAc;KACZ,WAAW;KACX,IAAI,CACF;MAAE,SAAS;MAAmB,MAAM;MAAc,SAAS;KAAK,CAClE;KACA,SAAS;KACT,MAAM;IACR;IACA,QAAQ;IACR,aAAa;IACb,WAAW;GACb;GACA,OAAO,EACL,MAAM,EACJ,OAAO,OACT,EACF;EACF;CACF;AACF"}
+{"version":3,"file":"playground.js","names":[],"sources":["../src/svelte/playground.ts"],"sourcesContent":["import { MESSAGES_MODULE_META } from '../ui.js';\n\nconst noop = () => {};\n\nconst sampleAccounts = [\n  {\n    id: 'account-editorial',\n    name: 'Editorial Inbox',\n    email: 'editorial@example.com',\n    providerType: 'email',\n    isActive: true,\n    unreadCount: 12,\n    totalCount: 438,\n    lastSyncAt: '2026-03-21T16:12:00.000Z',\n  },\n  {\n    id: 'account-social',\n    name: 'Community Slack',\n    providerType: 'slack',\n    isActive: true,\n    unreadCount: 3,\n    totalCount: 91,\n    lastSyncAt: '2026-03-21T16:05:00.000Z',\n  },\n];\n\nconst sampleAttachments = [\n  {\n    id: 'attachment-proof',\n    filename: 'proofing-notes.pdf',\n    contentType: 'application/pdf',\n    size: 248512,\n  },\n];\n\nconst sampleMessages = [\n  {\n    id: 'message-1',\n    type: 'email',\n    accountId: 'account-editorial',\n    subject: 'Governance review complete',\n    body: 'The editorial governance review is complete and the draft is ready for publication.',\n    senderName: 'Taylor Rowan',\n    senderAddress: 'taylor@example.com',\n    recipientAddresses: [\n      { address: 'editorial@example.com', name: 'Editorial Desk' },\n    ],\n    ccAddresses: [{ address: 'governance@example.com', name: 'Governance' }],\n    threadId: 'thread-1',\n    isRead: true,\n    isFlagged: false,\n    hasAttachments: true,\n    attachments: sampleAttachments,\n    date: '2026-03-21T15:30:00.000Z',\n    folderPath: 'Inbox',\n    labels: ['governance', 'release'],\n    sendStatus: 'sent',\n  },\n  {\n    id: 'message-2',\n    type: 'slack',\n    accountId: 'account-social',\n    subject: 'Release coordination',\n    body: 'Can we confirm the package rollout order for this afternoon?',\n    senderName: 'Jordan Lee',\n    senderAddress: 'jordan@example.com',\n    recipientAddresses: [{ address: '#release-coordination' }],\n    isRead: false,\n    isFlagged: true,\n    hasAttachments: false,\n    date: '2026-03-21T16:02:00.000Z',\n    folderPath: 'Slack / release-coordination',\n    meta: {\n      channelName: 'release-coordination',\n    },\n  },\n];\n\nconst loadAccountList = () => import('./components/AccountList.svelte');\nconst loadComposeForm = () => import('./components/ComposeForm.svelte');\nconst loadMessageDetail = () => import('./components/MessageDetail.svelte');\nconst loadMessageList = () => import('./components/MessageList.svelte');\n\nexport default {\n  packageName: '@happyvertical/smrt-messages',\n  displayName: MESSAGES_MODULE_META.displayName,\n  description: MESSAGES_MODULE_META.description,\n  moduleMeta: MESSAGES_MODULE_META,\n  entries: [\n    {\n      id: 'mailbox',\n      title: 'Mailbox',\n      description:\n        'Interactive fictional inbox. Compose and send are mocked; no mail is delivered.',\n      loadComponent: () => import('./components/MailboxDemo.svelte'),\n      order: 0,\n      props: {},\n      modes: { mock: { label: 'Mock sending' } },\n    },\n    {\n      id: 'account-list',\n      title: 'Account List',\n      description:\n        'Connected messaging accounts with sync state and unread counts.',\n      loadComponent: loadAccountList,\n      order: 1,\n      props: {\n        accounts: sampleAccounts,\n        onaccountclick: noop,\n        onsync: noop,\n        onremove: noop,\n      },\n      modes: {\n        mock: {\n          label: 'Mock',\n        },\n      },\n    },\n    {\n      id: 'message-list',\n      title: 'Message List',\n      description:\n        'Inbox-style message listing with selection, account context, and type-aware cards.',\n      loadComponent: loadMessageList,\n      order: 2,\n      props: {\n        messages: sampleMessages,\n        activeMessageId: 'message-1',\n        accounts: sampleAccounts,\n        showAccount: true,\n        onmessageclick: noop,\n        onselect: noop,\n        onflag: noop,\n      },\n      modes: {\n        mock: {\n          label: 'Mock',\n        },\n      },\n    },\n    {\n      id: 'message-detail',\n      title: 'Message Detail',\n      description:\n        'Full message view for reading, attachments, and follow-up actions.',\n      loadComponent: loadMessageDetail,\n      order: 3,\n      props: {\n        message: sampleMessages[0],\n        attachments: sampleAttachments,\n        account: sampleAccounts[0],\n        onreply: noop,\n        onforward: noop,\n        ondelete: noop,\n      },\n      modes: {\n        mock: {\n          label: 'Mock',\n        },\n      },\n    },\n    {\n      id: 'compose-form',\n      title: 'Compose Form',\n      description:\n        'Channel-aware compose experience for email, Slack, and short-form posts.',\n      loadComponent: loadComposeForm,\n      order: 4,\n      props: {\n        type: 'email',\n        accounts: sampleAccounts,\n        initialState: {\n          accountId: 'account-editorial',\n          to: [\n            { address: 'ops@example.com', name: 'Operations', isValid: true },\n          ],\n          subject: 'Launch checklist follow-up',\n          body: 'Please confirm the remaining package rollout items for issue #1047.',\n        },\n        onsend: noop,\n        onsavedraft: noop,\n        ondiscard: noop,\n      },\n      modes: {\n        mock: {\n          label: 'Mock',\n        },\n      },\n    },\n  ],\n};\n"],"mappings":";;AAEA,IAAM,aAAa,CAAC;AAEpB,IAAM,iBAAiB,CACrB;CACE,IAAI;CACJ,MAAM;CACN,OAAO;CACP,cAAc;CACd,UAAU;CACV,aAAa;CACb,YAAY;CACZ,YAAY;AACd,GACA;CACE,IAAI;CACJ,MAAM;CACN,cAAc;CACd,UAAU;CACV,aAAa;CACb,YAAY;CACZ,YAAY;AACd,CACF;AAEA,IAAM,oBAAoB,CACxB;CACE,IAAI;CACJ,UAAU;CACV,aAAa;CACb,MAAM;AACR,CACF;AAEA,IAAM,iBAAiB,CACrB;CACE,IAAI;CACJ,MAAM;CACN,WAAW;CACX,SAAS;CACT,MAAM;CACN,YAAY;CACZ,eAAe;CACf,oBAAoB,CAClB;EAAE,SAAS;EAAyB,MAAM;CAAiB,CAC7D;CACA,aAAa,CAAC;EAAE,SAAS;EAA0B,MAAM;CAAa,CAAC;CACvE,UAAU;CACV,QAAQ;CACR,WAAW;CACX,gBAAgB;CAChB,aAAa;CACb,MAAM;CACN,YAAY;CACZ,QAAQ,CAAC,cAAc,SAAS;CAChC,YAAY;AACd,GACA;CACE,IAAI;CACJ,MAAM;CACN,WAAW;CACX,SAAS;CACT,MAAM;CACN,YAAY;CACZ,eAAe;CACf,oBAAoB,CAAC,EAAE,SAAS,wBAAwB,CAAC;CACzD,QAAQ;CACR,WAAW;CACX,gBAAgB;CAChB,MAAM;CACN,YAAY;CACZ,MAAM,EACJ,aAAa,uBACf;AACF,CACF;AAEA,IAAM,wBAAwB,OAAO;AACrC,IAAM,wBAAwB,OAAO;AACrC,IAAM,0BAA0B,OAAO;AACvC,IAAM,wBAAwB,OAAO;AAErC,IAAA,qBAAe;CACb,aAAa;CACb,aAAa,qBAAqB;CAClC,aAAa,qBAAqB;CAClC,YAAY;CACZ,SAAS;EACP;GACE,IAAI;GACJ,OAAO;GACP,aACE;GACF,qBAAqB,OAAO;GAC5B,OAAO;GACP,OAAO,CAAC;GACR,OAAO,EAAE,MAAM,EAAE,OAAO,eAAe,EAAE;EAC3C;EACA;GACE,IAAI;GACJ,OAAO;GACP,aACE;GACF,eAAe;GACf,OAAO;GACP,OAAO;IACL,UAAU;IACV,gBAAgB;IAChB,QAAQ;IACR,UAAU;GACZ;GACA,OAAO,EACL,MAAM,EACJ,OAAO,OACT,EACF;EACF;EACA;GACE,IAAI;GACJ,OAAO;GACP,aACE;GACF,eAAe;GACf,OAAO;GACP,OAAO;IACL,UAAU;IACV,iBAAiB;IACjB,UAAU;IACV,aAAa;IACb,gBAAgB;IAChB,UAAU;IACV,QAAQ;GACV;GACA,OAAO,EACL,MAAM,EACJ,OAAO,OACT,EACF;EACF;EACA;GACE,IAAI;GACJ,OAAO;GACP,aACE;GACF,eAAe;GACf,OAAO;GACP,OAAO;IACL,SAAS,eAAe;IACxB,aAAa;IACb,SAAS,eAAe;IACxB,SAAS;IACT,WAAW;IACX,UAAU;GACZ;GACA,OAAO,EACL,MAAM,EACJ,OAAO,OACT,EACF;EACF;EACA;GACE,IAAI;GACJ,OAAO;GACP,aACE;GACF,eAAe;GACf,OAAO;GACP,OAAO;IACL,MAAM;IACN,UAAU;IACV,cAAc;KACZ,WAAW;KACX,IAAI,CACF;MAAE,SAAS;MAAmB,MAAM;MAAc,SAAS;KAAK,CAClE;KACA,SAAS;KACT,MAAM;IACR;IACA,QAAQ;IACR,aAAa;IACb,WAAW;GACb;GACA,OAAO,EACL,MAAM,EACJ,OAAO,OACT,EACF;EACF;CACF;AACF"}

package/dist/recipes.d.ts

@@ -0,0 +1,135 @@
+import { SmrtRecipe } from '@happyvertical/smrt-core';
+import { Email } from './models/Email.js';
+import { EmailAccount } from './models/EmailAccount.js';
+import { UserNotification } from './models/UserNotification.js';
+/** Email reading and composing with application-owned transport. */
+export declare class MailboxRecipe extends SmrtRecipe {
+    static id: string;
+    static label: string;
+    static summary: string;
+    static synonyms: string[];
+    static group: {
+        id: string;
+        label: string;
+        summary: string;
+    };
+    static section: {
+        id: string;
+        label: string;
+        icon: string;
+        description: string;
+    };
+    static models: (typeof Email | typeof EmailAccount)[];
+    static runtime: "both";
+    static surfaces: readonly [{
+        readonly kind: "route";
+        readonly path: "/messages/mailbox";
+        readonly export: "@happyvertical/smrt-messages/svelte#MessageList";
+        readonly label: "Mailbox";
+    }, {
+        readonly kind: "playground";
+        readonly export: "@happyvertical/smrt-messages/svelte#MailboxDemo";
+        readonly label: "Mailbox with mocked sending";
+    }];
+    static providers: {
+        id: string;
+        kind: string;
+        options: string[];
+        required: boolean;
+    }[];
+    static demoSeed: {
+        data: {
+            accounts: {
+                id: string;
+                name: string;
+                providerType: string;
+                email: string;
+                isActive: boolean;
+            }[];
+            messages: {
+                id: string;
+                type: string;
+                accountId: string;
+                subject: string;
+                body: string;
+                senderName: string;
+                senderAddress: string;
+                recipientAddresses: {
+                    address: string;
+                }[];
+                date: string;
+                isRead: boolean;
+                isFlagged: boolean;
+                hasAttachments: boolean;
+            }[];
+        };
+    };
+    static nav: ({
+        label: string;
+        model: typeof Email;
+        key: string;
+        icon: string;
+        noun: string;
+        description: string;
+        filter?: undefined;
+    } | {
+        label: string;
+        model: typeof Email;
+        key: string;
+        icon: string;
+        noun: string;
+        description: string;
+        filter: {
+            field: string;
+            value: string;
+        };
+    })[];
+    static help: string;
+}
+/** Recipient-scoped in-app notification bell. */
+export declare class NotificationsRecipe extends SmrtRecipe {
+    static id: string;
+    static label: string;
+    static summary: string;
+    static synonyms: string[];
+    static group: {
+        id: string;
+        label: string;
+        summary: string;
+    };
+    static section: {
+        id: string;
+        label: string;
+        icon: string;
+        description: string;
+    };
+    static models: (typeof UserNotification)[];
+    static runtime: "both";
+    static surfaces: readonly [{
+        readonly kind: "shell-widget";
+        readonly slot: "header.end";
+        readonly export: "@happyvertical/smrt-svelte/notifications#NotificationBell";
+        readonly label: "Notifications";
+    }];
+    static providers: {
+        id: string;
+        kind: string;
+        options: string[];
+        required: boolean;
+    }[];
+    static demoSeed: {
+        data: {
+            items: {
+                id: string;
+                title: string;
+                body: string;
+                occurredAt: string;
+                severity: string;
+                readAt: null;
+            }[];
+        };
+    };
+    static nav: never[];
+    static help: string;
+}
+//# sourceMappingURL=recipes.d.ts.map

package/dist/recipes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipes.d.ts","sourceRoot":"","sources":["../src/recipes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAEhE,oEAAoE;AACpE,qBAAa,aAAc,SAAQ,UAAU;IAC3C,MAAM,CAAC,EAAE,SAAsB;IAC/B,MAAM,CAAC,KAAK,SAAa;IACzB,MAAM,CAAC,OAAO,SAA0D;IACxE,MAAM,CAAC,QAAQ,WAA8B;IAC7C,MAAM,CAAC,KAAK;;;;MAIV;IACF,MAAM,CAAC,OAAO;;;;;MAKZ;IACF,MAAM,CAAC,MAAM,yCAAyB;IACtC,MAAM,CAAC,OAAO,EAAG,MAAM,CAAU;IACjC,MAAM,CAAC,QAAQ;;;;;;;;;OAYJ;IACX,MAAM,CAAC,SAAS;;;;;QAad;IACF,MAAM,CAAC,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;MA4Bb;IACF,MAAM,CAAC,GAAG;;;;;;;;;;;;;;;;;;;SAkBR;IACF,MAAM,CAAC,IAAI,SAAuB;CACnC;AAED,iDAAiD;AACjD,qBAAa,mBAAoB,SAAQ,UAAU;IACjD,MAAM,CAAC,EAAE,SAA4B;IACrC,MAAM,CAAC,KAAK,SAAmB;IAC/B,MAAM,CAAC,OAAO,SAAsD;IACpE,MAAM,CAAC,QAAQ,WAAmC;IAClD,MAAM,CAAC,KAAK;;;;MAIV;IACF,MAAM,CAAC,OAAO;;;;;MAKZ;IACF,MAAM,CAAC,MAAM,8BAAsB;IACnC,MAAM,CAAC,OAAO,EAAG,MAAM,CAAU;IACjC,MAAM,CAAC,QAAQ;;;;;OAOJ;IACX,MAAM,CAAC,SAAS;;;;;QAOd;IACF,MAAM,CAAC,QAAQ;;;;;;;;;;;MAab;IAEF,MAAM,CAAC,GAAG,UAAM;IAChB,MAAM,CAAC,IAAI,SAA6B;CACzC"}

package/dist/smrt-knowledge.json

@@ -3,12 +3,12 @@
   "sensitiveFieldsExcluded": true,
   "generatedAt": "1970-01-01T00:00:00.000Z",
   "packageName": "@happyvertical/smrt-messages",
-  "packageVersion": "0.55.9",
+  "packageVersion": "0.55.11",
   "sourceManifestPath": "dist/manifest.json",
   "agentDocPath": "AGENTS.md",
   "sourceHashes": {
-    "manifest": "680a388dbd99d90cd1c624e1c369702b73ecef7bec0a64894c59475c889acf1e",
-    "packageJson": "e6460c33ef22f7664d5666220b0eb04af74db27989a482a33e2b6e8d7ccb7937",
+    "manifest": "eadf03866882986943a242212d58981754af80a451cf17f4fc2910eafa5d65bc",
+    "packageJson": "5fe49b181fba9ee82dbb01ad3f18000c1c8bb5e9c531703de47ac21db64c9bfb",
     "agents": "f2bbd8f6d74a68c2ab949153f2051c7a906bd2e4ba547873b3641d0779491c59"
   },
   "exports": [
@@ -15160,6 +15160,204 @@
     "uuidColumns": 96
   },
   "agentDoc": "# @happyvertical/smrt-messages\n\nMulti-channel messaging with STI hierarchies for both messages and accounts. Credential encryption via smrt-secrets.\n\n## STI Hierarchies\n\n**Messages** (share `messages` table):\n- `Message` (base): accountId, personaId, endpointId, correlationId, threadId, subject, body, fromAddress, toAddresses (JSON), sendStatus (draft/sending/sent/failed), retryCount\n- `Email`: messageId (RFC 822), inReplyTo, ccAddresses, bccAddresses, htmlBody, textBody, folderId, labels, headers\n- `Tweet`: tweetId, retweetCount, likeCount, mediaUrls, hashtags, mentions\n- `SlackMessage`: channelId, slackTs, slackThreadTs, reactions, blocks\n\n**Accounts** (share `accounts` table):\n- `Account` (base): channelType, providerType, public configuration,\n  credentialSecretId, isActive, lastSyncAt, deprecated sensitive settings\n- `EmailAccount`, `TwitterAccount`, `SlackAccount`, `ZulipAccount`,\n  `TelegramAccount`: provider-specific identity/sender behavior\n\n## Persona messaging\n\n- `MessagingEndpoint`: tenant-owned, write-only destination JSON with masked\n  display helper.\n- `PersonaMessageRoute`: persona → account + endpoint, selected by purpose and\n  descending priority.\n- `PersonaMessagingService`: persists and sends through an enabled route.\n- Provider registry: public setup descriptors + optional sender factory. Keep\n  channel (`sms`) separate from provider (`twilio`).\n- Permissions: `messages.send`, `messages.manage-routes`,\n  `messages.manage-credentials`.\n- `MessagingSettingsService` is the permissioned server boundary;\n  its host-supplied `resolvePersonaTenantId` proves cross-package ownership.\n  `MessagingSettingsPanel` is the callback-driven Svelte surface.\n- Account, endpoint, and route generated surfaces are read-only. Do not add\n  generated mutations around the settings service or make secret fields writable.\n\n## In-app notifications (`UserNotification`)\n\nThe in-app channel: one stored row per person, with read state.\n`user_notifications`: `tenantId` (required), `recipientUserId`\n(`@crossPackageRef` smrt-users:User, uuid), `kind`, `title`, `body`, `href`,\n`severity` (info/success/warning/error), `sourceRef`, `occurredAt`, `readAt`,\n`dismissedAt`. Conflict identity `(tenant_id, recipient_user_id, source_ref)`.\n\n- `UserNotificationService` is the only access path: `notify()` /\n  `notifyMany()` (dedupe on `sourceRef`, existing row returned untouched;\n  a unique ref is generated when omitted), `listForUser()` / `countUnread()`\n  across explicit `tenantIds` (each read under `withTenant`), `markRead()`,\n  `dismiss()` (also marks read), `markAllRead()`. Every write filters on the\n  recipient, so another user's id matches nothing.\n- Generated REST/MCP/CLI are off (`api`/`mcp`/`cli: false`): a tenant-scoped\n  list would expose every member's rows. Hosts expose their own routes that\n  pass the signed-in user's id, never a request-chosen one.\n- Hosts decide who is told (e.g. `SocialPost.createdByUserId` for a failed\n  post). New table: consumers run `db:migrate`.\n\n## Credential Security\n\nAccount credentials stored via tenant-bound `credentialSecretId` →\nsmrt-secrets. Use `setCredentials()`/`getCredentials()` — never store passwords\ndirectly. Credential descriptor schemas contain field definitions, never values.\n\n## Send Lifecycle\n\n`message.send()`: resolves account → creates provider sender → updates sendStatus. Retry support with `maxRetries` budget.\n\n## Provider entry points (bundle boundary, #1979)\n\nThe package root is provider-neutral: models, collections, services,\npermissions, and the provider registry carry **zero provider-SDK weight**.\nProvider SDK wrappers (`@happyvertical/email`, `@happyvertical/messages`) are\nreachable only through explicit entry points, imported once at server startup:\n\n```ts\nimport '@happyvertical/smrt-messages/providers/email';   // smtp/imap/pop3/gmail\nimport '@happyvertical/smrt-messages/providers/slack';\nimport '@happyvertical/smrt-messages/providers/twitter';\nimport '@happyvertical/smrt-messages/providers/all';     // all of the above\n```\n\n- Without the matching entry, `EmailAccount.createClient()` (send + mailbox\n  sync) throws an actionable error and `SlackSender`/`TweetSender` return a\n  failure result naming the entry to import. Telegram and Zulip are\n  fetch-based and always work from the root.\n- Builtin registry definitions stay metadata-only (setup fields for UIs); the\n  entries upgrade them with `createEmailClient`/`createMessageClient`/\n  `createSender` hooks. Never import a provider SDK from any module reachable\n  from `src/index.ts` — the consumer bundle gate (`packages/bundle-gate`)\n  fails CI when one becomes reachable.\n- `Attachment.readContent()` loads `@happyvertical/files` through core's\n  `importOptionalDependency` boundary and keeps its null-on-failure contract\n  in builds where the SDK is absent.\n\n## Gotchas\n\n- **Manifest before decorators**: every decorated model imports\n  `../__smrt-register__.js`, and `package.json#sideEffects` lists\n  `./src/__smrt-register__.ts`. Without both, the library build dropped or\n  reordered the self-registration, so dist classes registered with only their\n  decorated fields and could adopt smrt-ledgers' same-named `Account` (#3098).\n- **`Account` is not unique**: smrt-ledgers also declares `Account` (on\n  `ledger_accounts`). Resolve by constructor or qualified name; the\n  coexistence tests (`ledger-account-identity-*`, and the PostgreSQL lane\n  `pnpm test:postgres`) load both packages in both orders.\n- **STI `_meta_type`**: qualified format `@happyvertical/smrt-messages:Email`\n- **JSON fields**: all address/metadata fields are JSON strings with `getX()`/`setX()` helpers\n- **RFC 822 threading**: Email uses `inReplyTo`/`messageId`/`references` — manual management required\n- **Attachment.messageId**: use this field (not `emailId`); old getter/setter mapped via deprecation wrapper\n- **Optional tenancy**: `@TenantScoped({ mode: 'optional' })` on Message, Account, Attachment\n- **Required tenancy**: endpoints and persona routes are always tenant scoped\n- **Secrets are write-only**: never serialize credentials or endpoint.address to an app\n\n## Intake byte snapshots\n\n`EmailAccount.readIntakeMessage(providerLookup, maxBytes, imapIdentity?)` is the authorized host seam for\nopt-in ingestion. It copies full-message attachment bytes from the registered\nemail provider and fails when only attachment metadata is available; it never\nreads provider-supplied paths or advances sync checkpoints. Keep this path\nprovider-neutral and exclude arbitrary headers/credentials from its snapshot.\nIMAP lookup must include folder/UIDVALIDITY/UID verification; sender Message-ID\nis a lookup hint, never the durable delivery identity.\n",
+  "recipes": [
+    {
+      "id": "messages.mailbox",
+      "className": "MailboxRecipe",
+      "label": "Mailbox",
+      "summary": "Read and compose email from your connected accounts.",
+      "synonyms": [
+        "email",
+        "inbox",
+        "mail"
+      ],
+      "models": [
+        "@happyvertical/smrt-messages:Email",
+        "@happyvertical/smrt-messages:EmailAccount"
+      ],
+      "nav": [
+        {
+          "label": "Mailbox",
+          "model": "@happyvertical/smrt-messages:Email",
+          "icon": "folder",
+          "description": "Read email from your connected accounts.",
+          "key": "mailbox",
+          "noun": "email"
+        },
+        {
+          "label": "Failed sends",
+          "model": "@happyvertical/smrt-messages:Email",
+          "icon": "fileText",
+          "description": "Review email whose last send attempt failed.",
+          "key": "failed-sends",
+          "noun": "email",
+          "filter": {
+            "field": "sendStatus",
+            "value": "failed"
+          }
+        }
+      ],
+      "requires": [],
+      "group": {
+        "id": "messages",
+        "label": "Messaging",
+        "summary": "Choose email and personal updates independently."
+      },
+      "section": {
+        "id": "messages",
+        "label": "Messaging",
+        "icon": "folder",
+        "description": "Read email and keep up with updates addressed to you."
+      },
+      "help": {
+        "markdown": "## Your mailbox\nRead messages, open a conversation, or compose an email using a connected account.\nChoose the sender account, add recipients, and check the subject and message before sending.\n\n## Failed sends\nUse Failed sends to review email whose last send attempt failed. Returning to the mailbox shows all email again.\nCheck the failure and sender connection before retrying through your application. This view does not resend email automatically.\n\n## Preview\nThe playground uses fictional messages. Sending and saving are mocked and never contact a mail server.\n\n## Connect an account\nYour application administrator connects an authorized email provider on the server. Real sending and mailbox synchronization require that connection; a preview does not verify delivery.\n",
+        "fieldRefs": []
+      },
+      "surfaces": [
+        {
+          "kind": "route",
+          "path": "/messages/mailbox",
+          "export": "@happyvertical/smrt-messages/svelte#MessageList",
+          "label": "Mailbox"
+        },
+        {
+          "kind": "playground",
+          "export": "@happyvertical/smrt-messages/svelte#MailboxDemo",
+          "label": "Mailbox with mocked sending"
+        }
+      ],
+      "providers": [
+        {
+          "id": "email-inbox",
+          "kind": "email",
+          "options": [
+            "imap",
+            "pop3",
+            "gmail"
+          ],
+          "required": true
+        },
+        {
+          "id": "email-send",
+          "kind": "email",
+          "options": [
+            "smtp",
+            "gmail"
+          ],
+          "required": false
+        }
+      ],
+      "runtime": "both",
+      "demoSeed": {
+        "data": {
+          "accounts": [
+            {
+              "id": "demo-account",
+              "name": "Demo Inbox",
+              "providerType": "email",
+              "email": "you@example.com",
+              "isActive": true
+            }
+          ],
+          "messages": [
+            {
+              "id": "demo-welcome",
+              "type": "email",
+              "accountId": "demo-account",
+              "subject": "Welcome to your mailbox",
+              "body": "Fictional mail. Sending is mocked; nothing leaves this browser.",
+              "senderName": "Demo colleague",
+              "senderAddress": "colleague@example.com",
+              "recipientAddresses": [
+                {
+                  "address": "you@example.com"
+                }
+              ],
+              "date": "2026-01-01T12:00:00Z",
+              "isRead": false,
+              "isFlagged": false,
+              "hasAttachments": false
+            }
+          ]
+        }
+      },
+      "demo": {
+        "mode": "server",
+        "reasons": [
+          "Needs a server because its package depends on @happyvertical/smrt-profiles, @happyvertical/smrt-secrets, @happyvertical/smrt-tenancy, @happyvertical/smrt-users, which do not build for a browser (#3617, #3624, #3626, #3627)."
+        ]
+      }
+    },
+    {
+      "id": "messages.notifications",
+      "className": "NotificationsRecipe",
+      "label": "Notifications",
+      "summary": "See updates addressed to you and mark them read.",
+      "synonyms": [
+        "alerts",
+        "notification bell"
+      ],
+      "models": [
+        "@happyvertical/smrt-messages:UserNotification"
+      ],
+      "nav": [],
+      "requires": [],
+      "group": {
+        "id": "messages",
+        "label": "Messaging",
+        "summary": "Choose email and personal updates independently."
+      },
+      "section": {
+        "id": "messages",
+        "label": "Messaging",
+        "icon": "folder",
+        "description": "Read email and keep up with updates addressed to you."
+      },
+      "help": {
+        "markdown": "## Notifications\nOpen the notification bell to see updates addressed to you. Unread updates have a visible marker.\nChoose Mark read for one update or Mark all read for every unread update in your authorized accounts.\nFollow a notification link to open its related record when one is available.\n\n## Availability\nNotifications are scoped to the signed-in person. Your application connects the notification provider and may enable live updates. If loading fails, try again after the connection returns.\n",
+        "fieldRefs": []
+      },
+      "surfaces": [
+        {
+          "kind": "shell-widget",
+          "slot": "header.end",
+          "export": "@happyvertical/smrt-svelte/notifications#NotificationBell",
+          "label": "Notifications"
+        }
+      ],
+      "providers": [
+        {
+          "id": "notifications",
+          "kind": "notifications",
+          "options": [
+            "user-notification-service"
+          ],
+          "required": true
+        }
+      ],
+      "runtime": "both",
+      "demoSeed": {
+        "data": {
+          "items": [
+            {
+              "id": "demo-notification",
+              "title": "You were mentioned",
+              "body": "A fictional update for the demo user.",
+              "occurredAt": "2026-01-01T12:00:00Z",
+              "severity": "info",
+              "readAt": null
+            }
+          ]
+        }
+      },
+      "demo": {
+        "mode": "server",
+        "reasons": [
+          "Needs a server because its package depends on @happyvertical/smrt-profiles, @happyvertical/smrt-secrets, @happyvertical/smrt-tenancy, @happyvertical/smrt-users, which do not build for a browser (#3617, #3624, #3626, #3627)."
+        ]
+      }
+    }
+  ],
   "browser": {
     "status": "server-only",
     "issues": [