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

package/dist/server/credentials.js

@@ -0,0 +1,263 @@
+import { randomUUID } from 'node:crypto';
+const REFRESH_LEASE_MS = 2 * 60 * 1_000;
+const REFRESH_POLL_MS = 50;
+const REFRESH_TIMEOUT_MS = 30 * 1_000;
+export class DatabaseMailCredentialVault {
+    database;
+    refreshLeaseMs;
+    refreshPollMs;
+    refreshTimeoutMs;
+    refreshes = new Map();
+    constructor(database, refreshLeaseMs = REFRESH_LEASE_MS, refreshPollMs = REFRESH_POLL_MS, refreshTimeoutMs = REFRESH_TIMEOUT_MS) {
+        this.database = database;
+        this.refreshLeaseMs = refreshLeaseMs;
+        this.refreshPollMs = refreshPollMs;
+        this.refreshTimeoutMs = refreshTimeoutMs;
+    }
+    async put(value, options = {}) {
+        const reference = `mail-credential:${randomUUID()}`;
+        const now = new Date().toISOString();
+        await this.database
+            .query()
+            .insertInto('mailCredentials')
+            .values({
+            reference,
+            value: JSON.stringify(value),
+            purpose: options.purpose ?? 'account',
+            expiresAt: options.expiresAt,
+            createdAt: now,
+            updatedAt: now,
+        })
+            .execute();
+        return reference;
+    }
+    async get(reference) {
+        const row = await this.database
+            .query()
+            .selectFrom('mailCredentials')
+            .selectAll()
+            .where('reference', '=', reference)
+            .executeTakeFirst();
+        if (!row)
+            throw new Error('Mail credential was not found.');
+        return JSON.parse(row.value);
+    }
+    async replace(reference, value) {
+        const result = await this.database
+            .query()
+            .updateTable('mailCredentials')
+            .set({
+            value: JSON.stringify(value),
+            updatedAt: new Date().toISOString(),
+        })
+            .where('reference', '=', reference)
+            .execute();
+        if (result.updatedCount !== 1) {
+            throw new Error('Mail credential was not found.');
+        }
+    }
+    async getOrRefresh(reference, isFresh, refresh, signal) {
+        throwIfAborted(signal);
+        const current = await this.get(reference);
+        if (isFresh(current))
+            return current;
+        const active = this.refreshes.get(reference);
+        if (active)
+            return waitForPromise(active, signal);
+        const pending = (async () => {
+            const latest = await this.get(reference);
+            if (isFresh(latest))
+                return latest;
+            return this.refreshWithLease(reference, isFresh, refresh, signal);
+        })();
+        this.refreshes.set(reference, pending);
+        try {
+            return await pending;
+        }
+        finally {
+            if (this.refreshes.get(reference) === pending) {
+                this.refreshes.delete(reference);
+            }
+        }
+    }
+    async refreshWithLease(reference, isFresh, refresh, signal) {
+        const timeoutController = new AbortController();
+        const timeout = setTimeout(() => timeoutController.abort(new Error('Mail credential refresh timed out.')), this.refreshTimeoutMs);
+        const refreshSignal = signal
+            ? AbortSignal.any([signal, timeoutController.signal])
+            : timeoutController.signal;
+        const leaseToken = randomUUID();
+        try {
+            while (true) {
+                throwIfAborted(refreshSignal);
+                const current = await this.get(reference);
+                if (isFresh(current))
+                    return current;
+                const now = new Date();
+                const claimed = await this.database
+                    .query()
+                    .updateTable('mailCredentials')
+                    .set({
+                    refreshLeaseToken: leaseToken,
+                    refreshLeaseExpiresAt: new Date(now.getTime() + this.refreshLeaseMs).toISOString(),
+                })
+                    .where('reference', '=', reference)
+                    .where((builder) => builder.or([
+                    builder.eb('refreshLeaseToken', 'is', null),
+                    builder.eb('refreshLeaseExpiresAt', '<=', now.toISOString()),
+                ]))
+                    .execute();
+                if (claimed.updatedCount !== 1) {
+                    await delay(this.refreshPollMs, refreshSignal);
+                    continue;
+                }
+                try {
+                    const claimedCurrent = await this.get(reference);
+                    if (isFresh(claimedCurrent)) {
+                        await this.releaseRefreshLease(reference, leaseToken);
+                        return claimedCurrent;
+                    }
+                    const heartbeatController = new AbortController();
+                    const heartbeatSignal = AbortSignal.any([
+                        refreshSignal,
+                        heartbeatController.signal,
+                    ]);
+                    let heartbeatError;
+                    const heartbeat = this.maintainRefreshLease(reference, leaseToken, heartbeatSignal).catch((error) => {
+                        heartbeatError =
+                            error instanceof Error
+                                ? error
+                                : new Error('Mail credential refresh lease renewal failed.');
+                    });
+                    try {
+                        const next = await waitForPromise(refresh(claimedCurrent, refreshSignal), refreshSignal);
+                        throwIfAborted(refreshSignal);
+                        if (heartbeatError)
+                            throw heartbeatError;
+                        const saved = await this.database
+                            .query()
+                            .updateTable('mailCredentials')
+                            .set({
+                            value: JSON.stringify(next),
+                            refreshLeaseToken: null,
+                            refreshLeaseExpiresAt: null,
+                            updatedAt: new Date().toISOString(),
+                        })
+                            .where('reference', '=', reference)
+                            .where('refreshLeaseToken', '=', leaseToken)
+                            .execute();
+                        if (saved.updatedCount !== 1) {
+                            throw new Error('Mail credential refresh lease was lost.');
+                        }
+                        return next;
+                    }
+                    finally {
+                        heartbeatController.abort();
+                        await heartbeat;
+                    }
+                }
+                catch (error) {
+                    await this.releaseRefreshLease(reference, leaseToken);
+                    throw error;
+                }
+            }
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+    async maintainRefreshLease(reference, leaseToken, signal) {
+        while (!signal.aborted) {
+            await delay(this.refreshLeaseMs / 3, signal);
+            if (signal.aborted)
+                return;
+            const renewed = await this.database
+                .query()
+                .updateTable('mailCredentials')
+                .set({
+                refreshLeaseExpiresAt: new Date(Date.now() + this.refreshLeaseMs).toISOString(),
+            })
+                .where('reference', '=', reference)
+                .where('refreshLeaseToken', '=', leaseToken)
+                .execute();
+            if (renewed.updatedCount !== 1) {
+                throw new Error('Mail credential refresh lease was lost.');
+            }
+        }
+    }
+    async releaseRefreshLease(reference, leaseToken) {
+        await this.database
+            .query()
+            .updateTable('mailCredentials')
+            .set({ refreshLeaseToken: null, refreshLeaseExpiresAt: null })
+            .where('reference', '=', reference)
+            .where('refreshLeaseToken', '=', leaseToken)
+            .execute();
+    }
+    async delete(reference) {
+        await this.database
+            .query()
+            .deleteFrom('mailCredentials')
+            .where('reference', '=', reference)
+            .execute();
+    }
+    async deleteExpired(now) {
+        const result = await this.database
+            .query()
+            .deleteFrom('mailCredentials')
+            .where('purpose', '=', 'authorization')
+            .where('expiresAt', '<=', now)
+            .execute();
+        return result.deletedCount ?? 0;
+    }
+}
+async function delay(milliseconds, signal) {
+    if (signal?.aborted)
+        return;
+    await new Promise((resolve) => {
+        const timer = setTimeout(finish, milliseconds);
+        signal?.addEventListener('abort', finish, { once: true });
+        function finish() {
+            clearTimeout(timer);
+            signal?.removeEventListener('abort', finish);
+            resolve();
+        }
+    });
+}
+function throwIfAborted(signal) {
+    if (!signal?.aborted)
+        return;
+    throw signal.reason instanceof Error
+        ? signal.reason
+        : new Error('Mail credential refresh was aborted.');
+}
+async function waitForPromise(promise, signal) {
+    if (!signal)
+        return promise;
+    throwIfAborted(signal);
+    return new Promise((resolve, reject) => {
+        const onAbort = () => {
+            cleanup();
+            reject(signal.reason instanceof Error
+                ? signal.reason
+                : new Error('Mail credential refresh was aborted.'));
+        };
+        const cleanup = () => {
+            signal.removeEventListener('abort', onAbort);
+        };
+        signal.addEventListener('abort', onAbort, { once: true });
+        promise.then((value) => {
+            cleanup();
+            resolve(value);
+        }, (error) => {
+            cleanup();
+            reject(error instanceof Error
+                ? error
+                : new Error('Mail credential refresh failed.'));
+        });
+    });
+}
+export function createDatabaseMailCredentialVault(database) {
+    return new DatabaseMailCredentialVault(database);
+}
+//# sourceMappingURL=credentials.js.map

package/dist/server/credentials.js.map

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

package/dist/server/index.d.ts

@@ -0,0 +1,13 @@
+export { default } from './plugin.js';
+export { DEFAULT_MAIL_CONFIG, mailEnvironmentMappings, mailConfig, resolveMailConfig, } from './config.js';
+export type { MailConfig } from './config.js';
+export { mailCredentialVaultToken, mailProviderRegistryToken, mailServiceToken, } from './tokens.js';
+export { createMailProviderRegistry } from './registry.js';
+export { defineMailProviderDefinition } from './contracts/provider.js';
+export type * from './public-types.js';
+export type { MailProviderConfigEntry } from './config.js';
+export { MAIL_PROVIDER_CAPABILITIES, MAIL_PROVIDER_ERROR_CATEGORIES, } from '../shared/mail.js';
+export type { GmailMailProviderConfig } from './adapters/gmail/types.js';
+export type { MicrosoftMailProviderConfig } from './adapters/microsoft/types.js';
+export type { ImapSmtpEndpointConfig, ImapSmtpMailProviderConfig, } from './adapters/imap-smtp/config.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../server/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,UAAU,EACV,iBAAiB,GAClB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,gBAAgB,GACjB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,0BAA0B,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,EAAE,4BAA4B,EAAE,MAAM,yBAAyB,CAAC;AACvE,mBAAmB,mBAAmB,CAAC;AACvC,YAAY,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EACL,0BAA0B,EAC1B,8BAA8B,GAC/B,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACzE,YAAY,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AACjF,YAAY,EACV,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,gCAAgC,CAAC"}

package/dist/server/index.js

@@ -0,0 +1,7 @@
+export { default } from './plugin.js';
+export { DEFAULT_MAIL_CONFIG, mailEnvironmentMappings, mailConfig, resolveMailConfig, } from './config.js';
+export { mailCredentialVaultToken, mailProviderRegistryToken, mailServiceToken, } from './tokens.js';
+export { createMailProviderRegistry } from './registry.js';
+export { defineMailProviderDefinition } from './contracts/provider.js';
+export { MAIL_PROVIDER_CAPABILITIES, MAIL_PROVIDER_ERROR_CATEGORIES, } from '../shared/mail.js';
+//# sourceMappingURL=index.js.map

package/dist/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../server/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,UAAU,EACV,iBAAiB,GAClB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,gBAAgB,GACjB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,0BAA0B,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,EAAE,4BAA4B,EAAE,MAAM,yBAAyB,CAAC;AAGvE,OAAO,EACL,0BAA0B,EAC1B,8BAA8B,GAC/B,MAAM,mBAAmB,CAAC"}

package/dist/server/jobs/send-scheduled-mail.d.ts

@@ -0,0 +1,8 @@
+import { type JobClass } from '@nocobase/jobs';
+import type { MailScheduledSendTaskPayload } from '../contracts/persistence.js';
+/** The handler identity stored with every scheduled send task: keep it stable. */
+export declare const MAIL_SCHEDULED_SEND_JOB_NAME = "@nocobase/app-plugin-mail/send-scheduled-mail";
+export type MailScheduledSendJobHandler = (payload: MailScheduledSendTaskPayload) => Promise<void>;
+/** Like the sync job, the class closes over the handler of the runtime that registers it. */
+export declare function createSendScheduledMailJob(handler: MailScheduledSendJobHandler): JobClass<MailScheduledSendTaskPayload>;
+//# sourceMappingURL=send-scheduled-mail.d.ts.map

package/dist/server/jobs/send-scheduled-mail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-scheduled-mail.d.ts","sourceRoot":"","sources":["../../../server/jobs/send-scheduled-mail.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,KAAK,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAEpD,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,6BAA6B,CAAC;AAEhF,kFAAkF;AAClF,eAAO,MAAM,4BAA4B,kDACQ,CAAC;AAElD,MAAM,MAAM,2BAA2B,GAAG,CACxC,OAAO,EAAE,4BAA4B,KAClC,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnB,6FAA6F;AAC7F,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,2BAA2B,GACnC,QAAQ,CAAC,4BAA4B,CAAC,CAexC"}

package/dist/server/jobs/send-scheduled-mail.js

@@ -0,0 +1,18 @@
+import { Job } from '@nocobase/jobs';
+/** The handler identity stored with every scheduled send task: keep it stable. */
+export const MAIL_SCHEDULED_SEND_JOB_NAME = '@nocobase/app-plugin-mail/send-scheduled-mail';
+/** Like the sync job, the class closes over the handler of the runtime that registers it. */
+export function createSendScheduledMailJob(handler) {
+    return class SendScheduledMailJob extends Job {
+        static jobName = MAIL_SCHEDULED_SEND_JOB_NAME;
+        async execute() {
+            if (this.payload.version !== 1 ||
+                typeof this.payload.submissionId !== 'string' ||
+                this.payload.submissionId.length === 0) {
+                throw new TypeError('Invalid scheduled mail job payload.');
+            }
+            await handler(this.payload);
+        }
+    };
+}
+//# sourceMappingURL=send-scheduled-mail.js.map

package/dist/server/jobs/send-scheduled-mail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-scheduled-mail.js","sourceRoot":"","sources":["../../../server/jobs/send-scheduled-mail.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAiB,MAAM,gBAAgB,CAAC;AAIpD,kFAAkF;AAClF,MAAM,CAAC,MAAM,4BAA4B,GACvC,+CAA+C,CAAC;AAMlD,6FAA6F;AAC7F,MAAM,UAAU,0BAA0B,CACxC,OAAoC;IAEpC,OAAO,MAAM,oBAAqB,SAAQ,GAAiC;QAClE,MAAM,CAAU,OAAO,GAAW,4BAA4B,CAAC;QAE/D,KAAK,CAAC,OAAO;YAClB,IACE,IAAI,CAAC,OAAO,CAAC,OAAO,KAAK,CAAC;gBAC1B,OAAO,IAAI,CAAC,OAAO,CAAC,YAAY,KAAK,QAAQ;gBAC7C,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,MAAM,KAAK,CAAC,EACtC,CAAC;gBACD,MAAM,IAAI,SAAS,CAAC,qCAAqC,CAAC,CAAC;YAC7D,CAAC;YACD,MAAM,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC9B,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/server/jobs/sync-mailbox.d.ts

@@ -0,0 +1,11 @@
+import { type JobClass } from '@nocobase/jobs';
+import type { MailSyncMailboxTaskPayload } from '../contracts/persistence.js';
+/** The handler identity stored with every sync task: keep it stable. */
+export declare const MAIL_SYNC_JOB_NAME = "@nocobase/app-plugin-mail/sync-mailbox";
+export type MailSyncJobHandler = (payload: MailSyncMailboxTaskPayload) => Promise<void>;
+/**
+ * The class closes over the runtime's handler rather than looking it up: a task carries only its payload, and each
+ * executor keeps its own registry, so the runtime that registered the class is the one that executes it.
+ */
+export declare function createSyncMailboxJob(handler: MailSyncJobHandler): JobClass<MailSyncMailboxTaskPayload>;
+//# sourceMappingURL=sync-mailbox.d.ts.map

package/dist/server/jobs/sync-mailbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-mailbox.d.ts","sourceRoot":"","sources":["../../../server/jobs/sync-mailbox.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,KAAK,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAEpD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AAE9E,wEAAwE;AACxE,eAAO,MAAM,kBAAkB,2CAA2C,CAAC;AAE3E,MAAM,MAAM,kBAAkB,GAAG,CAC/B,OAAO,EAAE,0BAA0B,KAChC,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnB;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,kBAAkB,GAC1B,QAAQ,CAAC,0BAA0B,CAAC,CAiBtC"}

package/dist/server/jobs/sync-mailbox.js

@@ -0,0 +1,23 @@
+import { Job } from '@nocobase/jobs';
+/** The handler identity stored with every sync task: keep it stable. */
+export const MAIL_SYNC_JOB_NAME = '@nocobase/app-plugin-mail/sync-mailbox';
+/**
+ * The class closes over the runtime's handler rather than looking it up: a task carries only its payload, and each
+ * executor keeps its own registry, so the runtime that registered the class is the one that executes it.
+ */
+export function createSyncMailboxJob(handler) {
+    return class SyncMailboxJob extends Job {
+        static jobName = MAIL_SYNC_JOB_NAME;
+        async execute() {
+            if (this.payload.version !== 1 ||
+                typeof this.payload.syncRunId !== 'string' ||
+                this.payload.syncRunId.length === 0 ||
+                !Number.isSafeInteger(this.payload.expectedRevision) ||
+                typeof this.payload.expectedPhase !== 'string') {
+                throw new TypeError('Invalid mail sync job payload.');
+            }
+            await handler(this.payload);
+        }
+    };
+}
+//# sourceMappingURL=sync-mailbox.js.map

package/dist/server/jobs/sync-mailbox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-mailbox.js","sourceRoot":"","sources":["../../../server/jobs/sync-mailbox.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAiB,MAAM,gBAAgB,CAAC;AAIpD,wEAAwE;AACxE,MAAM,CAAC,MAAM,kBAAkB,GAAG,wCAAwC,CAAC;AAM3E;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAA2B;IAE3B,OAAO,MAAM,cAAe,SAAQ,GAA+B;QAC1D,MAAM,CAAU,OAAO,GAAW,kBAAkB,CAAC;QAErD,KAAK,CAAC,OAAO;YAClB,IACE,IAAI,CAAC,OAAO,CAAC,OAAO,KAAK,CAAC;gBAC1B,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,KAAK,QAAQ;gBAC1C,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC;gBACnC,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC;gBACpD,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,KAAK,QAAQ,EAC9C,CAAC;gBACD,MAAM,IAAI,SAAS,CAAC,gCAAgC,CAAC,CAAC;YACxD,CAAC;YACD,MAAM,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC9B,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/server/locales/en-US.d.ts

@@ -0,0 +1,18 @@
+import type { LocaleResource } from '@nocobase/i18n';
+declare const enUS: {
+    errors: {
+        accessDenied: string;
+        idempotencyConflict: string;
+        invalidRequest: string;
+        requestFailed: string;
+        providerRateLimited: string;
+        providerUnavailable: string;
+        reauthorizationRequired: string;
+        syncRunNotFound: string;
+        messageNotFound: string;
+        authorizationStateRequired: string;
+    };
+};
+export type MailServerResource = LocaleResource<typeof enUS>;
+export default enUS;
+//# sourceMappingURL=en-US.d.ts.map

package/dist/server/locales/en-US.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"en-US.d.ts","sourceRoot":"","sources":["../../../server/locales/en-US.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,QAAA,MAAM,IAAI;;;;;;;;;;;;;CAiBT,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,cAAc,CAAC,OAAO,IAAI,CAAC,CAAC;AAC7D,eAAe,IAAI,CAAC"}

package/dist/server/locales/en-US.js

@@ -0,0 +1,16 @@
+const enUS = {
+    errors: {
+        accessDenied: 'Mail access is required.',
+        idempotencyConflict: 'The idempotency key is already associated with another request.',
+        invalidRequest: 'The mail request is invalid.',
+        requestFailed: 'The mail request could not be completed.',
+        providerRateLimited: 'The mail service is receiving too many requests. Try again later.',
+        providerUnavailable: 'The mail service could not be reached. Try again later.',
+        reauthorizationRequired: 'This mail account must be reconnected before it can be used.',
+        syncRunNotFound: 'Mail sync run was not found.',
+        messageNotFound: 'Mail message was not found.',
+        authorizationStateRequired: 'Mail authorization state is required.',
+    },
+};
+export default enUS;
+//# sourceMappingURL=en-US.js.map

package/dist/server/locales/en-US.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"en-US.js","sourceRoot":"","sources":["../../../server/locales/en-US.ts"],"names":[],"mappings":"AAEA,MAAM,IAAI,GAAG;IACX,MAAM,EAAE;QACN,YAAY,EAAE,0BAA0B;QACxC,mBAAmB,EACjB,iEAAiE;QACnE,cAAc,EAAE,8BAA8B;QAC9C,aAAa,EAAE,0CAA0C;QACzD,mBAAmB,EACjB,mEAAmE;QACrE,mBAAmB,EACjB,yDAAyD;QAC3D,uBAAuB,EACrB,8DAA8D;QAChE,eAAe,EAAE,8BAA8B;QAC/C,eAAe,EAAE,6BAA6B;QAC9C,0BAA0B,EAAE,uCAAuC;KACpE;CACF,CAAC;AAGF,eAAe,IAAI,CAAC"}

package/dist/server/locales/index.d.ts

@@ -0,0 +1,4 @@
+import type { LocaleLoaders } from '@nocobase/i18n';
+declare const locales: LocaleLoaders;
+export default locales;
+//# sourceMappingURL=index.d.ts.map

package/dist/server/locales/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../server/locales/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD,QAAA,MAAM,OAAO,EAAE,aAGd,CAAC;AAEF,eAAe,OAAO,CAAC"}

package/dist/server/locales/index.js

@@ -0,0 +1,6 @@
+const locales = {
+    'en-US': () => import('./en-US.js'),
+    'zh-CN': () => import('./zh-CN.js'),
+};
+export default locales;
+//# sourceMappingURL=index.js.map

package/dist/server/locales/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../server/locales/index.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,GAAkB;IAC7B,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC;IACnC,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC;CACpC,CAAC;AAEF,eAAe,OAAO,CAAC"}

package/dist/server/locales/zh-CN.d.ts

@@ -0,0 +1,4 @@
+import type { MailServerResource } from './en-US.js';
+declare const zhCN: MailServerResource;
+export default zhCN;
+//# sourceMappingURL=zh-CN.d.ts.map

package/dist/server/locales/zh-CN.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zh-CN.d.ts","sourceRoot":"","sources":["../../../server/locales/zh-CN.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,QAAA,MAAM,IAAI,EAAE,kBAaX,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/dist/server/locales/zh-CN.js

@@ -0,0 +1,16 @@
+const zhCN = {
+    errors: {
+        accessDenied: '需要邮件访问权限。',
+        idempotencyConflict: '该幂等键已关联到另一个请求。',
+        invalidRequest: '邮件请求无效。',
+        requestFailed: '无法完成邮件请求。',
+        providerRateLimited: '邮件服务请求过于频繁，请稍后重试。',
+        providerUnavailable: '无法连接邮件服务，请稍后重试。',
+        reauthorizationRequired: '需要重新连接此邮件账户后才能继续使用。',
+        syncRunNotFound: '未找到邮件同步任务。',
+        messageNotFound: '未找到邮件。',
+        authorizationStateRequired: '必须提供邮件授权状态。',
+    },
+};
+export default zhCN;
+//# sourceMappingURL=zh-CN.js.map

package/dist/server/locales/zh-CN.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zh-CN.js","sourceRoot":"","sources":["../../../server/locales/zh-CN.ts"],"names":[],"mappings":"AAEA,MAAM,IAAI,GAAuB;IAC/B,MAAM,EAAE;QACN,YAAY,EAAE,WAAW;QACzB,mBAAmB,EAAE,gBAAgB;QACrC,cAAc,EAAE,SAAS;QACzB,aAAa,EAAE,WAAW;QAC1B,mBAAmB,EAAE,mBAAmB;QACxC,mBAAmB,EAAE,iBAAiB;QACtC,uBAAuB,EAAE,qBAAqB;QAC9C,eAAe,EAAE,YAAY;QAC7B,eAAe,EAAE,QAAQ;QACzB,0BAA0B,EAAE,aAAa;KAC1C;CACF,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/dist/server/log-pagination.d.ts

@@ -0,0 +1,2 @@
+export declare function validateLogPagination(offset: number, limit: number): void;
+//# sourceMappingURL=log-pagination.d.ts.map

package/dist/server/log-pagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-pagination.d.ts","sourceRoot":"","sources":["../../server/log-pagination.ts"],"names":[],"mappings":"AAEA,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAKzE"}

package/dist/server/log-pagination.js

@@ -0,0 +1,8 @@
+import { mailInvalidArgument } from './services/errors.js';
+export function validateLogPagination(offset, limit) {
+    if (!Number.isSafeInteger(offset) || offset < 0)
+        throw mailInvalidArgument('Invalid mail log offset.');
+    if (!Number.isSafeInteger(limit) || limit < 1 || limit > 100)
+        throw mailInvalidArgument('Mail log limit must be between 1 and 100.');
+}
+//# sourceMappingURL=log-pagination.js.map

package/dist/server/log-pagination.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-pagination.js","sourceRoot":"","sources":["../../server/log-pagination.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE3D,MAAM,UAAU,qBAAqB,CAAC,MAAc,EAAE,KAAa;IACjE,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC;QAC7C,MAAM,mBAAmB,CAAC,0BAA0B,CAAC,CAAC;IACxD,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,GAAG;QAC1D,MAAM,mBAAmB,CAAC,2CAA2C,CAAC,CAAC;AAC3E,CAAC"}

package/dist/server/logging.d.ts

@@ -0,0 +1,16 @@
+/** The shared application logger, narrowed to the levels Mail uses. */
+export interface MailLogger {
+    info?(data: object, message: string): void;
+    warn?(data: object, message: string): void;
+    error?(data: object, message: string): void;
+}
+export interface MailLogError {
+    readonly type?: string;
+    readonly message: string;
+    readonly stack?: string;
+}
+/** Keep Error details JSON-safe without copying arbitrary SDK request payloads. */
+export declare function mailLogError(error: unknown): MailLogError;
+/** A failed logging transport must never change a delivery or persistence result. */
+export declare function writeMailLog(logger: MailLogger | undefined, level: keyof MailLogger, data: object, message: string): void;
+//# sourceMappingURL=logging.d.ts.map

package/dist/server/logging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.d.ts","sourceRoot":"","sources":["../../server/logging.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3C,IAAI,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3C,KAAK,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7C;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,mFAAmF;AACnF,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,CAazD;AAED,qFAAqF;AACrF,wBAAgB,YAAY,CAC1B,MAAM,EAAE,UAAU,GAAG,SAAS,EAC9B,KAAK,EAAE,MAAM,UAAU,EACvB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,IAAI,CAMN"}

package/dist/server/logging.js

@@ -0,0 +1,24 @@
+/** Keep Error details JSON-safe without copying arbitrary SDK request payloads. */
+export function mailLogError(error) {
+    if (error instanceof Error) {
+        return { type: error.name, message: error.message, stack: error.stack };
+    }
+    if (typeof error === 'object' && error !== null && 'message' in error) {
+        return {
+            message: typeof error.message === 'string'
+                ? error.message
+                : 'Unknown mail error',
+        };
+    }
+    return { message: typeof error === 'string' ? error : 'Unknown mail error' };
+}
+/** A failed logging transport must never change a delivery or persistence result. */
+export function writeMailLog(logger, level, data, message) {
+    try {
+        logger?.[level]?.(data, message);
+    }
+    catch {
+        // Retrying a successful send because logging failed could duplicate delivery.
+    }
+}
+//# sourceMappingURL=logging.js.map

package/dist/server/logging.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.js","sourceRoot":"","sources":["../../server/logging.ts"],"names":[],"mappings":"AAaA,mFAAmF;AACnF,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;IAC1E,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,SAAS,IAAI,KAAK,EAAE,CAAC;QACtE,OAAO;YACL,OAAO,EACL,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ;gBAC/B,CAAC,CAAC,KAAK,CAAC,OAAO;gBACf,CAAC,CAAC,oBAAoB;SAC3B,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,oBAAoB,EAAE,CAAC;AAC/E,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,YAAY,CAC1B,MAA8B,EAC9B,KAAuB,EACvB,IAAY,EACZ,OAAe;IAEf,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,8EAA8E;IAChF,CAAC;AACH,CAAC"}

package/dist/server/operations/index.d.ts

@@ -0,0 +1,3 @@
+export * from './send-mail.js';
+export * from './sync-mailbox.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/server/operations/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../server/operations/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC"}

package/dist/server/operations/index.js

@@ -0,0 +1,3 @@
+export * from './send-mail.js';
+export * from './sync-mailbox.js';
+//# sourceMappingURL=index.js.map

package/dist/server/operations/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../server/operations/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC"}

package/dist/server/operations/message-mutations.d.ts

@@ -0,0 +1,16 @@
+import type { MailAccount, MailMessage, MailOperationContext } from '../../shared/mail.js';
+import type { MailStore } from '../contracts/persistence.js';
+import type { DefaultMailServiceDependencies } from '../services/dependencies.js';
+type MessageMutationStore = Pick<MailStore, 'listFolders' | 'updateMessageState' | 'moveMessage' | 'deleteMessage'>;
+/** Executes mutations after the caller has authorized and resolved the target. */
+export declare class MailMessageMutations {
+    private readonly dependencies;
+    constructor(dependencies: Pick<DefaultMailServiceDependencies, 'adapters' | 'messageChangeNotifier' | 'logger'> & {
+        readonly store: MessageMutationStore;
+    });
+    updateMessage(context: MailOperationContext, account: MailAccount, message: MailMessage, input: import('../../shared/mail.js').MailUpdateMessageInput): Promise<MailMessage>;
+    moveMessage(context: MailOperationContext, account: MailAccount, message: MailMessage, input: import('../../shared/mail.js').MailMoveMessageInput): Promise<MailMessage>;
+    deleteMessage(context: MailOperationContext, account: MailAccount, message: MailMessage, input: import('../../shared/mail.js').MailDeleteMessageInput): Promise<void>;
+}
+export {};
+//# sourceMappingURL=message-mutations.d.ts.map

package/dist/server/operations/message-mutations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-mutations.d.ts","sourceRoot":"","sources":["../../../server/operations/message-mutations.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EACX,oBAAoB,EACrB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,6BAA6B,CAAC;AASlF,KAAK,oBAAoB,GAAG,IAAI,CAC9B,SAAS,EACT,aAAa,GAAG,oBAAoB,GAAG,aAAa,GAAG,eAAe,CACvE,CAAC;AAEF,kFAAkF;AAClF,qBAAa,oBAAoB;IAE7B,OAAO,CAAC,QAAQ,CAAC,YAAY;gBAAZ,YAAY,EAAE,IAAI,CACjC,8BAA8B,EAC9B,UAAU,GAAG,uBAAuB,GAAG,QAAQ,CAChD,GAAG;QAAE,QAAQ,CAAC,KAAK,EAAE,oBAAoB,CAAA;KAAE;IAEjC,aAAa,CACxB,OAAO,EAAE,oBAAoB,EAC7B,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,WAAW,EACpB,KAAK,EAAE,OAAO,sBAAsB,EAAE,sBAAsB,GAC3D,OAAO,CAAC,WAAW,CAAC;IAkFV,WAAW,CACtB,OAAO,EAAE,oBAAoB,EAC7B,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,WAAW,EACpB,KAAK,EAAE,OAAO,sBAAsB,EAAE,oBAAoB,GACzD,OAAO,CAAC,WAAW,CAAC;IAyDV,aAAa,CACxB,OAAO,EAAE,oBAAoB,EAC7B,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,WAAW,EACpB,KAAK,EAAE,OAAO,sBAAsB,EAAE,sBAAsB,GAC3D,OAAO,CAAC,IAAI,CAAC;CAyGjB"}