@happyvertical/smrt-messages 0.49.2 → 0.49.4

package/dist/smrt-knowledge.json

@@ -3,12 +3,12 @@
   "sensitiveFieldsExcluded": true,
   "generatedAt": "1970-01-01T00:00:00.000Z",
   "packageName": "@happyvertical/smrt-messages",
-  "packageVersion": "0.49.2",
+  "packageVersion": "0.49.4",
   "sourceManifestPath": "dist/manifest.json",
   "agentDocPath": "AGENTS.md",
   "sourceHashes": {
-    "manifest": "5ebc515b2af509ed59f39b57ff0dfe92151209a4116f715b05597b85b9dcf7b5",
-    "packageJson": "b3edbcc4b85c66db5e8619e97bca23ad9e83c9166b49352f1be690021040696d",
+    "manifest": "af27f3217fe2ebed56aacde9104ab5db564173a0254957ccbb2b29fc1c0ca069",
+    "packageJson": "865762d4a84793be9649b1e008b7e2171ed52d7f7f8fb889cb3be4299c9f876a",
     "agents": "712dcc2f244d01db8b49d764b8c076e94cb9274fa4b458d7c902434a0473f127"
   },
   "exports": [
@@ -72,7 +72,7 @@
       "name": "AccountCollection",
       "qualifiedName": "@happyvertical/smrt-messages:AccountCollection",
       "collection": "accounts",
-      "tableName": "account_collections",
+      "tableName": "accounts",
       "packageName": "@happyvertical/smrt-messages",
       "extends": "SmrtCollection",
       "fields": [],
@@ -343,7 +343,7 @@
       "name": "AttachmentCollection",
       "qualifiedName": "@happyvertical/smrt-messages:AttachmentCollection",
       "collection": "attachments",
-      "tableName": "attachment_collections",
+      "tableName": "attachments",
       "packageName": "@happyvertical/smrt-messages",
       "extends": "SmrtCollection",
       "fields": [],
@@ -819,7 +819,7 @@
       "name": "BlacklistCollection",
       "qualifiedName": "@happyvertical/smrt-messages:BlacklistCollection",
       "collection": "blacklists",
-      "tableName": "blacklist_collections",
+      "tableName": "blacklists",
       "packageName": "@happyvertical/smrt-messages",
       "extends": "SmrtCollection",
       "fields": [],
@@ -1367,7 +1367,7 @@
       "name": "EmailAttachmentCollection",
       "qualifiedName": "@happyvertical/smrt-messages:EmailAttachmentCollection",
       "collection": "emailattachments",
-      "tableName": "email_attachment_collections",
+      "tableName": "email_attachments",
       "packageName": "@happyvertical/smrt-messages",
       "extends": "AttachmentCollection",
       "fields": [],
@@ -2706,7 +2706,7 @@
       "name": "EmailFolderCollection",
       "qualifiedName": "@happyvertical/smrt-messages:EmailFolderCollection",
       "collection": "emailfolders",
-      "tableName": "email_folder_collections",
+      "tableName": "email_folders",
       "packageName": "@happyvertical/smrt-messages",
       "extends": "SmrtCollection",
       "fields": [],
@@ -3248,7 +3248,7 @@
       "name": "MessageCollection",
       "qualifiedName": "@happyvertical/smrt-messages:MessageCollection",
       "collection": "messages",
-      "tableName": "message_collections",
+      "tableName": "messages",
       "packageName": "@happyvertical/smrt-messages",
       "extends": "SmrtCollection",
       "fields": [],
@@ -3828,7 +3828,7 @@
       "name": "WhitelistCollection",
       "qualifiedName": "@happyvertical/smrt-messages:WhitelistCollection",
       "collection": "whitelists",
-      "tableName": "whitelist_collections",
+      "tableName": "whitelists",
       "packageName": "@happyvertical/smrt-messages",
       "extends": "SmrtCollection",
       "fields": [],
@@ -14989,7 +14989,7 @@
     "junctionCollections": 0,
     "hierarchicalObjects": 0,
     "polymorphicAssociations": 0,
-    "uuidColumns": 66
+    "uuidColumns": 90
   },
   "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## 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- **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"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@happyvertical/smrt-messages",
-  "version": "0.49.2",
+  "version": "0.49.4",
   "smrtJsdoc": "strict",
   "description": "Unified multi-channel messaging with STI-based hierarchies",
   "type": "module",
@@ -61,12 +61,12 @@
     "@happyvertical/files": "^0.89.6",
     "@happyvertical/logger": "^0.89.6",
     "@happyvertical/messages": "^0.89.6",
-    "@happyvertical/smrt-core": "0.49.2",
-    "@happyvertical/smrt-types": "0.49.2",
-    "@happyvertical/smrt-secrets": "0.49.2",
-    "@happyvertical/smrt-tenancy": "0.49.2",
-    "@happyvertical/smrt-ui": "0.49.2",
-    "@happyvertical/smrt-users": "0.49.2",
+    "@happyvertical/smrt-core": "0.49.4",
+    "@happyvertical/smrt-types": "0.49.4",
+    "@happyvertical/smrt-secrets": "0.49.4",
+    "@happyvertical/smrt-tenancy": "0.49.4",
+    "@happyvertical/smrt-ui": "0.49.4",
+    "@happyvertical/smrt-users": "0.49.4",
     "@happyvertical/sql": "^0.89.6",
     "@happyvertical/utils": "^0.89.6"
   },
@@ -83,7 +83,7 @@
     }
   },
   "devDependencies": {
-    "@happyvertical/smrt-vitest": "0.49.2",
+    "@happyvertical/smrt-vitest": "0.49.4",
     "@sveltejs/package": "^2.5.8",
     "@sveltejs/vite-plugin-svelte": "^7.1.2",
     "@types/node": "24.13.2",