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

package/src/BedrockModule/native-modules/natives/setSecureScreen.ts

@@ -0,0 +1,31 @@
+import { BedrockModule } from './BedrockModule';
+
+/**
+ * @public
+ * @name setSecureScreen
+ * @category 화면 제어
+ * @kind function
+ * @description
+ * 화면 캡쳐를 차단해서 민감한 정보가 유출되지 않도록 보호하거나, 필요할 경우 캡쳐를 허용하도록 설정해요. 예를 들어 보안이 중요한 화면에서 사용할 수 있어요.
+ *
+ * @param {object} options 화면 캡쳐 설정 옵션이에요.
+ * @param {boolean} options.enabled 화면 캡쳐를 차단할지 여부를 설정해요. `true`면 캡쳐를 차단하고, `false`면 허용해요.
+ * @returns {enabled: boolean} 현재 설정된 캡쳐 차단 상태를 반환해요.
+ *
+ * @example
+ * ### 캡쳐 허용 상태 변경하기
+ *
+ * ```tsx
+ * import { Button } from 'react-native';
+ * import { setSecureScreen } from '@apps-in-toss/native-modules';
+ *
+ * function SetSecureScreen() {
+ *  return <Button title="캡쳐 막기" onPress={async () => {
+ *    await setSecureScreen({ enabled: true });
+ *  }} />;
+ * }
+ * ```
+ */
+export function setSecureScreen(options: { enabled: boolean }): Promise<{ enabled: boolean }> {
+  return BedrockModule.setSecureScreen(options);
+}

package/src/BedrockModule/native-modules/natives/share.ts

@@ -0,0 +1,36 @@
+import { BedrockModule } from './BedrockModule';
+
+/**
+ * @public
+ * @category 공유
+ * @kind function
+ * @name share
+ * @description
+ * 사용자가 콘텐츠를 다른 사람과 공유할 수 있도록 네이티브 공유 시트를 표시해요.
+ * `options.message` 속성에 공유할 메시지를 전달하면, 사용자가 선택할 수 있는 앱 목록이 표시돼요.
+ * 예를 들어, 사용자가 텍스트 메시지를 공유하거나 메모 앱에 저장하려고 할 때 유용해요.
+ * @param {object} options - 공유할 메시지를 담은 객체예요.
+ * @param {string} options.message - 공유할 텍스트 문자열이에요. 예를 들어, "안녕하세요! 이 내용을 공유합니다."
+ *
+ * @example
+ * ### 공유하기 기능 구현하기
+ *
+ * 아래는 버튼을 클릭하면 메시지를 공유하는 간단한 예제예요.
+ *
+ * ```tsx
+ * import { share } from '@apps-in-toss/native-modules';
+ * import { Button } from 'react-native';
+ *
+ * function MyPage() {
+ *   return (
+ *     <Button
+ *       title="공유"
+ *       onPress={() => share({ message: '공유할 메시지입니다.' })}
+ *     />
+ *   );
+ * }
+ * ```
+ */
+export async function share(message: { message: string }) {
+  BedrockModule.share(message);
+}

package/src/async-bridges.ts

@@ -21,3 +21,6 @@ export * from './AppsInTossModule/native-modules/getTossShareLink';
 export * from './AppsInTossModule/native-modules/setDeviceOrientation';
 export * from './AppsInTossModule/native-modules/checkoutPayment';
 export * from './AppsInTossModule/native-modules/saveBase64Data';
+export * from './AppsInTossModule/native-modules/getGameCenterGameProfile';
+export * from './AppsInTossModule/native-modules/openGameCenterLeaderboard';
+export * from './AppsInTossModule/native-modules/submitGameCenterLeaderBoardScore';

package/src/event-bridges.ts

@@ -1,2 +1,4 @@
 // AppsInTossModule
 export * from './AppsInTossModule/native-event-emitter/startUpdateLocation';
+export * from './AppsInTossModule/native-event-emitter/internal/onVisibilityChangedByTransparentServiceWeb';
+export * from './AppsInTossModule/native-event-emitter/contactsViral';

package/src/index.ts

@@ -0,0 +1,16 @@
+// AppsInTossModule
+export * from './AppsInTossModule/native-event-emitter';
+export * from './AppsInTossModule/native-modules';
+
+// BedrockModule
+export * from './BedrockModule/native-modules';
+
+// Types
+export * from './types';
+
+// Private
+import { tossCoreEventLog } from './AppsInTossModule/native-modules/tossCore';
+// eslint-disable-next-line @typescript-eslint/naming-convention
+export const INTERNAL__module = {
+  tossCoreEventLog,
+};

package/src/types.ts

@@ -0,0 +1,108 @@
+export type PermissionStatus = 'notDetermined' | 'denied' | 'allowed';
+export type PermissionAccess = 'read' | 'write' | 'access';
+export type PermissionName = 'clipboard' | 'contacts' | 'photos' | 'geolocation' | 'camera';
+
+// Log
+export type Primitive = string | number | boolean | null | undefined | symbol;
+
+/**
+ * @public
+ * @category 위치 정보
+ * @name Accuracy
+ * @description 위치 정확도 옵션이에요.
+ */
+export enum Accuracy {
+  /**
+   * 오차범위 3KM 이내
+   */
+  Lowest = 1,
+  /**
+   * 오차범위 1KM 이내
+   */
+  Low,
+  /**
+   * 오차범위 몇 백미터 이내
+   */
+  Balanced,
+  /**
+   * 오차범위 10M 이내
+   */
+  High,
+  /**
+   * 가장 높은 정확도
+   */
+  Highest,
+  /**
+   * 네비게이션을 위한 최고 정확도
+   */
+  BestForNavigation,
+}
+
+/**
+ * @public
+ * @category 위치 정보
+ * @name Location
+ * @description 위치 정보를 나타내는 객체예요.
+ */
+export interface Location {
+  /**
+   * Android에서만 지원하는 옵션이에요.
+   *
+   * - `FINE`: 정확한 위치
+   * - `COARSE`: 대략적인 위치
+   *
+   * @see https://developer.android.com/codelabs/approximate-location
+   */
+  accessLocation?: 'FINE' | 'COARSE';
+  /**
+   * 위치가 업데이트된 시점의 유닉스 타임스탬프예요.
+   */
+  timestamp: number;
+  /**
+   * @description 위치 정보를 나타내는 객체예요. 자세한 내용은 [LocationCoords](/react-native/reference/native-modules/Types/LocationCoords.html)을 참고해주세요.
+   */
+  coords: LocationCoords;
+}
+
+/**
+ * @public
+ * @category 위치 정보
+ * @name LocationCoords
+ * @description 세부 위치 정보를 나타내는 객체예요.
+ */
+export interface LocationCoords {
+  /**
+   * 위도
+   */
+  latitude: number;
+  /**
+   * 경도
+   */
+  longitude: number;
+  /**
+   * 높이
+   */
+  altitude: number;
+  /**
+   * 위치 정확도
+   */
+  accuracy: number;
+  /**
+   * 고도 정확도
+   */
+  altitudeAccuracy: number;
+  /**
+   * 방향
+   */
+  heading: number;
+}
+
+/**
+ * 사진 조회 결과를 나타내는 타입이에요.
+ */
+export interface ImageResponse {
+  /** 가져온 사진의 고유 ID예요. */
+  id: string;
+  /** 사진의 데이터 URI예요. `base64` 옵션이 `true`인 경우 Base64 문자열로 반환돼요. */
+  dataUri: string;
+}

package/src/utils/compareVersion.spec.ts

@@ -0,0 +1,176 @@
+import { describe, it, expect } from 'vitest';
+import { compareVersions } from './compareVersion.js';
+
+describe('compareVersions', () => {
+  it('기본 버전 비교가 올바르게 작동해야 합니다', () => {
+    expect(compareVersions('1.0.0', '1.0.0')).toBe(0);
+    expect(compareVersions('1.0.0', '1.0.1')).toBe(-1);
+    expect(compareVersions('1.0.1', '1.0.0')).toBe(1);
+    expect(compareVersions('1.1.0', '1.0.0')).toBe(1);
+    expect(compareVersions('2.0.0', '1.0.0')).toBe(1);
+  });
+
+  it('다양한 길이의 버전을 비교할 수 있어야 합니다', () => {
+    expect(compareVersions('1', '1.0.0')).toBe(0);
+    expect(compareVersions('1.0', '1.0.0')).toBe(0);
+    expect(compareVersions('1', '2')).toBe(-1);
+    expect(compareVersions('1.0', '1.1')).toBe(-1);
+    expect(compareVersions('1.1', '1.0.1')).toBe(1);
+    expect(compareVersions('11.1.10', '11.0')).toBe(1);
+    expect(compareVersions('1.1.1', '1')).toBe(1);
+    expect(compareVersions('01.1.0', '1.01')).toBe(0);
+    expect(compareVersions('10.0.0', '10.114')).toBe(-1);
+    expect(compareVersions('1.0', '1.4.1')).toBe(-1);
+  });
+
+  it('와일드카드 버전을 올바르게 처리해야 합니다', () => {
+    expect(compareVersions('1.x', '1.0.0')).toBe(0);
+    expect(compareVersions('1.*', '1.1.0')).toBe(0);
+    expect(compareVersions('1.0.X', '1.0.1')).toBe(0);
+    expect(compareVersions('3', '3.x.x')).toBe(0);
+    expect(compareVersions('3.3', '3.x.x')).toBe(0);
+    expect(compareVersions('3.3.3', '3.x.x')).toBe(0);
+    expect(compareVersions('3.x.x', '3.3.3')).toBe(0);
+    expect(compareVersions('3.3.3', '3.X.X')).toBe(0);
+    expect(compareVersions('3.3.3', '3.3.x')).toBe(0);
+    expect(compareVersions('3.3.3', '3.*.*')).toBe(0);
+    expect(compareVersions('3.3.3', '3.3.*')).toBe(0);
+    expect(compareVersions('3.0.3', '3.0.*')).toBe(0);
+    expect(compareVersions('0.7.x', '0.6.0')).toBe(1);
+    expect(compareVersions('0.7.x', '0.6.0-asdf')).toBe(1);
+    expect(compareVersions('0.7.x', '0.6.2')).toBe(1);
+    expect(compareVersions('0.7.x', '0.7.0-asdf')).toBe(1);
+    expect(compareVersions('1.2.*', '1.1.3')).toBe(1);
+    expect(compareVersions('1.2.*', '1.1.9999')).toBe(1);
+    expect(compareVersions('1.2.x', '1.0.0')).toBe(1);
+    expect(compareVersions('1.2.x', '1.1.0')).toBe(1);
+    expect(compareVersions('1.2.x', '1.1.3')).toBe(1);
+    expect(compareVersions('2.*.*', '1.0.1')).toBe(1);
+    expect(compareVersions('2.*.*', '1.1.3')).toBe(1);
+    expect(compareVersions('2.x.x', '1.0.0')).toBe(1);
+    expect(compareVersions('2.x.x', '1.1.3')).toBe(1);
+  });
+
+  it('프리릴리스 버전을 올바르게 비교해야 합니다', () => {
+    expect(compareVersions('1.0.0-alpha', '1.0.0')).toBe(-1);
+    expect(compareVersions('1.0.0', '1.0.0-alpha')).toBe(1);
+    expect(compareVersions('1.0.0-alpha', '1.0.0-beta')).toBe(-1);
+    expect(compareVersions('1.0.0-beta.2', '1.0.0-beta.1')).toBe(1);
+    expect(compareVersions('1.0.0-alpha.1', '1.0.0-alpha')).toBe(1);
+    expect(compareVersions('1.0.0-alpha', '1.0.0-alpha.1')).toBe(-1);
+    expect(compareVersions('1.0.0-alpha.1', '1.0.0-alpha.beta')).toBe(-1);
+    expect(compareVersions('1.0.0-alpha.beta', '1.0.0-beta')).toBe(-1);
+    expect(compareVersions('1.0.0-beta', '1.0.0-beta.2')).toBe(-1);
+    expect(compareVersions('1.0.0-beta.2', '1.0.0-beta.11')).toBe(-1);
+    expect(compareVersions('1.0.0-beta.11', '1.0.0-rc.1')).toBe(-1);
+    expect(compareVersions('1.0.0-rc.1', '1.0.0')).toBe(-1);
+    expect(compareVersions('1.0.0-alpha', '1')).toBe(-1);
+    expect(compareVersions('1.0.0-beta.11', '1.0.0-beta.1')).toBe(1);
+    expect(compareVersions('1.0.0-beta.10', '1.0.0-beta.9')).toBe(1);
+    expect(compareVersions('1.0.0-beta.10', '1.0.0-beta.90')).toBe(-1);
+    expect(compareVersions('0.6.1-1', '0.6.1-0')).toBe(1);
+    expect(compareVersions('v0.5.4-pre', '0.5.4-alpha')).toBe(1);
+  });
+
+  it('접두사가 있는 버전을 올바르게 처리해야 합니다', () => {
+    expect(compareVersions('v1.0.0', '1.0.0')).toBe(0);
+    expect(compareVersions('^1.0.0', '1.0.0')).toBe(0);
+    expect(compareVersions('~1.0.0', '1.0.0')).toBe(0);
+    expect(compareVersions('v1.0.0', 'v1.0.0')).toBe(0);
+    expect(compareVersions('v1.0.0-alpha', '1.0.0-alpha')).toBe(0);
+    expect(compareVersions('v3.2.1', 'v2.3.2')).toBe(1);
+  });
+
+  it('선행 0을 무시해야 합니다', () => {
+    expect(compareVersions('01.0.0', '1')).toBe(0);
+    expect(compareVersions('01.0.0', '1.0.0')).toBe(0);
+    expect(compareVersions('1.01.0', '1.01.0')).toBe(0);
+    expect(compareVersions('1.0.03', '1.0.3')).toBe(0);
+    expect(compareVersions('1.0.03-alpha', '1.0.3-alpha')).toBe(0);
+    expect(compareVersions('v01.0.0', '1.0.0')).toBe(0);
+    expect(compareVersions('v01.0.0', '2.0.0')).toBe(-1);
+  });
+
+  it('빌드 메타데이터를 무시해야 합니다', () => {
+    expect(compareVersions('1.4.0-build.3928', '1.4.0-build.3928+sha.a8d9d4f')).toBe(0);
+    expect(compareVersions('1.4.0-build.3928+sha.b8dbdb0', '1.4.0-build.3928+sha.a8d9d4f')).toBe(0);
+    expect(compareVersions('1.0.0-alpha+001', '1.0.0-alpha')).toBe(0);
+    expect(compareVersions('1.0.0-beta+exp.sha.5114f85', '1.0.0-beta+exp.sha.999999')).toBe(0);
+    expect(compareVersions('1.0.0+20130313144700', '1.0.0')).toBe(0);
+    expect(compareVersions('1.0.0+20130313144700', '2.0.0')).toBe(-1);
+    expect(compareVersions('1.0.0+20130313144700', '1.0.1+11234343435')).toBe(-1);
+    expect(compareVersions('1.0.1+1', '1.0.1+2')).toBe(0);
+    expect(compareVersions('1.0.0+a-a', '1.0.0+a-b')).toBe(0);
+  });
+
+  it('4세그먼트 버전을 올바르게 처리해야 합니다', () => {
+    expect(compareVersions('1.0.0.0', '1')).toBe(0);
+    expect(compareVersions('1.0.0.0', '1.0')).toBe(0);
+    expect(compareVersions('1.0.0.0', '1.0.0')).toBe(0);
+    expect(compareVersions('1.0.0.0', '1.0.0.0')).toBe(0);
+    expect(compareVersions('1.2.3.4', '1.2.3.4')).toBe(0);
+    expect(compareVersions('1.2.3.4', '1.2.3.04')).toBe(0);
+    expect(compareVersions('v1.2.3.4', '01.2.3.4')).toBe(0);
+    expect(compareVersions('1.2.3.4', '1.2.3.5')).toBe(-1);
+    expect(compareVersions('1.2.3.5', '1.2.3.4')).toBe(1);
+    expect(compareVersions('1.0.0.0-alpha', '1.0.0-alpha')).toBe(0);
+    expect(compareVersions('1.0.0.0-alpha', '1.0.0.0-beta')).toBe(-1);
+  });
+
+  it('단일 세그먼트 버전을 올바르게 비교해야 합니다', () => {
+    expect(compareVersions('10', '9')).toBe(1);
+    expect(compareVersions('10', '10')).toBe(0);
+    expect(compareVersions('9', '10')).toBe(-1);
+  });
+
+  it('두 세그먼트 버전을 올바르게 비교해야 합니다', () => {
+    expect(compareVersions('10.8', '10.4')).toBe(1);
+    expect(compareVersions('10.1', '10.1')).toBe(0);
+    expect(compareVersions('10.1', '10.2')).toBe(-1);
+  });
+
+  it('세 세그먼트 버전을 올바르게 비교해야 합니다', () => {
+    expect(compareVersions('10.1.8', '10.0.4')).toBe(1);
+    expect(compareVersions('10.0.1', '10.0.1')).toBe(0);
+    expect(compareVersions('10.1.1', '10.2.2')).toBe(-1);
+    expect(compareVersions('11.0.10', '11.0.2')).toBe(1);
+    expect(compareVersions('11.0.2', '11.0.10')).toBe(-1);
+  });
+
+  it('추가 비교 테스트', () => {
+    expect(compareVersions('0.1.21', '0.1.5')).toBe(1);
+    expect(compareVersions('1', '0.0.0-beta')).toBe(1);
+    expect(compareVersions('1', '0.2.3')).toBe(1);
+    expect(compareVersions('1', '0.2.4')).toBe(1);
+    expect(compareVersions('1', '1.0.0-0')).toBe(1);
+    expect(compareVersions('1', '1.0.0-beta')).toBe(1);
+    expect(compareVersions('1.0', '0.0.0')).toBe(1);
+    expect(compareVersions('1.0', '0.1.0')).toBe(1);
+    expect(compareVersions('1.0', '0.1.2')).toBe(1);
+    expect(compareVersions('1.0.0', '0.0.0')).toBe(1);
+    expect(compareVersions('1.0.0', '0.0.1')).toBe(1);
+    expect(compareVersions('1.0.0', '0.2.3')).toBe(1);
+    expect(compareVersions('1.2.2', '1.2.1')).toBe(1);
+    expect(compareVersions('2', '1.0.0')).toBe(1);
+    expect(compareVersions('2', '1.0.0-beta')).toBe(1);
+    expect(compareVersions('2', '1.9999.9999')).toBe(1);
+    expect(compareVersions('2.0.0', '1.0.0')).toBe(1);
+    expect(compareVersions('2.0.0', '1.1.1')).toBe(1);
+    expect(compareVersions('2.0.0', '1.2.9')).toBe(1);
+    expect(compareVersions('2.0.0', '1.9999.9999')).toBe(1);
+    expect(compareVersions('2.3', '2.2.1')).toBe(1);
+    expect(compareVersions('2.3', '2.2.2')).toBe(1);
+    expect(compareVersions('2.4', '2.3.0')).toBe(1);
+    expect(compareVersions('2.4', '2.3.5')).toBe(1);
+    expect(compareVersions('3.2.1', '2.3.2')).toBe(1);
+    expect(compareVersions('3.2.1', '3.2.0')).toBe(1);
+  });
+
+  it('잘못된 버전 형식에 대해 오류를 발생시켜야 합니다', () => {
+    expect(() => compareVersions('invalid', '1.0.0')).toThrow();
+    expect(() => compareVersions('1.0.0', 'invalid')).toThrow();
+    expect(() => compareVersions('6.3.', '1.0.0')).toThrow();
+    expect(() => compareVersions('1.2.3a', '1.0.0')).toThrow();
+    expect(() => compareVersions('1.2.-3a', '1.0.0')).toThrow();
+  });
+});

package/src/utils/compareVersion.ts

@@ -0,0 +1,104 @@
+/**
+ * Allowed arithmetic operators
+ */
+export type CompareOperator = '>' | '>=' | '=' | '<' | '<=' | '!=';
+
+/**
+ * RegExp to match semver versions like:
+ * - 1.0.0
+ * - ^1.2.3-alpha+build
+ * - v2.3
+ */
+const SEMVER_REGEX =
+  /^[v^~<>=]*?(\d+)(?:\.([x*]|\d+)(?:\.([x*]|\d+)(?:\.([x*]|\d+))?(?:-([\da-z\\-]+(?:\.[\da-z\\-]+)*))?(?:\+[\da-z\\-]+(?:\.[\da-z\\-]+)*)?)?)?$/i;
+
+const isWildcard = (val: string) => ['*', 'x', 'X'].includes(val);
+
+const tryParse = (val: string): string | number => {
+  const num = parseInt(val, 10);
+  return isNaN(num) ? val : num;
+};
+
+const coerceTypes = (a: string | number, b: string | number): [string | number, string | number] => {
+  return typeof a === typeof b ? [a, b] : [String(a), String(b)];
+};
+
+const compareValues = (a: string, b: string): number => {
+  if (isWildcard(a) || isWildcard(b)) {
+    return 0;
+  }
+
+  const [aVal, bVal] = coerceTypes(tryParse(a), tryParse(b));
+  if (aVal > bVal) {
+    return 1;
+  }
+  if (aVal < bVal) {
+    return -1;
+  }
+  return 0;
+};
+
+const parseVersion = (version: string): (string | undefined)[] => {
+  if (typeof version !== 'string') {
+    throw new TypeError('Invalid argument: expected a string');
+  }
+
+  const match = version.match(SEMVER_REGEX);
+  if (!match) {
+    throw new Error(`Invalid semver: '${version}'`);
+  }
+
+  const [, major, minor, patch, build, preRelease] = match;
+  return [major, minor, patch, build, preRelease];
+};
+
+const compareSegments = (a: (string | undefined)[], b: (string | undefined)[]): number => {
+  const maxLength = Math.max(a.length, b.length);
+
+  for (let i = 0; i < maxLength; i++) {
+    const segA = a[i] ?? '0';
+    const segB = b[i] ?? '0';
+    const result = compareValues(segA, segB);
+    if (result !== 0) {
+      return result;
+    }
+  }
+
+  return 0;
+};
+
+/**
+ * Compare [semver](https://semver.org/) version strings.
+ * Supports versions like `1`, `1.0`, `1.0.0`, and pre-release like `1.0.0-alpha`.
+ *
+ * @param v1 - First version
+ * @param v2 - Second version
+ * @returns 1 if v1 > v2, -1 if v1 < v2, 0 if equal
+ */
+export const compareVersions = (v1: string, v2: string): number => {
+  const seg1 = parseVersion(v1);
+  const seg2 = parseVersion(v2);
+
+  const preRelease1 = seg1.pop();
+  const preRelease2 = seg2.pop();
+
+  const mainCompare = compareSegments(seg1, seg2);
+  if (mainCompare !== 0) {
+    return mainCompare;
+  }
+
+  // If both have pre-release
+  if (preRelease1 && preRelease2) {
+    return compareSegments(preRelease1.split('.'), preRelease2.split('.'));
+  }
+
+  // If only one has pre-release, it's considered lower precedence
+  if (preRelease1) {
+    return -1;
+  }
+  if (preRelease2) {
+    return 1;
+  }
+
+  return 0;
+};

package/src/utils/generateUUID.ts

@@ -0,0 +1,5 @@
+export function generateUUID(placeholder?: any): string {
+  return placeholder
+    ? (placeholder ^ ((Math.random() * 16) >> (placeholder / 4))).toString(16)
+    : (String(1e7) + 1e3 + 4e3 + 8e3 + 1e11).replace(/[018]/g, generateUUID);
+}