@apps-in-toss/web-framework 2.6.1 → 3.0.0-beta.9d42c0b

package/dist/core.d.ts

@@ -0,0 +1,906 @@
+import * as _apps_in_toss_webview_bridge_spec from '@apps-in-toss/webview-bridge/spec';
+import { LoadAppsInTossAdmobParams, LoadAppsInTossAdmobResult, ShowAppsInTossAdmobParams, ShowAppsInTossAdmobEvent, GetCachedStatusAppsInTossAdmobParams, LoadTossAdOrAdmobParams, ShowTossAdOrAdmobParams, LoadFullScreenAdOptions, LoadFullScreenAdEvent, ShowFullScreenAdOptions, ShowFullScreenAdEvent, GetAnonymousKeyResponse, AppLoginResponse, AppsInTossSignTossCertParams, CheckoutPaymentParams, CheckoutPaymentResult, FetchContactsResult, ContactsViralParams as ContactsViralParams$1, ContactsViralEvent, ContactsViralCloseEvent, FetchContactsParams, ContactsViralRewardEvent, AppsInTossGlobals, EventLogParams as EventLogParams$1, GameCenterGameProfileResponse, GrantPromotionRewardParams, GrantPromotionRewardResponse, SubmitGameCenterLeaderBoardScoreResponse, IapCreateOneTimePurchaseOrderResult, GetSubscriptionInfoResult, Location, FetchAlbumPhotosParams, OpenCameraParams, AddAccessoryButtonParams, PermissionStatus, PermissionName, PermissionAccess, SafeAreaInsets as SafeAreaInsets$2, SaveBase64DataParams, DeviceOrientation, OpenPDFViewerParams, OpenPDFViewerResult, FetchAlbumItemsOptions, AlbumItemResponse, RequestTossPayPaysBillingParams, RequestTossPayPaysBillingResult, RequestNotificationAgreementParams, NotificationAgreementResult, ImageResponse, LogParam } from '@apps-in-toss/webview-bridge/spec';
+export { AlbumItemResponse, AlbumItemType, AppsInTossGlobals, AppsInTossSignTossCertParams, CheckoutPaymentResult, CompletedOrRefundedOrdersResult, ConsumableProductListItem, ContactEntity, ContactsViralEvent, ContactsViralParams as ContactsViralOption, FetchAlbumItemsOptions, FetchTossAdOptions, GameCenterGameProfileResponse, GetAnonymousKeyResponse, GrantPromotionRewardParams, GrantPromotionRewardResponse, IapCreateOneTimePurchaseOrderResult, IapProductListItem, IapSubscriptionInfoResult, ImageResponse, LoadFullScreenAdEvent, LoadFullScreenAdOptions, Location, LocationCoords, NonConsumableProductListItem, NotificationAgreementResult, Offer, OpenPDFViewerParams, OpenPDFViewerResult, PermissionAccess, PermissionName, PermissionStatus, RequestTossPayPaysBillingParams, RequestTossPayPaysBillingResult, SaveBase64DataParams, ShowFullScreenAdEvent, ShowFullScreenAdOptions, ShowTossAdOrAdmobEvent, SubmitGameCenterLeaderBoardScoreResponse, SubscriptionProductListItem, TossAdEventLogParams } from '@apps-in-toss/webview-bridge/spec';
+
+type LoadAdMobOptions = LoadAppsInTossAdmobParams;
+type LoadAdMobResult = LoadAppsInTossAdmobResult;
+type ShowAdMobOptions = ShowAppsInTossAdmobParams;
+type ShowAdMobEvent = ShowAppsInTossAdmobEvent;
+type IsAdMobLoadedOptions = GetCachedStatusAppsInTossAdmobParams;
+type LoadAdMobEvent = {
+    type: "loaded";
+    data: LoadAdMobResult;
+};
+type LoadTossAdOrAdmobOptions = LoadTossAdOrAdmobParams;
+type ShowTossAdOrAdmobOptions = ShowTossAdOrAdmobParams;
+type TossAdOrAdmobRewardData = {
+    unitType: string;
+    unitAmount: number;
+};
+
+declare const GoogleAdMob: {
+    /**
+     * @public
+     * @category 광고
+     * @name loadAppsInTossAdMob
+     * @description 광고를 미리 불러와서, 광고가 필요한 시점에 바로 보여줄 수 있도록 준비하는 함수예요.
+     * @param {object} params 광고를 불러올 때 사용할 설정 값이에요.
+     * @param {LoadAdMobOptions} params.options 광고를 불러올 때 전달할 옵션 객체예요.
+     * @param {string} params.options.adGroupId 광고 그룹 단위 ID예요.
+     * @param {(event: LoadAdMobEvent) => void} [params.onEvent] 광고 관련 이벤트가 발생했을 때 호출돼요.
+     * @param {(reason: unknown) => void} [params.onError] 광고를 불러오지 못했을 때 호출돼요.
+     * @property {() => boolean} [isSupported] 현재 환경에서 Google AdMob 광고 기능을 지원하는지 확인하는 함수예요.
+     */
+    loadAppsInTossAdMob: ((params: {
+        options: LoadAdMobOptions;
+        onEvent: (event: LoadAdMobEvent) => void;
+        onError: (error: unknown) => void;
+    }) => () => void) & {
+        isSupported: () => boolean;
+    };
+    /**
+     * @public
+     * @category 광고
+     * @name showAppsInTossAdMob
+     * @description 광고를 사용자에게 노출해요.
+     * @param {object} params 광고를 보여주기 위해 사용할 설정 값이에요.
+     * @param {ShowAdMobOptions} params.options 광고를 보여줄 때 전달할 옵션 객체예요.
+     * @param {string} params.options.adGroupId 광고 그룹 단위 ID예요.
+     * @param {(event: ShowAdMobEvent) => void} [params.onEvent] 광고 관련 이벤트가 발생했을 때 호출돼요.
+     * @param {(reason: unknown) => void} [params.onError] 광고를 노출하지 못했을 때 호출돼요.
+     * @property {() => boolean} [isSupported] 현재 환경에서 Google AdMob 광고 기능을 지원하는지 확인하는 함수예요.
+     */
+    showAppsInTossAdMob: ((params: {
+        options: ShowAdMobOptions;
+        onEvent: (event: ShowAdMobEvent) => void;
+        onError: (error: unknown) => void;
+    }) => () => void) & {
+        isSupported: () => boolean;
+    };
+    /**
+     * @public
+     * @category 광고
+     * @name isAppsInTossAdMobLoaded
+     * @description 광고가 잘 불러와졌는지 확인해요.
+     * @param {IsAdMobLoadedOptions} options 광고 그룹 단위 ID가 포함된 옵션 객체예요.
+     * @property {() => boolean} [isSupported] 현재 환경에서 지원하는지 확인하는 함수예요.
+     */
+    isAppsInTossAdMobLoaded: ((options: IsAdMobLoadedOptions) => Promise<boolean>) & {
+        isSupported: () => boolean;
+    };
+};
+
+declare const loadFullScreenAd: ((params: {
+    options: LoadFullScreenAdOptions;
+    onEvent: (event: LoadFullScreenAdEvent) => void;
+    onError: (error: unknown) => void;
+}) => () => void) & {
+    isSupported: () => boolean;
+};
+declare const showFullScreenAd: ((params: {
+    options: ShowFullScreenAdOptions;
+    onEvent: (event: ShowFullScreenAdEvent) => void;
+    onError: (error: unknown) => void;
+}) => () => void) & {
+    isSupported: () => boolean;
+};
+
+type Environment = 'alpha' | 'live';
+type DeviceOS = 'IOS' | 'ANDROID';
+type DeviceAttStatus = 'NOT_DETERMINED' | 'RESTRICTED' | 'DENIED' | 'AUTHORIZED';
+type DeviceCarrier = 'SKT' | 'KT' | 'LGU' | 'SKT_MVNO' | 'KT_MVNO' | 'LG_MVNO';
+type RequestHeaders = Record<string, string>;
+interface DeviceInfo {
+    os?: DeviceOS;
+    osVersion?: string;
+    ua?: string;
+    ifa?: string;
+    ifv?: string | null;
+    attStatus?: DeviceAttStatus | null;
+    model?: string;
+    carrier?: DeviceCarrier;
+}
+interface SafeAreaInsets$1 {
+    top: string;
+    bottom: string;
+    left: string;
+    right: string;
+}
+interface RuntimeInfo {
+    safeAreaInsets?: SafeAreaInsets$1;
+}
+type AdOpener = (url: string, target?: string, features?: string) => void;
+interface AdConfig {
+    environment: Environment;
+    apiEndpoint?: string;
+    deviceInfo?: DeviceInfo;
+    requestHeaders?: RequestHeaders;
+    runtimeInfo?: RuntimeInfo;
+    opener?: AdOpener;
+    customAdFetcher?: CustomAdFetcher;
+}
+interface AdRequest {
+    spaceUnitId: string;
+    options?: {
+        dummyAdFormat?: string;
+        maxSize?: number;
+        video?: {
+            maxDurationMs?: number;
+        };
+    };
+}
+type AdResponseStatus = 'OK' | 'NO_AD' | 'BLOCKED' | 'ERROR' | 'TIMEOUT' | 'INVALID_SPACE' | 'INVALID_REQUEST' | 'LIMITED_AD' | 'CONSENT_REQUIRED' | 'TEST_MODE';
+interface AdResponse {
+    requestId?: string;
+    status?: AdResponseStatus;
+    ads: Ad[];
+    ext?: AdResponseExt;
+}
+interface Ad {
+    styleId: string;
+    creative: Record<string, any>;
+    eventTrackingUrls?: string[];
+    eventTypes?: string[];
+    eventPayload?: string;
+    requestId?: string;
+}
+interface AdResponseExt {
+    skippableOffsetSeconds?: number;
+    reward?: {
+        type: string;
+        amount: number;
+    };
+    isAdBadgeEnabled?: boolean;
+    refetchSeconds?: number | null;
+}
+interface ApiResponse<T> {
+    resultType: 'SUCCESS' | 'HTTP_TIMEOUT' | 'NETWORK_ERROR' | 'EXECUTION_FAIL' | 'INTERRUPTED' | 'INTERNAL_ERROR' | 'FAIL';
+    success?: T;
+    error?: {
+        errorType?: number;
+        errorCode?: string;
+        reason?: string;
+        data?: Record<string, any>;
+        title?: string;
+    };
+}
+type CustomAdFetcher = (endpoint: string, request: AdRequest, headers?: RequestHeaders) => Promise<ApiResponse<AdResponse>>;
+interface InitializeOptions {
+    callbacks?: {
+        onInitialized?: () => void;
+        onInitializationFailed?: (error: Error) => void;
+    };
+}
+interface BannerSlotEventPayload {
+    slotId: string;
+    adGroupId: string;
+    adMetadata: {
+        creativeId: string;
+        requestId: string;
+    };
+}
+interface BannerSlotErrorPayload {
+    slotId: string;
+    adGroupId: string;
+    adMetadata: Record<string, never>;
+    error: {
+        code: number;
+        message: string;
+        domain?: string;
+    };
+}
+interface BannerSlotCallbacks {
+    onAdRendered?: (payload: BannerSlotEventPayload) => void;
+    onAdViewable?: (payload: BannerSlotEventPayload) => void;
+    onAdClicked?: (payload: BannerSlotEventPayload) => void;
+    onAdImpression?: (payload: BannerSlotEventPayload) => void;
+    onAdFailedToRender?: (payload: BannerSlotErrorPayload) => void;
+    onNoFill?: (payload: {
+        slotId: string;
+        adGroupId: string;
+        adMetadata: Record<string, never>;
+    }) => void;
+}
+interface BannerSlotOptions {
+    spaceId: string;
+    autoLoad?: boolean;
+    dummyAdFormat?: string;
+    maxVideoDurationMs?: number;
+    refetchIntervalMs?: number;
+    theme?: 'light' | 'dark';
+    padding?: string;
+    renderPadding?: (styleId: string) => string;
+    callbacks?: BannerSlotCallbacks;
+}
+interface BannerSlot {
+    load(): void | Promise<void>;
+    destroy(): void;
+}
+interface BannerNamespace {
+    createSlot(target: string | HTMLElement, options: BannerSlotOptions): BannerSlot;
+    destroy(slotId: string): void;
+    destroyAll(): void;
+}
+interface AdsSdkGlobal {
+    init(config: AdConfig): void;
+    banner: BannerNamespace;
+    isInitialized(): boolean;
+}
+declare global {
+    interface Window {
+        TossAdsSpaceKit?: AdsSdkGlobal;
+    }
+}
+interface AttachOptions {
+    theme?: 'light' | 'dark';
+    padding?: string;
+    callbacks?: BannerSlotCallbacks;
+}
+interface AttachBannerOptions {
+    theme?: 'auto' | 'light' | 'dark';
+    tone?: 'blackAndWhite' | 'grey';
+    variant?: 'card' | 'expanded';
+    callbacks?: BannerSlotCallbacks;
+}
+interface AttachBannerResult {
+    destroy: () => void;
+}
+
+declare function initialize(options: InitializeOptions): void;
+/**
+ * @deprecated attach는 더 이상 권장되지 않습니다. attachBanner를 사용해주세요.
+ */
+declare function attach(adGroupId: string, target: string | HTMLElement, options?: AttachOptions): void;
+declare function attachBanner(adGroupId: string, target: string | HTMLElement, options?: AttachBannerOptions): AttachBannerResult;
+declare function destroy(slotId: string): void;
+declare function destroyAll(): void;
+declare const TossAds: {
+    initialize: typeof initialize & {
+        isSupported: () => boolean;
+    };
+    /**
+     * @deprecated attach는 더 이상 권장되지 않습니다. attachBanner를 사용해주세요.
+     */
+    attach: typeof attach & {
+        isSupported: () => boolean;
+    };
+    attachBanner: typeof attachBanner & {
+        isSupported: () => boolean;
+    };
+    destroy: typeof destroy & {
+        isSupported: () => boolean;
+    };
+    destroyAll: typeof destroyAll & {
+        isSupported: () => boolean;
+    };
+};
+
+declare function getAnonymousKey(): Promise<GetAnonymousKeyResponse>;
+
+declare function appLogin(): Promise<AppLoginResponse>;
+
+declare function appsInTossSignTossCert(params: AppsInTossSignTossCertParams): Promise<void>;
+
+type CheckoutPaymentOptions = CheckoutPaymentParams;
+
+declare function checkoutPayment(options: {
+    params: CheckoutPaymentOptions;
+}): Promise<CheckoutPaymentResult>;
+
+declare const getClipboardText: PermissionFunctionWithDialog<() => Promise<string>>;
+
+declare const setClipboardText: PermissionFunctionWithDialog<(text: string) => Promise<void>>;
+
+declare function getDeviceId(): string;
+
+declare function getGroupId(): string;
+
+declare function getLocale(): string;
+
+declare function getOperationalEnvironment(): "toss" | "sandbox";
+
+declare function getPlatformOS(): "ios" | "android";
+
+declare function getSchemeUri(): string;
+
+declare function getTossAppVersion(): string;
+
+type FetchContactsOptions = FetchContactsParams;
+type ContactResult = FetchContactsResult;
+type RewardFromContactsViralEvent = ContactsViralRewardEvent;
+type ContactsViralSuccessEvent = ContactsViralCloseEvent;
+interface ContactsViralParams {
+    options: ContactsViralParams$1;
+    onEvent: (event: ContactsViralEvent) => void;
+    onError: (error: unknown) => void;
+}
+
+declare function contactsViral(params: ContactsViralParams): () => void;
+
+declare const fetchContacts: PermissionFunctionWithDialog<(options: FetchContactsOptions) => Promise<_apps_in_toss_webview_bridge_spec.FetchContactsResult>>;
+
+declare const env: {
+    getDeploymentId: () => string;
+};
+
+declare function getAppsInTossGlobals(): AppsInTossGlobals;
+
+declare function isMinVersionSupported(minVersions: {
+    android: `${number}.${number}.${number}` | "always" | "never";
+    ios: `${number}.${number}.${number}` | "always" | "never";
+}): boolean;
+
+declare function eventLog(params: EventLogParams$1): Promise<void>;
+
+type GraniteEvent = {
+    backEvent: {
+        onEvent: () => void;
+        onError?: (error: Error) => void;
+        options?: void;
+    };
+    homeEvent: {
+        onEvent: () => void;
+        onError?: (error: Error) => void;
+        options?: void;
+    };
+};
+type AppsInTossEvent = {};
+type TdsEvent = {
+    navigationAccessoryEvent: {
+        onEvent: (data: {
+            id: string;
+        }) => void;
+        onError?: (error: Error) => void;
+        options: undefined;
+    };
+};
+
+declare const appsInTossEvent: {
+    addEventListener: <K extends keyof AppsInTossEvent>(event: K, args: {
+        onEvent: AppsInTossEvent[K]["onEvent"];
+        onError?: AppsInTossEvent[K]["onError"];
+        options?: AppsInTossEvent[K]["options"];
+    }) => () => void;
+};
+
+declare const graniteEvent: {
+    addEventListener: <K extends keyof GraniteEvent>(event: K, args: {
+        onEvent: GraniteEvent[K]["onEvent"];
+        onError?: GraniteEvent[K]["onError"];
+        options?: GraniteEvent[K]["options"];
+    }) => () => void;
+};
+
+declare const tdsEvent: {
+    addEventListener: <K extends keyof TdsEvent>(event: K, args: {
+        onEvent: TdsEvent[K]["onEvent"];
+        onError?: TdsEvent[K]["onError"];
+        options?: TdsEvent[K]["options"];
+    }) => () => void;
+};
+
+declare function getGameCenterGameProfile(): Promise<GameCenterGameProfileResponse | undefined>;
+
+/** @deprecated getAnonymousKey를 사용하세요. */
+declare const getUserKeyForGame: typeof getAnonymousKey;
+
+declare function grantPromotionReward(params: GrantPromotionRewardParams): Promise<GrantPromotionRewardResponse>;
+
+/** @deprecated grantPromotionReward를 사용하세요. */
+declare const grantPromotionRewardForGame: typeof grantPromotionReward;
+
+declare function openGameCenterLeaderboard(): Promise<void>;
+
+declare function submitGameCenterLeaderBoardScore(params: {
+    score: string;
+}): Promise<SubmitGameCenterLeaderBoardScoreResponse | undefined>;
+
+type HapticFeedbackType = "tickWeak" | "tap" | "tickMedium" | "softMedium" | "basicWeak" | "basicMedium" | "success" | "error" | "wiggle" | "confetti";
+interface HapticFeedbackOptions {
+    type: HapticFeedbackType;
+}
+declare function generateHapticFeedback(options: HapticFeedbackOptions): Promise<void>;
+
+declare function getIsTossLoginIntegratedService(): Promise<boolean | undefined>;
+
+type NetworkStatus = "OFFLINE" | "WIFI" | "2G" | "3G" | "4G" | "5G" | "WWAN" | "UNKNOWN";
+declare function getNetworkStatus(): Promise<NetworkStatus>;
+
+declare const getServerTime: (() => Promise<number | undefined>) & {
+    isSupported: () => boolean;
+};
+
+type IapCreateSubscriptionPurchaseOrderResult = IapCreateOneTimePurchaseOrderResult;
+type IapSubscriptionInfoResponse = GetSubscriptionInfoResult;
+interface IapCreateOneTimePurchaseOrderOptions {
+    options: {
+        sku: string;
+        productId?: string;
+        processProductGrant: (params: {
+            orderId: string;
+        }) => boolean | Promise<boolean>;
+    };
+    onEvent: (event: {
+        type: "success";
+        data: IapCreateOneTimePurchaseOrderResult;
+    }) => void | Promise<void>;
+    onError: (error: unknown) => void | Promise<void>;
+}
+interface CreateSubscriptionPurchaseOrderOptions {
+    options: {
+        sku: string;
+        offerId?: string | null;
+        processProductGrant: (params: {
+            orderId: string;
+            subscriptionId?: string;
+        }) => boolean | Promise<boolean>;
+    };
+    onEvent: (event: {
+        type: "success";
+        data: IapCreateSubscriptionPurchaseOrderResult;
+    }) => void | Promise<void>;
+    onError: (error: unknown) => void | Promise<void>;
+}
+
+declare const IAP: {
+    createOneTimePurchaseOrder: (params: IapCreateOneTimePurchaseOrderOptions) => (() => void);
+    createSubscriptionPurchaseOrder: (params: CreateSubscriptionPurchaseOrderOptions) => (() => void);
+    getProductItemList: () => Promise<_apps_in_toss_webview_bridge_spec.IapGetProductItemListResult>;
+    getPendingOrders: () => Promise<_apps_in_toss_webview_bridge_spec.GetPendingOrdersResult>;
+    getCompletedOrRefundedOrders: () => Promise<_apps_in_toss_webview_bridge_spec.CompletedOrRefundedOrdersResult>;
+    completeProductGrant: (args: {
+        params: {
+            orderId: string;
+        };
+    }) => Promise<boolean>;
+    getSubscriptionInfo: (args: {
+        params: {
+            orderId: string;
+        };
+    }) => Promise<_apps_in_toss_webview_bridge_spec.GetSubscriptionInfoResult>;
+};
+
+declare enum Accuracy {
+    Lowest = 1,
+    Low = 2,
+    Balanced = 3,
+    High = 4,
+    Highest = 5,
+    BestForNavigation = 6
+}
+interface GetCurrentLocationOptions {
+    accuracy: Accuracy;
+}
+interface StartUpdateLocationOptions {
+    accuracy: Accuracy;
+    timeInterval: number;
+    distanceInterval: number;
+}
+type StartUpdateLocationEventParams = {
+    onEvent: (response: Location) => void;
+    onError: (error: unknown) => void;
+    options: StartUpdateLocationOptions;
+};
+
+declare const getCurrentLocation: PermissionFunctionWithDialog<(options: GetCurrentLocationOptions) => Promise<_apps_in_toss_webview_bridge_spec.Location>>;
+
+declare const startUpdateLocation: {
+    (eventParams: StartUpdateLocationEventParams): (() => void);
+    getPermission(): Promise<_apps_in_toss_webview_bridge_spec.PermissionStatus>;
+    openPermissionDialog(): Promise<_apps_in_toss_webview_bridge_spec.PermissionDialogResult>;
+};
+
+type FetchAlbumPhotosOptions = FetchAlbumPhotosParams;
+type OpenCameraOptions = OpenCameraParams;
+
+declare const fetchAlbumPhotos: PermissionFunctionWithDialog<(options?: FetchAlbumPhotosOptions) => Promise<_apps_in_toss_webview_bridge_spec.ImageResponse[]>>;
+
+declare const openCamera: PermissionFunctionWithDialog<(options?: OpenCameraOptions) => Promise<_apps_in_toss_webview_bridge_spec.ImageResponse>>;
+
+declare function openURL(url: string): Promise<any>;
+
+declare const partner: {
+    addAccessoryButton: (params: AddAccessoryButtonParams) => Promise<void>;
+    removeAccessoryButton: () => Promise<void>;
+};
+
+type PermissionFunctionName = "getClipboardText" | "setClipboardText" | "fetchContacts" | "fetchAlbumPhotos" | "getCurrentLocation" | "openCamera";
+interface PermissionErrorConstructorParams {
+    methodName: PermissionFunctionName;
+    message: string;
+}
+interface PermissionErrorType extends Error {
+    name: string;
+    message: string;
+}
+type PermissionDialogFunction = () => Promise<Exclude<PermissionStatus, "notDetermined">>;
+type GetPermissionFunction = () => Promise<PermissionStatus>;
+type PermissionFunctionWithDialog<T extends (...args: any[]) => any> = T & {
+    getPermission: GetPermissionFunction;
+    openPermissionDialog: PermissionDialogFunction;
+};
+
+/**
+ * 권한 에러를 나타내는 클래스예요. 공통된 권한에러를 처리할 때 사용해요.
+ * 에러가 발생했을 때 `error instanceof PermissionError`를 통해 확인할 수 있어요.
+ */
+declare class PermissionError extends Error {
+    constructor({ methodName, message }: PermissionErrorConstructorParams);
+}
+
+/**
+ * 사진첩 권한이 거부되었을 때 발생하는 에러예요.
+ * 에러가 발생했을 때 `error instanceof FetchAlbumPhotosPermissionError`를 통해 확인할 수 있어요.
+ */
+declare class FetchAlbumPhotosPermissionError extends PermissionError {
+    constructor();
+}
+
+/**
+ * 연락처 권한이 거부되었을 때 발생하는 에러예요.
+ * 에러가 발생했을 때 `error instanceof FetchContactsPermissionError`를 통해 확인할 수 있어요.
+ */
+declare class FetchContactsPermissionError extends PermissionError {
+    constructor();
+}
+
+/**
+ * 클립보드 읽기 권한이 거부되었을 때 발생하는 에러예요.
+ * 에러가 발생했을 때 `error instanceof GetClipboardTextPermissionError`를 통해 확인할 수 있어요.
+ */
+declare class GetClipboardTextPermissionError extends PermissionError {
+    constructor();
+}
+
+/**
+ * 위치 권한이 거부되었을 때 발생하는 에러예요.
+ * 에러가 발생했을 때 `error instanceof GetCurrentLocationPermissionError`를 통해 확인할 수 있어요.
+ */
+declare class GetCurrentLocationPermissionError extends PermissionError {
+    constructor();
+}
+
+/**
+ * 카메라 권한이 거부되었을 때 발생하는 에러예요.
+ * 에러가 발생했을 때 `error instanceof OpenCameraPermissionError`를 통해 확인할 수 있어요.
+ */
+declare class OpenCameraPermissionError extends PermissionError {
+    constructor();
+}
+
+/**
+ * 클립보드 쓰기 권한이 거부되었을 때 발생하는 에러예요.
+ * 에러가 발생했을 때 `error instanceof SetClipboardTextPermissionError`를 통해 확인할 수 있어요.
+ */
+declare class SetClipboardTextPermissionError extends PermissionError {
+    constructor();
+}
+
+/**
+ * 위치 업데이트 권한이 거부되었을 때 발생하는 에러예요.
+ * `GetCurrentLocationPermissionError`와 동일하며,
+ * `error instanceof StartUpdateLocationPermissionError`로 확인할 수 있어요.
+ */
+declare const StartUpdateLocationPermissionError: typeof GetCurrentLocationPermissionError;
+
+declare function getPermission(permission: {
+    name: PermissionName;
+    access: PermissionAccess;
+}): Promise<PermissionStatus>;
+
+declare function openPermissionDialog(permission: {
+    name: PermissionName;
+    access: PermissionAccess;
+}): Promise<Exclude<PermissionStatus, "notDetermined">>;
+
+declare function requestPermission(permission: {
+    name: PermissionName;
+    access: PermissionAccess;
+}): Promise<Exclude<PermissionStatus, "notDetermined">>;
+
+declare const requestReview: (() => Promise<void>) & {
+    isSupported: () => boolean;
+};
+
+/** @deprecated SafeAreaInsets.get()를 사용하세요. */
+declare function getSafeAreaInsets(): number;
+
+type SafeAreaInsets = SafeAreaInsets$2;
+declare const SafeAreaInsets: {
+    get: () => SafeAreaInsets;
+    subscribe: (args: {
+        onEvent: (data: SafeAreaInsets) => void;
+    }) => () => void;
+};
+
+declare function saveBase64Data(params: SaveBase64DataParams): Promise<void>;
+
+declare function getTossShareLink(url: string, ogImageUrl?: string): Promise<string>;
+
+declare function share(message: {
+    message: string;
+}): Promise<void>;
+
+declare const Storage: {
+    getItem: (key: string) => Promise<string | null>;
+    setItem: (key: string, value: string) => Promise<void>;
+    removeItem: (key: string) => Promise<void>;
+    clearItems: () => Promise<void>;
+};
+
+declare function closeView(): Promise<void>;
+
+declare function setDeviceOrientation(options: {
+    type: DeviceOrientation;
+}): Promise<void>;
+
+declare function setIosSwipeGestureEnabled(options: {
+    isEnabled: boolean;
+}): Promise<void>;
+
+declare function setScreenAwakeMode(options: {
+    enabled: boolean;
+}): Promise<{
+    enabled: boolean;
+}>;
+
+declare function setSecureScreen(options: {
+    enabled: boolean;
+}): Promise<{
+    enabled: boolean;
+}>;
+
+declare const openPDFViewer: ((params: OpenPDFViewerParams) => Promise<OpenPDFViewerResult>) & {
+    isSupported: () => boolean;
+};
+
+declare const fetchAlbumItems: ((options?: FetchAlbumItemsOptions) => Promise<AlbumItemResponse[]>) & {
+    isSupported: () => boolean;
+};
+
+type RequestTossPayPaysBillingOptions = RequestTossPayPaysBillingParams;
+declare const requestTossPayPaysBilling: ((options: {
+    params: RequestTossPayPaysBillingOptions;
+}) => Promise<RequestTossPayPaysBillingResult | undefined>) & {
+    isSupported: () => boolean;
+};
+
+interface RequestNotificationAgreementOptions {
+    options: RequestNotificationAgreementParams;
+    onEvent: (result: {
+        type: NotificationAgreementResult;
+    }) => void;
+    onError: (error: unknown) => void | Promise<void>;
+}
+declare const requestNotificationAgreement: ((params: RequestNotificationAgreementOptions) => () => void) & {
+    isSupported: () => boolean;
+};
+
+/**
+ * @deprecated v2 호환용 타입. v3에서는 `GetAnonymousKeyResponse`를 사용하세요.
+ */
+type GetAnonymousKeySuccessResponse = GetAnonymousKeyResponse;
+/**
+ * @deprecated v2 호환용 타입. `getAnonymousKey`를 사용하세요.
+ */
+type GetUserKeyForGameSuccessResponse = GetAnonymousKeyResponse;
+/**
+ * @deprecated v2 호환용 타입. `getAnonymousKey`를 사용하세요.
+ */
+type GetUserKeyForGameErrorResponse = {
+    type: "NOT_AVAILABLE";
+};
+/**
+ * @deprecated v2 호환용 타입. `getAnonymousKey`를 사용하세요.
+ */
+type GetUserKeyForGameResponse = GetAnonymousKeyResponse | GetUserKeyForGameErrorResponse;
+/**
+ * @deprecated v2 호환용 타입. `GrantPromotionRewardResponse`를 사용하세요.
+ */
+type GrantPromotionRewardSuccessResponse = GrantPromotionRewardResponse;
+/**
+ * @deprecated v2 호환용 타입.
+ */
+interface GrantPromotionRewardErrorResponse {
+    code: string;
+    [key: string]: any;
+}
+/**
+ * @deprecated v2 호환용 타입.
+ */
+interface GrantPromotionRewardErrorResult {
+    errorCode: string;
+    message: string;
+}
+/**
+ * @deprecated v2 호환용 타입. `grantPromotionReward`를 사용하세요.
+ */
+type GrantPromotionRewardForGameSuccessResponse = GrantPromotionRewardResponse;
+/**
+ * @deprecated v2 호환용 타입. `grantPromotionReward`를 사용하세요.
+ */
+type GrantPromotionRewardForGameErrorResponse = GrantPromotionRewardErrorResponse;
+/**
+ * @deprecated v2 호환용 타입. `grantPromotionReward`를 사용하세요.
+ */
+type GrantPromotionRewardForGameErrorResult = GrantPromotionRewardErrorResult;
+/**
+ * @deprecated v2 호환용 타입. `grantPromotionReward`를 사용하세요.
+ */
+type GrantPromotionRewardForGameResponse = GrantPromotionRewardForGameSuccessResponse | GrantPromotionRewardForGameErrorResponse;
+/**
+ * @deprecated v2 호환용 타입.
+ */
+type GrantPromotionRewardResult = GrantPromotionRewardResponse | GrantPromotionRewardErrorResult | "ERROR" | undefined;
+/**
+ * @deprecated v2 호환용 타입.
+ */
+interface AdNetworkResponseInfo {
+    adSourceId: string;
+    adSourceName: string;
+    adSourceInstanceId: string;
+    adSourceInstanceName: string;
+    adNetworkClassName: string | null;
+}
+/**
+ * @deprecated v2 호환용 타입.
+ */
+interface ResponseInfo {
+    adNetworkInfoArray: Array<AdNetworkResponseInfo>;
+    loadedAdNetworkInfo: AdNetworkResponseInfo | null;
+    responseId: string | null;
+}
+/**
+ * @deprecated v2 호환용 타입. v3의 `LoadAdMobResult`를 사용하세요.
+ */
+interface AdMobLoadResult {
+    adGroupId: string;
+    adUnitId: string;
+    responseInfo: ResponseInfo;
+}
+/**
+ * @deprecated v2 호환용 타입.
+ */
+type AdUserEarnedReward = {
+    type: "userEarnedReward";
+    data: {
+        unitType: string;
+        unitAmount: number;
+    };
+};
+/**
+ * @deprecated v2 호환용 타입.
+ */
+type AdMobFullScreenEvent = {
+    type: "clicked";
+} | {
+    type: "dismissed";
+} | {
+    type: "failedToShow";
+} | {
+    type: "impression";
+} | {
+    type: "show";
+};
+/**
+ * @deprecated v2 호환용 타입.
+ */
+interface AdMobHandlerParams<Options = void, Event = AdMobFullScreenEvent> {
+    options: Options;
+    onEvent: (event: Event) => void;
+    onError: (error: unknown) => void;
+}
+/**
+ * @deprecated v2 호환용 타입.
+ */
+interface InterstitialAd {
+    adUnitId: string;
+    responseInfo: ResponseInfo;
+}
+/**
+ * @deprecated v2 호환용 타입.
+ */
+interface RewardedAd {
+    adUnitId: string;
+    responseInfo: ResponseInfo;
+}
+/**
+ * @deprecated v2 호환용 타입.
+ */
+type LoadAdMobParams = AdMobHandlerParams<LoadAdMobOptions, LoadAdMobEvent>;
+/**
+ * @deprecated v2 호환용 타입.
+ */
+type ShowAdMobParams = AdMobHandlerParams<ShowAdMobOptions, ShowAdMobEvent>;
+/**
+ * @deprecated v2 호환용 타입.
+ */
+interface LoadFullScreenAdParams {
+    options: LoadFullScreenAdOptions;
+    onEvent: (data: LoadFullScreenAdEvent) => void;
+    onError: (err: unknown) => void;
+}
+/**
+ * @deprecated v2 호환용 타입.
+ */
+interface ShowFullScreenAdParams {
+    options: ShowFullScreenAdOptions;
+    onEvent: (data: ShowFullScreenAdEvent) => void;
+    onError: (err: unknown) => void;
+}
+/**
+ * @deprecated v2 호환용 타입.
+ */
+type GetClipboardText = () => Promise<string>;
+/**
+ * @deprecated v2 호환용 타입.
+ */
+type SetClipboardText = (text: string) => Promise<void>;
+/**
+ * @deprecated v2 호환용 타입.
+ */
+interface SetClipboardTextOptions {
+    text: string;
+}
+/**
+ * @deprecated v2 호환용 타입.
+ */
+type FetchContacts = (options: FetchContactsOptions) => Promise<ContactResult>;
+/**
+ * @deprecated v2 호환용 타입.
+ */
+type FetchAlbumPhotos = (options?: FetchAlbumPhotosOptions) => Promise<ImageResponse[]>;
+/**
+ * @deprecated v2 호환용 타입.
+ */
+type OpenCamera = (options?: OpenCameraOptions) => Promise<ImageResponse>;
+/**
+ * @deprecated v2 호환용 타입.
+ */
+type GetCurrentLocation = (options: GetCurrentLocationOptions) => Promise<Location>;
+/**
+ * @deprecated v2 호환용 타입.
+ */
+type StartUpdateLocation = (eventParams: StartUpdateLocationEventParams) => () => void;
+/**
+ * @deprecated v2 호환용 타입.
+ */
+interface EventEmitterSchema<K extends string, P extends unknown[]> {
+    name: K;
+    params: P;
+}
+/**
+ * @deprecated v2 호환용 타입.
+ */
+type UpdateLocationEventEmitter = EventEmitterSchema<"updateLocation", [
+    Location
+]>;
+/**
+ * @deprecated v2 호환용 타입. spec의 `AddAccessoryButtonParams`를 사용하세요.
+ */
+type AddAccessoryButtonOptions = AddAccessoryButtonParams;
+/**
+ * @deprecated v2 호환용 타입.
+ */
+type Primitive = string | number | boolean | null | undefined | symbol;
+/**
+ * @deprecated v2 호환용 타입. v3에서는 spec의 `EventLogParams`를 사용하세요.
+ */
+interface EventLogParams {
+    log_name: string;
+    log_type: "debug" | "info" | "warn" | "error" | "event" | "screen" | "impression" | "click" | "popup";
+    params: Record<string, Primitive>;
+}
+
+type LoggerParams = {
+    log_name?: string;
+} & {
+    [key: string]: LogParam;
+};
+declare const Analytics: {
+    screen: (params?: LoggerParams) => Promise<void> | undefined;
+    impression: (params?: LoggerParams) => Promise<void> | undefined;
+    click: (params?: LoggerParams) => Promise<void> | undefined;
+};
+
+export { Accuracy, type AdMobFullScreenEvent, type AdMobHandlerParams, type AdMobLoadResult, type AdNetworkResponseInfo, type AdUserEarnedReward, type AddAccessoryButtonOptions, Analytics, type AppsInTossEvent, type CheckoutPaymentOptions, type ContactResult, type ContactsViralParams, type ContactsViralSuccessEvent, type CreateSubscriptionPurchaseOrderOptions, type EventEmitterSchema, type EventLogParams, type FetchAlbumPhotos, type FetchAlbumPhotosOptions, FetchAlbumPhotosPermissionError, type FetchContacts, type FetchContactsOptions, FetchContactsPermissionError, type GetAnonymousKeySuccessResponse, type GetClipboardText, GetClipboardTextPermissionError, type GetCurrentLocation, type GetCurrentLocationOptions, GetCurrentLocationPermissionError, type GetPermissionFunction, type GetUserKeyForGameErrorResponse, type GetUserKeyForGameResponse, type GetUserKeyForGameSuccessResponse, GoogleAdMob, type GraniteEvent, type GrantPromotionRewardErrorResponse, type GrantPromotionRewardErrorResult, type GrantPromotionRewardForGameErrorResponse, type GrantPromotionRewardForGameErrorResult, type GrantPromotionRewardForGameResponse, type GrantPromotionRewardForGameSuccessResponse, type GrantPromotionRewardResult, type GrantPromotionRewardSuccessResponse, type HapticFeedbackOptions, type HapticFeedbackType, IAP, type IapCreateOneTimePurchaseOrderOptions, type IapSubscriptionInfoResponse, type InterstitialAd, type IsAdMobLoadedOptions, type LoadAdMobEvent, type LoadAdMobOptions, type LoadAdMobParams, type LoadAdMobResult, type LoadFullScreenAdParams, type LoadTossAdOrAdmobOptions, type NetworkStatus, type OpenCamera, type OpenCameraOptions, OpenCameraPermissionError, type PermissionDialogFunction, PermissionError, type PermissionErrorConstructorParams, type PermissionErrorType, type PermissionFunctionName, type PermissionFunctionWithDialog, type Primitive, type RequestNotificationAgreementOptions, type RequestTossPayPaysBillingOptions, type ResponseInfo, type RewardFromContactsViralEvent, type RewardedAd, SafeAreaInsets, type SetClipboardText, type SetClipboardTextOptions, SetClipboardTextPermissionError, type ShowAdMobEvent, type ShowAdMobOptions, type ShowAdMobParams, type ShowFullScreenAdParams, type ShowTossAdOrAdmobOptions, type StartUpdateLocation, type StartUpdateLocationEventParams, type StartUpdateLocationOptions, StartUpdateLocationPermissionError, Storage, type TdsEvent, type TossAdOrAdmobRewardData, TossAds, type AttachBannerOptions as TossAdsAttachBannerOptions, type AttachBannerResult as TossAdsAttachBannerResult, type AttachOptions as TossAdsAttachOptions, type BannerSlotCallbacks as TossAdsBannerSlotCallbacks, type BannerSlotErrorPayload as TossAdsBannerSlotErrorPayload, type BannerSlotEventPayload as TossAdsBannerSlotEventPayload, type InitializeOptions as TossAdsInitializeOptions, type UpdateLocationEventEmitter, appLogin, appsInTossEvent, appsInTossSignTossCert, checkoutPayment, closeView, contactsViral, env, eventLog, fetchAlbumItems, fetchAlbumPhotos, fetchContacts, generateHapticFeedback, getAnonymousKey, getAppsInTossGlobals, getClipboardText, getCurrentLocation, getDeviceId, getGameCenterGameProfile, getGroupId, getIsTossLoginIntegratedService, getLocale, getNetworkStatus, getOperationalEnvironment, getPermission, getPlatformOS, getSafeAreaInsets, getSchemeUri, getServerTime, getTossAppVersion, getTossShareLink, getUserKeyForGame, graniteEvent, grantPromotionReward, grantPromotionRewardForGame, isMinVersionSupported, loadFullScreenAd, openCamera, openGameCenterLeaderboard, openPDFViewer, openPermissionDialog, openURL, partner, requestNotificationAgreement, requestPermission, requestReview, requestTossPayPaysBilling, saveBase64Data, setClipboardText, setDeviceOrientation, setIosSwipeGestureEnabled, setScreenAwakeMode, setSecureScreen, share, showFullScreenAd, startUpdateLocation, submitGameCenterLeaderBoardScore, tdsEvent };