@nocobase/app-plugin-mail 1.0.0-beta.12 → 1.0.0-beta.14

package/dist/database/migrations/202610090001_mail_create_message_participants.js

@@ -0,0 +1,167 @@
+import { defineMigration, } from '@nocobase/db';
+// These rules belong to this historical migration, not the live address parser.
+function normalizeAddress(value) {
+    if (typeof value !== 'string')
+        return undefined;
+    if (/[^\u0021-\u007e]/.test(value.trim()))
+        return undefined;
+    const address = value.trim().toLowerCase();
+    if (address.length > 320)
+        return undefined;
+    const at = address.indexOf('@');
+    if (at <= 0 || at !== address.lastIndexOf('@'))
+        return undefined;
+    const local = address.slice(0, at);
+    if (local.length > 64 ||
+        !/^[a-z0-9!#$%&'*+\-/=?^_`{|}~]+(?:\.[a-z0-9!#$%&'*+\-/=?^_`{|}~]+)*$/.test(local))
+        return undefined;
+    const domain = address.slice(at + 1);
+    if (domain.length > 253 || !domain.includes('.'))
+        return undefined;
+    if (domain
+        .split('.')
+        .some((label) => label.length === 0 ||
+        label.length > 63 ||
+        !/^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$/.test(label)))
+        return undefined;
+    return { address, domain };
+}
+const migration = defineMigration({
+    name: '202610090001_mail_create_message_participants',
+    async up({ builder, query }) {
+        await builder.createCollection('mailMessageParticipants', (collection) => {
+            collection.uuid('messageId', { nullable: false });
+            collection.uuid('accountId', { nullable: false });
+            collection.string('role', { length: 4, nullable: false });
+            collection.string('address', { length: 320, nullable: false });
+            collection.string('domain', { length: 253, nullable: false });
+            collection.primary(['messageId', 'role', 'address'], {
+                name: 'mail_participants_pk',
+            });
+            collection.index(['accountId', 'address', 'messageId'], {
+                name: 'mail_participants_address_idx',
+            });
+            collection.index(['accountId', 'domain', 'messageId'], {
+                name: 'mail_participants_domain_idx',
+            });
+            // One cascade path only: the owning message already belongs to an account.
+            collection.foreignKey('messageId', {
+                references: { collection: 'mailMessages', fields: ['id'] },
+                onDelete: 'cascade',
+            });
+        });
+        let skippedAddresses = 0;
+        let malformedValues = 0;
+        const object = (value) => {
+            if (value == null)
+                return undefined;
+            if (typeof value === 'string') {
+                try {
+                    value = JSON.parse(value);
+                }
+                catch {
+                    malformedValues += 1;
+                    return undefined;
+                }
+            }
+            if (value === null)
+                return undefined;
+            if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+                malformedValues += 1;
+                return undefined;
+            }
+            return value;
+        };
+        try {
+            let after;
+            while (true) {
+                let page = query
+                    .selectFrom('mailMessages')
+                    .select(['id', 'accountId', 'sender', 'recipients'])
+                    .orderBy('id', 'asc')
+                    .limit(100);
+                if (after)
+                    page = page.where('id', '>', after);
+                const messages = await page.execute();
+                if (messages.length === 0)
+                    break;
+                let batch = [];
+                for (const message of messages) {
+                    const sender = object(message.sender);
+                    const recipients = object(message.recipients);
+                    const seen = new Set();
+                    const candidates = [];
+                    if (sender)
+                        candidates.push(['from', sender]);
+                    for (const role of ['to', 'cc']) {
+                        const list = recipients?.[role];
+                        if (list === undefined)
+                            continue;
+                        if (!Array.isArray(list)) {
+                            malformedValues += 1;
+                            continue;
+                        }
+                        for (const value of list)
+                            candidates.push([role, value]);
+                    }
+                    for (const [role, candidate] of candidates) {
+                        const value = candidate !== null &&
+                            typeof candidate === 'object' &&
+                            !Array.isArray(candidate)
+                            ? candidate
+                            : undefined;
+                        const normalized = normalizeAddress(value?.address);
+                        if (!normalized) {
+                            skippedAddresses += 1;
+                            continue;
+                        }
+                        const key = `${role}:${normalized.address}`;
+                        if (seen.has(key))
+                            continue;
+                        seen.add(key);
+                        batch.push({
+                            messageId: message.id,
+                            accountId: message.accountId,
+                            role,
+                            ...normalized,
+                        });
+                        // Five bindings per row; a large To/Cc list must not exceed parameter limits.
+                        if (batch.length === 100) {
+                            await query
+                                .insertInto('mailMessageParticipants')
+                                .values(batch)
+                                .execute();
+                            batch = [];
+                        }
+                    }
+                }
+                if (batch.length > 0)
+                    await query
+                        .insertInto('mailMessageParticipants')
+                        .values(batch)
+                        .execute();
+                after = messages.at(-1)?.id;
+            }
+        }
+        catch (error) {
+            // MySQL and other non-transactional DDL dialects need explicit failed-backfill cleanup.
+            // No source message was changed, so the migration can be retried from its original JSON.
+            try {
+                await builder.dropCollection('mailMessageParticipants');
+            }
+            catch (cleanupError) {
+                throw new AggregateError([error, cleanupError], 'Mail participant backfill and cleanup failed.', { cause: cleanupError });
+            }
+            throw error;
+        }
+        if (skippedAddresses > 0 || malformedValues > 0) {
+            process.emitWarning(`Mail participant backfill skipped ${skippedAddresses} invalid addresses and ${malformedValues} malformed values.`, { code: 'MAIL_PARTICIPANT_BACKFILL_SKIPPED' });
+        }
+    },
+    async down({ builder }) {
+        await builder.dropCollection('mailMessageParticipants');
+    },
+});
+export default migration;
+//# sourceMappingURL=202610090001_mail_create_message_participants.js.map
+// @nocobase/task-manifest v1

package/dist/database/migrations/202610090001_mail_create_message_participants.js.map

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

package/dist/database/migrations/202610250001_mail_imap_message_locations.d.ts

@@ -0,0 +1,4 @@
+import { type MigrationDefinition } from '@nocobase/db';
+declare const migration: MigrationDefinition;
+export default migration;
+//# sourceMappingURL=202610250001_mail_imap_message_locations.d.ts.map

package/dist/database/migrations/202610250001_mail_imap_message_locations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"202610250001_mail_imap_message_locations.d.ts","sourceRoot":"","sources":["../../../database/migrations/202610250001_mail_imap_message_locations.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,mBAAmB,EAEzB,MAAM,cAAc,CAAC;AAoKtB,QAAA,MAAM,SAAS,EAAE,mBA8Lf,CAAC;AAEH,eAAe,SAAS,CAAC"}

package/dist/database/migrations/202610250001_mail_imap_message_locations.js

@@ -0,0 +1,297 @@
+import { randomUUID } from 'node:crypto';
+import { defineMigration, } from '@nocobase/db';
+// Rollback cannot discard mail business data or its location ownership.
+const MESSAGE_TABLES = [
+    'mailMessages',
+    'mailMessageFolders',
+    'mailMessageLabels',
+    'mailMessageParticipants',
+    'mailSyncTombstones',
+    'mailDraftStates',
+    'mailSubmissions',
+    'mailOutboundAttachments',
+    'mailSyncStates',
+    'mailSyncRuns',
+    'mailOutbox',
+    'mailPushPending',
+    'mailAccountRemovals',
+];
+async function assertNoMessages(query, action) {
+    for (const table of MESSAGE_TABLES) {
+        const row = await query.selectFrom(table).selectAll().limit(1).execute();
+        if (row.length > 0)
+            throw new Error(`Cannot ${action} IMAP message locations while ${table} contains data. Rollback would lose mail business data.`);
+    }
+}
+function legacyCopy(message) {
+    const mirror = message.providerMessageId.startsWith('local-draft:');
+    const identity = mirror
+        ? message.providerDraftMessageId
+        : message.providerMessageId;
+    // SMTP accepted RFC IDs and local-only drafts have no recorded remote tuple.
+    if (!identity?.startsWith('imap:'))
+        return undefined;
+    const fail = (reason) => {
+        throw new Error(`Cannot upgrade legacy IMAP message ${message.id}: ${reason}.`);
+    };
+    if (!message.ownerId)
+        fail('missing owning account');
+    if (message.providerType !== 'imap-smtp')
+        return undefined;
+    if (identity.length > 500)
+        fail('locator exceeds identity capacity');
+    let parsed;
+    try {
+        const encoded = identity.slice(5);
+        const bytes = Buffer.from(encoded, 'base64url');
+        if (!encoded || bytes.toString('base64url') !== encoded)
+            return fail('invalid locator encoding');
+        if (!Buffer.from(bytes.toString('utf8'), 'utf8').equals(bytes))
+            return fail('invalid locator encoding');
+        const value = JSON.parse(bytes.toString('utf8'));
+        if (!value || typeof value !== 'object' || Array.isArray(value))
+            return fail('invalid locator object');
+        parsed = value;
+    }
+    catch {
+        return fail('invalid locator encoding');
+    }
+    const { folder, uidValidity, uid } = parsed;
+    if (typeof folder !== 'string' ||
+        !folder.length ||
+        folder.length > 500 ||
+        folder.includes('\0'))
+        return fail('invalid folder path');
+    if (typeof uidValidity !== 'string' ||
+        !/^[1-9]\d{0,9}$/.test(uidValidity) ||
+        BigInt(uidValidity) > 4294967295n)
+        return fail('invalid UIDVALIDITY');
+    if (typeof uid !== 'number' ||
+        !Number.isSafeInteger(uid) ||
+        uid < 1 ||
+        uid > 4294967295)
+        return fail('invalid UID');
+    return {
+        message,
+        sourceField: mirror ? 'providerDraftMessageIdSource' : 'imapIdSource',
+        folder,
+        uidValidity,
+        uid,
+    };
+}
+/** Two bounded scans: preflight before DDL, then copy only recorded local facts. */
+async function legacyCopies(query, visit) {
+    let last;
+    for (;;) {
+        let selection = query
+            .selectFrom('mailMessages')
+            .leftJoin('mailAccounts', 'mailAccounts.id', 'mailMessages.accountId')
+            .select([
+            'mailMessages.id',
+            'mailMessages.accountId',
+            'mailAccounts.id as ownerId',
+            'mailAccounts.providerType',
+            'mailMessages.providerMessageId',
+            'mailMessages.providerDraftMessageId',
+            'mailMessages.read',
+            'mailMessages.starred',
+            'mailMessages.receivedAt',
+            'mailMessages.createdAt',
+            'mailMessages.updatedAt',
+        ])
+            .orderBy('mailMessages.accountId')
+            .orderBy('mailMessages.id')
+            .limit(100);
+        if (last) {
+            const cursor = last;
+            selection = selection.where((builder) => builder.or([
+                builder('mailMessages.accountId', '>', cursor.accountId),
+                builder.and([
+                    builder('mailMessages.accountId', '=', cursor.accountId),
+                    builder('mailMessages.id', '>', cursor.id),
+                ]),
+            ]));
+        }
+        const rows = await selection.execute();
+        if (!rows.length)
+            return;
+        await visit(rows.flatMap((row) => {
+            const copy = legacyCopy(row);
+            return copy ? [copy] : [];
+        }));
+        last = rows.at(-1);
+    }
+}
+const migration = defineMigration({
+    name: '202610250001_mail_imap_message_locations',
+    async up({ builder, query, connection }) {
+        let accountId;
+        const owners = new Map();
+        await legacyCopies(query, async (copies) => {
+            for (const copy of copies) {
+                if (accountId !== copy.message.accountId) {
+                    owners.clear();
+                    accountId = copy.message.accountId;
+                }
+                const tuple = JSON.stringify([copy.folder, copy.uidValidity, copy.uid]);
+                const owner = owners.get(tuple);
+                if (owner && owner !== copy.message.id)
+                    throw new Error(`Cannot upgrade legacy IMAP message ${copy.message.id}: tuple belongs to message ${owner}.`);
+                owners.set(tuple, copy.message.id);
+            }
+        });
+        // SQLite rebuilds a table when changing its column type. Detach only the
+        // incoming Mail foreign keys so that dropping that table cannot cascade.
+        // The migration transaction restores both schema and data on any failure.
+        const incoming = [
+            [
+                'mailMessageFolders',
+                'fk_mail_message_folders_message_id_mail_messages',
+                'messageId',
+                'mailMessages',
+            ],
+            [
+                'mailMessageLabels',
+                'fk_mail_message_labels_message_id_mail_messages',
+                'messageId',
+                'mailMessages',
+            ],
+            // Restore both label constraints in their original order as well.
+            [
+                'mailMessageLabels',
+                'fk_mail_message_labels_label_id_mail_labels',
+                'labelId',
+                'mailLabels',
+            ],
+            [
+                'mailMessageParticipants',
+                'fk_mail_message_participants_message_id_mail_messages',
+                'messageId',
+                'mailMessages',
+            ],
+        ];
+        const detach = connection.dialect === 'sqlite' &&
+            (await query.selectFrom('mailMessages').select('id').limit(1).execute())
+                .length > 0;
+        if (detach) {
+            for (const [table, name] of incoming) {
+                await builder.alterCollection(table, (collection) => collection.dropConstraint(name));
+            }
+        }
+        await builder.alterCollection('mailMessages', (collection) => {
+            collection.string('imapIdSource', { length: 20 });
+            collection.string('providerDraftMessageIdSource', { length: 20 });
+            collection.uuid('imapOrphanRunId');
+            // A complete RFC Message-ID header can exceed the previous 1000 characters.
+            collection.alterField('internetMessageId', {
+                type: 'text',
+                db: connection.dialect === 'mysql' ? { nativeType: 'longtext' } : {},
+            });
+            // Target of the locations' account-scoped foreign key.
+            collection.unique(['accountId', 'id'], {
+                name: 'mail_messages_account_id_unique',
+            });
+        });
+        if (detach) {
+            for (const [table, name, field, target] of incoming) {
+                await builder.alterCollection(table, (collection) => collection.foreignKey(field, {
+                    name,
+                    references: { collection: target, fields: ['id'] },
+                    onDelete: 'cascade',
+                }));
+            }
+        }
+        await builder.createCollection('mailMessageImapLocations', (collection) => {
+            collection.uuid('id').primary();
+            collection.uuid('accountId', { nullable: false });
+            collection.uuid('messageId', { nullable: false });
+            collection.string('providerFolderId', { length: 500, nullable: false });
+            // Canonical decimal UIDVALIDITY, 1 to 4294967295.
+            collection.string('uidValidity', { length: 10, nullable: false });
+            // Signed 64-bit holds every uint32 UID on every dialect.
+            collection.bigInt('uid', { nullable: false });
+            collection.string('status', { length: 10, nullable: false });
+            collection.string('invalidationReason', { length: 40 });
+            collection.boolean('read', { nullable: false, defaultValue: false });
+            collection.boolean('starred', { nullable: false, defaultValue: false });
+            collection.datetimeTz('receivedAt');
+            collection.datetimeTz('createdAt', { nullable: false });
+            collection.datetimeTz('updatedAt', { nullable: false });
+            collection.unique(['accountId', 'providerFolderId', 'uidValidity', 'uid'], {
+                name: 'mail_imap_locations_tuple_unique',
+            });
+            collection.index(['accountId', 'messageId'], {
+                name: 'mail_imap_locations_message_idx',
+            });
+            // One cascade path only: the owning message already belongs to the account.
+            collection.foreignKey(['accountId', 'messageId'], {
+                name: 'mail_imap_locations_message_fk',
+                references: {
+                    collection: 'mailMessages',
+                    fields: ['accountId', 'id'],
+                },
+                onDelete: 'cascade',
+            });
+        });
+        const now = new Date().toISOString();
+        await legacyCopies(query, async (copies) => {
+            if (!copies.length)
+                return;
+            await query
+                .insertInto('mailMessageImapLocations')
+                .values(copies.map((copy) => ({
+                id: randomUUID(),
+                accountId: copy.message.accountId,
+                messageId: copy.message.id,
+                providerFolderId: copy.folder,
+                uidValidity: copy.uidValidity,
+                uid: copy.uid,
+                status: 'valid',
+                invalidationReason: null,
+                read: copy.message.read,
+                starred: copy.message.starred,
+                receivedAt: copy.message.receivedAt,
+                createdAt: copy.message.createdAt ?? now,
+                updatedAt: copy.message.updatedAt ?? now,
+            })))
+                .execute();
+            for (const field of [
+                'imapIdSource',
+                'providerDraftMessageIdSource',
+            ]) {
+                const ids = copies
+                    .filter((copy) => copy.sourceField === field)
+                    .map((copy) => copy.message.id);
+                if (ids.length)
+                    await query
+                        .updateTable('mailMessages')
+                        .set({ [field]: 'locator' })
+                        .where('id', 'in', ids)
+                        .execute();
+            }
+        });
+    },
+    async down({ builder, query }) {
+        // Restoring the 1000-character Message-ID column must not cut stored values.
+        await assertNoMessages(query, 'remove');
+        if ((await query
+            .selectFrom('mailMessageImapLocations')
+            .selectAll()
+            .limit(1)
+            .execute()).length)
+            throw new Error('Cannot remove IMAP message locations while location business data exists.');
+        await builder.dropCollection('mailMessageImapLocations');
+        await builder.alterCollection('mailMessages', (collection) => {
+            collection.dropConstraint('mail_messages_account_id_unique');
+            collection.alterField('internetMessageId', {
+                type: 'string',
+                length: 1000,
+                db: {},
+            });
+            collection.dropFields('imapIdSource', 'providerDraftMessageIdSource', 'imapOrphanRunId');
+        });
+    },
+});
+export default migration;
+//# sourceMappingURL=202610250001_mail_imap_message_locations.js.map
+// @nocobase/task-manifest v1

package/dist/database/migrations/202610250001_mail_imap_message_locations.js.map

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

package/dist/server/adapters/imap-smtp/adapter.d.ts

@@ -1,16 +1,43 @@
+import { ImapFlow } from 'imapflow';
 import type { MailAttachmentContent, MailProviderResult, MailSyncCursor } from '../../../shared/mail.js';
 import type { MailProviderAdapter, MailProviderAccount, MailProviderContext, MailProviderFolderPage, MailProviderListChangesInput, MailProviderListFoldersInput, MailProviderListMessagesInput, MailProviderMessagePage, MailProviderSendInput, MailProviderSendResult, NormalizedMailMessage } from '../../contracts/provider.js';
-import type { ImapSmtpCredential } from './types.js';
+import type { ImapOperationSnapshot, ImapLocationPersistence, ImapSmtpCredential } from './types.js';
+import type { MailSyncStepCommit } from '../../contracts/persistence.js';
+import type { MailSyncRun } from '../../../shared/mail.js';
 import type { ImapSmtpMailProviderConfig } from './config.js';
+import { createImapClient, createSmtpTransport } from './connection.js';
 export declare class ImapSmtpAdapter implements MailProviderAdapter {
+    private readonly context;
     private readonly config;
+    private readonly account;
     private readonly credential;
+    private readonly locations?;
+    private readonly protocol;
+    private readonly operation?;
     readonly identity: MailProviderAccount['provider'];
     readonly capabilities: MailProviderAdapter['capabilities'];
     private readonly folderTypes;
     private imapClient?;
     private readonly smtpTransport;
-    constructor(_context: MailProviderContext, config: ImapSmtpMailProviderConfig, account: MailProviderAccount, credential: ImapSmtpCredential);
+    private copies;
+    private changes;
+    private cleanup;
+    private verificationIncomplete;
+    private readonly verificationCopies;
+    private readonly syncRun?;
+    private rawBudget;
+    private readonly rawCache;
+    constructor(context: MailProviderContext, config: ImapSmtpMailProviderConfig, account: MailProviderAccount, credential: ImapSmtpCredential, locations?: ImapLocationPersistence | undefined, run?: MailSyncRun, protocol?: {
+        readonly imap: typeof createImapClient;
+        readonly smtp: typeof createSmtpTransport;
+        readonly expungeUid: typeof expungeUid;
+    }, operation?: ImapOperationSnapshot | undefined);
+    forSync(run: MailSyncRun): ImapSmtpAdapter;
+    forMessage(messageId: string, providerMessageId: string, operation: 'flags' | 'delete'): Promise<ImapSmtpAdapter>;
+    /** True when this instance records message copies in the account's location table. */
+    get persistsLocations(): boolean;
+    /** Commit a sync step together with the location evidence this instance gathered for it. */
+    commitSyncStep(input: MailSyncStepCommit): Promise<MailSyncRun>;
     listFolders(input: MailProviderListFoldersInput): Promise<MailProviderResult<MailProviderFolderPage>>;
     getCurrentSyncCursor(signal?: AbortSignal): Promise<MailProviderResult<MailSyncCursor>>;
     listMessages(input: MailProviderListMessagesInput): Promise<MailProviderResult<MailProviderMessagePage>>;
@@ -21,13 +48,14 @@ export declare class ImapSmtpAdapter implements MailProviderAdapter {
         readonly hasMore: boolean;
     }>>;
     getMessage(providerMessageId: string, signal?: AbortSignal): Promise<MailProviderResult<NormalizedMailMessage>>;
-    getAttachment(_providerMessageId: string, providerAttachmentId: string, signal?: AbortSignal): Promise<MailProviderResult<MailAttachmentContent>>;
+    getAttachment(providerMessageId: string, providerAttachmentId: string, signal?: AbortSignal): Promise<MailProviderResult<MailAttachmentContent>>;
     sendMessage(input: MailProviderSendInput): Promise<MailProviderSendResult>;
     setRead(providerMessageId: string, read: boolean, signal?: AbortSignal): Promise<MailProviderResult<void>>;
     setStarred(providerMessageId: string, starred: boolean, signal?: AbortSignal): Promise<MailProviderResult<void>>;
     deleteMessage(providerMessageId: string, permanently: boolean, signal?: AbortSignal): Promise<MailProviderResult<void>>;
     close(): Promise<void>;
     private updateFlags;
+    private closeImap;
     private imap;
     private listMailboxes;
     private selectableMailboxes;
@@ -35,6 +63,35 @@ export declare class ImapSmtpAdapter implements MailProviderAdapter {
     private selectedFolderState;
     private normalizeFolder;
     private fetchMessages;
+    private beginStep;
+    /**
+     * Choose each copy's identity: its persisted location first, then the
+     * server's native ID, then an RFC Message-ID proven by identical MIME bytes,
+     * and otherwise the copy's own location.
+     */
+    private assignIdentities;
+    private nativeSource;
+    /** Compare a new copy with a verified copy already stored under this RFC Message-ID. */
+    private matchesStoredCopy;
+    private sameRawCopies;
+    /** Complete raw MIME of one copy within the per-message and per-step budgets. */
+    private rawCopy;
+    /**
+     * Select a stored copy and confirm it is still the same message. Returns
+     * undefined for a changed generation, a missing UID or another identity.
+     */
+    private openCopy;
+    private copyChanged;
+    /** Change one flag on every verified copy, committing each confirmed copy on its own. */
+    private updateCopyFlags;
+    /**
+     * One complete pass over every selectable folder. It reconciles stored
+     * copies, and two matching passes in a row authorize orphan cleanup.
+     */
+    private verifyFolders;
     private normalizeMessage;
 }
+/** ImapFlow 2.2.10's command primitive keeps the verb explicitly scoped to a UID. */
+declare function expungeUid(client: ImapFlow, uid: number): Promise<void>;
+export {};
 //# sourceMappingURL=adapter.d.ts.map

package/dist/server/adapters/imap-smtp/adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../../server/adapters/imap-smtp/adapter.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EACV,qBAAqB,EAErB,kBAAkB,EAClB,cAAc,EACf,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,sBAAsB,EACtB,4BAA4B,EAC5B,4BAA4B,EAC5B,6BAA6B,EAC7B,uBAAuB,EACvB,qBAAqB,EACrB,sBAAsB,EAEtB,qBAAqB,EACtB,MAAM,6BAA6B,CAAC;AAErC,OAAO,KAAK,EAEV,kBAAkB,EAEnB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAuC9D,qBAAa,eAAgB,YAAW,mBAAmB;IAavD,OAAO,CAAC,QAAQ,CAAC,MAAM;IAEvB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAd7B,SAAgB,QAAQ,EAAE,mBAAmB,CAAC,UAAU,CAAC,CAAC;IAC1D,SAAgB,YAAY,EAAE,mBAAmB,CAAC,cAAc,CAAC,CACxC;IACzB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAGxB;IACJ,OAAO,CAAC,UAAU,CAAC,CAAW;IAC9B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAc;gBAG1C,QAAQ,EAAE,mBAAmB,EACZ,MAAM,EAAE,0BAA0B,EACnD,OAAO,EAAE,mBAAmB,EACX,UAAU,EAAE,kBAAkB;IAMpC,WAAW,CACtB,KAAK,EAAE,4BAA4B,GAClC,OAAO,CAAC,kBAAkB,CAAC,sBAAsB,CAAC,CAAC;IAgBzC,oBAAoB,CAC/B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,kBAAkB,CAAC,cAAc,CAAC,CAAC;IAkBjC,YAAY,CACvB,KAAK,EAAE,6BAA6B,GACnC,OAAO,CAAC,kBAAkB,CAAC,uBAAuB,CAAC,CAAC;IAoJ1C,WAAW,CAAC,KAAK,EAAE,4BAA4B,GAAG,OAAO,CACpE,kBAAkB,CAAC;QACjB,QAAQ,CAAC,QAAQ,EAAE,SAAS,qBAAqB,EAAE,CAAC;QACpD,QAAQ,CAAC,yBAAyB,EAAE,SAAS,MAAM,EAAE,CAAC;QACtD,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC;QACpC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;KAC3B,CAAC,CACH;IA2IY,UAAU,CACrB,iBAAiB,EAAE,MAAM,EACzB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,kBAAkB,CAAC,qBAAqB,CAAC,CAAC;IA0CxC,aAAa,CACxB,kBAAkB,EAAE,MAAM,EAC1B,oBAAoB,EAAE,MAAM,EAC5B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,kBAAkB,CAAC,qBAAqB,CAAC,CAAC;IAgExC,WAAW,CACtB,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC,sBAAsB,CAAC;IA8IrB,OAAO,CAClB,iBAAiB,EAAE,MAAM,EACzB,IAAI,EAAE,OAAO,EACb,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAIvB,UAAU,CACrB,iBAAiB,EAAE,MAAM,EACzB,OAAO,EAAE,OAAO,EAChB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAIvB,aAAa,CACxB,iBAAiB,EAAE,MAAM,EACzB,WAAW,EAAE,OAAO,EACpB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAqBvB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAYrB,WAAW;YAmBX,IAAI;YAQJ,aAAa;IAyB3B,OAAO,CAAC,mBAAmB;YAYb,WAAW;YAyDX,mBAAmB;IA0BjC,OAAO,CAAC,eAAe;YAUT,aAAa;YA0Bb,gBAAgB;CA2E/B"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../../server/adapters/imap-smtp/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EAMT,MAAM,UAAU,CAAC;AAiBlB,OAAO,KAAK,EACV,qBAAqB,EAErB,kBAAkB,EAClB,cAAc,EACf,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,sBAAsB,EACtB,4BAA4B,EAC5B,4BAA4B,EAC5B,6BAA6B,EAC7B,uBAAuB,EACvB,qBAAqB,EACrB,sBAAsB,EAEtB,qBAAqB,EACtB,MAAM,6BAA6B,CAAC;AAErC,OAAO,KAAK,EAIV,qBAAqB,EAErB,uBAAuB,EAEvB,kBAAkB,EAKnB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAW9D,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAkCxE,qBAAa,eAAgB,YAAW,mBAAmB;IAqBvD,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;IAE3B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IASzB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;IAnC7B,SAAgB,QAAQ,EAAE,mBAAmB,CAAC,UAAU,CAAC,CAAC;IAC1D,SAAgB,YAAY,EAAE,mBAAmB,CAAC,cAAc,CAAC,CACxC;IACzB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAGxB;IACJ,OAAO,CAAC,UAAU,CAAC,CAAW;IAC9B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAc;IAE5C,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,sBAAsB,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAqB;IACxD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAc;IACvC,OAAO,CAAC,SAAS,CAA+B;IAChD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyC;gBAG/C,OAAO,EAAE,mBAAmB,EAC5B,MAAM,EAAE,0BAA0B,EAClC,OAAO,EAAE,mBAAmB,EAC5B,UAAU,EAAE,kBAAkB,EAC9B,SAAS,CAAC,EAAE,uBAAuB,GAAG,SAAS,EAChE,GAAG,CAAC,EAAE,WAAW,EACA,QAAQ,GAAE;QACzB,QAAQ,CAAC,IAAI,EAAE,OAAO,gBAAgB,CAAC;QACvC,QAAQ,CAAC,IAAI,EAAE,OAAO,mBAAmB,CAAC;QAC1C,QAAQ,CAAC,UAAU,EAAE,OAAO,UAAU,CAAC;KAKvC,EACe,SAAS,CAAC,EAAE,qBAAqB,GAAG,SAAS;IAyBzD,OAAO,CAAC,GAAG,EAAE,WAAW,GAAG,eAAe;IAoBpC,UAAU,CACrB,SAAS,EAAE,MAAM,EACjB,iBAAiB,EAAE,MAAM,EACzB,SAAS,EAAE,OAAO,GAAG,QAAQ,GAC5B,OAAO,CAAC,eAAe,CAAC;IAoB3B,sFAAsF;IACtF,IAAW,iBAAiB,IAAI,OAAO,CAEtC;IAED,4FAA4F;IAC/E,cAAc,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,WAAW,CAAC;IAoC/D,WAAW,CACtB,KAAK,EAAE,4BAA4B,GAClC,OAAO,CAAC,kBAAkB,CAAC,sBAAsB,CAAC,CAAC;IAgBzC,oBAAoB,CAC/B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,kBAAkB,CAAC,cAAc,CAAC,CAAC;IAkBjC,YAAY,CACvB,KAAK,EAAE,6BAA6B,GACnC,OAAO,CAAC,kBAAkB,CAAC,uBAAuB,CAAC,CAAC;IAsJ1C,WAAW,CAAC,KAAK,EAAE,4BAA4B,GAAG,OAAO,CACpE,kBAAkB,CAAC;QACjB,QAAQ,CAAC,QAAQ,EAAE,SAAS,qBAAqB,EAAE,CAAC;QACpD,QAAQ,CAAC,yBAAyB,EAAE,SAAS,MAAM,EAAE,CAAC;QACtD,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC;QACpC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;KAC3B,CAAC,CACH;IA+HY,UAAU,CACrB,iBAAiB,EAAE,MAAM,EACzB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,kBAAkB,CAAC,qBAAqB,CAAC,CAAC;IAsExC,aAAa,CACxB,iBAAiB,EAAE,MAAM,EACzB,oBAAoB,EAAE,MAAM,EAC5B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,kBAAkB,CAAC,qBAAqB,CAAC,CAAC;IAiJxC,WAAW,CACtB,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC,sBAAsB,CAAC;IA8IrB,OAAO,CAClB,iBAAiB,EAAE,MAAM,EACzB,IAAI,EAAE,OAAO,EACb,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAkBvB,UAAU,CACrB,iBAAiB,EAAE,MAAM,EACzB,OAAO,EAAE,OAAO,EAChB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAkBvB,aAAa,CACxB,iBAAiB,EAAE,MAAM,EACzB,WAAW,EAAE,OAAO,EACpB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;IA4FvB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAYrB,WAAW;IAmBzB,OAAO,CAAC,SAAS;YAMH,IAAI;YAQJ,aAAa;IAyB3B,OAAO,CAAC,mBAAmB;YAYb,WAAW;YAyDX,mBAAmB;IA0BjC,OAAO,CAAC,eAAe;YAUT,aAAa;IA8C3B,OAAO,CAAC,SAAS;IAUjB;;;;OAIG;YACW,gBAAgB;IAsG9B,OAAO,CAAC,YAAY;IAOpB,wFAAwF;YAC1E,iBAAiB;YA2BjB,aAAa;IAU3B,iFAAiF;YACnE,OAAO;IAiCrB;;;OAGG;YACW,QAAQ;IA2CtB,OAAO,CAAC,WAAW;IASnB,yFAAyF;YAC3E,eAAe;IAiD7B;;;OAGG;YACW,aAAa;YAwPb,gBAAgB;CA2F/B;AAgED,qFAAqF;AACrF,iBAAe,UAAU,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAWtE"}