@apps-in-toss/web-bridge 2.5.2 → 2.6.1

package/dist/bridge.d.ts

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

package/dist/bridge.js

@@ -1 +1 @@
-import{createAsyncBridge,createConstantBridge,createEventBridge}from"@apps-in-toss/bridge-core";var createEvents=function(){return{emit:function emit(event,args){for(var callbacks=this.events[event]||[],i=0,length=callbacks.length;i<length;i++){callbacks[i](args)}},events:{},on:function on(event,cb){var _this=this;var _this_events,_event;((_this_events=this.events)[_event=event]||(_this_events[_event]=[])).push(cb);return function(){var _this_events_event;_this.events[event]=(_this_events_event=_this.events[event])===null||_this_events_event===void 0?void 0:_this_events_event.filter(function(i){return cb!==i})}}}};if(typeof window!=="undefined"){window.__GRANITE_NATIVE_EMITTER=createEvents()}export var closeView=createAsyncBridge("closeView");export var generateHapticFeedback=createAsyncBridge("generateHapticFeedback");export var share=createAsyncBridge("share");export var setSecureScreen=createAsyncBridge("setSecureScreen");export var setScreenAwakeMode=createAsyncBridge("setScreenAwakeMode");export var getNetworkStatus=createAsyncBridge("getNetworkStatus");export var setIosSwipeGestureEnabled=createAsyncBridge("setIosSwipeGestureEnabled");export var openURL=createAsyncBridge("openURL");export var openPermissionDialog=createAsyncBridge("openPermissionDialog");export var getPermission=createAsyncBridge("getPermission");export var requestPermission=createAsyncBridge("requestPermission");export var setClipboardText=createConstantBridge("setClipboardText");export var getClipboardText=createConstantBridge("getClipboardText");export var fetchContacts=createConstantBridge("fetchContacts");export var fetchAlbumPhotos=createConstantBridge("fetchAlbumPhotos");export var getCurrentLocation=createConstantBridge("getCurrentLocation");export var openCamera=createConstantBridge("openCamera");export var appLogin=createAsyncBridge("appLogin");export var eventLog=createAsyncBridge("eventLog");export var getTossShareLink=createAsyncBridge("getTossShareLink");export var setDeviceOrientation=createAsyncBridge("setDeviceOrientation");export var checkoutPayment=createAsyncBridge("checkoutPayment");export var requestTossPayPaysBilling=createAsyncBridge("requestTossPayPaysBilling");export var saveBase64Data=createAsyncBridge("saveBase64Data");export var appsInTossSignTossCert=createAsyncBridge("appsInTossSignTossCert");export var getGameCenterGameProfile=createAsyncBridge("getGameCenterGameProfile");export var openGameCenterLeaderboard=createAsyncBridge("openGameCenterLeaderboard");export var submitGameCenterLeaderBoardScore=createAsyncBridge("submitGameCenterLeaderBoardScore");export var getAnonymousKey=createAsyncBridge("getAnonymousKey");export var getUserKeyForGame=createAsyncBridge("getUserKeyForGame");export var grantPromotionReward=createAsyncBridge("grantPromotionReward");export var grantPromotionRewardForGame=createAsyncBridge("grantPromotionRewardForGame");export var getIsTossLoginIntegratedService=createAsyncBridge("getIsTossLoginIntegratedService");export var getServerTime=createAsyncBridge("getServerTime");export var requestReview=createAsyncBridge("requestReview");export var getLocale=createConstantBridge("getLocale");export var getSchemeUri=createConstantBridge("getSchemeUri");export var getPlatformOS=createConstantBridge("getPlatformOS");export var getOperationalEnvironment=createConstantBridge("getOperationalEnvironment");export var getTossAppVersion=createConstantBridge("getTossAppVersion");export var getDeviceId=createConstantBridge("getDeviceId");export var getGroupId=createConstantBridge("getGroupId");export var contactsViral=createEventBridge("contactsViral");export var startUpdateLocation=createEventBridge("startUpdateLocation");export var onVisibilityChangedByTransparentServiceWeb=createEventBridge("onVisibilityChangedByTransparentServiceWeb");
+import{createAsyncBridge,createConstantBridge,createEventBridge}from"@apps-in-toss/bridge-core";var createEvents=function(){return{emit:function emit(event,args){for(var callbacks=this.events[event]||[],i=0,length=callbacks.length;i<length;i++){callbacks[i](args)}},events:{},on:function on(event,cb){var _this=this;var _this_events,_event;((_this_events=this.events)[_event=event]||(_this_events[_event]=[])).push(cb);return function(){var _this_events_event;_this.events[event]=(_this_events_event=_this.events[event])===null||_this_events_event===void 0?void 0:_this_events_event.filter(function(i){return cb!==i})}}}};if(typeof window!=="undefined"){window.__GRANITE_NATIVE_EMITTER=createEvents()}export var closeView=createAsyncBridge("closeView");export var generateHapticFeedback=createAsyncBridge("generateHapticFeedback");export var share=createAsyncBridge("share");export var setSecureScreen=createAsyncBridge("setSecureScreen");export var setScreenAwakeMode=createAsyncBridge("setScreenAwakeMode");export var getNetworkStatus=createAsyncBridge("getNetworkStatus");export var setIosSwipeGestureEnabled=createAsyncBridge("setIosSwipeGestureEnabled");export var openURL=createAsyncBridge("openURL");export var openPermissionDialog=createAsyncBridge("openPermissionDialog");export var getPermission=createAsyncBridge("getPermission");export var requestPermission=createAsyncBridge("requestPermission");export var setClipboardText=createConstantBridge("setClipboardText");export var getClipboardText=createConstantBridge("getClipboardText");export var fetchContacts=createConstantBridge("fetchContacts");export var fetchAlbumPhotos=createConstantBridge("fetchAlbumPhotos");export var getCurrentLocation=createConstantBridge("getCurrentLocation");export var openCamera=createConstantBridge("openCamera");export var appLogin=createAsyncBridge("appLogin");export var eventLog=createAsyncBridge("eventLog");export var getTossShareLink=createAsyncBridge("getTossShareLink");export var setDeviceOrientation=createAsyncBridge("setDeviceOrientation");export var checkoutPayment=createAsyncBridge("checkoutPayment");export var requestTossPayPaysBilling=createAsyncBridge("requestTossPayPaysBilling");export var saveBase64Data=createAsyncBridge("saveBase64Data");export var openPDFViewer=createAsyncBridge("openPDFViewer");export var fetchAlbumItems=createAsyncBridge("fetchAlbumItems");export var appsInTossSignTossCert=createAsyncBridge("appsInTossSignTossCert");export var getGameCenterGameProfile=createAsyncBridge("getGameCenterGameProfile");export var openGameCenterLeaderboard=createAsyncBridge("openGameCenterLeaderboard");export var submitGameCenterLeaderBoardScore=createAsyncBridge("submitGameCenterLeaderBoardScore");export var getAnonymousKey=createAsyncBridge("getAnonymousKey");export var getUserKeyForGame=createAsyncBridge("getUserKeyForGame");export var grantPromotionReward=createAsyncBridge("grantPromotionReward");export var grantPromotionRewardForGame=createAsyncBridge("grantPromotionRewardForGame");export var getIsTossLoginIntegratedService=createAsyncBridge("getIsTossLoginIntegratedService");export var getServerTime=createAsyncBridge("getServerTime");export var requestReview=createAsyncBridge("requestReview");export var getLocale=createConstantBridge("getLocale");export var getSchemeUri=createConstantBridge("getSchemeUri");export var getPlatformOS=createConstantBridge("getPlatformOS");export var getOperationalEnvironment=createConstantBridge("getOperationalEnvironment");export var getTossAppVersion=createConstantBridge("getTossAppVersion");export var getDeviceId=createConstantBridge("getDeviceId");export var getGroupId=createConstantBridge("getGroupId");export var contactsViral=createEventBridge("contactsViral");export var startUpdateLocation=createEventBridge("startUpdateLocation");export var onVisibilityChangedByTransparentServiceWeb=createEventBridge("onVisibilityChangedByTransparentServiceWeb");

package/dist/fetchAlbumItems.d.ts

@@ -0,0 +1,81 @@
+/**
+ * @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/web-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 declare function fetchAlbumItems(options?: FetchAlbumItemsOptions): Promise<AlbumItemResponse[]>;
+
+export {};

package/dist/openPDFViewer.d.ts

@@ -0,0 +1,57 @@
+/**
+ * @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/web-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 declare function openPDFViewer(params: OpenPDFViewerParams): Promise<OpenPDFViewerResult>;
+
+export {};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@apps-in-toss/web-bridge",
   "type": "module",
-  "version": "2.5.2",
+  "version": "2.6.1",
   "description": "Web Bridge for Apps In Toss",
   "scripts": {
     "typecheck": "tsc --noEmit",
@@ -27,11 +27,11 @@
     "dist"
   ],
   "dependencies": {
-    "@apps-in-toss/types": "2.5.2"
+    "@apps-in-toss/types": "2.6.1"
   },
   "devDependencies": {
-    "@apps-in-toss/bridge-core": "2.5.2",
-    "@apps-in-toss/native-modules": "^2.5.2",
+    "@apps-in-toss/bridge-core": "2.6.1",
+    "@apps-in-toss/native-modules": "^2.6.1",
     "@swc/core": "^1.12.7",
     "picocolors": "^1.1.1",
     "ts-morph": "^26.0.0",