Files
SRCmail/stores/theme-store.ts
T
Linus Rath 76b21147e4 feat: add plugin/theme harness and admin dashboard
Plugin & Theme System:
- Add plugin type definitions, permissions (30+), and validation constants
- Add IndexedDB storage layer for plugin code, theme CSS, and previews
- Add theme CSS sanitization, injection, and safety validation
- Add HookBus event system with 130+ hooks across 20 domains
- Add plugin ZIP extraction and manifest validation with JS security checks
- Add sandboxed PluginAPI factory with scoped storage, logging, and permission gating
- Add plugin loader with blob URL dynamic import and auto-disable circuit breaker
- Add 3 built-in themes (Nord, Catppuccin, Solarized)
- Add Zustand plugin store with install/uninstall/enable/disable lifecycle
- Add PluginSlot, PluginSlotRenderer, and PluginErrorBoundary components
- Add plugins and themes settings UI panels
- Integrate plugin slots into email viewer, composer, navigation rail, sidebar, and context menu
- Extend theme store with custom theme installation and activation

Admin Dashboard:
- Add admin authentication with scrypt password hashing and AES-256-GCM sessions
- Add rate-limited login (5 attempts/15min per IP)
- Add config manager with admin override > env var > default priority
- Add settings policy system with feature gates and per-setting restrictions
- Add audit logging with rotation
- Add admin API routes (login, logout, config, policy, audit, password change)
- Add admin UI pages (login, dashboard, config, policy, audit)
- Add policy store for client-side feature gate enforcement
- Wire admin password initialization into server instrumentation

Tests:
- Add 139 tests across 10 test files covering all plugin/theme modules
2026-03-25 00:44:03 +01:00

274 lines
9.1 KiB
TypeScript

import { create } from 'zustand';
import { persist } from 'zustand/middleware';
import type { InstalledTheme, ThemeVariant } from '@/lib/plugin-types';
import { pluginStorage } from '@/lib/plugin-storage';
import { injectThemeCSS, removeThemeCSS, sanitizeThemeCSS } from '@/lib/theme-loader';
import { extractTheme } from '@/lib/plugin-validator';
import { BUILTIN_THEMES } from '@/lib/builtin-themes';
type Theme = 'light' | 'dark' | 'system';
interface ThemeState {
theme: Theme;
resolvedTheme: 'light' | 'dark';
hydrated: boolean;
// Custom theme system
installedThemes: InstalledTheme[];
activeThemeId: string | null; // null = built-in default
setTheme: (theme: Theme) => void;
toggleTheme: () => void;
initializeTheme: () => void;
// Custom theme management
installTheme: (file: File) => Promise<{ success: boolean; error?: string; warnings?: string[] }>;
uninstallTheme: (id: string) => void;
activateTheme: (id: string | null) => void;
}
const getSystemTheme = (): 'light' | 'dark' => {
if (typeof window === 'undefined') return 'light';
return window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light';
};
const applyTheme = (theme: 'light' | 'dark') => {
if (typeof document === 'undefined') return;
const root = document.documentElement;
if (theme === 'dark') {
root.classList.remove('light');
root.classList.add('dark');
} else {
root.classList.remove('dark');
root.classList.add('light');
}
// Also update color-scheme for native elements (scrollbars, form controls)
root.style.colorScheme = theme;
localStorage.setItem('theme-applied', theme);
};
let mediaQueryCleanup: (() => void) | null = null;
export const useThemeStore = create<ThemeState>()(
persist(
(set, get) => ({
theme: 'system',
resolvedTheme: 'light',
hydrated: false,
installedThemes: [...BUILTIN_THEMES],
activeThemeId: null,
setTheme: (theme) => {
const resolvedTheme = theme === 'system' ? getSystemTheme() : theme;
applyTheme(resolvedTheme);
set({ theme, resolvedTheme });
// Re-apply active custom theme for new mode
const { activeThemeId, installedThemes } = get();
if (activeThemeId) {
const t = installedThemes.find(t => t.id === activeThemeId);
if (t) applyCustomThemeCSS(t, resolvedTheme);
}
},
toggleTheme: () => {
const { theme } = get();
const nextTheme: Theme =
theme === 'light' ? 'dark' :
theme === 'dark' ? 'system' : 'light';
get().setTheme(nextTheme);
},
initializeTheme: () => {
const { theme, activeThemeId, installedThemes } = get();
const resolvedTheme = theme === 'system' ? getSystemTheme() : theme;
applyTheme(resolvedTheme);
set({ resolvedTheme, hydrated: true });
// Apply active custom theme on boot
if (activeThemeId) {
const t = installedThemes.find(t => t.id === activeThemeId);
if (t) {
// Load CSS from IndexedDB (may have been stripped from localStorage)
if (t.css) {
applyCustomThemeCSS(t, resolvedTheme);
} else {
pluginStorage.getThemeCSS(activeThemeId).then(css => {
if (css) {
injectThemeCSS(css);
// Update the in-memory cache
set({
installedThemes: installedThemes.map(
it => it.id === activeThemeId ? { ...it, css } : it
),
});
}
});
}
}
}
// Clean up previous listener if any
if (mediaQueryCleanup) {
mediaQueryCleanup();
mediaQueryCleanup = null;
}
if (typeof window !== 'undefined') {
const mediaQuery = window.matchMedia('(prefers-color-scheme: dark)');
const handleChange = () => {
const { theme, activeThemeId, installedThemes } = get();
if (theme === 'system') {
const newResolvedTheme = getSystemTheme();
applyTheme(newResolvedTheme);
set({ resolvedTheme: newResolvedTheme });
if (activeThemeId) {
const t = installedThemes.find(t => t.id === activeThemeId);
if (t) applyCustomThemeCSS(t, newResolvedTheme);
}
}
};
mediaQuery.addEventListener('change', handleChange);
mediaQueryCleanup = () => mediaQuery.removeEventListener('change', handleChange);
}
},
installTheme: async (file: File) => {
const result = await extractTheme(file);
if (!result.valid || !result.manifest) {
return { success: false, error: result.errors.join('; '), warnings: result.warnings };
}
const { manifest, css, preview } = result;
const { installedThemes } = get();
// Check for duplicate
if (installedThemes.some(t => t.id === manifest.id)) {
// Update existing
const sanitized = sanitizeThemeCSS(css);
const theme: InstalledTheme = {
id: manifest.id,
name: manifest.name,
version: manifest.version,
author: manifest.author,
description: manifest.description || '',
preview: preview || undefined,
css: sanitized.css,
variants: manifest.variants,
enabled: true,
builtIn: false,
};
await pluginStorage.saveThemeCSS(manifest.id, sanitized.css);
if (preview) await pluginStorage.savePreview(manifest.id, preview);
set({
installedThemes: installedThemes.map(t =>
t.id === manifest.id ? theme : t
),
});
return { success: true, warnings: [...result.warnings, ...sanitized.warnings] };
}
// Install new
const sanitized = sanitizeThemeCSS(css);
const theme: InstalledTheme = {
id: manifest.id,
name: manifest.name,
version: manifest.version,
author: manifest.author,
description: manifest.description || '',
preview: preview || undefined,
css: sanitized.css,
variants: manifest.variants,
enabled: true,
builtIn: false,
};
await pluginStorage.saveThemeCSS(manifest.id, sanitized.css);
if (preview) await pluginStorage.savePreview(manifest.id, preview);
set({ installedThemes: [...installedThemes, theme] });
return { success: true, warnings: [...result.warnings, ...sanitized.warnings] };
},
uninstallTheme: (id: string) => {
const { installedThemes, activeThemeId } = get();
const theme = installedThemes.find(t => t.id === id);
if (!theme || theme.builtIn) return;
// Deactivate if active
if (activeThemeId === id) {
removeThemeCSS();
set({ activeThemeId: null });
}
// Clean up storage
pluginStorage.deleteThemeCSS(id);
pluginStorage.deletePreview(id);
set({
installedThemes: installedThemes.filter(t => t.id !== id),
});
},
activateTheme: (id: string | null) => {
if (id === null) {
removeThemeCSS();
set({ activeThemeId: null });
return;
}
const { installedThemes, resolvedTheme } = get();
const theme = installedThemes.find(t => t.id === id);
if (!theme) return;
applyCustomThemeCSS(theme, resolvedTheme);
set({ activeThemeId: id });
},
}),
{
name: 'theme-storage',
partialize: (state) => ({
theme: state.theme,
activeThemeId: state.activeThemeId,
// Store theme metadata but NOT full CSS (that goes in IndexedDB)
installedThemes: state.installedThemes.map(t => ({
...t,
css: t.builtIn ? t.css : '', // only keep CSS for built-in themes
preview: undefined, // previews also in IndexedDB
})),
}),
onRehydrateStorage: () => {
return (state) => {
if (state) {
// Ensure built-in themes are always present after rehydration
const builtInIds = new Set(BUILTIN_THEMES.map(t => t.id));
const userThemes = state.installedThemes.filter(t => !builtInIds.has(t.id));
state.installedThemes = [...BUILTIN_THEMES, ...userThemes];
// Re-apply theme immediately after rehydration
const resolvedTheme = state.theme === 'system' ? getSystemTheme() : state.theme;
applyTheme(resolvedTheme);
state.resolvedTheme = resolvedTheme;
state.hydrated = true;
}
};
},
}
)
);
/** Apply a custom theme's CSS, filtering to the appropriate variant */
function applyCustomThemeCSS(theme: InstalledTheme, resolvedTheme: 'light' | 'dark'): void {
// If theme only supports one variant and current mode doesn't match, skip
if (!theme.variants.includes(resolvedTheme as ThemeVariant)) {
removeThemeCSS();
return;
}
injectThemeCSS(theme.css);
}