@bobfrankston/mailx-types 0.1.10 → 0.1.12

package/index.d.ts

@@ -38,8 +38,7 @@ export interface AccountConfig {
     primaryContacts?: boolean; /** Per-feature override: use this account's Google Contacts. Falls back to `primary` if unset. */
     defaultSend?: boolean; /** Use this account's SMTP when From doesn't match any account */
     syncContacts?: boolean; /** Sync contacts even when account is disabled (contacts-only Gmail) */
-    relayDomains?: string[]; /** Domains to skip in Delivered-To chain (e.g., ["m.connectivity.xyz"]) */
-    deliveredToPrefix?: string[]; /** Prefixes to strip from Delivered-To to get clean alias (e.g., ["bobf-ma-", "bobf-"]) — order matters, longest first */
+    relayDomains?: string[]; /** Domains to skip in Delivered-To chain (e.g., ["relay.aaz.lt"]) */
     identityDomains?: string[]; /** Domains where Delivered-To address should become the reply From (e.g., ["bob.ma", "bobf.frankston.com"]) */
     spam?: string; /** IMAP folder path for "Mark as spam" button (e.g., "_spam"). Button hidden when not set. */
     signature?: string; /** Legacy: HTML signature appended to all outgoing messages (new + reply + forward). Plain text or HTML allowed. Superseded by `sig`. */
@@ -65,6 +64,30 @@ export interface Folder {
     unreadCount: number;
     children: Folder[]; /** Nested subfolders */
 }
+interface FlagBearing {
+    flags: string[];
+}
+export declare const seenOf: (m: {
+    flags?: readonly string[];
+}) => boolean;
+export declare const flaggedOf: (m: {
+    flags?: readonly string[];
+}) => boolean;
+export declare const answeredOf: (m: {
+    flags?: readonly string[];
+}) => boolean;
+export declare const draftOf: (m: {
+    flags?: readonly string[];
+}) => boolean;
+export declare const deletedOf: (m: {
+    flags?: readonly string[];
+}) => boolean;
+export declare const setSeen: (m: FlagBearing, state: boolean) => void;
+export declare const setFlagged: (m: FlagBearing, state: boolean) => void;
+export declare const setAnswered: (m: FlagBearing, state: boolean) => void;
+export declare const setDraft: (m: FlagBearing, state: boolean) => void;
+export declare const toggleSeen: (m: FlagBearing) => void;
+export declare const toggleFlagged: (m: FlagBearing) => void;
 /** Email address with optional display name */
 export interface EmailAddress {
     name: string; /** Display name, may be empty */

package/index.js

@@ -12,6 +12,50 @@ export { CONTACT_RULES } from "./contact-rules.js";
 // send time. Both desktop and Android send paths consume this expander
 // against contacts.jsonc → groups.
 export { expandRecipients, splitRecipients, isAddressToken, extractAddress, } from "./groups.js";
+// ── Message flag state ──
+//
+// External API surface for the IMAP system flags. The literal strings
+// (`"\\Seen"`, `"\\Flagged"`, etc.) live ONLY inside this module — every
+// caller speaks in terms of named predicates (`seenOf(msg)`) and verbs
+// (`setSeen(msg, true)`, `toggleSeen(msg)`). That keeps a typo like
+// `"\Seen"` (single backslash) from silently bypassing flag checks
+// elsewhere, and removes the "two-API leak" of having both `FLAG.SEEN`
+// constants AND verb helpers exposed simultaneously.
+//
+// These work against any object with a mutable `flags: string[]`
+// property — `MessageEnvelope`, `Message`, and the row's `msg` reference
+// all qualify. The verbs return `void` and mutate `msg.flags` in place
+// (replacing the array with a fresh one so listeners observing
+// reference identity, e.g. message-state, still re-render). Pure
+// predicate calls (`seenOf`, `flaggedOf`) don't mutate.
+const _SEEN = "\\Seen";
+const _FLAGGED = "\\Flagged";
+const _ANSWERED = "\\Answered";
+const _DRAFT = "\\Draft";
+const _DELETED = "\\Deleted";
+function _has(msg, flag) {
+    return !!msg.flags && msg.flags.includes(flag);
+}
+function _set(msg, flag, state) {
+    const present = (msg.flags || []).includes(flag);
+    if (state === present)
+        return;
+    const next = state
+        ? [...(msg.flags || []), flag]
+        : (msg.flags || []).filter(f => f !== flag);
+    msg.flags = next;
+}
+export const seenOf = (m) => _has(m, _SEEN);
+export const flaggedOf = (m) => _has(m, _FLAGGED);
+export const answeredOf = (m) => _has(m, _ANSWERED);
+export const draftOf = (m) => _has(m, _DRAFT);
+export const deletedOf = (m) => _has(m, _DELETED);
+export const setSeen = (m, state) => _set(m, _SEEN, state);
+export const setFlagged = (m, state) => _set(m, _FLAGGED, state);
+export const setAnswered = (m, state) => _set(m, _ANSWERED, state);
+export const setDraft = (m, state) => _set(m, _DRAFT, state);
+export const toggleSeen = (m) => _set(m, _SEEN, !_has(m, _SEEN));
+export const toggleFlagged = (m) => _set(m, _FLAGGED, !_has(m, _FLAGGED));
 // ── Shared Utilities ──
 // Pure functions used by both desktop (mailx-service) and Android (web-service).
 // Kept here to avoid duplication — both platforms import from mailx-types.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bobfrankston/mailx-types",
-  "version": "0.1.10",
+  "version": "0.1.12",
   "type": "module",
   "main": "index.js",
   "types": "index.d.ts",