react-native-attachment-kit 1.0.5 → 1.0.8

package/ios/RNAttachmentKit.xcframework/ios-arm64_x86_64-simulator/RNAttachmentKit.framework/_CodeSignature/CodeResources

@@ -6,7 +6,7 @@
 	<dict>
 		<key>Assets.car</key>
 		<data>
-		24XBU3LEblGjGTOAqjhqZ+mB2U0=
+		MRss66st77g0KhHxCBbJQfKPil4=
 		</data>
 		<key>Base.lproj/LaunchScreen.storyboardc/01J-lp-oVM-view-Ze5-6b-2t3.nib</key>
 		<data>
@@ -22,51 +22,51 @@
 		</data>
 		<key>Headers/RNAttachmentKit-Swift.h</key>
 		<data>
-		4lqGZdGnjvCCDxNRFc2GgyyzqyE=
+		SA2Uv/xUxXBayyyXE8H2RjgdHQA=
 		</data>
 		<key>Info.plist</key>
 		<data>
-		0sC7XVCqX43alae4JC2p56Wh1F4=
+		VGVHsdYWxmrpkpVKbSFeY69ecnY=
 		</data>
 		<key>Modules/RNAttachmentKit.swiftmodule/arm64-apple-ios-simulator.abi.json</key>
 		<data>
-		yzVs+k0n+fAWBNbxtMQPWwrjRN0=
+		FC2zf1jZnueKAakmwRvTrB9xiFk=
 		</data>
 		<key>Modules/RNAttachmentKit.swiftmodule/arm64-apple-ios-simulator.private.swiftinterface</key>
 		<data>
-		3d+7crlvM8P5/XPlmAcyIbpS6zs=
+		QViRQdPRlGSnejc+FkklUFb1xzo=
 		</data>
 		<key>Modules/RNAttachmentKit.swiftmodule/arm64-apple-ios-simulator.swiftdoc</key>
 		<data>
-		3Y+Yb6iItYSkNObvNxCJpXncvHQ=
+		13waPrbWcS1Vv7tMDqh9IORrbTU=
 		</data>
 		<key>Modules/RNAttachmentKit.swiftmodule/arm64-apple-ios-simulator.swiftinterface</key>
 		<data>
-		3d+7crlvM8P5/XPlmAcyIbpS6zs=
+		QViRQdPRlGSnejc+FkklUFb1xzo=
 		</data>
 		<key>Modules/RNAttachmentKit.swiftmodule/arm64-apple-ios-simulator.swiftmodule</key>
 		<data>
-		pTw5/RKAzDXtx8rwalHKzC1QVrw=
+		vxYcaOMhuUnqhRHLBIJ08g7Poz8=
 		</data>
 		<key>Modules/RNAttachmentKit.swiftmodule/x86_64-apple-ios-simulator.abi.json</key>
 		<data>
-		yzVs+k0n+fAWBNbxtMQPWwrjRN0=
+		FC2zf1jZnueKAakmwRvTrB9xiFk=
 		</data>
 		<key>Modules/RNAttachmentKit.swiftmodule/x86_64-apple-ios-simulator.private.swiftinterface</key>
 		<data>
-		YZtIbnfcDasieXiHsoxa0r1/Hkc=
+		4Bhyu9pqG8QPG8JDzN15Es69LgQ=
 		</data>
 		<key>Modules/RNAttachmentKit.swiftmodule/x86_64-apple-ios-simulator.swiftdoc</key>
 		<data>
-		174LWJPXzjBzOETdSc+BKgsj/ig=
+		9aHuRlxlcUm5c6hoS03l0x+rd+8=
 		</data>
 		<key>Modules/RNAttachmentKit.swiftmodule/x86_64-apple-ios-simulator.swiftinterface</key>
 		<data>
-		YZtIbnfcDasieXiHsoxa0r1/Hkc=
+		4Bhyu9pqG8QPG8JDzN15Es69LgQ=
 		</data>
 		<key>Modules/RNAttachmentKit.swiftmodule/x86_64-apple-ios-simulator.swiftmodule</key>
 		<data>
-		brFa0/Ksy3av4Ce56nRbOQSY1c0=
+		H6BZLJRWSEbtZxoVbtor+kQqH4A=
 		</data>
 		<key>Modules/module.modulemap</key>
 		<data>
@@ -227,7 +227,7 @@
 		<dict>
 			<key>hash2</key>
 			<data>
-			hcxV/4NZu79SXIpwsHu8Fo8WVAZLQfuKhITugdLFV+I=
+			PN8SGeEYmroH8IKhC4cAPpqrFa8xoBCtF2CRXH0MgEA=
 			</data>
 		</dict>
 		<key>Base.lproj/LaunchScreen.storyboardc/01J-lp-oVM-view-Ze5-6b-2t3.nib</key>
@@ -255,77 +255,77 @@
 		<dict>
 			<key>hash2</key>
 			<data>
-			jP+jiNnXhkOKTRJb5kKT4Skcl3imtlmW8htzvrG/9B8=
+			CIsiqD4QUiiFinw84KecZtVO9t4RF+3C362HoLNyZiA=
 			</data>
 		</dict>
 		<key>Modules/RNAttachmentKit.swiftmodule/arm64-apple-ios-simulator.abi.json</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			wPEN6QtxVqoCbCp/z3rYhGT5QOE2vKZR2uHf1sFkKcQ=
+			qtO0CZnvzwP16BEJ2c8k4epzursuYOewuXDMvEuLD3k=
 			</data>
 		</dict>
 		<key>Modules/RNAttachmentKit.swiftmodule/arm64-apple-ios-simulator.private.swiftinterface</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			PCJzsbciCPQjQ+8d1NaEqra2tG6IhnKGxArWy0tMCNU=
+			bQBBzPNGBXPENE5stiQHn43HpKljGLBGsmytx74osv8=
 			</data>
 		</dict>
 		<key>Modules/RNAttachmentKit.swiftmodule/arm64-apple-ios-simulator.swiftdoc</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			IqlfotL45Jo1H46fYK8QlNdsrWP+Wc4omyD8Ei0M38Y=
+			c5sCwczWvgTgfE4P3/QZXLg4Ju1YyiBkHe8mlkacRzs=
 			</data>
 		</dict>
 		<key>Modules/RNAttachmentKit.swiftmodule/arm64-apple-ios-simulator.swiftinterface</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			PCJzsbciCPQjQ+8d1NaEqra2tG6IhnKGxArWy0tMCNU=
+			bQBBzPNGBXPENE5stiQHn43HpKljGLBGsmytx74osv8=
 			</data>
 		</dict>
 		<key>Modules/RNAttachmentKit.swiftmodule/arm64-apple-ios-simulator.swiftmodule</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			+69q+F1mVqbDKIgKGmPaw7Oh0Evf2i4ESrGeEAa4b94=
+			QYe4TAel3zohjG3Va4rjTXrpDxq7B321XftFkE+yV08=
 			</data>
 		</dict>
 		<key>Modules/RNAttachmentKit.swiftmodule/x86_64-apple-ios-simulator.abi.json</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			wPEN6QtxVqoCbCp/z3rYhGT5QOE2vKZR2uHf1sFkKcQ=
+			qtO0CZnvzwP16BEJ2c8k4epzursuYOewuXDMvEuLD3k=
 			</data>
 		</dict>
 		<key>Modules/RNAttachmentKit.swiftmodule/x86_64-apple-ios-simulator.private.swiftinterface</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			+c23Df2P+F8jTw46r7Qo0C11WzQMkRn3zQP3nOBtOng=
+			ruMrsqQu7c5vBjEKp/hzHz82QST/UnwbWCTHD3uGgqM=
 			</data>
 		</dict>
 		<key>Modules/RNAttachmentKit.swiftmodule/x86_64-apple-ios-simulator.swiftdoc</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			oh5aRAAJiHhK6wJJLdK4eEzb5vdFcETRW28KyIXHj0g=
+			l+6rzGzrcNz6C1xQixmxJnTj6bp8QFLvi01FhSTniOA=
 			</data>
 		</dict>
 		<key>Modules/RNAttachmentKit.swiftmodule/x86_64-apple-ios-simulator.swiftinterface</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			+c23Df2P+F8jTw46r7Qo0C11WzQMkRn3zQP3nOBtOng=
+			ruMrsqQu7c5vBjEKp/hzHz82QST/UnwbWCTHD3uGgqM=
 			</data>
 		</dict>
 		<key>Modules/RNAttachmentKit.swiftmodule/x86_64-apple-ios-simulator.swiftmodule</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			hC7shtU5k+++O06+9Yl5UBbBKbXd0idJRMcEokgi3Co=
+			ThGXvJl+h56CfaVaUxPIvX289ZySMuF5rCfa478xQRo=
 			</data>
 		</dict>
 		<key>Modules/module.modulemap</key>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-attachment-kit",
-  "version": "1.0.5",
+  "version": "1.0.8",
   "description": "Native attachment kit for React Native — gallery picker, editor, image viewer and media gallery (Turbo Module)",
   "main": "src/index.ts",
   "types": "src/index.ts",
@@ -65,4 +65,4 @@
     "type": "git",
     "url": "https://github.com/Usomnia/react-native-attachment-kit.git"
   }
-}
+}

package/react-native-attachment-kit.podspec

@@ -26,7 +26,7 @@ Pod::Spec.new do |s|
   }
 
   s.vendored_frameworks = "ios/RNAttachmentKit.xcframework"
-  s.frameworks = "MapKit", "CoreLocation", "UniformTypeIdentifiers"  # 첨부 메뉴 > 위치·파일 탭
+  s.frameworks = "MapKit", "CoreLocation", "UniformTypeIdentifiers", "Vision", "CryptoKit", "CoreMotion"  # 위치·파일 탭 / AI 편집 사진 분석·캐시 / 카메라 기기 방향
 
   # s.dependency "SDWebImageWebPCoder"
 

package/src/NativeAttachmentKit.ts

@@ -7,6 +7,8 @@ export interface Spec extends TurboModule {
   openEditor(options: Object): Promise<Object>;
   openViewer(options: Object): Promise<void>;
   closeGallery(): Promise<boolean>;
+  /** 동영상 변환 취소. index -1 = 남은 동영상 전부, processingId "" = 가장 최근 처리 */
+  cancelVideoProcessing(index: number, processingId: string): Promise<boolean>;
   
   // RCTEventEmitter 필수 규격 (Turbo Module에서 이벤트 방출 시 필수)
   addListener(eventName: string): void;
@@ -26,6 +28,9 @@ export interface Spec extends TurboModule {
   reverseGeocode(options: Object): Promise<Object>;
   clearReverseGeocodeCache(): Promise<void>;
 
+  // AI 기능 설정·잔액 (넘긴 값만 바뀜). 사용·충전 요청은 onAIUsage / onAIChargeRequired 이벤트
+  setAIConfig(config: Object): Promise<void>;
+
   // 미디어 갤러리 (사진 모아보기)
   openMediaGallery(options: Object): Promise<Object>;
   closeMediaGallery(galleryId: string): Promise<void>;

package/src/index.ts

@@ -1,5 +1,5 @@
 import { NativeModules, Platform, TurboModuleRegistry, NativeEventEmitter, DeviceEventEmitter } from "react-native"
-import type { ImageResult, GalleryOptions, EditorOptions, SelectionChangeEvent, ViewerOptions, MediaGalleryOptions, MediaGalleryAppendPayload, MediaGalleryRemovePayload, Appearance } from "./types"
+import type { ImageResult, GalleryOptions, EditorOptions, SelectionChangeEvent, ViewerOptions, MediaGalleryOptions, MediaGalleryAppendPayload, MediaGalleryRemovePayload, Appearance, AIConfig, AIUsageEvent, AIChargeRequiredEvent } from "./types"
 
 const LINKING_ERROR = `The package 'react-native-attachment-kit' doesn't seem to be linked. Make sure: \n\n` + Platform.select({ ios: "- You have run 'pod install'\n", default: "" }) + "- You rebuilt the app after installing the package\n" + "- You are not using Expo Go\n"
 
@@ -78,6 +78,8 @@ function alreadyOpenError(what: string): Error {
  * Android pickImagesPromise) 중복 호출하면 앞 호출의 Promise 가 영영 끝나지 않습니다 → JS 에서 먼저 막습니다.
  */
 let _galleryOpen = false
+/** 어느 openGallery 호출이 _galleryOpen 을 잡고 있는지 — 처리 시작(onProcessingStart)에 먼저 풀고, 늦게 끝난 앞 호출이 새 호출의 잠금을 풀지 않게 */
+let _galleryOpenToken = 0
 /** openEditor 도 Android 가 editImagePromise 하나만 보관하므로 같은 보호가 필요 */
 let _editorOpen = false
 /**
@@ -86,6 +88,8 @@ let _editorOpen = false
  */
 let _asyncImgProcessedSub: { remove: () => void } | null = null
 
+export type { AIConfig, AIUsageEvent, AIChargeRequiredEvent } from "./types"
+export type { VideoOptions, VideoProgressEvent, ViewerVideo, ProcessingStartEvent, ProcessingStartItem } from "./types"
 export type { SelectionChangeEvent, Appearance, AttachLocationResult, MapViewerOptions, ReverseGeocodeOptions, ReverseGeocodeResult, ReverseGeocodeErrorCode, AttachFileResult, AttachFileFailure, LocationThumbnailOptions, LocationThumbnailResult } from "./types"
 export type { MediaGalleryItem, MediaGalleryOptions, MediaGalleryGridSize, MediaGalleryGridSizeChangedEvent, MediaGalleryTheme, MediaGalleryViewerOptions, MediaGalleryDeleteOption, MediaGalleryItemDeletedEvent, MediaGalleryNeedPageEvent, MediaGalleryClosedEvent, MediaGalleryAppendPayload, MediaGalleryRemovePayload } from "./types"
 
@@ -115,6 +119,23 @@ export interface RNAttachmentKit {
   /** reverseGeocode 캐시 비우기 */
   clearReverseGeocodeCache(): Promise<void>
   closeGallery(): Promise<boolean>
+  /**
+   * processingId: 어느 보내기인지 (onProcessingStart 의 값). 생략하면 가장 최근 보내기
+   *
+   * 보내는 중인 동영상 변환 취소 (HUD 없이 말풍선에서 취소할 때). index 생략 = 남은 동영상 전부.
+   * 취소된 동영상은 onImageProcessed·결과에 { error: "CANCELLED", cancelled: true } 로 오고 나머지는 계속 처리됩니다.
+   * 진행 중인 처리가 없으면 false
+   */
+  cancelVideoProcessing(index?: number, processingId?: string): Promise<boolean>
+  /**
+   * AI 기능 on/off · 포인트 · 무료 횟수 · 1회 차감 포인트 (넘긴 값만 바뀜). 앱 시작 때 한 번, 잔액이 바뀔 때마다(충전·서버 동기화) 다시 호출.
+   * AI 화면이 열려 있으면 바로 반영됩니다.
+   */
+  setAIConfig(config: AIConfig): Promise<void>
+  /** AI 를 한 번 쓸 때마다 (무료 횟수 사용 또는 포인트 차감) — 앱이 서버에 반영. 해제 함수를 돌려줌 */
+  addAIUsageListener(listener: (event: AIUsageEvent) => void): () => void
+  /** 포인트가 모자라 사용자가 '충전하기'를 눌렀을 때 — 앱이 충전 화면으로 안내 (필요하면 closeGallery() 로 시트도 닫기). 해제 함수를 돌려줌 */
+  addAIChargeRequiredListener(listener: (event: AIChargeRequiredEvent) => void): () => void
   addSelectionChangeListener(listener: (event: SelectionChangeEvent) => void): () => void
   getDefaultAnimationConfig(): Promise<{ galleryOpen: number, galleryClose: number, editorOpen: number, editorClose: number, viewerOpen: number, viewerClose: number }>
   injectImageCache(urlString: string, localPath: string): Promise<boolean>
@@ -167,6 +188,22 @@ const AttachmentKit: RNAttachmentKit = {
       throw alreadyOpenError("Gallery")
     }
     _galleryOpen = true
+    const myToken = ++_galleryOpenToken
+    // 갤러리 화면이 닫히고 처리가 시작되면(onProcessingStart) 바로 잠금을 풂 — 동영상을 변환하는 동안에도
+    // 다시 열어 보낼 수 있게. Promise 는 지금처럼 처리가 다 끝나야 resolve
+    let myProcessingId: string | null = null
+    const subscriptionOpenLock = eventEmitter.addListener("onProcessingStart", (e: any) => {
+      if (myProcessingId) return
+      myProcessingId = typeof e?.processingId === "string" ? e.processingId : ""
+      if (_galleryOpenToken === myToken) _galleryOpen = false
+    })
+    /** 이 호출의 이벤트인지 — processingId 가 붙은 이벤트는 내 처리의 것만, 안 붙은(옛 네이티브·사진 1장 편집) 이벤트는 처리 ID 를 모를 때만 */
+    const isMine = (e: any) => {
+      const id = e?.processingId
+      if (typeof id !== "string" || id === "") return !myProcessingId
+      return myProcessingId === id
+    }
+    const mine = <T,>(fn?: (e: T) => void) => fn ? (e: T) => { if (isMine(e)) fn(e) } : undefined
 
     // 콜백 이벤트 임시 리스너 등록
     let subscriptionSelChange: any = null
@@ -182,16 +219,33 @@ const AttachmentKit: RNAttachmentKit = {
           try { _asyncImgProcessedSub.remove() } catch (e) { /* noop */ }
           _asyncImgProcessedSub = null
         }
-        subscriptionImgProcessed = eventEmitter.addListener("onImageProcessed", options.onImageProcessed)
+        subscriptionImgProcessed = eventEmitter.addListener("onImageProcessed", mine(options.onImageProcessed)!)
         _asyncImgProcessedSub = subscriptionImgProcessed
       } else {
-        subscriptionImgProcessed = eventEmitter.addListener("onImageProcessed", options.onImageProcessed)
+        subscriptionImgProcessed = eventEmitter.addListener("onImageProcessed", mine(options.onImageProcessed)!)
       }
     }
     let subscriptionLocation: any = null
     if (options.onLocationSelected) {
       subscriptionLocation = eventEmitter.addListener("onLocationSelected", options.onLocationSelected)
     }
+    // 동영상 변환 진행률 (video.onProgress)
+    let subscriptionVideoProgress: any = null
+    if (options.video?.onProgress) {
+      subscriptionVideoProgress = eventEmitter.addListener("onVideoProgress", mine(options.video.onProgress)!)
+    }
+    // 처리 시작 (보낸 직후 한 번, 결과보다 먼저)
+    let subscriptionProcessingStart: any = null
+    if (options.onProcessingStart) {
+      // 내 처리 시작만 (앞 보내기의 시작 이벤트는 이 호출 전에 이미 지나감)
+      const onStart = options.onProcessingStart
+      let started = false
+      subscriptionProcessingStart = eventEmitter.addListener("onProcessingStart", (e: any) => {
+        if (started) return
+        started = true
+        onStart(e)
+      })
+    }
     let subscriptionFiles: any = null
     if (options.onFilesSelected) {
       const onFiles = options.onFilesSelected
@@ -201,19 +255,26 @@ const AttachmentKit: RNAttachmentKit = {
 
     try {
       // 이벤트 콜백은 네이티브로 전달하지 않음
-      const { onSelectionChange, onImageProcessed, onLocationSelected, onFilesSelected, ...restOptions } = options
-      const nativeOptions = {
+      const { onSelectionChange, onImageProcessed, onLocationSelected, onFilesSelected, onProcessingStart, video, ...restOptions } = options
+      const nativeOptions: any = {
         themeColor: _defaultThemeColor,
         languageCode: _defaultLanguageCode,
         appearance: _defaultAppearance,
         ...restOptions,
       }
+      if (video) {
+        // onProgress 콜백은 네이티브로 넘기지 않음
+        const { onProgress, ...videoRest } = video
+        nativeOptions.video = videoRest
+      }
       nativeOptions.languageCode = normalizeLanguageCode(nativeOptions.languageCode)
       nativeOptions.appearance = normalizeAppearance(nativeOptions.appearance)
       const result = await RNAttachmentKitModule.openGallery(nativeOptions)
       return result
     } finally {
-      _galleryOpen = false
+      // 처리 시작 때 이미 풀었고 그 뒤 새 호출이 잡았을 수 있음 → 내 잠금일 때만
+      if (_galleryOpenToken === myToken) _galleryOpen = false
+      subscriptionOpenLock.remove()
       // 갤러리가 닫히면 onSelectionChange 리스너 제거
       if (subscriptionSelChange) {
         subscriptionSelChange.remove()
@@ -225,6 +286,12 @@ const AttachmentKit: RNAttachmentKit = {
       if (subscriptionFiles) {
         subscriptionFiles.remove()
       }
+      if (subscriptionVideoProgress) {
+        subscriptionVideoProgress.remove()
+      }
+      if (subscriptionProcessingStart) {
+        subscriptionProcessingStart.remove()
+      }
       // asyncProcessing 모드가 아닐 때만 onImageProcessed 리스너 제거 (async 모드에선 백그라운드 처리를 위해 유지해야 함)
       // 호출부에서 수동으로 제거하거나, 최종 완료 시 정리하는 구조가 필요할 수 있음
       if (!options.asyncProcessing && subscriptionImgProcessed) {
@@ -380,7 +447,22 @@ const AttachmentKit: RNAttachmentKit = {
     mergedOptions.addressLanguageCode = options.languageCode || _rawLanguageCode || _defaultLanguageCode
     mergedOptions.languageCode = normalizeLanguageCode(mergedOptions.languageCode)
     mergedOptions.appearance = normalizeAppearance(mergedOptions.appearance)
-    await RNAttachmentKitModule.openMapViewer(mergedOptions)
+    // 함수는 네이티브로 못 넘김 — 닫기 시작은 이벤트로 받음 (Android 는 RCTDeviceEventEmitter 로도 올 수 있어 둘 다 듣고 한 번만)
+    const onWillClose = options.onViewerWillClose
+    delete mergedOptions.onViewerWillClose
+    let willCloseSent = false
+    const willCloseHandler = (e: any) => {
+      if (willCloseSent) return
+      willCloseSent = true
+      onWillClose?.({ durationMs: typeof e?.durationMs === 'number' ? e.durationMs : 0 })
+    }
+    const subs: any[] = [eventEmitter.addListener("onMapViewerWillClose", willCloseHandler)]
+    if (Platform.OS === "android") subs.push(DeviceEventEmitter.addListener("onMapViewerWillClose", willCloseHandler))
+    try {
+      await RNAttachmentKitModule.openMapViewer(mergedOptions)
+    } finally {
+      subs.forEach(s => s.remove())
+    }
   },
 
   updateMapViewerSourceRect: async (rect: import("./types").SourceRect | null): Promise<void> => {
@@ -439,6 +521,35 @@ const AttachmentKit: RNAttachmentKit = {
     return RNAttachmentKitModule.closeGallery()
   },
 
+  cancelVideoProcessing: async (index?: number, processingId?: string): Promise<boolean> => {
+    if (!RNAttachmentKitModule) {
+      throw new Error(LINKING_ERROR)
+    }
+    if (typeof RNAttachmentKitModule.cancelVideoProcessing !== "function") return false   // 옛 네이티브 빌드
+    return RNAttachmentKitModule.cancelVideoProcessing(typeof index === "number" && index >= 0 ? index : -1, processingId ?? "")
+  },
+
+  setAIConfig: async (config: AIConfig): Promise<void> => {
+    if (!RNAttachmentKitModule) {
+      throw new Error(LINKING_ERROR)
+    }
+    if (typeof RNAttachmentKitModule.setAIConfig !== "function") return   // 옛 네이티브 빌드
+    // undefined 는 "바꾸지 않음" 이므로 빼고 보냄 (null 은 "비움")
+    const payload: Record<string, unknown> = {}
+    Object.entries(config ?? {}).forEach(([k, v]) => { if (v !== undefined) payload[k] = v })
+    return RNAttachmentKitModule.setAIConfig(payload)
+  },
+
+  addAIUsageListener: (listener: (event: AIUsageEvent) => void) => {
+    const subscription = eventEmitter.addListener("onAIUsage", listener as any)
+    return () => subscription.remove()
+  },
+
+  addAIChargeRequiredListener: (listener: (event: AIChargeRequiredEvent) => void) => {
+    const subscription = eventEmitter.addListener("onAIChargeRequired", listener as any)
+    return () => subscription.remove()
+  },
+
   addSelectionChangeListener: (listener: (event: SelectionChangeEvent) => void) => {
     const subscription = eventEmitter.addListener("onSelectionChange", listener)
 

package/src/types.ts

@@ -20,6 +20,94 @@ export interface ImageResult {
   fileName?: string // 파일명
   fileExtension?: string // 확장자
   fileSize?: number // 파일 크기 (bytes)
+  /** "image"(기본) | "video" — mediaType: "all"/"video" 로 열었을 때 동영상이면 "video" */
+  mediaType?: "image" | "video"
+  /** 동영상: 길이(초, 소수) */
+  duration?: number
+  /** 동영상: 포스터 썸네일 file:// (video.posterFormat 형식 — 기본 webp, 긴 변 512) */
+  thumbnailUri?: string
+  thumbnailWidth?: number
+  thumbnailHeight?: number
+  /** 동영상: 전송본 코덱·평균 비트레이트(bps) */
+  videoCodec?: "h264" | "hevc" | string
+  videoBitrate?: number
+  /** 편집(trim/crop/overlay/음소거/품질 변경)했는지. false 면 원본을 그대로(리먹스) 보낸 것 */
+  edited?: boolean
+  /** 동영상 변환에 실패했을 때 (uri 없음). 사진·정상 동영상엔 없음. 앱이 취소했으면 "CANCELLED" */
+  error?: string
+  /** 앱이 cancelVideoProcessing 으로 취소한 동영상 (uri 없음) */
+  cancelled?: boolean
+}
+
+/**
+ * onProcessingStart — 갤러리에서 보낸 직후, 처리(사진 리사이즈·동영상 변환)를 시작하기 전에 한 번.
+ * 앱은 이걸로 말풍선 자리를 먼저 만들고(비율·포스터·길이), 동영상은 onVideoProgress 로 진행률을 그린 뒤
+ * onImageProcessed(index 같음)가 오면 실제 파일로 바꿉니다.
+ */
+export interface ProcessingStartEvent {
+  /**
+   * 이번 보내기의 ID. onVideoProgress / onImageProcessed 에도 같은 값이 붙음.
+   * 동영상을 변환하는 동안에도 갤러리를 다시 열어 또 보낼 수 있으므로, 이벤트를 전역 리스너로 받는 앱은 이 값으로 구분
+   */
+  processingId: string
+  total: number
+  items: ProcessingStartItem[]
+}
+
+export interface ProcessingStartItem {
+  index: number
+  mediaType: "image" | "video"
+  /** ph://… (iOS) / content://… (Android) */
+  originalUri?: string
+  /** 예상 결과 크기 (사진: 리사이즈 후, 동영상: 품질·크롭 반영). 비율용 */
+  width: number
+  height: number
+  /** 동영상: 보낼 길이(초, 구간 반영) */
+  duration?: number
+  /** 동영상: 포스터 file:// (video.posterFormat 형식 — 기본 webp, 크롭·그리기 반영) — 변환이 끝나기 전 말풍선에 */
+  thumbnailUri?: string
+  thumbnailWidth?: number
+  thumbnailHeight?: number
+}
+
+/** 동영상 옵션 (GalleryOptions.video). mediaType 이 "video"/"all" 일 때만 의미 */
+export interface VideoOptions {
+  /** 고를 수 있는 최대 길이(초). 기본 600 (10분). 넘는 동영상은 누르면 안내만. 0 = 제한 없음 */
+  maxDurationSec?: number
+  /** 전송 결과 최대 용량(MB). 기본 100. 추정치가 넘으면 더 낮은 품질로 자동 조정. 0 = 제한 없음 */
+  maxFileSizeMB?: number
+  /** 해상도 단계 (세로 px). 기본 [360, 480, 720, 1080]. 원본보다 큰 단계는 쓰지 않음(원본 유지) */
+  qualities?: number[]
+  /** 기본 품질 (세로 px). 기본 720. 원본이 더 작으면 원본 그대로 */
+  defaultQuality?: number
+  /** 구간 자르기 허용. 기본 true (편집 화면이 생기는 P2 부터) */
+  allowTrim?: boolean
+  /** 음소거 버튼 표시. 기본 true (P2 부터) */
+  allowMute?: boolean
+  /** 코덱. 기본 "h264". "hevc" 는 용량이 작지만 수신 기기 호환을 확인한 경우만 */
+  codec?: "h264" | "hevc"
+  /**
+   * 동영상 포스터(썸네일) 파일 형식. 기본 "webp" (jpg 보다 작음). "jpg" 로 하면 예전처럼 jpg.
+   * onProcessingStart / onImageProcessed 의 thumbnailUri 확장자가 이 값을 따름 (webp 인코딩이 안 되는 드문 경우엔 jpg 로 대신하니, 확장자는 uri 로 확인)
+   */
+  posterFormat?: "webp" | "jpg"
+  /** 전송 전 변환 진행률 (동영상마다 0~1, 1% 이상 바뀔 때·최소 0.1초 간격) */
+  onProgress?: (e: VideoProgressEvent) => void
+  /**
+   * 변환하는 동안 화면 가운데 진행 HUD(취소 버튼 포함)를 띄울지.
+   * 기본: asyncProcessing 이 아니면 true, asyncProcessing: true 면 false —
+   * 이벤트(onProcessingStart / onVideoProgress / onImageProcessed)로 말풍선에 진행 상황을 그리는 앱은 HUD 없이 씁니다.
+   * HUD 가 없을 때 취소는 AttachmentKit.cancelVideoProcessing(index)
+   */
+  showProgressHUD?: boolean
+}
+
+export interface VideoProgressEvent {
+  index: number
+  total: number
+  progress: number
+  /** 어느 보내기의 진행률인지 (onProcessingStart 의 processingId) */
+  processingId?: string
 }
 
 export interface SourceRect {
@@ -33,7 +121,10 @@ export interface GalleryOptions {
   maxSelection?: number
   maxWidth?: number // 최대 width
   maxHeight?: number // 최대 height
+  /** 기본 "photo" = 사진만(동영상 권한도 요청 안 함). "all" = 사진+동영상 날짜순 혼합, "video" = 동영상만 */
   mediaType?: "photo" | "video" | "all"
+  /** 동영상 옵션 (mediaType 이 video/all 일 때) */
+  video?: VideoOptions
   quality?: number
   allItemsText?: string
   selectedItemsText?: string
@@ -61,6 +152,8 @@ export interface GalleryOptions {
   asyncProcessing?: boolean // 완전 비동기 이벤트 리턴 여부
   onSelectionChange?: (event: SelectionChangeEvent) => void
   onImageProcessed?: (event: any) => void
+  /** 처리 시작 (보낸 직후 한 번) — 모든 자리의 미디어 종류·예상 크기·동영상 포스터. ProcessingStartEvent 참고 */
+  onProcessingStart?: (event: ProcessingStartEvent) => void
   /**
    * 갤러리 아래에 첨부 메뉴(갤러리 / 위치 / 파일)를 보여줍니다. 기본 false.
    * 위치 탭: iOS 는 Apple 지도(키 필요 없음), Android 는 Google 지도 — 앱의 AndroidManifest 에
@@ -266,12 +359,29 @@ export interface MapViewerOptions {
   sourceImageUri?: string
   /** 말풍선 이미지 라운드 (dp/pt, 기본 12) */
   sourceCornerRadius?: number
+  /**
+   * 닫기 애니메이션이 "시작"될 때 (durationMs = 닫기 애니메이션 길이). 프로미스는 다 닫힌 뒤에 끝나므로,
+   * 키보드 복귀처럼 닫힘과 동시에 하고 싶은 일은 여기서. Android 는 이 시점에 뷰어 창이 입력 포커스를 내려놓음
+   */
+  onViewerWillClose?: (e: { durationMs: number }) => void
   /** 마커·버튼 색 (기본: setDefaults 의 themeColor) */
   themeColor?: string
   languageCode?: LanguageCode
   appearance?: Appearance
 }
 
+/** 뷰어의 동영상 페이지 정보 (ViewerOptions.videos) */
+export interface ViewerVideo {
+  /** http(s) 또는 file:// */
+  uri: string
+  /** 초. 모르면 생략 (불러온 뒤 채움) */
+  duration?: number
+  /** 절대 경로(file:// 없음). 파일이 있으면 그걸로 재생, 없으면 스트리밍하고 다 받으면 이 경로에 저장 */
+  cacheFile?: string
+  width?: number
+  height?: number
+}
+
 export interface ViewerOptions {
   images: string[]
   placeholderImages?: string[]
@@ -281,6 +391,12 @@ export interface ViewerOptions {
    * (앱이 캐시를 한 곳에서 관리하기 위한 옵션 — 항목이 null/빈 문자열이면 해당 사진은 기존 방식)
    */
   cacheFiles?: (string | null)[]
+  /**
+   * images 와 같은 순서. 항목이 있으면 그 페이지는 동영상 (null/생략 = 사진) — cacheFiles 와 같은 "평행 배열".
+   * 동영상 페이지에서 images[i] 는 포스터(썸네일) 이미지로 쓰입니다 (열기·닫기 애니메이션, 로딩 중 표시).
+   * 지원: iOS 뷰어, Android 는 useOverlayViewer: true 일 때 (그 외 Android 뷰어는 포스터만 보임)
+   */
+  videos?: (ViewerVideo | null)[]
   initialIndex?: number
   themeColor?: string // Added themeColor for Android
   /**
@@ -414,6 +530,14 @@ export interface MediaGalleryItem {
   isMine?: boolean
   width?: number
   height?: number
+  /** 생략 = 'image'. 'video' 면 imageUri/thumbUri 는 포스터, 재생은 videoUri */
+  mediaType?: 'image' | 'video'
+  /** 동영상 원본 (http(s) 또는 file://) */
+  videoUri?: string
+  /** 동영상 캐시 경로 (ViewerVideo.cacheFile 과 같은 의미) */
+  videoCacheFile?: string
+  /** 초 — 그리드 칸의 "▶ 0:12" 배지 */
+  duration?: number
 }
 
 export interface MediaGalleryDeleteOption {
@@ -534,3 +658,52 @@ export interface MediaGalleryRemovePayload {
   galleryId: string
   groupIds: string[]
 }
+
+/**
+ * AI 기능 (갤러리의 AI 생성 · 편집 화면의 AI 편집) 설정과 잔액. `AttachmentKit.setAIConfig` 로 넘기며, 넘긴 값만 바뀝니다.
+ * 앱 서버가 진짜 장부이고 모듈은 화면 표시·사용 가능 판단용 사본을 들고 있습니다.
+ * 사용 순서: 구독자의 남은 무료 횟수(freeCount, 예: 월 30회) → 포인트(points, 1회 costPerUse) → 모자라면 충전 안내(onAIChargeRequired).
+ * 성공한 요청만 차감되고(실패·취소·안전 차단은 무료), 차감할 때마다 onAIUsage 가 옵니다.
+ */
+export interface AIConfig {
+  /** AI 기능 on/off. 기본 false — 꺼져 있으면 갤러리·편집 화면에 AI 버튼이 보이지 않음 */
+  enabled?: boolean
+  /** 현재 포인트 */
+  points?: number
+  /** 구독자의 남은 무료 횟수 (예: 월 30회 중 남은 것 — 기간·횟수는 앱/서버가 정함). 0 보다 크면 포인트보다 먼저 씀 */
+  freeCount?: number
+  /** 1회 차감 포인트. 0 이면 과금 없음 (무제한) */
+  costPerUse?: number
+  /** 화질 옵션 "고화질(1K)" 1회 차감 포인트. 생략/null 이면 costPerUse */
+  highQualityCost?: number | null
+  /** 운영: 앱 서버(프록시) 주소. 모듈이 Gemini generateContent 본문을 이 주소로 보내고 서버가 키를 붙여 전달 (헤더 X-AI-Model = 모델 이름) */
+  endpoint?: string | null
+  /** endpoint 로 보낼 때 붙일 헤더 (예: { Authorization: "Bearer …" }) */
+  headers?: Record<string, string>
+  /** 테스트 전용 Gemini 키 (앱에 넣어 배포하지 말 것). endpoint 가 있으면 무시 */
+  apiKey?: string | null
+}
+
+/** AI 를 한 번 성공적으로 썼을 때 (서버에 차감을 반영하는 데 사용) */
+export interface AIUsageEvent {
+  /** "generate" = 갤러리 AI 생성, "edit" = 편집 화면 AI 편집 */
+  kind: "generate" | "edit"
+  /** 무료 횟수를 썼으면 true (이때 pointsDeducted = 0) */
+  usedFreeCount: boolean
+  /** 이번에 차감한 포인트 */
+  pointsDeducted: number
+  /** 고화질(1K)로 만들었는지 */
+  highQuality: boolean
+  /** 차감 후 모듈이 들고 있는 값 */
+  points: number
+  freeCount: number
+}
+
+/** 포인트가 모자라 사용자가 '충전하기'를 눌렀을 때 (모듈은 AI 화면을 닫음 → 앱이 충전 화면으로 안내) */
+export interface AIChargeRequiredEvent {
+  kind: "generate" | "edit"
+  /** 1회에 필요한 포인트 */
+  required: number
+  points: number
+  freeCount: number
+}