@apps-in-toss/native-modules 1.7.1 → 1.8.0

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @apps-in-toss/native-modules
 
+## 1.8.0
+
+### Minor Changes
+
+[[AIT-3762]: GoogleAdMob 로딩 여부 확인하는 브릿지 추가](https://github.toss.bz/toss/apps-in-toss-sdk/pull/18)
+
+구글 광고가 로딩되었는지 확인하는 isAdMobLoaded를 추가합니다.
+
 ## 1.7.1
 
 ## 1.7.0

package/dist/index.cjs

@@ -448,6 +448,30 @@ function createIsSupported() {
 }
 loadAppsInTossAdMob.isSupported = createIsSupported();
 showAppsInTossAdMob.isSupported = createIsSupported();
+async function isAppsInTossAdMobLoaded(params) {
+  if (!isAppsInTossAdMobLoadedSupported()) {
+    return false;
+  }
+  return new Promise((resolve, reject) => {
+    const unregister = INTERNAL__appBridgeHandler.invokeAppBridgeMethod(
+      "getCachedStatusAppsInTossAdmob",
+      {
+        ...params
+      },
+      {
+        onSuccess: (cached) => {
+          resolve(cached);
+          unregister();
+        },
+        onError: reject
+      }
+    );
+  });
+}
+function isAppsInTossAdMobLoadedSupported() {
+  return ENVIRONMENT !== "toss" ? false : isMinVersionSupported({ android: "5.244.0", ios: "5.244.0" });
+}
+isAppsInTossAdMobLoaded.isSupported = isAppsInTossAdMobLoadedSupported;
 
 // src/AppsInTossModule/native-modules/checkoutPayment.ts
 async function checkoutPayment(options) {
@@ -971,7 +995,8 @@ var TossPay = {
 };
 var GoogleAdMob = {
   loadAppsInTossAdMob,
-  showAppsInTossAdMob
+  showAppsInTossAdMob,
+  isAppsInTossAdMobLoaded
 };
 
 // src/AppsInTossModule/native-event-emitter/startUpdateLocation.ts

package/dist/index.d.cts

@@ -701,6 +701,25 @@ declare function showAppsInTossAdMob(params: ShowAdMobParams): () => void;
 declare namespace showAppsInTossAdMob {
     var isSupported: () => boolean;
 }
+interface IsAdMobLoadedOptions {
+    /**
+     * 광고 그룹 단위 ID
+     */
+    adGroupId: string;
+}
+/**
+ * @public
+ * @category 광고
+ * @name showAppsInTossAdMob
+ * @description 이 함수는 `loadAppsInTossAdMob` 로 광고가 잘 불러와졌는지 확인해요.
+ * @param {string} params.adUnitId 광고 그룹 단위 ID예요.
+ * @property {() => boolean} [isSupported] 현재 실행 중인 앱(예: 토스 앱, 개발용 샌드박스 앱 등)에서 `isAppsInTossAdMobLoaded` 를 지원하는지 확인하는 함수예요. 기능을 사용하기 전에 지원 여부를 확인해야 해요.
+ */
+declare function isAppsInTossAdMobLoaded(params: IsAdMobLoadedOptions): Promise<boolean>;
+declare namespace isAppsInTossAdMobLoaded {
+    var isSupported: typeof isAppsInTossAdMobLoadedSupported;
+}
+declare function isAppsInTossAdMobLoadedSupported(): boolean;
 
 /**
  * @public
@@ -2628,12 +2647,14 @@ declare const TossPay: {
  * @category 광고
  * @name GoogleAdMob
  * @description Google AdMob 광고 관련 함수를 모아둔 객체예요.
- * @property {typeof loadAppsInTossAdMob} [loadAppsInTossAdMob] 광고를 로드하는 함수예요. 자세한 내용은 [loadAppsInTossAdMob](/react-native/reference/native-modules/광고/loadAppsInTossAdMob.html)를 참고하세요.
- * @property {typeof showAppsInTossAdMob} [showAppsInTossAdMob] 로드한 광고를 보여주는 함수예요. 자세한 내용은 [showAppsInTossAdMob](/react-native/reference/native-modules/광고/showAppsInTossAdMob.html)를 참고하세요.
+ * @property {typeof loadAppsInTossAdMob} [loadAppsInTossAdMob] 광고를 로드하는 함수예요.
+ * @property {typeof showAppsInTossAdMob} [showAppsInTossAdMob] 로드한 광고를 보여주는 함수예요.
+ * @property {typeof isAppsInTossAdMobLoaded} [isAppsInTossAdMobLoaded] 광고가 로드되었는지 확인하는 함수예요.
  */
 declare const GoogleAdMob: {
     loadAppsInTossAdMob: typeof loadAppsInTossAdMob;
     showAppsInTossAdMob: typeof showAppsInTossAdMob;
+    isAppsInTossAdMobLoaded: typeof isAppsInTossAdMobLoaded;
 };
 
 /**
@@ -3101,4 +3122,4 @@ declare const INTERNAL__module: {
     tossCoreEventLog: typeof tossCoreEventLog;
 };
 
-export { AppsInTossModule, type AppsInTossSignTossCertParams, BedrockCoreModule, BedrockModule, type CheckoutPaymentOptions, type CheckoutPaymentResult, type CompletedOrRefundedOrdersResult, type ContactsViralParams, type EventLogParams, type GameCenterGameProfileResponse, type GetUserKeyForGameErrorResponse, type GetUserKeyForGameResponse, type GetUserKeyForGameSuccessResponse, GoogleAdMob, type GrantPromotionRewardForGameErrorResponse, type GrantPromotionRewardForGameErrorResult, type GrantPromotionRewardForGameResponse, type GrantPromotionRewardForGameSuccessResponse, type HapticFeedbackType, IAP, AppsInTossModuleInstance as INTERNAL__AppsInTossModule, INTERNAL__appBridgeHandler, INTERNAL__module, type IapCreateOneTimePurchaseOrderOptions, type IapCreateOneTimePurchaseOrderResult, type IapProductListItem, type LoadAdMobEvent, type LoadAdMobOptions, type LoadAdMobParams, type NetworkStatus, type Primitive, type SaveBase64DataParams, type ShowAdMobEvent, type ShowAdMobOptions, type ShowAdMobParams, Storage, type SubmitGameCenterLeaderBoardScoreResponse, TossPay, type UpdateLocationEventEmitter, appLogin, appsInTossEvent, appsInTossSignTossCert, closeView, contactsViral, eventLog, fetchAlbumPhotos, fetchContacts, generateHapticFeedback, getClipboardText, getCurrentLocation, getDeviceId, getGameCenterGameProfile, getIsTossLoginIntegratedService, getLocale, getNetworkStatus, getOperationalEnvironment, getPlatformOS, getSchemeUri, getTossAppVersion, getTossShareLink, getUserKeyForGame, grantPromotionRewardForGame, iapCreateOneTimePurchaseOrder, isMinVersionSupported, onVisibilityChangedByTransparentServiceWeb, openCamera, openGameCenterLeaderboard, openURL, processProductGrant, requestOneTimePurchase, saveBase64Data, setClipboardText, setDeviceOrientation, setIosSwipeGestureEnabled, setScreenAwakeMode, setSecureScreen, share, startUpdateLocation, submitGameCenterLeaderBoardScore };
+export { AppsInTossModule, type AppsInTossSignTossCertParams, BedrockCoreModule, BedrockModule, type CheckoutPaymentOptions, type CheckoutPaymentResult, type CompletedOrRefundedOrdersResult, type ContactsViralParams, type EventLogParams, type GameCenterGameProfileResponse, type GetUserKeyForGameErrorResponse, type GetUserKeyForGameResponse, type GetUserKeyForGameSuccessResponse, GoogleAdMob, type GrantPromotionRewardForGameErrorResponse, type GrantPromotionRewardForGameErrorResult, type GrantPromotionRewardForGameResponse, type GrantPromotionRewardForGameSuccessResponse, type HapticFeedbackType, IAP, AppsInTossModuleInstance as INTERNAL__AppsInTossModule, INTERNAL__appBridgeHandler, INTERNAL__module, type IapCreateOneTimePurchaseOrderOptions, type IapCreateOneTimePurchaseOrderResult, type IapProductListItem, type IsAdMobLoadedOptions, type LoadAdMobEvent, type LoadAdMobOptions, type LoadAdMobParams, type NetworkStatus, type Primitive, type SaveBase64DataParams, type ShowAdMobEvent, type ShowAdMobOptions, type ShowAdMobParams, Storage, type SubmitGameCenterLeaderBoardScoreResponse, TossPay, type UpdateLocationEventEmitter, appLogin, appsInTossEvent, appsInTossSignTossCert, closeView, contactsViral, eventLog, fetchAlbumPhotos, fetchContacts, generateHapticFeedback, getClipboardText, getCurrentLocation, getDeviceId, getGameCenterGameProfile, getIsTossLoginIntegratedService, getLocale, getNetworkStatus, getOperationalEnvironment, getPlatformOS, getSchemeUri, getTossAppVersion, getTossShareLink, getUserKeyForGame, grantPromotionRewardForGame, iapCreateOneTimePurchaseOrder, isMinVersionSupported, onVisibilityChangedByTransparentServiceWeb, openCamera, openGameCenterLeaderboard, openURL, processProductGrant, requestOneTimePurchase, saveBase64Data, setClipboardText, setDeviceOrientation, setIosSwipeGestureEnabled, setScreenAwakeMode, setSecureScreen, share, startUpdateLocation, submitGameCenterLeaderBoardScore };

package/dist/index.d.ts

@@ -701,6 +701,25 @@ declare function showAppsInTossAdMob(params: ShowAdMobParams): () => void;
 declare namespace showAppsInTossAdMob {
     var isSupported: () => boolean;
 }
+interface IsAdMobLoadedOptions {
+    /**
+     * 광고 그룹 단위 ID
+     */
+    adGroupId: string;
+}
+/**
+ * @public
+ * @category 광고
+ * @name showAppsInTossAdMob
+ * @description 이 함수는 `loadAppsInTossAdMob` 로 광고가 잘 불러와졌는지 확인해요.
+ * @param {string} params.adUnitId 광고 그룹 단위 ID예요.
+ * @property {() => boolean} [isSupported] 현재 실행 중인 앱(예: 토스 앱, 개발용 샌드박스 앱 등)에서 `isAppsInTossAdMobLoaded` 를 지원하는지 확인하는 함수예요. 기능을 사용하기 전에 지원 여부를 확인해야 해요.
+ */
+declare function isAppsInTossAdMobLoaded(params: IsAdMobLoadedOptions): Promise<boolean>;
+declare namespace isAppsInTossAdMobLoaded {
+    var isSupported: typeof isAppsInTossAdMobLoadedSupported;
+}
+declare function isAppsInTossAdMobLoadedSupported(): boolean;
 
 /**
  * @public
@@ -2628,12 +2647,14 @@ declare const TossPay: {
  * @category 광고
  * @name GoogleAdMob
  * @description Google AdMob 광고 관련 함수를 모아둔 객체예요.
- * @property {typeof loadAppsInTossAdMob} [loadAppsInTossAdMob] 광고를 로드하는 함수예요. 자세한 내용은 [loadAppsInTossAdMob](/react-native/reference/native-modules/광고/loadAppsInTossAdMob.html)를 참고하세요.
- * @property {typeof showAppsInTossAdMob} [showAppsInTossAdMob] 로드한 광고를 보여주는 함수예요. 자세한 내용은 [showAppsInTossAdMob](/react-native/reference/native-modules/광고/showAppsInTossAdMob.html)를 참고하세요.
+ * @property {typeof loadAppsInTossAdMob} [loadAppsInTossAdMob] 광고를 로드하는 함수예요.
+ * @property {typeof showAppsInTossAdMob} [showAppsInTossAdMob] 로드한 광고를 보여주는 함수예요.
+ * @property {typeof isAppsInTossAdMobLoaded} [isAppsInTossAdMobLoaded] 광고가 로드되었는지 확인하는 함수예요.
  */
 declare const GoogleAdMob: {
     loadAppsInTossAdMob: typeof loadAppsInTossAdMob;
     showAppsInTossAdMob: typeof showAppsInTossAdMob;
+    isAppsInTossAdMobLoaded: typeof isAppsInTossAdMobLoaded;
 };
 
 /**
@@ -3101,4 +3122,4 @@ declare const INTERNAL__module: {
     tossCoreEventLog: typeof tossCoreEventLog;
 };
 
-export { AppsInTossModule, type AppsInTossSignTossCertParams, BedrockCoreModule, BedrockModule, type CheckoutPaymentOptions, type CheckoutPaymentResult, type CompletedOrRefundedOrdersResult, type ContactsViralParams, type EventLogParams, type GameCenterGameProfileResponse, type GetUserKeyForGameErrorResponse, type GetUserKeyForGameResponse, type GetUserKeyForGameSuccessResponse, GoogleAdMob, type GrantPromotionRewardForGameErrorResponse, type GrantPromotionRewardForGameErrorResult, type GrantPromotionRewardForGameResponse, type GrantPromotionRewardForGameSuccessResponse, type HapticFeedbackType, IAP, AppsInTossModuleInstance as INTERNAL__AppsInTossModule, INTERNAL__appBridgeHandler, INTERNAL__module, type IapCreateOneTimePurchaseOrderOptions, type IapCreateOneTimePurchaseOrderResult, type IapProductListItem, type LoadAdMobEvent, type LoadAdMobOptions, type LoadAdMobParams, type NetworkStatus, type Primitive, type SaveBase64DataParams, type ShowAdMobEvent, type ShowAdMobOptions, type ShowAdMobParams, Storage, type SubmitGameCenterLeaderBoardScoreResponse, TossPay, type UpdateLocationEventEmitter, appLogin, appsInTossEvent, appsInTossSignTossCert, closeView, contactsViral, eventLog, fetchAlbumPhotos, fetchContacts, generateHapticFeedback, getClipboardText, getCurrentLocation, getDeviceId, getGameCenterGameProfile, getIsTossLoginIntegratedService, getLocale, getNetworkStatus, getOperationalEnvironment, getPlatformOS, getSchemeUri, getTossAppVersion, getTossShareLink, getUserKeyForGame, grantPromotionRewardForGame, iapCreateOneTimePurchaseOrder, isMinVersionSupported, onVisibilityChangedByTransparentServiceWeb, openCamera, openGameCenterLeaderboard, openURL, processProductGrant, requestOneTimePurchase, saveBase64Data, setClipboardText, setDeviceOrientation, setIosSwipeGestureEnabled, setScreenAwakeMode, setSecureScreen, share, startUpdateLocation, submitGameCenterLeaderBoardScore };
+export { AppsInTossModule, type AppsInTossSignTossCertParams, BedrockCoreModule, BedrockModule, type CheckoutPaymentOptions, type CheckoutPaymentResult, type CompletedOrRefundedOrdersResult, type ContactsViralParams, type EventLogParams, type GameCenterGameProfileResponse, type GetUserKeyForGameErrorResponse, type GetUserKeyForGameResponse, type GetUserKeyForGameSuccessResponse, GoogleAdMob, type GrantPromotionRewardForGameErrorResponse, type GrantPromotionRewardForGameErrorResult, type GrantPromotionRewardForGameResponse, type GrantPromotionRewardForGameSuccessResponse, type HapticFeedbackType, IAP, AppsInTossModuleInstance as INTERNAL__AppsInTossModule, INTERNAL__appBridgeHandler, INTERNAL__module, type IapCreateOneTimePurchaseOrderOptions, type IapCreateOneTimePurchaseOrderResult, type IapProductListItem, type IsAdMobLoadedOptions, type LoadAdMobEvent, type LoadAdMobOptions, type LoadAdMobParams, type NetworkStatus, type Primitive, type SaveBase64DataParams, type ShowAdMobEvent, type ShowAdMobOptions, type ShowAdMobParams, Storage, type SubmitGameCenterLeaderBoardScoreResponse, TossPay, type UpdateLocationEventEmitter, appLogin, appsInTossEvent, appsInTossSignTossCert, closeView, contactsViral, eventLog, fetchAlbumPhotos, fetchContacts, generateHapticFeedback, getClipboardText, getCurrentLocation, getDeviceId, getGameCenterGameProfile, getIsTossLoginIntegratedService, getLocale, getNetworkStatus, getOperationalEnvironment, getPlatformOS, getSchemeUri, getTossAppVersion, getTossShareLink, getUserKeyForGame, grantPromotionRewardForGame, iapCreateOneTimePurchaseOrder, isMinVersionSupported, onVisibilityChangedByTransparentServiceWeb, openCamera, openGameCenterLeaderboard, openURL, processProductGrant, requestOneTimePurchase, saveBase64Data, setClipboardText, setDeviceOrientation, setIosSwipeGestureEnabled, setScreenAwakeMode, setSecureScreen, share, startUpdateLocation, submitGameCenterLeaderBoardScore };

package/dist/index.js

@@ -372,6 +372,30 @@ function createIsSupported() {
 }
 loadAppsInTossAdMob.isSupported = createIsSupported();
 showAppsInTossAdMob.isSupported = createIsSupported();
+async function isAppsInTossAdMobLoaded(params) {
+  if (!isAppsInTossAdMobLoadedSupported()) {
+    return false;
+  }
+  return new Promise((resolve, reject) => {
+    const unregister = INTERNAL__appBridgeHandler.invokeAppBridgeMethod(
+      "getCachedStatusAppsInTossAdmob",
+      {
+        ...params
+      },
+      {
+        onSuccess: (cached) => {
+          resolve(cached);
+          unregister();
+        },
+        onError: reject
+      }
+    );
+  });
+}
+function isAppsInTossAdMobLoadedSupported() {
+  return ENVIRONMENT !== "toss" ? false : isMinVersionSupported({ android: "5.244.0", ios: "5.244.0" });
+}
+isAppsInTossAdMobLoaded.isSupported = isAppsInTossAdMobLoadedSupported;
 
 // src/AppsInTossModule/native-modules/checkoutPayment.ts
 async function checkoutPayment(options) {
@@ -895,7 +919,8 @@ var TossPay = {
 };
 var GoogleAdMob = {
   loadAppsInTossAdMob,
-  showAppsInTossAdMob
+  showAppsInTossAdMob,
+  isAppsInTossAdMobLoaded
 };
 
 // src/AppsInTossModule/native-event-emitter/startUpdateLocation.ts

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@apps-in-toss/native-modules",
   "type": "module",
-  "version": "1.7.1",
+  "version": "1.8.0",
   "description": "Native Modules for Apps In Toss",
   "scripts": {
     "typecheck": "tsc --noEmit",
@@ -42,7 +42,7 @@
     "vitest": "^3.2.4"
   },
   "dependencies": {
-    "@apps-in-toss/types": "^1.7.1",
+    "@apps-in-toss/types": "^1.8.0",
     "es-toolkit": "^1.39.3"
   },
   "peerDependencies": {

package/src/AppsInTossModule/native-modules/ads/googleAdMobV2.ts

@@ -372,3 +372,48 @@ function createIsSupported() {
 
 loadAppsInTossAdMob.isSupported = createIsSupported();
 showAppsInTossAdMob.isSupported = createIsSupported();
+
+// MARK: - isAppsInTossAdMobLoaded
+
+export interface IsAdMobLoadedOptions {
+  /**
+   * 광고 그룹 단위 ID
+   */
+  adGroupId: string;
+}
+
+/**
+ * @public
+ * @category 광고
+ * @name showAppsInTossAdMob
+ * @description 이 함수는 `loadAppsInTossAdMob` 로 광고가 잘 불러와졌는지 확인해요.
+ * @param {string} params.adUnitId 광고 그룹 단위 ID예요.
+ * @property {() => boolean} [isSupported] 현재 실행 중인 앱(예: 토스 앱, 개발용 샌드박스 앱 등)에서 `isAppsInTossAdMobLoaded` 를 지원하는지 확인하는 함수예요. 기능을 사용하기 전에 지원 여부를 확인해야 해요.
+ */
+export async function isAppsInTossAdMobLoaded(params: IsAdMobLoadedOptions) {
+  if (!isAppsInTossAdMobLoadedSupported()) {
+    return false;
+  }
+
+  return new Promise<boolean>((resolve, reject) => {
+    const unregister = INTERNAL__appBridgeHandler.invokeAppBridgeMethod(
+      'getCachedStatusAppsInTossAdmob',
+      {
+        ...params,
+      },
+      {
+        onSuccess: (cached) => {
+          resolve(cached);
+          unregister();
+        },
+        onError: reject,
+      }
+    );
+  });
+}
+
+function isAppsInTossAdMobLoadedSupported() {
+  return ENVIRONMENT !== 'toss' ? false : isMinVersionSupported({ android: '5.244.0', ios: '5.244.0' });
+}
+
+isAppsInTossAdMobLoaded.isSupported = isAppsInTossAdMobLoadedSupported;

package/src/AppsInTossModule/native-modules/index.ts

@@ -8,6 +8,8 @@ import {
   type ShowAdMobParams,
   type ShowAdMobEvent,
   type ShowAdMobOptions,
+  isAppsInTossAdMobLoaded,
+  type IsAdMobLoadedOptions,
 } from './ads/googleAdMobV2';
 // TossPay
 import { checkoutPayment, type CheckoutPaymentOptions, type CheckoutPaymentResult } from './checkoutPayment';
@@ -53,6 +55,7 @@ export type {
   ShowAdMobParams,
   ShowAdMobEvent,
   ShowAdMobOptions,
+  IsAdMobLoadedOptions,
 };
 
 /**
@@ -71,10 +74,12 @@ export const TossPay = {
  * @category 광고
  * @name GoogleAdMob
  * @description Google AdMob 광고 관련 함수를 모아둔 객체예요.
- * @property {typeof loadAppsInTossAdMob} [loadAppsInTossAdMob] 광고를 로드하는 함수예요. 자세한 내용은 [loadAppsInTossAdMob](/react-native/reference/native-modules/광고/loadAppsInTossAdMob.html)를 참고하세요.
- * @property {typeof showAppsInTossAdMob} [showAppsInTossAdMob] 로드한 광고를 보여주는 함수예요. 자세한 내용은 [showAppsInTossAdMob](/react-native/reference/native-modules/광고/showAppsInTossAdMob.html)를 참고하세요.
+ * @property {typeof loadAppsInTossAdMob} [loadAppsInTossAdMob] 광고를 로드하는 함수예요.
+ * @property {typeof showAppsInTossAdMob} [showAppsInTossAdMob] 로드한 광고를 보여주는 함수예요.
+ * @property {typeof isAppsInTossAdMobLoaded} [isAppsInTossAdMobLoaded] 광고가 로드되었는지 확인하는 함수예요.
  */
 export const GoogleAdMob = {
   loadAppsInTossAdMob,
   showAppsInTossAdMob,
+  isAppsInTossAdMobLoaded,
 };