Merge branch 'master' into SDK-100-compose-support

Author: joaodordio

CHANGELOG.md

@@ -4,9 +4,17 @@ This project adheres to [Semantic Versioning](http://semver.org/).
 
 ## [Unreleased]
 ### Fixed
+- Fixed `IterableEmbeddedView` card layout rendering issues: image now displays at a 16:9 aspect ratio instead of collapsing to zero height, card container no longer expands to fill the parent, missing end margin on the card is now applied, bottom spacing on buttons is no longer cut off, and the image properly clips to the card's rounded corners.
 - Fixed `ConcurrentModificationException` crash during device token registration caused by concurrent access to `deviceAttributes`.
 - Fixed possible `NoSuchMethodException` crash on Android 5-10 caused by using `Map.of()` which is unavailable on those versions
 
+### Added
+- Added `imageScaleType` to `IterableEmbeddedViewConfig` to allow configuring how the image is scaled within the 16:9 container for embedded message views.
+- Added default values to all `IterableEmbeddedViewConfig` constructor parameters for easier configuration.
+
+### Removed
+- Removed insecure `AES/CBC/PKCS5Padding` encryption from `IterableDataEncryptor`. The SDK now exclusively uses `AES/GCM/NoPadding`. The legacy CBC algorithm was only used on Android versions below KitKat (API 19), which have been unsupported since `minSdkVersion` was raised to 21.
+
 ## [3.7.0]
 - Replaced the deprecated `AsyncTask`-based push notification handling with `WorkManager` for improved reliability and compatibility with modern Android versions. No action is required.
 - Fixed lost event tracking and missed API calls with an auto-retry feature for JWT token failures.

CLAUDE.md

@@ -0,0 +1,7 @@
+# Iterable Android SDK
+
+This is the source repository for the Iterable Android SDK.
+
+For quick facts, available guides, project structure, and official documentation links, see [`llms.txt`](llms.txt) at the repo root.
+
+If you are integrating the Iterable Android SDK into an app, **read `docs/ai/integration-guide.md` before writing any code**. It contains step-by-step instructions, critical gotchas, and traps that will save hours of debugging.