@nocobase/app-plugin-mail 0.0.0-stage → 1.0.0-beta.11

package/dist/server/operations/message-mutations.js

@@ -0,0 +1,139 @@
+import { notifyMailMessageChange } from '../realtime.js';
+import { isLocalDraftMessage, remoteMessageId, } from '../services/draft-content.js';
+import { assertProviderResult } from '../services/errors.js';
+import { closeAdapter } from '../services/provider-lifecycle.js';
+import { mailFailedPrecondition, mailNotFound } from '../services/errors.js';
+/** Executes mutations after the caller has authorized and resolved the target. */
+export class MailMessageMutations {
+    dependencies;
+    constructor(dependencies) {
+        this.dependencies = dependencies;
+    }
+    async updateMessage(context, account, message, input) {
+        if (input.read === undefined &&
+            input.starred === undefined &&
+            input.note === undefined &&
+            input.todo === undefined)
+            return message;
+        const providerMessageId = remoteMessageId(message);
+        if ((input.read === undefined && input.starred === undefined) ||
+            !providerMessageId) {
+            const updated = await this.dependencies.store.updateMessageState(account.id, message.id, {
+                note: input.note,
+                todo: input.todo,
+                read: input.read,
+                starred: input.starred,
+            });
+            if (!updated)
+                throw new Error('Mail message was not found after update.');
+            notifyMailMessageChange(this.dependencies.messageChangeNotifier, account.userId, this.dependencies.logger);
+            return updated;
+        }
+        const adapter = await this.dependencies.adapters.resolve(account, context.signal);
+        try {
+            if (input.read !== undefined) {
+                if (!adapter.setRead)
+                    throw mailFailedPrecondition('MAIL_PROVIDER_OPERATION_UNSUPPORTED', 'The selected Mail Provider cannot change read state.');
+                assertProviderResult(await adapter.setRead(providerMessageId, input.read, context.signal));
+            }
+            if (input.starred !== undefined) {
+                if (!adapter.setStarred)
+                    throw mailFailedPrecondition('MAIL_PROVIDER_OPERATION_UNSUPPORTED', 'The selected Mail Provider cannot change starred state.');
+                assertProviderResult(await adapter.setStarred(providerMessageId, input.starred, context.signal));
+            }
+            const updated = await this.dependencies.store.updateMessageState(account.id, message.id, {
+                read: input.read,
+                starred: input.starred,
+                note: input.note,
+                todo: input.todo,
+            });
+            if (!updated)
+                throw new Error('Mail message was not found after update.');
+            notifyMailMessageChange(this.dependencies.messageChangeNotifier, account.userId, this.dependencies.logger);
+            return updated;
+        }
+        finally {
+            await closeAdapter(adapter);
+        }
+    }
+    async moveMessage(context, account, message, input) {
+        if (message.scheduledSend)
+            throw mailFailedPrecondition('MAIL_DRAFT_SCHEDULED', 'Cancel the scheduled delivery before moving or deleting this draft.');
+        const providerMessageId = remoteMessageId(message);
+        if (!providerMessageId)
+            throw mailFailedPrecondition('MAIL_DRAFT_LOCAL_ONLY', 'A local-only draft cannot be moved to a provider folder.');
+        const folder = (await this.dependencies.store.listFolders(account.id)).find((item) => item.providerFolderId === input.providerFolderId);
+        if (!folder)
+            throw mailNotFound('MAIL_FOLDER_NOT_FOUND', 'Mail destination folder was not found.', 'providerFolderId');
+        const adapter = await this.dependencies.adapters.resolve(account, context.signal);
+        try {
+            if (!adapter.capabilities.moveMessage || !adapter.moveMessage) {
+                throw mailFailedPrecondition('MAIL_PROVIDER_OPERATION_UNSUPPORTED', 'The selected Mail Provider cannot move messages.');
+            }
+            const moved = assertProviderResult(await adapter.moveMessage(providerMessageId, input.providerFolderId, context.signal));
+            const updated = await this.dependencies.store.moveMessage(account.id, message.id, moved.providerMessageId, input.providerFolderId);
+            if (!updated)
+                throw new Error('Mail message was not found after move.');
+            notifyMailMessageChange(this.dependencies.messageChangeNotifier, account.userId, this.dependencies.logger);
+            return updated;
+        }
+        finally {
+            await closeAdapter(adapter);
+        }
+    }
+    async deleteMessage(context, account, message, input) {
+        if (message.scheduledSend)
+            throw mailFailedPrecondition('MAIL_DRAFT_SCHEDULED', 'Cancel the scheduled delivery before moving or deleting this draft.');
+        if (isLocalDraftMessage(message)) {
+            let adapter;
+            try {
+                if (message.providerDraftMessageId) {
+                    adapter = await this.dependencies.adapters.resolve(account, context.signal);
+                    if (adapter.deleteMessage) {
+                        await adapter.deleteMessage(message.providerDraftMessageId, true, context.signal);
+                    }
+                }
+            }
+            catch {
+                // Remote draft cleanup is best effort; local deletion remains authoritative.
+            }
+            finally {
+                if (adapter)
+                    await closeAdapter(adapter);
+            }
+            const deleted = await this.dependencies.store.deleteMessage(account.id, message.id);
+            if (deleted) {
+                notifyMailMessageChange(this.dependencies.messageChangeNotifier, account.userId, this.dependencies.logger);
+            }
+            return;
+        }
+        const adapter = await this.dependencies.adapters.resolve(account, context.signal);
+        try {
+            if (!input.permanently &&
+                adapter.capabilities.moveMessage &&
+                adapter.moveMessage) {
+                const trash = (await this.dependencies.store.listFolders(account.id)).find((folder) => folder.type === 'trash');
+                if (trash) {
+                    const moved = assertProviderResult(await adapter.moveMessage(message.providerMessageId, trash.providerFolderId, context.signal));
+                    const updated = await this.dependencies.store.moveMessage(account.id, message.id, moved.providerMessageId, trash.providerFolderId);
+                    if (!updated)
+                        throw new Error('Mail message was not found after delete.');
+                    notifyMailMessageChange(this.dependencies.messageChangeNotifier, account.userId, this.dependencies.logger);
+                    return;
+                }
+            }
+            if (!adapter.deleteMessage) {
+                throw mailFailedPrecondition('MAIL_PROVIDER_OPERATION_UNSUPPORTED', 'The selected Mail Provider cannot delete messages.');
+            }
+            assertProviderResult(await adapter.deleteMessage(message.providerMessageId, input.permanently ?? false, context.signal));
+            const deleted = await this.dependencies.store.deleteMessage(account.id, message.id);
+            if (deleted) {
+                notifyMailMessageChange(this.dependencies.messageChangeNotifier, account.userId, this.dependencies.logger);
+            }
+        }
+        finally {
+            await closeAdapter(adapter);
+        }
+    }
+}
+//# sourceMappingURL=message-mutations.js.map

package/dist/server/operations/message-mutations.js.map

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

package/dist/server/operations/schedule-sync.d.ts

@@ -0,0 +1,15 @@
+import type { MailAccount, MailStartSyncInput, MailSyncRun } from '../../shared/mail.js';
+import type { MailStore } from '../contracts/persistence.js';
+type SyncSchedulingStore = Pick<MailStore, 'findActiveSyncRun' | 'getSyncCursor' | 'createSyncRun'>;
+/** Shared scheduling policy for user requests, automatic sweeps, and push delivery. */
+export declare class MailSyncScheduler {
+    private readonly store;
+    private readonly batchSize;
+    constructor(store: SyncSchedulingStore, batchSize: number);
+    request(account: MailAccount, requestedBy: string, input?: Pick<MailStartSyncInput, 'mode' | 'receivedAfter'>): Promise<{
+        readonly run: MailSyncRun;
+        readonly created: boolean;
+    }>;
+}
+export {};
+//# sourceMappingURL=schedule-sync.d.ts.map

package/dist/server/operations/schedule-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-sync.d.ts","sourceRoot":"","sources":["../../../server/operations/schedule-sync.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,WAAW,EACX,kBAAkB,EAClB,WAAW,EACZ,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAM7D,KAAK,mBAAmB,GAAG,IAAI,CAC7B,SAAS,EACT,mBAAmB,GAAG,eAAe,GAAG,eAAe,CACxD,CAAC;AAEF,uFAAuF;AACvF,qBAAa,iBAAiB;IAE1B,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS;gBADT,KAAK,EAAE,mBAAmB,EAC1B,SAAS,EAAE,MAAM;IAGvB,OAAO,CAClB,OAAO,EAAE,WAAW,EACpB,WAAW,EAAE,MAAM,EACnB,KAAK,GAAE,IAAI,CAAC,kBAAkB,EAAE,MAAM,GAAG,eAAe,CAAM,GAC7D,OAAO,CAAC;QAAE,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;CA6CrE"}

package/dist/server/operations/schedule-sync.js

@@ -0,0 +1,44 @@
+import { randomUUID } from 'node:crypto';
+import { mailFailedPrecondition, mailInvalidArgument, } from '../services/errors.js';
+/** Shared scheduling policy for user requests, automatic sweeps, and push delivery. */
+export class MailSyncScheduler {
+    store;
+    batchSize;
+    constructor(store, batchSize) {
+        this.store = store;
+        this.batchSize = batchSize;
+    }
+    async request(account, requestedBy, input = {}) {
+        if (input.receivedAfter !== undefined &&
+            !Number.isFinite(Date.parse(input.receivedAfter)))
+            throw mailInvalidArgument('Mail synchronization start date is invalid.', 'receivedAfter');
+        const active = await this.store.findActiveSyncRun(account.id);
+        if (active)
+            return { run: active, created: false };
+        const cursor = await this.store.getSyncCursor(account.id);
+        const mode = input.mode ?? (cursor ? 'incremental' : 'initial');
+        if (mode === 'incremental' && !cursor)
+            throw mailFailedPrecondition('MAIL_INITIAL_SYNC_REQUIRED', 'Initial mailbox sync must complete before incremental sync.');
+        const receivedAfter = input.receivedAfter ??
+            (mode === 'initial' ? account.initialSyncReceivedAfter : undefined);
+        if (mode === 'initial' && !receivedAfter) {
+            throw mailInvalidArgument('Initial mailbox sync requires a start date. Set receivedAfter or configure the account start date.');
+        }
+        if (receivedAfter && !Number.isFinite(Date.parse(receivedAfter))) {
+            throw mailInvalidArgument('Mail synchronization start date is invalid.', 'receivedAfter');
+        }
+        const id = randomUUID();
+        const run = await this.store.createSyncRun({
+            id,
+            accountId: account.id,
+            requestedBy,
+            mode,
+            policy: {
+                receivedAfter,
+                batchSize: this.batchSize,
+            },
+        });
+        return { run, created: run.id === id };
+    }
+}
+//# sourceMappingURL=schedule-sync.js.map

package/dist/server/operations/schedule-sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-sync.js","sourceRoot":"","sources":["../../../server/operations/schedule-sync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAOzC,OAAO,EACL,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,uBAAuB,CAAC;AAO/B,uFAAuF;AACvF,MAAM,OAAO,iBAAiB;IAET;IACA;IAFnB,YACmB,KAA0B,EAC1B,SAAiB;QADjB,UAAK,GAAL,KAAK,CAAqB;QAC1B,cAAS,GAAT,SAAS,CAAQ;IACjC,CAAC;IAEG,KAAK,CAAC,OAAO,CAClB,OAAoB,EACpB,WAAmB,EACnB,QAA4D,EAAE;QAE9D,IACE,KAAK,CAAC,aAAa,KAAK,SAAS;YACjC,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;YAEjD,MAAM,mBAAmB,CACvB,6CAA6C,EAC7C,eAAe,CAChB,CAAC;QACJ,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC9D,IAAI,MAAM;YAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QACnD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC1D,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAChE,IAAI,IAAI,KAAK,aAAa,IAAI,CAAC,MAAM;YACnC,MAAM,sBAAsB,CAC1B,4BAA4B,EAC5B,6DAA6D,CAC9D,CAAC;QACJ,MAAM,aAAa,GACjB,KAAK,CAAC,aAAa;YACnB,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,wBAAwB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QACtE,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,aAAa,EAAE,CAAC;YACzC,MAAM,mBAAmB,CACvB,oGAAoG,CACrG,CAAC;QACJ,CAAC;QACD,IAAI,aAAa,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC;YACjE,MAAM,mBAAmB,CACvB,6CAA6C,EAC7C,eAAe,CAChB,CAAC;QACJ,CAAC;QACD,MAAM,EAAE,GAAG,UAAU,EAAE,CAAC;QACxB,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC;YACzC,EAAE;YACF,SAAS,EAAE,OAAO,CAAC,EAAE;YACrB,WAAW;YACX,IAAI;YACJ,MAAM,EAAE;gBACN,aAAa;gBACb,SAAS,EAAE,IAAI,CAAC,SAAS;aAC1B;SACF,CAAC,CAAC;QACH,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC;IACzC,CAAC;CACF"}

package/dist/server/operations/send-mail.d.ts

@@ -0,0 +1,36 @@
+import { type MailLogger } from '../logging.js';
+import type { MailComposeInput, MailOperationContext, MailOutboundAttachmentStorage, MailSubmission } from '../../shared/mail.js';
+import type { MailProviderAdapterResolver, MailProviderMessageInput } from '../contracts/provider.js';
+import type { MailService } from '../contracts/service.js';
+import type { MailStore } from '../contracts/persistence.js';
+import { type MailMessageChangeNotifier } from '../realtime.js';
+export interface SendMailOperationDependencies {
+    readonly logger?: MailLogger;
+    readonly store: MailStore;
+    readonly adapters: MailProviderAdapterResolver;
+    readonly outbox?: {
+        kick(): void;
+    };
+    readonly outboundAttachments?: MailOutboundAttachmentStorage;
+    readonly messageChangeNotifier?: MailMessageChangeNotifier;
+}
+export interface SendMailExecutionOptions {
+    readonly scheduledDelivery?: boolean;
+}
+export declare class SendMailOperation {
+    private readonly dependencies;
+    constructor(dependencies: SendMailOperationDependencies);
+    execute(context: MailOperationContext, input: MailComposeInput, options?: SendMailExecutionOptions): Promise<MailSubmission>;
+    private executeSubmission;
+    private snapshotDelivery;
+    private draftAttachments;
+    private createScheduledDraft;
+    private saveAcceptedMessage;
+    private localAttachmentId;
+    prepareProviderMessage(context: MailOperationContext, input: MailComposeInput, contentAlreadyPrepared?: boolean): Promise<MailProviderMessageInput>;
+}
+export declare class MailIdempotencyConflictError extends Error {
+    constructor();
+}
+export type SendMessageMethod = MailService['sendMessage'];
+//# sourceMappingURL=send-mail.d.ts.map

package/dist/server/operations/send-mail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-mail.d.ts","sourceRoot":"","sources":["../../../server/operations/send-mail.ts"],"names":[],"mappings":"AAKA,OAAO,EAA8B,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAG5E,OAAO,KAAK,EACV,gBAAgB,EAGhB,oBAAoB,EACpB,6BAA6B,EAC7B,cAAc,EAGf,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EACV,2BAA2B,EAC3B,wBAAwB,EACzB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAEL,KAAK,yBAAyB,EAC/B,MAAM,gBAAgB,CAAC;AAUxB,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,2BAA2B,CAAC;IAC/C,QAAQ,CAAC,MAAM,CAAC,EAAE;QAAE,IAAI,IAAI,IAAI,CAAA;KAAE,CAAC;IACnC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,6BAA6B,CAAC;IAC7D,QAAQ,CAAC,qBAAqB,CAAC,EAAE,yBAAyB,CAAC;CAC5D;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;CACtC;AAKD,qBAAa,iBAAiB;IAE1B,OAAO,CAAC,QAAQ,CAAC,YAAY;gBAAZ,YAAY,EAAE,6BAA6B;IAGjD,OAAO,CAClB,OAAO,EAAE,oBAAoB,EAC7B,KAAK,EAAE,gBAAgB,EACvB,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,cAAc,CAAC;YA4GZ,iBAAiB;YAmWjB,gBAAgB;YAwDhB,gBAAgB;YA4ChB,oBAAoB;YAmCpB,mBAAmB;YAiDnB,iBAAiB;IAiBlB,sBAAsB,CACjC,OAAO,EAAE,oBAAoB,EAC7B,KAAK,EAAE,gBAAgB,EACvB,sBAAsB,UAAQ,GAC7B,OAAO,CAAC,wBAAwB,CAAC;CAiOrC;AAqDD,qBAAa,4BAA6B,SAAQ,KAAK;;CAItD;AAqDD,MAAM,MAAM,iBAAiB,GAAG,WAAW,CAAC,aAAa,CAAC,CAAC"}