Refine live control and show overview

src/lib/calendar.spec.ts

@@ -0,0 +1,31 @@
+import { describe, expect, it } from 'vitest';
+import {
+	berlinDateKey,
+	buildCalendarDays,
+	formatMonthLabel,
+	normalizeMonthKey,
+	shiftMonth
+} from './calendar.js';
+
+describe('show calendar', () => {
+	it('groups UTC instants by their Berlin civil date', () => {
+		expect(berlinDateKey('2026-09-30T22:30:00.000Z')).toBe('2026-10-01');
+		expect(berlinDateKey('2026-12-31T23:30:00.000Z')).toBe('2027-01-01');
+	});
+
+	it('builds a Monday-first six-week month without dropping boundary days', () => {
+		const days = buildCalendarDays('2026-10', '2026-10-24');
+		expect(days).toHaveLength(42);
+		expect(days[0]).toMatchObject({ date: '2026-09-28', inSelectedMonth: false });
+		expect(days.find((day) => day.date === '2026-10-24')?.isToday).toBe(true);
+		expect(days.at(-1)?.date).toBe('2026-11-08');
+	});
+
+	it('moves across year boundaries and validates month keys', () => {
+		expect(shiftMonth('2026-12', 1)).toBe('2027-01');
+		expect(shiftMonth('2026-01', -1)).toBe('2025-12');
+		expect(normalizeMonthKey('2026-13', '2026-10')).toBe('2026-10');
+		expect(normalizeMonthKey('2026-02', '2026-10')).toBe('2026-02');
+		expect(formatMonthLabel('2026-10')).toBe('Oktober 2026');
+	});
+});

src/lib/calendar.ts

@@ -0,0 +1,75 @@
+export const BERLIN_TIME_ZONE = 'Europe/Berlin';
+
+export type CalendarDay = {
+	date: string;
+	dayNumber: number;
+	inSelectedMonth: boolean;
+	isToday: boolean;
+};
+
+const berlinDateFormatter = new Intl.DateTimeFormat('en-CA', {
+	timeZone: BERLIN_TIME_ZONE,
+	year: 'numeric',
+	month: '2-digit',
+	day: '2-digit'
+});
+
+function padded(value: number) {
+	return String(value).padStart(2, '0');
+}
+
+function dateParts(value: string | Date) {
+	const parts = berlinDateFormatter.formatToParts(
+		typeof value === 'string' ? new Date(value) : value
+	);
+	const read = (type: Intl.DateTimeFormatPartTypes) =>
+		Number(parts.find((part) => part.type === type)?.value);
+	return { year: read('year'), month: read('month'), day: read('day') };
+}
+
+export function berlinDateKey(value: string | Date) {
+	const parts = dateParts(value);
+	return `${parts.year}-${padded(parts.month)}-${padded(parts.day)}`;
+}
+
+export function berlinMonthKey(value: string | Date) {
+	return berlinDateKey(value).slice(0, 7);
+}
+
+export function normalizeMonthKey(value: string | null | undefined, fallback: string) {
+	if (!value || !/^\d{4}-(0[1-9]|1[0-2])$/.test(value)) return fallback;
+	return value;
+}
+
+export function shiftMonth(monthKey: string, delta: number) {
+	const [year, month] = monthKey.split('-').map(Number);
+	const shifted = new Date(Date.UTC(year, month - 1 + delta, 1));
+	return `${shifted.getUTCFullYear()}-${padded(shifted.getUTCMonth() + 1)}`;
+}
+
+export function formatMonthLabel(monthKey: string) {
+	const [year, month] = monthKey.split('-').map(Number);
+	return new Intl.DateTimeFormat('de-DE', {
+		timeZone: 'UTC',
+		month: 'long',
+		year: 'numeric'
+	}).format(new Date(Date.UTC(year, month - 1, 1)));
+}
+
+export function buildCalendarDays(monthKey: string, todayKey: string): CalendarDay[] {
+	const [year, month] = monthKey.split('-').map(Number);
+	const first = new Date(Date.UTC(year, month - 1, 1));
+	const mondayOffset = (first.getUTCDay() + 6) % 7;
+	const start = new Date(Date.UTC(year, month - 1, 1 - mondayOffset));
+	return Array.from({ length: 42 }, (_, index) => {
+		const date = new Date(start);
+		date.setUTCDate(start.getUTCDate() + index);
+		const dateKey = `${date.getUTCFullYear()}-${padded(date.getUTCMonth() + 1)}-${padded(date.getUTCDate())}`;
+		return {
+			date: dateKey,
+			dayNumber: date.getUTCDate(),
+			inSelectedMonth: dateKey.startsWith(monthKey),
+			isToday: dateKey === todayKey
+		};
+	});
+}

src/lib/server/auth.spec.ts

@@ -70,6 +70,21 @@ afterEach(async () => {
 });
 
 describe('authentication', () => {
+	it('stores the show overview preference per user', async () => {
+		const { createFirstAdmin, getShowOverviewView, setShowOverviewView } =
+			await import('./auth.js');
+		const user = await createFirstAdmin({
+			setupToken: 'a'.repeat(32),
+			email: 'calendar@example.test',
+			displayName: 'Kalender Test',
+			password: 'a-valid-password-123'
+		});
+		expect(getShowOverviewView(user.id)).toBe('list');
+		expect(setShowOverviewView(user.id, 'calendar')).toBe('calendar');
+		expect(getShowOverviewView(user.id)).toBe('calendar');
+		expect(() => setShowOverviewView(user.id, 'invalid')).toThrow('INVALID_VIEW');
+	});
+
 	it('creates the first Barkeeper once and stores no plaintext secret', async () => {
 		const { createFirstAdmin } = await import('./auth.js');
 		const password = 'Ein-sehr-langes-Testpasswort';

src/lib/server/auth.ts

@@ -26,6 +26,7 @@ const PASSWORD_OPTIONS = {
 } as const;
 
 export type Role = 'barkeeper' | 'thekencrew';
+export type ShowOverviewView = 'list' | 'calendar';
 export type AuthUser = {
 	id: string;
 	email: string;
@@ -66,6 +67,23 @@ export function normalizeEmail(email: string): string {
 	return email.trim().toLowerCase();
 }
 
+export function getShowOverviewView(userId: string): ShowOverviewView {
+	const row = getDatabase()
+		.prepare('SELECT show_overview_view FROM users WHERE id = ?')
+		.get(userId) as { show_overview_view: ShowOverviewView } | undefined;
+	if (!row) throw new Error('NOT_FOUND');
+	return row.show_overview_view;
+}
+
+export function setShowOverviewView(userId: string, view: string): ShowOverviewView {
+	if (view !== 'list' && view !== 'calendar') throw new Error('INVALID_VIEW');
+	const result = getDatabase()
+		.prepare('UPDATE users SET show_overview_view = ?, updated_at_utc = ? WHERE id = ?')
+		.run(view, nowUtc(), userId);
+	if (!result.changes) throw new Error('NOT_FOUND');
+	return view;
+}
+
 export function validEmail(email: string): boolean {
 	return email.length <= 254 && /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(email);
 }

src/lib/server/database.spec.ts

@@ -62,7 +62,7 @@ describe('database setup', () => {
 		database.close();
 
 		expect(counts).toEqual({
-			migrations: 11,
+			migrations: 12,
 			pieces: 6,
 			shows: 2,
 			usages: 5,