feat(dashboard): tenant self-service branding editor

clients/dashboard/src/api/tenants.ts

@@ -0,0 +1,101 @@
+import { apiFetch } from "@/lib/api-client";
+
+// ─────────────────────────────────────────────────────────────────────────
+// Tenant theme / branding
+//
+// The theme endpoints are CURRENT-TENANT scoped server-side — they read the
+// request's tenant (resolved from the caller's token) and act on that row.
+// Unlike the admin app, the dashboard never targets a *different* tenant, so
+// we send NO `tenant:` header: every call operates on the signed-in tenant.
+//
+// Types mirror clients/admin/src/api/tenants.ts (the two Vite apps duplicate
+// by design — no cross-app imports). Keep the shapes in sync if the server
+// DTO changes. Typography + layout exist on the server DTO but the editor
+// omits them (parity with the admin card's v1 scope).
+// ─────────────────────────────────────────────────────────────────────────
+
+export type PaletteDto = {
+  primary: string;
+  secondary: string;
+  tertiary: string;
+  background: string;
+  surface: string;
+  error: string;
+  warning: string;
+  success: string;
+  info: string;
+};
+
+export type BrandAssetsDto = {
+  logoUrl?: string | null;
+  logoDarkUrl?: string | null;
+  faviconUrl?: string | null;
+  deleteLogo?: boolean;
+  deleteLogoDark?: boolean;
+  deleteFavicon?: boolean;
+};
+
+export type TypographyDto = {
+  fontFamily: string;
+  headingFontFamily: string;
+  fontSizeBase: number;
+  lineHeightBase: number;
+};
+
+export type LayoutDto = {
+  borderRadius: string;
+  defaultElevation: number;
+};
+
+export type TenantThemeDto = {
+  lightPalette: PaletteDto;
+  darkPalette: PaletteDto;
+  brandAssets: BrandAssetsDto;
+  typography: TypographyDto;
+  layout: LayoutDto;
+  isDefault: boolean;
+};
+
+export const DEFAULT_LIGHT_PALETTE: PaletteDto = {
+  primary: "#2563EB",
+  secondary: "#0F172A",
+  tertiary: "#6366F1",
+  background: "#F8FAFC",
+  surface: "#FFFFFF",
+  error: "#DC2626",
+  warning: "#F59E0B",
+  success: "#16A34A",
+  info: "#0284C7",
+};
+
+export const DEFAULT_DARK_PALETTE: PaletteDto = {
+  primary: "#38BDF8",
+  secondary: "#94A3B8",
+  tertiary: "#818CF8",
+  background: "#0B1220",
+  surface: "#111827",
+  error: "#F87171",
+  warning: "#FBBF24",
+  success: "#22C55E",
+  info: "#38BDF8",
+};
+
+/** Fetch the current tenant's theme. Caller needs Tenants.ViewTheme (IsBasic). */
+export async function getTenantTheme(): Promise<TenantThemeDto> {
+  return apiFetch<TenantThemeDto>(`/api/v1/tenants/theme`);
+}
+
+/** Save the current tenant's theme. Caller needs Tenants.UpdateTheme. */
+export async function updateTenantTheme(theme: TenantThemeDto): Promise<void> {
+  await apiFetch<void>(`/api/v1/tenants/theme`, {
+    method: "PUT",
+    body: JSON.stringify(theme),
+  });
+}
+
+/** Reset the current tenant's theme to framework defaults. Needs Tenants.UpdateTheme. */
+export async function resetTenantTheme(): Promise<void> {
+  await apiFetch<void>(`/api/v1/tenants/theme/reset`, {
+    method: "POST",
+  });
+}