@agent-native/core 0.102.1 → 0.103.0

package/corpus/templates/mail/server/handlers/emails.ts

@@ -63,6 +63,11 @@ import {
 } from "../lib/google-auth.js";
 import { getSyntheticEmailsForView, getSnoozedThreadIds } from "../lib/jobs.js";
 import { listInboxEmails } from "../lib/list-inbox-emails.js";
+import {
+  readLocalEmails as readEmails,
+  withLocalEmailMutationLock,
+  writeLocalEmails as writeEmails,
+} from "../lib/local-email-store.js";
 import {
   bodyToHtml as outgoingBodyToHtml,
   buildRawEmail as buildOutgoingRawEmail,
@@ -294,26 +299,10 @@ const DEFAULT_SETTINGS: UserSettings = {
 
 // ─── Helpers ─────────────────────────────────────────────────────────────────
 
-async function readEmails(email: string): Promise<EmailMessage[]> {
-  const data = await getUserSetting(email, "local-emails");
-  if (data && Array.isArray((data as any).emails)) {
-    return (data as any).emails;
-  }
-  return [];
-}
-
 function reqSource(event: H3Event) {
   return getHeader(event, "x-request-source") || undefined;
 }
 
-async function writeEmails(
-  email: string,
-  emails: EmailMessage[],
-  options?: { requestSource?: string },
-): Promise<void> {
-  await putUserSetting(email, "local-emails", { emails }, options);
-}
-
 async function readGmailComposeAttachment(
   ownerEmail: string,
   requestAccountEmail: string | undefined,
@@ -779,27 +768,32 @@ export const reportSpam = defineEventHandler(async (event: H3Event) => {
   }
 
   // Local fallback: move to trash with a spam label
-  const emails = await readEmails(email);
-  const target = emails.find((e) => e.id === getRouterParam(event, "id"));
-  if (!target) {
-    setResponseStatus(event, 404);
-    return { error: "Email not found" };
-  }
-  const threadId = target.threadId || target.id;
-  for (let i = 0; i < emails.length; i++) {
-    const eid = emails[i].threadId || emails[i].id;
-    if (eid === threadId) {
-      emails[i] = {
-        ...emails[i],
-        isTrashed: true,
-        labelIds: [...emails[i].labelIds.filter((l) => l !== "inbox"), "spam"],
-      };
+  return withLocalEmailMutationLock(email, async () => {
+    const emails = await readEmails(email);
+    const target = emails.find((e) => e.id === getRouterParam(event, "id"));
+    if (!target) {
+      setResponseStatus(event, 404);
+      return { error: "Email not found" };
     }
-  }
-  await writeEmails(email, emails, { requestSource: reqSource(event) });
-  const labels = recomputeUnreadCounts(emails, await readLabels(email));
-  await writeLabels(email, labels, { requestSource: reqSource(event) });
-  return { id: getRouterParam(event, "id"), threadId, spam: true };
+    const threadId = target.threadId || target.id;
+    for (let i = 0; i < emails.length; i++) {
+      const eid = emails[i].threadId || emails[i].id;
+      if (eid === threadId) {
+        emails[i] = {
+          ...emails[i],
+          isTrashed: true,
+          labelIds: [
+            ...emails[i].labelIds.filter((l) => l !== "inbox"),
+            "spam",
+          ],
+        };
+      }
+    }
+    await writeEmails(email, emails, { requestSource: reqSource(event) });
+    const labels = recomputeUnreadCounts(emails, await readLabels(email));
+    await writeLabels(email, labels, { requestSource: reqSource(event) });
+    return { id: getRouterParam(event, "id"), threadId, spam: true };
+  });
 });
 
 // ─── Block sender ─────────────────────────────────────────────────────────────
@@ -888,27 +882,32 @@ export const blockSender = defineEventHandler(async (event: H3Event) => {
     });
   }
 
-  const emails = await readEmails(email);
-  const target = emails.find((e) => e.id === getRouterParam(event, "id"));
-  if (!target) {
-    setResponseStatus(event, 404);
-    return { error: "Email not found" };
-  }
-  const threadId = target.threadId || target.id;
-  for (let i = 0; i < emails.length; i++) {
-    const eid = emails[i].threadId || emails[i].id;
-    if (eid === threadId) {
-      emails[i] = {
-        ...emails[i],
-        isTrashed: true,
-        labelIds: [...emails[i].labelIds.filter((l) => l !== "inbox"), "spam"],
-      };
+  return withLocalEmailMutationLock(email, async () => {
+    const emails = await readEmails(email);
+    const target = emails.find((e) => e.id === getRouterParam(event, "id"));
+    if (!target) {
+      setResponseStatus(event, 404);
+      return { error: "Email not found" };
     }
-  }
-  await writeEmails(email, emails, { requestSource: reqSource(event) });
-  const labels = recomputeUnreadCounts(emails, await readLabels(email));
-  await writeLabels(email, labels, { requestSource: reqSource(event) });
-  return { id: getRouterParam(event, "id"), threadId, blocked: senderEmail };
+    const threadId = target.threadId || target.id;
+    for (let i = 0; i < emails.length; i++) {
+      const eid = emails[i].threadId || emails[i].id;
+      if (eid === threadId) {
+        emails[i] = {
+          ...emails[i],
+          isTrashed: true,
+          labelIds: [
+            ...emails[i].labelIds.filter((l) => l !== "inbox"),
+            "spam",
+          ],
+        };
+      }
+    }
+    await writeEmails(email, emails, { requestSource: reqSource(event) });
+    const labels = recomputeUnreadCounts(emails, await readLabels(email));
+    await writeLabels(email, labels, { requestSource: reqSource(event) });
+    return { id: getRouterParam(event, "id"), threadId, blocked: senderEmail };
+  });
 });
 
 // ─── Mute thread ──────────────────────────────────────────────────────────────
@@ -964,35 +963,39 @@ export const muteThread = defineEventHandler(async (event: H3Event) => {
     await writeMutedThreads(email, muted, { requestSource: reqSource(event) });
   }
 
-  const emails = await readEmails(email);
-  for (let i = 0; i < emails.length; i++) {
-    const eid = emails[i].threadId || emails[i].id;
-    if (eid === threadId) {
-      emails[i] = {
-        ...emails[i],
-        isArchived: true,
-        labelIds: emails[i].labelIds.filter((l) => l !== "inbox"),
-      };
+  return withLocalEmailMutationLock(email, async () => {
+    const emails = await readEmails(email);
+    for (let i = 0; i < emails.length; i++) {
+      const eid = emails[i].threadId || emails[i].id;
+      if (eid === threadId) {
+        emails[i] = {
+          ...emails[i],
+          isArchived: true,
+          labelIds: emails[i].labelIds.filter((l) => l !== "inbox"),
+        };
+      }
     }
-  }
-  await writeEmails(email, emails, { requestSource: reqSource(event) });
-  const labels = recomputeUnreadCounts(emails, await readLabels(email));
-  await writeLabels(email, labels, { requestSource: reqSource(event) });
-  return { threadId, muted: true };
+    await writeEmails(email, emails, { requestSource: reqSource(event) });
+    const labels = recomputeUnreadCounts(emails, await readLabels(email));
+    await writeLabels(email, labels, { requestSource: reqSource(event) });
+    return { threadId, muted: true };
+  });
 });
 
 // ─── Delete permanently ───────────────────────────────────────────────────────
 
 export const deleteEmail = defineEventHandler(async (event: H3Event) => {
   const email = await userEmail(event);
-  const emails = await readEmails(email);
-  const filtered = emails.filter((e) => e.id !== getRouterParam(event, "id"));
-  if (filtered.length === emails.length) {
-    setResponseStatus(event, 404);
-    return { error: "Email not found" };
-  }
-  await writeEmails(email, filtered, { requestSource: reqSource(event) });
-  return { ok: true };
+  return withLocalEmailMutationLock(email, async () => {
+    const emails = await readEmails(email);
+    const filtered = emails.filter((e) => e.id !== getRouterParam(event, "id"));
+    if (filtered.length === emails.length) {
+      setResponseStatus(event, 404);
+      return { error: "Email not found" };
+    }
+    await writeEmails(email, filtered, { requestSource: reqSource(event) });
+    return { ok: true };
+  });
 });
 
 // ─── Send / compose ───────────────────────────────────────────────────────────
@@ -1197,62 +1200,64 @@ export const sendEmail = defineEventHandler(async (event: H3Event) => {
   }
 
   // Local fallback: store as sent email
-  const emails = await readEmails(email);
-
-  const newEmail: EmailMessage = {
-    id: `msg-${nanoid(8)}`,
-    threadId: replyToId
-      ? (emails.find((e) => e.id === replyToId)?.threadId ??
-        `thread-${nanoid(8)}`)
-      : `thread-${nanoid(8)}`,
-    from: { name: settings.name, email: settings.email },
-    to: (to as string).split(",").map((t: string) => {
-      const trimmed = t.trim();
-      return { name: trimmed, email: trimmed };
-    }),
-    ...(cc
-      ? {
-          cc: (cc as string)
-            .split(",")
-            .map((t: string) => ({ name: t.trim(), email: t.trim() })),
-        }
-      : {}),
-    ...(bcc
-      ? {
-          bcc: (bcc as string)
-            .split(",")
-            .map((t: string) => ({ name: t.trim(), email: t.trim() })),
-        }
-      : {}),
-    subject,
-    snippet: markdownPreviewSnippet(body),
-    body,
-    bodyHtml: outgoingBodyToHtml(body),
-    date: new Date().toISOString(),
-    isRead: true,
-    isStarred: false,
-    isSent: true,
-    isArchived: false,
-    isTrashed: false,
-    labelIds: ["sent"],
-    ...(attachments.length > 0
-      ? {
-          attachments: attachments.map((att) => ({
-            id: att.filename,
-            filename: att.originalName,
-            mimeType: att.mimeType,
-            size: att.size,
-            url: att.url,
-          })),
-        }
-      : {}),
-  };
+  return withLocalEmailMutationLock(email, async () => {
+    const emails = await readEmails(email);
+
+    const newEmail: EmailMessage = {
+      id: `msg-${nanoid(8)}`,
+      threadId: replyToId
+        ? (emails.find((e) => e.id === replyToId)?.threadId ??
+          `thread-${nanoid(8)}`)
+        : `thread-${nanoid(8)}`,
+      from: { name: settings.name, email: settings.email },
+      to: (to as string).split(",").map((t: string) => {
+        const trimmed = t.trim();
+        return { name: trimmed, email: trimmed };
+      }),
+      ...(cc
+        ? {
+            cc: (cc as string)
+              .split(",")
+              .map((t: string) => ({ name: t.trim(), email: t.trim() })),
+          }
+        : {}),
+      ...(bcc
+        ? {
+            bcc: (bcc as string)
+              .split(",")
+              .map((t: string) => ({ name: t.trim(), email: t.trim() })),
+          }
+        : {}),
+      subject,
+      snippet: markdownPreviewSnippet(body),
+      body,
+      bodyHtml: outgoingBodyToHtml(body),
+      date: new Date().toISOString(),
+      isRead: true,
+      isStarred: false,
+      isSent: true,
+      isArchived: false,
+      isTrashed: false,
+      labelIds: ["sent"],
+      ...(attachments.length > 0
+        ? {
+            attachments: attachments.map((att) => ({
+              id: att.filename,
+              filename: att.originalName,
+              mimeType: att.mimeType,
+              size: att.size,
+              url: att.url,
+            })),
+          }
+        : {}),
+    };
 
-  emails.push(newEmail);
-  await writeEmails(email, emails, { requestSource: reqSource(event) });
+    emails.push(newEmail);
+    await writeEmails(email, emails, { requestSource: reqSource(event) });
 
-  setResponseStatus(event, 201);
-  return newEmail;
+    setResponseStatus(event, 201);
+    return newEmail;
+  });
 });
 
 // ─── Save draft (persistent, Gmail-style) ─────────────────────────────────────
@@ -1353,80 +1358,82 @@ export const saveDraft = defineEventHandler(async (event: H3Event) => {
   }
 
   // Local fallback: save as EmailMessage with isDraft=true
-  const emails = await readEmails(email);
-  const existingIdx = draftId
-    ? emails.findIndex((e) => e.id === draftId && e.isDraft)
-    : -1;
-
-  const draftEmail: EmailMessage = {
-    id: existingIdx >= 0 ? emails[existingIdx].id : `draft-${nanoid(8)}`,
-    threadId:
-      existingIdx >= 0
-        ? emails[existingIdx].threadId
-        : replyToId
-          ? (emails.find((e) => e.id === replyToId)?.threadId ??
-            `thread-${nanoid(8)}`)
-          : `thread-${nanoid(8)}`,
-    from: { name: settings.name, email: settings.email },
-    to: to
-      ? (to as string)
-          .split(",")
-          .filter((t: string) => t.trim())
-          .map((t: string) => ({ name: t.trim(), email: t.trim() }))
-      : [],
-    ...(cc
-      ? {
-          cc: (cc as string)
-            .split(",")
-            .filter((t: string) => t.trim())
-            .map((t: string) => ({ name: t.trim(), email: t.trim() })),
-        }
-      : {}),
-    ...(bcc
-      ? {
-          bcc: (bcc as string)
+  return withLocalEmailMutationLock(email, async () => {
+    const emails = await readEmails(email);
+    const existingIdx = draftId
+      ? emails.findIndex((e) => e.id === draftId && e.isDraft)
+      : -1;
+
+    const draftEmail: EmailMessage = {
+      id: existingIdx >= 0 ? emails[existingIdx].id : `draft-${nanoid(8)}`,
+      threadId:
+        existingIdx >= 0
+          ? emails[existingIdx].threadId
+          : replyToId
+            ? (emails.find((e) => e.id === replyToId)?.threadId ??
+              `thread-${nanoid(8)}`)
+            : `thread-${nanoid(8)}`,
+      from: { name: settings.name, email: settings.email },
+      to: to
+        ? (to as string)
             .split(",")
             .filter((t: string) => t.trim())
-            .map((t: string) => ({ name: t.trim(), email: t.trim() })),
-        }
-      : {}),
-    subject: subject || "(no subject)",
-    snippet: markdownPreviewSnippet(body || ""),
-    body: body || "",
-    bodyHtml: outgoingBodyToHtml(body || ""),
-    date: new Date().toISOString(),
-    isRead: true,
-    isStarred: false,
-    isDraft: true,
-    isArchived: false,
-    isTrashed: false,
-    labelIds: ["drafts"],
-    ...(attachments.length > 0
-      ? {
-          attachments: attachments.map((att) => ({
-            id: att.filename,
-            filename: att.originalName,
-            mimeType: att.mimeType,
-            size: att.size,
-            url: att.url,
-          })),
-        }
-      : {}),
-    ...(replyToId ? { replyToId } : {}),
-    ...(replyToThreadId ? { replyToThreadId } : {}),
-  };
-
-  if (existingIdx >= 0) {
-    emails[existingIdx] = draftEmail;
-  } else {
-    emails.push(draftEmail);
-  }
-  await writeEmails(email, emails, { requestSource: reqSource(event) });
+            .map((t: string) => ({ name: t.trim(), email: t.trim() }))
+        : [],
+      ...(cc
+        ? {
+            cc: (cc as string)
+              .split(",")
+              .filter((t: string) => t.trim())
+              .map((t: string) => ({ name: t.trim(), email: t.trim() })),
+          }
+        : {}),
+      ...(bcc
+        ? {
+            bcc: (bcc as string)
+              .split(",")
+              .filter((t: string) => t.trim())
+              .map((t: string) => ({ name: t.trim(), email: t.trim() })),
+          }
+        : {}),
+      subject: subject || "(no subject)",
+      snippet: markdownPreviewSnippet(body || ""),
+      body: body || "",
+      bodyHtml: outgoingBodyToHtml(body || ""),
+      date: new Date().toISOString(),
+      isRead: true,
+      isStarred: false,
+      isDraft: true,
+      isArchived: false,
+      isTrashed: false,
+      labelIds: ["drafts"],
+      ...(attachments.length > 0
+        ? {
+            attachments: attachments.map((att) => ({
+              id: att.filename,
+              filename: att.originalName,
+              mimeType: att.mimeType,
+              size: att.size,
+              url: att.url,
+            })),
+          }
+        : {}),
+      ...(replyToId ? { replyToId } : {}),
+      ...(replyToThreadId ? { replyToThreadId } : {}),
+    };
+
+    if (existingIdx >= 0) {
+      emails[existingIdx] = draftEmail;
+    } else {
+      emails.push(draftEmail);
+    }
+    await writeEmails(email, emails, { requestSource: reqSource(event) });
 
-  return {
-    draftId: draftEmail.id,
-    [existingIdx >= 0 ? "updated" : "created"]: true,
-  };
+    return {
+      draftId: draftEmail.id,
+      [existingIdx >= 0 ? "updated" : "created"]: true,
+    };
+  });
 });
 
 /**
@@ -1488,12 +1495,14 @@ export const deleteDraft = defineEventHandler(async (event: H3Event) => {
   }
 
   // Local fallback
-  const emails = await readEmails(email);
-  const filtered = emails.filter((e) => !(e.id === id && e.isDraft));
-  if (filtered.length !== emails.length) {
-    await writeEmails(email, filtered, { requestSource: reqSource(event) });
-  }
-  return { ok: true };
+  return withLocalEmailMutationLock(email, async () => {
+    const emails = await readEmails(email);
+    const filtered = emails.filter((e) => !(e.id === id && e.isDraft));
+    if (filtered.length !== emails.length) {
+      await writeEmails(email, filtered, { requestSource: reqSource(event) });
+    }
+    return { ok: true };
+  });
 });
 
 // ─── Contacts (extracted from email history) ─────────────────────────────────

package/corpus/templates/mail/server/lib/bulk-mark-read.ts

@@ -0,0 +1,30 @@
+export interface BulkMarkReadFailure {
+  id: string;
+  error: string;
+}
+
+export interface BulkMarkReadResult {
+  mode: "all-unread";
+  accountEmail: string;
+  matchedMessages: number;
+  matchedThreads: number;
+  excludedMessages: number;
+  excludedThreads: number;
+  changedMessages: number;
+  batchCount: number;
+  failures: BulkMarkReadFailure[];
+  remainingUnreadMessages: number | null;
+  remainingUnreadThreads: number | null;
+  remainingProtectedMessages: number | null;
+  remainingProtectedThreads: number | null;
+  /** Initially selected messages that were still unread during verification. */
+  unexpectedUnreadMessages: number | null;
+  /** Threads containing initially selected messages still unread at verification. */
+  unexpectedUnreadThreads: number | null;
+  /** Messages not present in the initial unread snapshot. */
+  newUnreadMessages?: number | null;
+  /** Threads containing messages not present in the initial unread snapshot. */
+  newUnreadThreads?: number | null;
+  verificationComplete: boolean;
+  verificationError?: string;
+}