@aitne/daemon 0.1.0

package/dist/services/mail/imap/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../../src/services/mail/imap/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEpC,OAAO,EAAE,iBAAiB,EAA0B,MAAM,mBAAmB,CAAC;AAE9E,MAAM,wBAAwB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAEhD,MAAM,UAAU,oBAAoB,CAClC,MAAyB,EACzB,YAAqC,EAAE;IAEvC,OAAO,IAAI,QAAQ,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI;QACtB,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI;QACtB,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM;QAC1B,IAAI,EAAE;YACJ,IAAI,EAAE,MAAM,CAAC,KAAK;YAClB,IAAI,EAAE,MAAM,CAAC,WAAW;YACxB,uEAAuE;YACvE,kEAAkE;YAClE,4DAA4D;SAC7D;QACD,eAAe,EAAE,IAAI;QACrB,WAAW,EAAE,wBAAwB;QACrC,uEAAuE;QACvE,gEAAgE;QAChE,uEAAuE;QACvE,6DAA6D;QAC7D,OAAO,EAAE,IAAI;QACb,GAAG,SAAS;KACb,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,MAAyB;IAEzB,MAAM,MAAM,GAAG,oBAAoB,CAAC,MAAM,EAAE;QAC1C,UAAU,EAAE,IAAI;QAChB,gBAAgB,EAAE,IAAI;QACtB,oEAAoE;QACpE,wEAAwE;QACxE,2DAA2D;QAC3D,aAAa,EAAE,MAAM;KACtB,CAAC,CAAC;IACH,qEAAqE;IACrE,qEAAqE;IACrE,yEAAyE;IACzE,iCAAiC;IACjC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAC7B,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;IACzB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,uEAAuE;QACvE,4CAA4C;QAC5C,MAAM,CAAC,KAAK,EAAE,CAAC;QACf,MAAM,GAAG,CAAC;IACZ,CAAC;IACD,OAAO,iBAAiB,CACrB,MAAgD,CAAC,YAIrC,CACd,CAAC;AACJ,CAAC"}

package/dist/services/mail/imap/cursor.d.ts

@@ -0,0 +1,19 @@
+import type { PollCursor } from "../provider.js";
+export interface ImapFolderCursorState {
+    uidValidity: number;
+    lastUid: number;
+}
+export interface ImapCursorPlan {
+    mode: "bootstrap" | "resume" | "resync";
+    lastSeenUid: number;
+    previousUidValidity: number | null;
+}
+export declare function formatImapProviderMsgId(uidValidity: number, uid: number): string;
+export declare function parseImapProviderMsgId(value: string): {
+    uidValidity: number;
+    uid: number;
+} | null;
+export declare function getImapFolderCursor(cursor: PollCursor | null, folder: string): ImapFolderCursorState | null;
+export declare function planImapFolderSync(cursor: PollCursor | null, folder: string, serverUidValidity: number): ImapCursorPlan;
+export declare function advanceImapCursor(cursor: PollCursor | null, folder: string, uidValidity: number, lastUid: number): PollCursor;
+//# sourceMappingURL=cursor.d.ts.map

package/dist/services/mail/imap/cursor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.d.ts","sourceRoot":"","sources":["../../../../src/services/mail/imap/cursor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,WAAW,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC;AAED,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,MAAM,GACV,MAAM,CAER;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,GACZ;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAO7C;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,UAAU,GAAG,IAAI,EACzB,MAAM,EAAE,MAAM,GACb,qBAAqB,GAAG,IAAI,CAG9B;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,UAAU,GAAG,IAAI,EACzB,MAAM,EAAE,MAAM,EACd,iBAAiB,EAAE,MAAM,GACxB,cAAc,CAqBhB;AAED,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,UAAU,GAAG,IAAI,EACzB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,GACd,UAAU,CAOZ"}

package/dist/services/mail/imap/cursor.js

@@ -0,0 +1,47 @@
+export function formatImapProviderMsgId(uidValidity, uid) {
+    return `${uidValidity}:${uid}`;
+}
+export function parseImapProviderMsgId(value) {
+    const match = value.match(/^(\d+):(\d+)$/);
+    if (!match)
+        return null;
+    return {
+        uidValidity: Number.parseInt(match[1], 10),
+        uid: Number.parseInt(match[2], 10),
+    };
+}
+export function getImapFolderCursor(cursor, folder) {
+    if (!cursor || cursor.kind !== "imap")
+        return null;
+    return cursor.folders[folder] ?? null;
+}
+export function planImapFolderSync(cursor, folder, serverUidValidity) {
+    const existing = getImapFolderCursor(cursor, folder);
+    if (!existing) {
+        return {
+            mode: "bootstrap",
+            lastSeenUid: 0,
+            previousUidValidity: null,
+        };
+    }
+    if (existing.uidValidity !== serverUidValidity) {
+        return {
+            mode: "resync",
+            lastSeenUid: 0,
+            previousUidValidity: existing.uidValidity,
+        };
+    }
+    return {
+        mode: "resume",
+        lastSeenUid: existing.lastUid,
+        previousUidValidity: existing.uidValidity,
+    };
+}
+export function advanceImapCursor(cursor, folder, uidValidity, lastUid) {
+    const folders = cursor?.kind === "imap"
+        ? { ...cursor.folders }
+        : {};
+    folders[folder] = { uidValidity, lastUid };
+    return { kind: "imap", folders };
+}
+//# sourceMappingURL=cursor.js.map

package/dist/services/mail/imap/cursor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.js","sourceRoot":"","sources":["../../../../src/services/mail/imap/cursor.ts"],"names":[],"mappings":"AAaA,MAAM,UAAU,uBAAuB,CACrC,WAAmB,EACnB,GAAW;IAEX,OAAO,GAAG,WAAW,IAAI,GAAG,EAAE,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,KAAa;IAEb,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IAC3C,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,OAAO;QACL,WAAW,EAAE,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC;QAC3C,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC;KACpC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,MAAyB,EACzB,MAAc;IAEd,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IACnD,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,MAAyB,EACzB,MAAc,EACd,iBAAyB;IAEzB,MAAM,QAAQ,GAAG,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO;YACL,IAAI,EAAE,WAAW;YACjB,WAAW,EAAE,CAAC;YACd,mBAAmB,EAAE,IAAI;SAC1B,CAAC;IACJ,CAAC;IACD,IAAI,QAAQ,CAAC,WAAW,KAAK,iBAAiB,EAAE,CAAC;QAC/C,OAAO;YACL,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,CAAC;YACd,mBAAmB,EAAE,QAAQ,CAAC,WAAW;SAC1C,CAAC;IACJ,CAAC;IACD,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,QAAQ,CAAC,OAAO;QAC7B,mBAAmB,EAAE,QAAQ,CAAC,WAAW;KAC1C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,MAAyB,EACzB,MAAc,EACd,WAAmB,EACnB,OAAe;IAEf,MAAM,OAAO,GACX,MAAM,EAAE,IAAI,KAAK,MAAM;QACrB,CAAC,CAAC,EAAE,GAAG,MAAM,CAAC,OAAO,EAAE;QACvB,CAAC,CAAC,EAAE,CAAC;IACT,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC;IAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AACnC,CAAC"}

package/dist/services/mail/imap/folder-resolver.d.ts

@@ -0,0 +1,24 @@
+import type { CanonicalFolder } from "../provider.js";
+export type ImapFolderRole = CanonicalFolder | "archive";
+export interface ImapListedFolder {
+    path: string;
+    name?: string;
+    specialUse?: string | string[] | null;
+    flags?: Iterable<string> | null;
+}
+export interface ResolvedImapFolders {
+    inbox: string;
+    sent: string;
+    drafts: string;
+    trash: string;
+    archive: string;
+}
+export declare function resolveSpecialUseFolder(folders: readonly ImapListedFolder[], role: ImapFolderRole, fallbackName: string): string;
+export declare function deriveCanonicalFolder(folder: ImapListedFolder): CanonicalFolder | undefined;
+export declare function resolveImapFolders(folders: readonly ImapListedFolder[], hints: {
+    sent: string;
+    drafts: string;
+    trash: string;
+    archive: string;
+}): ResolvedImapFolders;
+//# sourceMappingURL=folder-resolver.d.ts.map

package/dist/services/mail/imap/folder-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"folder-resolver.d.ts","sourceRoot":"","sources":["../../../../src/services/mail/imap/folder-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD,MAAM,MAAM,cAAc,GAAG,eAAe,GAAG,SAAS,CAAC;AAEzD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAAC;IACtC,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;CACjC;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAYD,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,SAAS,gBAAgB,EAAE,EACpC,IAAI,EAAE,cAAc,EACpB,YAAY,EAAE,MAAM,GACnB,MAAM,CAcR;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,gBAAgB,GACvB,eAAe,GAAG,SAAS,CAgB7B;AAED,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,SAAS,gBAAgB,EAAE,EACpC,KAAK,EAAE;IACL,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB,GACA,mBAAmB,CAQrB"}

package/dist/services/mail/imap/folder-resolver.js

@@ -0,0 +1,58 @@
+const SPECIAL_USE_ROLE_MAP = {
+    inbox: "inbox",
+    sent: "sent",
+    drafts: "drafts",
+    trash: "trash",
+    archive: "archive",
+    junk: "spam",
+    spam: "spam",
+};
+export function resolveSpecialUseFolder(folders, role, fallbackName) {
+    const bySpecialUse = folders.find((folder) => normalizeFolderFlags(folder).some((token) => SPECIAL_USE_ROLE_MAP[token] === role));
+    if (bySpecialUse)
+        return bySpecialUse.path;
+    const byName = folders.find((folder) => folder.path.localeCompare(fallbackName, undefined, { sensitivity: "accent" }) === 0);
+    if (byName)
+        return byName.path;
+    return fallbackName;
+}
+export function deriveCanonicalFolder(folder) {
+    const roles = normalizeFolderFlags(folder)
+        .map((token) => SPECIAL_USE_ROLE_MAP[token])
+        .filter((value) => value !== undefined && value !== "archive");
+    if (roles.length > 0)
+        return roles[0];
+    const lowered = folder.path.trim().toLowerCase();
+    if (lowered === "inbox")
+        return "inbox";
+    if (lowered.includes("sent"))
+        return "sent";
+    if (lowered.includes("draft"))
+        return "drafts";
+    if (lowered.includes("trash") || lowered.includes("deleted"))
+        return "trash";
+    if (lowered.includes("spam") || lowered.includes("junk"))
+        return "spam";
+    return undefined;
+}
+export function resolveImapFolders(folders, hints) {
+    return {
+        inbox: resolveSpecialUseFolder(folders, "inbox", "INBOX"),
+        sent: resolveSpecialUseFolder(folders, "sent", hints.sent),
+        drafts: resolveSpecialUseFolder(folders, "drafts", hints.drafts),
+        trash: resolveSpecialUseFolder(folders, "trash", hints.trash),
+        archive: resolveSpecialUseFolder(folders, "archive", hints.archive),
+    };
+}
+function normalizeFolderFlags(folder) {
+    const specialUse = Array.isArray(folder.specialUse)
+        ? folder.specialUse
+        : folder.specialUse
+            ? [folder.specialUse]
+            : [];
+    const flags = folder.flags ? Array.from(folder.flags) : [];
+    return [...specialUse, ...flags]
+        .map((value) => value.trim().replaceAll(/^\\+/g, "").toLowerCase())
+        .filter((value) => value.length > 0);
+}
+//# sourceMappingURL=folder-resolver.js.map

package/dist/services/mail/imap/folder-resolver.js.map

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

package/dist/services/mail/imap/icloud-provider.d.ts

@@ -0,0 +1,5 @@
+import { ImapProviderBase } from "./imap-provider-base.js";
+export declare class ICloudImapProvider extends ImapProviderBase {
+    readonly kind: "icloud";
+}
+//# sourceMappingURL=icloud-provider.d.ts.map

package/dist/services/mail/imap/icloud-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"icloud-provider.d.ts","sourceRoot":"","sources":["../../../../src/services/mail/imap/icloud-provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,qBAAa,kBAAmB,SAAQ,gBAAgB;IACtD,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAU;CACnC"}

package/dist/services/mail/imap/icloud-provider.js

@@ -0,0 +1,5 @@
+import { ImapProviderBase } from "./imap-provider-base.js";
+export class ICloudImapProvider extends ImapProviderBase {
+    kind = "icloud";
+}
+//# sourceMappingURL=icloud-provider.js.map

package/dist/services/mail/imap/icloud-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"icloud-provider.js","sourceRoot":"","sources":["../../../../src/services/mail/imap/icloud-provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,MAAM,OAAO,kBAAmB,SAAQ,gBAAgB;IAC7C,IAAI,GAAG,QAAiB,CAAC;CACnC"}

package/dist/services/mail/imap/imap-provider-base.d.ts

@@ -0,0 +1,173 @@
+import { ImapFlow } from "imapflow";
+import type { DraftDetail, DraftSummary, FolderInfo, ListQuery, MailAccount, MailMessage, MailMessageSummary, MailProvider, PollCursor, PollResult, SendInput, SendResult, TagCatalog, ThreadView } from "../provider.js";
+import type { ImapAccountSecret, ImapAppPasswordKind } from "./app-password.js";
+import { type ResolvedImapFolders } from "./folder-resolver.js";
+import { type ImapCapabilitySet } from "./capabilities.js";
+/**
+ * Real-time deletion event surfaced by IDLE when QRESYNC is enabled.
+ * `providerMsgId` is pre-formatted as `${uidValidity}:${uid}` so callers
+ * can soft-delete from `mail_messages_index` without re-hashing.
+ */
+export interface ExpungeNotification {
+    folder: string;
+    uid: number;
+    uidValidity: number;
+    providerMsgId: string;
+}
+export interface IdleHandlers {
+    /** Called on any IDLE signal (new message, expunge). Triggers a re-poll. */
+    onDirty: () => void;
+    /**
+     * Called once per VANISHED response when QRESYNC is live on the server.
+     * On non-QRESYNC servers EXPUNGE notifications only carry sequence
+     * numbers and this is NOT invoked — callers should fall back to the
+     * reconcile observer for deletion detection on those accounts.
+     */
+    onExpunge?: (event: ExpungeNotification) => void;
+}
+export interface IdleCapableMailProvider extends MailProvider {
+    startIdle(handlers: IdleHandlers): Promise<void>;
+    stopIdle(): Promise<void>;
+}
+/**
+ * Surface a provider exposes to the deletion-reconciliation observer
+ * (§3.1.1). Keeping this as a structural interface — rather than requiring
+ * `instanceof ImapProviderBase` — lets future IMAP-over-something providers
+ * participate without inheritance coupling.
+ */
+export interface ImapReconcileSource {
+    readonly account: MailAccount;
+    listExistingUids(folder: string, options: {
+        sinceUid?: number;
+    }): Promise<{
+        uidValidity: number;
+        uids: number[];
+    }>;
+    getCapabilities(): ImapCapabilitySet | null;
+}
+export declare function isImapReconcileSource(provider: unknown): provider is ImapReconcileSource;
+/**
+ * Fired once per provider instance, on the first successful connect. Phase 4
+ * uses this to persist the CAPABILITY probe result on the account row so
+ * Phase 7 can branch on it without reprobing. Must be fire-and-forget — the
+ * base class does not await the returned promise so a slow DB write cannot
+ * stall IMAP traffic.
+ */
+export type OnCapabilitiesProbed = (accountId: string, capabilities: ImapCapabilitySet) => void | Promise<void>;
+export interface ImapProviderBaseOptions {
+    account: MailAccount;
+    secret: ImapAccountSecret;
+    now?: () => Date;
+    onCapabilitiesProbed?: OnCapabilitiesProbed;
+}
+type ImapFlowLike = InstanceType<typeof ImapFlow>;
+export declare abstract class ImapProviderBase implements IdleCapableMailProvider {
+    abstract readonly kind: ImapAppPasswordKind;
+    readonly account: MailAccount;
+    protected readonly secret: ImapAccountSecret;
+    protected readonly now: () => Date;
+    private clientPromise;
+    private smtpTransport;
+    private resolvedFoldersPromise;
+    private idleCallback;
+    private idleExpungeCallback;
+    private idleListenerClient;
+    private idleLoopClient;
+    private idleLoopPromise;
+    private readonly onCapabilitiesProbed;
+    private capabilities;
+    private capabilitiesProbed;
+    /**
+     * Snapshot of UIDVALIDITY per folder, refreshed on each `mailboxOpen`.
+     * Expunge events need the UIDVALIDITY that was in effect when the message
+     * was observed so we can build the local `provider_msg_id`. Per-client
+     * state — cleared when the client closes so a post-reconnect mismatch
+     * never fabricates stale ids.
+     */
+    private uidValidityByFolder;
+    constructor(options: ImapProviderBaseOptions);
+    /** Most-recently-probed capabilities, or null until first connect finishes. */
+    getCapabilities(): ImapCapabilitySet | null;
+    list(query: ListQuery): Promise<MailMessageSummary[]>;
+    get(id: string): Promise<MailMessage>;
+    getAttachment(messageId: string, attachmentId: string): Promise<{
+        data: Buffer;
+        mimeType: string;
+    } | null>;
+    send(input: SendInput): Promise<SendResult>;
+    modifyTags(id: string, add: string[], remove: string[]): Promise<void>;
+    markRead(id: string, read: boolean): Promise<void>;
+    trash(id: string): Promise<void>;
+    listFolders(): Promise<FolderInfo[]>;
+    pollSince(cursor: PollCursor | null, limit: number): Promise<PollResult>;
+    /**
+     * List UIDs currently present on the server for `folder`. Used by the
+     * reconcile observer (§3.1.1) to diff against the local index and flag
+     * deletions. Returns the server's current UIDVALIDITY alongside so the
+     * caller can skip reconciliation on an epoch mismatch — deletion
+     * reconciliation does not cross UIDVALIDITY boundaries (the poll path's
+     * resync branch owns that case).
+     *
+     * `sinceUid` bounds the walk: callers typically pass `lastUid - K` to cap
+     * the SEARCH on very large folders. Pass `0` (or omit) to walk the folder.
+     */
+    listExistingUids(folder: string, options?: {
+        sinceUid?: number;
+    }): Promise<{
+        uidValidity: number;
+        uids: number[];
+    }>;
+    startIdle(handlers: IdleHandlers): Promise<void>;
+    stopIdle(): Promise<void>;
+    /**
+     * Translate an ImapFlow `expunge` event into an {@link ExpungeNotification}
+     * (if QRESYNC is live and the event carries a UID) plus a generic re-poll
+     * trigger. Non-QRESYNC servers only surface sequence numbers; those are
+     * not resolvable to a provider_msg_id here, so the reconcile observer
+     * (§3.1.1) is the fallback for deletion detection on those accounts.
+     */
+    private handleExpungeEvent;
+    revoke(): Promise<void>;
+    untrash(id: string): Promise<void>;
+    archive(id: string): Promise<void>;
+    listTags(): Promise<TagCatalog>;
+    getThread(threadId: string, limit?: number): Promise<ThreadView>;
+    listDrafts(limit?: number): Promise<DraftSummary[]>;
+    getDraft(draftId: string): Promise<DraftDetail | null>;
+    createDraft(_input: SendInput): Promise<{
+        id: string;
+    }>;
+    updateDraft(): Promise<never>;
+    deleteDraft(): Promise<void>;
+    sendDraft(): Promise<never>;
+    protected locateMessageByRfc822(rfc822MsgId: string): Promise<{
+        folder: string;
+        uid: number;
+        uidValidity: number;
+        message: Record<string, unknown>;
+    } | null>;
+    protected readBodyFromLocated(located: {
+        message: Record<string, unknown>;
+    }): Promise<{
+        text?: string;
+        html?: string;
+    }>;
+    protected getResolvedFolders(): Promise<ResolvedImapFolders>;
+    private loadResolvedFolders;
+    protected getClient(): Promise<ImapFlowLike>;
+    private connectClient;
+    protected recordCapabilities(client: ImapFlowLike): void;
+    private getSmtpTransport;
+    private locateMessage;
+    private getResolvedFoldersValues;
+    private appendMessage;
+    private composeRawMessage;
+    private toSummary;
+    private buildSearchObject;
+    private matchesClientSideQuery;
+    private attachSourceSnippets;
+    private extractSnippetFromSource;
+    private runIdleLoop;
+}
+export {};
+//# sourceMappingURL=imap-provider-base.d.ts.map

package/dist/services/mail/imap/imap-provider-base.d.ts.map

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