@happyvertical/email 0.74.8

package/AGENT.md

@@ -0,0 +1,34 @@
+# @happyvertical/email
+
+<!-- BEGIN AGENT:GENERATED -->
+## Purpose
+Low-level email protocol operations with adapter-based architecture
+
+## Package Map
+- Package: `@happyvertical/email`
+- Hierarchy path: `@happyvertical/sdk > packages > email`
+- Workspace position: `9 of 30` local packages
+- Internal dependencies: `@happyvertical/logger`, `@happyvertical/utils`
+- Internal dependents: `@happyvertical/messages`
+- Knowledge graph files: `AGENT.md`, `metadata.json`, `ecosystem-manifest.json`
+
+## Build & Test
+```bash
+pnpm --filter @happyvertical/email build
+pnpm --filter @happyvertical/email test
+pnpm --filter @happyvertical/email typecheck
+pnpm --filter @happyvertical/email clean
+```
+
+## Agent Correction Loops
+- If module resolution or export errors mention a workspace dependency, build the dependency first (`pnpm --filter @happyvertical/logger build`, `pnpm --filter @happyvertical/utils build`) and then rerun `pnpm --filter @happyvertical/email build`.
+- If tests or exports fail after API, type, or bundle changes, run `pnpm --filter @happyvertical/email clean` followed by `pnpm --filter @happyvertical/email build` and `pnpm --filter @happyvertical/email test`.
+- If failures span multiple packages or Turborepo ordering looks wrong, run `pnpm build` and `pnpm typecheck` from the repo root before retrying package-scoped commands.
+
+## Ecosystem Relationships
+- Provides: Low-level email protocol operations with adapter-based architecture
+- Implements: none
+- Requires: @happyvertical/logger, @happyvertical/utils, google-auth-library, googleapis, imapflow, mailparser, node-pop3, nodemailer
+- Stability: stable (Primary package surface is described as implemented and production-oriented.)
+<!-- END AGENT:GENERATED -->
+

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/dist/adapters/gmail.d.ts

@@ -0,0 +1,43 @@
+import { BaseEmailClient } from '../shared/base';
+import { AdapterType, EmailClientCapabilities, EmailMessage, FetchOptions, Folder, FolderInfo, GmailOptions, SearchCriteria, SendOptions, SendResult } from '../shared/types';
+/**
+ * Gmail adapter implementation using Gmail API
+ *
+ * Requires OAuth2 credentials with appropriate scopes:
+ * - gmail.readonly: Read emails and settings
+ * - gmail.send: Send emails
+ * - gmail.modify: Modify emails (mark read, delete, move)
+ * - gmail.labels: Manage labels
+ */
+export declare class GmailAdapter extends BaseEmailClient {
+    private gmail;
+    private options;
+    private auth;
+    constructor(options: GmailOptions);
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    send(message: EmailMessage, options?: SendOptions): Promise<SendResult>;
+    fetch(options?: FetchOptions): Promise<EmailMessage[]>;
+    getMessage(messageId: string): Promise<EmailMessage>;
+    listFolders(): Promise<Folder[]>;
+    selectFolder(name: string): Promise<FolderInfo>;
+    createFolder(name: string): Promise<void>;
+    deleteFolder(name: string): Promise<void>;
+    markRead(messageId: string | string[]): Promise<void>;
+    markUnread(messageId: string | string[]): Promise<void>;
+    move(messageId: string | string[], folder: string): Promise<void>;
+    copy(messageId: string | string[], folder: string): Promise<void>;
+    delete(messageId: string | string[]): Promise<void>;
+    search(criteria: SearchCriteria): Promise<EmailMessage[]>;
+    getCapabilities(): Promise<EmailClientCapabilities>;
+    getAdapter(): AdapterType;
+    private ensureConnected;
+    private getUserId;
+    private buildRFC2822Message;
+    private formatEmailAddress;
+    private buildGmailQuery;
+    private formatGmailDate;
+    private mapGmailLabelToSpecialUse;
+    private mapGmailError;
+}
+//# sourceMappingURL=gmail.d.ts.map

package/dist/adapters/gmail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gmail.d.ts","sourceRoot":"","sources":["../../src/adapters/gmail.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAWjD,OAAO,KAAK,EACV,WAAW,EACX,uBAAuB,EACvB,YAAY,EACZ,YAAY,EACZ,MAAM,EACN,UAAU,EACV,YAAY,EACZ,cAAc,EACd,WAAW,EACX,UAAU,EACX,MAAM,iBAAiB,CAAC;AAEzB;;;;;;;;GAQG;AACH,qBAAa,YAAa,SAAQ,eAAe;IAC/C,OAAO,CAAC,KAAK,CAA+B;IAC5C,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,IAAI,CAA6B;gBAE7B,OAAO,EAAE,YAAY;IAY3B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA2BxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAW3B,IAAI,CACR,OAAO,EAAE,YAAY,EACrB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,UAAU,CAAC;IA0ChB,KAAK,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAmEtD,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAgGpD,WAAW,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IA2BhC,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IA8B/C,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BzC,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqCzC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBrD,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBvD,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA+BjE,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMjE,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBnD,MAAM,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IA2CzD,eAAe,IAAI,OAAO,CAAC,uBAAuB,CAAC;IAczD,UAAU,IAAI,WAAW;IAQzB,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,mBAAmB;IA+H3B,OAAO,CAAC,kBAAkB;IAO1B,OAAO,CAAC,eAAe;IAwBvB,OAAO,CAAC,eAAe;IAQvB,OAAO,CAAC,yBAAyB;IAmBjC,OAAO,CAAC,aAAa;CAiDtB"}

package/dist/adapters/imap.d.ts

@@ -0,0 +1,114 @@
+import { BaseEmailClient } from '../shared/base';
+import { AdapterType, EmailClientCapabilities, EmailMessage, FetchOptions, Folder, FolderInfo, IMAPOptions, SearchCriteria, SendOptions, SendResult } from '../shared/types';
+/**
+ * IMAP adapter for receiving email via IMAP protocol
+ *
+ * Uses ImapFlow for robust IMAP operations including:
+ * - Fetch messages with various filters
+ * - Folder management (list, create, delete, rename)
+ * - Message operations (mark read, move, copy, delete)
+ * - Search functionality
+ * - OAuth2 authentication
+ * - IDLE push notifications (optional)
+ */
+export declare class IMAPAdapter extends BaseEmailClient {
+    private client;
+    private options;
+    private currentFolder;
+    constructor(options: IMAPOptions);
+    /**
+     * Create ImapFlow client
+     */
+    private createClient;
+    getAdapter(): AdapterType;
+    /**
+     * Helper to convert search results to array
+     */
+    private searchResultToArray;
+    /**
+     * Connect to IMAP server
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect from IMAP server
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Fetch messages with filters
+     */
+    fetch(options?: FetchOptions): Promise<EmailMessage[]>;
+    /**
+     * Get a specific message by ID
+     */
+    getMessage(messageId: string): Promise<EmailMessage>;
+    /**
+     * List all folders
+     */
+    listFolders(): Promise<Folder[]>;
+    /**
+     * Select a folder
+     */
+    selectFolder(name: string): Promise<FolderInfo>;
+    /**
+     * Create a new folder
+     */
+    createFolder(name: string): Promise<void>;
+    /**
+     * Delete a folder
+     */
+    deleteFolder(name: string): Promise<void>;
+    /**
+     * Mark message(s) as read
+     */
+    markRead(messageId: string | string[]): Promise<void>;
+    /**
+     * Mark message(s) as unread
+     */
+    markUnread(messageId: string | string[]): Promise<void>;
+    /**
+     * Move message(s) to another folder
+     */
+    move(messageId: string | string[], folder: string): Promise<void>;
+    /**
+     * Copy message(s) to another folder
+     */
+    copy(messageId: string | string[], folder: string): Promise<void>;
+    /**
+     * Delete message(s)
+     */
+    delete(messageId: string | string[]): Promise<void>;
+    /**
+     * Search messages
+     */
+    search(criteria: SearchCriteria): Promise<EmailMessage[]>;
+    /**
+     * Get adapter capabilities
+     */
+    getCapabilities(): Promise<EmailClientCapabilities>;
+    /**
+     * Check if using OAuth2 authentication
+     */
+    private isOAuth2;
+    send(_message: EmailMessage, _options?: SendOptions): Promise<SendResult>;
+    /**
+     * Ensure client is connected
+     */
+    private ensureConnected;
+    /**
+     * Build IMAP search query from FetchOptions
+     */
+    private buildSearchQuery;
+    /**
+     * Build IMAP search criteria from SearchCriteria
+     */
+    private buildSearchCriteria;
+    /**
+     * Parse mailparser output to EmailMessage
+     */
+    private parseMessage;
+    /**
+     * Map ImapFlow errors to standard error types
+     */
+    private mapIMAPError;
+}
+//# sourceMappingURL=imap.d.ts.map

package/dist/adapters/imap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"imap.d.ts","sourceRoot":"","sources":["../../src/adapters/imap.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAUjD,OAAO,KAAK,EACV,WAAW,EACX,uBAAuB,EACvB,YAAY,EACZ,YAAY,EACZ,MAAM,EACN,UAAU,EACV,WAAW,EACX,cAAc,EACd,WAAW,EACX,UAAU,EACX,MAAM,iBAAiB,CAAC;AAEzB;;;;;;;;;;GAUG;AACH,qBAAa,WAAY,SAAQ,eAAe;IAC9C,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,aAAa,CAAuB;gBAEhC,OAAO,EAAE,WAAW;IAShC;;OAEG;IACH,OAAO,CAAC,YAAY;IAoBpB,UAAU,IAAI,WAAW;IAIzB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAO3B;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAa9B;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAUjC;;OAEG;IACG,KAAK,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAmE5D;;OAEG;IACG,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IA6C1D;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAsBtC;;OAEG;IACG,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAgCrD;;OAEG;IACG,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB/C;;OAEG;IACG,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB/C;;OAEG;IACG,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAwB3D;;OAEG;IACG,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAwB7D;;OAEG;IACG,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBvE;;OAEG;IACG,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBvE;;OAEG;IACG,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAyBzD;;OAEG;IACG,MAAM,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAgC/D;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,uBAAuB,CAAC;IAczD;;OAEG;IACH,OAAO,CAAC,QAAQ;IAYV,IAAI,CACR,QAAQ,EAAE,YAAY,EACtB,QAAQ,CAAC,EAAE,WAAW,GACrB,OAAO,CAAC,UAAU,CAAC;IAYtB;;OAEG;IACH,OAAO,CAAC,eAAe;IASvB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAuBxB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAwE3B;;OAEG;IACH,OAAO,CAAC,YAAY;IAuEpB;;OAEG;IACH,OAAO,CAAC,YAAY;CAuCrB"}

package/dist/adapters/pop3.d.ts

@@ -0,0 +1,44 @@
+import { BaseEmailClient } from '../shared/base';
+import { AdapterType, EmailClientCapabilities, EmailMessage, FetchOptions, Folder, FolderInfo, POP3Options, SearchCriteria, SendOptions, SendResult } from '../shared/types';
+/**
+ * POP3 adapter implementation
+ *
+ * POP3 is a simple protocol for retrieving email. It does not support:
+ * - Folders (POP3 has no folder concept)
+ * - Marking messages as read/unread
+ * - Moving or copying messages
+ * - Server-side search
+ *
+ * By default, POP3 deletes messages from the server after retrieval.
+ * Use leaveOnServer: true to keep messages on the server.
+ */
+export declare class POP3Adapter extends BaseEmailClient {
+    private client;
+    private options;
+    private messageCache;
+    constructor(options: POP3Options);
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    fetch(options?: FetchOptions): Promise<EmailMessage[]>;
+    getMessage(messageId: string): Promise<EmailMessage>;
+    delete(messageId: string | string[]): Promise<void>;
+    send(_message: EmailMessage, _options?: SendOptions): Promise<SendResult>;
+    listFolders(): Promise<Folder[]>;
+    selectFolder(_name: string): Promise<FolderInfo>;
+    createFolder(_name: string): Promise<void>;
+    deleteFolder(_name: string): Promise<void>;
+    markRead(_messageId: string | string[]): Promise<void>;
+    markUnread(_messageId: string | string[]): Promise<void>;
+    move(_messageId: string | string[], _folder: string): Promise<void>;
+    copy(_messageId: string | string[], _folder: string): Promise<void>;
+    search(_criteria: SearchCriteria): Promise<EmailMessage[]>;
+    getCapabilities(): Promise<EmailClientCapabilities>;
+    getAdapter(): AdapterType;
+    private ensureConnected;
+    private fetchMessage;
+    private deleteMessageByNum;
+    private parseUidlResponse;
+    private shouldIncludeMessage;
+    private mapPOP3Error;
+}
+//# sourceMappingURL=pop3.d.ts.map

package/dist/adapters/pop3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pop3.d.ts","sourceRoot":"","sources":["../../src/adapters/pop3.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAQjD,OAAO,KAAK,EACV,WAAW,EACX,uBAAuB,EACvB,YAAY,EACZ,YAAY,EACZ,MAAM,EACN,UAAU,EACV,WAAW,EACX,cAAc,EACd,WAAW,EACX,UAAU,EACX,MAAM,iBAAiB,CAAC;AAEzB;;;;;;;;;;;GAWG;AACH,qBAAa,WAAY,SAAQ,eAAe;IAC9C,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,YAAY,CAAkC;gBAE1C,OAAO,EAAE,WAAW;IAY1B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAoBxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAuB3B,KAAK,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IA8DtD,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IA+CpD,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAmDnD,IAAI,CACR,QAAQ,EAAE,YAAY,EACtB,QAAQ,CAAC,EAAE,WAAW,GACrB,OAAO,CAAC,UAAU,CAAC;IAQhB,WAAW,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAQhC,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAQhD,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ1C,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ1C,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAQtD,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAQxD,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQnE,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQnE,MAAM,CAAC,SAAS,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAY1D,eAAe,IAAI,OAAO,CAAC,uBAAuB,CAAC;IAczD,UAAU,IAAI,WAAW;IAQzB,OAAO,CAAC,eAAe;YAST,YAAY;YAuEZ,kBAAkB;IAUhC,OAAO,CAAC,iBAAiB;IAwBzB,OAAO,CAAC,oBAAoB;IAsB5B,OAAO,CAAC,YAAY;CAgDrB"}

package/dist/adapters/smtp.d.ts

@@ -0,0 +1,64 @@
+import { BaseEmailClient } from '../shared/base';
+import { AdapterType, EmailClientCapabilities, EmailMessage, FetchOptions, Folder, FolderInfo, SearchCriteria, SendOptions, SendResult, SMTPOptions } from '../shared/types';
+/**
+ * SMTP adapter for sending email via SMTP protocol
+ *
+ * Uses Nodemailer for robust SMTP operations including:
+ * - Plain text and HTML email
+ * - Attachments (files and inline images)
+ * - Multiple recipients (To, CC, BCC)
+ * - Connection pooling
+ * - OAuth2 authentication
+ * - TLS/SSL support
+ */
+export declare class SMTPAdapter extends BaseEmailClient {
+    private transporter;
+    private options;
+    constructor(options: SMTPOptions);
+    /**
+     * Create Nodemailer transporter with configuration
+     */
+    private createTransporter;
+    getAdapter(): AdapterType;
+    /**
+     * Send an email message
+     */
+    send(message: EmailMessage, options?: SendOptions): Promise<SendResult>;
+    /**
+     * Format email address for Nodemailer
+     */
+    private formatEmailAddress;
+    /**
+     * Map Nodemailer/SMTP errors to standard error types
+     */
+    private mapSMTPError;
+    /**
+     * Connect to SMTP server (verify connection)
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect from SMTP server
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Get adapter capabilities
+     */
+    getCapabilities(): Promise<EmailClientCapabilities>;
+    /**
+     * Check if using OAuth2 authentication
+     */
+    private isOAuth2;
+    fetch(_options?: FetchOptions): Promise<EmailMessage[]>;
+    getMessage(_messageId: string): Promise<EmailMessage>;
+    listFolders(): Promise<Folder[]>;
+    selectFolder(_name: string): Promise<FolderInfo>;
+    createFolder(_name: string): Promise<void>;
+    deleteFolder(_name: string): Promise<void>;
+    markRead(_messageId: string | string[]): Promise<void>;
+    markUnread(_messageId: string | string[]): Promise<void>;
+    move(_messageId: string | string[], _folder: string): Promise<void>;
+    copy(_messageId: string | string[], _folder: string): Promise<void>;
+    delete(_messageId: string | string[]): Promise<void>;
+    search(_criteria: SearchCriteria): Promise<EmailMessage[]>;
+}
+//# sourceMappingURL=smtp.d.ts.map

package/dist/adapters/smtp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smtp.d.ts","sourceRoot":"","sources":["../../src/adapters/smtp.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAQjD,OAAO,KAAK,EACV,WAAW,EACX,uBAAuB,EACvB,YAAY,EACZ,YAAY,EACZ,MAAM,EACN,UAAU,EACV,cAAc,EACd,WAAW,EACX,UAAU,EACV,WAAW,EACZ,MAAM,iBAAiB,CAAC;AAEzB;;;;;;;;;;GAUG;AACH,qBAAa,WAAY,SAAQ,eAAe;IAC9C,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,OAAO,CAAc;gBAEjB,OAAO,EAAE,WAAW;IAUhC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAqBzB,UAAU,IAAI,WAAW;IAIzB;;OAEG;IACG,IAAI,CACR,OAAO,EAAE,YAAY,EACrB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,UAAU,CAAC;IAgEtB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAS1B;;OAEG;IACH,OAAO,CAAC,YAAY;IAqDpB;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAY9B;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAMjC;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,uBAAuB,CAAC;IAczD;;OAEG;IACH,OAAO,CAAC,QAAQ;IAYV,KAAK,CAAC,QAAQ,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAQvD,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAQrD,WAAW,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAQhC,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAQhD,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ1C,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ1C,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAQtD,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAQxD,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQnE,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQnE,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAQpD,MAAM,CAAC,SAAS,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;CAOjE"}

package/dist/cli/claude-context.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=claude-context.d.ts.map

package/dist/cli/claude-context.d.ts.map

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

package/dist/cli/claude-context.js

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+import { existsSync, mkdirSync, copyFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+const Dirname = dirname(fileURLToPath(import.meta.url));
+const pkgRoot = join(Dirname, "../..");
+const targetDir = join(process.cwd(), ".claude");
+if (!existsSync(targetDir)) {
+  mkdirSync(targetDir, { recursive: true });
+}
+const pkgName = "email";
+const agentMdSrc = existsSync(join(pkgRoot, "AGENT.md")) ? join(pkgRoot, "AGENT.md") : join(pkgRoot, "CLAUDE.md");
+const metaSrc = existsSync(join(pkgRoot, "metadata.json")) ? join(pkgRoot, "metadata.json") : join(pkgRoot, ".claude-meta.json");
+if (existsSync(agentMdSrc)) {
+  copyFileSync(agentMdSrc, join(targetDir, `have-${pkgName}.md`));
+}
+if (existsSync(metaSrc)) {
+  copyFileSync(metaSrc, join(targetDir, `have-${pkgName}.meta.json`));
+}
+console.log(`✓ Installed @happyvertical/${pkgName} context to .claude/`);
+//# sourceMappingURL=claude-context.js.map

package/dist/cli/claude-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-context.js","sources":["../../src/cli/claude-context.ts"],"sourcesContent":["#!/usr/bin/env node\n/**\n * CLI script to install agent context for @happyvertical/email\n * Run the published context installer binary for this package.\n */\nimport { copyFileSync, existsSync, mkdirSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nconst Dirname = dirname(fileURLToPath(import.meta.url));\nconst pkgRoot = join(Dirname, '../..');\nconst targetDir = join(process.cwd(), '.claude');\n\nif (!existsSync(targetDir)) {\n  mkdirSync(targetDir, { recursive: true });\n}\n\nconst pkgName = 'email';\nconst agentMdSrc = existsSync(join(pkgRoot, 'AGENT.md'))\n  ? join(pkgRoot, 'AGENT.md')\n  : join(pkgRoot, 'CLAUDE.md');\nconst metaSrc = existsSync(join(pkgRoot, 'metadata.json'))\n  ? join(pkgRoot, 'metadata.json')\n  : join(pkgRoot, '.claude-meta.json');\n\nif (existsSync(agentMdSrc)) {\n  copyFileSync(agentMdSrc, join(targetDir, `have-${pkgName}.md`));\n}\n\nif (existsSync(metaSrc)) {\n  copyFileSync(metaSrc, join(targetDir, `have-${pkgName}.meta.json`));\n}\n\nconsole.log(`✓ Installed @happyvertical/${pkgName} context to .claude/`);\n"],"names":[],"mappings":";;;;AASA,MAAM,UAAU,QAAQ,cAAc,YAAY,GAAG,CAAC;AACtD,MAAM,UAAU,KAAK,SAAS,OAAO;AACrC,MAAM,YAAY,KAAK,QAAQ,IAAA,GAAO,SAAS;AAE/C,IAAI,CAAC,WAAW,SAAS,GAAG;AAC1B,YAAU,WAAW,EAAE,WAAW,KAAA,CAAM;AAC1C;AAEA,MAAM,UAAU;AAChB,MAAM,aAAa,WAAW,KAAK,SAAS,UAAU,CAAC,IACnD,KAAK,SAAS,UAAU,IACxB,KAAK,SAAS,WAAW;AAC7B,MAAM,UAAU,WAAW,KAAK,SAAS,eAAe,CAAC,IACrD,KAAK,SAAS,eAAe,IAC7B,KAAK,SAAS,mBAAmB;AAErC,IAAI,WAAW,UAAU,GAAG;AAC1B,eAAa,YAAY,KAAK,WAAW,QAAQ,OAAO,KAAK,CAAC;AAChE;AAEA,IAAI,WAAW,OAAO,GAAG;AACvB,eAAa,SAAS,KAAK,WAAW,QAAQ,OAAO,YAAY,CAAC;AACpE;AAEA,QAAQ,IAAI,8BAA8B,OAAO,sBAAsB;"}

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @happyvertical/email
+ *
+ * Low-level email protocol operations with adapter-based architecture.
+ * Supports SMTP, IMAP, POP3, and Gmail API protocols.
+ */
+export { GmailAdapter } from './adapters/gmail.js';
+export { IMAPAdapter } from './adapters/imap.js';
+export { POP3Adapter } from './adapters/pop3.js';
+export { SMTPAdapter } from './adapters/smtp.js';
+export { BaseEmailClient } from './shared/base.js';
+export { AttachmentError, AuthenticationError, AuthorizationError, ConnectionError, EmailError, FolderExistsError, FolderNotFoundError, InvalidMessageError, MessageNotFoundError, SendError, TimeoutError, } from './shared/errors.js';
+export { getEmailClient, isGmailOptions, isIMAPOptions, isPOP3Options, isSMTPOptions, } from './shared/factory.js';
+export type { AdapterType, Attachment, EmailAddress, EmailClient, EmailClientCapabilities, EmailClientConfig, EmailMessage, FetchOptions, Folder, FolderInfo, FolderSpecialUse, GetEmailClientOptions, GmailOptions, IMAPOptions, MessageFlag, POP3Options, SearchCriteria, SendOptions, SendResult, SMTPOptions, } from './shared/types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,UAAU,EACV,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,SAAS,EACT,YAAY,GACb,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,cAAc,EACd,cAAc,EACd,aAAa,EACb,aAAa,EACb,aAAa,GACd,MAAM,qBAAqB,CAAC;AAG7B,YAAY,EACV,WAAW,EACX,UAAU,EACV,YAAY,EACZ,WAAW,EACX,uBAAuB,EACvB,iBAAiB,EACjB,YAAY,EACZ,YAAY,EACZ,MAAM,EACN,UAAU,EACV,gBAAgB,EAChB,qBAAqB,EACrB,YAAY,EACZ,WAAW,EACX,WAAW,EACX,WAAW,EACX,cAAc,EACd,WAAW,EACX,UAAU,EACV,WAAW,GACZ,MAAM,mBAAmB,CAAC"}