@apps-in-toss/native-modules 2.5.2 → 2.6.1

package/dist/bridges-meta.json

@@ -95,6 +95,14 @@
     "identifier": "saveBase64Data",
     "dts": "export interface SaveBase64DataParams {\n\tdata: string;\n\tfileName: string;\n\tmimeType: string;\n}\n/**\n * @public\n * @category 데이터\n * @name saveBase64Data\n * @description 문자열로 인코딩된 Base64 데이터를 지정한 파일 이름과 MIME 타입으로 사용자 기기에 저장해요. 이미지, 텍스트, PDF 등 다양한 형식의 데이터를 저장할 수 있어요.\n * @param {SaveBase64DataParams} params - 저장할 데이터와 파일 정보를 담은 객체예요.\n * @param {string} params.data - Base64 형식으로 인코딩된 데이터 문자열이에요.\n * @param {string} params.fileName - 저장할 파일 이름이에요. 확장자도 같이 붙여줘야해요. 예를 들어, 'example.png'로 저장할 수 있어요.\n * @param {string} params.mimeType - 저장할 파일의 MIME 타입이에요. 예를 들어 'image/png' 로 지정하면 이미지, 'application/pdf'는 PDF 파일이에요. 자세한 내용은 [MIME 문서](https://developer.mozilla.org/ko/docs/Web/HTTP/Guides/MIME_types)를 참고해주세요.\n *\n * @example\n * ### Base64 이미지 데이터를 사용자 기기에 저장하기\n *\n * ```tsx\n * import { Button } from 'react-native';\n * import { saveBase64Data } from '@apps-in-toss/framework';\n *\n * // '저장' 버튼을 누르면 이미지가 사용자 기기에 저장돼요.\n * function SaveButton() {\n *   const handleSave = async () => {\n *     try {\n *       await saveBase64Data({\n *         data: 'iVBORw0KGgo...',\n *         fileName: 'some-photo.png',\n *         mimeType: 'image/png',\n *       });\n *     } catch (error) {\n *       console.error('데이터 저장에 실패했어요:', error);\n *     }\n *   };\n *\n *   return <Button title=\"저장\" onPress={handleSave} />;\n * }\n * ```\n */\nexport declare function saveBase64Data(params: SaveBase64DataParams): Promise<void>;\n\nexport {};\n"
   },
+  {
+    "identifier": "openPDFViewer",
+    "dts": "/**\n * @public\n * @category PDF\n * @name OpenPDFViewerParams\n * @description PDF 뷰어를 열 때 필요한 파라미터예요.\n * @property {string} data - Base64 형식으로 인코딩된 PDF 데이터 문자열이에요.\n * @property {string} [filename] - PDF 파일 이름이에요.\n */\nexport interface OpenPDFViewerParams {\n\tdata: string;\n\tfilename?: string;\n}\n/**\n * @public\n * @category PDF\n * @name OpenPDFViewerResult\n * @description PDF 뷰어가 닫혔을 때 반환되는 결과예요.\n */\nexport type OpenPDFViewerResult = \"CLOSE\";\n/**\n * @public\n * @category PDF\n * @name openPDFViewer\n * @description Base64로 인코딩된 PDF 데이터를 네이티브 PDF 뷰어로 열어요. 사용자가 뷰어를 닫으면 `'CLOSE'`를 반환해요.\n *\n * @param {OpenPDFViewerParams} params - PDF 데이터와 파일 이름을 담은 객체예요.\n * @returns {Promise<OpenPDFViewerResult>} PDF 뷰어가 닫히면 `'CLOSE'`를 반환해요.\n *\n * @throws\n * - {code: `INVALID_REQUEST`}: 요청 파라미터가 올바르지 않을 때\n * - {code: `INVALID_DATA`}: PDF 데이터가 유효하지 않을 때\n * - {code: `PDF_VIEWER_ERROR`}: PDF 뷰어를 여는 과정에서 오류가 발생했을 때\n * - {code: `UNSUPPORTED_APP_VERSION`}: 토스앱 버전이 5.261.0보다 낮을 때\n *\n * @example\n * ```tsx\n * import { openPDFViewer } from '@apps-in-toss/framework';\n *\n * async function showPdf() {\n *   try {\n *     const result = await openPDFViewer({\n *       data: 'JVBERi0xLjQK...',\n *       filename: 'document.pdf',\n *     });\n *\n *     if (result === 'CLOSE') {\n *       console.log('PDF 뷰어가 닫혔어요.');\n *     }\n *   } catch (error) {\n *       console.error('PDF 뷰어 오류:', error);\n *   }\n * }\n * ```\n */\nexport declare function openPDFViewer(params: OpenPDFViewerParams): Promise<OpenPDFViewerResult>;\n\nexport {};\n"
+  },
+  {
+    "identifier": "fetchAlbumItems",
+    "dts": "/**\n * @public\n * @category 앨범\n * @name AlbumItemType\n * @description 앨범에서 가져올 미디어 유형이에요.\n */\nexport type AlbumItemType = \"PHOTO\" | \"VIDEO\";\n/**\n * @public\n * @category 앨범\n * @name FetchAlbumItemsOptions\n * @description 앨범에서 사진·동영상을 선택할 때 사용하는 옵션이에요.\n * @property {Array<\"PHOTO\" | \"VIDEO\">} [types] - 가져올 미디어 유형 목록이에요. 지정하지 않으면 사진만 가져와요.\n * @property {number} [maxCount] - 가져올 항목의 최대 개수예요. 기본값은 10이에요.\n * @property {number} [maxWidth] - 이미지의 최대 폭이에요. 단위는 픽셀이에요. 기본값은 1024이에요.\n * @property {boolean} [base64] - 이미지의 `dataUri`를 Base64 문자열로 반환할지 여부예요. 기본값은 `false`이에요.\n */\nexport interface FetchAlbumItemsOptions {\n\ttypes?: AlbumItemType[];\n\tmaxCount?: number;\n\tmaxWidth?: number;\n\tbase64?: boolean;\n}\n/**\n * @public\n * @category 앨범\n * @name AlbumItemResponse\n * @description 앨범에서 선택한 미디어 항목이에요.\n * @property {string} id - 항목의 고유 ID예요.\n * @property {string} dataUri - 미디어 데이터 URI예요. `type`이 `PHOTO`면서 `base64` 옵션이 `true`이면 Base64 문자열로 반환돼요.\n * @property {\"PHOTO\" | \"VIDEO\"} type - 미디어 유형이에요.\n */\nexport interface AlbumItemResponse {\n\tid: string;\n\tdataUri: string;\n\ttype: AlbumItemType;\n}\n/**\n * @public\n * @category 앨범\n * @name fetchAlbumItems\n * @description 사용자 앨범에서 사진·동영상을 선택해 가져와요. 사용자가 선택을 취소하면 빈 배열 `[]`을 반환해요.\n *\n * @param {FetchAlbumItemsOptions} [options] - 조회 옵션을 담은 객체예요.\n * @returns {Promise<AlbumItemResponse[]>} 선택한 미디어 목록을 반환해요. 취소 시 빈 배열을 반환해요.\n *\n * @throws 다음 에러 코드가 발생할 수 있어요.\n * - {code: `NOT_ALLOWED`}: 앨범 접근이 허용되지 않았을 때\n * - {code: `INVALID_REQUEST`}: 요청 파라미터가 올바르지 않을 때\n * - {code: `INVALID_DATA`}: 미디어 데이터가 유효하지 않을 때\n * - {code: `UNSUPPORTED_APP_VERSION`}: 토스앱 버전이 5.261.0보다 낮을 때\n *\n * @example\n * ```tsx\n * import { fetchAlbumItems, FetchAlbumItemsError } from '@apps-in-toss/framework';\n *\n * async function pickMedia() {\n *   try {\n *     const items = await fetchAlbumItems({\n *       types: ['PHOTO', 'VIDEO'],\n *       maxCount: 5,\n *       base64: true,\n *     });\n *\n *     if (items.length === 0) {\n *       console.log('선택이 취소되었어요.');\n *       return;\n *     }\n *\n *     items.forEach((item) => {\n *       console.log(item.type, item.id);\n *     });\n *   } catch (error) {\n *       console.error('앨범 조회 오류:', error.code);\n *   }\n * }\n * ```\n */\nexport declare function fetchAlbumItems(options?: FetchAlbumItemsOptions): Promise<AlbumItemResponse[]>;\n\nexport {};\n"
+  },
   {
     "identifier": "appsInTossSignTossCert",
     "dts": "export interface AppsInTossSignTossCertParams {\n\ttxId: string;\n}\n/**\n * @public\n * @category 토스인증\n * @name appsInTossSignTossCert\n * @description 토스 인증서를 사용해 서명하는 기능을 제공해요. 이 함수를 사용하면 앱인토스에서 제공하는 인증서를 활용해 서명을 할 수 있어요.\n *\n * @param {AppsInTossSignTossCertParams} params - 서명에 필요한 파라미터를 포함하는 객체예요.\n * @param {string} params.txId - 토스인증서를 사용한 본인확인이나 간편인증, 전자서명에서 사용하는 Transaction Id예요.\n *\n * @example\n * ```tsx\n * import { appsInTossSignTossCert } from '@apps-in-toss/framework';\n *\n *  // 서명에 필요한 파라미터를 정의해요.\n *  const params = {\n *    txId: \"f2e1a6df...\"\n *  };\n *\n * appsInTossSignTossCert(params)\n *   .then(() => {\n *     console.log('서명 작업이 성공적으로 완료되었어요.');\n *   })\n *   .catch((error) => {\n *     console.error('서명 작업 중 에러가 발생했어요:', error);\n *   });\n * ```\n */\nexport declare function appsInTossSignTossCert(params: AppsInTossSignTossCertParams): Promise<void>;\n\nexport {};\n"

package/dist/index.cjs

@@ -34,6 +34,7 @@ __export(index_exports, {
   closeView: () => closeView,
   contactsViral: () => contactsViral,
   eventLog: () => eventLog,
+  fetchAlbumItems: () => fetchAlbumItems,
   fetchAlbumPhotos: () => fetchAlbumPhotos,
   fetchContacts: () => fetchContacts,
   generateHapticFeedback: () => generateHapticFeedback,
@@ -60,6 +61,7 @@ __export(index_exports, {
   onVisibilityChangedByTransparentServiceWeb: () => onVisibilityChangedByTransparentServiceWeb,
   openCamera: () => openCamera,
   openGameCenterLeaderboard: () => openGameCenterLeaderboard,
+  openPDFViewer: () => openPDFViewer,
   openURL: () => openURL2,
   processProductGrant: () => processProductGrant,
   requestNotificationAgreement: () => requestNotificationAgreement,
@@ -862,6 +864,34 @@ async function saveBase64Data(params) {
   await safePostMessage("saveBase64Data", params);
 }
 
+// src/MiniAppModule/native-modules/openPDFViewer.ts
+async function openPDFViewer(params) {
+  const isSupported = isMinVersionSupported({
+    android: "5.261.0",
+    ios: "5.261.0"
+  });
+  if (!isSupported) {
+    const error = new Error("\uD1A0\uC2A4\uC571 5.261.0 \uBC84\uC804 \uC774\uC0C1\uC774 \uD544\uC694\uD574\uC694.");
+    error.code = "UNSUPPORTED_APP_VERSION";
+    throw error;
+  }
+  return safePostMessage("openPDFViewer", params);
+}
+
+// src/MiniAppModule/native-modules/fetchAlbumItems.ts
+async function fetchAlbumItems(options) {
+  const isSupported = isMinVersionSupported({
+    android: "5.261.0",
+    ios: "5.261.0"
+  });
+  if (!isSupported) {
+    const error = new Error("\uD1A0\uC2A4\uC571 5.261.0 \uBC84\uC804 \uC774\uC0C1\uC774 \uD544\uC694\uD574\uC694.");
+    error.code = "UNSUPPORTED_APP_VERSION";
+    throw error;
+  }
+  return safePostMessage("fetchAlbumItems", options ?? {});
+}
+
 // src/MiniAppModule/native-modules/setDeviceOrientation.ts
 async function setDeviceOrientation(options) {
   const isSupported = isMinVersionSupported({
@@ -1241,6 +1271,7 @@ var INTERNAL__module = {
   closeView,
   contactsViral,
   eventLog,
+  fetchAlbumItems,
   fetchAlbumPhotos,
   fetchContacts,
   generateHapticFeedback,
@@ -1267,6 +1298,7 @@ var INTERNAL__module = {
   onVisibilityChangedByTransparentServiceWeb,
   openCamera,
   openGameCenterLeaderboard,
+  openPDFViewer,
   openURL,
   processProductGrant,
   requestNotificationAgreement,

package/dist/index.d.cts

@@ -112,6 +112,86 @@ declare function checkoutPayment(options: {
     params: CheckoutPaymentOptions;
 }): Promise<CheckoutPaymentResult>;
 
+/**
+ * @public
+ * @category 앨범
+ * @name AlbumItemType
+ * @description 앨범에서 가져올 미디어 유형이에요.
+ */
+type AlbumItemType = 'PHOTO' | 'VIDEO';
+/**
+ * @public
+ * @category 앨범
+ * @name FetchAlbumItemsOptions
+ * @description 앨범에서 사진·동영상을 선택할 때 사용하는 옵션이에요.
+ * @property {Array<"PHOTO" | "VIDEO">} [types] - 가져올 미디어 유형 목록이에요. 지정하지 않으면 사진만 가져와요.
+ * @property {number} [maxCount] - 가져올 항목의 최대 개수예요. 기본값은 10이에요.
+ * @property {number} [maxWidth] - 이미지의 최대 폭이에요. 단위는 픽셀이에요. 기본값은 1024이에요.
+ * @property {boolean} [base64] - 이미지의 `dataUri`를 Base64 문자열로 반환할지 여부예요. 기본값은 `false`이에요.
+ */
+interface FetchAlbumItemsOptions {
+    types?: AlbumItemType[];
+    maxCount?: number;
+    maxWidth?: number;
+    base64?: boolean;
+}
+/**
+ * @public
+ * @category 앨범
+ * @name AlbumItemResponse
+ * @description 앨범에서 선택한 미디어 항목이에요.
+ * @property {string} id - 항목의 고유 ID예요.
+ * @property {string} dataUri - 미디어 데이터 URI예요. `type`이 `PHOTO`면서 `base64` 옵션이 `true`이면 Base64 문자열로 반환돼요.
+ * @property {"PHOTO" | "VIDEO"} type - 미디어 유형이에요.
+ */
+interface AlbumItemResponse {
+    id: string;
+    dataUri: string;
+    type: AlbumItemType;
+}
+/**
+ * @public
+ * @category 앨범
+ * @name fetchAlbumItems
+ * @description 사용자 앨범에서 사진·동영상을 선택해 가져와요. 사용자가 선택을 취소하면 빈 배열 `[]`을 반환해요.
+ *
+ * @param {FetchAlbumItemsOptions} [options] - 조회 옵션을 담은 객체예요.
+ * @returns {Promise<AlbumItemResponse[]>} 선택한 미디어 목록을 반환해요. 취소 시 빈 배열을 반환해요.
+ *
+ * @throws 다음 에러 코드가 발생할 수 있어요.
+ * - {code: `NOT_ALLOWED`}: 앨범 접근이 허용되지 않았을 때
+ * - {code: `INVALID_REQUEST`}: 요청 파라미터가 올바르지 않을 때
+ * - {code: `INVALID_DATA`}: 미디어 데이터가 유효하지 않을 때
+ * - {code: `UNSUPPORTED_APP_VERSION`}: 토스앱 버전이 5.261.0보다 낮을 때
+ *
+ * @example
+ * ```tsx
+ * import { fetchAlbumItems, FetchAlbumItemsError } from '@apps-in-toss/framework';
+ *
+ * async function pickMedia() {
+ *   try {
+ *     const items = await fetchAlbumItems({
+ *       types: ['PHOTO', 'VIDEO'],
+ *       maxCount: 5,
+ *       base64: true,
+ *     });
+ *
+ *     if (items.length === 0) {
+ *       console.log('선택이 취소되었어요.');
+ *       return;
+ *     }
+ *
+ *     items.forEach((item) => {
+ *       console.log(item.type, item.id);
+ *     });
+ *   } catch (error) {
+ *       console.error('앨범 조회 오류:', error.code);
+ *   }
+ * }
+ * ```
+ */
+declare function fetchAlbumItems(options?: FetchAlbumItemsOptions): Promise<AlbumItemResponse[]>;
+
 interface GetAnonymousKeySuccessResponse {
     hash: string;
     type: 'HASH';
@@ -902,6 +982,62 @@ declare const IAP: {
     getSubscriptionInfo: typeof getSubscriptionInfo;
 };
 
+/**
+ * @public
+ * @category PDF
+ * @name OpenPDFViewerParams
+ * @description PDF 뷰어를 열 때 필요한 파라미터예요.
+ * @property {string} data - Base64 형식으로 인코딩된 PDF 데이터 문자열이에요.
+ * @property {string} [filename] - PDF 파일 이름이에요.
+ */
+interface OpenPDFViewerParams {
+    data: string;
+    filename?: string;
+}
+/**
+ * @public
+ * @category PDF
+ * @name OpenPDFViewerResult
+ * @description PDF 뷰어가 닫혔을 때 반환되는 결과예요.
+ */
+type OpenPDFViewerResult = 'CLOSE';
+/**
+ * @public
+ * @category PDF
+ * @name openPDFViewer
+ * @description Base64로 인코딩된 PDF 데이터를 네이티브 PDF 뷰어로 열어요. 사용자가 뷰어를 닫으면 `'CLOSE'`를 반환해요.
+ *
+ * @param {OpenPDFViewerParams} params - PDF 데이터와 파일 이름을 담은 객체예요.
+ * @returns {Promise<OpenPDFViewerResult>} PDF 뷰어가 닫히면 `'CLOSE'`를 반환해요.
+ *
+ * @throws
+ * - {code: `INVALID_REQUEST`}: 요청 파라미터가 올바르지 않을 때
+ * - {code: `INVALID_DATA`}: PDF 데이터가 유효하지 않을 때
+ * - {code: `PDF_VIEWER_ERROR`}: PDF 뷰어를 여는 과정에서 오류가 발생했을 때
+ * - {code: `UNSUPPORTED_APP_VERSION`}: 토스앱 버전이 5.261.0보다 낮을 때
+ *
+ * @example
+ * ```tsx
+ * import { openPDFViewer } from '@apps-in-toss/framework';
+ *
+ * async function showPdf() {
+ *   try {
+ *     const result = await openPDFViewer({
+ *       data: 'JVBERi0xLjQK...',
+ *       filename: 'document.pdf',
+ *     });
+ *
+ *     if (result === 'CLOSE') {
+ *       console.log('PDF 뷰어가 닫혔어요.');
+ *     }
+ *   } catch (error) {
+ *       console.error('PDF 뷰어 오류:', error);
+ *   }
+ * }
+ * ```
+ */
+declare function openPDFViewer(params: OpenPDFViewerParams): Promise<OpenPDFViewerResult>;
+
 /**
  * @public
  * @category 알림
@@ -1178,6 +1314,7 @@ interface AsyncMethodsMap {
         maxCount?: number;
         maxWidth?: number;
     }) => Promise<ImageResponse[]>;
+    fetchAlbumItems: (params: FetchAlbumItemsOptions) => Promise<AlbumItemResponse[]>;
     openCamera: (params: {
         base64?: boolean;
         maxWidth?: number;
@@ -1237,6 +1374,7 @@ interface AsyncMethodsMap {
         type: 'portrait' | 'landscape';
     }) => Promise<void>;
     saveBase64Data: (params: SaveBase64DataParams) => Promise<void>;
+    openPDFViewer: (params: OpenPDFViewerParams) => Promise<OpenPDFViewerResult>;
     appsInTossSignTossCert: (params: AppsInTossSignTossCertParams) => Promise<void>;
     getGameCenterGameProfile: (params: CompatiblePlaceholderArgument) => Promise<GameCenterGameProfileResponse | undefined>;
     getUserKeyForGame: (params: CompatiblePlaceholderArgument) => Promise<GetUserKeyForGameResponse | undefined>;
@@ -3450,4 +3588,4 @@ declare const INTERNAL__module: {
     tossCoreEventLog: typeof tossCoreEventLog;
 };
 
-export { type AppsInTossSignTossCertParams, type CheckoutPaymentOptions, type CheckoutPaymentResult, type CompletedOrRefundedOrdersResult, type ConsumableProductListItem, type ContactsViralParams, type CreateSubscriptionPurchaseOrderOptions, type EventLogParams, type GameCenterGameProfileResponse, type GetAnonymousKeyResponse, type GetAnonymousKeySuccessResponse, type GetUserKeyForGameErrorResponse, type GetUserKeyForGameResponse, type GetUserKeyForGameSuccessResponse, GoogleAdMob, type GrantPromotionRewardErrorResponse, type GrantPromotionRewardErrorResult, type GrantPromotionRewardForGameErrorResponse, type GrantPromotionRewardForGameErrorResult, type GrantPromotionRewardForGameResponse, type GrantPromotionRewardForGameSuccessResponse, type GrantPromotionRewardResponse, type GrantPromotionRewardSuccessResponse, type HapticFeedbackType, IAP, INTERNAL__appBridgeHandler, INTERNAL__module, type IapCreateOneTimePurchaseOrderOptions, type IapCreateOneTimePurchaseOrderResult, type IapCreateSubscriptionPurchaseOrderResult, type IapProductListItem, type IapSubscriptionInfoResult, type NetworkStatus, type NonConsumableProductListItem, type NotificationAgreementResult, type Primitive, type RequestNotificationAgreementOptions, type RequestTossPayPaysBillingOptions, type RequestTossPayPaysBillingResult, type SaveBase64DataParams, Storage, type SubmitGameCenterLeaderBoardScoreResponse, type SubscriptionProductListItem, TossPay, type UpdateLocationEventEmitter, appLogin, appsInTossEvent, appsInTossSignTossCert, checkoutPayment, closeView, contactsViral, eventLog, fetchAlbumPhotos, fetchContacts, generateHapticFeedback, getAnonymousKey, getClipboardText, getCurrentLocation, getDeviceId, getGameCenterGameProfile, getGroupId, getIsTossLoginIntegratedService, getLocale, getNetworkStatus, getOperationalEnvironment, getPlatformOS, getSchemeUri, getServerTime, getTossAppVersion, getTossShareLink, getUserKeyForGame, grantPromotionReward, grantPromotionRewardForGame, iapCreateOneTimePurchaseOrder, isMinVersionSupported, onVisibilityChangedByTransparentServiceWeb, openCamera, openGameCenterLeaderboard, openURL, processProductGrant, requestNotificationAgreement, requestOneTimePurchase, requestReview, requestTossPayPaysBilling, safePostMessage, safeSyncPostMessage, saveBase64Data, setClipboardText, setDeviceOrientation, setIosSwipeGestureEnabled, setScreenAwakeMode, setSecureScreen, share, shareWithScheme, startUpdateLocation, submitGameCenterLeaderBoardScore };
+export { type AlbumItemResponse, type AlbumItemType, type AppsInTossSignTossCertParams, type CheckoutPaymentOptions, type CheckoutPaymentResult, type CompletedOrRefundedOrdersResult, type ConsumableProductListItem, type ContactsViralParams, type CreateSubscriptionPurchaseOrderOptions, type EventLogParams, type FetchAlbumItemsOptions, type GameCenterGameProfileResponse, type GetAnonymousKeyResponse, type GetAnonymousKeySuccessResponse, type GetUserKeyForGameErrorResponse, type GetUserKeyForGameResponse, type GetUserKeyForGameSuccessResponse, GoogleAdMob, type GrantPromotionRewardErrorResponse, type GrantPromotionRewardErrorResult, type GrantPromotionRewardForGameErrorResponse, type GrantPromotionRewardForGameErrorResult, type GrantPromotionRewardForGameResponse, type GrantPromotionRewardForGameSuccessResponse, type GrantPromotionRewardResponse, type GrantPromotionRewardSuccessResponse, type HapticFeedbackType, IAP, INTERNAL__appBridgeHandler, INTERNAL__module, type IapCreateOneTimePurchaseOrderOptions, type IapCreateOneTimePurchaseOrderResult, type IapCreateSubscriptionPurchaseOrderResult, type IapProductListItem, type IapSubscriptionInfoResult, type NetworkStatus, type NonConsumableProductListItem, type NotificationAgreementResult, type OpenPDFViewerParams, type OpenPDFViewerResult, type Primitive, type RequestNotificationAgreementOptions, type RequestTossPayPaysBillingOptions, type RequestTossPayPaysBillingResult, type SaveBase64DataParams, Storage, type SubmitGameCenterLeaderBoardScoreResponse, type SubscriptionProductListItem, TossPay, type UpdateLocationEventEmitter, appLogin, appsInTossEvent, appsInTossSignTossCert, checkoutPayment, closeView, contactsViral, eventLog, fetchAlbumItems, fetchAlbumPhotos, fetchContacts, generateHapticFeedback, getAnonymousKey, getClipboardText, getCurrentLocation, getDeviceId, getGameCenterGameProfile, getGroupId, getIsTossLoginIntegratedService, getLocale, getNetworkStatus, getOperationalEnvironment, getPlatformOS, getSchemeUri, getServerTime, getTossAppVersion, getTossShareLink, getUserKeyForGame, grantPromotionReward, grantPromotionRewardForGame, iapCreateOneTimePurchaseOrder, isMinVersionSupported, onVisibilityChangedByTransparentServiceWeb, openCamera, openGameCenterLeaderboard, openPDFViewer, openURL, processProductGrant, requestNotificationAgreement, requestOneTimePurchase, requestReview, requestTossPayPaysBilling, safePostMessage, safeSyncPostMessage, saveBase64Data, setClipboardText, setDeviceOrientation, setIosSwipeGestureEnabled, setScreenAwakeMode, setSecureScreen, share, shareWithScheme, startUpdateLocation, submitGameCenterLeaderBoardScore };

package/dist/index.d.ts

@@ -112,6 +112,86 @@ declare function checkoutPayment(options: {
     params: CheckoutPaymentOptions;
 }): Promise<CheckoutPaymentResult>;
 
+/**
+ * @public
+ * @category 앨범
+ * @name AlbumItemType
+ * @description 앨범에서 가져올 미디어 유형이에요.
+ */
+type AlbumItemType = 'PHOTO' | 'VIDEO';
+/**
+ * @public
+ * @category 앨범
+ * @name FetchAlbumItemsOptions
+ * @description 앨범에서 사진·동영상을 선택할 때 사용하는 옵션이에요.
+ * @property {Array<"PHOTO" | "VIDEO">} [types] - 가져올 미디어 유형 목록이에요. 지정하지 않으면 사진만 가져와요.
+ * @property {number} [maxCount] - 가져올 항목의 최대 개수예요. 기본값은 10이에요.
+ * @property {number} [maxWidth] - 이미지의 최대 폭이에요. 단위는 픽셀이에요. 기본값은 1024이에요.
+ * @property {boolean} [base64] - 이미지의 `dataUri`를 Base64 문자열로 반환할지 여부예요. 기본값은 `false`이에요.
+ */
+interface FetchAlbumItemsOptions {
+    types?: AlbumItemType[];
+    maxCount?: number;
+    maxWidth?: number;
+    base64?: boolean;
+}
+/**
+ * @public
+ * @category 앨범
+ * @name AlbumItemResponse
+ * @description 앨범에서 선택한 미디어 항목이에요.
+ * @property {string} id - 항목의 고유 ID예요.
+ * @property {string} dataUri - 미디어 데이터 URI예요. `type`이 `PHOTO`면서 `base64` 옵션이 `true`이면 Base64 문자열로 반환돼요.
+ * @property {"PHOTO" | "VIDEO"} type - 미디어 유형이에요.
+ */
+interface AlbumItemResponse {
+    id: string;
+    dataUri: string;
+    type: AlbumItemType;
+}
+/**
+ * @public
+ * @category 앨범
+ * @name fetchAlbumItems
+ * @description 사용자 앨범에서 사진·동영상을 선택해 가져와요. 사용자가 선택을 취소하면 빈 배열 `[]`을 반환해요.
+ *
+ * @param {FetchAlbumItemsOptions} [options] - 조회 옵션을 담은 객체예요.
+ * @returns {Promise<AlbumItemResponse[]>} 선택한 미디어 목록을 반환해요. 취소 시 빈 배열을 반환해요.
+ *
+ * @throws 다음 에러 코드가 발생할 수 있어요.
+ * - {code: `NOT_ALLOWED`}: 앨범 접근이 허용되지 않았을 때
+ * - {code: `INVALID_REQUEST`}: 요청 파라미터가 올바르지 않을 때
+ * - {code: `INVALID_DATA`}: 미디어 데이터가 유효하지 않을 때
+ * - {code: `UNSUPPORTED_APP_VERSION`}: 토스앱 버전이 5.261.0보다 낮을 때
+ *
+ * @example
+ * ```tsx
+ * import { fetchAlbumItems, FetchAlbumItemsError } from '@apps-in-toss/framework';
+ *
+ * async function pickMedia() {
+ *   try {
+ *     const items = await fetchAlbumItems({
+ *       types: ['PHOTO', 'VIDEO'],
+ *       maxCount: 5,
+ *       base64: true,
+ *     });
+ *
+ *     if (items.length === 0) {
+ *       console.log('선택이 취소되었어요.');
+ *       return;
+ *     }
+ *
+ *     items.forEach((item) => {
+ *       console.log(item.type, item.id);
+ *     });
+ *   } catch (error) {
+ *       console.error('앨범 조회 오류:', error.code);
+ *   }
+ * }
+ * ```
+ */
+declare function fetchAlbumItems(options?: FetchAlbumItemsOptions): Promise<AlbumItemResponse[]>;
+
 interface GetAnonymousKeySuccessResponse {
     hash: string;
     type: 'HASH';
@@ -902,6 +982,62 @@ declare const IAP: {
     getSubscriptionInfo: typeof getSubscriptionInfo;
 };
 
+/**
+ * @public
+ * @category PDF
+ * @name OpenPDFViewerParams
+ * @description PDF 뷰어를 열 때 필요한 파라미터예요.
+ * @property {string} data - Base64 형식으로 인코딩된 PDF 데이터 문자열이에요.
+ * @property {string} [filename] - PDF 파일 이름이에요.
+ */
+interface OpenPDFViewerParams {
+    data: string;
+    filename?: string;
+}
+/**
+ * @public
+ * @category PDF
+ * @name OpenPDFViewerResult
+ * @description PDF 뷰어가 닫혔을 때 반환되는 결과예요.
+ */
+type OpenPDFViewerResult = 'CLOSE';
+/**
+ * @public
+ * @category PDF
+ * @name openPDFViewer
+ * @description Base64로 인코딩된 PDF 데이터를 네이티브 PDF 뷰어로 열어요. 사용자가 뷰어를 닫으면 `'CLOSE'`를 반환해요.
+ *
+ * @param {OpenPDFViewerParams} params - PDF 데이터와 파일 이름을 담은 객체예요.
+ * @returns {Promise<OpenPDFViewerResult>} PDF 뷰어가 닫히면 `'CLOSE'`를 반환해요.
+ *
+ * @throws
+ * - {code: `INVALID_REQUEST`}: 요청 파라미터가 올바르지 않을 때
+ * - {code: `INVALID_DATA`}: PDF 데이터가 유효하지 않을 때
+ * - {code: `PDF_VIEWER_ERROR`}: PDF 뷰어를 여는 과정에서 오류가 발생했을 때
+ * - {code: `UNSUPPORTED_APP_VERSION`}: 토스앱 버전이 5.261.0보다 낮을 때
+ *
+ * @example
+ * ```tsx
+ * import { openPDFViewer } from '@apps-in-toss/framework';
+ *
+ * async function showPdf() {
+ *   try {
+ *     const result = await openPDFViewer({
+ *       data: 'JVBERi0xLjQK...',
+ *       filename: 'document.pdf',
+ *     });
+ *
+ *     if (result === 'CLOSE') {
+ *       console.log('PDF 뷰어가 닫혔어요.');
+ *     }
+ *   } catch (error) {
+ *       console.error('PDF 뷰어 오류:', error);
+ *   }
+ * }
+ * ```
+ */
+declare function openPDFViewer(params: OpenPDFViewerParams): Promise<OpenPDFViewerResult>;
+
 /**
  * @public
  * @category 알림
@@ -1178,6 +1314,7 @@ interface AsyncMethodsMap {
         maxCount?: number;
         maxWidth?: number;
     }) => Promise<ImageResponse[]>;
+    fetchAlbumItems: (params: FetchAlbumItemsOptions) => Promise<AlbumItemResponse[]>;
     openCamera: (params: {
         base64?: boolean;
         maxWidth?: number;
@@ -1237,6 +1374,7 @@ interface AsyncMethodsMap {
         type: 'portrait' | 'landscape';
     }) => Promise<void>;
     saveBase64Data: (params: SaveBase64DataParams) => Promise<void>;
+    openPDFViewer: (params: OpenPDFViewerParams) => Promise<OpenPDFViewerResult>;
     appsInTossSignTossCert: (params: AppsInTossSignTossCertParams) => Promise<void>;
     getGameCenterGameProfile: (params: CompatiblePlaceholderArgument) => Promise<GameCenterGameProfileResponse | undefined>;
     getUserKeyForGame: (params: CompatiblePlaceholderArgument) => Promise<GetUserKeyForGameResponse | undefined>;
@@ -3450,4 +3588,4 @@ declare const INTERNAL__module: {
     tossCoreEventLog: typeof tossCoreEventLog;
 };
 
-export { type AppsInTossSignTossCertParams, type CheckoutPaymentOptions, type CheckoutPaymentResult, type CompletedOrRefundedOrdersResult, type ConsumableProductListItem, type ContactsViralParams, type CreateSubscriptionPurchaseOrderOptions, type EventLogParams, type GameCenterGameProfileResponse, type GetAnonymousKeyResponse, type GetAnonymousKeySuccessResponse, type GetUserKeyForGameErrorResponse, type GetUserKeyForGameResponse, type GetUserKeyForGameSuccessResponse, GoogleAdMob, type GrantPromotionRewardErrorResponse, type GrantPromotionRewardErrorResult, type GrantPromotionRewardForGameErrorResponse, type GrantPromotionRewardForGameErrorResult, type GrantPromotionRewardForGameResponse, type GrantPromotionRewardForGameSuccessResponse, type GrantPromotionRewardResponse, type GrantPromotionRewardSuccessResponse, type HapticFeedbackType, IAP, INTERNAL__appBridgeHandler, INTERNAL__module, type IapCreateOneTimePurchaseOrderOptions, type IapCreateOneTimePurchaseOrderResult, type IapCreateSubscriptionPurchaseOrderResult, type IapProductListItem, type IapSubscriptionInfoResult, type NetworkStatus, type NonConsumableProductListItem, type NotificationAgreementResult, type Primitive, type RequestNotificationAgreementOptions, type RequestTossPayPaysBillingOptions, type RequestTossPayPaysBillingResult, type SaveBase64DataParams, Storage, type SubmitGameCenterLeaderBoardScoreResponse, type SubscriptionProductListItem, TossPay, type UpdateLocationEventEmitter, appLogin, appsInTossEvent, appsInTossSignTossCert, checkoutPayment, closeView, contactsViral, eventLog, fetchAlbumPhotos, fetchContacts, generateHapticFeedback, getAnonymousKey, getClipboardText, getCurrentLocation, getDeviceId, getGameCenterGameProfile, getGroupId, getIsTossLoginIntegratedService, getLocale, getNetworkStatus, getOperationalEnvironment, getPlatformOS, getSchemeUri, getServerTime, getTossAppVersion, getTossShareLink, getUserKeyForGame, grantPromotionReward, grantPromotionRewardForGame, iapCreateOneTimePurchaseOrder, isMinVersionSupported, onVisibilityChangedByTransparentServiceWeb, openCamera, openGameCenterLeaderboard, openURL, processProductGrant, requestNotificationAgreement, requestOneTimePurchase, requestReview, requestTossPayPaysBilling, safePostMessage, safeSyncPostMessage, saveBase64Data, setClipboardText, setDeviceOrientation, setIosSwipeGestureEnabled, setScreenAwakeMode, setSecureScreen, share, shareWithScheme, startUpdateLocation, submitGameCenterLeaderBoardScore };
+export { type AlbumItemResponse, type AlbumItemType, type AppsInTossSignTossCertParams, type CheckoutPaymentOptions, type CheckoutPaymentResult, type CompletedOrRefundedOrdersResult, type ConsumableProductListItem, type ContactsViralParams, type CreateSubscriptionPurchaseOrderOptions, type EventLogParams, type FetchAlbumItemsOptions, type GameCenterGameProfileResponse, type GetAnonymousKeyResponse, type GetAnonymousKeySuccessResponse, type GetUserKeyForGameErrorResponse, type GetUserKeyForGameResponse, type GetUserKeyForGameSuccessResponse, GoogleAdMob, type GrantPromotionRewardErrorResponse, type GrantPromotionRewardErrorResult, type GrantPromotionRewardForGameErrorResponse, type GrantPromotionRewardForGameErrorResult, type GrantPromotionRewardForGameResponse, type GrantPromotionRewardForGameSuccessResponse, type GrantPromotionRewardResponse, type GrantPromotionRewardSuccessResponse, type HapticFeedbackType, IAP, INTERNAL__appBridgeHandler, INTERNAL__module, type IapCreateOneTimePurchaseOrderOptions, type IapCreateOneTimePurchaseOrderResult, type IapCreateSubscriptionPurchaseOrderResult, type IapProductListItem, type IapSubscriptionInfoResult, type NetworkStatus, type NonConsumableProductListItem, type NotificationAgreementResult, type OpenPDFViewerParams, type OpenPDFViewerResult, type Primitive, type RequestNotificationAgreementOptions, type RequestTossPayPaysBillingOptions, type RequestTossPayPaysBillingResult, type SaveBase64DataParams, Storage, type SubmitGameCenterLeaderBoardScoreResponse, type SubscriptionProductListItem, TossPay, type UpdateLocationEventEmitter, appLogin, appsInTossEvent, appsInTossSignTossCert, checkoutPayment, closeView, contactsViral, eventLog, fetchAlbumItems, fetchAlbumPhotos, fetchContacts, generateHapticFeedback, getAnonymousKey, getClipboardText, getCurrentLocation, getDeviceId, getGameCenterGameProfile, getGroupId, getIsTossLoginIntegratedService, getLocale, getNetworkStatus, getOperationalEnvironment, getPlatformOS, getSchemeUri, getServerTime, getTossAppVersion, getTossShareLink, getUserKeyForGame, grantPromotionReward, grantPromotionRewardForGame, iapCreateOneTimePurchaseOrder, isMinVersionSupported, onVisibilityChangedByTransparentServiceWeb, openCamera, openGameCenterLeaderboard, openPDFViewer, openURL, processProductGrant, requestNotificationAgreement, requestOneTimePurchase, requestReview, requestTossPayPaysBilling, safePostMessage, safeSyncPostMessage, saveBase64Data, setClipboardText, setDeviceOrientation, setIosSwipeGestureEnabled, setScreenAwakeMode, setSecureScreen, share, shareWithScheme, startUpdateLocation, submitGameCenterLeaderBoardScore };

package/dist/index.js

@@ -779,6 +779,34 @@ async function saveBase64Data(params) {
   await safePostMessage("saveBase64Data", params);
 }
 
+// src/MiniAppModule/native-modules/openPDFViewer.ts
+async function openPDFViewer(params) {
+  const isSupported = isMinVersionSupported({
+    android: "5.261.0",
+    ios: "5.261.0"
+  });
+  if (!isSupported) {
+    const error = new Error("\uD1A0\uC2A4\uC571 5.261.0 \uBC84\uC804 \uC774\uC0C1\uC774 \uD544\uC694\uD574\uC694.");
+    error.code = "UNSUPPORTED_APP_VERSION";
+    throw error;
+  }
+  return safePostMessage("openPDFViewer", params);
+}
+
+// src/MiniAppModule/native-modules/fetchAlbumItems.ts
+async function fetchAlbumItems(options) {
+  const isSupported = isMinVersionSupported({
+    android: "5.261.0",
+    ios: "5.261.0"
+  });
+  if (!isSupported) {
+    const error = new Error("\uD1A0\uC2A4\uC571 5.261.0 \uBC84\uC804 \uC774\uC0C1\uC774 \uD544\uC694\uD574\uC694.");
+    error.code = "UNSUPPORTED_APP_VERSION";
+    throw error;
+  }
+  return safePostMessage("fetchAlbumItems", options ?? {});
+}
+
 // src/MiniAppModule/native-modules/setDeviceOrientation.ts
 async function setDeviceOrientation(options) {
   const isSupported = isMinVersionSupported({
@@ -1157,6 +1185,7 @@ export {
   closeView,
   contactsViral,
   eventLog,
+  fetchAlbumItems,
   fetchAlbumPhotos,
   fetchContacts,
   generateHapticFeedback,
@@ -1183,6 +1212,7 @@ export {
   onVisibilityChangedByTransparentServiceWeb,
   openCamera,
   openGameCenterLeaderboard,
+  openPDFViewer,
   openURL2 as openURL,
   processProductGrant,
   requestNotificationAgreement,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@apps-in-toss/native-modules",
   "type": "module",
-  "version": "2.5.2",
+  "version": "2.6.1",
   "description": "Native Modules for Apps In Toss",
   "scripts": {
     "typecheck": "tsc --noEmit",
@@ -42,7 +42,7 @@
     "vitest": "^3.2.4"
   },
   "dependencies": {
-    "@apps-in-toss/types": "2.5.2",
+    "@apps-in-toss/types": "2.6.1",
     "brick-module": "0.5.2",
     "es-toolkit": "^1.39.3"
   },

package/src/MiniAppModule/native-modules/fetchAlbumItems.ts

@@ -0,0 +1,98 @@
+import { isMinVersionSupported } from './isMinVersionSupported';
+import { safePostMessage } from '../../natives';
+
+/**
+ * @public
+ * @category 앨범
+ * @name AlbumItemType
+ * @description 앨범에서 가져올 미디어 유형이에요.
+ */
+export type AlbumItemType = 'PHOTO' | 'VIDEO';
+
+/**
+ * @public
+ * @category 앨범
+ * @name FetchAlbumItemsOptions
+ * @description 앨범에서 사진·동영상을 선택할 때 사용하는 옵션이에요.
+ * @property {Array<"PHOTO" | "VIDEO">} [types] - 가져올 미디어 유형 목록이에요. 지정하지 않으면 사진만 가져와요.
+ * @property {number} [maxCount] - 가져올 항목의 최대 개수예요. 기본값은 10이에요.
+ * @property {number} [maxWidth] - 이미지의 최대 폭이에요. 단위는 픽셀이에요. 기본값은 1024이에요.
+ * @property {boolean} [base64] - 이미지의 `dataUri`를 Base64 문자열로 반환할지 여부예요. 기본값은 `false`이에요.
+ */
+export interface FetchAlbumItemsOptions {
+  types?: AlbumItemType[];
+  maxCount?: number;
+  maxWidth?: number;
+  base64?: boolean;
+}
+
+/**
+ * @public
+ * @category 앨범
+ * @name AlbumItemResponse
+ * @description 앨범에서 선택한 미디어 항목이에요.
+ * @property {string} id - 항목의 고유 ID예요.
+ * @property {string} dataUri - 미디어 데이터 URI예요. `type`이 `PHOTO`면서 `base64` 옵션이 `true`이면 Base64 문자열로 반환돼요.
+ * @property {"PHOTO" | "VIDEO"} type - 미디어 유형이에요.
+ */
+export interface AlbumItemResponse {
+  id: string;
+  dataUri: string;
+  type: AlbumItemType;
+}
+
+/**
+ * @public
+ * @category 앨범
+ * @name fetchAlbumItems
+ * @description 사용자 앨범에서 사진·동영상을 선택해 가져와요. 사용자가 선택을 취소하면 빈 배열 `[]`을 반환해요.
+ *
+ * @param {FetchAlbumItemsOptions} [options] - 조회 옵션을 담은 객체예요.
+ * @returns {Promise<AlbumItemResponse[]>} 선택한 미디어 목록을 반환해요. 취소 시 빈 배열을 반환해요.
+ *
+ * @throws 다음 에러 코드가 발생할 수 있어요.
+ * - {code: `NOT_ALLOWED`}: 앨범 접근이 허용되지 않았을 때
+ * - {code: `INVALID_REQUEST`}: 요청 파라미터가 올바르지 않을 때
+ * - {code: `INVALID_DATA`}: 미디어 데이터가 유효하지 않을 때
+ * - {code: `UNSUPPORTED_APP_VERSION`}: 토스앱 버전이 5.261.0보다 낮을 때
+ *
+ * @example
+ * ```tsx
+ * import { fetchAlbumItems, FetchAlbumItemsError } from '@apps-in-toss/framework';
+ *
+ * async function pickMedia() {
+ *   try {
+ *     const items = await fetchAlbumItems({
+ *       types: ['PHOTO', 'VIDEO'],
+ *       maxCount: 5,
+ *       base64: true,
+ *     });
+ *
+ *     if (items.length === 0) {
+ *       console.log('선택이 취소되었어요.');
+ *       return;
+ *     }
+ *
+ *     items.forEach((item) => {
+ *       console.log(item.type, item.id);
+ *     });
+ *   } catch (error) {
+ *       console.error('앨범 조회 오류:', error.code);
+ *   }
+ * }
+ * ```
+ */
+export async function fetchAlbumItems(options?: FetchAlbumItemsOptions): Promise<AlbumItemResponse[]> {
+  const isSupported = isMinVersionSupported({
+    android: '5.261.0',
+    ios: '5.261.0',
+  });
+
+  if (!isSupported) {
+    const error = new Error('토스앱 5.261.0 버전 이상이 필요해요.');
+    (error as any).code = 'UNSUPPORTED_APP_VERSION';
+    throw error;
+  }
+
+  return safePostMessage('fetchAlbumItems', options ?? {});
+}

package/src/MiniAppModule/native-modules/index.ts

@@ -37,6 +37,8 @@ export * from './getTossShareLink';
 export * from './iap';
 export * from './isMinVersionSupported';
 export * from './saveBase64Data';
+export * from './openPDFViewer';
+export * from './fetchAlbumItems';
 export * from './setDeviceOrientation';
 export * from './storage';
 export * from './openGameCenterLeaderboard';

package/src/MiniAppModule/native-modules/openPDFViewer.ts

@@ -0,0 +1,73 @@
+import { isMinVersionSupported } from './isMinVersionSupported';
+import { safePostMessage } from '../../natives';
+
+/**
+ * @public
+ * @category PDF
+ * @name OpenPDFViewerParams
+ * @description PDF 뷰어를 열 때 필요한 파라미터예요.
+ * @property {string} data - Base64 형식으로 인코딩된 PDF 데이터 문자열이에요.
+ * @property {string} [filename] - PDF 파일 이름이에요.
+ */
+export interface OpenPDFViewerParams {
+  data: string;
+  filename?: string;
+}
+
+/**
+ * @public
+ * @category PDF
+ * @name OpenPDFViewerResult
+ * @description PDF 뷰어가 닫혔을 때 반환되는 결과예요.
+ */
+export type OpenPDFViewerResult = 'CLOSE';
+
+/**
+ * @public
+ * @category PDF
+ * @name openPDFViewer
+ * @description Base64로 인코딩된 PDF 데이터를 네이티브 PDF 뷰어로 열어요. 사용자가 뷰어를 닫으면 `'CLOSE'`를 반환해요.
+ *
+ * @param {OpenPDFViewerParams} params - PDF 데이터와 파일 이름을 담은 객체예요.
+ * @returns {Promise<OpenPDFViewerResult>} PDF 뷰어가 닫히면 `'CLOSE'`를 반환해요.
+ *
+ * @throws
+ * - {code: `INVALID_REQUEST`}: 요청 파라미터가 올바르지 않을 때
+ * - {code: `INVALID_DATA`}: PDF 데이터가 유효하지 않을 때
+ * - {code: `PDF_VIEWER_ERROR`}: PDF 뷰어를 여는 과정에서 오류가 발생했을 때
+ * - {code: `UNSUPPORTED_APP_VERSION`}: 토스앱 버전이 5.261.0보다 낮을 때
+ *
+ * @example
+ * ```tsx
+ * import { openPDFViewer } from '@apps-in-toss/framework';
+ *
+ * async function showPdf() {
+ *   try {
+ *     const result = await openPDFViewer({
+ *       data: 'JVBERi0xLjQK...',
+ *       filename: 'document.pdf',
+ *     });
+ *
+ *     if (result === 'CLOSE') {
+ *       console.log('PDF 뷰어가 닫혔어요.');
+ *     }
+ *   } catch (error) {
+ *       console.error('PDF 뷰어 오류:', error);
+ *   }
+ * }
+ * ```
+ */
+export async function openPDFViewer(params: OpenPDFViewerParams): Promise<OpenPDFViewerResult> {
+  const isSupported = isMinVersionSupported({
+    android: '5.261.0',
+    ios: '5.261.0',
+  });
+
+  if (!isSupported) {
+    const error = new Error('토스앱 5.261.0 버전 이상이 필요해요.');
+    (error as any).code = 'UNSUPPORTED_APP_VERSION';
+    throw error;
+  }
+
+  return safePostMessage('openPDFViewer', params);
+}

package/src/MiniAppModule/postMessage.ts

@@ -9,11 +9,13 @@ import type {
 } from '@apps-in-toss/types';
 import type { AppsInTossSignTossCertParams } from './native-modules/appsInTossSignTossCert';
 import type { CheckoutPaymentOptions, CheckoutPaymentResult } from './native-modules/checkoutPayment';
+import type { AlbumItemResponse, FetchAlbumItemsOptions } from './native-modules/fetchAlbumItems';
 import type { GetAnonymousKeyResponse } from './native-modules/getAnonymousKey';
 import type { GameCenterGameProfileResponse } from './native-modules/getGameCenterGameProfile';
 import type { GetUserKeyForGameResponse } from './native-modules/getUserKeyForGame';
 import type { GrantPromotionRewardForGameResponse } from './native-modules/grantPromotionRewardForGame';
 import type { IapCreateOneTimePurchaseOrderResult, IapSubscriptionInfoResult } from './native-modules/iap';
+import type { OpenPDFViewerParams, OpenPDFViewerResult } from './native-modules/openPDFViewer';
 import type { RequestNotificationAgreementOptions } from './native-modules/requestNotificationAgreement';
 import type {
   RequestTossPayPaysBillingOptions,
@@ -45,6 +47,7 @@ export interface AsyncMethodsMap {
   // Contacts & Photos (3)
   fetchContacts: (params: { size: number; offset: number; query?: { contains?: string } }) => Promise<ContactResult>;
   fetchAlbumPhotos: (params: { base64?: boolean; maxCount?: number; maxWidth?: number }) => Promise<ImageResponse[]>;
+  fetchAlbumItems: (params: FetchAlbumItemsOptions) => Promise<AlbumItemResponse[]>;
   openCamera: (params: { base64?: boolean; maxWidth?: number }) => Promise<ImageResponse>;
 
   // Location (1)
@@ -74,6 +77,7 @@ export interface AsyncMethodsMap {
   requestTossPayPaysBilling: (params: RequestTossPayPaysBillingOptions) => Promise<RequestTossPayPaysBillingResult>;
   setDeviceOrientation: (params: { type: 'portrait' | 'landscape' }) => Promise<void>;
   saveBase64Data: (params: SaveBase64DataParams) => Promise<void>;
+  openPDFViewer: (params: OpenPDFViewerParams) => Promise<OpenPDFViewerResult>;
   appsInTossSignTossCert: (params: AppsInTossSignTossCertParams) => Promise<void>;
   getGameCenterGameProfile: (
     params: CompatiblePlaceholderArgument

package/src/async-bridges.ts

@@ -25,6 +25,8 @@ export * from './MiniAppModule/native-modules/setDeviceOrientation';
 export * from './MiniAppModule/native-modules/checkoutPayment';
 export * from './MiniAppModule/native-modules/requestTossPayPaysBilling';
 export * from './MiniAppModule/native-modules/saveBase64Data';
+export * from './MiniAppModule/native-modules/openPDFViewer';
+export * from './MiniAppModule/native-modules/fetchAlbumItems';
 export * from './MiniAppModule/native-modules/appsInTossSignTossCert';
 export * from './MiniAppModule/native-modules/getGameCenterGameProfile';
 export * from './MiniAppModule/native-modules/openGameCenterLeaderboard';