@happyvertical/smrt-messages 0.30.0

package/AGENTS.md

@@ -0,0 +1,31 @@
+# @happyvertical/smrt-messages
+
+Multi-channel messaging with STI hierarchies for both messages and accounts. Credential encryption via smrt-secrets.
+
+## STI Hierarchies
+
+**Messages** (share `messages` table):
+- `Message` (base): accountId, threadId, subject, body, fromAddress, toAddresses (JSON), sendStatus (draft/sending/sent/failed), retryCount
+- `Email`: messageId (RFC 822), inReplyTo, ccAddresses, bccAddresses, htmlBody, textBody, folderId, labels, headers
+- `Tweet`: tweetId, retweetCount, likeCount, mediaUrls, hashtags, mentions
+- `SlackMessage`: channelId, slackTs, slackThreadTs, reactions, blocks
+
+**Accounts** (share `accounts` table):
+- `Account` (base): providerType, credentialSecretId, isActive, lastSyncAt, settings
+- `EmailAccount`, `TwitterAccount`, `SlackAccount`: provider-specific fields + sync methods
+
+## Credential Security
+
+Account credentials stored via `credentialSecretId` → smrt-secrets. Use `setCredentials()`/`getCredentials()` — never store passwords directly.
+
+## Send Lifecycle
+
+`message.send()`: resolves account → creates provider sender → updates sendStatus. Retry support with `maxRetries` budget.
+
+## Gotchas
+
+- **STI `_meta_type`**: qualified format `@happyvertical/smrt-messages:Email`
+- **JSON fields**: all address/metadata fields are JSON strings with `getX()`/`setX()` helpers
+- **RFC 822 threading**: Email uses `inReplyTo`/`messageId`/`references` — manual management required
+- **Attachment.messageId**: use this field (not `emailId`); old getter/setter mapped via deprecation wrapper
+- **Optional tenancy**: `@TenantScoped({ mode: 'optional' })` on Message, Account, Attachment

package/CLAUDE.md

@@ -0,0 +1 @@
+@AGENTS.md

package/LICENSE

@@ -0,0 +1,7 @@
+Copyright <2025> <Happy Vertical Corporation>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,103 @@
+# @happyvertical/smrt-messages
+
+Unified multi-channel messaging with STI-based channel hierarchies for the SMRT framework. Supports email, Slack, and Twitter as message subtypes, with per-channel sender implementations and encrypted credential storage.
+
+## Installation
+
+```bash
+pnpm add @happyvertical/smrt-messages
+```
+
+## Usage
+
+```typescript
+import {
+  Email, EmailCollection,
+  EmailAccount, EmailAccountCollection,
+  EmailSender,
+  MessageCollection,
+} from '@happyvertical/smrt-messages';
+
+// Create an email account with encrypted credentials
+const accounts = new EmailAccountCollection(db);
+const account = await accounts.create({
+  name: 'Support',
+  providerType: 'smtp',
+});
+await account.setCredentials({
+  host: 'smtp.example.com',
+  user: 'support@example.com',
+  pass: process.env.SMTP_PASSWORD,
+});
+
+// Send an email through the send lifecycle
+const emails = new EmailCollection(db);
+const email = await emails.create({
+  accountId: account.id,
+  subject: 'Welcome',
+  toAddresses: JSON.stringify([{ address: 'user@example.com' }]),
+  textBody: 'Thanks for signing up!',
+});
+const result = await email.send();
+// sendStatus transitions: draft -> sending -> sent (or failed)
+
+// Retry a failed message (respects maxRetries budget)
+if (!result.success) {
+  await email.retrySend();
+}
+
+// Query messages across all channels via base collection
+const messages = new MessageCollection(db);
+const recent = await messages.list({ orderBy: 'createdAt DESC', limit: 20 });
+```
+
+## API
+
+### Models (STI Hierarchy)
+
+Messages and accounts each use single-table inheritance. STI discriminators use qualified names (e.g., `@happyvertical/smrt-messages:Email`).
+
+| Export | Description |
+|--------|------------|
+| `Message` | Base message with send lifecycle (draft/sending/sent/failed) |
+| `Email` | Email with RFC 822 threading, cc/bcc, htmlBody/textBody, folders |
+| `SlackMessage` | Slack message with channelId, slackTs, reactions, blocks |
+| `Tweet` | Twitter message with tweetId, retweetCount, likeCount, hashtags |
+| `Account` | Base account with `setCredentials()`/`getCredentials()` via smrt-secrets |
+| `EmailAccount` | Email account (SMTP/IMAP provider) |
+| `SlackAccount` | Slack workspace account |
+| `TwitterAccount` | Twitter API account |
+| `Attachment` | Message attachment |
+| `EmailAttachment` | Email-specific attachment |
+| `EmailFolder` | Email folder/label |
+
+### Collections
+
+`MessageCollection`, `EmailCollection`, `AccountCollection`, `EmailAccountCollection`, `AttachmentCollection`, `EmailAttachmentCollection`, `EmailFolderCollection`
+
+### Senders
+
+Each channel has a dedicated sender implementing `MessageSenderInterface`.
+
+| Export | Description |
+|--------|------------|
+| `EmailSender` | Send emails via `@happyvertical/email` client |
+| `SlackSender` | Send Slack messages via API |
+| `TweetSender` | Post tweets via Twitter API |
+
+### Credential Security
+
+Account credentials are stored via `credentialSecretId` pointing to smrt-secrets envelope encryption. Use `account.setCredentials()` and `account.getCredentials()` -- never store passwords as plain fields.
+
+### Key Types
+
+`MessageType`, `ProviderType`, `SendStatus`, `SendMessageOptions`, `SendEmailOptions`, `SendSlackOptions`, `SendTweetOptions`, `MessageSendResult`, `MessageSenderInterface`, `SyncOptions`, `SyncResult`, `SyncProgress`
+
+## Dependencies
+
+- `@happyvertical/smrt-core` -- ORM and code generation
+- `@happyvertical/smrt-secrets` -- credential encryption (envelope encryption)
+- `@happyvertical/smrt-tenancy` -- optional multi-tenant scoping
+- `@happyvertical/smrt-types` -- shared type definitions
+- `@happyvertical/email` -- SMTP/IMAP email client
+- Peer: `@happyvertical/smrt-svelte` (optional)

package/dist/__smrt-register__.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=__smrt-register__.d.ts.map

package/dist/__smrt-register__.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"__smrt-register__.d.ts","sourceRoot":"","sources":["../src/__smrt-register__.ts"],"names":[],"mappings":""}

package/dist/collections/AccountCollection.d.ts

@@ -0,0 +1,42 @@
+import { SmrtCollection } from '@happyvertical/smrt-core';
+import { Account } from '../models/Account';
+import { AccountSearchFilters } from '../types';
+export declare class AccountCollection extends SmrtCollection<Account> {
+    static readonly _itemClass: typeof Account;
+    /**
+     * Get active accounts
+     */
+    getActive(): Promise<Account[]>;
+    /**
+     * Get inactive accounts
+     */
+    getInactive(): Promise<Account[]>;
+    /**
+     * Get accounts by provider type
+     */
+    getByProviderType(providerType: string): Promise<Account[]>;
+    /**
+     * Get accounts by STI type.
+     *
+     * Accepts either the full discriminator (e.g. "@happyvertical/smrt-messages:EmailAccount")
+     * or the short type name (e.g. "EmailAccount").
+     */
+    getByType(accountType: string): Promise<Account[]>;
+    /**
+     * Search accounts with filters
+     */
+    search(query: string, filters?: AccountSearchFilters): Promise<Account[]>;
+    /**
+     * Get account statistics
+     */
+    getStats(): Promise<{
+        total: number;
+        active: number;
+        inactive: number;
+        byType: Record<string, number>;
+    }>;
+    findByTenant(tenantId: string): Promise<Account[]>;
+    findGlobal(): Promise<Account[]>;
+    findWithGlobals(tenantId: string): Promise<Account[]>;
+}
+//# sourceMappingURL=AccountCollection.d.ts.map

package/dist/collections/AccountCollection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AccountCollection.d.ts","sourceRoot":"","sources":["../../src/collections/AccountCollection.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAErD,qBAAa,iBAAkB,SAAQ,cAAc,CAAC,OAAO,CAAC;IAC5D,MAAM,CAAC,QAAQ,CAAC,UAAU,iBAAW;IAErC;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAIrC;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAIvC;;OAEG;IACG,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAIjE;;;;;OAKG;IACG,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAWxD;;OAEG;IACG,MAAM,CACV,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,OAAO,EAAE,CAAC;IA8BrB;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC;QACxB,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAChC,CAAC;IAsBI,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAIlD,UAAU,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAIhC,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;CAM5D"}

package/dist/collections/AttachmentCollection.d.ts

@@ -0,0 +1,67 @@
+import { SmrtCollection } from '@happyvertical/smrt-core';
+import { Attachment } from '../models/Attachment';
+export declare class AttachmentCollection extends SmrtCollection<Attachment> {
+    static readonly _itemClass: typeof Attachment;
+    /**
+     * Get attachments for a message
+     */
+    getByMessage(messageId: string): Promise<Attachment[]>;
+    /**
+     * Get attachments by content type
+     */
+    getByContentType(contentType: string): Promise<Attachment[]>;
+    /**
+     * Get image attachments
+     */
+    getImages(messageId?: string): Promise<Attachment[]>;
+    /**
+     * Get PDF attachments
+     */
+    getPdfs(messageId?: string): Promise<Attachment[]>;
+    /**
+     * Get inline attachments (embedded in message body)
+     */
+    getInline(messageId: string): Promise<Attachment[]>;
+    /**
+     * Get regular attachments (not inline)
+     */
+    getRegular(messageId: string): Promise<Attachment[]>;
+    /**
+     * Get attachments with external files
+     */
+    getWithExternalFiles(): Promise<Attachment[]>;
+    /**
+     * Get total size of attachments for a message
+     */
+    getTotalSize(messageId: string): Promise<number>;
+    /**
+     * Get largest attachments
+     */
+    getLargest(limit?: number): Promise<Attachment[]>;
+    /**
+     * Search attachments by filename
+     */
+    searchByFilename(query: string): Promise<Attachment[]>;
+    /**
+     * Get attachments by extension
+     */
+    getByExtension(extension: string): Promise<Attachment[]>;
+    /**
+     * Get attachment statistics
+     */
+    getStats(): Promise<{
+        total: number;
+        totalSize: number;
+        byType: Record<string, number>;
+        inline: number;
+        regular: number;
+    }>;
+    /**
+     * Delete all attachments for a message
+     */
+    deleteByMessage(messageId: string): Promise<number>;
+    findByTenant(tenantId: string): Promise<Attachment[]>;
+    findGlobal(): Promise<Attachment[]>;
+    findWithGlobals(tenantId: string): Promise<Attachment[]>;
+}
+//# sourceMappingURL=AttachmentCollection.d.ts.map

package/dist/collections/AttachmentCollection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AttachmentCollection.d.ts","sourceRoot":"","sources":["../../src/collections/AttachmentCollection.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD,qBAAa,oBAAqB,SAAQ,cAAc,CAAC,UAAU,CAAC;IAClE,MAAM,CAAC,QAAQ,CAAC,UAAU,oBAAc;IAExC;;OAEG;IACG,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAI5D;;OAEG;IACG,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAIlE;;OAEG;IACG,SAAS,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAQ1D;;OAEG;IACG,OAAO,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAQxD;;OAEG;IACG,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAKzD;;OAEG;IACG,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAK1D;;OAEG;IACG,oBAAoB,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAKnD;;OAEG;IACG,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKtD;;OAEG;IACG,UAAU,CAAC,KAAK,SAAK,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAKnD;;OAEG;IACG,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAS5D;;OAEG;IACG,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAO9D;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC;QACxB,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC/B,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IAkBF;;OAEG;IACG,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAgBnD,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAIrD,UAAU,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAInC,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;CAM/D"}

package/dist/collections/BlacklistCollection.d.ts

@@ -0,0 +1,14 @@
+import { SmrtCollection } from '@happyvertical/smrt-core';
+import { Blacklist } from '../models/Blacklist.js';
+export declare class BlacklistCollection extends SmrtCollection<Blacklist> {
+    static readonly _itemClass: typeof Blacklist;
+    /**
+     * Check if an email is blacklisted
+     */
+    isBlacklisted(email: string): Promise<boolean>;
+    /**
+     * Get the matching blacklist entry for an email
+     */
+    getMatchingEntry(email: string): Promise<Blacklist | null>;
+}
+//# sourceMappingURL=BlacklistCollection.d.ts.map

package/dist/collections/BlacklistCollection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlacklistCollection.d.ts","sourceRoot":"","sources":["../../src/collections/BlacklistCollection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEnD,qBAAa,mBAAoB,SAAQ,cAAc,CAAC,SAAS,CAAC;IAChE,MAAM,CAAC,QAAQ,CAAC,UAAU,mBAAa;IAEvC;;OAEG;IACG,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAYpD;;OAEG;IACG,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;CAWjE"}

package/dist/collections/EmailAccountCollection.d.ts

@@ -0,0 +1,74 @@
+import { EmailAccount } from '../models/EmailAccount';
+import { EmailAccountSearchFilters, ProviderType } from '../types';
+import { AccountCollection } from './AccountCollection';
+export declare class EmailAccountCollection extends AccountCollection {
+    static readonly _itemClass: typeof EmailAccount;
+    /**
+     * Get account by email address
+     */
+    getByEmail(email: string): Promise<EmailAccount | null>;
+    /**
+     * Get accounts by email provider type
+     */
+    getByEmailProviderType(providerType: ProviderType): Promise<EmailAccount[]>;
+    /**
+     * Get active email accounts
+     */
+    getActive(): Promise<EmailAccount[]>;
+    /**
+     * Get inactive email accounts
+     */
+    getInactive(): Promise<EmailAccount[]>;
+    /**
+     * Get accounts that need syncing
+     */
+    getNeedingSync(maxAgeMinutes?: number): Promise<EmailAccount[]>;
+    /**
+     * Search email accounts with filters.
+     * Alias: `search()` for backward compatibility.
+     */
+    search(query: string, filters?: EmailAccountSearchFilters): Promise<EmailAccount[]>;
+    /**
+     * Get accounts by email provider type.
+     * Alias: `getByProviderType()` for backward compatibility.
+     */
+    getByProviderType(providerType: string): Promise<EmailAccount[]>;
+    /**
+     * Get email account statistics.
+     * Alias: `getStats()` for backward compatibility.
+     */
+    getStats(): Promise<{
+        total: number;
+        active: number;
+        inactive: number;
+        byType: Record<string, number>;
+    }>;
+    /**
+     * Search email accounts with filters
+     */
+    searchEmailAccounts(query: string, filters?: EmailAccountSearchFilters): Promise<EmailAccount[]>;
+    /**
+     * Sync all active email accounts
+     */
+    syncAll(options?: Record<string, any>): Promise<Map<string, {
+        success: boolean;
+        error?: Error;
+    }>>;
+    /**
+     * Get total unread count across all email accounts
+     */
+    getTotalUnreadCount(): Promise<number>;
+    /**
+     * Get email account statistics
+     */
+    getEmailStats(): Promise<{
+        total: number;
+        active: number;
+        inactive: number;
+        byProvider: Record<ProviderType, number>;
+    }>;
+    findByTenant(tenantId: string): Promise<EmailAccount[]>;
+    findGlobal(): Promise<EmailAccount[]>;
+    findWithGlobals(tenantId: string): Promise<EmailAccount[]>;
+}
+//# sourceMappingURL=EmailAccountCollection.d.ts.map

package/dist/collections/EmailAccountCollection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EmailAccountCollection.d.ts","sourceRoot":"","sources":["../../src/collections/EmailAccountCollection.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,KAAK,EAAE,yBAAyB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,qBAAa,sBAAuB,SAAQ,iBAAiB;IAC3D,gBAAyB,UAAU,sBAAgB;IAEnD;;OAEG;IACG,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAK7D;;OAEG;IACG,sBAAsB,CAC1B,YAAY,EAAE,YAAY,GACzB,OAAO,CAAC,YAAY,EAAE,CAAC;IAI1B;;OAEG;IACY,SAAS,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAInD;;OAEG;IACY,WAAW,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAIrD;;OAEG;IACG,cAAc,CAAC,aAAa,SAAK,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IASjE;;;OAGG;IACY,MAAM,CACnB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,yBAAyB,GAClC,OAAO,CAAC,YAAY,EAAE,CAAC;IAI1B;;;OAGG;IACY,iBAAiB,CAC9B,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,YAAY,EAAE,CAAC;IAI1B;;;OAGG;IACY,QAAQ,IAAI,OAAO,CAAC;QACjC,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAChC,CAAC;IAUF;;OAEG;IACG,mBAAmB,CACvB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,yBAAyB,GAClC,OAAO,CAAC,YAAY,EAAE,CAAC;IAkC1B;;OAEG;IACG,OAAO,CACX,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC5B,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,KAAK,CAAA;KAAE,CAAC,CAAC;IAqB5D;;OAEG;IACG,mBAAmB,IAAI,OAAO,CAAC,MAAM,CAAC;IAW5C;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC;QAC7B,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;KAC1C,CAAC;IA6Ba,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAIvD,UAAU,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAIrC,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;CAM1E"}

package/dist/collections/EmailAttachmentCollection.d.ts

@@ -0,0 +1,38 @@
+import { EmailAttachment } from '../models/EmailAttachment';
+import { AttachmentCollection } from './AttachmentCollection';
+/**
+ * @deprecated Use AttachmentCollection instead
+ */
+export declare class EmailAttachmentCollection extends AttachmentCollection {
+    static readonly _itemClass: typeof EmailAttachment;
+    /**
+     * Get attachments for an email
+     * @deprecated Use getByMessage() instead
+     */
+    getByEmail(emailId: string): Promise<EmailAttachment[]>;
+    /**
+     * Get image attachments
+     */
+    getImages(emailId?: string): Promise<EmailAttachment[]>;
+    /**
+     * Get PDF attachments
+     */
+    getPdfs(emailId?: string): Promise<EmailAttachment[]>;
+    /**
+     * Get inline attachments
+     */
+    getInline(emailId: string): Promise<EmailAttachment[]>;
+    /**
+     * Get regular attachments
+     */
+    getRegular(emailId: string): Promise<EmailAttachment[]>;
+    /**
+     * Delete all attachments for an email
+     * @deprecated Use deleteByMessage() instead
+     */
+    deleteByEmail(emailId: string): Promise<number>;
+    findByTenant(tenantId: string): Promise<EmailAttachment[]>;
+    findGlobal(): Promise<EmailAttachment[]>;
+    findWithGlobals(tenantId: string): Promise<EmailAttachment[]>;
+}
+//# sourceMappingURL=EmailAttachmentCollection.d.ts.map

package/dist/collections/EmailAttachmentCollection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EmailAttachmentCollection.d.ts","sourceRoot":"","sources":["../../src/collections/EmailAttachmentCollection.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D;;GAEG;AACH,qBAAa,yBAA0B,SAAQ,oBAAoB;IACjE,gBAAyB,UAAU,yBAAmB;IAEtD;;;OAGG;IACG,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAI7D;;OAEG;IACY,SAAS,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAItE;;OAEG;IACY,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAIpE;;OAEG;IACY,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAIrE;;OAEG;IACY,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAItE;;;OAGG;IACG,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAQtC,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAI1D,UAAU,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAMxC,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;CAM7E"}

package/dist/collections/EmailCollection.d.ts

@@ -0,0 +1,81 @@
+import { Email } from '../models/Email';
+import { EmailSearchFilters } from '../types';
+import { MessageCollection } from './MessageCollection';
+export declare class EmailCollection extends MessageCollection {
+    static readonly _itemClass: typeof Email;
+    /**
+     * Get email by RFC 822 Message-ID
+     */
+    getByMessageId(accountId: string, messageId: string): Promise<Email | null>;
+    /**
+     * Get emails by account
+     */
+    getByAccount(accountId: string): Promise<Email[]>;
+    /**
+     * Get emails by folder
+     */
+    getByFolder(folderId: string): Promise<Email[]>;
+    /**
+     * Get emails by thread
+     */
+    getByThread(threadId: string): Promise<Email[]>;
+    /**
+     * Get unread emails
+     */
+    getUnread(accountId?: string): Promise<Email[]>;
+    /**
+     * Get flagged emails
+     */
+    getFlagged(accountId?: string): Promise<Email[]>;
+    /**
+     * Get emails with attachments
+     */
+    getWithAttachments(accountId?: string): Promise<Email[]>;
+    /**
+     * Get recent emails
+     */
+    getRecent(limit?: number, accountId?: string): Promise<Email[]>;
+    /**
+     * Count emails in a folder
+     */
+    countByFolder(folderId: string): Promise<number>;
+    /**
+     * Count unread emails in a folder
+     */
+    countUnreadByFolder(folderId: string): Promise<number>;
+    /**
+     * Count unread emails for an account
+     */
+    countUnreadByAccount(accountId: string): Promise<number>;
+    /**
+     * Search emails with email-specific filters.
+     * Alias: `search()` for backward compatibility.
+     */
+    search(query: string, filters?: EmailSearchFilters): Promise<Email[]>;
+    /**
+     * Search emails with email-specific filters
+     */
+    searchEmails(query: string, filters?: EmailSearchFilters): Promise<Email[]>;
+    /**
+     * Mark all emails in a folder as read
+     */
+    markFolderRead(folderId: string): Promise<void>;
+    /**
+     * Delete emails by folder
+     */
+    deleteByFolder(folderId: string): Promise<number>;
+    /**
+     * Get email statistics for an account
+     */
+    getAccountStats(accountId: string): Promise<{
+        total: number;
+        unread: number;
+        flagged: number;
+        withAttachments: number;
+        byType: Record<string, number>;
+    }>;
+    findByTenant(tenantId: string): Promise<Email[]>;
+    findGlobal(): Promise<Email[]>;
+    findWithGlobals(tenantId: string): Promise<Email[]>;
+}
+//# sourceMappingURL=EmailCollection.d.ts.map

package/dist/collections/EmailCollection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EmailCollection.d.ts","sourceRoot":"","sources":["../../src/collections/EmailCollection.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AACxC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,qBAAa,eAAgB,SAAQ,iBAAiB;IACpD,gBAAyB,UAAU,eAAS;IAE5C;;OAEG;IACG,cAAc,CAClB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IAQxB;;OAEG;IACG,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAIvD;;OAEG;IACG,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAIrD;;OAEG;IACY,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAI9D;;OAEG;IACY,SAAS,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAQ9D;;OAEG;IACY,UAAU,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAQ/D;;OAEG;IACG,kBAAkB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAQ9D;;OAEG;IACY,SAAS,CAAC,KAAK,SAAK,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAc1E;;OAEG;IACG,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKtD;;OAEG;IACG,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAK5D;;OAEG;IACG,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAK9D;;;OAGG;IACY,MAAM,CACnB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,KAAK,EAAE,CAAC;IAInB;;OAEG;IACG,YAAY,CAChB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,KAAK,EAAE,CAAC;IAwEnB;;OAEG;IACG,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASrD;;OAEG;IACG,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAYvD;;OAEG;IACY,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QACzD,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,eAAe,EAAE,MAAM,CAAC;QACxB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAChC,CAAC;IAgBa,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAIhD,UAAU,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IAI9B,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;CAMnE"}

package/dist/collections/EmailFolderCollection.d.ts

@@ -0,0 +1,85 @@
+import { SmrtCollection } from '@happyvertical/smrt-core';
+import { EmailFolder } from '../models/EmailFolder';
+import { EmailFolderSearchFilters } from '../types';
+export declare class EmailFolderCollection extends SmrtCollection<EmailFolder> {
+    static readonly _itemClass: typeof EmailFolder;
+    /**
+     * Get folder by path for an account
+     */
+    getByPath(accountId: string, path: string): Promise<EmailFolder | null>;
+    /**
+     * Get folders by account
+     */
+    getByAccount(accountId: string): Promise<EmailFolder[]>;
+    /**
+     * Get inbox folder for an account
+     */
+    getInbox(accountId: string): Promise<EmailFolder | null>;
+    /**
+     * Get sent folder for an account
+     */
+    getSent(accountId: string): Promise<EmailFolder | null>;
+    /**
+     * Get drafts folder for an account
+     */
+    getDrafts(accountId: string): Promise<EmailFolder | null>;
+    /**
+     * Get trash folder for an account
+     */
+    getTrash(accountId: string): Promise<EmailFolder | null>;
+    /**
+     * Get spam folder for an account
+     */
+    getSpam(accountId: string): Promise<EmailFolder | null>;
+    /**
+     * Get system folders for an account
+     */
+    getSystemFolders(accountId: string): Promise<EmailFolder[]>;
+    /**
+     * Get user-created folders for an account
+     */
+    getUserFolders(accountId: string): Promise<EmailFolder[]>;
+    /**
+     * Get subscribed folders
+     */
+    getSubscribed(accountId?: string): Promise<EmailFolder[]>;
+    /**
+     * Get folders with unread messages
+     */
+    getWithUnread(accountId?: string): Promise<EmailFolder[]>;
+    /**
+     * Search folders with filters
+     */
+    search(query: string, filters?: EmailFolderSearchFilters): Promise<EmailFolder[]>;
+    /**
+     * Refresh counts for all folders in an account
+     */
+    refreshAllCounts(accountId: string): Promise<void>;
+    /**
+     * Get folder statistics for an account
+     */
+    getAccountStats(accountId: string): Promise<{
+        totalFolders: number;
+        totalMessages: number;
+        totalUnread: number;
+        systemFolders: number;
+        userFolders: number;
+    }>;
+    /**
+     * Create standard system folders for an account
+     */
+    createSystemFolders(accountId: string): Promise<void>;
+    /**
+     * Find all email folders belonging to a specific tenant
+     */
+    findByTenant(tenantId: string): Promise<EmailFolder[]>;
+    /**
+     * Find all global email folders (no tenant)
+     */
+    findGlobal(): Promise<EmailFolder[]>;
+    /**
+     * Find email folders for a tenant including global folders
+     */
+    findWithGlobals(tenantId: string): Promise<EmailFolder[]>;
+}
+//# sourceMappingURL=EmailFolderCollection.d.ts.map

package/dist/collections/EmailFolderCollection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EmailFolderCollection.d.ts","sourceRoot":"","sources":["../../src/collections/EmailFolderCollection.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAC;AAEzD,qBAAa,qBAAsB,SAAQ,cAAc,CAAC,WAAW,CAAC;IACpE,MAAM,CAAC,QAAQ,CAAC,UAAU,qBAAe;IAEzC;;OAEG;IACG,SAAS,CACb,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAK9B;;OAEG;IACG,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAI7D;;OAEG;IACG,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAK9D;;OAEG;IACG,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAK7D;;OAEG;IACG,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAK/D;;OAEG;IACG,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAK9D;;OAEG;IACG,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAK7D;;OAEG;IACG,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAKjE;;OAEG;IACG,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAK/D;;OAEG;IACG,aAAa,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAQ/D;;OAEG;IACG,aAAa,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAQ/D;;OAEG;IACG,MAAM,CACV,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,wBAAwB,GACjC,OAAO,CAAC,WAAW,EAAE,CAAC;IA6BzB;;OAEG;IACG,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQxD;;OAEG;IACG,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QAChD,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,CAAC;QACtB,WAAW,EAAE,MAAM,CAAC;QACpB,aAAa,EAAE,MAAM,CAAC;QACtB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IAYF;;OAEG;IACG,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA4B3D;;OAEG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAI5D;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAI1C;;OAEG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;CAMhE"}