Files
ihasmail-inbuxa/web/src/lib/__tests__/mailboxRoute.test.ts
T
jcoffey-dev 5a7cc5cc5a Say a missing folder is missing, not empty
A folder id the account does not have rendered the ordinary empty state --
"Nothing here. This folder is empty." That is a claim about a folder that
is not there, so a stale link read as a folder that had emptied itself
rather than one that was gone (#111).

It now goes to the inbox and says why. Inbox is the kinder landing than a
dead end for a bookmark that has outlived its folder, but swapping one
folder for another without a word would be its own small lie, so it does
not do that either.

The condition worth writing a test around is not the unknown id, it is
the one guarding it. The folder list arrives after the first paint, so for
a moment *every* id is unknown, the right one included. Without that gate
this redirects on every cold load, from the folder the reader actually
asked for, and looks exactly like a flaky link -- a worse bug than the one
being fixed and a harder one to see. `isUnknownMailbox` is a small pure
function so that case can be pinned down rather than reasoned about.

Only ever reachable from outside the app, which is why it went unnoticed:
the sidebar links to ids that exist. A bookmark to a deleted folder, or a
folder link passed between accounts, is where it bites.

Verified against the mock: an unknown id lands on the inbox with the
message and a full list rather than an empty one, and a cold load straight
into a real folder stays in that folder with nothing said.

Closes #111.
2026-08-27 15:28:26 -07:00

47 lines
2.1 KiB
TypeScript

import { describe, expect, it } from "vitest";
import { isUnknownMailbox } from "@/lib/mailboxRoute";
import type { Mailbox } from "@/jmap/types";
/**
* Issue #111: a folder id the account does not have rendered the ordinary
* empty state — "Nothing here. This folder is empty" — which is a claim about
* a folder that is not there. A stale link read as a folder that had emptied
* itself rather than one that was gone.
*
* The interesting case is not the unknown id. It is `loaded`: the folder list
* arrives after the first paint, so for a moment *every* id is unknown,
* including the right one. A version without that gate sends the reader to
* their inbox from the folder they asked for, on every cold load, and looks
* exactly like a flaky link.
*/
const boxes = (...ids: string[]): Record<string, Mailbox> =>
Object.fromEntries(ids.map((id) => [id, { id, name: id } as Mailbox]));
describe("spotting a folder the account does not have", () => {
it("is unknown when the list is loaded and does not contain it", () => {
expect(isUnknownMailbox({ mailboxId: "ghost", mailboxes: boxes("a", "b"), loaded: true })).toBe(true);
});
it("is not unknown when the list contains it", () => {
expect(isUnknownMailbox({ mailboxId: "a", mailboxes: boxes("a", "b"), loaded: true })).toBe(false);
});
});
describe("what it refuses to call unknown", () => {
it("says nothing before the folder list has arrived", () => {
// The whole point. Every id is unknown at this moment, the real one too.
expect(isUnknownMailbox({ mailboxId: "a", mailboxes: {}, loaded: false })).toBe(false);
expect(isUnknownMailbox({ mailboxId: "ghost", mailboxes: {}, loaded: false })).toBe(false);
});
it("says nothing when there is no folder in the address", () => {
// /mail has its own redirect to the inbox; this must not race it.
expect(isUnknownMailbox({ mailboxId: undefined, mailboxes: boxes("a"), loaded: true })).toBe(false);
});
it("says nothing on a search, which has no folder to be wrong about", () => {
expect(isUnknownMailbox({ mailboxId: "ghost", mailboxes: boxes("a"), loaded: true, search: true })).toBe(false);
});
});