@invoiceleaf/integration-smtp-mail 1.0.1

package/README.md

@@ -0,0 +1,21 @@
+# SMTP Mail Integration
+
+SMTP + IMAP integration for InvoiceLeaf.
+
+## Features
+
+- Action: Send email through SMTP
+- Scheduled trigger: Crawl IMAP mailbox for PDF attachments
+- Automatic import of discovered PDFs into InvoiceLeaf
+- Dedupe based on message UID + attachment checksum
+
+## Notes
+
+- SMTP is used for outbound sending.
+- IMAP is used for mailbox crawling.
+- This integration requires runtime support for:
+  - `context.data.importDocument(...)`
+  - `context.state.get/set/delete(...)`
+  - `context.email.sendSmtpEmail(...)`
+  - `context.email.testSmtpImapConnection(...)`
+  - `context.email.crawlImapPdfAttachments(...)`

package/dist/handlers/crawlPdfAttachments.d.ts

@@ -0,0 +1,4 @@
+import type { IntegrationHandler, ScheduleInput } from '@invoiceleaf/integration-sdk';
+import type { CrawlResult, SmtpMailConfig } from '../types.js';
+export declare const crawlPdfAttachments: IntegrationHandler<ScheduleInput, CrawlResult, SmtpMailConfig>;
+//# sourceMappingURL=crawlPdfAttachments.d.ts.map

package/dist/handlers/crawlPdfAttachments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crawlPdfAttachments.d.ts","sourceRoot":"","sources":["../../src/handlers/crawlPdfAttachments.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAsB,kBAAkB,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC1G,OAAO,KAAK,EAAE,WAAW,EAAwB,cAAc,EAAE,MAAM,aAAa,CAAC;AA2DrF,eAAO,MAAM,mBAAmB,EAAE,kBAAkB,CAAC,aAAa,EAAE,WAAW,EAAE,cAAc,CAuE9F,CAAC"}

package/dist/handlers/crawlPdfAttachments.js

@@ -0,0 +1,110 @@
+import { buildAttachmentStateKey } from '../utils/dedupe.js';
+function getPrefix(config) {
+    return config.stateKeyPrefix || 'smtp-mail';
+}
+function getDedupeTtlSeconds(config) {
+    return config.dedupeTtlSeconds && config.dedupeTtlSeconds > 0
+        ? config.dedupeTtlSeconds
+        : 90 * 24 * 60 * 60;
+}
+function getImportSource(config) {
+    return config.importSource || 'smtp-mail';
+}
+async function importAttachment(context, attachment, stateKey, ttlSeconds) {
+    const existing = await context.state.get(stateKey);
+    if (existing) {
+        return 'duplicate';
+    }
+    try {
+        const result = await context.data.importDocument({
+            fileName: attachment.fileName,
+            contentType: attachment.contentType,
+            contentBase64: attachment.contentBase64,
+            source: getImportSource(context.config),
+            externalRef: `${attachment.uid}:${attachment.fileName}:${attachment.checksum}`,
+            metadata: {
+                uid: attachment.uid,
+                subject: attachment.subject,
+                from: attachment.from,
+                date: attachment.date,
+            },
+        });
+        if (result.duplicate) {
+            return 'duplicate';
+        }
+        await context.state.set(stateKey, result.documentId, { ttlSeconds });
+        return 'imported';
+    }
+    catch (error) {
+        context.logger.error('Attachment import failed', {
+            uid: attachment.uid,
+            fileName: attachment.fileName,
+            error: error.message,
+        });
+        return 'failed';
+    }
+}
+export const crawlPdfAttachments = async (input, context) => {
+    const result = {
+        success: true,
+        scannedMessages: 0,
+        scannedAttachments: 0,
+        imported: 0,
+        duplicates: 0,
+        skipped: 0,
+        failed: 0,
+    };
+    const maxMessages = context.config.maxMessagesPerRun || 100;
+    const maxAttachments = context.config.maxAttachmentsPerMessage || 10;
+    const statePrefix = getPrefix(context.config);
+    const dedupeTtlSeconds = getDedupeTtlSeconds(context.config);
+    try {
+        context.logger.info('Starting SMTP crawl run', {
+            scheduledTime: input.scheduledTime,
+            maxMessages,
+            maxAttachments,
+        });
+        const crawl = await context.email.crawlImapPdfAttachments({
+            imapHost: context.config.imapHost,
+            imapPort: context.config.imapPort,
+            imapSecure: context.config.imapSecure,
+            imapUsername: context.config.imapUsername,
+            imapPassword: context.config.imapPassword,
+            imapFolder: context.config.imapFolder || 'INBOX',
+            searchFilter: context.config.searchFilter,
+            maxMessagesPerRun: maxMessages,
+            maxAttachmentsPerMessage: maxAttachments,
+            markAsSeen: true,
+            moveToFolder: context.config.processedFolder,
+        });
+        result.scannedMessages = crawl.messages;
+        result.scannedAttachments = crawl.attachments;
+        if (crawl.items.length === 0) {
+            result.skipped = crawl.messages;
+        }
+        for (const attachment of crawl.items) {
+            const stateKey = buildAttachmentStateKey(statePrefix, attachment);
+            const status = await importAttachment(context, attachment, stateKey, dedupeTtlSeconds);
+            if (status === 'imported') {
+                result.imported += 1;
+            }
+            else if (status === 'duplicate') {
+                result.duplicates += 1;
+            }
+            else {
+                result.failed += 1;
+            }
+            await context.state.set(`${statePrefix}:lastProcessedUid`, attachment.uid, {
+                ttlSeconds: dedupeTtlSeconds,
+            });
+        }
+    }
+    catch (error) {
+        result.success = false;
+        result.error = `Crawl failed: ${error.message}`;
+        context.logger.error('SMTP crawl failed', { error: error.message });
+    }
+    result.message = `Scanned ${result.scannedMessages} messages, imported ${result.imported} PDFs`;
+    return result;
+};
+//# sourceMappingURL=crawlPdfAttachments.js.map

package/dist/handlers/crawlPdfAttachments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crawlPdfAttachments.js","sourceRoot":"","sources":["../../src/handlers/crawlPdfAttachments.ts"],"names":[],"mappings":"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"}

package/dist/handlers/index.d.ts

@@ -0,0 +1,4 @@
+export { sendEmail } from './sendEmail.js';
+export { testConnection } from './testConnection.js';
+export { crawlPdfAttachments } from './crawlPdfAttachments.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/handlers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/handlers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/handlers/index.js

@@ -0,0 +1,4 @@
+export { sendEmail } from './sendEmail.js';
+export { testConnection } from './testConnection.js';
+export { crawlPdfAttachments } from './crawlPdfAttachments.js';
+//# sourceMappingURL=index.js.map

package/dist/handlers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/handlers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/handlers/sendEmail.d.ts

@@ -0,0 +1,4 @@
+import type { IntegrationHandler } from '@invoiceleaf/integration-sdk';
+import type { HandlerResult, SendEmailInput, SmtpMailConfig } from '../types.js';
+export declare const sendEmail: IntegrationHandler<SendEmailInput, HandlerResult, SmtpMailConfig>;
+//# sourceMappingURL=sendEmail.d.ts.map

package/dist/handlers/sendEmail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sendEmail.d.ts","sourceRoot":"","sources":["../../src/handlers/sendEmail.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAsB,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAC3F,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGjF,eAAO,MAAM,SAAS,EAAE,kBAAkB,CAAC,cAAc,EAAE,aAAa,EAAE,cAAc,CA2CvF,CAAC"}

package/dist/handlers/sendEmail.js

@@ -0,0 +1,41 @@
+import { toAddressList } from '../utils/dedupe.js';
+export const sendEmail = async (input, context) => {
+    try {
+        if (!input.subject || (!input.text && !input.html)) {
+            return {
+                success: false,
+                error: 'subject and at least one body field (text or html) are required',
+            };
+        }
+        const result = await context.email.sendSmtpEmail({
+            smtpHost: context.config.smtpHost,
+            smtpPort: context.config.smtpPort,
+            smtpSecure: context.config.smtpSecure,
+            smtpUsername: context.config.smtpUsername,
+            smtpPassword: context.config.smtpPassword,
+            fromAddress: context.config.fromAddress,
+            to: toAddressList(input.to),
+            cc: toAddressList(input.cc),
+            bcc: toAddressList(input.bcc),
+            replyTo: input.replyTo,
+            subject: input.subject,
+            text: input.text,
+            html: input.html,
+            attachments: input.attachments,
+        });
+        context.logger.info('SMTP sendEmail succeeded', { messageId: result.messageId });
+        return {
+            success: true,
+            message: 'Email sent successfully',
+            details: { messageId: result.messageId },
+        };
+    }
+    catch (error) {
+        context.logger.error('SMTP sendEmail failed', { error: error.message });
+        return {
+            success: false,
+            error: `Failed to send email: ${error.message}`,
+        };
+    }
+};
+//# sourceMappingURL=sendEmail.js.map

package/dist/handlers/sendEmail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sendEmail.js","sourceRoot":"","sources":["../../src/handlers/sendEmail.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,MAAM,CAAC,MAAM,SAAS,GAAsE,KAAK,EAC/F,KAAK,EACL,OAA2C,EACnB,EAAE;IAC1B,IAAI,CAAC;QACH,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACnD,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,iEAAiE;aACzE,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC;YAC/C,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,QAAQ;YACjC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,QAAQ;YACjC,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,UAAU;YACrC,YAAY,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY;YACzC,YAAY,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY;YACzC,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW;YACvC,EAAE,EAAE,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3B,EAAE,EAAE,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3B,GAAG,EAAE,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC;YAC7B,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,WAAW,EAAE,KAAK,CAAC,WAAW;SAC/B,CAAC,CAAC;QAEH,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,0BAA0B,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;QAEjF,OAAO;YACL,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,yBAAyB;YAClC,OAAO,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE;SACzC,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,uBAAuB,EAAE,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;QACnF,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,yBAA0B,KAAe,CAAC,OAAO,EAAE;SAC3D,CAAC;IACJ,CAAC;AACH,CAAC,CAAC"}

package/dist/handlers/testConnection.d.ts

@@ -0,0 +1,4 @@
+import type { IntegrationHandler } from '@invoiceleaf/integration-sdk';
+import type { HandlerResult, SmtpMailConfig } from '../types.js';
+export declare const testConnection: IntegrationHandler<unknown, HandlerResult, SmtpMailConfig>;
+//# sourceMappingURL=testConnection.d.ts.map

package/dist/handlers/testConnection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testConnection.d.ts","sourceRoot":"","sources":["../../src/handlers/testConnection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAsB,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAC3F,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAEjE,eAAO,MAAM,cAAc,EAAE,kBAAkB,CAAC,OAAO,EAAE,aAAa,EAAE,cAAc,CA8BrF,CAAC"}

package/dist/handlers/testConnection.js

@@ -0,0 +1,29 @@
+export const testConnection = async (_input, context) => {
+    try {
+        await context.email.testSmtpImapConnection({
+            smtpHost: context.config.smtpHost,
+            smtpPort: context.config.smtpPort,
+            smtpSecure: context.config.smtpSecure,
+            smtpUsername: context.config.smtpUsername,
+            smtpPassword: context.config.smtpPassword,
+            imapHost: context.config.imapHost,
+            imapPort: context.config.imapPort,
+            imapSecure: context.config.imapSecure,
+            imapUsername: context.config.imapUsername,
+            imapPassword: context.config.imapPassword,
+            imapFolder: context.config.imapFolder || 'INBOX',
+        });
+        return {
+            success: true,
+            message: 'SMTP and IMAP connections are valid',
+        };
+    }
+    catch (error) {
+        context.logger.error('Connection test failed', { error: error.message });
+        return {
+            success: false,
+            error: `Connection test failed: ${error.message}`,
+        };
+    }
+};
+//# sourceMappingURL=testConnection.js.map

package/dist/handlers/testConnection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testConnection.js","sourceRoot":"","sources":["../../src/handlers/testConnection.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,cAAc,GAA+D,KAAK,EAC7F,MAAM,EACN,OAA2C,EACnB,EAAE;IAC1B,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,KAAK,CAAC,sBAAsB,CAAC;YACzC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,QAAQ;YACjC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,QAAQ;YACjC,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,UAAU;YACrC,YAAY,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY;YACzC,YAAY,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY;YACzC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,QAAQ;YACjC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,QAAQ;YACjC,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,UAAU;YACrC,YAAY,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY;YACzC,YAAY,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY;YACzC,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,UAAU,IAAI,OAAO;SACjD,CAAC,CAAC;QAEH,OAAO;YACL,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,qCAAqC;SAC/C,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,wBAAwB,EAAE,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;QACpF,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,2BAA4B,KAAe,CAAC,OAAO,EAAE;SAC7D,CAAC;IACJ,CAAC;AACH,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * SMTP Mail integration handler exports.
+ * Manifest is defined in manifest.json at package root.
+ */
+export { sendEmail, testConnection, crawlPdfAttachments } from './handlers/index.js';
+export type { SmtpMailConfig, SendEmailInput, SendEmailAttachmentInput, HandlerResult, CrawlResult, } from './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;;;GAGG;AACH,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAErF,YAAY,EACV,cAAc,EACd,cAAc,EACd,wBAAwB,EACxB,aAAa,EACb,WAAW,GACZ,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+/**
+ * SMTP Mail integration handler exports.
+ * Manifest is defined in manifest.json at package root.
+ */
+export { sendEmail, testConnection, crawlPdfAttachments } from './handlers/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,61 @@
+export interface SmtpMailConfig {
+    smtpHost: string;
+    smtpPort: number;
+    smtpSecure?: boolean;
+    smtpUsername: string;
+    smtpPassword: string;
+    fromAddress: string;
+    imapHost: string;
+    imapPort: number;
+    imapSecure?: boolean;
+    imapUsername: string;
+    imapPassword: string;
+    imapFolder?: string;
+    processedFolder?: string;
+    searchFilter?: string;
+    maxMessagesPerRun?: number;
+    maxAttachmentsPerMessage?: number;
+    stateKeyPrefix?: string;
+    dedupeTtlSeconds?: number;
+    importSource?: string;
+}
+export interface SendEmailAttachmentInput {
+    fileName: string;
+    contentType?: string;
+    contentBase64: string;
+}
+export interface SendEmailInput {
+    to: string | string[];
+    cc?: string | string[];
+    bcc?: string | string[];
+    subject: string;
+    text?: string;
+    html?: string;
+    replyTo?: string;
+    attachments?: SendEmailAttachmentInput[];
+}
+export interface HandlerResult {
+    success: boolean;
+    message?: string;
+    error?: string;
+    details?: Record<string, unknown>;
+}
+export interface CrawledPdfAttachment {
+    uid: number;
+    fileName: string;
+    contentType: string;
+    contentBase64: string;
+    checksum: string;
+    subject?: string;
+    from?: string;
+    date?: string;
+}
+export interface CrawlResult extends HandlerResult {
+    scannedMessages: number;
+    scannedAttachments: number;
+    imported: number;
+    duplicates: number;
+    skipped: number;
+    failed: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IAEpB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAElC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACtB,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,wBAAwB,EAAE,CAAC;CAC1C;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAY,SAAQ,aAAa;IAChD,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/dist/utils/dedupe.d.ts

@@ -0,0 +1,4 @@
+import type { CrawledPdfAttachment } from '../types.js';
+export declare function toAddressList(value?: string | string[]): string[];
+export declare function buildAttachmentStateKey(prefix: string, attachment: CrawledPdfAttachment): string;
+//# sourceMappingURL=dedupe.d.ts.map

package/dist/utils/dedupe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dedupe.d.ts","sourceRoot":"","sources":["../../src/utils/dedupe.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAExD,wBAAgB,aAAa,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,CAKjE;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,oBAAoB,GAAG,MAAM,CAEhG"}

package/dist/utils/dedupe.js

@@ -0,0 +1,10 @@
+export function toAddressList(value) {
+    if (!value) {
+        return [];
+    }
+    return Array.isArray(value) ? value : [value];
+}
+export function buildAttachmentStateKey(prefix, attachment) {
+    return `${prefix}:att:${attachment.uid}:${attachment.fileName}:${attachment.checksum}`;
+}
+//# sourceMappingURL=dedupe.js.map

package/dist/utils/dedupe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dedupe.js","sourceRoot":"","sources":["../../src/utils/dedupe.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,aAAa,CAAC,KAAyB;IACrD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,MAAc,EAAE,UAAgC;IACtF,OAAO,GAAG,MAAM,QAAQ,UAAU,CAAC,GAAG,IAAI,UAAU,CAAC,QAAQ,IAAI,UAAU,CAAC,QAAQ,EAAE,CAAC;AACzF,CAAC"}

package/manifest.json

@@ -0,0 +1,182 @@
+{
+  "id": "integration-smtp-mail",
+  "name": "SMTP Mail",
+  "description": "Send email through SMTP and crawl IMAP inboxes for PDF attachments to import into InvoiceLeaf.",
+  "version": "1.0.0",
+  "author": {
+    "name": "InvoiceLeaf",
+    "email": "support@invoiceleaf.com",
+    "url": "https://invoiceleaf.com"
+  },
+  "icon": "mail",
+  "category": "communication",
+  "tags": ["smtp", "imap", "email", "inbox", "attachments"],
+  "dataAccess": ["documents"],
+  "externalAuth": [],
+  "triggers": [
+    {
+      "id": "crawl-email-pdf-attachments",
+      "type": "schedule",
+      "name": "Crawl Email PDF Attachments",
+      "description": "Checks IMAP mailbox for PDF attachments and imports them into InvoiceLeaf",
+      "schedule": "*/15 * * * *",
+      "handler": "crawlPdfAttachments",
+      "configurable": true
+    }
+  ],
+  "actions": [
+    {
+      "id": "send-email",
+      "name": "Send Email",
+      "description": "Send an email through SMTP",
+      "handler": "sendEmail",
+      "icon": "send"
+    },
+    {
+      "id": "test-connection",
+      "name": "Test SMTP/IMAP Connection",
+      "description": "Verify SMTP and IMAP credentials",
+      "handler": "testConnection",
+      "icon": "check"
+    }
+  ],
+  "configSchema": {
+    "type": "object",
+    "properties": {
+      "smtpHost": {
+        "type": "string",
+        "title": "SMTP Host",
+        "description": "SMTP server hostname (for example, smtp.office365.com)"
+      },
+      "smtpPort": {
+        "type": "number",
+        "title": "SMTP Port",
+        "default": 587,
+        "minimum": 1,
+        "maximum": 65535
+      },
+      "smtpSecure": {
+        "type": "boolean",
+        "title": "SMTP Secure (TLS)",
+        "description": "Use secure SMTP transport (usually true for port 465)",
+        "default": false
+      },
+      "smtpUsername": {
+        "type": "string",
+        "title": "SMTP Username"
+      },
+      "smtpPassword": {
+        "type": "string",
+        "title": "SMTP Password",
+        "format": "password"
+      },
+      "fromAddress": {
+        "type": "string",
+        "title": "From Address",
+        "format": "email"
+      },
+      "imapHost": {
+        "type": "string",
+        "title": "IMAP Host",
+        "description": "IMAP server hostname (for example, outlook.office365.com)"
+      },
+      "imapPort": {
+        "type": "number",
+        "title": "IMAP Port",
+        "default": 993,
+        "minimum": 1,
+        "maximum": 65535
+      },
+      "imapSecure": {
+        "type": "boolean",
+        "title": "IMAP Secure (TLS)",
+        "default": true
+      },
+      "imapUsername": {
+        "type": "string",
+        "title": "IMAP Username"
+      },
+      "imapPassword": {
+        "type": "string",
+        "title": "IMAP Password",
+        "format": "password"
+      },
+      "imapFolder": {
+        "type": "string",
+        "title": "IMAP Folder",
+        "default": "INBOX"
+      },
+      "processedFolder": {
+        "type": "string",
+        "title": "Processed Folder",
+        "description": "Optional destination folder after successful import"
+      },
+      "searchFilter": {
+        "type": "string",
+        "title": "Search Filter",
+        "description": "Supported values: UNSEEN, SEEN, ALL",
+        "default": "UNSEEN"
+      },
+      "maxMessagesPerRun": {
+        "type": "number",
+        "title": "Max Messages Per Run",
+        "default": 100,
+        "minimum": 1,
+        "maximum": 500
+      },
+      "maxAttachmentsPerMessage": {
+        "type": "number",
+        "title": "Max Attachments Per Message",
+        "default": 10,
+        "minimum": 1,
+        "maximum": 50
+      },
+      "stateKeyPrefix": {
+        "type": "string",
+        "title": "State Key Prefix",
+        "default": "smtp-mail"
+      },
+      "dedupeTtlSeconds": {
+        "type": "number",
+        "title": "Dedupe TTL (seconds)",
+        "default": 7776000,
+        "minimum": 3600
+      },
+      "importSource": {
+        "type": "string",
+        "title": "Import Source",
+        "default": "smtp-mail"
+      }
+    },
+    "required": [
+      "smtpHost",
+      "smtpPort",
+      "smtpUsername",
+      "smtpPassword",
+      "fromAddress",
+      "imapHost",
+      "imapPort",
+      "imapUsername",
+      "imapPassword"
+    ]
+  },
+  "ui": {
+    "configGroups": [
+      {
+        "title": "SMTP",
+        "description": "Configure outbound email delivery",
+        "fields": ["smtpHost", "smtpPort", "smtpSecure", "smtpUsername", "smtpPassword", "fromAddress"]
+      },
+      {
+        "title": "IMAP",
+        "description": "Configure inbox crawling",
+        "fields": ["imapHost", "imapPort", "imapSecure", "imapUsername", "imapPassword", "imapFolder", "processedFolder", "searchFilter"]
+      },
+      {
+        "title": "Crawler Limits",
+        "description": "Control per-run workload and dedupe",
+        "fields": ["maxMessagesPerRun", "maxAttachmentsPerMessage", "stateKeyPrefix", "dedupeTtlSeconds", "importSource"]
+      }
+    ]
+  }
+}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@invoiceleaf/integration-smtp-mail",
+  "version": "1.0.1",
+  "description": "SMTP + IMAP integration for InvoiceLeaf: send emails and crawl PDF attachments for import",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run clean && npm run build",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "invoiceleaf",
+    "integration",
+    "smtp",
+    "imap",
+    "email"
+  ],
+  "author": "InvoiceLeaf <support@invoiceleaf.com>",
+  "license": "MIT",
+  "peerDependencies": {
+    "@invoiceleaf/integration-sdk": "^1.5.0"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "@invoiceleaf/integration-sdk": "file:../../integration-sdk",
+    "@types/node": "^22.10.0",
+    "typescript": "^5.7.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "files": [
+    "dist",
+    "manifest.json",
+    "README.md"
+  ]
+}