fluxmail 0.0.1 → 0.2.0

package/dist/scheduler/sendScheduler.d.ts

@@ -0,0 +1,38 @@
+import { type SendResult } from '@fluxmail/core';
+import type { FluxmailDb } from '../storage/db.js';
+/** The slice of EmailService the scheduler needs. */
+export interface ScheduledSender {
+    send(accountId: string | undefined, input: {
+        draftId: string;
+    }): Promise<SendResult>;
+    /** Throws while a lapsed license leaves the instance over the plan quota. */
+    enforceQuota(): string | undefined;
+}
+/**
+ * Fires scheduled sends when their time comes. Owned by the long-lived
+ * processes (serve/stdio); one-shot CLI commands construct it but never
+ * start() it. Assumes a single long-lived process per database; there is
+ * no cross-process locking.
+ */
+export declare class SendScheduler {
+    private readonly db;
+    private readonly service;
+    private timer;
+    private running;
+    private processing;
+    private rerun;
+    /** Retry gates for transient failures; in-memory only (a restart just retries immediately). */
+    private backoff;
+    /** While over the plan quota, due sends are held and re-checked no sooner than this. */
+    private quotaHoldUntil;
+    constructor(db: FluxmailDb, service: ScheduledSender);
+    /** Starts the loop; immediately fires anything past due (catch-up after downtime). */
+    start(): void;
+    stop(): void;
+    /** Poke after any schedule change (new, canceled, or sent early). */
+    wake(): void;
+    private tick;
+    private fire;
+    private arm;
+}
+//# sourceMappingURL=sendScheduler.d.ts.map

package/dist/scheduler/sendScheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sendScheduler.d.ts","sourceRoot":"","sources":["../../src/scheduler/sendScheduler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAYnD,qDAAqD;AACrD,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACrF,6EAA6E;IAC7E,YAAY,IAAI,MAAM,GAAG,SAAS,CAAC;CACpC;AAUD;;;;;GAKG;AACH,qBAAa,aAAa;IAWtB,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAX1B,OAAO,CAAC,KAAK,CAA6B;IAC1C,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,KAAK,CAAS;IACtB,+FAA+F;IAC/F,OAAO,CAAC,OAAO,CAA6D;IAC5E,wFAAwF;IACxF,OAAO,CAAC,cAAc,CAAK;gBAGR,EAAE,EAAE,UAAU,EACd,OAAO,EAAE,eAAe;IAG3C,sFAAsF;IACtF,KAAK,IAAI,IAAI;IAKb,IAAI,IAAI,IAAI;IAMZ,qEAAqE;IACrE,IAAI,IAAI,IAAI;YAIE,IAAI;YAqCJ,IAAI;IAgClB,OAAO,CAAC,GAAG;CAaZ"}

package/dist/scheduler/sendScheduler.js

@@ -0,0 +1,128 @@
+import { isEmailError } from '@fluxmail/core';
+import { claimScheduledSend, completeClaim, failClaim, holdPending, listActive, listClaimable, retryClaim, } from '../storage/scheduledSends.js';
+/** Re-check at least this often while anything is pending (heals clock jumps and laptop sleep). */
+const MAX_ARM_MS = 15 * 60_000;
+const BASE_BACKOFF_MS = 30_000;
+const CLAIM_LEASE_MS = 5 * 60_000;
+/** Errors that no amount of retrying will fix (e.g. the draft is gone). */
+const PERMANENT_CODES = new Set(['not_found', 'invalid_request', 'unsupported_capability']);
+/**
+ * Fires scheduled sends when their time comes. Owned by the long-lived
+ * processes (serve/stdio); one-shot CLI commands construct it but never
+ * start() it. Assumes a single long-lived process per database; there is
+ * no cross-process locking.
+ */
+export class SendScheduler {
+    db;
+    service;
+    timer;
+    running = false;
+    processing = false;
+    rerun = false;
+    /** Retry gates for transient failures; in-memory only (a restart just retries immediately). */
+    backoff = new Map();
+    /** While over the plan quota, due sends are held and re-checked no sooner than this. */
+    quotaHoldUntil = 0;
+    constructor(db, service) {
+        this.db = db;
+        this.service = service;
+    }
+    /** Starts the loop; immediately fires anything past due (catch-up after downtime). */
+    start() {
+        this.running = true;
+        void this.tick();
+    }
+    stop() {
+        this.running = false;
+        if (this.timer)
+            clearTimeout(this.timer);
+        this.timer = undefined;
+    }
+    /** Poke after any schedule change (new, canceled, or sent early). */
+    wake() {
+        if (this.running)
+            void this.tick();
+    }
+    async tick() {
+        if (!this.running)
+            return;
+        if (this.processing) {
+            this.rerun = true;
+            return;
+        }
+        this.processing = true;
+        try {
+            const now = Date.now();
+            let due = listClaimable(this.db, now)
+                .filter((r) => r.sendAt <= now && (this.backoff.get(r.id)?.notBefore ?? 0) <= now)
+                .sort((a, b) => a.sendAt - b.sendAt);
+            if (due.length) {
+                try {
+                    this.service.enforceQuota();
+                    this.quotaHoldUntil = 0;
+                }
+                catch (err) {
+                    // Over quota after a license lapse: hold due sends (pending, no
+                    // attempt consumed) and re-check later; they fire once the license
+                    // is renewed or usage is trimmed to fit the plan.
+                    this.quotaHoldUntil = now + MAX_ARM_MS;
+                    const message = err instanceof Error ? err.message : String(err);
+                    for (const row of due)
+                        holdPending(this.db, row.id, message);
+                    due = [];
+                }
+            }
+            for (const row of due)
+                await this.fire(row);
+        }
+        finally {
+            this.processing = false;
+        }
+        if (this.rerun) {
+            this.rerun = false;
+            return void this.tick();
+        }
+        this.arm();
+    }
+    async fire(row) {
+        const claim = claimScheduledSend(this.db, row.id, Date.now(), CLAIM_LEASE_MS);
+        if (!claim) {
+            this.backoff.delete(row.id);
+            return;
+        }
+        try {
+            const result = await this.service.send(row.accountId, { draftId: row.draftId });
+            completeClaim(this.db, row.id, claim.token, result);
+            this.backoff.delete(row.id);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            if (isEmailError(err) && PERMANENT_CODES.has(err.code)) {
+                failClaim(this.db, row.id, claim.token, err.code === 'not_found' ? 'Draft no longer exists: it was sent or deleted outside Fluxmail' : message);
+                this.backoff.delete(row.id);
+            }
+            else {
+                // Transient (auth_expired, rate_limited, network): retry forever, late but sent.
+                retryClaim(this.db, row.id, claim.token, message);
+                const attempt = (this.backoff.get(row.id)?.attempt ?? 0) + 1;
+                this.backoff.set(row.id, {
+                    attempt,
+                    notBefore: Date.now() + Math.min(BASE_BACKOFF_MS * 2 ** (attempt - 1), MAX_ARM_MS),
+                });
+            }
+        }
+    }
+    arm() {
+        if (this.timer)
+            clearTimeout(this.timer);
+        this.timer = undefined;
+        const pending = listActive(this.db);
+        if (!pending.length)
+            return;
+        const next = Math.max(Math.min(...pending.map((r) => Math.max(r.sendAt, r.claimUntil ?? 0, this.backoff.get(r.id)?.notBefore ?? 0))), this.quotaHoldUntil);
+        const delay = Math.min(Math.max(next - Date.now(), 0), MAX_ARM_MS);
+        this.timer = setTimeout(() => void this.tick(), delay);
+        this.timer.unref();
+    }
+}
+//# sourceMappingURL=sendScheduler.js.map

package/dist/scheduler/sendScheduler.js.map

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

package/dist/service/emailService.d.ts

@@ -0,0 +1,139 @@
+import { type Account, type AttachmentMeta, type DraftInput, type EmailAddress, type EmailQuery, type Folder, type Message, type ModifyAction, type Page, type PageOpts, type SendResult, type Thread } from '@fluxmail/core';
+import type { AccountRegistry } from '../accounts/registry.js';
+import { type Entitlements } from '../licensing/entitlements.js';
+import type { FluxmailDb } from '../storage/db.js';
+import { type ScheduledSendStatus } from '../storage/scheduledSends.js';
+export interface SendInput extends DraftInput {
+    /** With replyToMessageId: compute recipients from the original (reply-all semantics). */
+    replyAll?: boolean;
+}
+/** The mailboxes an API key may reach: everything for admin keys, shared + owned for member keys. */
+export interface AccessScope {
+    /** Member the key is scoped to; null grants unscoped admin access. */
+    memberId: string | null;
+}
+export interface ForwardInput {
+    messageId: string;
+    to: EmailAddress[];
+    cc?: EmailAddress[];
+    /** Optional note placed above the forwarded content. */
+    comment?: string;
+    includeAttachments?: boolean;
+}
+export interface ServiceStatus {
+    accounts: Array<Pick<Account, 'id' | 'provider' | 'email' | 'status' | 'memberId'> & {
+        error?: {
+            code: string;
+            message: string;
+        };
+        warnings?: string[];
+    }>;
+    /** Instance-wide fields are only returned to administrators. */
+    members?: {
+        count: number;
+    };
+    entitlements?: Entitlements;
+    /** Renewal warning while the license is in grace or has lapsed. */
+    licenseWarning?: string;
+    providersAvailable: string[];
+    scheduled: {
+        pending: number;
+        nextSendAt?: string;
+    };
+}
+export interface ScheduledSendInfo {
+    scheduleId: string;
+    accountId: string;
+    draftId: string;
+    /** ISO 8601 UTC. */
+    sendAt: string;
+    status: ScheduledSendStatus;
+    attempts: number;
+    subject?: string;
+    to?: string;
+    lastError?: string;
+    sentMessageId?: string;
+    sentThreadId?: string;
+}
+/** Parse and validate a sendAt timestamp; returns epoch ms. */
+export declare function resolveSendAt(sendAtIso: string, now?: number): number;
+/**
+ * All business logic lives here: account routing, reply/forward computation,
+ * entitlement enforcement, auth-failure bookkeeping. MCP tools (and the future
+ * REST API / CLI) are thin wrappers over this service.
+ */
+export declare class EmailService {
+    private readonly registry;
+    private readonly db;
+    private readonly scope;
+    /** Wired to SendScheduler.wake() in long-lived processes; a no-op for one-shot CLI commands. */
+    onScheduleChanged: () => void;
+    constructor(registry: AccountRegistry, db: FluxmailDb, scope?: AccessScope);
+    /**
+     * A view of this service restricted to one member's mailboxes (shared + owned).
+     * The HTTP layer scopes each request to the authenticated API key's member;
+     * unscoped admin keys keep full access.
+     */
+    withScope(scope: AccessScope): EmailService;
+    /** Shared mailboxes and, for member keys, the member's own mailboxes. */
+    private canAccess;
+    private accessibleAccounts;
+    /**
+     * Resolve an account id within the current scope. A member-scoped key defaults
+     * to its sole accessible mailbox and can never reach another member's mailbox;
+     * inaccessible ids surface as not_found so a key cannot probe for their existence.
+     */
+    private resolveScopedAccountId;
+    /** Route a call to the right provider, recording auth failures on the account. */
+    private withProvider;
+    listAccounts(): Account[];
+    status(): Promise<ServiceStatus>;
+    /**
+     * Gate for MCP tool calls: throws once a lapsed license leaves the instance
+     * over the entitled caps; returns a renewal warning to attach to results
+     * while the license is in its grace period or has lapsed.
+     */
+    enforceQuota(): string | undefined;
+    private scheduledStatus;
+    listFolders(accountId?: string): Promise<Folder[]>;
+    listMessages(accountId: string | undefined, q: EmailQuery, page?: PageOpts): Promise<Page<Message>>;
+    getMessage(accountId: string | undefined, id: string): Promise<Message>;
+    getThread(accountId: string | undefined, threadId: string): Promise<Thread>;
+    createDraft(accountId: string | undefined, d: SendInput): Promise<Message>;
+    updateDraft(accountId: string | undefined, draftId: string, d: SendInput): Promise<Message>;
+    deleteDraft(accountId: string | undefined, draftId: string): Promise<void>;
+    send(accountId: string | undefined, input: SendInput | {
+        draftId: string;
+    }): Promise<SendResult>;
+    /**
+     * Draft-backed scheduled send: the content becomes a real provider draft
+     * immediately; only the schedule (draft id + fire time) is stored locally.
+     */
+    scheduleSend(accountId: string | undefined, input: SendInput | {
+        draftId: string;
+    }, sendAtIso: string): Promise<ScheduledSendInfo>;
+    listScheduled(accountId?: string): ScheduledSendInfo[];
+    /** Cancels a pending schedule; the provider draft is kept. */
+    cancelScheduled(scheduleId: string): {
+        scheduleId: string;
+        draftId: string;
+        draftKept: true;
+    };
+    /**
+     * Reply recipient computation (provider-agnostic): when replying without explicit
+     * recipients, derive them from the original message: Reply-To/From for a plain
+     * reply; plus original To/Cc (minus our own address) for reply-all.
+     */
+    private resolveRecipients;
+    forward(accountId: string | undefined, input: ForwardInput): Promise<SendResult>;
+    modify(accountId: string | undefined, ids: string[], action: ModifyAction): Promise<void>;
+    getAttachment(accountId: string | undefined, messageId: string, attachmentId: string): Promise<{
+        meta: AttachmentMeta;
+        content: Buffer;
+    }>;
+}
+export declare function buildForwardBody(original: Message, comment?: string): {
+    text?: string;
+    html?: string;
+};
+//# sourceMappingURL=emailService.d.ts.map

package/dist/service/emailService.d.ts.map

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