@apps-in-toss/types 0.0.0-dev.1757573431379

package/README.md

@@ -0,0 +1,3 @@
+# @apps-in-toss/types
+
+Types for Apps In Toss

package/dist/index.cjs

@@ -0,0 +1,108 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  Accuracy: () => Accuracy,
+  FetchAlbumPhotosPermissionError: () => FetchAlbumPhotosPermissionError,
+  FetchContactsPermissionError: () => FetchContactsPermissionError,
+  GetClipboardTextPermissionError: () => GetClipboardTextPermissionError,
+  GetCurrentLocationPermissionError: () => GetCurrentLocationPermissionError,
+  OpenCameraPermissionError: () => OpenCameraPermissionError,
+  SetClipboardTextPermissionError: () => SetClipboardTextPermissionError,
+  StartUpdateLocationPermissionError: () => StartUpdateLocationPermissionError
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/permissions/PermissionError.ts
+var PermissionError = class extends Error {
+  constructor({ methodName, message }) {
+    super();
+    this.name = `${methodName} permission error`;
+    this.message = message;
+  }
+};
+
+// src/permissions/FetchAlbumPhotosPermissionError.ts
+var FetchAlbumPhotosPermissionError = class extends PermissionError {
+  constructor() {
+    super({ methodName: "fetchAlbumPhotos", message: "\uC0AC\uC9C4\uCCA9 \uAD8C\uD55C\uC774 \uAC70\uBD80\uB418\uC5C8\uC5B4\uC694." });
+  }
+};
+
+// src/permissions/FetchContactsPermissionError.ts
+var FetchContactsPermissionError = class extends PermissionError {
+  constructor() {
+    super({ methodName: "fetchContacts", message: "\uC5F0\uB77D\uCC98 \uAD8C\uD55C\uC774 \uAC70\uBD80\uB418\uC5C8\uC5B4\uC694." });
+  }
+};
+
+// src/permissions/OpenCameraPermissionError.ts
+var OpenCameraPermissionError = class extends PermissionError {
+  constructor() {
+    super({ methodName: "openCamera", message: "\uCE74\uBA54\uB77C \uAD8C\uD55C\uC774 \uAC70\uBD80\uB418\uC5C8\uC5B4\uC694." });
+  }
+};
+
+// src/permissions/getCurrentLocation.ts
+var Accuracy = /* @__PURE__ */ ((Accuracy2) => {
+  Accuracy2[Accuracy2["Lowest"] = 1] = "Lowest";
+  Accuracy2[Accuracy2["Low"] = 2] = "Low";
+  Accuracy2[Accuracy2["Balanced"] = 3] = "Balanced";
+  Accuracy2[Accuracy2["High"] = 4] = "High";
+  Accuracy2[Accuracy2["Highest"] = 5] = "Highest";
+  Accuracy2[Accuracy2["BestForNavigation"] = 6] = "BestForNavigation";
+  return Accuracy2;
+})(Accuracy || {});
+
+// src/permissions/GetCurrentLocationPermissionError.ts
+var GetCurrentLocationPermissionError = class extends PermissionError {
+  constructor() {
+    super({ methodName: "getCurrentLocation", message: "\uC704\uCE58 \uAD8C\uD55C\uC774 \uAC70\uBD80\uB418\uC5C8\uC5B4\uC694." });
+  }
+};
+
+// src/permissions/StartUpdateLocationPermissionError.ts
+var StartUpdateLocationPermissionError = GetCurrentLocationPermissionError;
+
+// src/permissions/GetClipboardTextPermissionError.ts
+var GetClipboardTextPermissionError = class extends PermissionError {
+  constructor() {
+    super({ methodName: "getClipboardText", message: "\uD074\uB9BD\uBCF4\uB4DC \uC77D\uAE30 \uAD8C\uD55C\uC774 \uAC70\uBD80\uB418\uC5C8\uC5B4\uC694." });
+  }
+};
+
+// src/permissions/SetClipboardTextPermissionError.ts
+var SetClipboardTextPermissionError = class extends PermissionError {
+  constructor() {
+    super({ methodName: "setClipboardText", message: "\uD074\uB9BD\uBCF4\uB4DC \uC4F0\uAE30 \uAD8C\uD55C\uC774 \uAC70\uBD80\uB418\uC5C8\uC5B4\uC694." });
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Accuracy,
+  FetchAlbumPhotosPermissionError,
+  FetchContactsPermissionError,
+  GetClipboardTextPermissionError,
+  GetCurrentLocationPermissionError,
+  OpenCameraPermissionError,
+  SetClipboardTextPermissionError,
+  StartUpdateLocationPermissionError
+});

package/dist/index.d.cts

@@ -0,0 +1,309 @@
+/**
+ * 앨범 사진을 조회할 때 사용하는 옵션 타입이에요.
+ */
+interface FetchAlbumPhotosOptions {
+    /** 가져올 사진의 최대 개수를 설정해요. 숫자를 입력하고 기본값은 10이에요. */
+    maxCount?: number;
+    /** 사진의 최대 폭을 제한해요. 단위는 픽셀이고 기본값은 1024이에요. */
+    maxWidth?: number;
+    /** 이미지를 base64 형식으로 반환할지 설정해요. 기본값은 `false`예요. */
+    base64?: boolean;
+}
+/**
+ * 사진 조회 결과를 나타내는 타입이에요.
+ */
+interface ImageResponse {
+    /** 가져온 사진의 고유 ID예요. */
+    id: string;
+    /** 사진의 데이터 URI예요. `base64` 옵션이 `true`인 경우 Base64 문자열로 반환돼요. */
+    dataUri: string;
+}
+type FetchAlbumPhotos = (options?: FetchAlbumPhotosOptions) => Promise<ImageResponse[]>;
+
+type CompatiblePlaceholderArgument = object;
+type PermissionFunctionName = 'getClipboardText' | 'setClipboardText' | 'fetchContacts' | 'fetchAlbumPhotos' | 'getCurrentLocation' | 'openCamera';
+
+/**
+ * @public
+ * @category 권한
+ * @name PermissionError
+ * @description 권한 에러를 나타내는 클래스예요. 공통된 권한에러를 처리할 때 사용해요. 에러가 발생했을 때 `error instanceof PermissionError`를 통해 확인할 수 있어요.
+ */
+declare class PermissionError extends Error {
+    constructor({ methodName, message }: {
+        methodName: PermissionFunctionName;
+        message: string;
+    });
+}
+
+/**
+ * @public
+ * @category 권한
+ * @name FetchAlbumPhotosPermissionError
+ * @description 사진첩 권한이 거부되었을 때 발생하는 에러예요. 에러가 발생했을 때 `error instanceof FetchAlbumPhotosPermissionError`를 통해 확인할 수 있어요.
+ */
+declare class FetchAlbumPhotosPermissionError extends PermissionError {
+    constructor();
+}
+
+interface FetchContactsOptions {
+    size: number;
+    offset: number;
+    query?: {
+        contains?: string;
+    };
+}
+/**
+ * 연락처 정보를 나타내는 타입이에요.
+ */
+interface ContactEntity {
+    /** 연락처 이름이에요. */
+    name: string;
+    /** 연락처 전화번호로, 문자열 형식이에요. */
+    phoneNumber: string;
+}
+interface ContactResult {
+    result: ContactEntity[];
+    nextOffset: number | null;
+    done: boolean;
+}
+type FetchContacts = (options: FetchContactsOptions) => Promise<ContactResult>;
+
+/**
+ * @public
+ * @category 권한
+ * @name FetchContactsPermissionError
+ * @description 연락처 권한이 거부되었을 때 발생하는 에러예요. 에러가 발생했을 때 `error instanceof FetchContactsPermissionError`를 통해 확인할 수 있어요.
+ */
+declare class FetchContactsPermissionError extends PermissionError {
+    constructor();
+}
+
+interface OpenCameraOptions {
+    /**
+     * 이미지를 Base64 형식으로 반환할지 여부를 나타내는 불리언 값이에요.
+     *
+     * 기본값: `false`.
+     */
+    base64?: boolean;
+    /**
+     * 이미지의 최대 너비를 나타내는 숫자 값이에요.
+     *
+     * 기본값: `1024`.
+     */
+    maxWidth?: number;
+}
+type OpenCamera = (options?: OpenCameraOptions) => Promise<ImageResponse>;
+
+/**
+ * @public
+ * @category 권한
+ * @name OpenCameraPermissionError
+ * @description 카메라 권한이 거부되었을 때 발생하는 에러예요. 에러가 발생했을 때 `error instanceof OpenCameraPermissionError`를 통해 확인할 수 있어요.
+ */
+declare class OpenCameraPermissionError extends PermissionError {
+    constructor();
+}
+
+/**
+ * @public
+ * @category 위치 정보
+ * @name Accuracy
+ * @description 위치 정확도 옵션이에요.
+ */
+declare enum Accuracy {
+    /**
+     * 오차범위 3KM 이내
+     */
+    Lowest = 1,
+    /**
+     * 오차범위 1KM 이내
+     */
+    Low = 2,
+    /**
+     * 오차범위 몇 백미터 이내
+     */
+    Balanced = 3,
+    /**
+     * 오차범위 10M 이내
+     */
+    High = 4,
+    /**
+     * 가장 높은 정확도
+     */
+    Highest = 5,
+    /**
+     * 네비게이션을 위한 최고 정확도
+     */
+    BestForNavigation = 6
+}
+interface GetCurrentLocationOptions {
+    /**
+     * 위치 정보를 가져올 정확도 수준이에요.
+     */
+    accuracy: Accuracy;
+}
+/**
+ * @public
+ * @category 위치 정보
+ * @name Location
+ * @description 위치 정보를 나타내는 객체예요.
+ */
+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 세부 위치 정보를 나타내는 객체예요.
+ */
+interface LocationCoords {
+    /**
+     * 위도
+     */
+    latitude: number;
+    /**
+     * 경도
+     */
+    longitude: number;
+    /**
+     * 높이
+     */
+    altitude: number;
+    /**
+     * 위치 정확도
+     */
+    accuracy: number;
+    /**
+     * 고도 정확도
+     */
+    altitudeAccuracy: number;
+    /**
+     * 방향
+     */
+    heading: number;
+}
+type GetCurrentLocation = (options: GetCurrentLocationOptions) => Promise<Location>;
+
+/**
+ * @public
+ * @category 권한
+ *  @name GetCurrentLocationPermissionError
+ * @description 위치 권한이 거부되었을 때 발생하는 에러예요. 에러가 발생했을 때 `error instanceof GetCurrentLocationPermissionError`를 통해 확인할 수 있어요.
+ */
+declare class GetCurrentLocationPermissionError extends PermissionError {
+    constructor();
+}
+
+interface StartUpdateLocationOptions {
+    /**
+     * 위치 정확도를 설정해요.
+     */
+    accuracy: Accuracy;
+    /**
+     * 위치 업데이트 주기를 밀리초(ms) 단위로 설정해요.
+     */
+    timeInterval: number;
+    /**
+     * 위치 변경 거리를 미터(m) 단위로 설정해요.
+     */
+    distanceInterval: number;
+}
+type StartUpdateLocationEventParams = {
+    onEvent: (response: Location) => void;
+    onError: (error: unknown) => void;
+    options: StartUpdateLocationOptions;
+};
+type StartUpdateLocation = (eventParams: StartUpdateLocationEventParams) => () => void;
+
+/**
+ * @public
+ * @category 권한
+ *  @name StartUpdateLocationPermissionError
+ * @description 위치 업데이트 권한이 거부되었을 때 발생하는 에러예요. 에러가 발생했을 때 `error instanceof StartUpdateLocationPermissionError`를 통해 확인할 수 있어요.
+ */
+declare const StartUpdateLocationPermissionError: typeof GetCurrentLocationPermissionError;
+
+type GetClipboardText = () => Promise<string>;
+
+/**
+ * @public
+ * @category 권한
+ * @name GetClipboardTextPermissionError
+ * @description 클립보드 읽기 권한이 거부되었을 때 발생하는 에러예요. 에러가 발생했을 때 `error instanceof GetClipboardTextPermissionError`를 통해 확인할 수 있어요.
+ */
+declare class GetClipboardTextPermissionError extends PermissionError {
+    constructor();
+}
+
+interface SetClipboardTextOptions {
+    text: string;
+}
+type SetClipboardText = (text: string) => Promise<void>;
+
+/**
+ * @public
+ * @category 권한
+ * @name SetClipboardTextPermissionError
+ * @description 클립보드 쓰기 권한이 거부되었을 때 발생하는 에러예요. 에러가 발생했을 때 `error instanceof SetClipboardTextPermissionError`를 통해 확인할 수 있어요.
+ */
+declare class SetClipboardTextPermissionError extends PermissionError {
+    constructor();
+}
+
+type PermissionStatus = 'notDetermined' | 'denied' | 'allowed';
+type PermissionAccess = 'read' | 'write' | 'access';
+type PermissionName = 'clipboard' | 'contacts' | 'photos' | 'geolocation' | 'camera';
+interface PermissionErrorConstructorParams {
+    methodName: PermissionFunctionName;
+    message: string;
+}
+interface PermissionErrorType extends Error {
+    name: string;
+    message: string;
+}
+interface CreatePermissionFunctionOptions<T extends (...args: any[]) => any> {
+    handler: T;
+    permission: {
+        name: PermissionName;
+        access: PermissionAccess;
+    };
+    error: new () => PermissionErrorType;
+}
+type RequestPermissionFunction = (permission: {
+    name: PermissionName;
+    access: PermissionAccess;
+}) => Promise<Exclude<PermissionStatus, 'notDetermined'>>;
+type InternalPermissionDialogFunction = (permission: {
+    name: PermissionName;
+    access: PermissionAccess;
+}) => Promise<Exclude<PermissionStatus, 'notDetermined'>>;
+type InternalGetPermissionFunction = (permission: {
+    name: PermissionName;
+    access: PermissionAccess;
+}) => Promise<PermissionStatus>;
+type PermissionDialogFunction = () => Promise<Exclude<PermissionStatus, 'notDetermined'>>;
+type GetPermissionFunction = () => Promise<PermissionStatus>;
+type PermissionFunctionWithDialog<T extends (...args: any[]) => any> = T & {
+    getPermission: GetPermissionFunction;
+    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 };

package/dist/index.d.ts

@@ -0,0 +1,309 @@
+/**
+ * 앨범 사진을 조회할 때 사용하는 옵션 타입이에요.
+ */
+interface FetchAlbumPhotosOptions {
+    /** 가져올 사진의 최대 개수를 설정해요. 숫자를 입력하고 기본값은 10이에요. */
+    maxCount?: number;
+    /** 사진의 최대 폭을 제한해요. 단위는 픽셀이고 기본값은 1024이에요. */
+    maxWidth?: number;
+    /** 이미지를 base64 형식으로 반환할지 설정해요. 기본값은 `false`예요. */
+    base64?: boolean;
+}
+/**
+ * 사진 조회 결과를 나타내는 타입이에요.
+ */
+interface ImageResponse {
+    /** 가져온 사진의 고유 ID예요. */
+    id: string;
+    /** 사진의 데이터 URI예요. `base64` 옵션이 `true`인 경우 Base64 문자열로 반환돼요. */
+    dataUri: string;
+}
+type FetchAlbumPhotos = (options?: FetchAlbumPhotosOptions) => Promise<ImageResponse[]>;
+
+type CompatiblePlaceholderArgument = object;
+type PermissionFunctionName = 'getClipboardText' | 'setClipboardText' | 'fetchContacts' | 'fetchAlbumPhotos' | 'getCurrentLocation' | 'openCamera';
+
+/**
+ * @public
+ * @category 권한
+ * @name PermissionError
+ * @description 권한 에러를 나타내는 클래스예요. 공통된 권한에러를 처리할 때 사용해요. 에러가 발생했을 때 `error instanceof PermissionError`를 통해 확인할 수 있어요.
+ */
+declare class PermissionError extends Error {
+    constructor({ methodName, message }: {
+        methodName: PermissionFunctionName;
+        message: string;
+    });
+}
+
+/**
+ * @public
+ * @category 권한
+ * @name FetchAlbumPhotosPermissionError
+ * @description 사진첩 권한이 거부되었을 때 발생하는 에러예요. 에러가 발생했을 때 `error instanceof FetchAlbumPhotosPermissionError`를 통해 확인할 수 있어요.
+ */
+declare class FetchAlbumPhotosPermissionError extends PermissionError {
+    constructor();
+}
+
+interface FetchContactsOptions {
+    size: number;
+    offset: number;
+    query?: {
+        contains?: string;
+    };
+}
+/**
+ * 연락처 정보를 나타내는 타입이에요.
+ */
+interface ContactEntity {
+    /** 연락처 이름이에요. */
+    name: string;
+    /** 연락처 전화번호로, 문자열 형식이에요. */
+    phoneNumber: string;
+}
+interface ContactResult {
+    result: ContactEntity[];
+    nextOffset: number | null;
+    done: boolean;
+}
+type FetchContacts = (options: FetchContactsOptions) => Promise<ContactResult>;
+
+/**
+ * @public
+ * @category 권한
+ * @name FetchContactsPermissionError
+ * @description 연락처 권한이 거부되었을 때 발생하는 에러예요. 에러가 발생했을 때 `error instanceof FetchContactsPermissionError`를 통해 확인할 수 있어요.
+ */
+declare class FetchContactsPermissionError extends PermissionError {
+    constructor();
+}
+
+interface OpenCameraOptions {
+    /**
+     * 이미지를 Base64 형식으로 반환할지 여부를 나타내는 불리언 값이에요.
+     *
+     * 기본값: `false`.
+     */
+    base64?: boolean;
+    /**
+     * 이미지의 최대 너비를 나타내는 숫자 값이에요.
+     *
+     * 기본값: `1024`.
+     */
+    maxWidth?: number;
+}
+type OpenCamera = (options?: OpenCameraOptions) => Promise<ImageResponse>;
+
+/**
+ * @public
+ * @category 권한
+ * @name OpenCameraPermissionError
+ * @description 카메라 권한이 거부되었을 때 발생하는 에러예요. 에러가 발생했을 때 `error instanceof OpenCameraPermissionError`를 통해 확인할 수 있어요.
+ */
+declare class OpenCameraPermissionError extends PermissionError {
+    constructor();
+}
+
+/**
+ * @public
+ * @category 위치 정보
+ * @name Accuracy
+ * @description 위치 정확도 옵션이에요.
+ */
+declare enum Accuracy {
+    /**
+     * 오차범위 3KM 이내
+     */
+    Lowest = 1,
+    /**
+     * 오차범위 1KM 이내
+     */
+    Low = 2,
+    /**
+     * 오차범위 몇 백미터 이내
+     */
+    Balanced = 3,
+    /**
+     * 오차범위 10M 이내
+     */
+    High = 4,
+    /**
+     * 가장 높은 정확도
+     */
+    Highest = 5,
+    /**
+     * 네비게이션을 위한 최고 정확도
+     */
+    BestForNavigation = 6
+}
+interface GetCurrentLocationOptions {
+    /**
+     * 위치 정보를 가져올 정확도 수준이에요.
+     */
+    accuracy: Accuracy;
+}
+/**
+ * @public
+ * @category 위치 정보
+ * @name Location
+ * @description 위치 정보를 나타내는 객체예요.
+ */
+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 세부 위치 정보를 나타내는 객체예요.
+ */
+interface LocationCoords {
+    /**
+     * 위도
+     */
+    latitude: number;
+    /**
+     * 경도
+     */
+    longitude: number;
+    /**
+     * 높이
+     */
+    altitude: number;
+    /**
+     * 위치 정확도
+     */
+    accuracy: number;
+    /**
+     * 고도 정확도
+     */
+    altitudeAccuracy: number;
+    /**
+     * 방향
+     */
+    heading: number;
+}
+type GetCurrentLocation = (options: GetCurrentLocationOptions) => Promise<Location>;
+
+/**
+ * @public
+ * @category 권한
+ *  @name GetCurrentLocationPermissionError
+ * @description 위치 권한이 거부되었을 때 발생하는 에러예요. 에러가 발생했을 때 `error instanceof GetCurrentLocationPermissionError`를 통해 확인할 수 있어요.
+ */
+declare class GetCurrentLocationPermissionError extends PermissionError {
+    constructor();
+}
+
+interface StartUpdateLocationOptions {
+    /**
+     * 위치 정확도를 설정해요.
+     */
+    accuracy: Accuracy;
+    /**
+     * 위치 업데이트 주기를 밀리초(ms) 단위로 설정해요.
+     */
+    timeInterval: number;
+    /**
+     * 위치 변경 거리를 미터(m) 단위로 설정해요.
+     */
+    distanceInterval: number;
+}
+type StartUpdateLocationEventParams = {
+    onEvent: (response: Location) => void;
+    onError: (error: unknown) => void;
+    options: StartUpdateLocationOptions;
+};
+type StartUpdateLocation = (eventParams: StartUpdateLocationEventParams) => () => void;
+
+/**
+ * @public
+ * @category 권한
+ *  @name StartUpdateLocationPermissionError
+ * @description 위치 업데이트 권한이 거부되었을 때 발생하는 에러예요. 에러가 발생했을 때 `error instanceof StartUpdateLocationPermissionError`를 통해 확인할 수 있어요.
+ */
+declare const StartUpdateLocationPermissionError: typeof GetCurrentLocationPermissionError;
+
+type GetClipboardText = () => Promise<string>;
+
+/**
+ * @public
+ * @category 권한
+ * @name GetClipboardTextPermissionError
+ * @description 클립보드 읽기 권한이 거부되었을 때 발생하는 에러예요. 에러가 발생했을 때 `error instanceof GetClipboardTextPermissionError`를 통해 확인할 수 있어요.
+ */
+declare class GetClipboardTextPermissionError extends PermissionError {
+    constructor();
+}
+
+interface SetClipboardTextOptions {
+    text: string;
+}
+type SetClipboardText = (text: string) => Promise<void>;
+
+/**
+ * @public
+ * @category 권한
+ * @name SetClipboardTextPermissionError
+ * @description 클립보드 쓰기 권한이 거부되었을 때 발생하는 에러예요. 에러가 발생했을 때 `error instanceof SetClipboardTextPermissionError`를 통해 확인할 수 있어요.
+ */
+declare class SetClipboardTextPermissionError extends PermissionError {
+    constructor();
+}
+
+type PermissionStatus = 'notDetermined' | 'denied' | 'allowed';
+type PermissionAccess = 'read' | 'write' | 'access';
+type PermissionName = 'clipboard' | 'contacts' | 'photos' | 'geolocation' | 'camera';
+interface PermissionErrorConstructorParams {
+    methodName: PermissionFunctionName;
+    message: string;
+}
+interface PermissionErrorType extends Error {
+    name: string;
+    message: string;
+}
+interface CreatePermissionFunctionOptions<T extends (...args: any[]) => any> {
+    handler: T;
+    permission: {
+        name: PermissionName;
+        access: PermissionAccess;
+    };
+    error: new () => PermissionErrorType;
+}
+type RequestPermissionFunction = (permission: {
+    name: PermissionName;
+    access: PermissionAccess;
+}) => Promise<Exclude<PermissionStatus, 'notDetermined'>>;
+type InternalPermissionDialogFunction = (permission: {
+    name: PermissionName;
+    access: PermissionAccess;
+}) => Promise<Exclude<PermissionStatus, 'notDetermined'>>;
+type InternalGetPermissionFunction = (permission: {
+    name: PermissionName;
+    access: PermissionAccess;
+}) => Promise<PermissionStatus>;
+type PermissionDialogFunction = () => Promise<Exclude<PermissionStatus, 'notDetermined'>>;
+type GetPermissionFunction = () => Promise<PermissionStatus>;
+type PermissionFunctionWithDialog<T extends (...args: any[]) => any> = T & {
+    getPermission: GetPermissionFunction;
+    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 };

package/dist/index.js

@@ -0,0 +1,74 @@
+// src/permissions/PermissionError.ts
+var PermissionError = class extends Error {
+  constructor({ methodName, message }) {
+    super();
+    this.name = `${methodName} permission error`;
+    this.message = message;
+  }
+};
+
+// src/permissions/FetchAlbumPhotosPermissionError.ts
+var FetchAlbumPhotosPermissionError = class extends PermissionError {
+  constructor() {
+    super({ methodName: "fetchAlbumPhotos", message: "\uC0AC\uC9C4\uCCA9 \uAD8C\uD55C\uC774 \uAC70\uBD80\uB418\uC5C8\uC5B4\uC694." });
+  }
+};
+
+// src/permissions/FetchContactsPermissionError.ts
+var FetchContactsPermissionError = class extends PermissionError {
+  constructor() {
+    super({ methodName: "fetchContacts", message: "\uC5F0\uB77D\uCC98 \uAD8C\uD55C\uC774 \uAC70\uBD80\uB418\uC5C8\uC5B4\uC694." });
+  }
+};
+
+// src/permissions/OpenCameraPermissionError.ts
+var OpenCameraPermissionError = class extends PermissionError {
+  constructor() {
+    super({ methodName: "openCamera", message: "\uCE74\uBA54\uB77C \uAD8C\uD55C\uC774 \uAC70\uBD80\uB418\uC5C8\uC5B4\uC694." });
+  }
+};
+
+// src/permissions/getCurrentLocation.ts
+var Accuracy = /* @__PURE__ */ ((Accuracy2) => {
+  Accuracy2[Accuracy2["Lowest"] = 1] = "Lowest";
+  Accuracy2[Accuracy2["Low"] = 2] = "Low";
+  Accuracy2[Accuracy2["Balanced"] = 3] = "Balanced";
+  Accuracy2[Accuracy2["High"] = 4] = "High";
+  Accuracy2[Accuracy2["Highest"] = 5] = "Highest";
+  Accuracy2[Accuracy2["BestForNavigation"] = 6] = "BestForNavigation";
+  return Accuracy2;
+})(Accuracy || {});
+
+// src/permissions/GetCurrentLocationPermissionError.ts
+var GetCurrentLocationPermissionError = class extends PermissionError {
+  constructor() {
+    super({ methodName: "getCurrentLocation", message: "\uC704\uCE58 \uAD8C\uD55C\uC774 \uAC70\uBD80\uB418\uC5C8\uC5B4\uC694." });
+  }
+};
+
+// src/permissions/StartUpdateLocationPermissionError.ts
+var StartUpdateLocationPermissionError = GetCurrentLocationPermissionError;
+
+// src/permissions/GetClipboardTextPermissionError.ts
+var GetClipboardTextPermissionError = class extends PermissionError {
+  constructor() {
+    super({ methodName: "getClipboardText", message: "\uD074\uB9BD\uBCF4\uB4DC \uC77D\uAE30 \uAD8C\uD55C\uC774 \uAC70\uBD80\uB418\uC5C8\uC5B4\uC694." });
+  }
+};
+
+// src/permissions/SetClipboardTextPermissionError.ts
+var SetClipboardTextPermissionError = class extends PermissionError {
+  constructor() {
+    super({ methodName: "setClipboardText", message: "\uD074\uB9BD\uBCF4\uB4DC \uC4F0\uAE30 \uAD8C\uD55C\uC774 \uAC70\uBD80\uB418\uC5C8\uC5B4\uC694." });
+  }
+};
+export {
+  Accuracy,
+  FetchAlbumPhotosPermissionError,
+  FetchContactsPermissionError,
+  GetClipboardTextPermissionError,
+  GetCurrentLocationPermissionError,
+  OpenCameraPermissionError,
+  SetClipboardTextPermissionError,
+  StartUpdateLocationPermissionError
+};

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@apps-in-toss/types",
+  "type": "module",
+  "version": "0.0.0-dev.1757573431379",
+  "description": "Types for Apps In Toss",
+  "scripts": {
+    "prepack": "yarn build",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint .",
+    "build": "tsup"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.cjs",
+      "import": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "devDependencies": {
+    "@types/react": "18.3.3",
+    "esbuild": "0.25.5",
+    "tsup": "^8.5.0",
+    "typescript": "4.9.5"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "gitHead": "21c448c93d9212ce09af01cc21fc39b9877aabc9"
+}

package/src/index.ts

@@ -0,0 +1 @@
+export * from './permissions';

package/src/permissions/FetchAlbumPhotosPermissionError.ts

@@ -0,0 +1,13 @@
+import { PermissionError } from './PermissionError';
+
+/**
+ * @public
+ * @category 권한
+ * @name FetchAlbumPhotosPermissionError
+ * @description 사진첩 권한이 거부되었을 때 발생하는 에러예요. 에러가 발생했을 때 `error instanceof FetchAlbumPhotosPermissionError`를 통해 확인할 수 있어요.
+ */
+export class FetchAlbumPhotosPermissionError extends PermissionError {
+  constructor() {
+    super({ methodName: 'fetchAlbumPhotos', message: '사진첩 권한이 거부되었어요.' });
+  }
+}

package/src/permissions/FetchContactsPermissionError.ts

@@ -0,0 +1,13 @@
+import { PermissionError } from './PermissionError';
+
+/**
+ * @public
+ * @category 권한
+ * @name FetchContactsPermissionError
+ * @description 연락처 권한이 거부되었을 때 발생하는 에러예요. 에러가 발생했을 때 `error instanceof FetchContactsPermissionError`를 통해 확인할 수 있어요.
+ */
+export class FetchContactsPermissionError extends PermissionError {
+  constructor() {
+    super({ methodName: 'fetchContacts', message: '연락처 권한이 거부되었어요.' });
+  }
+}

package/src/permissions/GetClipboardTextPermissionError.ts

@@ -0,0 +1,13 @@
+import { PermissionError } from './PermissionError';
+
+/**
+ * @public
+ * @category 권한
+ * @name GetClipboardTextPermissionError
+ * @description 클립보드 읽기 권한이 거부되었을 때 발생하는 에러예요. 에러가 발생했을 때 `error instanceof GetClipboardTextPermissionError`를 통해 확인할 수 있어요.
+ */
+export class GetClipboardTextPermissionError extends PermissionError {
+  constructor() {
+    super({ methodName: 'getClipboardText', message: '클립보드 읽기 권한이 거부되었어요.' });
+  }
+}

package/src/permissions/GetCurrentLocationPermissionError.ts

@@ -0,0 +1,13 @@
+import { PermissionError } from './PermissionError';
+
+/**
+ * @public
+ * @category 권한
+ *  @name GetCurrentLocationPermissionError
+ * @description 위치 권한이 거부되었을 때 발생하는 에러예요. 에러가 발생했을 때 `error instanceof GetCurrentLocationPermissionError`를 통해 확인할 수 있어요.
+ */
+export class GetCurrentLocationPermissionError extends PermissionError {
+  constructor() {
+    super({ methodName: 'getCurrentLocation', message: '위치 권한이 거부되었어요.' });
+  }
+}

package/src/permissions/OpenCameraPermissionError.ts

@@ -0,0 +1,13 @@
+import { PermissionError } from './PermissionError';
+
+/**
+ * @public
+ * @category 권한
+ * @name OpenCameraPermissionError
+ * @description 카메라 권한이 거부되었을 때 발생하는 에러예요. 에러가 발생했을 때 `error instanceof OpenCameraPermissionError`를 통해 확인할 수 있어요.
+ */
+export class OpenCameraPermissionError extends PermissionError {
+  constructor() {
+    super({ methodName: 'openCamera', message: '카메라 권한이 거부되었어요.' });
+  }
+}

package/src/permissions/PermissionError.ts

@@ -0,0 +1,15 @@
+import type { PermissionFunctionName } from './nativeModules';
+
+/**
+ * @public
+ * @category 권한
+ * @name PermissionError
+ * @description 권한 에러를 나타내는 클래스예요. 공통된 권한에러를 처리할 때 사용해요. 에러가 발생했을 때 `error instanceof PermissionError`를 통해 확인할 수 있어요.
+ */
+export class PermissionError extends Error {
+  constructor({ methodName, message }: { methodName: PermissionFunctionName; message: string }) {
+    super();
+    this.name = `${methodName} permission error`;
+    this.message = message;
+  }
+}

package/src/permissions/SetClipboardTextPermissionError.ts

@@ -0,0 +1,13 @@
+import { PermissionError } from './PermissionError';
+
+/**
+ * @public
+ * @category 권한
+ * @name SetClipboardTextPermissionError
+ * @description 클립보드 쓰기 권한이 거부되었을 때 발생하는 에러예요. 에러가 발생했을 때 `error instanceof SetClipboardTextPermissionError`를 통해 확인할 수 있어요.
+ */
+export class SetClipboardTextPermissionError extends PermissionError {
+  constructor() {
+    super({ methodName: 'setClipboardText', message: '클립보드 쓰기 권한이 거부되었어요.' });
+  }
+}

package/src/permissions/StartUpdateLocationPermissionError.ts

@@ -0,0 +1,9 @@
+import { GetCurrentLocationPermissionError } from './GetCurrentLocationPermissionError';
+
+/**
+ * @public
+ * @category 권한
+ *  @name StartUpdateLocationPermissionError
+ * @description 위치 업데이트 권한이 거부되었을 때 발생하는 에러예요. 에러가 발생했을 때 `error instanceof StartUpdateLocationPermissionError`를 통해 확인할 수 있어요.
+ */
+export const StartUpdateLocationPermissionError = GetCurrentLocationPermissionError;

package/src/permissions/fetchAlbumPhotos.ts

@@ -0,0 +1,23 @@
+/**
+ * 앨범 사진을 조회할 때 사용하는 옵션 타입이에요.
+ */
+export interface FetchAlbumPhotosOptions {
+  /** 가져올 사진의 최대 개수를 설정해요. 숫자를 입력하고 기본값은 10이에요. */
+  maxCount?: number;
+  /** 사진의 최대 폭을 제한해요. 단위는 픽셀이고 기본값은 1024이에요. */
+  maxWidth?: number;
+  /** 이미지를 base64 형식으로 반환할지 설정해요. 기본값은 `false`예요. */
+  base64?: boolean;
+}
+
+/**
+ * 사진 조회 결과를 나타내는 타입이에요.
+ */
+export interface ImageResponse {
+  /** 가져온 사진의 고유 ID예요. */
+  id: string;
+  /** 사진의 데이터 URI예요. `base64` 옵션이 `true`인 경우 Base64 문자열로 반환돼요. */
+  dataUri: string;
+}
+
+export type FetchAlbumPhotos = (options?: FetchAlbumPhotosOptions) => Promise<ImageResponse[]>;

package/src/permissions/fetchContacts.ts

@@ -0,0 +1,25 @@
+export interface FetchContactsOptions {
+  size: number;
+  offset: number;
+  query?: {
+    contains?: string;
+  };
+}
+
+/**
+ * 연락처 정보를 나타내는 타입이에요.
+ */
+export interface ContactEntity {
+  /** 연락처 이름이에요. */
+  name: string;
+  /** 연락처 전화번호로, 문자열 형식이에요. */
+  phoneNumber: string;
+}
+
+export interface ContactResult {
+  result: ContactEntity[];
+  nextOffset: number | null;
+  done: boolean;
+}
+
+export type FetchContacts = (options: FetchContactsOptions) => Promise<ContactResult>;

package/src/permissions/getClipboardText.ts

@@ -0,0 +1 @@
+export type GetClipboardText = () => Promise<string>;

package/src/permissions/getCurrentLocation.ts

@@ -0,0 +1,100 @@
+/**
+ * @public
+ * @category 위치 정보
+ * @name Accuracy
+ * @description 위치 정확도 옵션이에요.
+ */
+export enum Accuracy {
+  /**
+   * 오차범위 3KM 이내
+   */
+  Lowest = 1,
+  /**
+   * 오차범위 1KM 이내
+   */
+  Low,
+  /**
+   * 오차범위 몇 백미터 이내
+   */
+  Balanced,
+  /**
+   * 오차범위 10M 이내
+   */
+  High,
+  /**
+   * 가장 높은 정확도
+   */
+  Highest,
+  /**
+   * 네비게이션을 위한 최고 정확도
+   */
+  BestForNavigation,
+}
+
+export interface GetCurrentLocationOptions {
+  /**
+   * 위치 정보를 가져올 정확도 수준이에요.
+   */
+  accuracy: Accuracy;
+}
+
+/**
+ * @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 type GetCurrentLocation = (options: GetCurrentLocationOptions) => Promise<Location>;

package/src/permissions/index.ts

@@ -0,0 +1,29 @@
+/** album photos */
+export * from './fetchAlbumPhotos';
+export * from './FetchAlbumPhotosPermissionError';
+
+/** contacts */
+export * from './fetchContacts';
+export * from './FetchContactsPermissionError';
+
+/** camera */
+export * from './openCamera';
+export * from './OpenCameraPermissionError';
+
+/** location */
+export * from './getCurrentLocation';
+export * from './GetCurrentLocationPermissionError';
+
+export * from './startUpdateLocation';
+export * from './StartUpdateLocationPermissionError';
+
+/** clipboard */
+export * from './getClipboardText';
+export * from './GetClipboardTextPermissionError';
+
+export * from './setClipboardText';
+export * from './SetClipboardTextPermissionError';
+
+/** common */
+export * from './nativeModules';
+export * from './permission';

package/src/permissions/nativeModules.ts

@@ -0,0 +1,8 @@
+export type CompatiblePlaceholderArgument = object;
+export type PermissionFunctionName =
+  | 'getClipboardText'
+  | 'setClipboardText'
+  | 'fetchContacts'
+  | 'fetchAlbumPhotos'
+  | 'getCurrentLocation'
+  | 'openCamera';

package/src/permissions/openCamera.ts

@@ -0,0 +1,18 @@
+import { ImageResponse } from './fetchAlbumPhotos';
+
+export interface OpenCameraOptions {
+  /**
+   * 이미지를 Base64 형식으로 반환할지 여부를 나타내는 불리언 값이에요.
+   *
+   * 기본값: `false`.
+   */
+  base64?: boolean;
+  /**
+   * 이미지의 최대 너비를 나타내는 숫자 값이에요.
+   *
+   * 기본값: `1024`.
+   */
+  maxWidth?: number;
+}
+
+export type OpenCamera = (options?: OpenCameraOptions) => Promise<ImageResponse>;

package/src/permissions/permission.ts

@@ -0,0 +1,46 @@
+import { PermissionFunctionName } from './nativeModules';
+
+export type PermissionStatus = 'notDetermined' | 'denied' | 'allowed';
+export type PermissionAccess = 'read' | 'write' | 'access';
+export type PermissionName = 'clipboard' | 'contacts' | 'photos' | 'geolocation' | 'camera';
+
+export interface PermissionErrorConstructorParams {
+  methodName: PermissionFunctionName;
+  message: string;
+}
+
+export interface PermissionErrorType extends Error {
+  name: string;
+  message: string;
+}
+
+export interface CreatePermissionFunctionOptions<T extends (...args: any[]) => any> {
+  handler: T;
+  permission: {
+    name: PermissionName;
+    access: PermissionAccess;
+  };
+  error: new () => PermissionErrorType;
+}
+
+export type RequestPermissionFunction = (permission: {
+  name: PermissionName;
+  access: PermissionAccess;
+}) => Promise<Exclude<PermissionStatus, 'notDetermined'>>;
+
+export type InternalPermissionDialogFunction = (permission: {
+  name: PermissionName;
+  access: PermissionAccess;
+}) => Promise<Exclude<PermissionStatus, 'notDetermined'>>;
+export type InternalGetPermissionFunction = (permission: {
+  name: PermissionName;
+  access: PermissionAccess;
+}) => Promise<PermissionStatus>;
+
+export type PermissionDialogFunction = () => Promise<Exclude<PermissionStatus, 'notDetermined'>>;
+export type GetPermissionFunction = () => Promise<PermissionStatus>;
+
+export type PermissionFunctionWithDialog<T extends (...args: any[]) => any> = T & {
+  getPermission: GetPermissionFunction;
+  openPermissionDialog: PermissionDialogFunction;
+};

package/src/permissions/setClipboardText.ts

@@ -0,0 +1,5 @@
+export interface SetClipboardTextOptions {
+  text: string;
+}
+
+export type SetClipboardText = (text: string) => Promise<void>;

package/src/permissions/startUpdateLocation.ts

@@ -0,0 +1,24 @@
+import { Accuracy, Location } from './getCurrentLocation';
+
+export interface StartUpdateLocationOptions {
+  /**
+   * 위치 정확도를 설정해요.
+   */
+  accuracy: Accuracy;
+  /**
+   * 위치 업데이트 주기를 밀리초(ms) 단위로 설정해요.
+   */
+  timeInterval: number;
+  /**
+   * 위치 변경 거리를 미터(m) 단위로 설정해요.
+   */
+  distanceInterval: number;
+}
+
+export type StartUpdateLocationEventParams = {
+  onEvent: (response: Location) => void;
+  onError: (error: unknown) => void;
+  options: StartUpdateLocationOptions;
+};
+
+export type StartUpdateLocation = (eventParams: StartUpdateLocationEventParams) => () => void;