Files
ihasmail/web/src/lib/__tests__/htmlAlternative.test.ts
T
jcoffey-dev bd6a605d61 Group six more clusters out of web/src/lib
Takes the flat module count from 66 to 42, continuing what admin/ and
calendar/ started.

  lib/mailbox/  archiveDate, emptyFolder, folderMove, labelTree,
                mailboxName, mailboxRoute
  lib/sieve/    sieve, sieveApply, sieveFolders
  lib/input/    keyboard, swipe, touch, listSelection, dropUpload
  lib/notify/   notify, webpush, webpushEnable
  lib/sw/       swCache, swFacts, staleBuild
  lib/text/     html, markdown, text, emlName

FOUR THINGS THE FILENAMES GET WRONG, each checked by reading the file
rather than trusting what it is called:

  - appFolder is not a mailbox. It is the `ihasmail` folder in JMAP
    *Files*, where the client keeps signature images and synced settings.
    It stays flat.
  - format holds no formatting of text. It re-exports the date and clock
    formatters, so it belongs with dates/datetime, not with text/.
  - preview is the file viewer deciding what it can show without
    downloading, and source is where to point someone asking for this
    instance's AGPL source. Neither is about text.
  - notify is not Web Push. It is the tab title, the favicon badge and
    the new-mail sound -- in-app notification, which is why it sits with
    webpush rather than under sw/ with the service worker's own concerns.

threadScroll stays flat too: it decides where a conversation opens, which
is view state rather than a gesture, and input/ is honest only if
everything in it interprets something the reader did.

No behavior change. Almost every reference was on the @/ alias; eight
relative imports in files that did not move, or that moved away from a
sibling, needed rewriting by hand.
2026-09-15 23:17:50 -07:00

55 lines
2.5 KiB
TypeScript

import { describe, expect, it } from "vitest";
import { hasHtmlAlternative } from "../text/html";
/*
* The rule: `htmlBody` is derived, so its presence proves nothing. Only the
* part's own type says whether there is an HTML alternative to render.
*
* The shapes below are what Stalwart 0.16.21 actually returned for one thread
* on 2026-09-10, read back through `Email/get` with
* `bodyProperties: ["partId", "type"]`. A plain-text message named the *same*
* part in both lists; a message with a real alternative named two.
*
* Getting this wrong is not a rendering nicety. Plain text went to the HTML
* path, which places the body under `white-space: normal`, so every line break
* collapsed: hard-wrapped mail arrived as one paragraph, and the signature and
* the quoted reply ran into the prose.
*/
describe("deciding whether a message has an HTML alternative", () => {
it("says no to a plain-text message, whose htmlBody holds the text part", () => {
// As returned for [email protected]: htmlBody[0] and textBody[0] are the
// same part, typed text/plain.
expect(hasHtmlAlternative({ type: "text/plain" }, "Hey,\n\nmy earlier response was before\n")).toBe(false);
});
it("says yes to a real multipart/alternative", () => {
expect(hasHtmlAlternative({ type: "text/html" }, "<p>Hello</p>")).toBe(true);
});
it("keeps the parameters that follow a media type", () => {
// `type` arrives bare in practice, but a charset must not turn a real HTML
// part into a plain-text one.
expect(hasHtmlAlternative({ type: "text/html; charset=utf-8" }, "<p>Hi</p>")).toBe(true);
});
it("is not fooled by a type that merely starts with the right letters", () => {
expect(hasHtmlAlternative({ type: "text/htmlish" }, "<p>Hi</p>")).toBe(false);
});
it("matches the type case-insensitively, since a header may be capitalized", () => {
expect(hasHtmlAlternative({ type: "TEXT/HTML" }, "<p>Hi</p>")).toBe(true);
});
it("says no when the part is HTML but its value never arrived", () => {
// maxBodyValueBytes can leave a part named with nothing fetched; falling
// through to the text body is the useful answer, not an empty pane.
expect(hasHtmlAlternative({ type: "text/html" }, undefined)).toBe(false);
expect(hasHtmlAlternative({ type: "text/html" }, "")).toBe(false);
});
it("says no when there is no part at all", () => {
expect(hasHtmlAlternative(undefined, undefined)).toBe(false);
expect(hasHtmlAlternative({}, "something")).toBe(false);
});
});