@simula/ads 1.1.0 → 1.2.0

package/dist/index.mjs

@@ -50,14 +50,19 @@ const fetchAd = async (request) => {
     try {
         const conversationHistory = request.messages;
         // Normalize theme accent and font to arrays for backend
-        const normalizedTheme = request.theme ? {
-            ...request.theme,
-            accent: request.theme.accent ? (Array.isArray(request.theme.accent) ? request.theme.accent : [request.theme.accent]) : undefined,
-            font: request.theme.font ? (Array.isArray(request.theme.font) ? request.theme.font : [request.theme.font]) : undefined,
-        } : undefined;
+        // Also handle backward compatibility: prefer 'mode' over 'theme', but support both
+        const normalizedTheme = request.theme ? (() => {
+            var _a;
+            const { theme: themeDeprecated, ...themeRest } = request.theme;
+            return {
+                ...themeRest,
+                mode: (_a = request.theme.mode) !== null && _a !== void 0 ? _a : themeDeprecated, // Prefer 'mode', fallback to 'theme' for backward compatibility
+                accent: request.theme.accent ? (Array.isArray(request.theme.accent) ? request.theme.accent : [request.theme.accent]) : undefined,
+                font: request.theme.font ? (Array.isArray(request.theme.font) ? request.theme.font : [request.theme.font]) : undefined,
+            };
+        })() : undefined;
         const requestBody = {
             messages: conversationHistory,
-            types: request.formats,
             slot_id: request.slotId,
             theme: normalizedTheme,
             session_id: request.sessionId,
@@ -210,10 +215,6 @@ const validateInChatAdSlotProps = (props) => {
             throw new Error(`Invalid message at index ${i}: "content" must be a string`);
         }
     });
-    // Validate formats (optional)
-    if (props.formats !== undefined) {
-        validateFormats(props.formats);
-    }
     // Validate theme (optional)
     if (props.theme !== undefined) {
         validateTheme(props.theme);
@@ -244,50 +245,33 @@ const validateInChatAdSlotProps = (props) => {
     // Note: trigger validation (Promise check) is skipped because checking instanceof Promise
     // is unreliable across different Promise implementations and contexts
 };
-/**
- * Validates formats - accepts string or string[]
- * Throws descriptive errors for invalid formats
- */
-const validateFormats = (formats) => {
-    if (!formats)
-        return;
-    const validFormatOptions = ['all', 'tips', 'interactive', 'suggestions', 'text', 'highlight', 'visual_banner', 'image_feature'];
-    // Normalize to array for validation
-    const formatsArray = Array.isArray(formats) ? formats : [formats];
-    formatsArray.forEach((format, i) => {
-        if (typeof format !== 'string') {
-            throw new Error(`Invalid format type at index ${i}: "${typeof format}". Must be a string. Valid values: ${validFormatOptions.join(', ')}`);
-        }
-        if (!validFormatOptions.includes(format)) {
-            throw new Error(`Invalid format value${Array.isArray(formats) ? ` at index ${i}` : ''}: "${format}". Valid values: ${validFormatOptions.join(', ')}`);
-        }
-    });
-};
 /**
  * Validates theme object
  * Throws descriptive errors for invalid theme properties
  */
 const validateTheme = (theme) => {
+    var _a;
     if (!theme || typeof theme !== 'object') {
         throw new Error('Invalid "theme": must be an object');
     }
-    const validThemeOptions = ['light', 'dark', 'auto'];
+    const validModeOptions = ['light', 'dark', 'auto'];
     const validAccentOptions = ['blue', 'red', 'green', 'yellow', 'purple', 'pink', 'orange', 'neutral', 'gray', 'tan', 'transparent', 'image'];
     const validFontOptions = ['san-serif', 'serif', 'monospace'];
-    const validKeys = ['theme', 'accent', 'font', 'width', 'cornerRadius'];
+    const validKeys = ['mode', 'theme', 'accent', 'font', 'width', 'cornerRadius']; // 'theme' kept for backward compatibility
     // Check for invalid top-level keys
     Object.keys(theme).forEach(key => {
         if (!validKeys.includes(key)) {
             throw new Error(`Invalid theme parameter "${key}". Valid parameters: ${validKeys.join(', ')}`);
         }
     });
-    // Validate theme value
-    if (theme.theme !== undefined) {
-        if (typeof theme.theme !== 'string') {
-            throw new Error(`Invalid theme type "${typeof theme.theme}". Must be a string. Valid values: ${validThemeOptions.join(', ')}`);
+    // Validate mode value (prefer 'mode' over 'theme' for backward compatibility)
+    const modeValue = (_a = theme.mode) !== null && _a !== void 0 ? _a : theme.theme;
+    if (modeValue !== undefined) {
+        if (typeof modeValue !== 'string') {
+            throw new Error(`Invalid mode/theme type "${typeof modeValue}". Must be a string. Valid values: ${validModeOptions.join(', ')}`);
         }
-        if (!validThemeOptions.includes(theme.theme)) {
-            throw new Error(`Invalid theme value "${theme.theme}". Valid values: ${validThemeOptions.join(', ')}`);
+        if (!validModeOptions.includes(modeValue)) {
+            throw new Error(`Invalid mode/theme value "${modeValue}". Valid values: ${validModeOptions.join(', ')}`);
         }
     }
     // Validate accent value(s)
@@ -1587,7 +1571,10 @@ const getFontStyles = (font = 'san-serif') => {
 };
 
 const createInChatAdSlotCSS = (theme = {}) => {
-    const { theme: themeMode = 'light', accent = 'blue', font = 'san-serif', width = 'auto', } = theme;
+    var _a, _b;
+    // Backward compatibility: prefer 'mode' over 'theme', but support both
+    const themeMode = (_b = (_a = theme.mode) !== null && _a !== void 0 ? _a : theme.theme) !== null && _b !== void 0 ? _b : 'light';
+    const { accent = 'blue', font = 'san-serif', width = 'auto', } = theme;
     // If accent or font is an array, use the first value for styling
     Array.isArray(accent) ? accent[0] : accent;
     const effectiveFont = Array.isArray(font) ? font[0] : font;
@@ -1742,9 +1729,8 @@ const hasValidMessages = (messages) => {
 const InChatAdSlot = (props) => {
     // Validate props early
     validateInChatAdSlotProps(props);
-    const { messages, trigger, formats: formatsRaw = ['all'], theme = {}, debounceMs = 0, charDesc, onImpression, onClick, onError, } = props;
-    // Normalize formats to array (similar to theme.accent and theme.font)
-    const formats = Array.isArray(formatsRaw) ? formatsRaw : [formatsRaw];
+    const { messages, trigger, formats, // Deprecated: ignored for backward compatibility
+    theme = {}, debounceMs = 0, charDesc, onImpression, onClick, onError, } = props;
     const { apiKey, sessionId } = useSimula();
     // Generate a stable slotId for this component instance
     const slotId = useMemo(() => `slot-${v4()}`, []);
@@ -1876,7 +1862,6 @@ const InChatAdSlot = (props) => {
             }
             const result = await fetchAd({
                 messages,
-                formats,
                 apiKey,
                 slotId,
                 theme: themeForBackend,
@@ -1907,7 +1892,7 @@ const InChatAdSlot = (props) => {
         finally {
             setLoading(false);
         }
-    }, [hasBeenViewed, loading, hasTriggered, error, messages, formats, apiKey, slotId, theme, onError, isBot, reasons, sessionId, measuredWidth]);
+    }, [hasBeenViewed, loading, hasTriggered, error, messages, apiKey, slotId, theme, onError, isBot, reasons, sessionId, measuredWidth]);
     useDebounce(() => {
         if (shouldFetch) {
             fetchAdData();