react-native-attachment-kit 1.0.2 → 1.0.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-attachment-kit",
-  "version": "1.0.2",
+  "version": "1.0.6",
   "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",

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;
@@ -16,6 +18,19 @@ export interface Spec extends TurboModule {
   
   getDefaultAnimationConfig(): Promise<Object>;
 
+  // 지도 뷰어 (위치 메시지)
+  openMapViewer(options: Object): Promise<void>;
+  updateMapViewerSourceRect(rect: Object): Promise<void>;
+  // 위치 메시지 지도 썸네일 (이 기기에서 그려 캐시)
+  renderLocationThumbnail(options: Object): Promise<Object>;
+  clearLocationThumbnailCache(): Promise<void>;
+  // 좌표 → 주소 (기기 지오코더, 디스크 캐시)
+  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.d.ts

@@ -1,56 +1,5 @@
-export interface ImageResult {
-  uri: string
-  width: number
-  height: number
-  type: string
-}
-
-export interface GalleryOptions {
-  maxSelection?: number
-  mediaType?: "photo" | "video" | "all"
-  quality?: number
-  allItemsText?: string
-  selectedItemsText?: string
-  doneButtonText?: string
-  recentsAlbumText?: string
-  languageCode?: string
-  autoCloseOnSelect?: boolean
-  /**
-   * 선택 방식.
-   * - 'single': 한 장 즉시 선택형 (기존 maxSelection 0/1 동작 — 탭하면 바로 반환, 편집 ON 이면 탭 → 편집 → 전송)
-   * - 'multi' : 체크(번호 배지) → (필요하면 편집) → 완료. maxSelection 이 1 이어도 멀티와 똑같이 동작하고,
-   *             1장일 때 다른 사진을 고르면 기존 선택과 교체됩니다. autoCloseOnSelect 는 무시되며 maxSelection 생략/1 미만이면 1장.
-   * 생략 시 기존 규칙으로 판단: autoCloseOnSelect 또는 maxSelection <= 1 → 단일, 그 외 멀티 (하위 호환)
-   */
-  selectionMode?: "single" | "multi"
-  enableEditor?: boolean // 단일 이미지 선택 시 편집기 활성화 여부
-  themeColor?: string // 테마 컬러 지정 (ex: "#FFEB3B")
-  onSelectionChange?: (event: SelectionChangeEvent) => void
-}
-
-export interface SelectionChangeEvent {
-  selectedCount: number
-  maxSelection: number
-}
-
-export interface RNAttachmentKit {
-  init(licenseKey: string): Promise<boolean>;
-  openGallery(options?: GalleryOptions): Promise<ImageResult[]>;
-  openEditor(options: EditorOptions): Promise<ImageResult>;
-  closeGallery(): Promise<boolean>
-  addSelectionChangeListener(listener: (event: SelectionChangeEvent) => void): () => void
-}
-
-/**
- * Returns true if using Turbo Module (New Architecture)
- */
-export const isUsingTurboModule: boolean
-
-/**
- * Returns true if using Legacy Native Module (Old Architecture)
- */
-export const isUsingLegacyModule: boolean
-
-declare const AttachmentKit: RNAttachmentKit
-
-export default AttachmentKit
+// package.json 의 "types" 는 src/index.ts 를 가리키므로 이 파일은 소비자에게 쓰이지 않습니다.
+// 예전엔 손으로 관리하던 복사본이 index.ts / types.ts 와 어긋나 있었기 때문에, 이제는 실제 export 를 그대로 재노출만 합니다.
+export * from "./types"
+export { default } from "./index"
+export * from "./index"

package/src/index.ts

@@ -1,5 +1,5 @@
-import { NativeModules, Platform, TurboModuleRegistry, NativeEventEmitter } from "react-native"
-import type { ImageResult, GalleryOptions, EditorOptions, SelectionChangeEvent, ViewerOptions, MediaGalleryOptions, MediaGalleryAppendPayload, MediaGalleryRemovePayload, Appearance } from "./types"
+import { NativeModules, Platform, TurboModuleRegistry, NativeEventEmitter, DeviceEventEmitter } from "react-native"
+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"
 
@@ -15,6 +15,8 @@ try {
 
 let _defaultThemeColor = "#10b981";
 let _defaultLanguageCode = "en";
+/** setDefaults/init 에 넘긴 언어 코드 그대로 (예: "zh-Hans", "pt-BR") — 주소(역지오코딩)는 UI 언어 목록으로 줄이지 않음 */
+let _rawLanguageCode: string | null = null;
 let _defaultAppearance: Appearance = "system";
 
 /** "light" | "dark" 외의 값(생략·오타 포함)은 "system" */
@@ -64,7 +66,31 @@ if (!RNAttachmentKitModule) {
 // Create event emitter
 const eventEmitter = new NativeEventEmitter(RNAttachmentKitModule)
 
-export type { SelectionChangeEvent, Appearance } from "./types"
+/** 같은 화면을 중복으로 열려고 할 때 reject 하는 Error (code: "E_ALREADY_OPEN") */
+function alreadyOpenError(what: string): Error {
+  const err = new Error(`${what} is already open`)
+  ;(err as any).code = "E_ALREADY_OPEN"
+  return err
+}
+
+/**
+ * openGallery 가 아직 끝나지 않았는지. 네이티브는 갤러리 Promise 를 하나만 보관하므로(iOS currentGalleryVC,
+ * Android pickImagesPromise) 중복 호출하면 앞 호출의 Promise 가 영영 끝나지 않습니다 → JS 에서 먼저 막습니다.
+ */
+let _galleryOpen = false
+/** 어느 openGallery 호출이 _galleryOpen 을 잡고 있는지 — 처리 시작(onProcessingStart)에 먼저 풀고, 늦게 끝난 앞 호출이 새 호출의 잠금을 풀지 않게 */
+let _galleryOpenToken = 0
+/** openEditor 도 Android 가 editImagePromise 하나만 보관하므로 같은 보호가 필요 */
+let _editorOpen = false
+/**
+ * asyncProcessing 모드의 onImageProcessed 구독. 이 모드에선 openGallery 가 끝난 뒤에도 이벤트가 오므로
+ * finally 에서 제거하지 않고, 다음 openGallery(asyncProcessing) 호출 때 이전 구독만 제거합니다 (최대 1개 유지).
+ */
+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"
 
 export interface RNAttachmentKit {
@@ -77,7 +103,39 @@ export interface RNAttachmentKit {
   openEditor(options: EditorOptions): Promise<ImageResult>
   openViewer(options: ViewerOptions): Promise<void>
   updateSourceRect(rect: import("./types").SourceRect): Promise<void>
+  /** 지도 뷰어. 닫히면 resolve */
+  openMapViewer(options: import("./types").MapViewerOptions): Promise<void>
+  /** 지도 뷰어가 열린 동안 말풍선 위치가 바뀌었을 때 (닫힐 때 돌아갈 자리) */
+  updateMapViewerSourceRect(rect: import("./types").SourceRect | null): Promise<void>
+  /** 위치 메시지 말풍선 지도 썸네일을 이 기기에서 그려 캐시 (같은 요청이면 캐시에서 바로) */
+  renderLocationThumbnail(options: import("./types").LocationThumbnailOptions): Promise<import("./types").LocationThumbnailResult>
+  /** renderLocationThumbnail 캐시 비우기 */
+  clearLocationThumbnailCache(): Promise<void>
+  /**
+   * 좌표 → 주소 (기기 지오코더, 무료). 언어는 languageCode 그대로 (생략하면 setDefaults 의 languageCode).
+   * 결과("결과 없음" 포함)는 디스크에 캐시. 오류는 ReverseGeocodeErrorCode 로 reject (캐시 안 함)
+   */
+  reverseGeocode(options: import("./types").ReverseGeocodeOptions): Promise<import("./types").ReverseGeocodeResult>
+  /** 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>
@@ -99,6 +157,7 @@ const AttachmentKit: RNAttachmentKit = {
     }
     if (options?.languageCode) {
       _defaultLanguageCode = normalizeLanguageCode(options.languageCode);
+      _rawLanguageCode = options.languageCode;
     }
     if (options?.appearance) {
       _defaultAppearance = normalizeAppearance(options.appearance);
@@ -111,7 +170,10 @@ const AttachmentKit: RNAttachmentKit = {
 
   setDefaults: (options: DefaultOptions): void => {
     if (options?.themeColor) _defaultThemeColor = options.themeColor
-    if (options?.languageCode) _defaultLanguageCode = normalizeLanguageCode(options.languageCode)
+    if (options?.languageCode) {
+      _defaultLanguageCode = normalizeLanguageCode(options.languageCode)
+      _rawLanguageCode = options.languageCode
+    }
     if (options?.appearance) _defaultAppearance = normalizeAppearance(options.appearance)
   },
 
@@ -121,36 +183,115 @@ const AttachmentKit: RNAttachmentKit = {
     if (!RNAttachmentKitModule) {
       throw new Error(LINKING_ERROR)
     }
+    // 이미 열려 있으면 네이티브를 건드리지 않고 바로 reject (앞 호출의 Promise 를 지키기 위해)
+    if (_galleryOpen) {
+      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
     let subscriptionImgProcessed: any = null
-    
+
     if (options.onSelectionChange) {
       subscriptionSelChange = eventEmitter.addListener("onSelectionChange", options.onSelectionChange)
     }
     if (options.onImageProcessed) {
-      subscriptionImgProcessed = eventEmitter.addListener("onImageProcessed", options.onImageProcessed)
+      if (options.asyncProcessing) {
+        // async 모드: 이전 호출이 남겨 둔 구독을 먼저 제거해서 리스너가 쌓이지 않게 함
+        if (_asyncImgProcessedSub) {
+          try { _asyncImgProcessedSub.remove() } catch (e) { /* noop */ }
+          _asyncImgProcessedSub = null
+        }
+        subscriptionImgProcessed = eventEmitter.addListener("onImageProcessed", mine(options.onImageProcessed)!)
+        _asyncImgProcessedSub = subscriptionImgProcessed
+      } else {
+        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
+      // failed: 복사에 실패한 파일 목록 [{ name, error }] (없으면 undefined)
+      subscriptionFiles = eventEmitter.addListener("onFilesSelected", (e: any) => onFiles(e?.files ?? [], e?.failed ?? undefined))
     }
 
     try {
       // 이벤트 콜백은 네이티브로 전달하지 않음
-      const { onSelectionChange, onImageProcessed, ...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 {
+      // 처리 시작 때 이미 풀었고 그 뒤 새 호출이 잡았을 수 있음 → 내 잠금일 때만
+      if (_galleryOpenToken === myToken) _galleryOpen = false
+      subscriptionOpenLock.remove()
       // 갤러리가 닫히면 onSelectionChange 리스너 제거
       if (subscriptionSelChange) {
         subscriptionSelChange.remove()
       }
+      // 위치 이벤트는 openGallery 가 끝나기 전에 오므로 여기서 바로 제거
+      if (subscriptionLocation) {
+        subscriptionLocation.remove()
+      }
+      if (subscriptionFiles) {
+        subscriptionFiles.remove()
+      }
+      if (subscriptionVideoProgress) {
+        subscriptionVideoProgress.remove()
+      }
+      if (subscriptionProcessingStart) {
+        subscriptionProcessingStart.remove()
+      }
       // asyncProcessing 모드가 아닐 때만 onImageProcessed 리스너 제거 (async 모드에선 백그라운드 처리를 위해 유지해야 함)
       // 호출부에서 수동으로 제거하거나, 최종 완료 시 정리하는 구조가 필요할 수 있음
       if (!options.asyncProcessing && subscriptionImgProcessed) {
@@ -163,6 +304,11 @@ const AttachmentKit: RNAttachmentKit = {
     if (!RNAttachmentKitModule) {
       throw new Error(LINKING_ERROR)
     }
+    // Android 는 editImagePromise 를 하나만 보관해서 중복 호출 시 앞 Promise 가 끝나지 않음 → JS 에서 막음
+    if (_editorOpen) {
+      throw alreadyOpenError("Editor")
+    }
+    _editorOpen = true
     const mergedOptions = {
       themeColor: _defaultThemeColor,
       languageCode: _defaultLanguageCode,
@@ -171,7 +317,11 @@ const AttachmentKit: RNAttachmentKit = {
     }
     mergedOptions.languageCode = normalizeLanguageCode(mergedOptions.languageCode)
     mergedOptions.appearance = normalizeAppearance(mergedOptions.appearance)
-    return RNAttachmentKitModule.openEditor(mergedOptions)
+    try {
+      return await RNAttachmentKitModule.openEditor(mergedOptions)
+    } finally {
+      _editorOpen = false
+    }
   },
 
   openViewer: async (options: ViewerOptions): Promise<void> => {
@@ -225,34 +375,34 @@ const AttachmentKit: RNAttachmentKit = {
       })
     }
 
-    if (options.onViewerWillClose) {
-      const closeHandler = () => {
-        if (options.onViewerWillClose) {
-          options.onViewerWillClose()
-        }
-        if (subscriptionPageSelected) {
-          subscriptionPageSelected.remove()
-        }
-        if (subscriptionViewerOpened) {
-          subscriptionViewerOpened.remove()
-        }
-        if (subscriptionViewerWillClose) {
-          subscriptionViewerWillClose.remove()
-        }
-        if (deviceSubscriptionViewerWillClose) {
-          deviceSubscriptionViewerWillClose.remove()
-        }
-        if (subscriptionImageDeleted) {
-          subscriptionImageDeleted.remove()
-        }
-      };
+    // 네이티브 "onViewerWillClose"(iOS sendEvent / Android RCTDeviceEventEmitter) 는 앱이 콜백을 넘기지 않아도
+    // 항상 구독합니다 — 이 이벤트가 와야 onPageSelected / onImageDeleted 구독을 정리할 수 있기 때문입니다
+    // (예전엔 options.onViewerWillClose 가 없으면 구독을 안 해서 뷰어를 열 때마다 리스너가 누수됐음).
+    const closeHandler = () => {
+      if (options.onViewerWillClose) {
+        options.onViewerWillClose()
+      }
+      if (subscriptionPageSelected) {
+        subscriptionPageSelected.remove()
+      }
+      if (subscriptionViewerOpened) {
+        subscriptionViewerOpened.remove()
+      }
+      if (subscriptionViewerWillClose) {
+        subscriptionViewerWillClose.remove()
+      }
+      if (deviceSubscriptionViewerWillClose) {
+        deviceSubscriptionViewerWillClose.remove()
+      }
+      if (subscriptionImageDeleted) {
+        subscriptionImageDeleted.remove()
+      }
+    };
 
-      subscriptionViewerWillClose = eventEmitter.addListener("onViewerWillClose", closeHandler);
+    subscriptionViewerWillClose = eventEmitter.addListener("onViewerWillClose", closeHandler);
 
-      if (Platform.OS === "android") {
-        const { DeviceEventEmitter } = require("react-native");
-        deviceSubscriptionViewerWillClose = DeviceEventEmitter.addListener("onViewerWillClose", closeHandler);
-      }
+    if (Platform.OS === "android") {
+      deviceSubscriptionViewerWillClose = DeviceEventEmitter.addListener("onViewerWillClose", closeHandler);
     }
 
     try {
@@ -266,9 +416,14 @@ const AttachmentKit: RNAttachmentKit = {
       mergedOptions.languageCode = normalizeLanguageCode(mergedOptions.languageCode)
       mergedOptions.appearance = normalizeAppearance(mergedOptions.appearance)
       return await RNAttachmentKitModule.openViewer(mergedOptions)
-    } finally {
-      // Listeners are now removed inside the onViewerWillClose callback
+    } catch (e) {
+      // 뷰어가 아예 안 떴으면(reject) onViewerWillClose 가 오지 않으므로 여기서 구독 정리 (앱 콜백은 호출 안 함)
+      for (const sub of [subscriptionPageSelected, subscriptionViewerOpened, subscriptionImageDeleted, subscriptionViewerWillClose, deviceSubscriptionViewerWillClose]) {
+        try { sub?.remove() } catch (err) { /* noop */ }
+      }
+      throw e
     }
+    // 정상적으로 열렸으면 리스너는 onViewerWillClose 콜백 안에서 제거됨
   },
 
   updateSourceRect: async (rect: import("./types").SourceRect): Promise<void> => {
@@ -278,6 +433,86 @@ const AttachmentKit: RNAttachmentKit = {
     return RNAttachmentKitModule.updateSourceRect(rect)
   },
 
+  openMapViewer: async (options: import("./types").MapViewerOptions): Promise<void> => {
+    if (!RNAttachmentKitModule) {
+      throw new Error(LINKING_ERROR)
+    }
+    const mergedOptions: Record<string, any> = {
+      themeColor: _defaultThemeColor,
+      languageCode: _defaultLanguageCode,
+      appearance: _defaultAppearance,
+      ...options,
+    }
+    // 주소를 안 넘기면 네이티브가 채움 — reverseGeocode 와 같은 캐시를 쓰도록 같은 언어(넘긴 그대로)
+    mergedOptions.addressLanguageCode = options.languageCode || _rawLanguageCode || _defaultLanguageCode
+    mergedOptions.languageCode = normalizeLanguageCode(mergedOptions.languageCode)
+    mergedOptions.appearance = normalizeAppearance(mergedOptions.appearance)
+    // 함수는 네이티브로 못 넘김 — 닫기 시작은 이벤트로 받음 (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> => {
+    if (!RNAttachmentKitModule) {
+      throw new Error(LINKING_ERROR)
+    }
+    return RNAttachmentKitModule.updateMapViewerSourceRect(rect ?? {})
+  },
+
+  renderLocationThumbnail: async (options: import("./types").LocationThumbnailOptions): Promise<import("./types").LocationThumbnailResult> => {
+    if (!RNAttachmentKitModule) {
+      throw new Error(LINKING_ERROR)
+    }
+    const mergedOptions = {
+      themeColor: _defaultThemeColor,
+      appearance: _defaultAppearance,
+      ...options,
+    }
+    mergedOptions.appearance = normalizeAppearance(mergedOptions.appearance)
+    // 내 위치는 둘 다 있을 때만
+    if (typeof mergedOptions.myLatitude !== "number" || typeof mergedOptions.myLongitude !== "number") {
+      delete mergedOptions.myLatitude
+      delete mergedOptions.myLongitude
+    }
+    return RNAttachmentKitModule.renderLocationThumbnail(mergedOptions)
+  },
+
+  clearLocationThumbnailCache: async (): Promise<void> => {
+    if (!RNAttachmentKitModule) {
+      throw new Error(LINKING_ERROR)
+    }
+    return RNAttachmentKitModule.clearLocationThumbnailCache()
+  },
+
+  reverseGeocode: async (options: import("./types").ReverseGeocodeOptions): Promise<import("./types").ReverseGeocodeResult> => {
+    if (!RNAttachmentKitModule) {
+      throw new Error(LINKING_ERROR)
+    }
+    const languageCode = options.languageCode || _rawLanguageCode || _defaultLanguageCode
+    const r = await RNAttachmentKitModule.reverseGeocode({ latitude: options.latitude, longitude: options.longitude, languageCode })
+    return { address: r?.address ?? null, shortAddress: r?.shortAddress ?? null, cached: !!r?.cached }
+  },
+
+  clearReverseGeocodeCache: async (): Promise<void> => {
+    if (!RNAttachmentKitModule) {
+      throw new Error(LINKING_ERROR)
+    }
+    return RNAttachmentKitModule.clearReverseGeocodeCache()
+  },
+
   closeGallery: async (): Promise<boolean> => {
     if (!RNAttachmentKitModule) {
       throw new Error(LINKING_ERROR)
@@ -286,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)