react-native-daro 1.0.15 → 2.0.0-rc.1

package/src/hooks/useInterstitialAd.ts

@@ -0,0 +1,117 @@
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { InterstitialAd } from '../InterstitialAd';
+import { AdEventType } from '../types/AdEvent';
+import type {
+  AdDisplayFailedInfo,
+  AdInfo,
+  AdLoadFailedInfo,
+} from '../types/AdInfo';
+
+export type UseInterstitialAdOptions = {
+  onLoaded?: (adInfo: AdInfo) => void;
+  onLoadFailed?: (error: AdLoadFailedInfo) => void;
+  onClicked?: (adInfo: AdInfo) => void;
+  onDisplayed?: (adInfo: AdInfo) => void;
+  onFailedToDisplay?: (error: AdDisplayFailedInfo) => void;
+  onHidden?: (adInfo: AdInfo) => void;
+  onImpressionRecorded?: (adInfo: AdInfo) => void;
+};
+
+export type UseInterstitialAdResult = {
+  isLoaded: boolean;
+  isLoading: boolean;
+  load: () => void;
+  show: () => void;
+  isAdReady: () => Promise<boolean>;
+};
+
+export function useInterstitialAd(
+  adUnitId: string | null,
+  options: UseInterstitialAdOptions = {}
+): UseInterstitialAdResult {
+  const adRef = useRef<InterstitialAd | null>(null);
+  const optionsRef = useRef(options);
+  optionsRef.current = options;
+  const [state, setState] = useState({
+    isLoaded: false,
+    isLoading: false,
+  });
+
+  const load = useCallback(() => {
+    if (!adUnitId) {
+      return;
+    }
+
+    const ad = adRef.current;
+    if (!ad) {
+      return;
+    }
+
+    setState({ isLoaded: false, isLoading: true });
+    ad.load();
+  }, [adUnitId]);
+
+  const show = useCallback(() => {
+    adRef.current?.show();
+  }, []);
+
+  const isAdReady = useCallback(async () => {
+    const isLoaded = (await adRef.current?.isAdReady()) ?? false;
+    setState((prevState) => ({ ...prevState, isLoaded }));
+    return isLoaded;
+  }, []);
+
+  useEffect(() => {
+    adRef.current?.removeAllListeners();
+    adRef.current = null;
+    setState({ isLoaded: false, isLoading: false });
+
+    if (!adUnitId) {
+      return;
+    }
+
+    const ad = InterstitialAd.createForAdRequest(adUnitId);
+    adRef.current = ad;
+
+    ad.addAdEventListener(AdEventType.LOADED, (info) => {
+      setState({ isLoaded: true, isLoading: false });
+      optionsRef.current.onLoaded?.(info);
+    });
+    ad.addAdEventListener(AdEventType.LOAD_FAILED, (error) => {
+      setState({ isLoaded: false, isLoading: false });
+      optionsRef.current.onLoadFailed?.(error);
+    });
+    ad.addAdEventListener(AdEventType.DISPLAYED, (info) => {
+      setState((prevState) => ({ ...prevState, isLoaded: false }));
+      optionsRef.current.onDisplayed?.(info);
+    });
+    ad.addAdEventListener(AdEventType.FAILED_TO_DISPLAY, (error) => {
+      setState({ isLoaded: false, isLoading: false });
+      optionsRef.current.onFailedToDisplay?.(error);
+    });
+    ad.addAdEventListener(AdEventType.HIDDEN, (info) => {
+      setState((prevState) => ({ ...prevState, isLoaded: false }));
+      optionsRef.current.onHidden?.(info);
+    });
+    ad.addAdEventListener(AdEventType.CLICKED, (info) => {
+      optionsRef.current.onClicked?.(info);
+    });
+    ad.addAdEventListener(AdEventType.IMPRESSION_RECORDED, (info) => {
+      optionsRef.current.onImpressionRecorded?.(info);
+    });
+
+    return () => {
+      ad.removeAllListeners();
+      if (adRef.current === ad) {
+        adRef.current = null;
+      }
+    };
+  }, [adUnitId]);
+
+  return {
+    ...state,
+    load,
+    show,
+    isAdReady,
+  };
+}

package/src/hooks/useLightPopupAd.ts

@@ -0,0 +1,132 @@
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { LightPopupAd } from '../LightPopupAd';
+import { AdEventType } from '../types/AdEvent';
+import type {
+  AdDisplayFailedInfo,
+  AdInfo,
+  AdLoadFailedInfo,
+} from '../types/AdInfo';
+import type { LightPopupAdConfiguration } from '../types/LightPopupAd';
+
+export type UseLightPopupAdOptions = {
+  onLoaded?: (adInfo: AdInfo) => void;
+  onLoadFailed?: (error: AdLoadFailedInfo) => void;
+  onClicked?: (adInfo: AdInfo) => void;
+  onDisplayed?: (adInfo: AdInfo) => void;
+  onFailedToDisplay?: (error: AdDisplayFailedInfo) => void;
+  onHidden?: (adInfo: AdInfo) => void;
+  onImpressionRecorded?: (adInfo: AdInfo) => void;
+};
+
+export type UseLightPopupAdLoadOptions = {
+  configuration?: LightPopupAdConfiguration;
+};
+
+export type UseLightPopupAdResult = {
+  isLoaded: boolean;
+  isLoading: boolean;
+  load: (options?: UseLightPopupAdLoadOptions) => void;
+  show: () => void;
+  isAdReady: () => Promise<boolean>;
+};
+
+export function useLightPopupAd(
+  adUnitId: string | null,
+  options: UseLightPopupAdOptions = {}
+): UseLightPopupAdResult {
+  const adRef = useRef<LightPopupAd | null>(null);
+  const optionsRef = useRef(options);
+  optionsRef.current = options;
+  const [state, setState] = useState({
+    isLoaded: false,
+    isLoading: false,
+  });
+
+  const createAd = useCallback(() => {
+    if (!adUnitId) {
+      return null;
+    }
+
+    adRef.current?.removeAllListeners();
+
+    const ad = LightPopupAd.createForAdRequest(adUnitId);
+    adRef.current = ad;
+
+    ad.addAdEventListener(AdEventType.LOADED, (info) => {
+      setState({ isLoaded: true, isLoading: false });
+      optionsRef.current.onLoaded?.(info);
+    });
+    ad.addAdEventListener(AdEventType.LOAD_FAILED, (error) => {
+      setState({ isLoaded: false, isLoading: false });
+      optionsRef.current.onLoadFailed?.(error);
+    });
+    ad.addAdEventListener(AdEventType.DISPLAYED, (info) => {
+      setState((prevState) => ({ ...prevState, isLoaded: false }));
+      optionsRef.current.onDisplayed?.(info);
+    });
+    ad.addAdEventListener(AdEventType.FAILED_TO_DISPLAY, (error) => {
+      setState({ isLoaded: false, isLoading: false });
+      optionsRef.current.onFailedToDisplay?.(error);
+    });
+    ad.addAdEventListener(AdEventType.HIDDEN, (info) => {
+      setState((prevState) => ({ ...prevState, isLoaded: false }));
+      optionsRef.current.onHidden?.(info);
+    });
+    ad.addAdEventListener(AdEventType.CLICKED, (info) => {
+      optionsRef.current.onClicked?.(info);
+    });
+    ad.addAdEventListener(AdEventType.IMPRESSION_RECORDED, (info) => {
+      optionsRef.current.onImpressionRecorded?.(info);
+    });
+
+    return ad;
+  }, [adUnitId]);
+
+  const load = useCallback(
+    (loadOptions?: UseLightPopupAdLoadOptions) => {
+      const ad = createAd();
+      if (!ad) {
+        return;
+      }
+
+      setState({ isLoaded: false, isLoading: true });
+
+      if (loadOptions?.configuration) {
+        ad.setConfiguration(loadOptions.configuration);
+      }
+
+      ad.load();
+    },
+    [createAd]
+  );
+
+  const show = useCallback(() => {
+    adRef.current?.show();
+  }, []);
+
+  const isAdReady = useCallback(async () => {
+    const isLoaded = (await adRef.current?.isAdReady()) ?? false;
+    setState((prevState) => ({ ...prevState, isLoaded }));
+    return isLoaded;
+  }, []);
+
+  useEffect(() => {
+    adRef.current?.removeAllListeners();
+    adRef.current = null;
+    setState({ isLoaded: false, isLoading: false });
+  }, [adUnitId]);
+
+  useEffect(() => {
+    return () => {
+      adRef.current?.removeAllListeners();
+      adRef.current = null;
+    };
+  }, []);
+
+  return {
+    ...state,
+    load,
+    show,
+    isAdReady,
+  };
+}

package/src/hooks/useRewardedAd.ts

@@ -0,0 +1,122 @@
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { RewardedAd } from '../RewardedAd';
+import { AdEventType, RewardedAdEventType } from '../types/AdEvent';
+import type {
+  AdDisplayFailedInfo,
+  AdInfo,
+  AdLoadFailedInfo,
+  AdRewardInfo,
+} from '../types/AdInfo';
+
+export type UseRewardedAdOptions = {
+  onLoaded?: (adInfo: AdInfo) => void;
+  onLoadFailed?: (error: AdLoadFailedInfo) => void;
+  onClicked?: (adInfo: AdInfo) => void;
+  onDisplayed?: (adInfo: AdInfo) => void;
+  onFailedToDisplay?: (error: AdDisplayFailedInfo) => void;
+  onHidden?: (adInfo: AdInfo) => void;
+  onImpressionRecorded?: (adInfo: AdInfo) => void;
+  onReceivedReward?: (reward: AdRewardInfo) => void;
+};
+
+export type UseRewardedAdResult = {
+  isLoaded: boolean;
+  isLoading: boolean;
+  load: () => void;
+  show: (customData?: string | null) => void;
+  isAdReady: () => Promise<boolean>;
+};
+
+export function useRewardedAd(
+  adUnitId: string | null,
+  options: UseRewardedAdOptions = {}
+): UseRewardedAdResult {
+  const adRef = useRef<RewardedAd | null>(null);
+  const optionsRef = useRef(options);
+  optionsRef.current = options;
+  const [state, setState] = useState({
+    isLoaded: false,
+    isLoading: false,
+  });
+
+  const load = useCallback(() => {
+    if (!adUnitId) {
+      return;
+    }
+
+    const ad = adRef.current;
+    if (!ad) {
+      return;
+    }
+
+    setState({ isLoaded: false, isLoading: true });
+    ad.load();
+  }, [adUnitId]);
+
+  const show = useCallback((customData?: string | null) => {
+    adRef.current?.show(customData);
+  }, []);
+
+  const isAdReady = useCallback(async () => {
+    const isLoaded = (await adRef.current?.isAdReady()) ?? false;
+    setState((prevState) => ({ ...prevState, isLoaded }));
+    return isLoaded;
+  }, []);
+
+  useEffect(() => {
+    adRef.current?.removeAllListeners();
+    adRef.current = null;
+    setState({ isLoaded: false, isLoading: false });
+
+    if (!adUnitId) {
+      return;
+    }
+
+    const ad = RewardedAd.createForAdRequest(adUnitId);
+    adRef.current = ad;
+
+    ad.addAdEventListener(AdEventType.LOADED, (info) => {
+      setState({ isLoaded: true, isLoading: false });
+      optionsRef.current.onLoaded?.(info);
+    });
+    ad.addAdEventListener(AdEventType.LOAD_FAILED, (error) => {
+      setState({ isLoaded: false, isLoading: false });
+      optionsRef.current.onLoadFailed?.(error);
+    });
+    ad.addAdEventListener(AdEventType.DISPLAYED, (info) => {
+      setState((prevState) => ({ ...prevState, isLoaded: false }));
+      optionsRef.current.onDisplayed?.(info);
+    });
+    ad.addAdEventListener(AdEventType.FAILED_TO_DISPLAY, (error) => {
+      setState({ isLoaded: false, isLoading: false });
+      optionsRef.current.onFailedToDisplay?.(error);
+    });
+    ad.addAdEventListener(AdEventType.HIDDEN, (info) => {
+      setState((prevState) => ({ ...prevState, isLoaded: false }));
+      optionsRef.current.onHidden?.(info);
+    });
+    ad.addAdEventListener(AdEventType.CLICKED, (info) => {
+      optionsRef.current.onClicked?.(info);
+    });
+    ad.addAdEventListener(AdEventType.IMPRESSION_RECORDED, (info) => {
+      optionsRef.current.onImpressionRecorded?.(info);
+    });
+    ad.addAdEventListener(RewardedAdEventType.RECEIVED_REWARD, (reward) => {
+      optionsRef.current.onReceivedReward?.(reward);
+    });
+
+    return () => {
+      ad.removeAllListeners();
+      if (adRef.current === ad) {
+        adRef.current = null;
+      }
+    };
+  }, [adUnitId]);
+
+  return {
+    ...state,
+    load,
+    show,
+    isAdReady,
+  };
+}

package/src/index.tsx

@@ -1,10 +1,26 @@
-import { NativeModules, Platform } from 'react-native';
+import NativeDaroModule from './NativeDaroModule';
 
 export * from './AdBannerView';
 export * from './types';
 export { InterstitialAd } from './InterstitialAd';
+export { useInterstitialAd } from './hooks/useInterstitialAd';
+export type {
+  UseInterstitialAdOptions,
+  UseInterstitialAdResult,
+} from './hooks/useInterstitialAd';
 export { RewardedAd } from './RewardedAd';
+export { useRewardedAd } from './hooks/useRewardedAd';
+export type {
+  UseRewardedAdOptions,
+  UseRewardedAdResult,
+} from './hooks/useRewardedAd';
 export { LightPopupAd } from './LightPopupAd';
+export { useLightPopupAd } from './hooks/useLightPopupAd';
+export type {
+  UseLightPopupAdOptions,
+  UseLightPopupAdLoadOptions,
+  UseLightPopupAdResult,
+} from './hooks/useLightPopupAd';
 
 export { NativeAdView } from './nativeAd/NativeAdView';
 export {
@@ -15,31 +31,150 @@ export {
   TitleView,
 } from './nativeAd/NativeAdViewComponents';
 
-const LINKING_ERROR =
-  `The native module 'DaroMModule' 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';
-
-const DaroMModule = NativeModules.DaroMModule
-  ? NativeModules.DaroMModule
-  : new Proxy(
-      {},
-      {
-        get() {
-          throw new Error(LINKING_ERROR);
-        },
-      }
-    );
-
 export async function initialize() {
-  await DaroMModule.initializeSdk();
+  await NativeDaroModule.initializeSdk();
+}
+
+export async function isInitialized(): Promise<boolean> {
+  return NativeDaroModule.isInitialized();
+}
+
+export type DaroMediationStatus = {
+  mediationPlatform: string;
+  isReady: boolean;
+  hasFailed: boolean;
+};
+
+// 키가 공개 어휘(`daroa`/`darom`)를 따른다 (DARO-1594). 한때 `admob`/`applovin` 이었고
+// 그것은 벤더 이름이라 공개 표면에서 걷었다.
+export type DaroMediationWeights = {
+  daroa: number;
+  darom: number;
+};
+
+export async function getSdkVersion(): Promise<string | null> {
+  return (await NativeDaroModule.getSdkVersion()) ?? null;
+}
+
+export async function getMediationStatuses(): Promise<
+  DaroMediationStatus[] | null
+> {
+  const statuses = await NativeDaroModule.getMediationStatuses();
+  return (statuses as DaroMediationStatus[] | null) ?? null;
+}
+
+export async function getMediationWeights(): Promise<DaroMediationWeights | null> {
+  const weights = await NativeDaroModule.getMediationWeights();
+  return (weights as DaroMediationWeights | null) ?? null;
+}
+
+/**
+ * 미디에이션별 벤더 검사기를 띄운다.
+ *
+ * 값은 {@link DaroAdInfo.mediationPlatform} 과 **같은 어휘**다. 구 어휘
+ * (`admob`/`applovin`)도 네이티브가 아직 받아주지만 타입으로는 광고하지 않는다 —
+ * 벤더 이름을 공개 표면에서 걷는 것이 이 어휘를 만든 이유다.
+ */
+export async function showMediationDebuggerFor(mediation: 'daroa' | 'darom') {
+  await NativeDaroModule.showMediationDebuggerFor(mediation);
+}
+
+export type DaroAdapterRow = {
+  name: string;
+  detail: string;
+  isReady: boolean;
+};
+
+// QA 전용 — 벤더 SDK(GMA·MAX)에 직접 묻는다. SDK 는 서브네트워크 목록을 갖지 않는다.
+export async function getAdapterInventory(): Promise<
+  Record<string, DaroAdapterRow[]>
+> {
+  const inventory = await NativeDaroModule.getAdapterInventory();
+  return inventory as Record<string, DaroAdapterRow[]>;
+}
+
+// QA 전용 — 주입 결과(런타임 plist/manifest)의 파생 키를 그대로 돌려준다. JS 는
+// 원문을 읽을 수 없어 이 브리지가 유일한 창이다. 판정·마스킹은 앱이 한다.
+export async function getIntegrationKeyInfo(): Promise<
+  Record<string, string | null>
+> {
+  const info = await NativeDaroModule.getIntegrationKeyInfo();
+  return info as Record<string, string | null>;
 }
 
 export async function showMediationDebugger() {
-  await DaroMModule.showMediationDebugger();
+  await NativeDaroModule.showMediationDebugger();
+}
+
+export async function setUserId(userId: string) {
+  await NativeDaroModule.setUserId(userId);
+}
+
+/**
+ * GDPR 동의 상태. `unknown` 이 SDK 기본값(미확정)이다.
+ *
+ * **네이티브의 표현을 노출하지 않는다.** Android 는 `GdprStatus` enum 이름
+ * (`OPT_IN`…), iOS 는 `DaroGdprStatus` 의 Int raw value(0…3)로 같은 개념을 서로 다르게
+ * 적는다. 둘 중 하나를 골라 JS 계약으로 삼으면 나머지 플랫폼이 그 표현을 되옮겨야 하고,
+ * 되옮기는 코드가 없거나 낡으면 **에러 없이 틀린 상태가 전달된다** — Flutter 가 Android
+ * enum 이름을 그대로 보내 iOS 에서 어긋난 것이 그 사고다(DARO-1471). 그래서 JS 는 어느
+ * 플랫폼 것도 아닌 문자열을 쓰고, 옮기는 일은 각 네이티브 어댑터가 자기 쪽에서 한다.
+ */
+export type DaroGdprStatus = 'optIn' | 'optOut' | 'notApplicable' | 'unknown';
+
+/** CCPA 동의 상태. GDPR 과 달리 `unknown` 이 없다. */
+export type DaroCcpaStatus = 'optIn' | 'optOut' | 'notApplicable';
+
+/** 퍼블리셔가 선언하는 COPPA 아동 대상 여부. */
+export type DaroCoppaStatus = 'child' | 'notChild';
+
+/**
+ * GDPR 동의 상태를 설정한다.
+ *
+ * **{@link initialize} 전에 호출한다.** 동의는 첫 광고 요청보다 먼저 확정돼 있어야 한다.
+ * 셋 중 {@link setCoppa} 는 이것이 권고가 아니라 요구이고, 나머지 둘의 순서를 거기에
+ * 맞춘다 — 세 API 의 규칙이 갈리면 지키는 쪽이 더 어렵다.
+ *
+ * 모르는 상태 문자열은 **기본값으로 떨어지지 않고 reject 된다**(`INVALID_CONSENT_STATUS`).
+ * 동의는 조용히 틀리면 안 되는 값이라, 오타가 "일단 옵트인"으로 흡수되는 쪽이 더 나쁘다.
+ *
+ * **이미 넘긴 동의 문자열이 있으면 상태만 갱신할 때도 같이 넘겨라.** 빈 문자열은 양쪽
+ * 플랫폼 모두 건너뛰므로 이전 값이 지워지지는 않지만, 상태와 문자열을 한 호출로 함께
+ * 넘기면 어느 쪽이 최신인지 따질 일이 아예 없다.
+ *
+ * @param consentString IAB TCF 동의 문자열. 없으면 비워 둔다.
+ */
+export async function setGdpr(
+  status: DaroGdprStatus,
+  consentString: string = ''
+) {
+  await NativeDaroModule.setGdpr(status, consentString);
+}
+
+/**
+ * CCPA 동의 상태를 설정한다.
+ *
+ * **{@link initialize} 전에 호출한다** — {@link setGdpr} 과 같은 이유다.
+ *
+ * `consentString` 취급도 {@link setGdpr} 과 같다 — 빈 문자열은 이전 값을 덮지 않고,
+ * 상태만 갱신할 때도 이미 넘긴 문자열이 있으면 같이 넘기는 편이 낫다.
+ *
+ * @param consentString IAB US Privacy 문자열. 없으면 비워 둔다.
+ */
+export async function setCcpa(
+  status: DaroCcpaStatus,
+  consentString: string = ''
+) {
+  await NativeDaroModule.setCcpa(status, consentString);
 }
 
-export async function setUserId(userId: String) {
-  await DaroMModule.setUserId(userId);
+/**
+ * COPPA 아동 대상 여부를 설정한다.
+ *
+ * **{@link initialize} 전에 호출한다.** 셋 중 이것만은 순서가 권고가 아니라 요구다 —
+ * 아동 대상으로 선언하면 광고 식별자 전송이 차단되는데, 그 차단이 **초기화 요청부터**
+ * 걸려야 한다. 초기화 뒤에 부르면 첫 요청은 이미 식별자를 달고 나간 뒤다.
+ */
+export async function setCoppa(status: DaroCoppaStatus) {
+  await NativeDaroModule.setCoppa(status);
 }