adwhale-sdk-react-native 2.7.204 → 2.7.400

package/src/AdWhaleTransitionPopupAd.ts

@@ -0,0 +1,171 @@
+// src/AdWhaleTransitionPopupAd.ts
+import {
+  NativeEventEmitter,
+  NativeModules,
+  Platform,
+} from 'react-native';
+import type { EmitterSubscription } from 'react-native';
+
+export interface AdWhaleTransitionPopupAdErrorEvent {
+  statusCode: number;
+  message: string;
+}
+
+export interface AdWhaleTransitionPopupAdClosedEvent {
+  reasonId: number;
+  reasonMessage: string;
+}
+
+export interface AdWhaleTransitionPopupAdEvents {
+  onLoaded?: () => void;
+  onLoadFailed?: (event: AdWhaleTransitionPopupAdErrorEvent) => void;
+  onShowed?: () => void;
+  onShowFailed?: (event: AdWhaleTransitionPopupAdErrorEvent) => void;
+  onClicked?: () => void;
+  onClosed?: (event: AdWhaleTransitionPopupAdClosedEvent) => void;
+}
+
+export interface AdWhaleTransitionPopupGcoder {
+  lt: number;
+  lng: number;
+}
+
+interface RNAdWhaleMediationTransitionPopupAdNativeModule {
+  setPlacementName(placementName: string): void;
+  setRegion(region: string): void;
+  setGcoder(gcoder: { lt: number; lng: number }): void;
+  loadAd(placementUid: string): void;
+  showAd(): void;
+  destroy(): void;
+  resume(): void;
+  addListener(eventName: string): void;
+  removeListeners(count: number): void;
+}
+
+const LINKING_ERROR =
+  Platform.OS === 'android'
+    ? 'RNAdWhaleMediationTransitionPopupAd native module is not linked.'
+    : 'Transition Popup Ad is only supported on Android.';
+
+const { RNAdWhaleMediationTransitionPopupAd } = NativeModules as {
+  RNAdWhaleMediationTransitionPopupAd?: RNAdWhaleMediationTransitionPopupAdNativeModule;
+};
+
+const transitionPopupEmitter = RNAdWhaleMediationTransitionPopupAd
+  ? new NativeEventEmitter(RNAdWhaleMediationTransitionPopupAd)
+  : null;
+
+export const AdWhaleTransitionPopupAd = {
+  loadAd(
+    placementUid: string,
+    options?: {
+      placementName?: string;
+      region?: string;
+      gcoder?: AdWhaleTransitionPopupGcoder;
+    }
+  ) {
+    if (!RNAdWhaleMediationTransitionPopupAd) {
+      console.warn(LINKING_ERROR);
+      return;
+    }
+    if (options?.placementName != null) {
+      RNAdWhaleMediationTransitionPopupAd.setPlacementName(options.placementName);
+    }
+    if (options?.region != null) {
+      RNAdWhaleMediationTransitionPopupAd.setRegion(options.region);
+    }
+    if (options?.gcoder) {
+      RNAdWhaleMediationTransitionPopupAd.setGcoder(options.gcoder);
+    }
+    RNAdWhaleMediationTransitionPopupAd.loadAd(placementUid);
+  },
+
+  showAd() {
+    if (!RNAdWhaleMediationTransitionPopupAd) {
+      console.warn(LINKING_ERROR);
+      return;
+    }
+    RNAdWhaleMediationTransitionPopupAd.showAd();
+  },
+
+  destroy() {
+    if (!RNAdWhaleMediationTransitionPopupAd) {
+      console.warn(LINKING_ERROR);
+      return;
+    }
+    RNAdWhaleMediationTransitionPopupAd.destroy();
+  },
+
+  resume() {
+    if (!RNAdWhaleMediationTransitionPopupAd) {
+      console.warn(LINKING_ERROR);
+      return;
+    }
+    RNAdWhaleMediationTransitionPopupAd.resume();
+  },
+
+  addEventListeners(
+    listeners: AdWhaleTransitionPopupAdEvents
+  ): EmitterSubscription[] {
+    if (!transitionPopupEmitter) {
+      console.warn(LINKING_ERROR);
+      return [];
+    }
+    const subs: EmitterSubscription[] = [];
+
+    if (listeners.onLoaded) {
+      subs.push(
+        transitionPopupEmitter.addListener('onTransitionPopupAdLoaded', () => {
+          listeners.onLoaded?.();
+        })
+      );
+    }
+    if (listeners.onLoadFailed) {
+      subs.push(
+        transitionPopupEmitter.addListener(
+          'onTransitionPopupAdLoadFailed',
+          event => {
+            listeners.onLoadFailed?.(
+              event as AdWhaleTransitionPopupAdErrorEvent
+            );
+          }
+        )
+      );
+    }
+    if (listeners.onShowed) {
+      subs.push(
+        transitionPopupEmitter.addListener('onTransitionPopupAdShowed', () => {
+          listeners.onShowed?.();
+        })
+      );
+    }
+    if (listeners.onShowFailed) {
+      subs.push(
+        transitionPopupEmitter.addListener(
+          'onTransitionPopupAdShowFailed',
+          event => {
+            listeners.onShowFailed?.(
+              event as AdWhaleTransitionPopupAdErrorEvent
+            );
+          }
+        )
+      );
+    }
+    if (listeners.onClicked) {
+      subs.push(
+        transitionPopupEmitter.addListener('onTransitionPopupAdClicked', () => {
+          listeners.onClicked?.();
+        })
+      );
+    }
+    if (listeners.onClosed) {
+      subs.push(
+        transitionPopupEmitter.addListener('onTransitionPopupAdClosed', event => {
+          listeners.onClosed?.(event as AdWhaleTransitionPopupAdClosedEvent);
+        })
+      );
+    }
+
+    return subs;
+  },
+};

package/src/NativeAdwhaleSdkReactNative.ts

@@ -1,18 +1,32 @@
 import { TurboModuleRegistry, type TurboModule } from 'react-native';
 
+/**
+ * Flutter `AdWhaleInitResult` / 네이티브 초기화 성공 맵과 동일: `statusCode`, `message` 만.
+ * 성공 여부는 `statusCode === 100` (Flutter 와 동일).
+ * TurboModule codegen 은 메서드명 `initialize` 를 사용합니다 (Flutter MethodChannel 은 `_init`).
+ */
 export interface InitializeResult {
   statusCode: number;
   message: string;
-  isSuccess: boolean;
+}
+
+/** Flutter GDPR `requestGdprConsent` 응답 맵: `success`, `message` */
+export interface GdprConsentResult {
+  success: boolean;
+  message: string;
+}
+
+/** Ad Inspector 닫힘 콜백과 동일한 status/message (Flutter 와 키 정렬) */
+export interface AdInspectorResult {
+  statusCode: number;
+  message: string;
 }
 
 export interface Spec extends TurboModule {
+  /** RN codegen Java `initialize(Promise)` — Flutter MethodChannel 은 `_init` */
   initialize(): Promise<InitializeResult>;
   setCoppa(isEnabled: boolean): void;
-  requestGdprConsent(): Promise<{
-    isSuccess: boolean;
-    message: string;
-  }>;
+  requestGdprConsent(): Promise<GdprConsentResult>;
   getConsentStatus(): Promise<{
     coppa: boolean;
     gdpr: string;
@@ -20,6 +34,16 @@ export interface Spec extends TurboModule {
   }>;
   resetGdprConsentStatus(): void;
   setGdpr(consent: boolean): void;
+  setTagForUnderAgeOfConsent(tag: boolean): void;
+  setMaxAdContentRating(rating: string | null): void;
+  setTestDeviceIdentifiers(testDeviceIds: string[] | null): void;
+  showAdInspector(): Promise<AdInspectorResult>;
+  setAppMuted(isMuted: boolean): void;
+  setAppVolume(volume: number): void;
 }
 
-export default TurboModuleRegistry.getEnforcing<Spec>('AdwhaleSdkReactNative');
+/**
+ * iOS/Android 네이티브에 모듈이 없거나 링크되지 않은 경우 null.
+ * (getEnforcing 는 로드 시점에 앱 전체가 크래시하므로 get 사용)
+ */
+export default TurboModuleRegistry.get<Spec>('AdwhaleSdkReactNative');

package/src/constants/AdWhaleMethodArgConst.ts

@@ -0,0 +1,50 @@
+/**
+ * Flutter `lib/src/flutter_method_arg_const.dart` / Android `FlutterMethodArgConst` 와
+ * 동일한 키 문자열을 유지합니다. RN 전용 키는 주석으로 표시합니다.
+ */
+export const AdWhaleMethodArgConst = {
+  sendStatusCode: 'statusCode',
+  sendMessage: 'message',
+  /** Flutter GDPR 등 */
+  sendSuccess: 'success',
+  /** RN 레거시 — init/showAdInspector 는 `sendStatusCode`(100) 로 성공 판별 */
+  sendIsSuccess: 'isSuccess',
+  sendCode: 'code',
+  sendEventName: 'eventName',
+  sendErrorMessage: 'errorMessage',
+  sendErrorCode: 'errorCode',
+  sendRewardAmount: 'RewardAmount',
+  sendRewardType: 'RewardType',
+  sendHeightPx: 'heightPx',
+  sendReason: 'reason',
+  receiveAdId: 'adId',
+  receivePlacementUid: 'placementUid',
+  receiveRating: 'rating',
+  receiveHasConsent: 'hasConsent',
+  receiveValue: 'value',
+  receiveTfuaMode: 'tfuaMode',
+  receiveIds: 'ids',
+  receiveRequestId: 'requestId',
+  receiveIsChildDirected: 'isChildDirected',
+  receiveEnabled: 'enabled',
+  receiveIsMuted: 'isMuted',
+  receivedVolume: 'volume',
+  receiveRegion: 'region',
+  receiveGcoder: 'gcoder',
+  receiveLt: 'lt',
+  receiveLng: 'lng',
+  receivePlacementName: 'placementName',
+  receivePrimaryButtonText: 'primaryButtonText',
+  receiveSecondaryButtonText: 'secondaryButtonText',
+  receiveCustomDescription: 'customDescription',
+  receiveOptions: 'options',
+  receiveAdaptiveAnchorWidth: 'adaptiveAnchorWidth',
+  receiveAndroidPlacementUid: 'androidPlacementUid',
+  receiveBannerHeight: 'bannerHeight',
+  receiveNativeAdOptions: 'nativeAdOptions',
+  receiveTemplateStyle: 'templateStyle',
+  sendCoppa: 'coppa',
+  sendGdpr: 'gdpr',
+  sendPersonalizedConsent: 'personalizedConsent',
+  sendRegistrationName: 'registrationName',
+} as const;

package/src/constants/AdWhaleMethodCallConst.ts

@@ -0,0 +1,60 @@
+/**
+ * Flutter `lib/src/flutter_method_call_const.dart` 와 동일한 메서드·이벤트 이름.
+ * RN ViewManager 전용 prop 은 주석으로 구분합니다.
+ */
+export const AdWhaleMethodCallConst = {
+  // 글로벌 (TurboModule)
+  /** RN TurboModule codegen — Java {@code initialize(Promise)} */
+  initialize: 'initialize',
+  /** Flutter MethodChannel 전용 (TurboModule 과 다름) */
+  flutterInit: '_init',
+  requestGdprConsent: 'requestGdprConsent',
+  resetGdprConsentStatus: 'resetGdprConsentStatus',
+  setGdpr: 'setGdpr',
+  getConsentStatus: 'getConsentStatus',
+  setTagForUnderAgeOfConsent: 'setTagForUnderAgeOfConsent',
+  setMaxAdContentRating: 'setMaxAdContentRating',
+  setTestDeviceIdentifiers: 'setTestDeviceIdentifiers',
+  showAdInspector: 'showAdInspector',
+  setCoppa: 'setCoppa',
+  setLoggerEnabled: 'setLoggerEnabled',
+  getLogLevel: 'getLogLevel',
+  setAppMuted: 'setAppMuted',
+  setAppVolume: 'setAppVolume',
+
+  // Flutter: adId 기반 배너 (RN 에는 추후 TurboModule 로 대응 가능)
+  loadBannerAd: 'loadBannerAd',
+  resumeBannerAd: 'resumeBannerAd',
+  pauseBannerAd: 'pauseBannerAd',
+  destroyBannerAd: 'destroyBannerAd',
+
+  /** RN Android 에는 아직 네이티브 구현 없음 — 상수만 동기화 */
+  loadPreloadBannerAd: 'loadPreloadBannerAd',
+  showPreloadBannerAd: 'showPreloadBannerAd',
+  resumePreloadBannerAd: 'resumePreloadBannerAd',
+  pausePreloadBannerAd: 'pausePreloadBannerAd',
+  destroyPreloadBannerAd: 'destroyPreloadBannerAd',
+
+  /** RN 배너 View — Flutter loadBannerAd 와 역할 유사한 prop */
+  loadAd: 'loadAd',
+  showAd: 'showAd',
+  placementUid: 'placementUid',
+  adSize: 'adSize',
+  factoryId: 'factoryId',
+
+  onAdInspectorClosed: 'onAdInspectorClosed',
+  onInitComplete: 'onInitComplete',
+  onAdLoaded: 'onAdLoaded',
+  onAdLoadFailed: 'onAdLoadFailed',
+  onAdFailedToLoad: 'onAdFailedToLoad',
+  onAdClicked: 'onAdClicked',
+
+  onNativeAdLoaded: 'onNativeAdLoaded',
+  onNativeAdFailedToLoad: 'onNativeAdFailedToLoad',
+  onNativeAdShowFailed: 'onNativeAdShowFailed',
+  onNativeAdClicked: 'onNativeAdClicked',
+  onNativeAdClosed: 'onNativeAdClosed',
+  onNativeAdViewHeight: 'onNativeAdViewHeight',
+} as const;
+
+export type AdWhaleMethodCallConstKey = keyof typeof AdWhaleMethodCallConst;

package/src/constants/AdWhaleMethodResultConst.ts

@@ -0,0 +1,13 @@
+/**
+ * Flutter `FlutterMethodResultConst` 와 동일한 Promise.reject / result.error 코드 문자열.
+ */
+export const AdWhaleMethodResultConst = {
+  noActivity: 'NoActivity',
+  invalidArgs: 'InvalidArgs',
+  nativeAdError: 'NativeAdError',
+  preloadBannerError: 'PreloadBannerError',
+  bannerAdError: 'BannerAdError',
+  adShowError: 'AdShowError',
+  openInspectorFailed: 'OpenInspectorFailed',
+  getLogLevelError: 'GetLogLevelError',
+} as const;

package/src/index.ts

@@ -2,6 +2,11 @@
 
 // ✅ 1) SDK 초기화 / 설정 (TurboModule 래퍼)
 export { AdWhaleMediationAds } from './AdWhaleMediationAds';
+export type {
+  InitializeResult,
+  GdprConsentResult,
+  AdInspectorResult,
+} from './AdWhaleMediationAds';
 // 사용 예:
 //   AdWhaleMediationAds.initialize()
 //   AdWhaleMediationAds.setLoggerEnabled(true)
@@ -11,11 +16,20 @@ export { AdWhaleMediationAds } from './AdWhaleMediationAds';
 //   AdWhaleMediationAds.resetGdprConsentStatus()
 //   AdWhaleMediationAds.setGdpr(true)
 
+// Flutter 브릿지 상수와 동일 문자열 유지 (유지보수 시 Flutter 저장소와 대조)
+export {
+  AdWhaleMethodCallConst,
+  type AdWhaleMethodCallConstKey,
+} from './constants/AdWhaleMethodCallConst';
+export { AdWhaleMethodArgConst } from './constants/AdWhaleMethodArgConst';
+export { AdWhaleMethodResultConst } from './constants/AdWhaleMethodResultConst';
 
 // ✅ 2) 배너 광고 View 컴포넌트
 export {
   AdWhaleAdView,
   AdWhaleAdSize,
+  ADWHALE_BANNER_IOS_UNSUPPORTED_STATUS_CODE,
+  isAdWhaleBannerAdSizeSupportedOnIos,
 } from './AdWhaleAdView';
 export type {
   AdWhaleBannerError,
@@ -41,6 +55,8 @@ export type {
   AdWhaleRewardErrorEvent,
   AdWhaleRewardUserRewardedEvent,
   AdWhaleRewardEvents,
+  AdWhaleRewardGcoder,
+  AdWhaleRewardLoadOptions,
 } from './AdWhaleRewardAd';
 
 
@@ -54,6 +70,25 @@ export type {
 } from './AdWhaleAppOpenAd';
 
 
+// ✅ 5.1) 종료 팝업 광고 API (Android)
+export { AdWhaleExitPopupAd } from './AdWhaleExitPopupAd';
+export type {
+  AdWhaleExitPopupAdClosedEvent,
+  AdWhaleExitPopupAdErrorEvent,
+  AdWhaleExitPopupAdEvents,
+  AdWhaleExitPopupGcoder,
+} from './AdWhaleExitPopupAd';
+
+// ✅ 5.2) 앱 전환 팝업 광고 API (Android)
+export { AdWhaleTransitionPopupAd } from './AdWhaleTransitionPopupAd';
+export type {
+  AdWhaleTransitionPopupAdClosedEvent,
+  AdWhaleTransitionPopupAdErrorEvent,
+  AdWhaleTransitionPopupAdEvents,
+  AdWhaleTransitionPopupGcoder,
+} from './AdWhaleTransitionPopupAd';
+
+
 // ✅ 6) 네이티브 커스텀 뷰 (네이티브 템플릿/커스텀용)
 export {
   AdWhaleNativeCustomView,