adwhale-sdk-react-native 2.7.204 → 2.7.400

package/lib/typescript/src/AdWhaleRewardAd.d.ts

@@ -4,8 +4,14 @@ export interface AdWhaleRewardErrorEvent {
     message: string;
 }
 export interface AdWhaleRewardUserRewardedEvent {
-    type: string;
-    amount: number;
+    /** Flutter payload key */
+    RewardType?: string;
+    /** Flutter payload key */
+    RewardAmount?: number;
+    /** 레거시 호환 */
+    type?: string;
+    /** 레거시 호환 */
+    amount?: number;
 }
 export interface AdWhaleRewardEvents {
     onLoaded?: () => void;
@@ -20,13 +26,64 @@ export interface AdWhaleRewardGcoder {
     lt: number;
     lng: number;
 }
+/**
+ * 보상형 광고 로드 시 함께 지정할 수 있는 옵션.
+ * placementName / region / gcoder 는 기존 옵션이며,
+ * userId / customData 는 보상형 SSV(서버 사이드 검증) 전용 옵션입니다.
+ */
+export interface AdWhaleRewardLoadOptions {
+    placementName?: string;
+    region?: string;
+    gcoder?: AdWhaleRewardGcoder;
+    /**
+     * 보상형 SSV(서버 사이드 검증)용 앱 사용자 id.
+     * AdMob / AdManager SSV postback 의 user_id 로 전달됩니다.
+     * (그 외 네트워크에서는 무시됩니다.)
+     */
+    userId?: string;
+    /**
+     * 보상형 SSV(서버 사이드 검증)용 커스텀 데이터.
+     * AdMob / AdManager SSV postback 의 custom_data 로 전달되며,
+     * 네이티브에서 JSON 문자열로 직렬화되어 실립니다.
+     * (그 외 네트워크에서는 무시됩니다.)
+     */
+    customData?: {
+        [key: string]: string;
+    };
+}
 export declare const AdWhaleRewardAd: {
-    loadAd(placementUid: string, options?: {
-        placementName?: string;
-        region?: string;
-        gcoder?: AdWhaleRewardGcoder;
+    /**
+     * 보상형 SSV(서버 사이드 검증)용 앱 사용자 id 설정.
+     *
+     * - AdMob / AdManager 의 SSV postback `user_id` 로 전달됩니다. 그 외 네트워크에서는 무시(no-op)됩니다.
+     * - `loadAd()` 호출 전에 설정하는 것을 권장하며, `showAd()` 이전까지 호출할 수 있습니다.
+     * - 여러 번 호출하면 마지막 값이 적용됩니다.
+     *
+     * 참고: `loadAd(placementUid, { userId })` 옵션으로도 동일하게 지정할 수 있습니다.
+     */
+    setUserId(userId: string): void;
+    /**
+     * 보상형 SSV(서버 사이드 검증)용 커스텀 데이터 설정.
+     *
+     * - AdMob / AdManager 의 SSV postback `custom_data` 로 전달됩니다. 그 외 네트워크에서는 무시(no-op)됩니다.
+     * - 전달한 객체는 네이티브에서 JSON 문자열로 직렬화되어 단일 문자열 필드에 실립니다.
+     *   퍼블리셔 서버는 postback 의 `custom_data` 값을 JSON 으로 파싱해야 합니다.
+     * - AdMob 의 `custom_data` 는 실무상 200자 정도를 넘기면 잘릴 수 있으니 길이에 유의하세요.
+     * - `loadAd()` 호출 전에 설정하는 것을 권장하며, `showAd()` 이전까지 호출할 수 있습니다.
+     *
+     * 참고: `loadAd(placementUid, { customData })` 옵션으로도 동일하게 지정할 수 있습니다.
+     */
+    setCustomData(customData: {
+        [key: string]: string;
     }): void;
+    loadAd(placementUid: string, options?: AdWhaleRewardLoadOptions): void;
     showAd(): void;
+    /** Flutter와 동일한 신규 API (권장) */
+    loadRewardAd(adId: number, placementUid: string, options?: AdWhaleRewardLoadOptions): void;
+    showAdWithoutView(adId: number): void;
+    destroyAd(adId: number): void;
     addEventListeners(listeners: AdWhaleRewardEvents): EmitterSubscription[];
+    /** Flutter `onAdEvent` 스타일 (adId 필터링) */
+    addAdEventListenersById(adId: number, listeners: AdWhaleRewardEvents): EmitterSubscription[];
 };
 //# sourceMappingURL=AdWhaleRewardAd.d.ts.map

package/lib/typescript/src/AdWhaleRewardAd.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AdWhaleRewardAd.d.ts","sourceRoot":"","sources":["../../../src/AdWhaleRewardAd.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAExD,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,8BAA8B;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,uBAAuB,KAAK,IAAI,CAAC;IACxD,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,uBAAuB,KAAK,IAAI,CAAC;IACxD,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,8BAA8B,KAAK,IAAI,CAAC;CAClE;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;CACb;AAkBD,eAAO,MAAM,eAAe;yBAEV,MAAM,YACV;QACR,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,mBAAmB,CAAC;KAC9B;;iCAoB0B,mBAAmB,GAAG,mBAAmB,EAAE;CA2DzE,CAAC"}
+{"version":3,"file":"AdWhaleRewardAd.d.ts","sourceRoot":"","sources":["../../../src/AdWhaleRewardAd.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAExD,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,8BAA8B;IAC7C,0BAA0B;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0BAA0B;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,uBAAuB,KAAK,IAAI,CAAC;IACxD,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,uBAAuB,KAAK,IAAI,CAAC;IACxD,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,8BAA8B,KAAK,IAAI,CAAC;CAClE;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,UAAU,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;CACxC;AAoCD,eAAO,MAAM,eAAe;IAC1B;;;;;;;;OAQG;sBACe,MAAM;IAQxB;;;;;;;;;;OAUG;8BACuB;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE;yBAQ9B,MAAM,YAAY,wBAAwB;;IA+D/D,+BAA+B;uBAEvB,MAAM,gBACE,MAAM,YACV,wBAAwB;4BAqBZ,MAAM;oBAYd,MAAM;iCAIO,mBAAmB,GAAG,mBAAmB,EAAE;IAmGxE,yCAAyC;kCAEjC,MAAM,aACD,mBAAmB,GAC7B,mBAAmB,EAAE;CA4DzB,CAAC"}

package/lib/typescript/src/AdWhaleTransitionPopupAd.d.ts

@@ -0,0 +1,33 @@
+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;
+}
+export declare const AdWhaleTransitionPopupAd: {
+    loadAd(placementUid: string, options?: {
+        placementName?: string;
+        region?: string;
+        gcoder?: AdWhaleTransitionPopupGcoder;
+    }): void;
+    showAd(): void;
+    destroy(): void;
+    resume(): void;
+    addEventListeners(listeners: AdWhaleTransitionPopupAdEvents): EmitterSubscription[];
+};
+//# sourceMappingURL=AdWhaleTransitionPopupAd.d.ts.map

package/lib/typescript/src/AdWhaleTransitionPopupAd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AdWhaleTransitionPopupAd.d.ts","sourceRoot":"","sources":["../../../src/AdWhaleTransitionPopupAd.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAExD,MAAM,WAAW,kCAAkC;IACjD,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mCAAmC;IAClD,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,kCAAkC,KAAK,IAAI,CAAC;IACnE,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,kCAAkC,KAAK,IAAI,CAAC;IACnE,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,mCAAmC,KAAK,IAAI,CAAC;CACjE;AAED,MAAM,WAAW,4BAA4B;IAC3C,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;CACb;AA2BD,eAAO,MAAM,wBAAwB;yBAEnB,MAAM,YACV;QACR,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,4BAA4B,CAAC;KACvC;;;;iCA2CU,8BAA8B,GACxC,mBAAmB,EAAE;CA8DzB,CAAC"}

package/lib/typescript/src/NativeAdwhaleSdkReactNative.d.ts

@@ -1,16 +1,28 @@
 import { 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;
@@ -18,7 +30,17 @@ 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;
 }
-declare const _default: Spec;
+/**
+ * iOS/Android 네이티브에 모듈이 없거나 링크되지 않은 경우 null.
+ * (getEnforcing 는 로드 시점에 앱 전체가 크래시하므로 get 사용)
+ */
+declare const _default: Spec | null | undefined;
 export default _default;
 //# sourceMappingURL=NativeAdwhaleSdkReactNative.d.ts.map

package/lib/typescript/src/NativeAdwhaleSdkReactNative.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NativeAdwhaleSdkReactNative.d.ts","sourceRoot":"","sources":["../../../src/NativeAdwhaleSdkReactNative.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAErE,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,IAAK,SAAQ,WAAW;IACvC,UAAU,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACxC,QAAQ,CAAC,SAAS,EAAE,OAAO,GAAG,IAAI,CAAC;IACnC,kBAAkB,IAAI,OAAO,CAAC;QAC5B,SAAS,EAAE,OAAO,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;IACH,gBAAgB,IAAI,OAAO,CAAC;QAC1B,KAAK,EAAE,OAAO,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,mBAAmB,EAAE,OAAO,CAAC;KAC9B,CAAC,CAAC;IACH,sBAAsB,IAAI,IAAI,CAAC;IAC/B,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;CACjC;;AAED,wBAA+E"}
+{"version":3,"file":"NativeAdwhaleSdkReactNative.d.ts","sourceRoot":"","sources":["../../../src/NativeAdwhaleSdkReactNative.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAErE;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,mEAAmE;AACnE,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,8DAA8D;AAC9D,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,IAAK,SAAQ,WAAW;IACvC,8EAA8E;IAC9E,UAAU,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACxC,QAAQ,CAAC,SAAS,EAAE,OAAO,GAAG,IAAI,CAAC;IACnC,kBAAkB,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACjD,gBAAgB,IAAI,OAAO,CAAC;QAC1B,KAAK,EAAE,OAAO,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,mBAAmB,EAAE,OAAO,CAAC;KAC9B,CAAC,CAAC;IACH,sBAAsB,IAAI,IAAI,CAAC;IAC/B,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IAChC,0BAA0B,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAAC;IAC/C,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;IACnD,wBAAwB,CAAC,aAAa,EAAE,MAAM,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;IAC/D,eAAe,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC9C,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACpC,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC;AAED;;;GAGG;;AACH,wBAAsE"}

package/lib/typescript/src/constants/AdWhaleMethodArgConst.d.ts

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

package/lib/typescript/src/constants/AdWhaleMethodArgConst.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AdWhaleMethodArgConst.d.ts","sourceRoot":"","sources":["../../../../src/constants/AdWhaleMethodArgConst.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,qBAAqB;;;IAGhC,qBAAqB;;IAErB,oEAAoE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwC5D,CAAC"}

package/lib/typescript/src/constants/AdWhaleMethodCallConst.d.ts

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

package/lib/typescript/src/constants/AdWhaleMethodCallConst.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AdWhaleMethodCallConst.d.ts","sourceRoot":"","sources":["../../../../src/constants/AdWhaleMethodCallConst.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,sBAAsB;IAEjC,gEAAgE;;IAEhE,kDAAkD;;;;;;;;;;;;;;;;;;;IAsBlD,4CAA4C;;;;;;IAO5C,sDAAsD;;;;;;;;;;;;;;;;;;CAoB9C,CAAC;AAEX,MAAM,MAAM,yBAAyB,GAAG,MAAM,OAAO,sBAAsB,CAAC"}

package/lib/typescript/src/constants/AdWhaleMethodResultConst.d.ts

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

package/lib/typescript/src/constants/AdWhaleMethodResultConst.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AdWhaleMethodResultConst.d.ts","sourceRoot":"","sources":["../../../../src/constants/AdWhaleMethodResultConst.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;CAS3B,CAAC"}

package/lib/typescript/src/index.d.ts

@@ -1,12 +1,20 @@
 export { AdWhaleMediationAds } from './AdWhaleMediationAds';
-export { AdWhaleAdView, AdWhaleAdSize, } from './AdWhaleAdView';
+export type { InitializeResult, GdprConsentResult, AdInspectorResult, } from './AdWhaleMediationAds';
+export { AdWhaleMethodCallConst, type AdWhaleMethodCallConstKey, } from './constants/AdWhaleMethodCallConst';
+export { AdWhaleMethodArgConst } from './constants/AdWhaleMethodArgConst';
+export { AdWhaleMethodResultConst } from './constants/AdWhaleMethodResultConst';
+export { AdWhaleAdView, AdWhaleAdSize, ADWHALE_BANNER_IOS_UNSUPPORTED_STATUS_CODE, isAdWhaleBannerAdSizeSupportedOnIos, } from './AdWhaleAdView';
 export type { AdWhaleBannerError, AdWhaleBannerViewProps, } from './AdWhaleAdView';
 export { AdWhaleInterstitialAd, } from './AdWhaleInterstitialAd';
 export type { AdWhaleInterstitialErrorEvent, AdWhaleInterstitialEvents, } from './AdWhaleInterstitialAd';
 export { AdWhaleRewardAd, } from './AdWhaleRewardAd';
-export type { AdWhaleRewardErrorEvent, AdWhaleRewardUserRewardedEvent, AdWhaleRewardEvents, } from './AdWhaleRewardAd';
+export type { AdWhaleRewardErrorEvent, AdWhaleRewardUserRewardedEvent, AdWhaleRewardEvents, AdWhaleRewardGcoder, AdWhaleRewardLoadOptions, } from './AdWhaleRewardAd';
 export { AdWhaleAppOpenAd, } from './AdWhaleAppOpenAd';
 export type { AdWhaleAppOpenErrorEvent, AdWhaleAppOpenEvents, } from './AdWhaleAppOpenAd';
+export { AdWhaleExitPopupAd } from './AdWhaleExitPopupAd';
+export type { AdWhaleExitPopupAdClosedEvent, AdWhaleExitPopupAdErrorEvent, AdWhaleExitPopupAdEvents, AdWhaleExitPopupGcoder, } from './AdWhaleExitPopupAd';
+export { AdWhaleTransitionPopupAd } from './AdWhaleTransitionPopupAd';
+export type { AdWhaleTransitionPopupAdClosedEvent, AdWhaleTransitionPopupAdErrorEvent, AdWhaleTransitionPopupAdEvents, AdWhaleTransitionPopupGcoder, } from './AdWhaleTransitionPopupAd';
 export { AdWhaleNativeCustomView, } from './AdWhaleNativeCustomView';
 export type { AdWhaleNativeCustomHandle, AdWhaleNativeCustomViewProps, AdWhaleNativeCustomError, } from './AdWhaleNativeCustomView';
 export * from './AdWhaleNativeTemplateView';

package/lib/typescript/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAY5D,OAAO,EACL,aAAa,EACb,aAAa,GACd,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,iBAAiB,CAAC;AAIzB,OAAO,EACL,qBAAqB,GACtB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACV,6BAA6B,EAC7B,yBAAyB,GAC1B,MAAM,yBAAyB,CAAC;AAIjC,OAAO,EACL,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,uBAAuB,EACvB,8BAA8B,EAC9B,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAI3B,OAAO,EACL,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,wBAAwB,EACxB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAI5B,OAAO,EACL,uBAAuB,GACxB,MAAM,2BAA2B,CAAC;AACnC,YAAY,EACV,yBAAyB,EACzB,4BAA4B,EAC5B,wBAAwB,GACzB,MAAM,2BAA2B,CAAC;AAMnC,cAAc,6BAA6B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,uBAAuB,CAAC;AAW/B,OAAO,EACL,sBAAsB,EACtB,KAAK,yBAAyB,GAC/B,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AAGhF,OAAO,EACL,aAAa,EACb,aAAa,EACb,0CAA0C,EAC1C,mCAAmC,GACpC,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,iBAAiB,CAAC;AAIzB,OAAO,EACL,qBAAqB,GACtB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACV,6BAA6B,EAC7B,yBAAyB,GAC1B,MAAM,yBAAyB,CAAC;AAIjC,OAAO,EACL,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,uBAAuB,EACvB,8BAA8B,EAC9B,mBAAmB,EACnB,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,mBAAmB,CAAC;AAI3B,OAAO,EACL,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,wBAAwB,EACxB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAI5B,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,YAAY,EACV,6BAA6B,EAC7B,4BAA4B,EAC5B,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACtE,YAAY,EACV,mCAAmC,EACnC,kCAAkC,EAClC,8BAA8B,EAC9B,4BAA4B,GAC7B,MAAM,4BAA4B,CAAC;AAIpC,OAAO,EACL,uBAAuB,GACxB,MAAM,2BAA2B,CAAC;AACnC,YAAY,EACV,yBAAyB,EACzB,4BAA4B,EAC5B,wBAAwB,GACzB,MAAM,2BAA2B,CAAC;AAMnC,cAAc,6BAA6B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "adwhale-sdk-react-native",
-  "version": "2.7.204",
+  "version": "2.7.400",
   "description": "Adwhale SDK React Native library for integrating Adwhale advertising mediation SDK into React Native applications.",
   "main": "./lib/module/index.js",
   "react-native": "./lib/module/index.js",

package/src/AdWhaleAdView.tsx

@@ -1,6 +1,6 @@
 // src/AdWhaleAdView.tsx
 import React from 'react';
-import { requireNativeComponent } from 'react-native';
+import { Platform, requireNativeComponent } from 'react-native';
 import type { NativeSyntheticEvent, StyleProp, ViewStyle } from 'react-native';
 
 /**
@@ -14,17 +14,42 @@ export enum AdWhaleAdSize {
   BANNER_320x100 = 'BANNER320x100',
   /** 중간 직사각형 (300x250) */
   BANNER_300x250 = 'BANNER300x250',
-  /** 정사각형 (250x250) */
+  /**
+   * 정사각형 (250x250)
+   * iOS: AdWhale iOS SDK 미지원 — 네이티브에서 로드하지 않으며 `onAdLoadFailed`(statusCode -100) 가 호출됩니다.
+   */
   BANNER_250x250 = 'BANNER250x250',
-  /** 적응형 앵커 배너 - adaptiveAnchorWidth와 함께 사용 */
+  /**
+   * 적응형 앵커 배너 - adaptiveAnchorWidth와 함께 사용
+   * iOS: AdWhale iOS SDK 미지원 — 네이티브에서 로드하지 않으며 `onAdLoadFailed`(statusCode -100) 가 호출됩니다.
+   */
   ADAPTIVE_ANCHOR = 'ADAPTIVE_ANCHOR',
 }
 
+/**
+ * AdWhale iOS SDK 가 해당 배너 사이즈를 지원하는지 (UI 비활성화 등에 사용).
+ * Android / 기타 플랫폼에서는 항상 true.
+ */
+export function isAdWhaleBannerAdSizeSupportedOnIos(
+  adSize: AdWhaleAdSize,
+): boolean {
+  if (Platform.OS !== 'ios') {
+    return true;
+  }
+  return (
+    adSize !== AdWhaleAdSize.BANNER_250x250 &&
+    adSize !== AdWhaleAdSize.ADAPTIVE_ANCHOR
+  );
+}
+
 export interface AdWhaleBannerError {
   statusCode: number;
   message: string;
 }
 
+/** iOS: BANNER250x250 / ADAPTIVE_ANCHOR 요청 시 네이티브 `onAdLoadFailed` 의 statusCode */
+export const ADWHALE_BANNER_IOS_UNSUPPORTED_STATUS_CODE = -100;
+
 export interface AdWhaleBannerGcoder {
   lt: number;
   lng: number;
@@ -32,6 +57,11 @@ export interface AdWhaleBannerGcoder {
 
 export interface AdWhaleBannerViewProps {
   style?: StyleProp<ViewStyle>;
+  /**
+   * Flutter와 동일한 개념의 배너 인스턴스 식별자.
+   * RN은 View 기반이므로, 여러 배너를 동시에 운용할 때 이벤트 라우팅/로그 추적 용도로 사용합니다.
+   */
+  adId?: number;
   placementUid: string;
   placementName?: string;
   region?: string;
@@ -55,7 +85,7 @@ export interface AdWhaleBannerViewProps {
   onAdClicked?: () => void;
 }
 
-type NativeErrorEvent = NativeSyntheticEvent<AdWhaleBannerError>;
+type NativeErrorEvent = NativeSyntheticEvent<AdWhaleBannerError & { adId?: number }>;
 
 interface NativeAdViewProps
   extends Omit<AdWhaleBannerViewProps, 'onAdLoadFailed'> {
@@ -65,13 +95,69 @@ interface NativeAdViewProps
 const RNAdWhaleMediationAdView =
   requireNativeComponent<NativeAdViewProps>('RNAdWhaleMediationAdView');
 
+const AD_SIZE_ENUM_NAME_BY_VALUE: Record<AdWhaleAdSize, string> = {
+  [AdWhaleAdSize.BANNER_320x50]: 'BANNER_320x50',
+  [AdWhaleAdSize.BANNER_320x100]: 'BANNER_320x100',
+  [AdWhaleAdSize.BANNER_300x250]: 'BANNER_300x250',
+  [AdWhaleAdSize.BANNER_250x250]: 'BANNER_250x250',
+  [AdWhaleAdSize.ADAPTIVE_ANCHOR]: 'ADAPTIVE_ANCHOR',
+};
+
 export const AdWhaleAdView: React.FC<AdWhaleBannerViewProps> = ({
+  onAdLoaded,
   onAdLoadFailed,
   adSize,
   adaptiveAnchorWidth,
+  loadAd,
   ...restProps
 }) => {
+  const lastCreateBannerLogKeyRef = React.useRef<string | null>(null);
+
+  React.useEffect(() => {
+    if (!loadAd) {
+      return;
+    }
+
+    const enumName = AD_SIZE_ENUM_NAME_BY_VALUE[adSize] ?? adSize;
+    const adaptiveWidthForLog =
+      adSize === AdWhaleAdSize.ADAPTIVE_ANCHOR
+        ? String(adaptiveAnchorWidth ?? 0)
+        : 'null';
+    const logKey = `${enumName}:${adaptiveWidthForLog}`;
+
+    if (lastCreateBannerLogKeyRef.current === logKey) {
+      return;
+    }
+    lastCreateBannerLogKeyRef.current = logKey;
+
+    console.log(
+      `AdWhaleAdView.tsx _createBanner size=AdWhaleAdSize.${enumName}(${adSize}), adaptiveWidth=${adaptiveWidthForLog}`,
+    );
+  }, [loadAd, adSize, adaptiveAnchorWidth]);
+
+  const handleAdLoaded = () => {
+    const enumName = AD_SIZE_ENUM_NAME_BY_VALUE[adSize] ?? adSize;
+    console.log(
+      `AdWhaleAdView.tsx BannerAd onLoaded for size AdWhaleAdSize.${enumName}(${adSize})`,
+    );
+    onAdLoaded?.();
+  };
+
   const handleAdLoadFailed: NativeAdViewProps['onAdLoadFailed'] = e => {
+    if (
+      Platform.OS === 'ios' &&
+      e.nativeEvent.statusCode === ADWHALE_BANNER_IOS_UNSUPPORTED_STATUS_CODE
+    ) {
+      const enumName = AD_SIZE_ENUM_NAME_BY_VALUE[adSize] ?? adSize;
+      const errorMessage =
+        adSize === AdWhaleAdSize.BANNER_250x250
+          ? '250x250 is not supported on iOS'
+          : 'adaptive banner is not supported on iOS';
+      console.log(
+        `AdWhaleAdView.tsx BannerAd onLoadFailed for AdWhaleAdSize.${enumName}: errorCode: UNSUPPORTED_BANNER_SIZE, errorMessage: ${errorMessage}`,
+      );
+      return;
+    }
     onAdLoadFailed?.(e.nativeEvent);
   };
 
@@ -84,6 +170,8 @@ export const AdWhaleAdView: React.FC<AdWhaleBannerViewProps> = ({
       {...restProps}
       adSize={adSize}
       adaptiveAnchorWidth={nativeAdaptiveAnchorWidth}
+      loadAd={loadAd}
+      onAdLoaded={handleAdLoaded}
       onAdLoadFailed={onAdLoadFailed ? handleAdLoadFailed : undefined}
     />
   );