fixes

Author: franco-zalamena-iterable

docs/ai/embedded-messaging.md

@@ -101,7 +101,7 @@ yourContainer.addView(embeddedView)
 
 **Custom styling:**
 
-> **Agent note:** `IterableEmbeddedViewConfig` is a data class with NO default values on its parameters. You must provide ALL 10 fields — use `null` for any you don't want to customize.
+> **Agent note:** `IterableEmbeddedViewConfig` is a data class where every parameter has a default (`null` for colors/borders, `CENTER_CROP` for `imageScaleType`). Use named arguments and only specify the fields you want to override — omitted fields keep their defaults. The class is annotated `@JvmOverloads` so Java callers can also omit trailing fields.
 
 ```kotlin
 val config = IterableEmbeddedViewConfig(
@@ -110,14 +110,13 @@ val config = IterableEmbeddedViewConfig(
     borderWidth = 1,
     borderCornerRadius = 8f,
     primaryBtnBackgroundColor = Color.BLUE,
-    primaryBtnTextColor = Color.WHITE,
-    secondaryBtnBackgroundColor = null,
-    secondaryBtnTextColor = null,
-    titleTextColor = null,
-    bodyTextColor = null
+    primaryBtnTextColor = Color.WHITE
+    // Other fields (secondary button colors, title/body text colors, imageScaleType) keep their defaults
 )
 ```
 
+Available fields: `backgroundColor`, `borderColor`, `borderWidth`, `borderCornerRadius`, `primaryBtnBackgroundColor`, `primaryBtnTextColor`, `secondaryBtnBackgroundColor`, `secondaryBtnTextColor`, `titleTextColor`, `bodyTextColor`, `imageScaleType` (applies to `CARD` and `BANNER` views).
+
 > **Agent note:** OOTB views handle both `handleEmbeddedClick` (navigation) and `trackEmbeddedClick` (analytics) automatically on button and default action taps.
 
 ---

docs/ai/integration-guide.md

@@ -173,7 +173,7 @@ class YourApplication : Application() {
             .setCustomActionHandler(AppCustomActionHandler())    // See deep-linking.md (only if using custom actions)
             .setUrlHandler(AppUrlHandler(this))                  // See deep-linking.md
             .setAllowedProtocols(arrayOf("yourscheme"))          // 🟠 Only if using custom deep link schemes
-            .setAuthHandler(AppAuthHandler { generateJwtForEmail(getFreshEmail()) })  // 🔴 Only if JWT required — see jwt-authentication.md
+            .setAuthHandler(AppAuthHandler { generateJwtForEmail(getFreshEmail()) })  // 🔴 JWT only — getFreshEmail() MUST read from source of truth on every call, never a cached var (see Trap #3 / jwt-authentication.md)
             .setEnableEmbeddedMessaging(true)                    // 🟠 Only if using embedded messages
             .build()