feat(settings): AI tab and email preferences with a local send schedule

apps/api/src/routes/internal/digest.http.ts

@@ -23,6 +23,7 @@ export const HttpDigestLive = HttpApiBuilder.group(MapleInternalApi, "digest", (
 						email: payload.email,
 						enabled: payload.enabled,
 						dayOfWeek: payload.dayOfWeek,
+						sendHour: payload.sendHour,
 						timezone: payload.timezone,
 						namespaces: payload.namespaces,
 						environments: payload.environments,

apps/web/src/components/account/digest-preferences.test.ts

@@ -0,0 +1,54 @@
+import { describe, expect, it } from "vitest"
+
+import { digestTimeZoneOptions, newDigestDraft, sameDigestDraft } from "./digest-preferences"
+
+const base = {
+	dayOfWeek: 1,
+	sendHour: 9,
+	timezone: "Europe/Berlin",
+	namespaces: ["payments", "checkout"],
+	environments: ["production"],
+}
+
+describe("sameDigestDraft", () => {
+	it("ignores the order scope values were picked in", () => {
+		expect(sameDigestDraft(base, { ...base, namespaces: ["checkout", "payments"] })).toBe(true)
+	})
+
+	it("sees a change to the day, hour, zone or scope", () => {
+		expect(sameDigestDraft(base, { ...base, dayOfWeek: 0 })).toBe(false)
+		expect(sameDigestDraft(base, { ...base, sendHour: 10 })).toBe(false)
+		expect(sameDigestDraft(base, { ...base, timezone: "UTC" })).toBe(false)
+		expect(sameDigestDraft(base, { ...base, environments: [] })).toBe(false)
+	})
+})
+
+describe("digestTimeZoneOptions", () => {
+	it("keeps the saved and browser zones selectable and puts UTC first", () => {
+		const zones = digestTimeZoneOptions(["Europe/Berlin", "Asia/Tokyo"], "Etc/GMT+5", "America/Denver")
+		expect(zones[0]).toBe("UTC")
+		expect(zones).toEqual(["UTC", "America/Denver", "Asia/Tokyo", "Etc/GMT+5", "Europe/Berlin"])
+	})
+
+	it("lists each zone once", () => {
+		const zones = digestTimeZoneOptions(["UTC", "Europe/Berlin"], "Europe/Berlin", "Europe/Berlin")
+		expect(zones).toEqual(["UTC", "Europe/Berlin"])
+	})
+})
+
+describe("newDigestDraft", () => {
+	it("schedules a first-time subscriber in the browser's zone", () => {
+		expect(newDigestDraft("America/Los_Angeles")).toEqual({
+			dayOfWeek: 1,
+			sendHour: 9,
+			timezone: "America/Los_Angeles",
+			namespaces: [],
+			environments: [],
+		})
+	})
+
+	it("falls back to UTC when the browser reports no zone", () => {
+		expect(newDigestDraft(undefined).timezone).toBe("UTC")
+		expect(newDigestDraft("").timezone).toBe("UTC")
+	})
+})

apps/web/src/components/account/digest-preferences.ts

@@ -0,0 +1,66 @@
+import { isSameDraft } from "@/components/settings/settings-draft"
+
+/** Monday first, as people read a week; values are `Date#getDay` numbers (0 = Sunday). */
+export const DIGEST_DAYS = [
+	{ value: 1, label: "Monday" },
+	{ value: 2, label: "Tuesday" },
+	{ value: 3, label: "Wednesday" },
+	{ value: 4, label: "Thursday" },
+	{ value: 5, label: "Friday" },
+	{ value: 6, label: "Saturday" },
+	{ value: 0, label: "Sunday" },
+] as const
+
+export const DIGEST_HOURS = Array.from({ length: 24 }, (_, hour) => ({
+	value: hour,
+	label: `${String(hour).padStart(2, "0")}:00`,
+}))
+
+/** What the server applies to a subscriber who never saved a schedule. */
+const DEFAULT_DIGEST_SCHEDULE = { dayOfWeek: 1, sendHour: 9, timezone: "UTC" } as const
+
+export interface DigestPreferencesDraft {
+	readonly dayOfWeek: number
+	readonly sendHour: number
+	readonly timezone: string
+	readonly namespaces: ReadonlyArray<string>
+	readonly environments: ReadonlyArray<string>
+}
+
+/**
+ * The draft for someone with no subscription yet: the server's day and hour, but in the
+ * browser's own zone, so the schedule reads in local time before the first save.
+ */
+export function newDigestDraft(browserZone: string | undefined): DigestPreferencesDraft {
+	return {
+		...DEFAULT_DIGEST_SCHEDULE,
+		timezone:
+			browserZone !== undefined && browserZone !== "" ? browserZone : DEFAULT_DIGEST_SCHEDULE.timezone,
+		namespaces: [],
+		environments: [],
+	}
+}
+
+const sorted = (values: ReadonlyArray<string>) => [...values].sort()
+
+/** Scopes are sets: picking the same namespaces in another order is not an edit. */
+export function sameDigestDraft(a: DigestPreferencesDraft, b: DigestPreferencesDraft): boolean {
+	return isSameDraft(
+		{ ...a, namespaces: sorted(a.namespaces), environments: sorted(a.environments) },
+		{ ...b, namespaces: sorted(b.namespaces), environments: sorted(b.environments) },
+	)
+}
+
+/**
+ * Zones for the picker: every zone the browser knows, plus UTC, the saved zone and the
+ * browser's own zone, so the current value is always selectable even when the list lacks it.
+ */
+export function digestTimeZoneOptions(
+	supported: ReadonlyArray<string>,
+	saved: string,
+	browserZone: string | undefined,
+): ReadonlyArray<string> {
+	const zones = new Set([...supported, "UTC", saved])
+	if (browserZone) zones.add(browserZone)
+	return [...zones].sort((a, b) => (a === "UTC" ? -1 : b === "UTC" ? 1 : a.localeCompare(b)))
+}