@arbidocs/react 0.5.110 → 0.5.112

package/dist/mail/offline/settings.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/mail/offline/settings.ts"],
+  "sourcesContent": ["/**\n * Per-device offline mail settings and the shared change/status signal.\n *\n * Settings are a device preference, not mail content, so they live in localStorage keyed by the\n * user (two people sharing a browser keep separate choices). The mail itself is wiped on sign-out;\n * the preference survives so the mailbox re-syncs after the user signs back in on this device\n * (decided in #2187: they hold no mail, and keeping them favours the person coming back).\n *\n * By default the last 7 days of mail are kept; the person can choose a shorter or longer window,\n * or none (\"Off\": only drafts and the Outbox stay on the device).\n *\n * `onOfflineMailChange` notifies this tab and, through a BroadcastChannel, other open tabs whenever\n * the offline store changes (sync progress, Outbox, drafts), so every Mail view stays current.\n */\n\n/** How far back mail is kept on this device. */\nexport type OfflineMailScope = '1d' | '7d' | '30d' | '90d'\n\nexport interface OfflineMailSettings {\n  /** Keep recent mail on this device (the window is `scope`). Off: only drafts and the Outbox. */\n  enabled: boolean\n  /** How far back mail is kept. */\n  scope: OfflineMailScope\n  /** Attachments of one message larger than this (MB, in total) are not saved. */\n  attachmentCapMb: number\n  /** Total space the offline mailbox may use (MB); the least recently opened attachments go first. */\n  quotaMb: number\n}\n\n/** On, for the last week: recent mail can be read and answered offline unless the person opts out. */\nexport const DEFAULT_OFFLINE_MAIL_SETTINGS: OfflineMailSettings = {\n  enabled: true,\n  scope: '7d',\n  attachmentCapMb: 25,\n  quotaMb: 1024,\n}\n\nexport const SCOPE_DAYS: Record<OfflineMailScope, number> = {\n  '1d': 1,\n  '7d': 7,\n  '30d': 30,\n  '90d': 90,\n}\n\nconst DAY_MS = 24 * 60 * 60 * 1000\n\n/** The oldest receive time (ms) kept on the device under `settings`. */\nexport function offlineWindowStart(settings: OfflineMailSettings, now = Date.now()): number {\n  return now - SCOPE_DAYS[settings.scope] * DAY_MS\n}\n\n/** Whether a message received at `receivedAt` belongs on the device (an undated one always does). */\nexport function inOfflineWindow(\n  settings: OfflineMailSettings,\n  receivedAt: string | undefined,\n  now = Date.now()\n): boolean {\n  const at = receivedAt ? Date.parse(receivedAt) || 0 : 0\n  return settings.enabled && (!at || at >= offlineWindowStart(settings, now))\n}\n\n/**\n * Saved choices from earlier versions: a longer window (\"Last year\", \"All mail\") becomes the\n * longest one offered now, anything unknown the default.\n */\nfunction normalize(saved: Partial<OfflineMailSettings>): OfflineMailSettings {\n  const merged = { ...DEFAULT_OFFLINE_MAIL_SETTINGS, ...saved }\n  const scope: string = merged.scope\n  if (scope in SCOPE_DAYS) return merged\n  const longer = scope === '365d' || scope === 'all'\n  return { ...merged, scope: longer ? '90d' : DEFAULT_OFFLINE_MAIL_SETTINGS.scope }\n}\n\nconst STORAGE_PREFIX = 'arbi-offline-mail-settings:'\n\n/** The signed-in user whose settings apply (`null`: signed out, nothing is kept). */\nexport type OfflineMailUser = string | null | undefined\n\n/** Nobody signed in (or a restored tab whose profile isn't loaded yet): keep no mail. */\nconst SIGNED_OUT: OfflineMailSettings = { ...DEFAULT_OFFLINE_MAIL_SETTINGS, enabled: false }\n\nexport function getOfflineMailSettings(userExtId: OfflineMailUser): OfflineMailSettings {\n  if (!userExtId) return SIGNED_OUT\n  const key = STORAGE_PREFIX + userExtId\n  try {\n    const raw = localStorage.getItem(key)\n    return raw\n      ? normalize(JSON.parse(raw) as Partial<OfflineMailSettings>)\n      : DEFAULT_OFFLINE_MAIL_SETTINGS\n  } catch {\n    return DEFAULT_OFFLINE_MAIL_SETTINGS\n  }\n}\n\nexport function setOfflineMailSettings(\n  userExtId: OfflineMailUser,\n  patch: Partial<OfflineMailSettings>\n): OfflineMailSettings {\n  const next = { ...getOfflineMailSettings(userExtId), ...patch }\n  if (userExtId) {\n    try {\n      localStorage.setItem(STORAGE_PREFIX + userExtId, JSON.stringify(next))\n    } catch {\n      // Storage full/blocked: the choice applies for this session only.\n    }\n  }\n  notifyOfflineMailChange('settings')\n  return next\n}\n\nexport type OfflineMailChange =\n  'settings' | 'mailbox' | 'outbox' | 'drafts' | 'changes' | 'status' | 'wiped'\n\nconst listeners = new Set<(change: OfflineMailChange) => void>()\nconst CHANNEL = 'arbi-offline-mail'\nlet channel: BroadcastChannel | null = null\n\nfunction getChannel(): BroadcastChannel | null {\n  if (channel || typeof BroadcastChannel === 'undefined') return channel\n  channel = new BroadcastChannel(CHANNEL)\n  channel.onmessage = (event: MessageEvent<OfflineMailChange>) => {\n    for (const listener of listeners) listener(event.data)\n  }\n  return channel\n}\n\nexport function notifyOfflineMailChange(change: OfflineMailChange): void {\n  for (const listener of listeners) listener(change)\n  try {\n    getChannel()?.postMessage(change)\n  } catch {\n    // Channel closed (tab unloading): other tabs pick the change up on their next read.\n  }\n}\n\nexport function onOfflineMailChange(listener: (change: OfflineMailChange) => void): () => void {\n  getChannel()\n  listeners.add(listener)\n  return () => listeners.delete(listener)\n}\n"],
+  "mappings": "AA8BO,MAAM,gCAAqD;AAAA,EAChE,SAAS;AAAA,EACT,OAAO;AAAA,EACP,iBAAiB;AAAA,EACjB,SAAS;AACX;AAEO,MAAM,aAA+C;AAAA,EAC1D,MAAM;AAAA,EACN,MAAM;AAAA,EACN,OAAO;AAAA,EACP,OAAO;AACT;AAEA,MAAM,SAAS,KAAK,KAAK,KAAK;AAGvB,SAAS,mBAAmB,UAA+B,MAAM,KAAK,IAAI,GAAW;AAC1F,SAAO,MAAM,WAAW,SAAS,KAAK,IAAI;AAC5C;AAGO,SAAS,gBACd,UACA,YACA,MAAM,KAAK,IAAI,GACN;AACT,QAAM,KAAK,aAAa,KAAK,MAAM,UAAU,KAAK,IAAI;AACtD,SAAO,SAAS,YAAY,CAAC,MAAM,MAAM,mBAAmB,UAAU,GAAG;AAC3E;AAMA,SAAS,UAAU,OAA0D;AAC3E,QAAM,SAAS,EAAE,GAAG,+BAA+B,GAAG,MAAM;AAC5D,QAAM,QAAgB,OAAO;AAC7B,MAAI,SAAS,WAAY,QAAO;AAChC,QAAM,SAAS,UAAU,UAAU,UAAU;AAC7C,SAAO,EAAE,GAAG,QAAQ,OAAO,SAAS,QAAQ,8BAA8B,MAAM;AAClF;AAEA,MAAM,iBAAiB;AAMvB,MAAM,aAAkC,EAAE,GAAG,+BAA+B,SAAS,MAAM;AAEpF,SAAS,uBAAuB,WAAiD;AACtF,MAAI,CAAC,UAAW,QAAO;AACvB,QAAM,MAAM,iBAAiB;AAC7B,MAAI;AACF,UAAM,MAAM,aAAa,QAAQ,GAAG;AACpC,WAAO,MACH,UAAU,KAAK,MAAM,GAAG,CAAiC,IACzD;AAAA,EACN,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEO,SAAS,uBACd,WACA,OACqB;AACrB,QAAM,OAAO,EAAE,GAAG,uBAAuB,SAAS,GAAG,GAAG,MAAM;AAC9D,MAAI,WAAW;AACb,QAAI;AACF,mBAAa,QAAQ,iBAAiB,WAAW,KAAK,UAAU,IAAI,CAAC;AAAA,IACvE,QAAQ;AAAA,IAER;AAAA,EACF;AACA,0BAAwB,UAAU;AAClC,SAAO;AACT;AAKA,MAAM,YAAY,oBAAI,IAAyC;AAC/D,MAAM,UAAU;AAChB,IAAI,UAAmC;AAEvC,SAAS,aAAsC;AAC7C,MAAI,WAAW,OAAO,qBAAqB,YAAa,QAAO;AAC/D,YAAU,IAAI,iBAAiB,OAAO;AACtC,UAAQ,YAAY,CAAC,UAA2C;AAC9D,eAAW,YAAY,UAAW,UAAS,MAAM,IAAI;AAAA,EACvD;AACA,SAAO;AACT;AAEO,SAAS,wBAAwB,QAAiC;AACvE,aAAW,YAAY,UAAW,UAAS,MAAM;AACjD,MAAI;AACF,eAAW,GAAG,YAAY,MAAM;AAAA,EAClC,QAAQ;AAAA,EAER;AACF;AAEO,SAAS,oBAAoB,UAA2D;AAC7F,aAAW;AACX,YAAU,IAAI,QAAQ;AACtB,SAAO,MAAM,UAAU,OAAO,QAAQ;AACxC;",
+  "names": []
+}

package/dist/mail/offline/store.js

@@ -0,0 +1,29 @@
+import { createRecordStore } from "../../offline-store/store.js";
+const OFFLINE_MAIL_DB = "arbi-offline-mail";
+const store = createRecordStore(OFFLINE_MAIL_DB);
+const putRecord = store.putRecord;
+const getRecord = store.getRecord;
+const hasRecord = store.hasRecord;
+const deleteRecords = store.deleteRecords;
+const recordsInBucket = store.recordsInBucket;
+const recordsOfKind = store.recordsOfKind;
+const allRecordSizes = store.allRecordSizes;
+const touchRecord = store.touchRecord;
+const getMeta = store.getMeta;
+const setMeta = store.setMeta;
+const deleteOfflineMailDatabase = store.deleteDatabase;
+export {
+  OFFLINE_MAIL_DB,
+  allRecordSizes,
+  deleteOfflineMailDatabase,
+  deleteRecords,
+  getMeta,
+  getRecord,
+  hasRecord,
+  putRecord,
+  recordsInBucket,
+  recordsOfKind,
+  setMeta,
+  touchRecord
+};
+//# sourceMappingURL=store.js.map

package/dist/mail/offline/store.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/mail/offline/store.ts"],
+  "sourcesContent": ["/**\n * The offline mailbox's IndexedDB store (the generic encrypted record store, see\n * ../../offline-store/store, under the `arbi-offline-mail` database).\n *\n * Record plaintext fields are only what IndexedDB needs to find and evict a record: a blind key, its\n * kind, a blind bucket (which folder/account it belongs to), a sort time, its size and last read.\n * Everything else \u2014 subjects, addresses, bodies, attachments, drafts, queued mail and changes \u2014 is sealed in\n * `data` with the key from ./crypto. `meta` holds non-content facts: owner, sync times and counts.\n */\n\nimport { createRecordStore, type StoredRecord as GenericRecord } from '../../offline-store/store'\n\nexport const OFFLINE_MAIL_DB = 'arbi-offline-mail'\n\nexport type RecordKind =\n  | 'accounts'\n  | 'policy'\n  | 'folders'\n  | 'header'\n  | 'body'\n  | 'attachment'\n  | 'draft'\n  | 'outbox'\n  | 'change'\n\nexport type StoredRecord = GenericRecord<RecordKind>\n\nconst store = createRecordStore<RecordKind>(OFFLINE_MAIL_DB)\n\nexport const putRecord = store.putRecord\nexport const getRecord = store.getRecord\nexport const hasRecord = store.hasRecord\nexport const deleteRecords = store.deleteRecords\nexport const recordsInBucket = store.recordsInBucket\nexport const recordsOfKind = store.recordsOfKind\n/** Keys + sizes only (no data), for quota accounting without loading ciphertext. */\nexport const allRecordSizes = store.allRecordSizes\nexport const touchRecord = store.touchRecord\nexport const getMeta = store.getMeta\nexport const setMeta = store.setMeta\n/** Delete the whole database (sign-out / \"Remove offline data\"). */\nexport const deleteOfflineMailDatabase = store.deleteDatabase\n"],
+  "mappings": "AAUA,SAAS,yBAA6D;AAE/D,MAAM,kBAAkB;AAe/B,MAAM,QAAQ,kBAA8B,eAAe;AAEpD,MAAM,YAAY,MAAM;AACxB,MAAM,YAAY,MAAM;AACxB,MAAM,YAAY,MAAM;AACxB,MAAM,gBAAgB,MAAM;AAC5B,MAAM,kBAAkB,MAAM;AAC9B,MAAM,gBAAgB,MAAM;AAE5B,MAAM,iBAAiB,MAAM;AAC7B,MAAM,cAAc,MAAM;AAC1B,MAAM,UAAU,MAAM;AACtB,MAAM,UAAU,MAAM;AAEtB,MAAM,4BAA4B,MAAM;",
+  "names": []
+}

package/dist/mail/offline/sync.js

@@ -0,0 +1,251 @@
+import { logger } from "@arbidocs/client";
+import {
+  bucketOf,
+  hasAttachment,
+  hasBody,
+  isVirtualFolder,
+  keyOf,
+  loadAccounts,
+  loadFolders,
+  loadHeaders,
+  removeKeys,
+  saveAccounts,
+  saveAttachment,
+  saveBody,
+  saveFolders,
+  saveHeader,
+  savePolicy,
+  toHeader
+} from "./mailbox.js";
+import { allRecordSizes, getMeta, recordsInBucket, recordsOfKind, setMeta } from "./store.js";
+import { overlayPendingMailChanges } from "./changes.js";
+import {
+  notifyOfflineMailChange,
+  offlineWindowStart,
+  SCOPE_DAYS
+} from "./settings.js";
+const STATUS_KEY = "status";
+const FULL_SYNC_EVERY_MS = 60 * 60 * 1e3;
+const MAX_PAGES = 200;
+async function getOfflineMailStatus() {
+  return await getMeta(STATUS_KEY) ?? { messages: 0, bytes: 0, skipped: [] };
+}
+const MB = 1024 * 1024;
+const time = (m) => m.received_at ? Date.parse(m.received_at) || 0 : 0;
+const sameHeader = (a, b) => JSON.stringify(toHeader(a)) === JSON.stringify(toHeader(b));
+class Budget {
+  constructor(used, quota) {
+    this.used = used;
+    this.quota = quota;
+  }
+  used;
+  quota;
+  get full() {
+    return this.used >= this.quota;
+  }
+  take(bytes) {
+    this.used += bytes;
+  }
+}
+async function saveMessageContent(transport, account, header, settings, budget) {
+  const message = await transport.message(account, header.id);
+  await saveBody(account.id, message);
+  budget.take((message.text?.length ?? 0) + (message.html?.length ?? 0));
+  let attachmentBytes = 0;
+  for (const attachment of message.attachments) {
+    if (budget.full) return;
+    if (attachmentBytes + attachment.size > settings.attachmentCapMb * MB) continue;
+    if (await hasAttachment(account.id, message.id, attachment.id)) continue;
+    const bytes = attachment.content_base64 ? Uint8Array.from(atob(attachment.content_base64), (c) => c.charCodeAt(0)) : await transport.attachment(account, message.id, attachment.id);
+    await saveAttachment(account.id, message.id, attachment.id, bytes, time(message));
+    attachmentBytes += bytes.byteLength;
+    budget.take(bytes.byteLength);
+  }
+}
+async function syncFolder(transport, account, folder, settings, windowStart, full, budget) {
+  const saved = new Map(
+    (await loadHeaders(account.id, folder.id)).map((h) => [h.message.id, h])
+  );
+  const seen = /* @__PURE__ */ new Set();
+  let oldestSeen = Infinity;
+  let cursor = null;
+  let reachedEnd = false;
+  for (let page = 0; page < MAX_PAGES; page++) {
+    const result = await transport.messages(account, folder.id, cursor);
+    let anythingNew = false;
+    let outOfScope = false;
+    for (const message of result.messages) {
+      const at = time(message);
+      if (at && at < windowStart) {
+        outOfScope = true;
+        break;
+      }
+      seen.add(message.id);
+      if (at) oldestSeen = Math.min(oldestSeen, at);
+      const previous = saved.get(message.id)?.message;
+      if (!previous || !sameHeader(previous, message)) {
+        await saveHeader(account.id, folder.id, message);
+        anythingNew = true;
+      }
+      if (!budget.full && !await hasBody(account.id, message.id)) {
+        try {
+          await saveMessageContent(transport, account, message, settings, budget);
+          anythingNew = true;
+        } catch (error) {
+          logger.warn("[offline-mail] could not save a message body", error);
+        }
+      }
+    }
+    cursor = result.next_cursor ?? null;
+    if (outOfScope || !cursor) {
+      reachedEnd = true;
+      break;
+    }
+    if (!full && !anythingNew) break;
+  }
+  const stale = [...saved.values()].filter(
+    (h) => !seen.has(h.message.id) && (reachedEnd || h.sortAt >= oldestSeen)
+  );
+  await removeKeys(stale.map((h) => h.key));
+}
+async function collectGarbage(accounts) {
+  for (const account of accounts) {
+    const folders = await loadFolders(account.id) ?? [];
+    const expected = /* @__PURE__ */ new Set([await keyOf.folders(account.id)]);
+    for (const folder of folders) {
+      for (const { message } of await loadHeaders(account.id, folder.id)) {
+        expected.add(await keyOf.body(account.id, message.id));
+        for (const attachment of message.attachments)
+          expected.add(await keyOf.attachment(account.id, message.id, attachment.id));
+      }
+    }
+    const orphans = (await recordsInBucket(await bucketOf.account(account.id))).filter((r) => (r.kind === "body" || r.kind === "attachment") && !expected.has(r.key)).map((r) => r.key);
+    await removeKeys(orphans);
+  }
+}
+async function forgetAccount(accountId) {
+  for (const folder of await loadFolders(accountId) ?? []) {
+    const records2 = await recordsInBucket(await bucketOf.folder(accountId, folder.id));
+    await removeKeys(records2.map((r) => r.key));
+  }
+  const records = await recordsInBucket(await bucketOf.account(accountId));
+  await removeKeys(records.filter((r) => r.kind !== "draft").map((r) => r.key));
+}
+async function enforceQuota(quotaBytes) {
+  let used = (await allRecordSizes()).reduce((n, r) => n + r.size, 0);
+  if (used <= quotaBytes) return used;
+  for (const kind of ["attachment", "body"]) {
+    const records = (await recordsOfKind(kind)).sort(
+      (a, b) => kind === "attachment" ? a.lastAccess - b.lastAccess : a.sortAt - b.sortAt
+    );
+    const evict = [];
+    for (const record of records) {
+      if (used <= quotaBytes) break;
+      evict.push(record.key);
+      used -= record.size;
+    }
+    await removeKeys(evict);
+    if (used <= quotaBytes) break;
+  }
+  return used;
+}
+const CONTENT_KINDS = ["header", "body", "attachment"];
+async function trimOfflineMailbox(settings, now = Date.now()) {
+  const windowStart = offlineWindowStart(settings, now);
+  const kinds = settings.enabled ? CONTENT_KINDS : [...CONTENT_KINDS, "folders"];
+  for (const kind of kinds) {
+    const records = await recordsOfKind(kind);
+    const old = settings.enabled ? records.filter((r) => r.sortAt > 0 && r.sortAt < windowStart) : records;
+    await removeKeys(old.map((r) => r.key));
+  }
+  const previous = await getOfflineMailStatus();
+  const status = {
+    ...previous,
+    messages: (await recordsOfKind("header")).length,
+    bytes: (await allRecordSizes()).reduce((n, r) => n + r.size, 0),
+    // A shorter window no longer covers what the last full pass fetched: growing it again (even
+    // before the next hourly full pass) makes the next pass a full one.
+    windowDays: settings.enabled && previous.windowDays !== void 0 ? Math.min(previous.windowDays, SCOPE_DAYS[settings.scope]) : void 0,
+    // Off: nothing is saved, so turning it back on starts with a full pass.
+    ...!settings.enabled && { lastSyncedAt: void 0, lastFullSyncAt: void 0 }
+  };
+  await setMeta(STATUS_KEY, status);
+  notifyOfflineMailChange("status");
+  return status;
+}
+async function syncMailbox(transport, settings, options = {}) {
+  const now = options.now ?? Date.now();
+  const previous = await getOfflineMailStatus();
+  const days = SCOPE_DAYS[settings.scope];
+  const full = options.full || !previous.lastFullSyncAt || now - previous.lastFullSyncAt > FULL_SYNC_EVERY_MS || (previous.windowDays ?? 0) < days;
+  const windowStart = offlineWindowStart(settings, now);
+  const quota = settings.quotaMb * MB;
+  const skipped = [];
+  let error;
+  try {
+    await savePolicy(await transport.policy());
+    const accounts = await transport.accounts();
+    const before = await loadAccounts() ?? [];
+    await saveAccounts(accounts);
+    for (const gone of before.filter((b) => !accounts.some((a) => a.id === b.id)))
+      await forgetAccount(gone.id);
+    const budget = new Budget(
+      (await allRecordSizes()).reduce((n, r) => n + r.size, 0),
+      quota
+    );
+    for (const account of accounts) {
+      if (account.needs_reconsent) {
+        skipped.push(account.email);
+        continue;
+      }
+      try {
+        await transport.unlock(account);
+        const folders = await transport.folders(account);
+        const oldFolders = await loadFolders(account.id) ?? [];
+        await saveFolders(account.id, folders);
+        for (const gone of oldFolders.filter((o) => !folders.some((f) => f.id === o.id))) {
+          const records = await recordsInBucket(await bucketOf.folder(account.id, gone.id));
+          await removeKeys(records.map((r) => r.key));
+        }
+        for (const folder of folders.filter((f) => !isVirtualFolder(f)))
+          await syncFolder(transport, account, folder, settings, windowStart, full, budget);
+        notifyOfflineMailChange("mailbox");
+      } catch (accountError) {
+        if (accountError.status === void 0) throw accountError;
+        logger.warn("[offline-mail] account sync failed", accountError);
+        skipped.push(account.email);
+      }
+    }
+    if (full) await collectGarbage(accounts);
+  } catch (syncError) {
+    error = syncError.status === void 0 ? "The connection dropped during sync. It will continue when you are back online." : syncError instanceof Error ? syncError.message : "Sync failed";
+  }
+  await overlayPendingMailChanges().catch(
+    (overlayError) => logger.warn("[offline-mail] could not lay pending changes over the device copy", overlayError)
+  );
+  const current = options.latest?.() ?? settings;
+  const trimmed = await trimOfflineMailbox(current, now);
+  if (!current.enabled) return trimmed;
+  const bytes = await enforceQuota(current.quotaMb * MB);
+  const messages = (await recordsOfKind("header")).length;
+  const fullDone = !error && full;
+  const status = {
+    lastSyncedAt: error ? previous.lastSyncedAt : now,
+    lastFullSyncAt: fullDone ? now : previous.lastFullSyncAt,
+    windowDays: fullDone ? Math.min(days, SCOPE_DAYS[current.scope]) : trimmed.windowDays,
+    messages,
+    bytes,
+    error,
+    skipped
+  };
+  await setMeta(STATUS_KEY, status);
+  notifyOfflineMailChange("status");
+  return status;
+}
+export {
+  enforceQuota,
+  getOfflineMailStatus,
+  syncMailbox,
+  trimOfflineMailbox
+};
+//# sourceMappingURL=sync.js.map

package/dist/mail/offline/sync.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/mail/offline/sync.ts"],
+  "sourcesContent": ["/**\n * Mailbox sync: copies the user's mail (native inbox and connected accounts, through the same list/\n * get endpoints the Mail page uses) into the encrypted offline store, incrementally.\n *\n * For each account \u2192 folder, list pages newest first within the chosen scope. Headers are always\n * refreshed (cheap: read/unread and moves show up); a body and its attachments are fetched only for\n * a message not saved yet. A quick pass stops at the first page that holds nothing new; a full pass\n * (hourly, or \"Sync now\") walks the whole scope and drops what was deleted or moved on the server.\n *\n * Space: attachments of one message are saved up to the per-message cap; the whole store is held\n * under the quota, evicting the least recently opened attachments first, then the oldest bodies.\n * A message whose body isn't saved still lists offline and says so when opened.\n *\n * Window: only mail received within the chosen window is kept (`trimOfflineMailbox`, after every\n * pass and as soon as the setting changes, offline too). A longer window than the last full pass\n * covered makes the next pass a full one, which fetches the older mail.\n */\n\nimport type { MailAccount, MailFolder, MailMessage, MailPolicy } from '../types'\nimport { logger } from '@arbidocs/client'\nimport {\n  bucketOf,\n  hasAttachment,\n  hasBody,\n  isVirtualFolder,\n  keyOf,\n  loadAccounts,\n  loadFolders,\n  loadHeaders,\n  removeKeys,\n  saveAccounts,\n  saveAttachment,\n  saveBody,\n  saveFolders,\n  saveHeader,\n  savePolicy,\n  toHeader,\n} from './mailbox'\nimport { allRecordSizes, getMeta, recordsInBucket, recordsOfKind, setMeta } from './store'\nimport { overlayPendingMailChanges } from './changes'\nimport {\n  notifyOfflineMailChange,\n  offlineWindowStart,\n  SCOPE_DAYS,\n  type OfflineMailSettings,\n} from './settings'\n\nexport interface MailTransport {\n  policy: () => Promise<MailPolicy>\n  accounts: () => Promise<MailAccount[]>\n  unlock: (account: MailAccount) => Promise<void>\n  folders: (account: MailAccount) => Promise<MailFolder[]>\n  messages: (\n    account: MailAccount,\n    folderId: string,\n    cursor: string | null\n  ) => Promise<{ messages: MailMessage[]; next_cursor?: string | null }>\n  message: (account: MailAccount, messageId: string) => Promise<MailMessage>\n  attachment: (account: MailAccount, messageId: string, attachmentId: string) => Promise<Uint8Array>\n}\n\nexport interface OfflineMailStatus {\n  lastSyncedAt?: number\n  lastFullSyncAt?: number\n  messages: number\n  bytes: number\n  /** Why the last sync didn't finish, in plain words. */\n  error?: string\n  /** Accounts that could not be synced (e.g. need reconnecting), by email. */\n  skipped: string[]\n  /** The window (days) the last full pass covered; a longer one needs another full pass. */\n  windowDays?: number\n}\n\nconst STATUS_KEY = 'status'\nconst FULL_SYNC_EVERY_MS = 60 * 60 * 1000\n/** Safety stop per folder per pass. */\nconst MAX_PAGES = 200\n\nexport async function getOfflineMailStatus(): Promise<OfflineMailStatus> {\n  return (await getMeta<OfflineMailStatus>(STATUS_KEY)) ?? { messages: 0, bytes: 0, skipped: [] }\n}\n\nconst MB = 1024 * 1024\nconst time = (m: MailMessage) => (m.received_at ? Date.parse(m.received_at) || 0 : 0)\nconst sameHeader = (a: MailMessage, b: MailMessage) =>\n  JSON.stringify(toHeader(a)) === JSON.stringify(toHeader(b))\n\nclass Budget {\n  constructor(\n    public used: number,\n    private readonly quota: number\n  ) {}\n  get full() {\n    return this.used >= this.quota\n  }\n  take(bytes: number) {\n    this.used += bytes\n  }\n}\n\nasync function saveMessageContent(\n  transport: MailTransport,\n  account: MailAccount,\n  header: MailMessage,\n  settings: OfflineMailSettings,\n  budget: Budget\n): Promise<void> {\n  const message = await transport.message(account, header.id)\n  await saveBody(account.id, message)\n  budget.take((message.text?.length ?? 0) + (message.html?.length ?? 0))\n  let attachmentBytes = 0\n  for (const attachment of message.attachments) {\n    if (budget.full) return\n    if (attachmentBytes + attachment.size > settings.attachmentCapMb * MB) continue\n    if (await hasAttachment(account.id, message.id, attachment.id)) continue\n    const bytes = attachment.content_base64\n      ? Uint8Array.from(atob(attachment.content_base64), (c) => c.charCodeAt(0))\n      : await transport.attachment(account, message.id, attachment.id)\n    await saveAttachment(account.id, message.id, attachment.id, bytes, time(message))\n    attachmentBytes += bytes.byteLength\n    budget.take(bytes.byteLength)\n  }\n}\n\nasync function syncFolder(\n  transport: MailTransport,\n  account: MailAccount,\n  folder: MailFolder,\n  settings: OfflineMailSettings,\n  windowStart: number,\n  full: boolean,\n  budget: Budget\n): Promise<void> {\n  const saved = new Map(\n    (await loadHeaders(account.id, folder.id)).map((h) => [h.message.id, h] as const)\n  )\n  const seen = new Set<string>()\n  let oldestSeen = Infinity\n  let cursor: string | null = null\n  let reachedEnd = false\n  for (let page = 0; page < MAX_PAGES; page++) {\n    const result = await transport.messages(account, folder.id, cursor)\n    let anythingNew = false\n    let outOfScope = false\n    for (const message of result.messages) {\n      const at = time(message)\n      if (at && at < windowStart) {\n        outOfScope = true\n        break\n      }\n      seen.add(message.id)\n      if (at) oldestSeen = Math.min(oldestSeen, at)\n      const previous = saved.get(message.id)?.message\n      if (!previous || !sameHeader(previous, message)) {\n        await saveHeader(account.id, folder.id, message)\n        anythingNew = true\n      }\n      if (!budget.full && !(await hasBody(account.id, message.id))) {\n        try {\n          await saveMessageContent(transport, account, message, settings, budget)\n          anythingNew = true\n        } catch (error) {\n          // One unreadable message must not stop the folder; it lists, and says it isn't saved.\n          logger.warn('[offline-mail] could not save a message body', error)\n        }\n      }\n    }\n    cursor = result.next_cursor ?? null\n    if (outOfScope || !cursor) {\n      reachedEnd = true\n      break\n    }\n    if (!full && !anythingNew) break\n  }\n  // Drop what the server no longer has here: everything unseen in the range this pass covered\n  // (the whole folder when it reached the end of the scope).\n  const stale = [...saved.values()].filter(\n    (h) => !seen.has(h.message.id) && (reachedEnd || h.sortAt >= oldestSeen)\n  )\n  await removeKeys(stale.map((h) => h.key))\n}\n\n/** Remove bodies/attachments no header points to any more, and folders/accounts that went away. */\nasync function collectGarbage(accounts: MailAccount[]): Promise<void> {\n  for (const account of accounts) {\n    const folders = (await loadFolders(account.id)) ?? []\n    const expected = new Set<string>([await keyOf.folders(account.id)])\n    for (const folder of folders) {\n      for (const { message } of await loadHeaders(account.id, folder.id)) {\n        expected.add(await keyOf.body(account.id, message.id))\n        for (const attachment of message.attachments)\n          expected.add(await keyOf.attachment(account.id, message.id, attachment.id))\n      }\n    }\n    const orphans = (await recordsInBucket(await bucketOf.account(account.id)))\n      .filter((r) => (r.kind === 'body' || r.kind === 'attachment') && !expected.has(r.key))\n      .map((r) => r.key)\n    await removeKeys(orphans)\n  }\n}\n\nasync function forgetAccount(accountId: string): Promise<void> {\n  for (const folder of (await loadFolders(accountId)) ?? []) {\n    const records = await recordsInBucket(await bucketOf.folder(accountId, folder.id))\n    await removeKeys(records.map((r) => r.key))\n  }\n  const records = await recordsInBucket(await bucketOf.account(accountId))\n  await removeKeys(records.filter((r) => r.kind !== 'draft').map((r) => r.key))\n}\n\n/** Hold the store under the quota: least recently opened attachments first, then oldest bodies. */\nexport async function enforceQuota(quotaBytes: number): Promise<number> {\n  let used = (await allRecordSizes()).reduce((n, r) => n + r.size, 0)\n  if (used <= quotaBytes) return used\n  for (const kind of ['attachment', 'body'] as const) {\n    const records = (await recordsOfKind(kind)).sort((a, b) =>\n      kind === 'attachment' ? a.lastAccess - b.lastAccess : a.sortAt - b.sortAt\n    )\n    const evict: string[] = []\n    for (const record of records) {\n      if (used <= quotaBytes) break\n      evict.push(record.key)\n      used -= record.size\n    }\n    await removeKeys(evict)\n    if (used <= quotaBytes) break\n  }\n  return used\n}\n\nconst CONTENT_KINDS = ['header', 'body', 'attachment'] as const\n\n/**\n * Hold the device copy to the chosen window, with no network: mail received before it goes (its\n * list row, body and attachments; an undated message stays). Off: every folder and message goes,\n * and only the accounts, drafts and the Outbox stay. Returns the status with the new totals.\n */\nexport async function trimOfflineMailbox(\n  settings: OfflineMailSettings,\n  now = Date.now()\n): Promise<OfflineMailStatus> {\n  const windowStart = offlineWindowStart(settings, now)\n  const kinds = settings.enabled ? CONTENT_KINDS : ([...CONTENT_KINDS, 'folders'] as const)\n  for (const kind of kinds) {\n    const records = await recordsOfKind(kind)\n    const old = settings.enabled\n      ? records.filter((r) => r.sortAt > 0 && r.sortAt < windowStart)\n      : records\n    await removeKeys(old.map((r) => r.key))\n  }\n  const previous = await getOfflineMailStatus()\n  const status: OfflineMailStatus = {\n    ...previous,\n    messages: (await recordsOfKind('header')).length,\n    bytes: (await allRecordSizes()).reduce((n, r) => n + r.size, 0),\n    // A shorter window no longer covers what the last full pass fetched: growing it again (even\n    // before the next hourly full pass) makes the next pass a full one.\n    windowDays:\n      settings.enabled && previous.windowDays !== undefined\n        ? Math.min(previous.windowDays, SCOPE_DAYS[settings.scope])\n        : undefined,\n    // Off: nothing is saved, so turning it back on starts with a full pass.\n    ...(!settings.enabled && { lastSyncedAt: undefined, lastFullSyncAt: undefined }),\n  }\n  await setMeta(STATUS_KEY, status)\n  notifyOfflineMailChange('status')\n  return status\n}\n\n/**\n * One sync pass. Never throws: the outcome is recorded in the status (and announced), because it\n * runs in the background and a failure must show up as \"couldn't sync\", not vanish.\n *\n * `latest` reads the settings again at the end: a window shortened (or Off chosen) while the pass\n * ran is what the device copy is trimmed to, not the settings the pass started with.\n */\nexport async function syncMailbox(\n  transport: MailTransport,\n  settings: OfflineMailSettings,\n  options: { full?: boolean; now?: number; latest?: () => OfflineMailSettings } = {}\n): Promise<OfflineMailStatus> {\n  const now = options.now ?? Date.now()\n  const previous = await getOfflineMailStatus()\n  const days = SCOPE_DAYS[settings.scope]\n  const full =\n    options.full ||\n    !previous.lastFullSyncAt ||\n    now - previous.lastFullSyncAt > FULL_SYNC_EVERY_MS ||\n    (previous.windowDays ?? 0) < days\n  const windowStart = offlineWindowStart(settings, now)\n  const quota = settings.quotaMb * MB\n  const skipped: string[] = []\n  let error: string | undefined\n  try {\n    await savePolicy(await transport.policy())\n    const accounts = await transport.accounts()\n    const before = (await loadAccounts()) ?? []\n    await saveAccounts(accounts)\n    for (const gone of before.filter((b) => !accounts.some((a) => a.id === b.id)))\n      await forgetAccount(gone.id)\n    const budget = new Budget(\n      (await allRecordSizes()).reduce((n, r) => n + r.size, 0),\n      quota\n    )\n    for (const account of accounts) {\n      if (account.needs_reconsent) {\n        skipped.push(account.email)\n        continue\n      }\n      try {\n        await transport.unlock(account)\n        const folders = await transport.folders(account)\n        const oldFolders = (await loadFolders(account.id)) ?? []\n        await saveFolders(account.id, folders)\n        for (const gone of oldFolders.filter((o) => !folders.some((f) => f.id === o.id))) {\n          const records = await recordsInBucket(await bucketOf.folder(account.id, gone.id))\n          await removeKeys(records.map((r) => r.key))\n        }\n        // Flagged is a view over the other folders: its messages are saved where they are.\n        for (const folder of folders.filter((f) => !isVirtualFolder(f)))\n          await syncFolder(transport, account, folder, settings, windowStart, full, budget)\n        notifyOfflineMailChange('mailbox')\n      } catch (accountError) {\n        // Network loss mid-sync: stop; everything saved so far stays and the next pass continues.\n        if ((accountError as { status?: number }).status === undefined) throw accountError\n        logger.warn('[offline-mail] account sync failed', accountError)\n        skipped.push(account.email)\n      }\n    }\n    if (full) await collectGarbage(accounts)\n  } catch (syncError) {\n    error =\n      (syncError as { status?: number }).status === undefined\n        ? 'The connection dropped during sync. It will continue when you are back online.'\n        : syncError instanceof Error\n          ? syncError.message\n          : 'Sync failed'\n  }\n  // Changes made offline that the server hasn't applied yet: the pass wrote the server's state.\n  await overlayPendingMailChanges().catch((overlayError) =>\n    logger.warn('[offline-mail] could not lay pending changes over the device copy', overlayError)\n  )\n  // Mail that aged out of the window since the last pass, under the settings as they are now.\n  const current = options.latest?.() ?? settings\n  const trimmed = await trimOfflineMailbox(current, now)\n  // Off was chosen while this pass ran: nothing stays, and nothing counts as synced.\n  if (!current.enabled) return trimmed\n  const bytes = await enforceQuota(current.quotaMb * MB)\n  const messages = (await recordsOfKind('header')).length\n  const fullDone = !error && full\n  const status: OfflineMailStatus = {\n    lastSyncedAt: error ? previous.lastSyncedAt : now,\n    lastFullSyncAt: fullDone ? now : previous.lastFullSyncAt,\n    windowDays: fullDone ? Math.min(days, SCOPE_DAYS[current.scope]) : trimmed.windowDays,\n    messages,\n    bytes,\n    error,\n    skipped,\n  }\n  await setMeta(STATUS_KEY, status)\n  notifyOfflineMailChange('status')\n  return status\n}\n"],
+  "mappings": "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",
+  "names": ["records"]
+}

package/dist/mail/offline/wipe.js

@@ -0,0 +1,19 @@
+import { forgetOfflineMailKeys } from "./crypto.js";
+import { deleteOfflineMailDatabase, getMeta, setMeta } from "./store.js";
+import { notifyOfflineMailChange } from "./settings.js";
+const OWNER_KEY = "owner";
+async function wipeOfflineMail() {
+  forgetOfflineMailKeys();
+  await deleteOfflineMailDatabase();
+  notifyOfflineMailChange("wiped");
+}
+async function claimOfflineMail(userExtId) {
+  const owner = await getMeta(OWNER_KEY);
+  if (owner && owner !== userExtId) await wipeOfflineMail();
+  await setMeta(OWNER_KEY, userExtId);
+}
+export {
+  claimOfflineMail,
+  wipeOfflineMail
+};
+//# sourceMappingURL=wipe.js.map

package/dist/mail/offline/wipe.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/mail/offline/wipe.ts"],
+  "sourcesContent": ["/**\n * Removing the offline mailbox: on sign-out, on \"Remove offline data\", and when a different account\n * signs in on this device.\n */\n\nimport { forgetOfflineMailKeys } from './crypto'\nimport { deleteOfflineMailDatabase, getMeta, setMeta } from './store'\nimport { notifyOfflineMailChange } from './settings'\n\nconst OWNER_KEY = 'owner'\n\n/** Delete everything the offline mailbox stored on this device (mail, drafts, Outbox, status). */\nexport async function wipeOfflineMail(): Promise<void> {\n  forgetOfflineMailKeys()\n  await deleteOfflineMailDatabase()\n  notifyOfflineMailChange('wiped')\n}\n\n/**\n * Bind the store to the account signing in. A store written by someone else on this device is\n * removed (it is sealed to their key, so it is unreadable anyway, but it must not take space or\n * leave their queued mail behind).\n */\nexport async function claimOfflineMail(userExtId: string): Promise<void> {\n  const owner = await getMeta<string>(OWNER_KEY)\n  if (owner && owner !== userExtId) await wipeOfflineMail()\n  await setMeta(OWNER_KEY, userExtId)\n}\n"],
+  "mappings": "AAKA,SAAS,6BAA6B;AACtC,SAAS,2BAA2B,SAAS,eAAe;AAC5D,SAAS,+BAA+B;AAExC,MAAM,YAAY;AAGlB,eAAsB,kBAAiC;AACrD,wBAAsB;AACtB,QAAM,0BAA0B;AAChC,0BAAwB,OAAO;AACjC;AAOA,eAAsB,iBAAiB,WAAkC;AACvE,QAAM,QAAQ,MAAM,QAAgB,SAAS;AAC7C,MAAI,SAAS,UAAU,UAAW,OAAM,gBAAgB;AACxD,QAAM,QAAQ,WAAW,SAAS;AACpC;",
+  "names": []
+}

package/dist/mail/thread-keys.js

@@ -0,0 +1,53 @@
+import { useEffect } from "react";
+import { useQueryClient } from "@tanstack/react-query";
+import { logger } from "@arbidocs/client";
+import { mail as mailOps } from "@arbidocs/sdk/browser";
+import { useMailOnline, useReadMailMessage } from "./hooks.js";
+import { useMailClient } from "./useMailClient.js";
+import { nativeThreadKeys } from "./threads.js";
+import { mailQueryKeys } from "../query-keys.js";
+const BATCH = 50;
+const SECRET_FRESH_MS = 6e4;
+const tried = /* @__PURE__ */ new Set();
+function useNativeThreadKeys(account, messages) {
+  const { client, enabled } = useMailClient();
+  const isOnline = useMailOnline();
+  const queryClient = useQueryClient();
+  const readMessage = useReadMailMessage();
+  useEffect(() => {
+    if (!enabled || !isOnline || account?.provider !== "native" || !messages) return;
+    const unkeyed = messages.filter((m) => !m.thread_id && m.id.startsWith("eml-") && !tried.has(m.id)).slice(0, BATCH);
+    if (!unkeyed.length) return;
+    for (const m of unkeyed) tried.add(m.id);
+    const keyable = unkeyed.filter((m) => m.message_id);
+    if (!keyable.length) return;
+    void (async () => {
+      try {
+        const secret = await queryClient.fetchQuery({
+          queryKey: mailQueryKeys.threadSecret(),
+          queryFn: () => mailOps.getNativeThreadSecret(client.fetch),
+          staleTime: SECRET_FRESH_MS
+        });
+        const keys = {};
+        for (const listed of keyable) {
+          const source = listed.references.length ? listed : await readMessage(account, listed.id).catch(() => void 0);
+          const key = source && await nativeThreadKeys(secret, source);
+          if (key) keys[listed.id] = key;
+        }
+        if (!Object.keys(keys).length) return;
+        if (await mailOps.submitNativeThreadKeys(client.fetch, keys) > 0) {
+          await queryClient.invalidateQueries({ queryKey: mailQueryKeys.allConversations() });
+          await queryClient.invalidateQueries({ queryKey: mailQueryKeys.allMessages() });
+        }
+      } catch (error) {
+        queryClient.removeQueries({ queryKey: mailQueryKeys.threadSecret() });
+        for (const m of keyable) tried.delete(m.id);
+        logger.warn("[mail] could not key older mail into conversations", error);
+      }
+    })();
+  }, [account, messages, enabled, isOnline, client, queryClient, readMessage]);
+}
+export {
+  useNativeThreadKeys
+};
+//# sourceMappingURL=thread-keys.js.map

package/dist/mail/thread-keys.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/mail/thread-keys.ts"],
+  "sourcesContent": ["/**\n * Keying older native mail into conversations, lazily, in the background.\n *\n * The server keys every message it stores from now on, but it cannot key mail stored before: its\n * Message-IDs are encrypted to the owner. The owner's client can read them, so it computes the keys\n * (with the owner's thread secret) for the unkeyed messages it lists and submits them. Until then\n * such a message is a conversation of its own, online and offline alike.\n *\n * A list row carries the Message-ID and References; only a row with no References is read in full\n * (for its In-Reply-To), through the query cache, so a message already opened is not read again.\n */\n\nimport { useEffect } from 'react'\nimport { useQueryClient } from '@tanstack/react-query'\nimport { logger } from '@arbidocs/client'\nimport { mail as mailOps } from '@arbidocs/sdk/browser'\nimport { useMailOnline, useReadMailMessage } from './hooks'\nimport { useMailClient } from './useMailClient'\nimport { nativeThreadKeys } from './threads'\nimport { mailQueryKeys } from '../query-keys'\nimport type { MailAccount, MailMessage } from './types'\n\n/** Messages keyed per round: the next list read brings the next ones. */\nconst BATCH = 50\n\n/** How long a fetched thread secret is used before it is fetched again. */\nconst SECRET_FRESH_MS = 60_000\n\n/**\n * Messages tried in this page's life, across mounts: a keyed one needs no second try, and one with\n * no Message-ID never gets a key (it stays on its own). A failed round is tried again later.\n */\nconst tried = new Set<string>()\n\n/** Key the native `messages` listed that have no thread yet. Failures stay quiet. */\nexport function useNativeThreadKeys(\n  account: MailAccount | undefined,\n  messages: MailMessage[] | undefined\n): void {\n  const { client, enabled } = useMailClient()\n  const isOnline = useMailOnline()\n  const queryClient = useQueryClient()\n  const readMessage = useReadMailMessage()\n  useEffect(() => {\n    if (!enabled || !isOnline || account?.provider !== 'native' || !messages) return\n    const unkeyed = messages\n      .filter((m) => !m.thread_id && m.id.startsWith('eml-') && !tried.has(m.id))\n      .slice(0, BATCH)\n    if (!unkeyed.length) return\n    for (const m of unkeyed) tried.add(m.id)\n    const keyable = unkeyed.filter((m) => m.message_id)\n    if (!keyable.length) return\n    void (async () => {\n      try {\n        // Fetched again for a batch after a minute, and after any failure: a secret kept across a\n        // change on the server (a tab open through a deploy) would key mail into conversations\n        // nobody else's keys match, for good.\n        const secret = await queryClient.fetchQuery({\n          queryKey: mailQueryKeys.threadSecret(),\n          queryFn: () => mailOps.getNativeThreadSecret(client.fetch),\n          staleTime: SECRET_FRESH_MS,\n        })\n        const keys: Record<string, { thread_hmac: string; message_id_hmac?: string }> = {}\n        for (const listed of keyable) {\n          // Older list rows carry no In-Reply-To: one without References is read in full for it.\n          const source = listed.references.length\n            ? listed\n            : await readMessage(account, listed.id).catch(() => undefined)\n          const key = source && (await nativeThreadKeys(secret, source))\n          if (key) keys[listed.id] = key\n        }\n        if (!Object.keys(keys).length) return\n        if ((await mailOps.submitNativeThreadKeys(client.fetch, keys)) > 0) {\n          await queryClient.invalidateQueries({ queryKey: mailQueryKeys.allConversations() })\n          await queryClient.invalidateQueries({ queryKey: mailQueryKeys.allMessages() })\n        }\n      } catch (error) {\n        queryClient.removeQueries({ queryKey: mailQueryKeys.threadSecret() })\n        for (const m of keyable) tried.delete(m.id)\n        logger.warn('[mail] could not key older mail into conversations', error)\n      }\n    })()\n  }, [account, messages, enabled, isOnline, client, queryClient, readMessage])\n}\n"],
+  "mappings": "AAYA,SAAS,iBAAiB;AAC1B,SAAS,sBAAsB;AAC/B,SAAS,cAAc;AACvB,SAAS,QAAQ,eAAe;AAChC,SAAS,eAAe,0BAA0B;AAClD,SAAS,qBAAqB;AAC9B,SAAS,wBAAwB;AACjC,SAAS,qBAAqB;AAI9B,MAAM,QAAQ;AAGd,MAAM,kBAAkB;AAMxB,MAAM,QAAQ,oBAAI,IAAY;AAGvB,SAAS,oBACd,SACA,UACM;AACN,QAAM,EAAE,QAAQ,QAAQ,IAAI,cAAc;AAC1C,QAAM,WAAW,cAAc;AAC/B,QAAM,cAAc,eAAe;AACnC,QAAM,cAAc,mBAAmB;AACvC,YAAU,MAAM;AACd,QAAI,CAAC,WAAW,CAAC,YAAY,SAAS,aAAa,YAAY,CAAC,SAAU;AAC1E,UAAM,UAAU,SACb,OAAO,CAAC,MAAM,CAAC,EAAE,aAAa,EAAE,GAAG,WAAW,MAAM,KAAK,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC,EACzE,MAAM,GAAG,KAAK;AACjB,QAAI,CAAC,QAAQ,OAAQ;AACrB,eAAW,KAAK,QAAS,OAAM,IAAI,EAAE,EAAE;AACvC,UAAM,UAAU,QAAQ,OAAO,CAAC,MAAM,EAAE,UAAU;AAClD,QAAI,CAAC,QAAQ,OAAQ;AACrB,UAAM,YAAY;AAChB,UAAI;AAIF,cAAM,SAAS,MAAM,YAAY,WAAW;AAAA,UAC1C,UAAU,cAAc,aAAa;AAAA,UACrC,SAAS,MAAM,QAAQ,sBAAsB,OAAO,KAAK;AAAA,UACzD,WAAW;AAAA,QACb,CAAC;AACD,cAAM,OAA0E,CAAC;AACjF,mBAAW,UAAU,SAAS;AAE5B,gBAAM,SAAS,OAAO,WAAW,SAC7B,SACA,MAAM,YAAY,SAAS,OAAO,EAAE,EAAE,MAAM,MAAM,MAAS;AAC/D,gBAAM,MAAM,UAAW,MAAM,iBAAiB,QAAQ,MAAM;AAC5D,cAAI,IAAK,MAAK,OAAO,EAAE,IAAI;AAAA,QAC7B;AACA,YAAI,CAAC,OAAO,KAAK,IAAI,EAAE,OAAQ;AAC/B,YAAK,MAAM,QAAQ,uBAAuB,OAAO,OAAO,IAAI,IAAK,GAAG;AAClE,gBAAM,YAAY,kBAAkB,EAAE,UAAU,cAAc,iBAAiB,EAAE,CAAC;AAClF,gBAAM,YAAY,kBAAkB,EAAE,UAAU,cAAc,YAAY,EAAE,CAAC;AAAA,QAC/E;AAAA,MACF,SAAS,OAAO;AACd,oBAAY,cAAc,EAAE,UAAU,cAAc,aAAa,EAAE,CAAC;AACpE,mBAAW,KAAK,QAAS,OAAM,OAAO,EAAE,EAAE;AAC1C,eAAO,KAAK,sDAAsD,KAAK;AAAA,MACzE;AAAA,IACF,GAAG;AAAA,EACL,GAAG,CAAC,SAAS,UAAU,SAAS,UAAU,QAAQ,aAAa,WAAW,CAAC;AAC7E;",
+  "names": []
+}

package/dist/mail/threads.js

@@ -0,0 +1,71 @@
+function mailConversationKey(message) {
+  return message.thread_id || message.id;
+}
+function toMailConversation(threadId, members) {
+  const newest = members[0];
+  const senders = /* @__PURE__ */ new Map();
+  for (const message of [...members].reverse())
+    for (const address of message.sender)
+      if (!senders.has(address.email.toLowerCase()))
+        senders.set(address.email.toLowerCase(), address);
+  return {
+    thread_id: threadId,
+    subject: [...members].reverse().find((m) => m.subject)?.subject ?? "",
+    preview: newest.preview,
+    senders: [...senders.values()],
+    received_at: newest.received_at ?? null,
+    message_count: members.length,
+    unread_count: members.filter((m) => m.unread).length,
+    flagged: members.some((m) => m.flagged),
+    messages: members
+  };
+}
+function groupMailConversations(messages) {
+  const groups = /* @__PURE__ */ new Map();
+  for (const message of messages) {
+    const key = mailConversationKey(message);
+    const members = groups.get(key);
+    if (members) members.push(message);
+    else groups.set(key, [message]);
+  }
+  return [...groups].map(([key, members]) => toMailConversation(key, members));
+}
+const MESSAGE_ID = /<[^<>\s]+>/g;
+function ids(header) {
+  if (!header || header.length === 0) return [];
+  const text = Array.isArray(header) ? header.join(" ") : header;
+  return text.match(MESSAGE_ID) ?? text.split(/\s+/).filter(Boolean);
+}
+function mailThreadRoot(message) {
+  return ids(message.references)[0] ?? ids(message.in_reply_to)[0] ?? ids(message.message_id)[0];
+}
+async function hmacKey(secret, value) {
+  const key = await crypto.subtle.importKey(
+    "raw",
+    secret,
+    { name: "HMAC", hash: "SHA-256" },
+    false,
+    ["sign"]
+  );
+  const mac = new Uint8Array(
+    await crypto.subtle.sign("HMAC", key, new TextEncoder().encode(`message:${value.trim()}`))
+  );
+  return Array.from(mac.slice(0, 16), (b) => b.toString(16).padStart(2, "0")).join("");
+}
+async function nativeThreadKeys(secret, message) {
+  const root = mailThreadRoot(message);
+  if (!root) return void 0;
+  const own = ids(message.message_id)[0];
+  return {
+    thread_hmac: await hmacKey(secret, root),
+    ...own && { message_id_hmac: await hmacKey(secret, own) }
+  };
+}
+export {
+  groupMailConversations,
+  mailConversationKey,
+  mailThreadRoot,
+  nativeThreadKeys,
+  toMailConversation
+};
+//# sourceMappingURL=threads.js.map

package/dist/mail/threads.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/mail/threads.ts"],
+  "sourcesContent": ["/**\n * Conversations: how messages group into threads, the same rule as the server's, so a list read\n * from this device groups exactly as one read online (`group_conversations` in the backend).\n *\n * A message's conversation is its `thread_id`, else (it stands alone) its own id. Native mail's\n * thread id is a per-user key: an HMAC of the thread's root Message-ID (the first References entry,\n * else In-Reply-To, else its own Message-ID), as the backend's `email_threading.thread_keys`. The\n * server keys mail it stores; older mail is keyed by the owner's client ({@link nativeThreadKeys}),\n * because only the client can read its Message-IDs.\n */\n\nimport type { MailAddress, MailConversation, MailMessage } from './types'\n\n/** What groups a message into a conversation. */\nexport function mailConversationKey(message: Pick<MailMessage, 'id' | 'thread_id'>): string {\n  return message.thread_id || message.id\n}\n\n/** A conversation row from its messages (newest first). */\nexport function toMailConversation(threadId: string, members: MailMessage[]): MailConversation {\n  const newest = members[0]\n  const senders = new Map<string, MailAddress>()\n  for (const message of [...members].reverse())\n    for (const address of message.sender)\n      if (!senders.has(address.email.toLowerCase()))\n        senders.set(address.email.toLowerCase(), address)\n  return {\n    thread_id: threadId,\n    subject: [...members].reverse().find((m) => m.subject)?.subject ?? '',\n    preview: newest.preview,\n    senders: [...senders.values()],\n    received_at: newest.received_at ?? null,\n    message_count: members.length,\n    unread_count: members.filter((m) => m.unread).length,\n    flagged: members.some((m) => m.flagged),\n    messages: members,\n  }\n}\n\n/** Conversations of `messages` (newest first), in the order of each one's newest message. */\nexport function groupMailConversations(messages: MailMessage[]): MailConversation[] {\n  const groups = new Map<string, MailMessage[]>()\n  for (const message of messages) {\n    const key = mailConversationKey(message)\n    const members = groups.get(key)\n    if (members) members.push(message)\n    else groups.set(key, [message])\n  }\n  return [...groups].map(([key, members]) => toMailConversation(key, members))\n}\n\nconst MESSAGE_ID = /<[^<>\\s]+>/g\n\n/** Message-IDs in a header, as the backend reads them (`<\u2026>` tokens, else whitespace-split). */\nfunction ids(header: string | string[] | null | undefined): string[] {\n  if (!header || header.length === 0) return []\n  const text = Array.isArray(header) ? header.join(' ') : header\n  return text.match(MESSAGE_ID) ?? text.split(/\\s+/).filter(Boolean)\n}\n\n/** The thread's root Message-ID: the first References entry, else In-Reply-To, else its own. */\nexport function mailThreadRoot(\n  message: Pick<MailMessage, 'message_id' | 'in_reply_to' | 'references'>\n): string | undefined {\n  return ids(message.references)[0] ?? ids(message.in_reply_to)[0] ?? ids(message.message_id)[0]\n}\n\nasync function hmacKey(secret: Uint8Array, value: string): Promise<string> {\n  const key = await crypto.subtle.importKey(\n    'raw',\n    secret as BufferSource,\n    { name: 'HMAC', hash: 'SHA-256' },\n    false,\n    ['sign']\n  )\n  const mac = new Uint8Array(\n    await crypto.subtle.sign('HMAC', key, new TextEncoder().encode(`message:${value.trim()}`))\n  )\n  return Array.from(mac.slice(0, 16), (b) => b.toString(16).padStart(2, '0')).join('')\n}\n\n/**\n * A native message's keys, computed with the owner's thread secret: its thread key and its own\n * Message-ID's. `undefined` when it has no Message-ID to key (it stays a conversation of its own).\n */\nexport async function nativeThreadKeys(\n  secret: Uint8Array,\n  message: Pick<MailMessage, 'message_id' | 'in_reply_to' | 'references'>\n): Promise<{ thread_hmac: string; message_id_hmac?: string } | undefined> {\n  const root = mailThreadRoot(message)\n  if (!root) return undefined\n  const own = ids(message.message_id)[0]\n  return {\n    thread_hmac: await hmacKey(secret, root),\n    ...(own && { message_id_hmac: await hmacKey(secret, own) }),\n  }\n}\n"],
+  "mappings": "AAcO,SAAS,oBAAoB,SAAwD;AAC1F,SAAO,QAAQ,aAAa,QAAQ;AACtC;AAGO,SAAS,mBAAmB,UAAkB,SAA0C;AAC7F,QAAM,SAAS,QAAQ,CAAC;AACxB,QAAM,UAAU,oBAAI,IAAyB;AAC7C,aAAW,WAAW,CAAC,GAAG,OAAO,EAAE,QAAQ;AACzC,eAAW,WAAW,QAAQ;AAC5B,UAAI,CAAC,QAAQ,IAAI,QAAQ,MAAM,YAAY,CAAC;AAC1C,gBAAQ,IAAI,QAAQ,MAAM,YAAY,GAAG,OAAO;AACtD,SAAO;AAAA,IACL,WAAW;AAAA,IACX,SAAS,CAAC,GAAG,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO,GAAG,WAAW;AAAA,IACnE,SAAS,OAAO;AAAA,IAChB,SAAS,CAAC,GAAG,QAAQ,OAAO,CAAC;AAAA,IAC7B,aAAa,OAAO,eAAe;AAAA,IACnC,eAAe,QAAQ;AAAA,IACvB,cAAc,QAAQ,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE;AAAA,IAC9C,SAAS,QAAQ,KAAK,CAAC,MAAM,EAAE,OAAO;AAAA,IACtC,UAAU;AAAA,EACZ;AACF;AAGO,SAAS,uBAAuB,UAA6C;AAClF,QAAM,SAAS,oBAAI,IAA2B;AAC9C,aAAW,WAAW,UAAU;AAC9B,UAAM,MAAM,oBAAoB,OAAO;AACvC,UAAM,UAAU,OAAO,IAAI,GAAG;AAC9B,QAAI,QAAS,SAAQ,KAAK,OAAO;AAAA,QAC5B,QAAO,IAAI,KAAK,CAAC,OAAO,CAAC;AAAA,EAChC;AACA,SAAO,CAAC,GAAG,MAAM,EAAE,IAAI,CAAC,CAAC,KAAK,OAAO,MAAM,mBAAmB,KAAK,OAAO,CAAC;AAC7E;AAEA,MAAM,aAAa;AAGnB,SAAS,IAAI,QAAwD;AACnE,MAAI,CAAC,UAAU,OAAO,WAAW,EAAG,QAAO,CAAC;AAC5C,QAAM,OAAO,MAAM,QAAQ,MAAM,IAAI,OAAO,KAAK,GAAG,IAAI;AACxD,SAAO,KAAK,MAAM,UAAU,KAAK,KAAK,MAAM,KAAK,EAAE,OAAO,OAAO;AACnE;AAGO,SAAS,eACd,SACoB;AACpB,SAAO,IAAI,QAAQ,UAAU,EAAE,CAAC,KAAK,IAAI,QAAQ,WAAW,EAAE,CAAC,KAAK,IAAI,QAAQ,UAAU,EAAE,CAAC;AAC/F;AAEA,eAAe,QAAQ,QAAoB,OAAgC;AACzE,QAAM,MAAM,MAAM,OAAO,OAAO;AAAA,IAC9B;AAAA,IACA;AAAA,IACA,EAAE,MAAM,QAAQ,MAAM,UAAU;AAAA,IAChC;AAAA,IACA,CAAC,MAAM;AAAA,EACT;AACA,QAAM,MAAM,IAAI;AAAA,IACd,MAAM,OAAO,OAAO,KAAK,QAAQ,KAAK,IAAI,YAAY,EAAE,OAAO,WAAW,MAAM,KAAK,CAAC,EAAE,CAAC;AAAA,EAC3F;AACA,SAAO,MAAM,KAAK,IAAI,MAAM,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,SAAS,GAAG,GAAG,CAAC,EAAE,KAAK,EAAE;AACrF;AAMA,eAAsB,iBACpB,QACA,SACwE;AACxE,QAAM,OAAO,eAAe,OAAO;AACnC,MAAI,CAAC,KAAM,QAAO;AAClB,QAAM,MAAM,IAAI,QAAQ,UAAU,EAAE,CAAC;AACrC,SAAO;AAAA,IACL,aAAa,MAAM,QAAQ,QAAQ,IAAI;AAAA,IACvC,GAAI,OAAO,EAAE,iBAAiB,MAAM,QAAQ,QAAQ,GAAG,EAAE;AAAA,EAC3D;AACF;",
+  "names": []
+}

package/dist/mail/useMailClient.js

@@ -0,0 +1,42 @@
+import { useMemo } from "react";
+import { useArbiHost } from "../host/config.js";
+import { arbiMailClient, createMailClient } from "./client.js";
+import { offlineMailReads } from "./offline/reads.js";
+const NO_MAIL = {
+  client: createMailClient(
+    () => Promise.reject(new Error("Mail needs an <ArbiHost> with `mail` or an `arbi`"))
+  ),
+  enabled: false,
+  sessionKey: null
+};
+const ALWAYS = () => ({ enabled: true, sessionKey: "session" });
+function useMailClient() {
+  const { mail, arbi } = useArbiHost();
+  const fallback = useMemo(
+    () => arbi ? arbiMailClient(
+      arbi,
+      offlineMailReads(() => arbi)
+    ) : null,
+    [arbi]
+  );
+  const useStatus = mail ? mail.useStatus ?? ALWAYS : ALWAYS;
+  const { enabled, sessionKey } = useStatus();
+  const client = mail?.client;
+  const provided = useMemo(
+    () => client ? { client, enabled, sessionKey } : null,
+    [client, enabled, sessionKey]
+  );
+  if (provided) return provided;
+  if (!arbi || !fallback) return NO_MAIL;
+  let identity = null;
+  try {
+    identity = arbi.isLoggedIn ? arbi.user.identity()?.externalId ?? "session" : null;
+  } catch {
+    identity = null;
+  }
+  return { client: fallback, enabled: identity !== null, sessionKey: identity };
+}
+export {
+  useMailClient
+};
+//# sourceMappingURL=useMailClient.js.map

package/dist/mail/useMailClient.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/mail/useMailClient.ts"],
+  "sourcesContent": ["import { useMemo } from 'react'\nimport { useArbiHost } from '../host/config'\nimport { arbiMailClient, createMailClient, type MailClient } from './client'\nimport { offlineMailReads } from './offline/reads'\n\nexport interface MailClientContextValue {\n  client: MailClient\n  /** Mail reads run only while this is true (signed in). */\n  enabled: boolean\n  /**\n   * Identifies the server session the mailbox is unlocked for: unlocking runs again when it\n   * changes. `null`: no session yet, so nothing is unlocked.\n   */\n  sessionKey: string | null\n}\n\nconst NO_MAIL: MailClientContextValue = {\n  client: createMailClient(() =>\n    Promise.reject(new Error('Mail needs an <ArbiHost> with `mail` or an `arbi`'))\n  ),\n  enabled: false,\n  sessionKey: null,\n}\n\nconst ALWAYS = () => ({ enabled: true, sessionKey: 'session' })\n\n/**\n * The mail client in scope: the host configuration's `mail`, else one on its `arbi` session\n * (`arbiMailClient`) whose reads keep working offline from the mail kept on this device\n * (`offlineMailReads`).\n */\nexport function useMailClient(): MailClientContextValue {\n  const { mail, arbi } = useArbiHost()\n  const fallback = useMemo(\n    () =>\n      arbi\n        ? arbiMailClient(\n            arbi,\n            offlineMailReads(() => arbi)\n          )\n        : null,\n    [arbi]\n  )\n  // The host's status hook is fixed for its configuration's life.\n  const useStatus = mail ? (mail.useStatus ?? ALWAYS) : ALWAYS\n  const { enabled, sessionKey } = useStatus()\n  const client = mail?.client\n  const provided = useMemo(\n    () => (client ? { client, enabled, sessionKey } : null),\n    [client, enabled, sessionKey]\n  )\n  if (provided) return provided\n  // Neither: mail stays off (reads disabled, writes refused) rather than breaking the screen.\n  if (!arbi || !fallback) return NO_MAIL\n  let identity: string | null = null\n  try {\n    identity = arbi.isLoggedIn ? (arbi.user.identity()?.externalId ?? 'session') : null\n  } catch {\n    identity = null\n  }\n  return { client: fallback, enabled: identity !== null, sessionKey: identity }\n}\n"],
+  "mappings": "AAAA,SAAS,eAAe;AACxB,SAAS,mBAAmB;AAC5B,SAAS,gBAAgB,wBAAyC;AAClE,SAAS,wBAAwB;AAajC,MAAM,UAAkC;AAAA,EACtC,QAAQ;AAAA,IAAiB,MACvB,QAAQ,OAAO,IAAI,MAAM,mDAAmD,CAAC;AAAA,EAC/E;AAAA,EACA,SAAS;AAAA,EACT,YAAY;AACd;AAEA,MAAM,SAAS,OAAO,EAAE,SAAS,MAAM,YAAY,UAAU;AAOtD,SAAS,gBAAwC;AACtD,QAAM,EAAE,MAAM,KAAK,IAAI,YAAY;AACnC,QAAM,WAAW;AAAA,IACf,MACE,OACI;AAAA,MACE;AAAA,MACA,iBAAiB,MAAM,IAAI;AAAA,IAC7B,IACA;AAAA,IACN,CAAC,IAAI;AAAA,EACP;AAEA,QAAM,YAAY,OAAQ,KAAK,aAAa,SAAU;AACtD,QAAM,EAAE,SAAS,WAAW,IAAI,UAAU;AAC1C,QAAM,SAAS,MAAM;AACrB,QAAM,WAAW;AAAA,IACf,MAAO,SAAS,EAAE,QAAQ,SAAS,WAAW,IAAI;AAAA,IAClD,CAAC,QAAQ,SAAS,UAAU;AAAA,EAC9B;AACA,MAAI,SAAU,QAAO;AAErB,MAAI,CAAC,QAAQ,CAAC,SAAU,QAAO;AAC/B,MAAI,WAA0B;AAC9B,MAAI;AACF,eAAW,KAAK,aAAc,KAAK,KAAK,SAAS,GAAG,cAAc,YAAa;AAAA,EACjF,QAAQ;AACN,eAAW;AAAA,EACb;AACA,SAAO,EAAE,QAAQ,UAAU,SAAS,aAAa,MAAM,YAAY,SAAS;AAC9E;",
+  "names": []
+}