WidgetConfig Schema

type InjectableWidgetConfig =
  Omit<WidgetConfig, "branding" | "status" | "security"> & {
    security?: InjectableWidgetSecurity;
  };

type WidgetTab = "home" | "messages" | "help" | "news" | "profile";
type WidgetLocaleStrategy = "AUTO" | "WEBSITE" | "DEFAULT";
type LauncherPosition = "RIGHT_BOTTOM" | "LEFT_BOTTOM";
type PrechatFieldKind = "NAME" | "EMAIL" | "PHONE" | "CUSTOM_TEXT";
type WidgetMessengerMessageKind = "HINT" | "SYSTEM" | "MESSAGE";

interface WidgetFeatures {
  home: boolean;
  messenger: boolean;
  help: boolean;
  news: boolean;
  profile?: boolean; // default true
}

interface WidgetTheme {
  light?: WidgetThemePalette;
  dark?: WidgetThemePalette;
  radii?: { sm?: number; md?: number; lg?: number; xl?: number };
  launcherPosition?: LauncherPosition;
  launcherOffset?: { x: number; y: number }; // px from the corner, each axis 0-200
  fontFamily?: string;
  homeBackdropGlow?: boolean; // default true, the radial glow behind the Home header
}

interface WidgetSecurity {
  requireAuth: boolean;
  google: { enabled: boolean; clientId: string | null };
  passkey: { enabled: boolean };
}

interface WidgetPrechatForm {
  enabled: boolean;
  fields: {
    kind: PrechatFieldKind;   // NAME | EMAIL | PHONE | CUSTOM_TEXT
    key: string;              // /^[a-z0-9_]{1,32}$/
    label: string;            // empty → localized default
    required: boolean;
  }[];
}

interface WidgetMessengerConfig {
  title: string | null;            // ≤120, null → localized default
  description: string | null;      // ≤500, null → localized default
  aiAssistantAvatar: string | null;
  aiAssistant?: { enabled: boolean; name: string | null; avatar: string | null };
  commands: string[];              // ≤20, each /^\/[a-zA-Z0-9_-]{1,32}$/
  messages: { kind: "HINT" | "SYSTEM" | "MESSAGE"; text: string }[];  // ≤10
  messageSlots?: MessageSlot[];    // read instead of messages when contentVersion >= 1
  showRelatedNews: boolean;
  showRelatedHelpArticles: boolean;
  showReactionCounts: boolean;
}

interface WidgetSounds {
  enabled: boolean;
  inboundSoundId: string | null;   // preset id or full URL
  outboundSoundId: string | null;
  volume: number;                  // 0.0 … 1.0
}

interface WidgetBotProtection {
  turnstile: { enabled: boolean; siteKey: string | null };
}

interface WidgetTracking {
  trackWidgetLinks: boolean;   // links the visitor opens inside the widget
  trackWebsitePages: boolean;  // pages the visitor views on your site
}

interface ContentRule {
  visitors?: "ALL" | "ANONYMOUS" | "SIGNED_IN";
  origins?: string[];
  paths?: { match: "CONTAINS" | "STARTS_WITH" | "EQUALS"; value: string }[];
}
interface MessageSlot { id: string; kind: "HINT" | "SYSTEM" | "MESSAGE"; variants: MessageVariant[]; reappearAfterDays?: number | null }
interface MessageVariant { id: string; when?: ContentRule; text: string; buttons: { id: string; label: string }[] }
interface HomeSlot { id: string; kind: string; variants: { id: string; when?: ContentRule; block: HomeBlock }[] }
interface GreetingSlot { id: string; variants: { id: string; when?: ContentRule; headline: string; subheadline: string }[] }

type HomeBlock =
  | { kind: "quick-actions";    buttons: HomeQuickActionButton[]; layout?: "stacked" | "inline" }
  | { kind: "help-search";      placeholder?: string; suggestions: HomeHelpSuggestionsConfig }
  | { kind: "pinned-articles";  articleIds: string[]; title?: string }
  | { kind: "news-preview";     maxItems?: number; title?: string }
  | { kind: "team-status";      showResponseTime: boolean; showOperatorAvatars: boolean } // presence, reply time and next opening come from the backend
  | { kind: "divider" }
  | { kind: "rich-text";        markdown: string }
  | { kind: "ask-question";     title?: string; subtitle?: string; action?: "open-messenger" | "open-help" | "open-news" }  // default open-messenger
  | { kind: "recent-message";   title?: string }
  | { kind: "featured-article"; newsId?: string; ctaLabel?: string };

interface HomeQuickActionButton {
  label?: string;                  // ≥1 of label/icon required
  icon?: { kind: "named"; name: string; colored?: boolean }  // curated list of channel logos and action icons | { kind: "media"; url: string };
  action: "open-messenger" | "open-help" | "open-news" | "open-url";
  url?: string;                    // required for "open-url"
  style?: "default" | "primary" | "ghost";  // max 1 "primary" per block
}

interface HomeHelpSuggestionsConfig {
  mode: "popular" | "recent" | "category" | "manual";
  maxItems: number;                // 3–8
  categoryId?: string;             // required for "category"
  articleIds?: string[];           // required for "manual"
}