@apps-in-toss/native-modules 0.0.0-dev.1752115036458 → 0.0.0-dev.1757056983098

package/src/AppsInTossModule/native-event-emitter/startUpdateLocation.ts

@@ -0,0 +1,98 @@
+import type { EmitterSubscription } from 'react-native';
+import { appsInTossEvent } from './appsInTossEvent';
+import type { EventEmitterSchema } from './types';
+import type { Accuracy, Location } from '../../types';
+
+export interface StartUpdateLocationOptions {
+  /**
+   * 위치 정확도를 설정해요.
+   */
+  accuracy: Accuracy;
+  /**
+   * 위치 업데이트 주기를 밀리초(ms) 단위로 설정해요.
+   */
+  timeInterval: number;
+  /**
+   * 위치 변경 거리를 미터(m) 단위로 설정해요.
+   */
+  distanceInterval: number;
+}
+
+export interface StartUpdateLocationSubscription extends EmitterSubscription {
+  remove: () => Promise<void>;
+}
+
+/**
+ * @name UpdateLocationEventEmitter
+ * @kind typedef
+ * @description
+ * 디바이스의 위치 정보 변경을 감지해요
+ */
+export type UpdateLocationEventEmitter = EventEmitterSchema<'updateLocation', [Location]>;
+
+/**
+ * @public
+ * @category 위치 정보
+ * @name startUpdateLocation
+ * @description  디바이스의 위치 정보를 지속적으로 감지하고, 위치가 변경되면 콜백을 실행하는 함수예요. 콜백 함수를 등록하면 위치가 변경될 때마다 자동으로 호출돼요.
+ * 실시간 위치 추적이 필요한 기능을 구현할 때 사용할 수 있어요. 예를 들어 지도 앱에서 사용자의 현재 위치를 실시간으로 업데이트할 때, 운동 앱에서 사용자의 이동 거리를 기록할 때 등이에요.
+ * 위치 업데이트 주기와 정확도를 조정해 배터리 소모를 최소화하면서도 필요한 정보를 얻을 수 있어요.
+ *
+ * @param {StartUpdateLocationOptions} options - 위치 정보 감지에 필요한 설정 객체에요.
+ * @param {number} [options.accuracy] 위치 정확도를 설정해요.
+ * @param {number} [options.timeInterval] 위치 정보를 업데이트하는 최소 주기로, 단위는 밀리초(ms)예요. 이 값은 위치 업데이트가 발생하는 가장 짧은 간격을 설정하지만, 시스템이나 환경의 영향을 받아 지정한 주기보다 더 긴 간격으로 업데이트될 수 있어요.
+ * @param {number} [options.distanceInterval] 위치 변경 거리를 미터(m) 단위로 설정해요.
+ * @param {(location: Location) => void} [options.callback] 위치 정보가 변경될 때 호출되는 콜백 함수예요. 자세한 내용은 [Location](/react-native/reference/native-modules/Types/Location.html)을 참고해주세요.
+ *
+ * @example
+ * ### 위치 정보 변경 감지하기
+ *
+ * ```tsx
+ * import React, { useState, useEffect } from 'react';
+ * import { View, Text, Button } from 'react-native';
+ * import { startUpdateLocation } from '@apps-in-toss/framework';
+ *
+ * // 위치 정보 변경 감지하기
+ * function LocationWatcher() {
+ *   const [location, setLocation] = useState(null);
+ *
+ *   useEffect(() => {
+ *     return startUpdateLocation({
+ *       options: {
+ *         accuracy: Accuracy.Balanced,
+ *         timeInterval: 3000,
+ *         distanceInterval: 10,
+ *       },
+ *       onEvent: (location) => {
+ *         setLocation(location);
+ *       },
+ *       onError: (error) => {
+ *         console.error('위치 정보를 가져오는데 실패했어요:', error);
+ *       },
+ *     });
+ *   }, []);
+ *
+ *   if (location == null) {
+ *     return <Text>위치 정보를 가져오는 중이에요...</Text>;
+ *   }
+ *
+ *   return (
+ *     <View>
+ *       <Text>위도: {location.coords.latitude}</Text>
+ *       <Text>경도: {location.coords.longitude}</Text>
+ *       <Text>위치 정확도: {location.coords.accuracy}m</Text>
+ *       <Text>높이: {location.coords.altitude}m</Text>
+ *       <Text>고도 정확도: {location.coords.altitudeAccuracy}m</Text>
+ *       <Text>방향: {location.coords.heading}°</Text>
+ *     </View>
+ *   );
+ * }
+ * ```
+ */
+export function startUpdateLocation(eventParams: {
+  onEvent: (response: Location) => void;
+  onError: (error: unknown) => void;
+  options: StartUpdateLocationOptions;
+}): () => void {
+  return appsInTossEvent.addEventListener('updateLocationEvent', eventParams);
+}

package/src/AppsInTossModule/native-event-emitter/types.ts

@@ -0,0 +1,4 @@
+export interface EventEmitterSchema<K extends string, P extends unknown[]> {
+  name: K;
+  params: P;
+}

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

@@ -0,0 +1,89 @@
+import { TurboModuleRegistry, type TurboModule as __TurboModule } from 'react-native';
+import type { CheckoutPaymentOptions, CheckoutPaymentResult } from './checkoutPayment';
+import type { FetchAlbumPhotosOptions } from './fetchAlbumPhotos';
+import type { ContactEntity } from './fetchContacts';
+import type { GetCurrentLocationOptions } from './getCurrentLocation';
+import type { GameCenterGameProfileResponse } from './getGameCenterGameProfile';
+import type {
+  IapCreateOneTimePurchaseOrderOptions,
+  IapCreateOneTimePurchaseOrderResult,
+  IapProductListItem,
+} from './iap';
+import type { OpenCameraOptions } from './openCamera';
+import type { SaveBase64DataParams } from './saveBase64Data';
+import type { SubmitGameCenterLeaderBoardScoreResponse } from './submitGameCenterLeaderBoardScore';
+import type { ImageResponse, Location, PermissionAccess, PermissionName, PermissionStatus } from '../../types';
+import type { ContactsViralParams } from '../native-event-emitter/contactsViral';
+
+type CompatiblePlaceholderArgument = object;
+
+/**
+ * TurboModule 타입 별칭 사용하는 이유?
+ * React Native Codegen 에 의해 코드젠 되는 것이 아니라 추후 내부 모듈 체계에 의해 처리될 것이기 때문에 RN Codegen에 본 파일을 코드젠 하지 않도록 함
+ * (코드젠 내부에서 "extends TurboModule" 문자열을 찾기 때문에 패턴에 매칭되지 않도록 함)
+ */
+interface Spec extends __TurboModule {
+  groupId: string;
+  operationalEnvironment: 'sandbox' | 'toss';
+  tossAppVersion: string;
+  deviceId: string;
+  getWebBundleURL: (arg: CompatiblePlaceholderArgument) => { url: string };
+  getClipboardText: (arg: CompatiblePlaceholderArgument) => Promise<string>;
+  setClipboardText: (option: { text: string }) => Promise<void>;
+  getPermission: (permission: { name: PermissionName; access: PermissionAccess }) => Promise<PermissionStatus>;
+  openPermissionDialog: (permission: {
+    name: PermissionName;
+    access: PermissionAccess;
+  }) => Promise<Exclude<PermissionStatus, 'notDetermined'>>;
+  fetchContacts: ({
+    size,
+    offset,
+    query,
+  }: {
+    size: number;
+    offset: number;
+    query?: {
+      contains?: string;
+    };
+  }) => Promise<{
+    result: ContactEntity[];
+    nextOffset: number | undefined;
+    done: boolean;
+  }>;
+  fetchAlbumPhotos: (options: FetchAlbumPhotosOptions) => Promise<ImageResponse[]>;
+  getCurrentLocation: (options: GetCurrentLocationOptions) => Promise<Location>;
+  openCamera: (options: OpenCameraOptions) => Promise<ImageResponse>;
+  appLogin: (
+    arg: CompatiblePlaceholderArgument
+  ) => Promise<{ authorizationCode: string; referrer: 'DEFAULT' | 'SANDBOX' }>;
+  checkoutPayment: (options: { params: CheckoutPaymentOptions }) => Promise<CheckoutPaymentResult>;
+
+  /** Storage */
+  getStorageItem: (params: { key: string }) => Promise<string | null>;
+  setStorageItem: (params: { key: string; value: string }) => Promise<void>;
+  removeStorageItem: (params: { key: string }) => Promise<void>;
+  clearStorage: (arg: CompatiblePlaceholderArgument) => Promise<void>;
+  eventLog: (params: {
+    log_name: string;
+    log_type: 'debug' | 'info' | 'warn' | 'error' | 'screen' | 'impression' | 'click';
+    params: Record<string, string>;
+  }) => Promise<void>;
+  getTossShareLink: (params: object) => Promise<{ shareLink: string }>;
+  setDeviceOrientation: (options: { type: 'portrait' | 'landscape' }) => Promise<void>;
+  saveBase64Data: (params: SaveBase64DataParams) => Promise<void>;
+
+  /** IAP */
+  iapCreateOneTimePurchaseOrder: (
+    params: IapCreateOneTimePurchaseOrderOptions
+  ) => Promise<IapCreateOneTimePurchaseOrderResult>;
+  iapGetProductItemList: (arg: CompatiblePlaceholderArgument) => Promise<{ products: IapProductListItem[] }>;
+  getGameCenterGameProfile: (params: CompatiblePlaceholderArgument) => Promise<GameCenterGameProfileResponse>;
+  submitGameCenterLeaderBoardScore: (params: { score: string }) => Promise<SubmitGameCenterLeaderBoardScoreResponse>;
+
+  contactsViral: (params: ContactsViralParams) => () => void;
+}
+
+const Module = TurboModuleRegistry.getEnforcing<Spec>('AppsInTossModule');
+
+export const AppsInTossModuleInstance = Module as any;
+export const AppsInTossModule = Module;