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

package/dist/server/contracts/provider.d.ts

@@ -0,0 +1,303 @@
+import type { NormalizedMailAttachment } from '../../shared/mail.js';
+import type { MailAccount, MailAddress, MailAttachmentContent, MailAuthorizationStartInput, MailAuthorizationStartResult, MailDraftConflict, MailFolderType, MailIdentity, MailProviderCapabilities, MailProviderConfig, MailProviderError, MailProviderIdentity, MailProviderResult, MailSyncCursor } from '../../shared/mail.js';
+/** Server-only account context passed to a registered Provider adapter. */
+export interface MailProviderAccount {
+    readonly id: string;
+    readonly address: string;
+    readonly provider: MailProviderIdentity;
+    /** Opaque vault reference; resolve credentials through MailProviderContext.credentials. */
+    readonly credentialReference: string;
+}
+export interface MailAuthorizedAccount {
+    readonly address: string;
+    readonly displayName?: string;
+    readonly authorizationSubject?: string;
+    readonly credentialReference: string;
+    readonly scopes: readonly string[];
+    readonly identities?: readonly MailAuthorizedIdentity[];
+}
+export interface MailAuthorizedIdentity {
+    readonly address: string;
+    readonly displayName?: string;
+    readonly signatureText?: string;
+    readonly signatureHtml?: string;
+    readonly isPrimary: boolean;
+    readonly canSend: boolean;
+}
+export interface MailProviderAuthorizationCallbackInput {
+    readonly redirectUri: string;
+    readonly state: string;
+    readonly code: string;
+    readonly codeVerifier: string;
+    readonly scopes: readonly string[];
+    readonly signal?: AbortSignal;
+}
+export interface MailProviderConnectInput {
+    readonly address: string;
+    readonly displayName?: string;
+    readonly username: string;
+    readonly password: string;
+    readonly signal?: AbortSignal;
+}
+export interface MailProviderChangePage {
+    readonly messages: readonly NormalizedMailMessage[];
+    readonly removedFromFolders?: readonly MailProviderFolderRemoval[];
+    readonly deletedProviderMessageIds: readonly string[];
+    readonly nextCursor: MailSyncCursor;
+    readonly hasMore: boolean;
+}
+export interface MailProviderFolderRemoval {
+    readonly providerMessageId: string;
+    readonly providerFolderId: string;
+}
+export interface MailProviderListChangesInput {
+    readonly cursor?: MailSyncCursor;
+    /** Existing IMAP-backed message IDs used for provider-side deletion reconciliation. */
+    readonly knownProviderMessageIds?: readonly string[];
+    readonly limit: number;
+    readonly signal?: AbortSignal;
+}
+export interface MailProviderListFoldersInput {
+    readonly cursor?: string;
+    readonly limit: number;
+    readonly signal?: AbortSignal;
+}
+export interface MailProviderFolderPage {
+    readonly folders: readonly NormalizedMailFolder[];
+    readonly nextCursor?: string;
+    /** Exact Provider folder scope, present only on the final page. */
+    readonly completeProviderFolderIds?: readonly string[];
+}
+export interface MailProviderListMessagesInput {
+    readonly providerFolderIds?: readonly string[];
+    readonly receivedAfter?: string;
+    /** Provider baseline seed captured before the initial history pass starts. */
+    readonly baselineCursor?: MailSyncCursor;
+    readonly cursor?: string;
+    readonly limit?: number;
+    readonly signal?: AbortSignal;
+}
+export interface MailProviderMessagePage {
+    /** False while the Provider is still establishing its history baseline. */
+    readonly historyReady?: boolean;
+    readonly messages: readonly NormalizedMailMessage[];
+    readonly nextCursor?: string;
+    /**
+     * Pre-history checkpoint. A Provider may return empty preparation pages while
+     * establishing this checkpoint before it returns bounded history pages.
+     */
+    readonly syncCursor?: MailSyncCursor;
+}
+export interface MailProviderSendInput {
+    readonly trackingId: string;
+    readonly identity: MailIdentity;
+    readonly message: MailProviderMessageInput;
+    readonly signal?: AbortSignal;
+}
+export interface MailProviderPushSubscription {
+    readonly accountId: string;
+    readonly provider: MailProviderIdentity;
+    readonly providerSubscriptionId: string;
+    readonly configurationFingerprint: string;
+    readonly renewAfter: string;
+    readonly expiresAt: string;
+    readonly updatedAt: string;
+}
+export interface MailPushSubscriptionMaintenanceLease {
+    readonly leaseToken: string;
+    readonly subscription?: MailProviderPushSubscription;
+}
+export interface MailProviderUpsertPushSubscriptionInput {
+    readonly notificationUrl: string;
+    readonly clientState: string;
+    readonly providerSubscriptionId?: string;
+    readonly signal?: AbortSignal;
+}
+export interface MailProviderUpsertPushSubscriptionResult {
+    readonly providerSubscriptionId: string;
+    readonly renewAfter: string;
+    readonly expiresAt: string;
+}
+export interface MailProviderPushNotification {
+    readonly providerSubscriptionId?: string;
+    readonly accountAddress?: string;
+    readonly clientState?: string;
+}
+export interface MailProviderPushNotificationInput {
+    readonly query: Readonly<Record<string, string>>;
+    readonly body: unknown;
+}
+export interface MailProviderPushNotificationResult {
+    readonly challengeResponse?: string;
+    readonly notifications: readonly MailProviderPushNotification[];
+}
+export interface MailProviderPushNotifications {
+    parse(input: MailProviderPushNotificationInput): MailProviderResult<MailProviderPushNotificationResult>;
+}
+/** Provider-normalized message before mail core assigns local identifiers. */
+export interface NormalizedMailMessage {
+    readonly draftRevision?: number;
+    readonly contentStatus?: 'complete' | 'deferred' | 'failed';
+    readonly contentError?: string;
+    readonly size?: number;
+    readonly draftSource?: {
+        readonly replyToMessageId?: string;
+        readonly forwardOfMessageId?: string;
+    };
+    readonly remoteDraftFingerprint?: string;
+    readonly providerMessageId: string;
+    readonly providerDraftId?: string;
+    readonly providerDraftMessageId?: string;
+    readonly internetMessageId?: string;
+    readonly providerConversationId?: string;
+    readonly providerFolderIds: readonly string[];
+    readonly from?: MailAddress;
+    readonly to: readonly MailAddress[];
+    readonly cc: readonly MailAddress[];
+    readonly bcc: readonly MailAddress[];
+    readonly replyTo: readonly MailAddress[];
+    readonly inReplyTo?: string;
+    readonly references: readonly string[];
+    readonly subject: string;
+    readonly preview?: string;
+    readonly text?: string;
+    readonly html?: string;
+    readonly receivedAt?: string;
+    readonly sentAt?: string;
+    readonly read: boolean;
+    readonly starred: boolean;
+    readonly draft: boolean;
+    readonly draftConflict?: MailDraftConflict;
+    readonly attachments: readonly NormalizedMailAttachment[];
+}
+export interface NormalizedMailFolder {
+    readonly providerFolderId: string;
+    readonly type: MailFolderType;
+    readonly name: string;
+    readonly unreadCount?: number;
+    readonly kind: 'folder' | 'label';
+}
+export interface MailProviderUpdateLabelsInput {
+    readonly addLabelIds: readonly string[];
+    readonly removeLabelIds: readonly string[];
+    readonly signal?: AbortSignal;
+}
+export interface MailProviderAttachmentInput {
+    readonly fileName: string;
+    readonly contentType: string;
+    readonly size: number;
+    readonly contentId?: string;
+    readonly inline: boolean;
+    open(): Promise<ReadableStream<Uint8Array>>;
+}
+/** Immutable snapshot prepared by mail core for one Provider submission. */
+export interface MailProviderMessageInput {
+    readonly to: readonly MailAddress[];
+    readonly cc: readonly MailAddress[];
+    readonly bcc: readonly MailAddress[];
+    readonly subject: string;
+    readonly text: string;
+    readonly html?: string;
+    readonly attachments: readonly MailProviderAttachmentInput[];
+    /** Provider attachment IDs retained from an existing draft. */
+    readonly retainedProviderAttachmentIds?: readonly string[];
+    readonly internetMessageId?: string;
+    readonly inReplyTo?: string;
+    readonly references: readonly string[];
+    readonly providerConversationId?: string;
+    /** Existing Provider draft message to update or send. */
+    readonly draftProviderMessageId?: string;
+    readonly draftProviderDraftId?: string;
+    /** Provider message used as the reply target, resolved by Mail Core. */
+    readonly replyToProviderMessageId?: string;
+    /** Provider message used as the forward source, resolved by Mail Core. */
+    readonly forwardOfProviderMessageId?: string;
+    /** Preserve the supplied forward body while retaining source attachments. */
+    readonly forwardBodyIncluded?: boolean;
+    /** The supplied reply already contains the original message. */
+    readonly replyBodyIncluded?: boolean;
+}
+export type MailProviderSendResult = {
+    readonly status: 'accepted';
+    readonly providerMessageId?: string;
+    readonly internetMessageId?: string;
+    readonly sentCopyError?: MailProviderError;
+    readonly recipientError?: MailProviderError;
+} | {
+    readonly status: 'failed';
+    readonly error: MailProviderError;
+} | {
+    readonly status: 'submission_unknown';
+    readonly error: MailProviderError;
+};
+export interface MailProviderAdapter {
+    readonly identity: MailProviderIdentity;
+    readonly capabilities: MailProviderCapabilities;
+    readonly pushNotificationsConfigured?: boolean;
+    refreshAuthorization?(signal?: AbortSignal): Promise<MailProviderResult<MailAuthorizedAccount>>;
+    listFolders?(input: MailProviderListFoldersInput): Promise<MailProviderResult<MailProviderFolderPage>>;
+    createLabel?(name: string, signal?: AbortSignal): Promise<MailProviderResult<NormalizedMailFolder>>;
+    updateLabels?(providerMessageId: string, input: MailProviderUpdateLabelsInput): Promise<MailProviderResult<void>>;
+    reconcileSyncCursor?(cursor: MailSyncCursor | undefined, providerFolderIds: readonly string[]): MailProviderResult<MailSyncCursor>;
+    listMessages?(input: MailProviderListMessagesInput): Promise<MailProviderResult<MailProviderMessagePage>>;
+    listChanges?(input: MailProviderListChangesInput): Promise<MailProviderResult<MailProviderChangePage>>;
+    getCurrentSyncCursor?(signal?: AbortSignal): Promise<MailProviderResult<MailSyncCursor>>;
+    getMessage?(providerMessageId: string, signal?: AbortSignal): Promise<MailProviderResult<NormalizedMailMessage>>;
+    getAttachment?(providerMessageId: string, providerAttachmentId: string, signal?: AbortSignal): Promise<MailProviderResult<MailAttachmentContent>>;
+    sendMessage?(input: MailProviderSendInput): Promise<MailProviderSendResult>;
+    saveDraft?(input: MailProviderSendInput): Promise<MailProviderResult<NormalizedMailMessage>>;
+    updateDraft?(providerMessageId: string, input: MailProviderSendInput): Promise<MailProviderResult<NormalizedMailMessage>>;
+    setRead?(providerMessageId: string, read: boolean, signal?: AbortSignal): Promise<MailProviderResult<void>>;
+    setStarred?(providerMessageId: string, starred: boolean, signal?: AbortSignal): Promise<MailProviderResult<void>>;
+    moveMessage?(providerMessageId: string, providerFolderId: string, signal?: AbortSignal): Promise<MailProviderResult<MailProviderMoveResult>>;
+    deleteMessage?(providerMessageId: string, permanently: boolean, signal?: AbortSignal): Promise<MailProviderResult<void>>;
+    upsertPushSubscription?(input: MailProviderUpsertPushSubscriptionInput): Promise<MailProviderResult<MailProviderUpsertPushSubscriptionResult>>;
+    deletePushSubscription?(providerSubscriptionId: string, signal?: AbortSignal): Promise<MailProviderResult<void>>;
+    close?(): Promise<void>;
+}
+export interface MailProviderContext {
+    readonly publicBasePath: string;
+    readonly credentials: MailCredentialVault;
+}
+export interface MailCredentialVault {
+    put(value: unknown, options?: {
+        readonly purpose?: 'account' | 'authorization';
+        readonly expiresAt?: string;
+    }): Promise<string>;
+    get<T>(reference: string): Promise<T>;
+    replace(reference: string, value: unknown): Promise<void>;
+    getOrRefresh<T>(reference: string, isFresh: (value: T) => boolean, refresh: (value: T, signal?: AbortSignal) => Promise<T>, signal?: AbortSignal): Promise<T>;
+    delete(reference: string): Promise<void>;
+    deleteExpired?(now: string): Promise<number>;
+}
+export interface MailProviderMoveResult {
+    /** Some Providers assign a new message identifier when moving a message. */
+    readonly providerMessageId: string;
+}
+export interface MailProviderAuthorization<TConfig extends MailProviderConfig = MailProviderConfig> {
+    start(context: MailProviderContext, config: TConfig, input: Omit<MailAuthorizationStartInput, 'provider'>): Promise<MailProviderResult<MailAuthorizationStartResult>>;
+    complete(context: MailProviderContext, config: TConfig, input: MailProviderAuthorizationCallbackInput): Promise<MailProviderResult<MailAuthorizedAccount>>;
+}
+export interface MailProviderConnection<TConfig extends MailProviderConfig = MailProviderConfig> {
+    connect(context: MailProviderContext, config: TConfig, input: MailProviderConnectInput): Promise<MailProviderResult<MailAuthorizedAccount>>;
+}
+export interface MailProviderDefinition<TConfig extends MailProviderConfig = MailProviderConfig> {
+    readonly type: TConfig['type'];
+    readonly label: string;
+    readonly capabilities: MailProviderCapabilities;
+    validateConfig?(config: TConfig): void;
+    readonly authorization?: MailProviderAuthorization<TConfig>;
+    readonly connection?: MailProviderConnection<TConfig>;
+    readonly push?: MailProviderPushNotifications;
+    createAdapter(context: MailProviderContext, config: TConfig, account: MailProviderAccount): Promise<MailProviderAdapter>;
+}
+export interface MailProviderRegistry {
+    register(definition: MailProviderDefinition): MailProviderRegistry;
+    definition(type: string): MailProviderDefinition | undefined;
+    definitions(): readonly MailProviderDefinition[];
+}
+export interface MailProviderAdapterResolver {
+    resolve(account: MailAccount, signal?: AbortSignal): Promise<MailProviderAdapter>;
+}
+export declare function defineMailProviderDefinition<TConfig extends MailProviderConfig>(definition: MailProviderDefinition<TConfig>): MailProviderDefinition<TConfig>;
+//# sourceMappingURL=provider.d.ts.map

package/dist/server/contracts/provider.d.ts.map

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

package/dist/server/contracts/provider.js

@@ -0,0 +1,4 @@
+export function defineMailProviderDefinition(definition) {
+    return definition;
+}
+//# sourceMappingURL=provider.js.map

package/dist/server/contracts/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../../server/contracts/provider.ts"],"names":[],"mappings":"AA2bA,MAAM,UAAU,4BAA4B,CAG1C,UAA2C;IAE3C,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/server/contracts/service.d.ts

@@ -0,0 +1,82 @@
+import type { MailAccount, MailAccountView, MailAttachmentContent, MailAuthorizationStartResult, MailBulkComposeInput, MailCompleteAuthorizationInput, MailComposeInput, MailConnectAccountInput, MailDeleteMessageInput, MailFolder, MailIdentity, MailLabel, MailListConversationMessagesInput, MailListMessagesInput, MailManagedAccountView, MailManagementMessageActionInput, MailManagementMessageActionResult, MailMessage, MailMessageSummary, MailMoveMessageInput, MailOffsetPage, MailOperationContext, MailOutboundAttachmentView, MailPage, MailProviderView, MailResolveDraftConflictInput, MailSaveLabelInput, MailSaveSignatureInput, MailSaveTemplateInput, MailSignature, MailStartAuthorizationInput, MailStartSyncInput, MailSubmissionLogView, MailSubmissionView, MailSyncRunView, MailTemplate, MailUpdateAccountInput, MailUpdateIdentityInput, MailUpdateLabelInput, MailUpdateSignatureInput, MailUpdateTemplateInput, MailUpdateMessageInput, MailUpdateMessageLabelsInput, MailUploadAttachmentInput } from '../../shared/mail.js';
+/**
+ * Server facade for consuming Mail operations from another application plugin.
+ * Resolve it with `mailServiceToken`; custom providers extend Mail through
+ * `MailProviderDefinition` rather than implementing this service.
+ */
+export interface MailService {
+    listProviders(): Promise<readonly MailProviderView[]>;
+    startAuthorization(context: MailOperationContext, input: MailStartAuthorizationInput): Promise<MailAuthorizationStartResult>;
+    connectAccount(context: MailOperationContext, input: MailConnectAccountInput): Promise<MailAccountView>;
+    completeAuthorization(input: MailCompleteAuthorizationInput): Promise<MailAccountView>;
+    listAccounts(context: MailOperationContext): Promise<readonly MailAccountView[]>;
+    updateAccount(context: MailOperationContext, input: MailUpdateAccountInput): Promise<MailAccountView>;
+    /**
+     * Mark an account for removal; a background task deletes it. Answers the account in its `removing` state, or
+     * `undefined` when the removal already finished.
+     */
+    removeAccount(context: MailOperationContext, accountId: string): Promise<MailAccountView | undefined>;
+    listManagedAccounts(context: MailOperationContext): Promise<readonly MailManagedAccountView[]>;
+    /** Every user's sync runs, newest first, one page at a time. */
+    listManagedSyncRunsPage(context: MailOperationContext, offset: number, limit: number): Promise<MailOffsetPage<MailSyncRunView>>;
+    /** Every user's submissions, newest first, one page at a time. */
+    listManagedSubmissionsPage(context: MailOperationContext, offset: number, limit: number): Promise<MailOffsetPage<MailSubmissionLogView>>;
+    listManagedFolders(context: MailOperationContext, accountId: string): Promise<readonly MailFolder[]>;
+    listManagedMessages(context: MailOperationContext, input: MailListMessagesInput): Promise<MailPage<MailMessageSummary>>;
+    getManagedMessage(context: MailOperationContext, accountId: string, messageId: string): Promise<MailMessage | undefined>;
+    getManagedAttachment(context: MailOperationContext, accountId: string, messageId: string, attachmentId: string): Promise<MailAttachmentContent>;
+    manageMessages(context: MailOperationContext, input: MailManagementMessageActionInput): Promise<MailManagementMessageActionResult>;
+    listFolders(context: MailOperationContext, accountId: string): Promise<readonly MailFolder[]>;
+    listLabels(context: MailOperationContext): Promise<readonly MailLabel[]>;
+    listIdentities(context: MailOperationContext, accountId: string): Promise<readonly MailIdentity[]>;
+    updateIdentity(context: MailOperationContext, input: MailUpdateIdentityInput): Promise<MailIdentity>;
+    listSignatures(context: MailOperationContext, accountId: string): Promise<readonly MailSignature[]>;
+    saveSignature(context: MailOperationContext, input: MailSaveSignatureInput): Promise<MailSignature>;
+    updateSignature(context: MailOperationContext, input: MailUpdateSignatureInput): Promise<MailSignature>;
+    deleteSignature(context: MailOperationContext, accountId: string, signatureId: string): Promise<void>;
+    createLabel(context: MailOperationContext, input: MailSaveLabelInput): Promise<MailLabel>;
+    updateLabel(context: MailOperationContext, input: MailUpdateLabelInput): Promise<MailLabel>;
+    deleteLabel(context: MailOperationContext, labelId: string): Promise<void>;
+    updateMessageLabels(context: MailOperationContext, input: MailUpdateMessageLabelsInput): Promise<MailMessage>;
+    getUnreadCount(context: MailOperationContext): Promise<number>;
+    startSync(context: MailOperationContext, input: MailStartSyncInput): Promise<MailSyncRunView>;
+    getSyncRun(context: MailOperationContext, syncRunId: string): Promise<MailSyncRunView | undefined>;
+    listSyncRunsPage(context: MailOperationContext, offset?: number, limit?: number): Promise<MailOffsetPage<MailSyncRunView>>;
+    listSubmissionsPage(context: MailOperationContext, bulkOnly?: boolean, offset?: number, groupByBatch?: boolean, limit?: number): Promise<MailOffsetPage<MailSubmissionLogView>>;
+    listSyncRuns(context: MailOperationContext, offset?: number, limit?: number): Promise<readonly MailSyncRunView[]>;
+    retrySyncRun(context: MailOperationContext, syncRunId: string): Promise<MailSyncRunView>;
+    cancelSyncRun(context: MailOperationContext, syncRunId: string): Promise<MailSyncRunView>;
+    retrySubmission(context: MailOperationContext, submissionId: string): Promise<MailSubmissionLogView>;
+    cancelSubmission(context: MailOperationContext, submissionId: string): Promise<MailSubmissionLogView>;
+    listSubmissions(context: MailOperationContext, bulkOnly?: boolean, offset?: number, groupByBatch?: boolean, limit?: number): Promise<readonly MailSubmissionLogView[]>;
+    listMessages(context: MailOperationContext, input: MailListMessagesInput): Promise<MailPage<MailMessageSummary>>;
+    retryMessageContent(context: MailOperationContext, accountId: string, messageId: string): Promise<MailMessage>;
+    getMessage(context: MailOperationContext, accountId: string, messageId: string): Promise<MailMessage | undefined>;
+    getAttachment(context: MailOperationContext, accountId: string, messageId: string, attachmentId: string): Promise<MailAttachmentContent>;
+    listConversationMessages(context: MailOperationContext, accountId: string, conversationId: string, input?: MailListConversationMessagesInput): Promise<MailPage<MailMessage>>;
+    sendMessage(context: MailOperationContext, input: MailComposeInput): Promise<MailSubmissionView>;
+    sendBulk(context: MailOperationContext, input: MailBulkComposeInput): Promise<readonly MailSubmissionView[]>;
+    saveDraft(context: MailOperationContext, input: MailComposeInput): Promise<MailMessage>;
+    resolveDraftConflict(context: MailOperationContext, input: MailResolveDraftConflictInput): Promise<MailMessage>;
+    getUploadedAttachment(context: MailOperationContext, attachmentId: string): Promise<MailAttachmentContent>;
+    uploadAttachment(context: MailOperationContext, input: MailUploadAttachmentInput): Promise<MailOutboundAttachmentView>;
+    listTemplates(context: MailOperationContext): Promise<readonly MailTemplate[]>;
+    saveTemplate(context: MailOperationContext, input: MailSaveTemplateInput): Promise<MailTemplate>;
+    updateTemplate(context: MailOperationContext, input: MailUpdateTemplateInput): Promise<MailTemplate>;
+    deleteTemplate(context: MailOperationContext, templateId: string): Promise<void>;
+    updateMessage(context: MailOperationContext, input: MailUpdateMessageInput): Promise<MailMessage>;
+    moveMessage(context: MailOperationContext, input: MailMoveMessageInput): Promise<MailMessage>;
+    deleteMessage(context: MailOperationContext, input: MailDeleteMessageInput): Promise<void>;
+}
+/** Background delivery and synchronization lifecycle owned by the Mail provider. */
+export interface MailRuntimeService {
+    start(): Promise<void>;
+    scheduleAutomaticSync(): void;
+    createAutomaticSyncRuns(): Promise<number>;
+    schedulePushSync(accountId: string): Promise<boolean>;
+    schedulePushSyncBatch(accounts: readonly MailAccount[]): Promise<void>;
+    kick(): void;
+    publishPending(): Promise<void>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=service.d.ts.map

package/dist/server/contracts/service.d.ts.map

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

package/dist/server/contracts/service.js

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

package/dist/server/contracts/service.js.map

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

package/dist/server/credentials.d.ts

@@ -0,0 +1,24 @@
+import type { DatabaseManager } from '@nocobase/db';
+import type { MailCredentialVault } from './contracts/provider.js';
+export declare class DatabaseMailCredentialVault implements MailCredentialVault {
+    private readonly database;
+    private readonly refreshLeaseMs;
+    private readonly refreshPollMs;
+    private readonly refreshTimeoutMs;
+    private readonly refreshes;
+    constructor(database: DatabaseManager, refreshLeaseMs?: number, refreshPollMs?: number, refreshTimeoutMs?: number);
+    put(value: unknown, options?: {
+        readonly purpose?: 'account' | 'authorization';
+        readonly expiresAt?: string;
+    }): Promise<string>;
+    get<T>(reference: string): Promise<T>;
+    replace(reference: string, value: unknown): Promise<void>;
+    getOrRefresh<T>(reference: string, isFresh: (value: T) => boolean, refresh: (value: T, signal?: AbortSignal) => Promise<T>, signal?: AbortSignal): Promise<T>;
+    private refreshWithLease;
+    private maintainRefreshLease;
+    private releaseRefreshLease;
+    delete(reference: string): Promise<void>;
+    deleteExpired(now: string): Promise<number>;
+}
+export declare function createDatabaseMailCredentialVault(database: DatabaseManager): DatabaseMailCredentialVault;
+//# sourceMappingURL=credentials.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"credentials.d.ts","sourceRoot":"","sources":["../../server/credentials.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAO,MAAM,cAAc,CAAC;AAEzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAiBnE,qBAAa,2BAA4B,YAAW,mBAAmB;IAInE,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IANnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAuC;gBAG9C,QAAQ,EAAE,eAAe,EACzB,cAAc,GAAE,MAAyB,EACzC,aAAa,GAAE,MAAwB,EACvC,gBAAgB,GAAE,MAA2B;IAGnD,GAAG,CACd,KAAK,EAAE,OAAO,EACd,OAAO,GAAE;QACP,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,GAAG,eAAe,CAAC;QAC/C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;KACxB,GACL,OAAO,CAAC,MAAM,CAAC;IAkBL,GAAG,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAWrC,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAezD,YAAY,CAAC,CAAC,EACzB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,EAC9B,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,EACvD,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,CAAC,CAAC;YAuBC,gBAAgB;YA0GhB,oBAAoB;YAyBpB,mBAAmB;IAapB,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQxC,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CASzD;AA6DD,wBAAgB,iCAAiC,CAC/C,QAAQ,EAAE,eAAe,GACxB,2BAA2B,CAE7B"}