@ait-co/devtools 0.0.1

package/dist/mock/index.d.ts

@@ -0,0 +1,613 @@
+/**
+ * ait-devtools 중앙 상태 관리
+ * DevTools Panel과 mock 구현체가 이 상태를 공유한다.
+ */
+type PlatformOS = 'ios' | 'android';
+type OperationalEnvironment = 'toss' | 'sandbox';
+type NetworkStatus$1 = 'OFFLINE' | 'WIFI' | '2G' | '3G' | '4G' | '5G' | 'WWAN' | 'UNKNOWN';
+type PermissionStatus = 'notDetermined' | 'denied' | 'allowed';
+type PermissionName = 'clipboard' | 'contacts' | 'photos' | 'geolocation' | 'camera' | 'microphone';
+type HapticFeedbackType = 'tickWeak' | 'tap' | 'tickMedium' | 'softMedium' | 'basicWeak' | 'basicMedium' | 'success' | 'error' | 'wiggle' | 'confetti';
+interface LocationCoords {
+    latitude: number;
+    longitude: number;
+    altitude: number;
+    accuracy: number;
+    altitudeAccuracy: number;
+    heading: number;
+}
+interface MockLocation {
+    coords: LocationCoords;
+    timestamp: number;
+    accessLocation?: 'FINE' | 'COARSE';
+}
+interface MockContact {
+    name: string;
+    phoneNumber: string;
+}
+interface MockIapProduct {
+    sku: string;
+    type: 'CONSUMABLE' | 'NON_CONSUMABLE' | 'SUBSCRIPTION';
+    displayName: string;
+    displayAmount: string;
+    iconUrl: string;
+    description: string;
+    renewalCycle?: 'WEEKLY' | 'MONTHLY' | 'YEARLY';
+}
+type IapNextResult = 'success' | 'USER_CANCELED' | 'INVALID_PRODUCT_ID' | 'PAYMENT_PENDING' | 'NETWORK_ERROR' | 'ITEM_ALREADY_OWNED' | 'INTERNAL_ERROR';
+interface AnalyticsLogEntry {
+    timestamp: number;
+    type: string;
+    params: Record<string, unknown>;
+}
+interface SafeAreaInsets$1 {
+    top: number;
+    bottom: number;
+    left: number;
+    right: number;
+}
+type Listener = () => void;
+interface AitDevtoolsState {
+    platform: PlatformOS;
+    environment: OperationalEnvironment;
+    appVersion: string;
+    locale: string;
+    schemeUri: string;
+    groupId: string;
+    deploymentId: string;
+    deviceId: string;
+    brand: {
+        displayName: string;
+        icon: string;
+        primaryColor: string;
+    };
+    networkStatus: NetworkStatus$1;
+    permissions: Record<PermissionName, PermissionStatus>;
+    location: MockLocation;
+    safeAreaInsets: SafeAreaInsets$1;
+    contacts: MockContact[];
+    iap: {
+        products: MockIapProduct[];
+        nextResult: IapNextResult;
+        pendingOrders: Array<{
+            orderId: string;
+            sku: string;
+            paymentCompletedDate: string;
+        }>;
+        completedOrders: Array<{
+            orderId: string;
+            sku: string;
+            status: 'COMPLETED' | 'REFUNDED';
+            date: string;
+        }>;
+    };
+    payment: {
+        nextResult: 'success' | 'fail';
+        failReason: string;
+    };
+    auth: {
+        isLoggedIn: boolean;
+        isTossLoginIntegrated: boolean;
+        userKeyHash: string;
+    };
+    ads: {
+        isLoaded: boolean;
+        nextEvent: 'loaded' | 'clicked' | 'dismissed' | 'failedToShow' | 'impression' | 'userEarnedReward';
+    };
+    game: {
+        profile: {
+            nickname: string;
+            profileImageUri: string;
+        } | null;
+        leaderboardScores: Array<{
+            score: string;
+            timestamp: number;
+        }>;
+    };
+    analyticsLog: AnalyticsLogEntry[];
+}
+declare class AitStateManager {
+    private _state;
+    private _listeners;
+    constructor();
+    get state(): AitDevtoolsState;
+    update(partial: Partial<AitDevtoolsState>): void;
+    /** 중첩 객체 업데이트용 */
+    patch<K extends keyof AitDevtoolsState>(key: K, partial: Partial<AitDevtoolsState[K]>): void;
+    subscribe(listener: Listener): () => void;
+    /** 분석 로그 추가 */
+    logAnalytics(entry: Omit<AnalyticsLogEntry, 'timestamp'>): void;
+    /** 이벤트 트리거 (backEvent, homeEvent 등) */
+    trigger(event: string): void;
+    reset(): void;
+    private _notify;
+}
+declare const aitState: AitStateManager;
+
+/**
+ * 인증/로그인 mock
+ */
+declare function appLogin(): Promise<{
+    authorizationCode: string;
+    referrer: 'DEFAULT' | 'SANDBOX';
+}>;
+declare function getIsTossLoginIntegratedService(): Promise<boolean | undefined>;
+declare function getUserKeyForGame(): Promise<{
+    hash: string;
+    type: 'HASH';
+} | 'INVALID_CATEGORY' | 'ERROR' | undefined>;
+interface AppsInTossSignTossCertParams {
+    txId: string;
+}
+declare function appsInTossSignTossCert(_params: AppsInTossSignTossCertParams): Promise<void>;
+
+/**
+ * 화면/네비게이션/이벤트 mock
+ */
+declare function closeView(): Promise<void>;
+declare function openURL(url: string): Promise<void>;
+declare function share(message: {
+    message: string;
+}): Promise<void>;
+declare function getTossShareLink(path: string, _ogImageUrl?: string): Promise<string>;
+declare function setIosSwipeGestureEnabled(_options: {
+    isEnabled: boolean;
+}): Promise<void>;
+declare function setDeviceOrientation(_options: {
+    type: 'portrait' | 'landscape';
+}): Promise<void>;
+declare function setScreenAwakeMode(options: {
+    enabled: boolean;
+}): Promise<{
+    enabled: boolean;
+}>;
+declare function setSecureScreen(options: {
+    enabled: boolean;
+}): Promise<{
+    enabled: boolean;
+}>;
+declare function requestReview(): Promise<void>;
+declare function getPlatformOS(): 'ios' | 'android';
+declare function getOperationalEnvironment(): 'toss' | 'sandbox';
+declare function getTossAppVersion(): string;
+declare function isMinVersionSupported(minVersions: {
+    android: string;
+    ios: string;
+}): boolean;
+declare function getSchemeUri(): string;
+declare function getLocale(): string;
+declare function getDeviceId(): string;
+declare function getGroupId(): string;
+declare function getNetworkStatus(): Promise<NetworkStatus>;
+type NetworkStatus = 'OFFLINE' | 'WIFI' | '2G' | '3G' | '4G' | '5G' | 'WWAN' | 'UNKNOWN';
+declare function getServerTime(): Promise<number | undefined>;
+interface GraniteEventMap {
+    backEvent: {
+        onEvent: () => void;
+        onError?: (error: Error) => void;
+        options?: void;
+    };
+    homeEvent: {
+        onEvent: () => void;
+        onError?: (error: Error) => void;
+        options?: void;
+    };
+}
+declare const graniteEvent: {
+    addEventListener<K extends keyof GraniteEventMap>(event: K, { onEvent, onError }: {
+        onEvent: GraniteEventMap[K]["onEvent"];
+        onError?: GraniteEventMap[K]["onError"];
+        options?: GraniteEventMap[K]["options"];
+    }): () => void;
+};
+declare const appsInTossEvent: {
+    addEventListener<K extends string>(_event: K, _handlers: {
+        onEvent: (...args: unknown[]) => void;
+        onError?: (error: Error) => void;
+        options?: unknown;
+    }): () => void;
+};
+interface TdsEventMap {
+    navigationAccessoryEvent: {
+        onEvent: (data: {
+            id: string;
+        }) => void;
+        onError?: (error: Error) => void;
+        options: undefined;
+    };
+}
+declare const tdsEvent: {
+    addEventListener<K extends keyof TdsEventMap>(event: K, { onEvent }: {
+        onEvent: TdsEventMap[K]["onEvent"];
+        onError?: TdsEventMap[K]["onError"];
+        options?: TdsEventMap[K]["options"];
+    }): () => void;
+};
+declare function onVisibilityChangedByTransparentServiceWeb(eventParams: {
+    options: {
+        callbackId: string;
+    };
+    onEvent: (isVisible: boolean) => void;
+    onError: (error: unknown) => void;
+}): () => void;
+declare const env: {
+    getDeploymentId: () => string;
+};
+declare function getAppsInTossGlobals(): {
+    deploymentId: string;
+    brandDisplayName: string;
+    brandIcon: string;
+    brandPrimaryColor: string;
+};
+type SafeAreaInsetsValue = {
+    top: number;
+    bottom: number;
+    left: number;
+    right: number;
+};
+type SafeAreaInsetsSubscribeHandler = {
+    onEvent: (data: SafeAreaInsetsValue) => void;
+};
+declare const SafeAreaInsets: {
+    get: () => SafeAreaInsetsValue;
+    subscribe: ({ onEvent }: SafeAreaInsetsSubscribeHandler) => (() => void);
+};
+/** @deprecated */
+declare function getSafeAreaInsets(): number;
+
+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 enum Accuracy {
+    Lowest = 1,
+    Low = 2,
+    Balanced = 3,
+    High = 4,
+    Highest = 5,
+    BestForNavigation = 6
+}
+
+declare const getCurrentLocation: ((_options?: {
+    accuracy: Accuracy;
+}) => Promise<MockLocation>) & {
+    getPermission: () => Promise<PermissionStatus>;
+    openPermissionDialog: () => Promise<"allowed" | "denied">;
+};
+interface StartUpdateLocationEventParams {
+    onEvent: (response: MockLocation) => void;
+    onError: (error: unknown) => void;
+    options: {
+        accuracy: Accuracy;
+        timeInterval: number;
+        distanceInterval: number;
+    };
+}
+declare function _startUpdateLocation(eventParams: StartUpdateLocationEventParams): () => void;
+declare const startUpdateLocation: typeof _startUpdateLocation & {
+    getPermission: () => Promise<PermissionStatus>;
+    openPermissionDialog: () => Promise<"denied" | "allowed">;
+};
+declare const openCamera: ((options?: {
+    base64?: boolean;
+    maxWidth?: number;
+}) => Promise<{
+    id: string;
+    dataUri: string;
+}>) & {
+    getPermission: () => Promise<PermissionStatus>;
+    openPermissionDialog: () => Promise<"allowed" | "denied">;
+};
+declare const fetchAlbumPhotos: ((options?: {
+    maxCount?: number;
+    maxWidth?: number;
+    base64?: boolean;
+}) => Promise<Array<{
+    id: string;
+    dataUri: string;
+}>>) & {
+    getPermission: () => Promise<PermissionStatus>;
+    openPermissionDialog: () => Promise<"allowed" | "denied">;
+};
+declare const fetchContacts: ((options: {
+    size: number;
+    offset: number;
+    query?: {
+        contains?: string;
+    };
+}) => Promise<{
+    result: MockContact[];
+    nextOffset: number | null;
+    done: boolean;
+}>) & {
+    getPermission: () => Promise<PermissionStatus>;
+    openPermissionDialog: () => Promise<"allowed" | "denied">;
+};
+declare const getClipboardText: (() => Promise<string>) & {
+    getPermission: () => Promise<PermissionStatus>;
+    openPermissionDialog: () => Promise<"allowed" | "denied">;
+};
+declare const setClipboardText: ((text: string) => Promise<void>) & {
+    getPermission: () => Promise<PermissionStatus>;
+    openPermissionDialog: () => Promise<"allowed" | "denied">;
+};
+declare function generateHapticFeedback(options: {
+    type: string;
+}): Promise<void>;
+declare function saveBase64Data(params: {
+    data: string;
+    fileName: string;
+    mimeType: string;
+}): Promise<void>;
+
+/**
+ * IAP (인앱결제) mock
+ */
+interface IapCreateOneTimePurchaseOrderOptions {
+    options: {
+        sku?: string;
+        productId?: string;
+        processProductGrant: (params: {
+            orderId: string;
+        }) => boolean | Promise<boolean>;
+    };
+    onEvent: (event: {
+        type: 'success';
+        data: IapOrderResult;
+    }) => 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: IapOrderResult;
+    }) => void | Promise<void>;
+    onError: (error: unknown) => void | Promise<void>;
+}
+interface IapOrderResult {
+    orderId: string;
+    displayName: string;
+    displayAmount: string;
+    amount: number;
+    currency: string;
+    fraction: number;
+    miniAppIconUrl: string | null;
+}
+declare const IAP: {
+    createOneTimePurchaseOrder(params: IapCreateOneTimePurchaseOrderOptions): () => void;
+    createSubscriptionPurchaseOrder(params: CreateSubscriptionPurchaseOrderOptions): () => void;
+    getProductItemList(): Promise<{
+        products: unknown[];
+    }>;
+    getPendingOrders(): Promise<{
+        orders: Array<{
+            orderId: string;
+            sku: string;
+            paymentCompletedDate: string;
+        }>;
+    }>;
+    getCompletedOrRefundedOrders(): Promise<{
+        hasNext: boolean;
+        nextKey?: string | null;
+        orders: Array<{
+            orderId: string;
+            sku: string;
+            status: "COMPLETED" | "REFUNDED";
+            date: string;
+        }>;
+    }>;
+    completeProductGrant(args: {
+        params: {
+            orderId: string;
+        };
+    }): Promise<boolean>;
+    getSubscriptionInfo(_args: {
+        params: {
+            orderId: string;
+        };
+    }): Promise<{
+        subscription: {
+            catalogId: number;
+            status: string;
+            expiresAt: string;
+            isAutoRenew: boolean;
+            gracePeriodExpiresAt: null;
+            isAccessible: boolean;
+        };
+    }>;
+};
+declare function checkoutPayment(options: {
+    params: {
+        payToken: string;
+    };
+}): Promise<{
+    success: boolean;
+    reason?: string;
+}>;
+
+/**
+ * 광고 mock (GoogleAdMob, TossAds, FullScreenAd)
+ */
+declare const GoogleAdMob: {
+    loadAppsInTossAdMob: ((args: {
+        onEvent: (data: {
+            type: string;
+            data?: unknown;
+        }) => void;
+        onError: (error: Error) => void;
+        options?: {
+            adGroupId?: string;
+        };
+    }) => (() => void)) & {
+        isSupported: () => boolean;
+    };
+    showAppsInTossAdMob: ((args: {
+        onEvent: (data: {
+            type: string;
+            data?: unknown;
+        }) => void;
+        onError: (error: Error) => void;
+        options?: {
+            adGroupId?: string;
+        };
+    }) => (() => void)) & {
+        isSupported: () => boolean;
+    };
+    isAppsInTossAdMobLoaded: ((_options: {
+        adGroupId?: string;
+    }) => Promise<boolean>) & {
+        isSupported: () => boolean;
+    };
+};
+declare const TossAds: {
+    initialize: ((_options: unknown) => void) & {
+        isSupported: () => boolean;
+    };
+    attach: ((_adGroupId: string, target: string | HTMLElement, _options?: unknown) => void) & {
+        isSupported: () => boolean;
+    };
+    attachBanner: ((_adGroupId: string, target: string | HTMLElement, _options?: unknown) => {
+        destroy: () => void;
+    }) & {
+        isSupported: () => boolean;
+    };
+    destroy: ((_slotId: string) => void) & {
+        isSupported: () => boolean;
+    };
+    destroyAll: (() => void) & {
+        isSupported: () => boolean;
+    };
+};
+declare const loadFullScreenAd: ((args: {
+    onEvent: (data: {
+        type: string;
+        data?: unknown;
+    }) => void;
+    onError: (error: Error) => void;
+    options?: {
+        adGroupId?: string;
+    };
+}) => (() => void)) & {
+    isSupported: () => boolean;
+};
+declare const showFullScreenAd: ((args: {
+    onEvent: (data: {
+        type: string;
+        data?: unknown;
+    }) => void;
+    onError: (error: Error) => void;
+    options?: {
+        adGroupId?: string;
+    };
+}) => (() => void)) & {
+    isSupported: () => boolean;
+};
+
+/**
+ * 게임/프로모션 mock
+ */
+declare function grantPromotionReward(params: {
+    params: {
+        promotionCode: string;
+        amount: number;
+    };
+}): Promise<{
+    key: string;
+} | {
+    errorCode: string;
+    message: string;
+} | 'ERROR' | undefined>;
+declare function grantPromotionRewardForGame(params: {
+    params: {
+        promotionCode: string;
+        amount: number;
+    };
+}): Promise<{
+    key: string;
+} | {
+    errorCode: string;
+    message: string;
+} | 'ERROR' | undefined>;
+declare function submitGameCenterLeaderBoardScore(params: {
+    score: string;
+}): Promise<{
+    statusCode: 'SUCCESS' | 'LEADERBOARD_NOT_FOUND' | 'PROFILE_NOT_FOUND' | 'UNPARSABLE_SCORE';
+} | undefined>;
+declare function getGameCenterGameProfile(): Promise<{
+    statusCode: 'SUCCESS';
+    nickname: string;
+    profileImageUri: string;
+} | {
+    statusCode: 'PROFILE_NOT_FOUND';
+} | undefined>;
+declare function openGameCenterLeaderboard(): Promise<void>;
+interface ContactsViralEvent {
+    type: string;
+    data: Record<string, unknown>;
+}
+declare function contactsViral(params: {
+    options: {
+        moduleId: string;
+    };
+    onEvent: (event: ContactsViralEvent) => void;
+    onError: (error: unknown) => void;
+}): () => void;
+
+/**
+ * Analytics mock
+ */
+type Primitive$1 = string | number | boolean | null | undefined | symbol;
+type LoggerParams = {
+    log_name?: string;
+} & Record<string, Primitive$1>;
+declare const Analytics: {
+    screen: (params?: LoggerParams) => Promise<void> | undefined;
+    impression: (params?: LoggerParams) => Promise<void> | undefined;
+    click: (params?: LoggerParams) => Promise<void> | undefined;
+};
+declare function eventLog(params: {
+    log_name: string;
+    log_type: 'debug' | 'info' | 'warn' | 'error' | 'event' | 'screen' | 'impression' | 'click';
+    params: Record<string, Primitive$1>;
+}): Promise<void>;
+
+/**
+ * Partner / TDS mock
+ */
+interface AddAccessoryButtonOptions {
+    id: string;
+    title: string;
+    icon: {
+        name: string;
+    };
+}
+declare const partner: {
+    addAccessoryButton(options: AddAccessoryButtonOptions): Promise<void>;
+    removeAccessoryButton(): Promise<void>;
+};
+
+/**
+ * 권한 시스템 mock
+ * 각 디바이스 API (.getPermission, .openPermissionDialog)에 부착된다.
+ */
+
+declare function getPermission(name: PermissionName): Promise<PermissionStatus>;
+declare function openPermissionDialog(name: PermissionName): Promise<'allowed' | 'denied'>;
+declare function requestPermission(permission: {
+    name: PermissionName;
+    access: string;
+}): Promise<'allowed' | 'denied'>;
+
+type Primitive = string | number | boolean | null | undefined | symbol;
+
+export { Accuracy, type AitDevtoolsState, Analytics, type AnalyticsLogEntry, GoogleAdMob, type HapticFeedbackType, IAP, type IapNextResult, type LocationCoords, type MockContact, type MockIapProduct, type MockLocation, type NetworkStatus$1 as NetworkStatus, type OperationalEnvironment, type PermissionName, type PermissionStatus, type PlatformOS, type Primitive, SafeAreaInsets, type SafeAreaInsets$1 as SafeAreaInsetsType, Storage, TossAds, aitState, appLogin, appsInTossEvent, appsInTossSignTossCert, checkoutPayment, closeView, contactsViral, env, eventLog, fetchAlbumPhotos, fetchContacts, generateHapticFeedback, getAppsInTossGlobals, getClipboardText, getCurrentLocation, getDeviceId, getGameCenterGameProfile, getGroupId, getIsTossLoginIntegratedService, getLocale, getNetworkStatus, getOperationalEnvironment, getPermission, getPlatformOS, getSafeAreaInsets, getSchemeUri, getServerTime, getTossAppVersion, getTossShareLink, getUserKeyForGame, graniteEvent, grantPromotionReward, grantPromotionRewardForGame, isMinVersionSupported, loadFullScreenAd, onVisibilityChangedByTransparentServiceWeb, openCamera, openGameCenterLeaderboard, openPermissionDialog, openURL, partner, requestPermission, requestReview, saveBase64Data, setClipboardText, setDeviceOrientation, setIosSwipeGestureEnabled, setScreenAwakeMode, setSecureScreen, share, showFullScreenAd, startUpdateLocation, submitGameCenterLeaderBoardScore, tdsEvent };