@apps-in-toss/types 1.9.3 → 1.10.0

package/dist/index.d.cts

@@ -306,4 +306,220 @@ type PermissionFunctionWithDialog<T extends (...args: any[]) => any> = T & {
     openPermissionDialog: PermissionDialogFunction;
 };
 
-export { Accuracy, type CompatiblePlaceholderArgument, type ContactEntity, type ContactResult, type CreatePermissionFunctionOptions, type FetchAlbumPhotos, type FetchAlbumPhotosOptions, FetchAlbumPhotosPermissionError, type FetchContacts, type FetchContactsOptions, FetchContactsPermissionError, type GetClipboardText, GetClipboardTextPermissionError, type GetCurrentLocation, type GetCurrentLocationOptions, GetCurrentLocationPermissionError, type GetPermissionFunction, type ImageResponse, type InternalGetPermissionFunction, type InternalPermissionDialogFunction, type Location, type LocationCoords, type OpenCamera, type OpenCameraOptions, OpenCameraPermissionError, type PermissionAccess, type PermissionDialogFunction, type PermissionErrorConstructorParams, type PermissionErrorType, type PermissionFunctionName, type PermissionFunctionWithDialog, type PermissionName, type PermissionStatus, type RequestPermissionFunction, type SetClipboardText, type SetClipboardTextOptions, SetClipboardTextPermissionError, type StartUpdateLocation, type StartUpdateLocationEventParams, type StartUpdateLocationOptions, StartUpdateLocationPermissionError };
+interface LoadFullScreenAdOptions {
+    adGroupId: string;
+}
+interface LoadFullScreenAdEvent {
+    type: 'loaded';
+}
+interface LoadFullScreenAdParams {
+    options: LoadFullScreenAdOptions;
+    onEvent: (data: LoadFullScreenAdEvent) => void;
+    onError: (err: unknown) => void;
+}
+interface ShowFullScreenAdOptions {
+    adGroupId: string;
+}
+type AdMobFullScreenEvent$1 = AdClicked$1 | AdDismissed$1 | AdFailedToShow$1 | AdImpression$1 | AdShow$1;
+type AdClicked$1 = {
+    type: 'clicked';
+};
+type AdDismissed$1 = {
+    type: 'dismissed';
+};
+type AdFailedToShow$1 = {
+    type: 'failedToShow';
+};
+type AdImpression$1 = {
+    type: 'impression';
+};
+type AdShow$1 = {
+    type: 'show';
+};
+type AdUserEarnedReward$1 = {
+    type: 'userEarnedReward';
+    data: {
+        unitType: string;
+        unitAmount: number;
+    };
+};
+type ShowFullScreenAdEvent = AdMobFullScreenEvent$1 | AdUserEarnedReward$1 | {
+    type: 'requested';
+};
+interface ShowFullScreenAdParams {
+    options: ShowFullScreenAdOptions;
+    onEvent: (data: ShowFullScreenAdEvent) => void;
+    onError: (err: unknown) => void;
+}
+
+interface FetchTossAdOptions {
+    adGroupId: string;
+    sdkId: string;
+    availableStyleIds: string[];
+}
+interface TossAdEventLogParams {
+    log_name: string;
+    log_type: string;
+    params: Record<string, unknown>;
+}
+
+/**
+ * @public
+ * @category 광고
+ * @name AdMobFullScreenEvent
+ * @description 앱 화면을 덮는 광고(예: 전면 광고, 보상형 광고)를 사용하는 경우에 발생하는 이벤트 타입이에요.
+ * @example
+ * ### 광고 이벤트 처리하기
+ * ```ts
+ * function handleEvent(event: AdMobFullScreenEvent) {
+ *   switch (event.type) {
+ *     case 'clicked':
+ *       console.log('광고가 클릭됐어요.');
+ *       break;
+ *
+ *     case 'dismissed':
+ *       console.log('광고가 닫혔어요.');
+ *       break;
+ *
+ *     case 'failedToShow':
+ *       console.log('광고가 보여지지 않았어요.');
+ *       break;
+ *
+ *     case 'impression':
+ *       console.log('광고가 노출됐어요.');
+ *       break;
+ *
+ *     case 'show':
+ *       console.log('광고가 보여졌어요.');
+ *       break;
+ *   }
+ * }
+ * ```
+ */
+type AdMobFullScreenEvent = AdClicked | AdDismissed | AdFailedToShow | AdImpression | AdShow;
+type AdClicked = {
+    type: 'clicked';
+};
+type AdDismissed = {
+    type: 'dismissed';
+};
+type AdFailedToShow = {
+    type: 'failedToShow';
+};
+type AdImpression = {
+    type: 'impression';
+};
+type AdShow = {
+    type: 'show';
+};
+type AdUserEarnedReward = {
+    type: 'userEarnedReward';
+    data: {
+        unitType: string;
+        unitAmount: number;
+    };
+};
+interface AdMobHandlerParams<Options = void, Event = AdMobFullScreenEvent> {
+    options: Options;
+    onEvent: (event: Event) => void;
+    onError: (error: unknown) => void;
+}
+/**
+ * @public
+ * @category 광고
+ * @name ResponseInfo
+ * @description 광고 로드 응답 정보를 담고 있는 객체예요.
+ * @property {Array<AdNetworkResponseInfo>} adNetworkInfoArray 광고 네트워크 응답 정보 배열예요.
+ * @property {AdNetworkResponseInfo | null} loadedAdNetworkInfo 로드된 광고 네트워크 응답 정보예요.
+ * @property {string | null} responseId 광고 응답 ID예요.
+ */
+interface ResponseInfo {
+    adNetworkInfoArray: Array<AdNetworkResponseInfo>;
+    loadedAdNetworkInfo: AdNetworkResponseInfo | null;
+    responseId: string | null;
+}
+/**
+ * @public
+ * @category 광고
+ * @name AdNetworkResponseInfo
+ * @description 광고 네트워크 응답 정보를 담고 있는 객체예요.
+ * @property {string} adSourceId 광고 소스 ID예요.
+ * @property {string} adSourceName 광고 소스 이름이예요.
+ * @property {string} adSourceInstanceId 광고 소스 인스턴스 ID예요.
+ * @property {string} adSourceInstanceName 광고 소스 인스턴스 이름이예요.
+ * @property {string | null} adNetworkClassName 광고 네트워크 클래스 이름이예요.
+ */
+interface AdNetworkResponseInfo {
+    adSourceId: string;
+    adSourceName: string;
+    adSourceInstanceId: string;
+    adSourceInstanceName: string;
+    adNetworkClassName: string | null;
+}
+/**
+ * @public
+ * @category 광고
+ * @name AdMobLoadResult
+ * @description 광고의 ID와 응답 정보를 담고 있는 객체예요. 광고를 로드한 뒤, 관련 정보를 확인할 때 유용해요.
+ * @property {string} adGroupId 광고 그룹 ID예요.
+ * @property {string} adUnitId 광고 ID예요.
+ * @property {ResponseInfo} responseInfo 광고 로드 응답 정보예요. 자세한 내용은 [ResponseInfo](/react-native/reference/native-modules/광고/ResponseInfo.html)를 참고하세요.
+ */
+interface AdMobLoadResult {
+    adGroupId: string;
+    adUnitId: string;
+    responseInfo: ResponseInfo;
+}
+interface LoadAdMobOptions {
+    /**
+     * 광고 그룹 단위 ID
+     */
+    adGroupId: string;
+}
+/**
+ * @public
+ * @category 광고
+ * @name LoadAdMobEvent
+ * @description 광고를 불러오는 함수에서 발생하는 이벤트 타입이에요. `loaded` 이벤트가 발생하면 광고를 성공적으로 불러온 거예요. 이때 [AdMobLoadResult](/react-native/reference/native-modules/광고/AdMobLoadResult.html) 객체가 함께 반환돼요.
+ */
+type LoadAdMobEvent = {
+    type: 'loaded';
+    data: AdMobLoadResult;
+};
+/**
+ * @public
+ * @category 광고
+ * @name LoadAdMobParams
+ * @description 광고를 불러오는 함수에 필요한 옵션 객체예요.
+ */
+type LoadAdMobParams = AdMobHandlerParams<LoadAdMobOptions, LoadAdMobEvent>;
+interface ShowAdMobOptions {
+    /**
+     * 광고 그룹 단위 ID
+     */
+    adGroupId: string;
+}
+/**
+ * @public
+ * @category 광고
+ * @name ShowAdMobEvent
+ * @description 광고를 보여주는 함수에서 발생하는 이벤트 타입이에요. `requested` 이벤트가 발생하면 광고 노출 요청이 Google AdMob에 성공적으로 전달된 거예요.
+ */
+type ShowAdMobEvent = AdMobFullScreenEvent | AdUserEarnedReward | {
+    type: 'requested';
+};
+/**
+ * @public
+ * @category 광고
+ * @name ShowAdMobParams
+ * @description 불러온 광고를 보여주는 함수에 필요한 옵션 객체예요.
+ */
+type ShowAdMobParams = AdMobHandlerParams<ShowAdMobOptions, ShowAdMobEvent>;
+interface IsAdMobLoadedOptions {
+    /**
+     * 광고 그룹 단위 ID
+     */
+    adGroupId: string;
+}
+
+export { Accuracy, type AdMobFullScreenEvent, type AdMobHandlerParams, type AdMobLoadResult, type AdNetworkResponseInfo, type AdUserEarnedReward, type CompatiblePlaceholderArgument, type ContactEntity, type ContactResult, type CreatePermissionFunctionOptions, type FetchAlbumPhotos, type FetchAlbumPhotosOptions, FetchAlbumPhotosPermissionError, type FetchContacts, type FetchContactsOptions, FetchContactsPermissionError, type FetchTossAdOptions, type GetClipboardText, GetClipboardTextPermissionError, type GetCurrentLocation, type GetCurrentLocationOptions, GetCurrentLocationPermissionError, type GetPermissionFunction, type ImageResponse, type InternalGetPermissionFunction, type InternalPermissionDialogFunction, type IsAdMobLoadedOptions, type LoadAdMobEvent, type LoadAdMobOptions, type LoadAdMobParams, type LoadFullScreenAdEvent, type LoadFullScreenAdOptions, type LoadFullScreenAdParams, type Location, type LocationCoords, type OpenCamera, type OpenCameraOptions, OpenCameraPermissionError, type PermissionAccess, type PermissionDialogFunction, type PermissionErrorConstructorParams, type PermissionErrorType, type PermissionFunctionName, type PermissionFunctionWithDialog, type PermissionName, type PermissionStatus, type RequestPermissionFunction, type ResponseInfo, type SetClipboardText, type SetClipboardTextOptions, SetClipboardTextPermissionError, type ShowAdMobEvent, type ShowAdMobOptions, type ShowAdMobParams, type ShowFullScreenAdEvent, type ShowFullScreenAdOptions, type ShowFullScreenAdParams, type StartUpdateLocation, type StartUpdateLocationEventParams, type StartUpdateLocationOptions, StartUpdateLocationPermissionError, type TossAdEventLogParams };

package/dist/index.d.ts

@@ -306,4 +306,220 @@ type PermissionFunctionWithDialog<T extends (...args: any[]) => any> = T & {
     openPermissionDialog: PermissionDialogFunction;
 };
 
-export { Accuracy, type CompatiblePlaceholderArgument, type ContactEntity, type ContactResult, type CreatePermissionFunctionOptions, type FetchAlbumPhotos, type FetchAlbumPhotosOptions, FetchAlbumPhotosPermissionError, type FetchContacts, type FetchContactsOptions, FetchContactsPermissionError, type GetClipboardText, GetClipboardTextPermissionError, type GetCurrentLocation, type GetCurrentLocationOptions, GetCurrentLocationPermissionError, type GetPermissionFunction, type ImageResponse, type InternalGetPermissionFunction, type InternalPermissionDialogFunction, type Location, type LocationCoords, type OpenCamera, type OpenCameraOptions, OpenCameraPermissionError, type PermissionAccess, type PermissionDialogFunction, type PermissionErrorConstructorParams, type PermissionErrorType, type PermissionFunctionName, type PermissionFunctionWithDialog, type PermissionName, type PermissionStatus, type RequestPermissionFunction, type SetClipboardText, type SetClipboardTextOptions, SetClipboardTextPermissionError, type StartUpdateLocation, type StartUpdateLocationEventParams, type StartUpdateLocationOptions, StartUpdateLocationPermissionError };
+interface LoadFullScreenAdOptions {
+    adGroupId: string;
+}
+interface LoadFullScreenAdEvent {
+    type: 'loaded';
+}
+interface LoadFullScreenAdParams {
+    options: LoadFullScreenAdOptions;
+    onEvent: (data: LoadFullScreenAdEvent) => void;
+    onError: (err: unknown) => void;
+}
+interface ShowFullScreenAdOptions {
+    adGroupId: string;
+}
+type AdMobFullScreenEvent$1 = AdClicked$1 | AdDismissed$1 | AdFailedToShow$1 | AdImpression$1 | AdShow$1;
+type AdClicked$1 = {
+    type: 'clicked';
+};
+type AdDismissed$1 = {
+    type: 'dismissed';
+};
+type AdFailedToShow$1 = {
+    type: 'failedToShow';
+};
+type AdImpression$1 = {
+    type: 'impression';
+};
+type AdShow$1 = {
+    type: 'show';
+};
+type AdUserEarnedReward$1 = {
+    type: 'userEarnedReward';
+    data: {
+        unitType: string;
+        unitAmount: number;
+    };
+};
+type ShowFullScreenAdEvent = AdMobFullScreenEvent$1 | AdUserEarnedReward$1 | {
+    type: 'requested';
+};
+interface ShowFullScreenAdParams {
+    options: ShowFullScreenAdOptions;
+    onEvent: (data: ShowFullScreenAdEvent) => void;
+    onError: (err: unknown) => void;
+}
+
+interface FetchTossAdOptions {
+    adGroupId: string;
+    sdkId: string;
+    availableStyleIds: string[];
+}
+interface TossAdEventLogParams {
+    log_name: string;
+    log_type: string;
+    params: Record<string, unknown>;
+}
+
+/**
+ * @public
+ * @category 광고
+ * @name AdMobFullScreenEvent
+ * @description 앱 화면을 덮는 광고(예: 전면 광고, 보상형 광고)를 사용하는 경우에 발생하는 이벤트 타입이에요.
+ * @example
+ * ### 광고 이벤트 처리하기
+ * ```ts
+ * function handleEvent(event: AdMobFullScreenEvent) {
+ *   switch (event.type) {
+ *     case 'clicked':
+ *       console.log('광고가 클릭됐어요.');
+ *       break;
+ *
+ *     case 'dismissed':
+ *       console.log('광고가 닫혔어요.');
+ *       break;
+ *
+ *     case 'failedToShow':
+ *       console.log('광고가 보여지지 않았어요.');
+ *       break;
+ *
+ *     case 'impression':
+ *       console.log('광고가 노출됐어요.');
+ *       break;
+ *
+ *     case 'show':
+ *       console.log('광고가 보여졌어요.');
+ *       break;
+ *   }
+ * }
+ * ```
+ */
+type AdMobFullScreenEvent = AdClicked | AdDismissed | AdFailedToShow | AdImpression | AdShow;
+type AdClicked = {
+    type: 'clicked';
+};
+type AdDismissed = {
+    type: 'dismissed';
+};
+type AdFailedToShow = {
+    type: 'failedToShow';
+};
+type AdImpression = {
+    type: 'impression';
+};
+type AdShow = {
+    type: 'show';
+};
+type AdUserEarnedReward = {
+    type: 'userEarnedReward';
+    data: {
+        unitType: string;
+        unitAmount: number;
+    };
+};
+interface AdMobHandlerParams<Options = void, Event = AdMobFullScreenEvent> {
+    options: Options;
+    onEvent: (event: Event) => void;
+    onError: (error: unknown) => void;
+}
+/**
+ * @public
+ * @category 광고
+ * @name ResponseInfo
+ * @description 광고 로드 응답 정보를 담고 있는 객체예요.
+ * @property {Array<AdNetworkResponseInfo>} adNetworkInfoArray 광고 네트워크 응답 정보 배열예요.
+ * @property {AdNetworkResponseInfo | null} loadedAdNetworkInfo 로드된 광고 네트워크 응답 정보예요.
+ * @property {string | null} responseId 광고 응답 ID예요.
+ */
+interface ResponseInfo {
+    adNetworkInfoArray: Array<AdNetworkResponseInfo>;
+    loadedAdNetworkInfo: AdNetworkResponseInfo | null;
+    responseId: string | null;
+}
+/**
+ * @public
+ * @category 광고
+ * @name AdNetworkResponseInfo
+ * @description 광고 네트워크 응답 정보를 담고 있는 객체예요.
+ * @property {string} adSourceId 광고 소스 ID예요.
+ * @property {string} adSourceName 광고 소스 이름이예요.
+ * @property {string} adSourceInstanceId 광고 소스 인스턴스 ID예요.
+ * @property {string} adSourceInstanceName 광고 소스 인스턴스 이름이예요.
+ * @property {string | null} adNetworkClassName 광고 네트워크 클래스 이름이예요.
+ */
+interface AdNetworkResponseInfo {
+    adSourceId: string;
+    adSourceName: string;
+    adSourceInstanceId: string;
+    adSourceInstanceName: string;
+    adNetworkClassName: string | null;
+}
+/**
+ * @public
+ * @category 광고
+ * @name AdMobLoadResult
+ * @description 광고의 ID와 응답 정보를 담고 있는 객체예요. 광고를 로드한 뒤, 관련 정보를 확인할 때 유용해요.
+ * @property {string} adGroupId 광고 그룹 ID예요.
+ * @property {string} adUnitId 광고 ID예요.
+ * @property {ResponseInfo} responseInfo 광고 로드 응답 정보예요. 자세한 내용은 [ResponseInfo](/react-native/reference/native-modules/광고/ResponseInfo.html)를 참고하세요.
+ */
+interface AdMobLoadResult {
+    adGroupId: string;
+    adUnitId: string;
+    responseInfo: ResponseInfo;
+}
+interface LoadAdMobOptions {
+    /**
+     * 광고 그룹 단위 ID
+     */
+    adGroupId: string;
+}
+/**
+ * @public
+ * @category 광고
+ * @name LoadAdMobEvent
+ * @description 광고를 불러오는 함수에서 발생하는 이벤트 타입이에요. `loaded` 이벤트가 발생하면 광고를 성공적으로 불러온 거예요. 이때 [AdMobLoadResult](/react-native/reference/native-modules/광고/AdMobLoadResult.html) 객체가 함께 반환돼요.
+ */
+type LoadAdMobEvent = {
+    type: 'loaded';
+    data: AdMobLoadResult;
+};
+/**
+ * @public
+ * @category 광고
+ * @name LoadAdMobParams
+ * @description 광고를 불러오는 함수에 필요한 옵션 객체예요.
+ */
+type LoadAdMobParams = AdMobHandlerParams<LoadAdMobOptions, LoadAdMobEvent>;
+interface ShowAdMobOptions {
+    /**
+     * 광고 그룹 단위 ID
+     */
+    adGroupId: string;
+}
+/**
+ * @public
+ * @category 광고
+ * @name ShowAdMobEvent
+ * @description 광고를 보여주는 함수에서 발생하는 이벤트 타입이에요. `requested` 이벤트가 발생하면 광고 노출 요청이 Google AdMob에 성공적으로 전달된 거예요.
+ */
+type ShowAdMobEvent = AdMobFullScreenEvent | AdUserEarnedReward | {
+    type: 'requested';
+};
+/**
+ * @public
+ * @category 광고
+ * @name ShowAdMobParams
+ * @description 불러온 광고를 보여주는 함수에 필요한 옵션 객체예요.
+ */
+type ShowAdMobParams = AdMobHandlerParams<ShowAdMobOptions, ShowAdMobEvent>;
+interface IsAdMobLoadedOptions {
+    /**
+     * 광고 그룹 단위 ID
+     */
+    adGroupId: string;
+}
+
+export { Accuracy, type AdMobFullScreenEvent, type AdMobHandlerParams, type AdMobLoadResult, type AdNetworkResponseInfo, type AdUserEarnedReward, type CompatiblePlaceholderArgument, type ContactEntity, type ContactResult, type CreatePermissionFunctionOptions, type FetchAlbumPhotos, type FetchAlbumPhotosOptions, FetchAlbumPhotosPermissionError, type FetchContacts, type FetchContactsOptions, FetchContactsPermissionError, type FetchTossAdOptions, type GetClipboardText, GetClipboardTextPermissionError, type GetCurrentLocation, type GetCurrentLocationOptions, GetCurrentLocationPermissionError, type GetPermissionFunction, type ImageResponse, type InternalGetPermissionFunction, type InternalPermissionDialogFunction, type IsAdMobLoadedOptions, type LoadAdMobEvent, type LoadAdMobOptions, type LoadAdMobParams, type LoadFullScreenAdEvent, type LoadFullScreenAdOptions, type LoadFullScreenAdParams, type Location, type LocationCoords, type OpenCamera, type OpenCameraOptions, OpenCameraPermissionError, type PermissionAccess, type PermissionDialogFunction, type PermissionErrorConstructorParams, type PermissionErrorType, type PermissionFunctionName, type PermissionFunctionWithDialog, type PermissionName, type PermissionStatus, type RequestPermissionFunction, type ResponseInfo, type SetClipboardText, type SetClipboardTextOptions, SetClipboardTextPermissionError, type ShowAdMobEvent, type ShowAdMobOptions, type ShowAdMobParams, type ShowFullScreenAdEvent, type ShowFullScreenAdOptions, type ShowFullScreenAdParams, type StartUpdateLocation, type StartUpdateLocationEventParams, type StartUpdateLocationOptions, StartUpdateLocationPermissionError, type TossAdEventLogParams };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@apps-in-toss/types",
   "type": "module",
-  "version": "1.9.3",
+  "version": "1.10.0",
   "description": "Types for Apps In Toss",
   "scripts": {
     "typecheck": "tsc --noEmit",

package/src/googleAdMobV2/index.ts

@@ -0,0 +1,153 @@
+/**
+ * @public
+ * @category 광고
+ * @name AdMobFullScreenEvent
+ * @description 앱 화면을 덮는 광고(예: 전면 광고, 보상형 광고)를 사용하는 경우에 발생하는 이벤트 타입이에요.
+ * @example
+ * ### 광고 이벤트 처리하기
+ * ```ts
+ * function handleEvent(event: AdMobFullScreenEvent) {
+ *   switch (event.type) {
+ *     case 'clicked':
+ *       console.log('광고가 클릭됐어요.');
+ *       break;
+ *
+ *     case 'dismissed':
+ *       console.log('광고가 닫혔어요.');
+ *       break;
+ *
+ *     case 'failedToShow':
+ *       console.log('광고가 보여지지 않았어요.');
+ *       break;
+ *
+ *     case 'impression':
+ *       console.log('광고가 노출됐어요.');
+ *       break;
+ *
+ *     case 'show':
+ *       console.log('광고가 보여졌어요.');
+ *       break;
+ *   }
+ * }
+ * ```
+ */
+export type AdMobFullScreenEvent = AdClicked | AdDismissed | AdFailedToShow | AdImpression | AdShow;
+
+type AdClicked = { type: 'clicked' };
+type AdDismissed = { type: 'dismissed' };
+type AdFailedToShow = { type: 'failedToShow' };
+type AdImpression = { type: 'impression' };
+type AdShow = { type: 'show' };
+
+export type AdUserEarnedReward = { type: 'userEarnedReward'; data: { unitType: string; unitAmount: number } };
+
+export interface AdMobHandlerParams<Options = void, Event = AdMobFullScreenEvent> {
+  options: Options;
+  onEvent: (event: Event) => void;
+  onError: (error: unknown) => void;
+}
+
+/**
+ * @public
+ * @category 광고
+ * @name ResponseInfo
+ * @description 광고 로드 응답 정보를 담고 있는 객체예요.
+ * @property {Array<AdNetworkResponseInfo>} adNetworkInfoArray 광고 네트워크 응답 정보 배열예요.
+ * @property {AdNetworkResponseInfo | null} loadedAdNetworkInfo 로드된 광고 네트워크 응답 정보예요.
+ * @property {string | null} responseId 광고 응답 ID예요.
+ */
+export interface ResponseInfo {
+  adNetworkInfoArray: Array<AdNetworkResponseInfo>;
+  loadedAdNetworkInfo: AdNetworkResponseInfo | null;
+  responseId: string | null;
+}
+
+/**
+ * @public
+ * @category 광고
+ * @name AdNetworkResponseInfo
+ * @description 광고 네트워크 응답 정보를 담고 있는 객체예요.
+ * @property {string} adSourceId 광고 소스 ID예요.
+ * @property {string} adSourceName 광고 소스 이름이예요.
+ * @property {string} adSourceInstanceId 광고 소스 인스턴스 ID예요.
+ * @property {string} adSourceInstanceName 광고 소스 인스턴스 이름이예요.
+ * @property {string | null} adNetworkClassName 광고 네트워크 클래스 이름이예요.
+ */
+export interface AdNetworkResponseInfo {
+  adSourceId: string;
+  adSourceName: string;
+  adSourceInstanceId: string;
+  adSourceInstanceName: string;
+  adNetworkClassName: string | null;
+}
+
+/**
+ * @public
+ * @category 광고
+ * @name AdMobLoadResult
+ * @description 광고의 ID와 응답 정보를 담고 있는 객체예요. 광고를 로드한 뒤, 관련 정보를 확인할 때 유용해요.
+ * @property {string} adGroupId 광고 그룹 ID예요.
+ * @property {string} adUnitId 광고 ID예요.
+ * @property {ResponseInfo} responseInfo 광고 로드 응답 정보예요. 자세한 내용은 [ResponseInfo](/react-native/reference/native-modules/광고/ResponseInfo.html)를 참고하세요.
+ */
+export interface AdMobLoadResult {
+  adGroupId: string;
+  adUnitId: string;
+  responseInfo: ResponseInfo;
+}
+
+export interface LoadAdMobOptions {
+  /**
+   * 광고 그룹 단위 ID
+   */
+  adGroupId: string;
+}
+
+/**
+ * @public
+ * @category 광고
+ * @name LoadAdMobEvent
+ * @description 광고를 불러오는 함수에서 발생하는 이벤트 타입이에요. `loaded` 이벤트가 발생하면 광고를 성공적으로 불러온 거예요. 이때 [AdMobLoadResult](/react-native/reference/native-modules/광고/AdMobLoadResult.html) 객체가 함께 반환돼요.
+ */
+export type LoadAdMobEvent = {
+  type: 'loaded';
+  data: AdMobLoadResult;
+};
+
+/**
+ * @public
+ * @category 광고
+ * @name LoadAdMobParams
+ * @description 광고를 불러오는 함수에 필요한 옵션 객체예요.
+ */
+export type LoadAdMobParams = AdMobHandlerParams<LoadAdMobOptions, LoadAdMobEvent>;
+
+export interface ShowAdMobOptions {
+  /**
+   * 광고 그룹 단위 ID
+   */
+  adGroupId: string;
+}
+
+/**
+ * @public
+ * @category 광고
+ * @name ShowAdMobEvent
+ * @description 광고를 보여주는 함수에서 발생하는 이벤트 타입이에요. `requested` 이벤트가 발생하면 광고 노출 요청이 Google AdMob에 성공적으로 전달된 거예요.
+ */
+export type ShowAdMobEvent = AdMobFullScreenEvent | AdUserEarnedReward | { type: 'requested' };
+
+/**
+ * @public
+ * @category 광고
+ * @name ShowAdMobParams
+ * @description 불러온 광고를 보여주는 함수에 필요한 옵션 객체예요.
+ */
+export type ShowAdMobParams = AdMobHandlerParams<ShowAdMobOptions, ShowAdMobEvent>;
+
+export interface IsAdMobLoadedOptions {
+  /**
+   * 광고 그룹 단위 ID
+   */
+  adGroupId: string;
+}

package/src/index.ts

@@ -1 +1,4 @@
 export * from './permissions';
+export * from './integratedAd';
+export * from './tossAd';
+export * from './googleAdMobV2';

package/src/integratedAd/index.ts

@@ -0,0 +1,35 @@
+export interface LoadFullScreenAdOptions {
+  adGroupId: string;
+}
+
+export interface LoadFullScreenAdEvent {
+  type: 'loaded';
+}
+
+export interface LoadFullScreenAdParams {
+  options: LoadFullScreenAdOptions;
+  onEvent: (data: LoadFullScreenAdEvent) => void;
+  onError: (err: unknown) => void;
+}
+
+export interface ShowFullScreenAdOptions {
+  adGroupId: string;
+}
+
+type AdMobFullScreenEvent = AdClicked | AdDismissed | AdFailedToShow | AdImpression | AdShow;
+
+type AdClicked = { type: 'clicked' };
+type AdDismissed = { type: 'dismissed' };
+type AdFailedToShow = { type: 'failedToShow' };
+type AdImpression = { type: 'impression' };
+type AdShow = { type: 'show' };
+
+type AdUserEarnedReward = { type: 'userEarnedReward'; data: { unitType: string; unitAmount: number } };
+
+export type ShowFullScreenAdEvent = AdMobFullScreenEvent | AdUserEarnedReward | { type: 'requested' };
+
+export interface ShowFullScreenAdParams {
+  options: ShowFullScreenAdOptions;
+  onEvent: (data: ShowFullScreenAdEvent) => void;
+  onError: (err: unknown) => void;
+}

package/src/tossAd/index.ts

@@ -0,0 +1,11 @@
+export interface FetchTossAdOptions {
+  adGroupId: string;
+  sdkId: string;
+  availableStyleIds: string[];
+}
+
+export interface TossAdEventLogParams {
+  log_name: string;
+  log_type: string;
+  params: Record<string, unknown>;
+}