@rapidmx/web-client 0.32.0 → 0.33.0

package/dist/apps/www/contacts/index.js

@@ -7,7 +7,7 @@ import { pageTitle } from "../../shared/navigation/pageTitle.js";
 import { useNavigate } from "../../shared/navigation/index.js";
 import { useEffect, useMemo, useRef, useState } from "react";
 import { ApiRequestError } from "../../../lib/util/api.js";
-import { createContact, deleteContact, listContacts, listContactsInFolders, listDeletedContacts, setContactFavorite, updateContact, } from "../../../lib/contacts/contactsApi.js";
+import { createContact, deleteContact, listContacts, ensureSuggestedContacts, listContactsInFolders, listDeletedContacts, setContactFavorite, updateContact, } from "../../../lib/contacts/contactsApi.js";
 import { VCARD_MAX_CHARS, VCARD_MAX_CONTACTS, contactsToVCardFile, contactToVCard, parseVCards } from "../../../lib/contacts/vcard.js";
 import { withoutDuplicates } from "../../shared/components/contacts/participantDetails.js";
 import useIsMobile from "../../../lib/util/useIsMobile.js";
@@ -68,6 +68,9 @@ function ContactsContent({ userUid }) {
     const client = useApiClient();
     const [contacts, setContacts] = useState([]);
     const [deletedContacts, setDeletedContacts] = useState([]);
+    // The mailbox's Suggested Contacts folder - the people it has corresponded with - once the server has made it; `null` while unknown (an older server has none).
+    const [suggestedFolderUid, setSuggestedFolderUid] = useState(null);
+    const [suggestedContacts, setSuggestedContacts] = useState([]);
     const [deletedLoading, setDeletedLoading] = useState(false);
     const [deletedError, setDeletedError] = useState(null);
     const [loading, setLoading] = useState(true);
@@ -97,6 +100,9 @@ function ContactsContent({ userUid }) {
         }
         setLoading(true);
         setError(null);
+        if (suggestedFolderUid) {
+            void loadSuggested(suggestedFolderUid);
+        }
         return listAllPages((page) => listContacts(folderUid, { limit: LIST_PAGE_SIZE, page }, client))
             .then((result) => {
             setContacts(result.items);
@@ -108,6 +114,29 @@ function ContactsContent({ userUid }) {
     useEffect(() => {
         void reload();
     }, [folderUid]);
+    /** Reads the Suggested Contacts folder's contacts. A failure leaves the list as it was. */
+    function loadSuggested(suggestedUid) {
+        return listAllPages((page) => listContacts(suggestedUid, { limit: LIST_PAGE_SIZE, page }, client))
+            .then((result) => setSuggestedContacts(result.items))
+            .catch(() => undefined);
+    }
+    // Asks the server to turn the people this mailbox has corresponded with into suggested contacts (it does so once for each person, so this is cheap when
+    // nothing is new), then lists them. An older server, or one that refuses, simply has no such view.
+    useEffect(() => {
+        let cancelled = false;
+        // `ContactsShell` only renders this with a resolved mailbox (see the Deleted view's comment above).
+        void ensureSuggestedContacts(mailboxUid, client)
+            .then(async (result) => {
+            if (!cancelled) {
+                setSuggestedFolderUid(result.folderUid);
+                await loadSuggested(result.folderUid);
+            }
+        })
+            .catch(() => undefined);
+        return () => {
+            cancelled = true;
+        };
+    }, [mailboxUid]);
     // restapi only honors `?deleted=true` for a caller with both delete and update rights on the contacts *folder*
     // (its ACL, which inherits the mailbox's but can carry its own records) - anyone else silently gets the *live*
     // contacts back, which the Deleted view would then present as deleted. There is no client API for the caller's
@@ -165,6 +194,8 @@ function ContactsContent({ userUid }) {
                 return contacts;
             case "favorites":
                 return contacts.filter((c) => c.favorite);
+            case "suggested":
+                return suggestedContacts;
             case "list":
                 return contacts.filter((c) => c.contactListUid === view.uid);
             case "category":
@@ -172,7 +203,7 @@ function ContactsContent({ userUid }) {
             case "deleted":
                 return deletedContacts;
         }
-    }, [contacts, deletedContacts, view]);
+    }, [contacts, deletedContacts, suggestedContacts, view]);
     const filtered = useMemo(() => {
         const q = query.trim().toLowerCase();
         if (!q) {
@@ -188,7 +219,7 @@ function ContactsContent({ userUid }) {
         });
         return arr;
     }, [filtered, sortColumn, sortDesc]);
-    const selected = contacts.find((c) => c.uid === selectedUid) ?? null;
+    const selected = contacts.find((c) => c.uid === selectedUid) ?? suggestedContacts.find((c) => c.uid === selectedUid) ?? null;
     const isDeletedView = view.type === "deleted";
     const checkedContacts = sorted.filter((c) => checkedUids.has(c.uid));
     const allChecked = sorted.length > 0 && sorted.every((c) => checkedUids.has(c.uid));
@@ -344,6 +375,33 @@ function ContactsContent({ userUid }) {
         clearPinnedSignerCache();
         await reload();
     });
+    // A suggested contact becomes one of the mailbox's own: a copy in its contacts folder, and the suggestion removed (the person is not suggested again).
+    const handleAddToContacts = singleFlight(async () => {
+        for (const contact of checkedContacts) {
+            try {
+                await createContact({
+                    mailboxUid: contact.mailboxUid,
+                    folderUid: folderUid,
+                    displayName: contact.displayName,
+                    givenName: contact.givenName,
+                    surname: contact.surname,
+                    emails: contact.emails,
+                    phones: contact.phones,
+                    addresses: contact.addresses,
+                    company: contact.company,
+                    jobTitle: contact.jobTitle,
+                    notes: contact.notes,
+                    categories: contact.categories,
+                }, client);
+                await deleteContact(contact.uid, contact.version, client);
+            }
+            catch (err) {
+                notifyApiError(err, "Couldn't add some of the contacts");
+            }
+        }
+        setCheckedUids(new Set());
+        await reload();
+    });
     function handleExportVCard() {
         downloadTextFile(checkedContacts.length === 1 ? `${checkedContacts[0].displayName}.vcf` : "contacts.vcf", checkedContacts.length === 1 ? contactToVCard(checkedContacts[0]) : contactsToVCardFile(checkedContacts));
     }
@@ -392,10 +450,10 @@ function ContactsContent({ userUid }) {
         clearPinnedSignerCache();
         await reload();
     }
-    return (_jsxs("div", { className: "flex-1 min-w-0 min-h-0 flex flex-col lg:flex-row md:flex-none md:h-[calc(100dvh_-_var(--rr-header-h,4rem))] md:overflow-hidden", children: [_jsx(ContactsSidebar, { mailboxUid: mailboxUid, contacts: contacts, active: view, onSelect: handleSelectView, showDeleted: canViewDeleted }), _jsxs("div", { className: "flex-1 min-w-0 min-h-0 flex", children: [_jsxs("div", { className: [
+    return (_jsxs("div", { className: "flex-1 min-w-0 min-h-0 flex flex-col lg:flex-row md:flex-none md:h-[calc(100dvh_-_var(--rr-header-h,4rem))] md:overflow-hidden", children: [_jsx(ContactsSidebar, { mailboxUid: mailboxUid, contacts: contacts, active: view, onSelect: handleSelectView, showDeleted: canViewDeleted, suggestedCount: suggestedFolderUid ? suggestedContacts.length : undefined }), _jsxs("div", { className: "flex-1 min-w-0 min-h-0 flex", children: [_jsxs("div", { className: [
                             "w-full md:w-[clamp(16rem,32vw,26rem)] min-w-0 md:shrink-0 md:border-r border-border md:flex flex-col min-h-0",
                             mode === "new" ? "hidden md:flex" : "flex",
-                        ].join(" "), children: [_jsx(ContactsToolbar, { selectedCount: checkedContacts.length, allSelectedFavorited: checkedContacts.length > 0 && checkedContacts.every((c) => c.favorite), onNewContact: handleNew, onEdit: handleToolbarEdit, onDelete: () => setConfirmingBulkDelete(true), onEmail: handleEmail, onToggleFavorite: handleToggleFavorite, onAddCategory: handleAddCategory, onExportVCard: handleExportVCard, onImportFile: handleImportFile, shortcuts: true, hideNew: isMobile }), _jsx("div", { className: "p-3 border-b border-border", children: _jsx("input", { ref: searchInputRef, type: "search", value: query, onChange: (e) => setQuery(e.target.value), placeholder: "Search contacts", "aria-label": "Search contacts", className: INPUT_CLASS }) }), error && (_jsx("div", { className: "p-3", children: _jsx(Alert, { children: error }) })), (isDeletedView ? deletedTruncated : truncated) && (_jsx("div", { className: "p-3", children: _jsxs(Alert, { children: ["This folder has more contacts than can be shown at once - only the first ", LIST_PAGE_SIZE * MAX_LIST_PAGES, " are listed."] }) })), deletedError && isDeletedView && (_jsx("div", { className: "p-3", children: _jsx(Alert, { children: deletedError }) })), (isDeletedView ? deletedLoading : loading) ? (_jsx("p", { className: "p-4 text-sm text-text-muted", children: "Loading\u2026" })) : sorted.length === 0 ? (_jsx("p", { className: "p-4 text-sm text-text-muted", children: "No contacts found." })) : (_jsx("div", { className: "flex-1 min-h-0 overflow-auto", children: _jsxs("table", { className: "w-full table-fixed text-sm", children: [_jsx("thead", { children: _jsxs("tr", { className: "border-b border-border text-left", children: [!isDeletedView && (_jsx("th", { className: "w-10 px-3 py-2", children: _jsx("input", { type: "checkbox", "aria-label": "Select all contacts", checked: allChecked, onChange: toggleCheckAll }) })), _jsx("th", { className: "w-[58%] px-3 py-2", children: _jsxs("button", { type: "button", onClick: () => handleSort("name"), className: "block max-w-full truncate text-xs font-bold uppercase tracking-wide text-text-muted", children: ["Name", sortColumn === "name" ? (sortDesc ? " ▾" : " ▴") : ""] }) }), _jsx("th", { className: "px-3 py-2", children: _jsxs("button", { type: "button", onClick: () => handleSort("info"), className: "block max-w-full truncate text-xs font-bold uppercase tracking-wide text-text-muted", children: ["Contact info", sortColumn === "info" ? (sortDesc ? " ▾" : " ▴") : ""] }) })] }) }), _jsx("tbody", { children: sorted.map((contact) => (_jsxs("tr", { className: ["border-b border-border", contact.uid === selectedUid ? "bg-primary/10" : "hover:bg-surface-alt"].join(" "), children: [!isDeletedView && (_jsx("td", { className: "px-3 py-2", children: _jsx("input", { type: "checkbox", "aria-label": `Select ${contact.displayName}`, checked: checkedUids.has(contact.uid), onChange: () => toggleChecked(contact.uid) }) })), _jsx("td", { className: "px-3 py-2", children: _jsxs("button", { type: "button", 
+                        ].join(" "), children: [_jsx(ContactsToolbar, { selectedCount: checkedContacts.length, allSelectedFavorited: checkedContacts.length > 0 && checkedContacts.every((c) => c.favorite), onNewContact: handleNew, onEdit: handleToolbarEdit, onDelete: () => setConfirmingBulkDelete(true), onEmail: handleEmail, onToggleFavorite: handleToggleFavorite, onAddCategory: handleAddCategory, onExportVCard: handleExportVCard, onAddToContacts: view.type === "suggested" ? handleAddToContacts : undefined, onImportFile: handleImportFile, shortcuts: true, hideNew: isMobile }), _jsx("div", { className: "p-3 border-b border-border", children: _jsx("input", { ref: searchInputRef, type: "search", value: query, onChange: (e) => setQuery(e.target.value), placeholder: "Search contacts", "aria-label": "Search contacts", className: INPUT_CLASS }) }), error && (_jsx("div", { className: "p-3", children: _jsx(Alert, { children: error }) })), (isDeletedView ? deletedTruncated : truncated) && (_jsx("div", { className: "p-3", children: _jsxs(Alert, { children: ["This folder has more contacts than can be shown at once - only the first ", LIST_PAGE_SIZE * MAX_LIST_PAGES, " are listed."] }) })), deletedError && isDeletedView && (_jsx("div", { className: "p-3", children: _jsx(Alert, { children: deletedError }) })), (isDeletedView ? deletedLoading : loading) ? (_jsx("p", { className: "p-4 text-sm text-text-muted", children: "Loading\u2026" })) : sorted.length === 0 ? (_jsx("p", { className: "p-4 text-sm text-text-muted", children: "No contacts found." })) : (_jsx("div", { className: "flex-1 min-h-0 overflow-auto", children: _jsxs("table", { className: "w-full table-fixed text-sm", children: [_jsx("thead", { children: _jsxs("tr", { className: "border-b border-border text-left", children: [!isDeletedView && (_jsx("th", { className: "w-10 px-3 py-2", children: _jsx("input", { type: "checkbox", "aria-label": "Select all contacts", checked: allChecked, onChange: toggleCheckAll }) })), _jsx("th", { className: "w-[58%] px-3 py-2", children: _jsxs("button", { type: "button", onClick: () => handleSort("name"), className: "block max-w-full truncate text-xs font-bold uppercase tracking-wide text-text-muted", children: ["Name", sortColumn === "name" ? (sortDesc ? " ▾" : " ▴") : ""] }) }), _jsx("th", { className: "px-3 py-2", children: _jsxs("button", { type: "button", onClick: () => handleSort("info"), className: "block max-w-full truncate text-xs font-bold uppercase tracking-wide text-text-muted", children: ["Contact info", sortColumn === "info" ? (sortDesc ? " ▾" : " ▴") : ""] }) })] }) }), _jsx("tbody", { children: sorted.map((contact) => (_jsxs("tr", { className: ["border-b border-border", contact.uid === selectedUid ? "bg-primary/10" : "hover:bg-surface-alt"].join(" "), children: [!isDeletedView && (_jsx("td", { className: "px-3 py-2", children: _jsx("input", { type: "checkbox", "aria-label": `Select ${contact.displayName}`, checked: checkedUids.has(contact.uid), onChange: () => toggleChecked(contact.uid) }) })), _jsx("td", { className: "px-3 py-2", children: _jsxs("button", { type: "button", 
                                                             // A deleted contact has no pane to show (it can't be restored or opened), and its route would answer 404.
                                                             disabled: isDeletedView, onClick: () => handleSelectRow(contact), className: "flex w-full min-w-0 items-center gap-2 text-left disabled:cursor-default", children: [_jsx(ContactPhotoAvatar, { lazy: true, displayName: contact.displayName, size: 28, contact: contact, email: contact.emails[0]?.address }), _jsxs("span", { className: "min-w-0 truncate font-medium", children: [contact.displayName, contact.favorite && _jsx("span", { "aria-label": "Favorite", children: " \u2605" })] })] }) }), _jsx("td", { className: "max-w-0 truncate px-3 py-2 text-text-muted", children: primaryInfo(contact) })] }, contact.uid))) })] }) }))] }), _jsxs("div", { className: ["flex-1 min-w-0 min-h-0 flex-col md:flex", mode === "new" ? "flex" : "hidden"].join(" "), children: [savedElsewhere && mode !== "new" && (_jsxs("p", { role: "status", className: "m-6 mb-0 text-sm py-2 px-3 rounded-sm bg-surface-alt text-text", children: [savedElsewhere.displayName, " was added to", " ", mailboxes.find((mb) => mb.uid === savedElsewhere.mailboxUid)?.displayName ?? "another mailbox", ".", " ", _jsx("a", { href: `/contacts?mailboxUid=${encodeURIComponent(savedElsewhere.mailboxUid)}`, "data-router-shallow": "", "data-router-prefetch": "false", className: "font-medium text-primary-dark hover:underline", children: "View that mailbox\u2019s contacts" })] })), mode === "new" && mailboxUid && folderUid ? (_jsx(ContactForm, { mailboxUid: mailboxUid, folderUid: folderUid, mailboxes: writableMailboxes, onSaved: handleSaved, onCancel: handleCancel })) : mode === "edit" && selected ? (_jsx(ContactForm, { contact: selected, onSaved: handleSaved, onCancel: handleCancel })) : selected ? (_jsx("div", { className: "min-h-0 flex-1 overflow-y-auto p-6", children: _jsx(ContactDetailPane, { contact: selected, onEdit: () => setMode("edit"), onDelete: () => handleDelete(selected), canWrite: mailboxWritable, onKeysChanged: () => void reload(), onChanged: () => void reload(), canResolveKeys: ownsMailbox || delegateCanUpdate }) })) : (_jsx("div", { className: "flex flex-1 items-center justify-center p-6 text-center", children: _jsx("p", { className: "text-sm text-text-muted", children: "Select a contact, or create a new one." }) }))] })] }), _jsxs(Modal, { open: confirmingBulkDelete, onClose: () => setConfirmingBulkDelete(false), title: "Delete contacts", children: [_jsxs("p", { className: "text-sm mb-5", children: ["Delete ", checkedContacts.length, " selected ", checkedContacts.length === 1 ? "contact" : "contacts", "? They move to Deleted contacts."] }), _jsxs("div", { className: "flex gap-3 justify-end", children: [_jsx(Button, { type: "button", variant: "secondary", className: "!w-auto", onClick: () => setConfirmingBulkDelete(false), children: "Cancel" }), _jsx(Button, { type: "button", className: "!w-auto !bg-none !bg-danger !border-danger hover:!bg-danger", onClick: handleBulkDelete, children: "Delete" })] })] }), isMobile && mode !== "new" && _jsx(FloatingActionButton, { label: "New contact", icon: HiOutlineUserPlus, onClick: handleNew })] }));
 }

package/dist/apps/www/tasks/index.js

@@ -42,7 +42,7 @@ function bucketFor(task, now) {
     if (isToday(due)) {
         return "Today";
     }
-    if (!isAfter(due, endOfWeek(now, { weekStartsOn: 1 }))) {
+    if (!isAfter(due, endOfWeek(now, { weekStartsOn: 0 }))) {
         return "This Week";
     }
     return "Later";

package/dist/lib/calendar/recurrence.js

@@ -261,7 +261,7 @@ export function describeRecurrence(rule) {
     const rrule = buildRRule(rule, new Date());
     return rrule.toText();
 }
-export const WEEKDAY_CODES = ["MO", "TU", "WE", "TH", "FR", "SA", "SU"];
+export const WEEKDAY_CODES = ["SU", "MO", "TU", "WE", "TH", "FR", "SA"];
 export const WEEKDAY_LABELS = {
     MO: "Mon",
     TU: "Tue",

package/dist/lib/components/overlays/overlayStack.d.ts

@@ -16,6 +16,12 @@ import { RefObject } from "react";
  * belongs above it regardless of effect ordering - see `push()`.
  */
 export declare const OverlayDepthContext: import("react").Context<number>;
+/**
+ * Closes every open overlay at once - what a caller does when it hands the reader over to something outside them (a compose window opened from a
+ * contact card, which sits on top of the event card it was reached from): leaving the cards underneath open would leave the reader a dialog they
+ * never asked to keep, in front of the window they just opened. Each overlay's own `onClose` runs, as for Escape.
+ */
+export declare function closeAllOverlays(): void;
 /**
  * Wires one open overlay into the stack: on open, remembers the previously focused element and moves
  * focus into `dialogRef`'s element; while open *and topmost*, Escape calls `onClose` and Tab/Shift+Tab

package/dist/lib/components/overlays/overlayStack.js

@@ -97,6 +97,16 @@ function push(entry) {
     }
     stack.splice(index, 0, entry);
 }
+/**
+ * Closes every open overlay at once - what a caller does when it hands the reader over to something outside them (a compose window opened from a
+ * contact card, which sits on top of the event card it was reached from): leaving the cards underneath open would leave the reader a dialog they
+ * never asked to keep, in front of the window they just opened. Each overlay's own `onClose` runs, as for Escape.
+ */
+export function closeAllOverlays() {
+    for (const entry of [...stack]) {
+        entry.onEscape();
+    }
+}
 function remove(entry) {
     stack.splice(stack.indexOf(entry), 1);
     if (stack.length === 0) {

package/dist/lib/components/pickers/MiniDatePicker.d.ts

@@ -5,7 +5,7 @@ export interface MiniDatePickerProps {
     onSelect: (date: Date) => void;
 }
 /** A compact month-grid date picker for the Calendar sidebar, reusing `MonthView`'s own grid-generation
- * approach (`date-fns`'s `startOfWeek`/`endOfWeek`/`eachDayOfInterval`, Monday-start) rather than
+ * approach (`date-fns`'s `startOfWeek`/`endOfWeek`/`eachDayOfInterval`, Sunday-start) rather than
  * re-deriving it — this component just renders that same grid far smaller and without any event data.
  * Its own displayed month tracks `selected` (so navigating the main view keeps this in sync) but can
  * also be paged independently via the arrows without moving the main view until a day is actually

package/dist/lib/components/pickers/MiniDatePicker.js

@@ -5,9 +5,9 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 ///////////////////////////////////////////////////////////////////////////////
 import { useState } from "react";
 import { addMonths, eachDayOfInterval, endOfMonth, endOfWeek, format, isSameDay, isSameMonth, isToday, startOfMonth, startOfWeek } from "date-fns";
-const WEEKDAY_LABELS = ["M", "T", "W", "T", "F", "S", "S"];
+const WEEKDAY_LABELS = ["S", "M", "T", "W", "T", "F", "S"];
 /** A compact month-grid date picker for the Calendar sidebar, reusing `MonthView`'s own grid-generation
- * approach (`date-fns`'s `startOfWeek`/`endOfWeek`/`eachDayOfInterval`, Monday-start) rather than
+ * approach (`date-fns`'s `startOfWeek`/`endOfWeek`/`eachDayOfInterval`, Sunday-start) rather than
  * re-deriving it — this component just renders that same grid far smaller and without any event data.
  * Its own displayed month tracks `selected` (so navigating the main view keeps this in sync) but can
  * also be paged independently via the arrows without moving the main view until a day is actually
@@ -23,8 +23,8 @@ export default function MiniDatePicker({ selected, onSelect }) {
         setTrackedSelectedMonth(startOfMonth(selected));
         setShownMonth(startOfMonth(selected));
     }
-    const gridStart = startOfWeek(startOfMonth(shownMonth), { weekStartsOn: 1 });
-    const gridEnd = endOfWeek(endOfMonth(shownMonth), { weekStartsOn: 1 });
+    const gridStart = startOfWeek(startOfMonth(shownMonth), { weekStartsOn: 0 });
+    const gridEnd = endOfWeek(endOfMonth(shownMonth), { weekStartsOn: 0 });
     const days = eachDayOfInterval({ start: gridStart, end: gridEnd });
     return (_jsxs("nav", { "aria-label": "Mini calendar", className: "p-2", children: [_jsxs("div", { className: "flex items-center justify-between mb-1.5", children: [_jsx("button", { type: "button", "aria-label": "Previous month", onClick: () => setShownMonth((m) => addMonths(m, -1)), className: "w-6 h-6 text-xs rounded-sm hover:bg-surface-alt", children: "\u2039" }), _jsx("span", { className: "text-xs font-semibold", children: format(shownMonth, "MMMM yyyy") }), _jsx("button", { type: "button", "aria-label": "Next month", onClick: () => setShownMonth((m) => addMonths(m, 1)), className: "w-6 h-6 text-xs rounded-sm hover:bg-surface-alt", children: "\u203A" })] }), _jsxs("div", { className: "grid grid-cols-7 gap-0.5", children: [WEEKDAY_LABELS.map((label, i) => (_jsx("div", { className: "text-[10px] text-text-muted text-center", children: label }, i))), days.map((day) => (_jsx("button", { type: "button", onClick: () => {
                             onSelect(day);

package/dist/lib/contacts/contactsApi.d.ts

@@ -122,6 +122,18 @@ export declare function fetchSignerKeyState(folderUids: string[], address: strin
  * is browse-only until that lands.
  */
 export declare function listDeletedContacts(folderUid: string, params?: ListParams, client?: ApiClient): Promise<Contact[]>;
+/** What `ensureSuggestedContacts()` did: the mailbox's Suggested Contacts folder, how many contacts it just added, and how many people are still waiting for the next call. */
+export interface SuggestedContactsResult {
+    folderUid: string;
+    created: number;
+    remaining: number;
+}
+/**
+ * Makes the people `mailboxUid` has exchanged mail or invitations with into contacts of its Suggested Contacts folder (a folder of their own, kept apart
+ * from the mailbox's contacts), and returns that folder. Idempotent: a person already a contact, or already suggested once, is never added again, so it
+ * is called whenever the contacts are shown.
+ */
+export declare function ensureSuggestedContacts(mailboxUid: string, client?: ApiClient): Promise<SuggestedContactsResult>;
 export declare function getContact(uid: string, client?: ApiClient): Promise<Contact>;
 export interface ContactInput {
     mailboxUid: string;

package/dist/lib/contacts/contactsApi.js

@@ -100,6 +100,14 @@ export async function fetchSignerKeyState(folderUids, address, client) {
 export function listDeletedContacts(folderUid, params = {}, client) {
     return withClient(client, `/mail/contacts?${buildQuery(params, { folderUid, deleted: "true", sort: CONTACT_SORT })}`);
 }
+/**
+ * Makes the people `mailboxUid` has exchanged mail or invitations with into contacts of its Suggested Contacts folder (a folder of their own, kept apart
+ * from the mailbox's contacts), and returns that folder. Idempotent: a person already a contact, or already suggested once, is never added again, so it
+ * is called whenever the contacts are shown.
+ */
+export function ensureSuggestedContacts(mailboxUid, client) {
+    return withClient(client, `/mail/directory/suggested-contacts?${buildQuery({}, { mailboxUid })}`, { method: "POST" });
+}
 export function getContact(uid, client) {
     return withClient(client, `/mail/contacts/${encodeURIComponent(uid)}`);
 }

package/lib/calendar/recurrence.ts

@@ -324,7 +324,7 @@ export function describeRecurrence(rule: RecurrenceRule): string {
     return rrule.toText();
 }
 
-export const WEEKDAY_CODES: WeekdayCode[] = ["MO", "TU", "WE", "TH", "FR", "SA", "SU"];
+export const WEEKDAY_CODES: WeekdayCode[] = ["SU", "MO", "TU", "WE", "TH", "FR", "SA"];
 export const WEEKDAY_LABELS: Record<WeekdayCode, string> = {
     MO: "Mon",
     TU: "Tue",

package/lib/components/overlays/overlayStack.ts

@@ -115,6 +115,17 @@ function push(entry: OverlayEntry) {
     stack.splice(index, 0, entry);
 }
 
+/**
+ * Closes every open overlay at once - what a caller does when it hands the reader over to something outside them (a compose window opened from a
+ * contact card, which sits on top of the event card it was reached from): leaving the cards underneath open would leave the reader a dialog they
+ * never asked to keep, in front of the window they just opened. Each overlay's own `onClose` runs, as for Escape.
+ */
+export function closeAllOverlays(): void {
+    for (const entry of [...stack]) {
+        entry.onEscape();
+    }
+}
+
 function remove(entry: OverlayEntry) {
     stack.splice(stack.indexOf(entry), 1);
     if (stack.length === 0) {

package/lib/components/pickers/MiniDatePicker.tsx

@@ -11,10 +11,10 @@ export interface MiniDatePickerProps {
     onSelect: (date: Date) => void;
 }
 
-const WEEKDAY_LABELS = ["M", "T", "W", "T", "F", "S", "S"];
+const WEEKDAY_LABELS = ["S", "M", "T", "W", "T", "F", "S"];
 
 /** A compact month-grid date picker for the Calendar sidebar, reusing `MonthView`'s own grid-generation
- * approach (`date-fns`'s `startOfWeek`/`endOfWeek`/`eachDayOfInterval`, Monday-start) rather than
+ * approach (`date-fns`'s `startOfWeek`/`endOfWeek`/`eachDayOfInterval`, Sunday-start) rather than
  * re-deriving it — this component just renders that same grid far smaller and without any event data.
  * Its own displayed month tracks `selected` (so navigating the main view keeps this in sync) but can
  * also be paged independently via the arrows without moving the main view until a day is actually
@@ -31,8 +31,8 @@ export default function MiniDatePicker({ selected, onSelect }: MiniDatePickerPro
         setShownMonth(startOfMonth(selected));
     }
 
-    const gridStart = startOfWeek(startOfMonth(shownMonth), { weekStartsOn: 1 });
-    const gridEnd = endOfWeek(endOfMonth(shownMonth), { weekStartsOn: 1 });
+    const gridStart = startOfWeek(startOfMonth(shownMonth), { weekStartsOn: 0 });
+    const gridEnd = endOfWeek(endOfMonth(shownMonth), { weekStartsOn: 0 });
     const days = eachDayOfInterval({ start: gridStart, end: gridEnd });
 
     return (

package/lib/contacts/contactsApi.ts

@@ -203,6 +203,22 @@ export function listDeletedContacts(folderUid: string, params: ListParams = {},
     );
 }
 
+/** What `ensureSuggestedContacts()` did: the mailbox's Suggested Contacts folder, how many contacts it just added, and how many people are still waiting for the next call. */
+export interface SuggestedContactsResult {
+    folderUid: string;
+    created: number;
+    remaining: number;
+}
+
+/**
+ * Makes the people `mailboxUid` has exchanged mail or invitations with into contacts of its Suggested Contacts folder (a folder of their own, kept apart
+ * from the mailbox's contacts), and returns that folder. Idempotent: a person already a contact, or already suggested once, is never added again, so it
+ * is called whenever the contacts are shown.
+ */
+export function ensureSuggestedContacts(mailboxUid: string, client?: ApiClient): Promise<SuggestedContactsResult> {
+    return withClient(client, `/mail/directory/suggested-contacts?${buildQuery({}, { mailboxUid })}`, { method: "POST" });
+}
+
 export function getContact(uid: string, client?: ApiClient): Promise<Contact> {
     return withClient(client, `/mail/contacts/${encodeURIComponent(uid)}`);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rapidmx/web-client",
-  "version": "0.32.0",
+  "version": "0.33.0",
   "description": "RapidMX's webmail and admin console React UI for web-based clients.",
   "type": "module",
   "repository": "https://github.com/rapidmx/web-client",