react-native-attachment-kit 1.0.6 → 1.0.9

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 1.0.8 — 2026-10-16
+
+- **AI screens are the same in every app (iOS + Android)**. Generate: woman / man, country, age (up to the 80s), style, situation, aspect ratio + Create, sample chips and the chat input; chat text is sent together with the chosen settings, and tapping a sample shows a summary of the settings before creating. The glamour situations / samples and the detail options were removed from the generate screen. Edit: the full editing screen everywhere. Generated and edited images are stored for the gallery's "AI 이미지" tab in every app.
+- iOS: the "AI 이미지" tab expands / collapses the sheet like the gallery grid.
+- iOS: an edited (trimmed) video's first poster (`onProcessingStart` `thumbnailUri`) is taken from the trimmed start, with crop and drawing applied.
+- iOS: closing the AI screen right after using a menu no longer leaves a stray button over the gallery.
+- Android image viewer: video controls no longer flash on photo pages while the viewer opens.
+
 ## 1.0.6 — 2026-10-14
 
 - **Video in the picker, editor and viewer (iOS + Android)**: `openGallery({ mediaType: "all" | "video", video })` picks videos; the editor gets video pages (trim, mute, quality, crop, drawing/stickers/text, pre-encoding); `openViewer({ images, videos })` plays videos (progress pill, mute/options, remote video cache, pinch zoom). Sending progress is reported as events. `video.posterFormat` (`"webp"` default / `"jpg"`). Video limits are checked before sending.

package/README.md

@@ -98,7 +98,7 @@ Enable on the key: **Maps SDK for Android**, and **Places API (New)** for place
 import AttachmentKit from 'react-native-attachment-kit'
 
 // Once at app start
-await AttachmentKit.init('YOUR_LICENSE_KEY', {   // '' = evaluation (editor watermark)
+await AttachmentKit.init('YOUR_LICENSE_KEY', {   // '' = evaluation: photos only (editor watermark; no location / video / AI)
   languageCode: 'ko',      // any app language code; see Localization
   themeColor: '#10b981',
   appearance: 'system',    // 'system' | 'light' | 'dark'
@@ -147,6 +147,7 @@ Opens the gallery bottom sheet. Resolves with the picked images (`[]` when the u
 | `profileMode` | `boolean` | `false` | 1:1 (circle) crop for profile photos. |
 | `maxWidth` / `maxHeight` | `number` | `1024` | Output images are scaled down to fit. |
 | `outputFormat` | `'webp' \| 'jpg' \| 'png'` | `'webp'` | Output file format. (Not in the TS type yet — pass it with a cast.) |
+| `thumbnail` | `ThumbnailOptions` | — | Also make a small photo thumbnail for each photo — see [Photo thumbnails](#photo-thumbnails). Omitted: no photo thumbnail (same as before). |
 | `themeColor` / `languageCode` / `appearance` | | defaults | Per-call overrides. |
 | `doneButtonText` / `allItemsText` / `selectedItemsText` / `recentsAlbumText` | `string` | translated | Label overrides. |
 | `asyncProcessing` | `boolean` | `false` | Event-driven sending: each item is delivered through `onImageProcessed` as soon as it is ready (the Promise still resolves with everything at the end), and videos show no progress HUD — draw progress in your own UI. See [Sending progress](#sending-progress-events). |
@@ -172,6 +173,32 @@ Opens the gallery bottom sheet. Resolves with the picked images (`[]` when the u
 | `type` | `string` | MIME type. |
 | `caption?` | `string` | Caption typed in the editor. |
 | `fileName?` / `fileExtension?` / `fileSize?` | | Output file info (bytes). |
+| `thumbnailUri?` / `thumbnailWidth?` / `thumbnailHeight?` | | Photo: the thumbnail when the `thumbnail` option is set. Video: the poster (always, see `video.posterFormat`). |
+| `thumbnailFileSize?` | `number` | Photo thumbnail file size (bytes). |
+
+#### Photo thumbnails
+
+Pass `thumbnail` to `openGallery` (or `openEditor`) to get a small thumbnail next to each photo — e.g. to upload both the full image and a list-size image in one request.
+
+```ts
+// Profile avatar: exactly 200×200, center-cropped
+await AttachmentKit.openGallery({ maxWidth: 512, maxHeight: 512, thumbnail: { maxWidth: 200, mode: 'cover' } })
+// Moments list: keep the aspect ratio, longest side ≤ 360
+await AttachmentKit.openGallery({ maxSelection: 10, thumbnail: { maxWidth: 360 } })
+```
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `maxWidth` | `number` (px) | **required** | Box width. |
+| `maxHeight` | `number` (px) | `maxWidth` | Box height. |
+| `mode` | `'fit' \| 'cover'` | `'fit'` | `'fit'`: keep the aspect ratio inside the box. `'cover'`: fill the box and crop the center → exactly `maxWidth × maxHeight`. |
+| `quality` | `number` 0–1 | `0.8` | Encoding quality. |
+| `format` | `'webp' \| 'jpg'` | `'webp'` | Falls back to jpg if webp encoding fails (check the extension of `thumbnailUri`). |
+
+- Made from the same image as `uri` (orientation, crop, drawing and filter applied) — the original is not decoded again. No EXIF / GPS is written.
+- Never enlarged: a 100×80 photo gives 100×80 with `{ maxWidth: 360 }` and 80×80 with `{ maxWidth: 200, mode: 'cover' }`. iOS and Android give the same size.
+- Also in `onImageProcessed` (`image.thumbnailUri` …). Video posters keep their own rules (longest side 512, `video.posterFormat`) and ignore this option.
+- Files: `turbo_picker_thumb_<time>_<index>.webp` next to the output photo; deleted after 24 h like the other temp files.
 
 #### `closeGallery(): Promise<boolean>`
 Closes the picker from code. `true` if it was open.
@@ -262,6 +289,7 @@ Both callbacks fire before `openGallery` resolves; their listeners are removed w
 | `uri` | `string` | Image to edit (`originalUri` from a picker result). |
 | `editedFileUri?` | `string` | A previous edit to continue from. |
 | `maxWidth` / `maxHeight` | `number` | Output bounds. |
+| `thumbnail?` | `ThumbnailOptions` | Also make a thumbnail of the edited result (crop and drawing applied). See [Photo thumbnails](#photo-thumbnails). |
 | `themeColor` / `appearance` | | Per-call overrides. |
 | `openDuration` / `closeDuration` | `number` (ms) | Animation durations. |
 
@@ -463,7 +491,7 @@ A native grid built for thousands of photos. It opens like the picker (same bott
 
 ### AI (generate & edit)
 
-The gallery's ✦ button (AI image generation) and the editor's 6th tool **AI** (AI photo editing) use Google Gemini. They are **off until you call `setAIConfig({ enabled: true, ... })`**. In apps other than ZemTalk the AI screens are chat-only: generate shows an aspect-ratio bar and the chat input, edit shows the photo and the chat input, and the text is sent to the model as typed. The style/option menus, sample prompts, recommendation chips and recent works are ZemTalk-only.
+The gallery's ✦ button (AI image generation) and the editor's 6th tool **AI** (AI photo editing) use Google Gemini. They are **off until you call `setAIConfig({ enabled: true, ... })`**. The screens are the same in every app. Generate has woman / man, country, age, style and situation pickers, an aspect-ratio bar, sample chips and the chat input; chat text is sent together with the chosen settings. Edit is the full editing screen: edit choices, options, recommendation chips and the chat input. Generated and edited images are kept on the device and listed in the gallery's "AI 이미지" tab.
 
 ```ts
 await AttachmentKit.setAIConfig({
@@ -562,6 +590,7 @@ app.post('/ai/generate', auth, express.json({ limit: '20mb' }), async (req, res)
 |---|---|---|---|
 | Files from the File tab | `tmp/AttachmentKitFiles/<uuid>/<name>` | `cache/AttachmentKitFiles/<uuid>/<name>` | Deleted after 24 h (next gallery open); the OS may purge earlier — copy/upload promptly. |
 | Location snapshots | `tmp/AttachmentKitLocation/` | `cache/AttachmentKitLocation/` | Deleted after 24 h. |
+| Photo thumbnails (`thumbnail` option) | `Library/Caches/RNAttachmentKit/turbo_picker_thumb_*` | `cache/turbo_picker_thumb_*` | Deleted after 24 h (next gallery open). |
 | Location thumbnails | `Library/Caches/RNAttachmentKit/LocationThumbs/` | `cache/RNAttachmentKitLocationThumbs/` | 300 max → 250, least recently used. `clearLocationThumbnailCache()`. |
 | Reverse-geocode results | `Library/Caches/RNAttachmentKit/Geocode/` | `cache/RNAttachmentKitGeocode/` | 1000 max → 800, least recently used. `clearReverseGeocodeCache()`. |
 
@@ -569,7 +598,16 @@ app.post('/ai/generate', auth, express.json({ limit: '20mb' }), async (req, res)
 
 ## 📜 License & Contact
 
-`react-native-attachment-kit` is released under the **MIT License**. Removing the editor watermark requires a license key passed to `init()`.
+`react-native-attachment-kit` is released under the **MIT License**. A license key passed to `init()` (one key per app ID — bundle ID / package name) removes the editor watermark and unlocks location, video and AI.
+
+Without a valid key (evaluation), only photos work: picking, editing (with watermark) and viewing.
+
+| Feature | Without a license key |
+|---|---|
+| Attach menu Location tab, ✦ AI generate, editor AI tool, "AI 이미지" tab | Visible; tapping shows a "License required" notice |
+| `openGallery({ mediaType: 'video' \| 'all' })` | Photos only; holding the shutter to record shows the notice |
+| `openMapViewer`, `renderLocationThumbnail`, `reverseGeocode`, `openViewer` with `videos`, `openMediaGallery` / `appendGalleryItems` with video items | Rejected with `E_LICENSE_REQUIRED` |
+| `setAIConfig` | Accepted (the AI buttons appear and show the notice) |
 
 🛒 **License**: [https://license.rnturboimagepicker.usomnia.co.kr](https://license.rnturboimagepicker.usomnia.co.kr)
 📧 **Contact**: [contact@usomnia.co.kr](mailto:contact@usomnia.co.kr)

package/android/CMakeLists.txt

@@ -3,6 +3,9 @@ set(CMAKE_VERBOSE_MAKEFILE ON)
 
 project(react_codegen_RNAttachmentKitSpec)
 
+# Android 15+ 16KB 페이지 기기 지원 (Google Play: targetSdk 35+ 업데이트 필수). NDK r27 이하는 기본이 4KB 정렬이라 명시
+string(APPEND CMAKE_SHARED_LINKER_FLAGS " -Wl,-z,max-page-size=16384")
+
 set(GENERATED_SRC_DIR "${CMAKE_CURRENT_SOURCE_DIR}/build/generated/source/codegen/jni")
 
 if(NOT COMMAND target_compile_reactnative_options)

package/android/build.gradle

@@ -46,10 +46,19 @@ if (project != rootProject) {
     android {
         namespace "com.rnattachmentkit.react"
         compileSdkVersion 34
+        // 16KB 페이지 지원: 앱과 같은 NDK (RN 템플릿의 rootProject.ext.ndkVersion, r27+ 권장)
+        if (rootProject.ext.has("ndkVersion")) {
+            ndkVersion rootProject.ext.ndkVersion
+        }
         
         defaultConfig {
             minSdkVersion 24
             targetSdkVersion 34
+            externalNativeBuild {
+                cmake {
+                    arguments "-DANDROID_SUPPORT_FLEXIBLE_PAGE_SIZES=ON"
+                }
+            }
         }
         compileOptions {
             sourceCompatibility JavaVersion.VERSION_17
@@ -126,8 +135,8 @@ if (project != rootProject) {
         implementation "androidx.media3:media3-transformer:${media3_version}"
         implementation "androidx.media3:media3-effect:${media3_version}"
 
-        // CameraX dependencies
-        def camerax_version = "1.3.1"
+        // CameraX dependencies — 1.4.0+ 부터 libimage_processing_util_jni.so 가 16KB 정렬 (AAR 쪽과 같은 버전)
+        def camerax_version = "1.4.2"
         implementation "androidx.camera:camera-core:${camerax_version}"
         implementation "androidx.camera:camera-camera2:${camerax_version}"
         implementation "androidx.camera:camera-lifecycle:${camerax_version}"

package/android/src/newarch/java/com/rnattachmentkit/RNAttachmentKitModule.kt

@@ -59,10 +59,13 @@ class RNAttachmentKitModule(reactContext: ReactApplicationContext) :
         val maxWidth: Int, val maxHeight: Int, val outputFormat: String,
         val videoOptions: com.rnattachmentkit.VideoExportOptions,
         val states: Map<String, com.rnattachmentkit.VideoEditState>,
-        val showHUD: Boolean, val themeColor: Int?, val language: String
+        val showHUD: Boolean, val themeColor: Int?, val language: String,
+        val thumbnail: com.rnattachmentkit.PhotoThumbnail.Options?
     )
     private fun sendSnapshot() = SendSnapshot(maxWidth, maxHeight, outputFormat, videoOptions, HashMap(lastVideoEditStates),
-        showVideoHUD, lastThemeColorInt, lastLanguageCode)
+        showVideoHUD, lastThemeColorInt, lastLanguageCode, thumbnailOptions)
+    /** 사진 썸네일 (GalleryOptions.thumbnail / EditorOptions.thumbnail). null 이면 만들지 않음 (기존과 같음) */
+    private var thumbnailOptions: com.rnattachmentkit.PhotoThumbnail.Options? = null
     /** 동영상 변환 진행 HUD — video.showProgressHUD, 없으면 asyncProcessing 이 아닐 때만 (이벤트로 말풍선에 그리는 앱은 HUD 없이) */
     private var showVideoHUD = true
     /** 시트가 닫힐 때 넘겨받은 동영상 편집 상태 (원본 uri 문자열 → 품질·음소거) */
@@ -242,6 +245,9 @@ class RNAttachmentKitModule(reactContext: ReactApplicationContext) :
         
         if (options.hasKey("maxWidth")) maxWidth = options.getInt("maxWidth")
         if (options.hasKey("maxHeight")) maxHeight = options.getInt("maxHeight")
+        thumbnailOptions = com.rnattachmentkit.PhotoThumbnail.parse(
+            if (options.hasKey("thumbnail") && !options.isNull("thumbnail")) options.getMap("thumbnail")?.toHashMap() else null
+        )
         
         editImagePromise = promise
 
@@ -350,6 +356,10 @@ class RNAttachmentKitModule(reactContext: ReactApplicationContext) :
         videoOptions = com.rnattachmentkit.VideoExportOptions.fromMap(
             if (options.hasKey("video") && !options.isNull("video")) options.getMap("video")?.toHashMap() else null
         )
+        // 사진 썸네일 (동영상 포스터 규칙은 그대로 — video.posterFormat, 긴 변 512)
+        thumbnailOptions = com.rnattachmentkit.PhotoThumbnail.parse(
+            if (options.hasKey("thumbnail") && !options.isNull("thumbnail")) options.getMap("thumbnail")?.toHashMap() else null
+        )
         run {
             val async = options.hasKey("asyncProcessing") && !options.isNull("asyncProcessing") && options.getBoolean("asyncProcessing")
             val v = if (options.hasKey("video") && !options.isNull("video")) options.getMap("video") else null
@@ -528,6 +538,14 @@ class RNAttachmentKitModule(reactContext: ReactApplicationContext) :
     }
 
     override fun openViewer(options: ReadableMap, promise: Promise) {
+        // 동영상 페이지는 라이선스 키가 있어야
+        if (!LicenseGate.isLicensed && options.hasKey("videos")) {
+            val va = options.getArray("videos")
+            val anyVideo = va != null && (0 until va.size()).any { i ->
+                va.getType(i) == com.facebook.react.bridge.ReadableType.Map && va.getMap(i)?.let { it.hasKey("uri") && !it.isNull("uri") && !it.getString("uri").isNullOrEmpty() } == true
+            }
+            if (anyVideo) { promise.reject(LicenseGate.ERROR_CODE, LicenseGate.ERROR_MESSAGE); return }
+        }
         val activity = getCurrentActivity()
         if (activity == null) {
             promise.reject(E_NO_ACTIVITY, "Activity doesn't exist")
@@ -964,6 +982,7 @@ class RNAttachmentKitModule(reactContext: ReactApplicationContext) :
         val showVideoHUD = snap.showHUD
         val lastThemeColorInt = snap.themeColor
         val lastLanguageCode = snap.language
+        val thumbnailOptions = snap.thumbnail
         val processingId = java.util.UUID.randomUUID().toString()
         val results = mutableListOf<com.facebook.react.bridge.WritableMap>()
         val contentResolver = reactApplicationContext.contentResolver
@@ -1212,6 +1231,10 @@ class RNAttachmentKitModule(reactContext: ReactApplicationContext) :
                             FileOutputStream(tempFile).use { out ->
                                 processedBitmap.compress(compressFormat, 85, out)
                             }
+                            // 썸네일: 같은 비트맵(방향·크롭·그리기 반영)에서 — 원본을 다시 읽지 않음
+                            val thumb = thumbnailOptions?.let {
+                                com.rnattachmentkit.PhotoThumbnail.make(processedBitmap, it, reactApplicationContext.cacheDir, currentIndex)
+                            }
                             
                             val finalWidth = processedBitmap.width
                             val finalHeight = processedBitmap.height
@@ -1237,6 +1260,12 @@ class RNAttachmentKitModule(reactContext: ReactApplicationContext) :
                                     putString("originalUri", uri.toString())
                                     putInt("originalWidth", originalWidth)
                                     putInt("originalHeight", originalHeight)
+                                    if (thumb != null) {
+                                        putString("thumbnailUri", Uri.fromFile(thumb.file).toString())
+                                        putInt("thumbnailWidth", thumb.width)
+                                        putInt("thumbnailHeight", thumb.height)
+                                        putDouble("thumbnailFileSize", thumb.fileSize.toDouble())
+                                    }
                                 }
                             }
                             val imageInfo = createImageInfo()
@@ -1342,6 +1371,10 @@ class RNAttachmentKitModule(reactContext: ReactApplicationContext) :
             return
         }
         val o: Map<String, Any?> = options.toHashMap()
+        // 동영상 항목은 라이선스 키가 있어야
+        if (!LicenseGate.isLicensed && MediaGalleryItem.listFrom(o["items"]).any { it.isVideo }) {
+            promise.reject(LicenseGate.ERROR_CODE, LicenseGate.ERROR_MESSAGE); return
+        }
         com.facebook.react.bridge.UiThreadUtil.runOnUiThread {
             try {
                 val systemDark = (activity.resources.configuration.uiMode and
@@ -1425,6 +1458,9 @@ class RNAttachmentKitModule(reactContext: ReactApplicationContext) :
             p["nextCursor"] as? String,
             p["hasMore"] as? Boolean ?: false
         )
+        if (!LicenseGate.isLicensed && page.items.any { it.isVideo }) {
+            promise.reject(LicenseGate.ERROR_CODE, LicenseGate.ERROR_MESSAGE); return
+        }
         com.facebook.react.bridge.UiThreadUtil.runOnUiThread {
             mediaGalleries[galleryId]?.store?.appendExternal(page)
             promise.resolve(null)
@@ -1503,6 +1539,8 @@ class RNAttachmentKitModule(reactContext: ReactApplicationContext) :
     }
 
     override fun openMapViewer(options: ReadableMap, promise: Promise) {
+        // 위치 기능은 라이선스 키가 있어야
+        if (!LicenseGate.isLicensed) { promise.reject(LicenseGate.ERROR_CODE, LicenseGate.ERROR_MESSAGE); return }
         val activity = getCurrentActivity() as? FragmentActivity
         if (activity == null) {
             promise.reject("NO_ACTIVITY", "Activity is not a FragmentActivity")
@@ -1585,6 +1623,8 @@ class RNAttachmentKitModule(reactContext: ReactApplicationContext) :
      */
     @ReactMethod
     override fun renderLocationThumbnail(options: ReadableMap, promise: Promise) {
+        // 위치 기능은 라이선스 키가 있어야
+        if (!LicenseGate.isLicensed) { promise.reject(LicenseGate.ERROR_CODE, LicenseGate.ERROR_MESSAGE); return }
         fun str(key: String) = if (options.hasKey(key) && !options.isNull(key)) options.getString(key) else null
         fun num(key: String) = if (options.hasKey(key) && !options.isNull(key)) options.getDouble(key) else null
         val lat = num("latitude")
@@ -1685,6 +1725,10 @@ class RNAttachmentKitModule(reactContext: ReactApplicationContext) :
     // ── AI 기능 설정·잔액 (넘긴 값만 바뀜). 사용·충전 요청은 onAIUsage / onAIChargeRequired 이벤트로 알림 ──
 
     override fun setAIConfig(config: ReadableMap, promise: Promise) {
+        // 라이선스 키가 없어도 설정은 받아 둠 (AI 버튼은 보이고, 누르면 "라이선스 필요" 안내)
+        if (!LicenseGate.isLicensed && config.hasKey("enabled") && !config.isNull("enabled") && config.getBoolean("enabled")) {
+            android.util.Log.w("RNAttachmentKit", "AI needs a license key — the AI buttons show a license notice until init() gets a valid key")
+        }
         AIBilling.apply(config.toHashMap())
         val ctx = reactApplicationContext
         fun emit(name: String, body: Map<String, Any>) {
@@ -1702,6 +1746,8 @@ class RNAttachmentKitModule(reactContext: ReactApplicationContext) :
     // ── 역지오코딩 (기기 Geocoder, 디스크 캐시) ──
 
     override fun reverseGeocode(options: ReadableMap, promise: Promise) {
+        // 위치 기능은 라이선스 키가 있어야
+        if (!LicenseGate.isLicensed) { promise.reject(LicenseGate.ERROR_CODE, LicenseGate.ERROR_MESSAGE); return }
         val lat = if (options.hasKey("latitude") && !options.isNull("latitude")) options.getDouble("latitude") else Double.NaN
         val lng = if (options.hasKey("longitude") && !options.isNull("longitude")) options.getDouble("longitude") else Double.NaN
         val lang = if (options.hasKey("languageCode") && !options.isNull("languageCode")) options.getString("languageCode") else null

package/android/src/oldarch/java/com/rnattachmentkit/RNAttachmentKitModule.kt

@@ -58,10 +58,13 @@ class RNAttachmentKitModule(reactContext: ReactApplicationContext) :
         val maxWidth: Int, val maxHeight: Int, val outputFormat: String,
         val videoOptions: com.rnattachmentkit.VideoExportOptions,
         val states: Map<String, com.rnattachmentkit.VideoEditState>,
-        val showHUD: Boolean, val themeColor: Int?, val language: String
+        val showHUD: Boolean, val themeColor: Int?, val language: String,
+        val thumbnail: com.rnattachmentkit.PhotoThumbnail.Options?
     )
     private fun sendSnapshot() = SendSnapshot(maxWidth, maxHeight, outputFormat, videoOptions, HashMap(lastVideoEditStates),
-        showVideoHUD, lastThemeColorInt, lastLanguageCode)
+        showVideoHUD, lastThemeColorInt, lastLanguageCode, thumbnailOptions)
+    /** 사진 썸네일 (GalleryOptions.thumbnail / EditorOptions.thumbnail). null 이면 만들지 않음 (기존과 같음) */
+    private var thumbnailOptions: com.rnattachmentkit.PhotoThumbnail.Options? = null
     /** 동영상 변환 진행 HUD — video.showProgressHUD, 없으면 asyncProcessing 이 아닐 때만 (이벤트로 말풍선에 그리는 앱은 HUD 없이) */
     private var showVideoHUD = true
     /** 시트가 닫힐 때 넘겨받은 동영상 편집 상태 (원본 uri 문자열 → 품질·음소거) */
@@ -180,6 +183,9 @@ class RNAttachmentKitModule(reactContext: ReactApplicationContext) :
         
         if (options.hasKey("maxWidth")) maxWidth = options.getInt("maxWidth")
         if (options.hasKey("maxHeight")) maxHeight = options.getInt("maxHeight")
+        thumbnailOptions = com.rnattachmentkit.PhotoThumbnail.parse(
+            if (options.hasKey("thumbnail") && !options.isNull("thumbnail")) options.getMap("thumbnail")?.toHashMap() else null
+        )
         
         editImagePromise = promise
 
@@ -288,6 +294,10 @@ class RNAttachmentKitModule(reactContext: ReactApplicationContext) :
         videoOptions = com.rnattachmentkit.VideoExportOptions.fromMap(
             if (options.hasKey("video") && !options.isNull("video")) options.getMap("video")?.toHashMap() else null
         )
+        // 사진 썸네일 (동영상 포스터 규칙은 그대로 — video.posterFormat, 긴 변 512)
+        thumbnailOptions = com.rnattachmentkit.PhotoThumbnail.parse(
+            if (options.hasKey("thumbnail") && !options.isNull("thumbnail")) options.getMap("thumbnail")?.toHashMap() else null
+        )
         run {
             val async = options.hasKey("asyncProcessing") && !options.isNull("asyncProcessing") && options.getBoolean("asyncProcessing")
             val v = if (options.hasKey("video") && !options.isNull("video")) options.getMap("video") else null
@@ -536,6 +546,14 @@ class RNAttachmentKitModule(reactContext: ReactApplicationContext) :
 
     @ReactMethod
     override fun openViewer(options: ReadableMap, promise: Promise) {
+        // 동영상 페이지는 라이선스 키가 있어야
+        if (!LicenseGate.isLicensed && options.hasKey("videos")) {
+            val va = options.getArray("videos")
+            val anyVideo = va != null && (0 until va.size()).any { i ->
+                va.getType(i) == com.facebook.react.bridge.ReadableType.Map && va.getMap(i)?.let { it.hasKey("uri") && !it.isNull("uri") && !it.getString("uri").isNullOrEmpty() } == true
+            }
+            if (anyVideo) { promise.reject(LicenseGate.ERROR_CODE, LicenseGate.ERROR_MESSAGE); return }
+        }
         val activity = getCurrentActivity()
         if (activity == null) {
             promise.reject(E_NO_ACTIVITY, "Activity doesn't exist")
@@ -948,6 +966,7 @@ class RNAttachmentKitModule(reactContext: ReactApplicationContext) :
         val showVideoHUD = snap.showHUD
         val lastThemeColorInt = snap.themeColor
         val lastLanguageCode = snap.language
+        val thumbnailOptions = snap.thumbnail
         val processingId = java.util.UUID.randomUUID().toString()
         val results = mutableListOf<com.facebook.react.bridge.WritableMap>()
         val contentResolver = reactApplicationContext.contentResolver
@@ -1196,6 +1215,10 @@ class RNAttachmentKitModule(reactContext: ReactApplicationContext) :
                             FileOutputStream(tempFile).use { out ->
                                 processedBitmap.compress(compressFormat, 85, out)
                             }
+                            // 썸네일: 같은 비트맵(방향·크롭·그리기 반영)에서 — 원본을 다시 읽지 않음
+                            val thumb = thumbnailOptions?.let {
+                                com.rnattachmentkit.PhotoThumbnail.make(processedBitmap, it, reactApplicationContext.cacheDir, currentIndex)
+                            }
                             
                             val finalWidth = processedBitmap.width
                             val finalHeight = processedBitmap.height
@@ -1221,6 +1244,12 @@ class RNAttachmentKitModule(reactContext: ReactApplicationContext) :
                                     putString("originalUri", uri.toString())
                                     putInt("originalWidth", originalWidth)
                                     putInt("originalHeight", originalHeight)
+                                    if (thumb != null) {
+                                        putString("thumbnailUri", Uri.fromFile(thumb.file).toString())
+                                        putInt("thumbnailWidth", thumb.width)
+                                        putInt("thumbnailHeight", thumb.height)
+                                        putDouble("thumbnailFileSize", thumb.fileSize.toDouble())
+                                    }
                                 }
                             }
                             val imageInfo = createImageInfo()
@@ -1327,6 +1356,10 @@ class RNAttachmentKitModule(reactContext: ReactApplicationContext) :
             return
         }
         val o: Map<String, Any?> = options.toHashMap()
+        // 동영상 항목은 라이선스 키가 있어야
+        if (!LicenseGate.isLicensed && MediaGalleryItem.listFrom(o["items"]).any { it.isVideo }) {
+            promise.reject(LicenseGate.ERROR_CODE, LicenseGate.ERROR_MESSAGE); return
+        }
         com.facebook.react.bridge.UiThreadUtil.runOnUiThread {
             try {
                 val systemDark = (activity.resources.configuration.uiMode and
@@ -1412,6 +1445,9 @@ class RNAttachmentKitModule(reactContext: ReactApplicationContext) :
             p["nextCursor"] as? String,
             p["hasMore"] as? Boolean ?: false
         )
+        if (!LicenseGate.isLicensed && page.items.any { it.isVideo }) {
+            promise.reject(LicenseGate.ERROR_CODE, LicenseGate.ERROR_MESSAGE); return
+        }
         com.facebook.react.bridge.UiThreadUtil.runOnUiThread {
             mediaGalleries[galleryId]?.store?.appendExternal(page)
             promise.resolve(null)
@@ -1488,6 +1524,8 @@ class RNAttachmentKitModule(reactContext: ReactApplicationContext) :
 
     @ReactMethod
     fun openMapViewer(options: ReadableMap, promise: Promise) {
+        // 위치 기능은 라이선스 키가 있어야
+        if (!LicenseGate.isLicensed) { promise.reject(LicenseGate.ERROR_CODE, LicenseGate.ERROR_MESSAGE); return }
         val activity = getCurrentActivity() as? FragmentActivity
         if (activity == null) {
             promise.reject("NO_ACTIVITY", "Activity is not a FragmentActivity")
@@ -1571,6 +1609,8 @@ class RNAttachmentKitModule(reactContext: ReactApplicationContext) :
      */
     @ReactMethod
     fun renderLocationThumbnail(options: ReadableMap, promise: Promise) {
+        // 위치 기능은 라이선스 키가 있어야
+        if (!LicenseGate.isLicensed) { promise.reject(LicenseGate.ERROR_CODE, LicenseGate.ERROR_MESSAGE); return }
         fun str(key: String) = if (options.hasKey(key) && !options.isNull(key)) options.getString(key) else null
         fun num(key: String) = if (options.hasKey(key) && !options.isNull(key)) options.getDouble(key) else null
         val lat = num("latitude")
@@ -1672,6 +1712,10 @@ class RNAttachmentKitModule(reactContext: ReactApplicationContext) :
 
     @ReactMethod
     fun setAIConfig(config: ReadableMap, promise: Promise) {
+        // 라이선스 키가 없어도 설정은 받아 둠 (AI 버튼은 보이고, 누르면 "라이선스 필요" 안내)
+        if (!LicenseGate.isLicensed && config.hasKey("enabled") && !config.isNull("enabled") && config.getBoolean("enabled")) {
+            android.util.Log.w("RNAttachmentKit", "AI needs a license key — the AI buttons show a license notice until init() gets a valid key")
+        }
         AIBilling.apply(config.toHashMap())
         val ctx = reactApplicationContext
         fun emit(name: String, body: Map<String, Any>) {
@@ -1690,6 +1734,8 @@ class RNAttachmentKitModule(reactContext: ReactApplicationContext) :
 
     @ReactMethod
     fun reverseGeocode(options: ReadableMap, promise: Promise) {
+        // 위치 기능은 라이선스 키가 있어야
+        if (!LicenseGate.isLicensed) { promise.reject(LicenseGate.ERROR_CODE, LicenseGate.ERROR_MESSAGE); return }
         val lat = if (options.hasKey("latitude") && !options.isNull("latitude")) options.getDouble("latitude") else Double.NaN
         val lng = if (options.hasKey("longitude") && !options.isNull("longitude")) options.getDouble("longitude") else Double.NaN
         val lang = if (options.hasKey("languageCode") && !options.isNull("languageCode")) options.getString("languageCode") else null