@apps-in-toss/web-bridge 1.3.0 → 1.4.1

package/built/bridge.d.ts

@@ -25,6 +25,8 @@ export * from './appsInTossSignTossCert';
 export * from './getGameCenterGameProfile';
 export * from './openGameCenterLeaderboard';
 export * from './submitGameCenterLeaderBoardScore';
+export * from './getUserKeyForGame';
+export * from './grantPromotionRewardForGame';
 export * from './getLocale';
 export * from './getSchemeUri';
 export * from './getPlatformOS';

package/built/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 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 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 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 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 getUserKeyForGame=createAsyncBridge("getUserKeyForGame");export var grantPromotionRewardForGame=createAsyncBridge("grantPromotionRewardForGame");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 contactsViral=createEventBridge("contactsViral");export var startUpdateLocation=createEventBridge("startUpdateLocation");export var onVisibilityChangedByTransparentServiceWeb=createEventBridge("onVisibilityChangedByTransparentServiceWeb");

package/built/getUserKeyForGame.d.ts

@@ -0,0 +1,98 @@
+export interface GetUserKeyForGameSuccessResponse {
+	hash: string;
+	type: "HASH";
+}
+export interface GetUserKeyForGameErrorResponse {
+	type: "NOT_AVAILABLE";
+}
+export type GetUserKeyForGameResponse = GetUserKeyForGameSuccessResponse | GetUserKeyForGameErrorResponse;
+/**
+ * @public
+ * @category 게임
+ * @name getUserKeyForGame
+ * @description
+ * 게임 카테고리 미니앱에서 사용자의 고유 키를 가져와요. 이 키를 사용해서 사용자를 식별하고 게임 데이터를 관리할 수 있어요.
+ * 게임 카테고리가 아닌 미니앱에서 호출하면 `'INVALID_CATEGORY'`를 반환해요.
+ * @returns {Promise<GetUserKeyForGameSuccessResponse | 'INVALID_CATEGORY' | 'ERROR' | undefined>}
+ * 사용자 키 조회 결과를 반환해요.
+ * - `GetUserKeyForGameSuccessResponse`: 사용자 키 조회에 성공했어요. `{ type: 'HASH', hash: string }` 형태로 반환돼요.
+ * - `'INVALID_CATEGORY'`: 게임 카테고리가 아닌 미니앱에서 호출했어요.
+ * - `'ERROR'`: 알 수 없는 오류가 발생했어요.
+ * - `undefined`: 앱 버전이 최소 지원 버전보다 낮아요.
+ *
+ * @example
+ * ```tsx
+ * // react-native
+ * 
+ * import { getUserKeyForGame } from '@apps-in-toss/web-framework';
+ *
+ * function GameUserKeyButton() {
+ *   async function handlePress() {
+ *       const result = await getUserKeyForGame();
+ *
+ *       if (!result) {
+ *         console.warn('지원하지 않는 앱 버전이에요.');
+ *         return;
+ *       }
+ *
+ *       if (result === 'INVALID_CATEGORY') {
+ *         console.error('게임 카테고리가 아닌 미니앱이에요.');
+ *         return;
+ *       }
+ *
+ *       if (result === 'ERROR') {
+ *         console.error('사용자 키 조회 중 오류가 발생했어요.');
+ *         return;
+ *       }
+ *
+ *       if (result.type === 'HASH') {
+ *         console.log('사용자 키:', result.hash);
+ *         // 여기에서 사용자 키를 사용해 게임 데이터를 관리할 수 있어요.
+ *       }
+ *   }
+ *
+ *   return (
+ *     <input type="button" onClick={handlePress} value="유저 키 가져오기" />
+ *   );
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // webview
+ * import { getUserKeyForGame } from '@apps-in-toss/web-framework';
+ *
+ * function GameUserKeyButton() {
+ *   async function handleClick() {
+ *       const result = await getUserKeyForGame();
+ *
+ *       if (!result) {
+ *         console.warn('지원하지 않는 앱 버전이에요.');
+ *         return;
+ *       }
+ *
+ *       if (result === 'INVALID_CATEGORY') {
+ *         console.error('게임 카테고리가 아닌 미니앱이에요.');
+ *         return;
+ *       }
+ *
+ *       if (result === 'ERROR') {
+ *         console.error('사용자 키 조회 중 오류가 발생했어요.');
+ *         return;
+ *       }
+ *
+ *       if (result.type === 'HASH') {
+ *         console.log('사용자 키:', result.hash);
+ *         // 여기에서 사용자 키를 사용해 게임 데이터를 관리할 수 있어요.
+ *       }
+ *   }
+ *
+ *   return (
+ *     <button onClick={handleClick}>유저 키 가져오기</button>
+ *   );
+ * }
+ * ```
+ */
+export declare function getUserKeyForGame(): Promise<GetUserKeyForGameSuccessResponse | "INVALID_CATEGORY" | "ERROR" | undefined>;
+
+export {};

package/built/grantPromotionRewardForGame.d.ts

@@ -0,0 +1,120 @@
+export interface GrantPromotionRewardForGameSuccessResponse {
+	key: string;
+}
+export interface GrantPromotionRewardForGameErrorResponse {
+	code: string;
+	[key: string]: any;
+}
+export interface GrantPromotionRewardForGameErrorResult {
+	errorCode: string;
+	message: string;
+}
+export type GrantPromotionRewardForGameResponse = GrantPromotionRewardForGameSuccessResponse | GrantPromotionRewardForGameErrorResponse;
+export type GrantPromotionRewardForGameResult = GrantPromotionRewardForGameResponse | GrantPromotionRewardForGameErrorResult | "ERROR" | undefined;
+/**
+ * @public
+ * @category 게임
+ * @name grantPromotionRewardForGame
+ * @description
+ * 이 함수를 사용하면 게임 카테고리 미니앱에서 프로모션 코드를 사용해서 유저에게 리워드를 지급할 수 있어요.
+ * 게임 카테고리가 아닌 미니앱에서 호출할 수 없어요.
+ * @param {{ params: { promotionCode: string; amount: number } }} params - 포인트를 지급하기 위해 필요한 정보예요.
+ * @param {string} params.promotionCode - 프로모션 코드예요.
+ * @param {number} params.amount - 지급할 포인트 금액이에요.
+ * @returns {Promise<{ key: string } | { errorCode: string; message: string } | 'ERROR' | undefined>}
+ * 포인트 지급 결과를 반환해요.
+ * - `{ key: string }`: 포인트 지급에 성공했어요. key는 리워드 키를 의미해요.
+ * - `{ errorCode: string, message: string }`: 포인트 지급에 실패했어요. 에러 코드는 다음과 같아요.
+ *   - `"40000"`: 게임이 아닌 미니앱에서 호출했을 때
+ *   - `"4100"`: 프로모션 정보를 찾을 수 없을 때
+ *   - `"4104"`: 프로모션이 중지되었을 때
+ *   - `"4105"`: 프로모션이 종료되었을 때
+ *   - `"4108"`: 프로모션이 승인되지 않았을 때
+ *   - `"4109"`: 프로모션이 실행중이 아닐 때
+ *   - `"4110"`: 리워드를 지급/회수할 수 없을 때
+ *   - `"4112"`: 프로모션 머니가 부족할 때
+ *   - `"4113"`: 이미 지급/회수된 내역일 때
+ *   - `"4114"`: 프로모션에 설정된 1회 지급 금액을 초과할 때
+ * - `'ERROR'`: 알 수 없는 오류가 발생했어요.
+ * - `undefined`: 앱 버전이 최소 지원 버전보다 낮아요.
+ * @example
+ * ```tsx
+ * // react-native
+ * 
+ * import { grantPromotionRewardForGame } from '@apps-in-toss/web-framework';
+ *
+ * function GrantRewardButton() {
+ *   async function handlePress() {
+ *       const result = await grantPromotionRewardForGame({
+ *         params: {
+ *           promotionCode: 'GAME_EVENT_2024',
+ *           amount: 1000,
+ *         },
+ *       });
+ *
+ *       if (!result) {
+ *         console.warn('지원하지 않는 앱 버전이에요.');
+ *         return;
+ *       }
+ *
+ *       if (result === 'ERROR') {
+ *         console.error('포인트 지급 중 알 수 없는 오류가 발생했어요.');
+ *         return;
+ *       }
+ *
+ *       if ('key' in result) {
+ *         console.log('포인트 지급 성공!', result.key);
+ *       } else if ('errorCode' in result) {
+ *         console.error('포인트 지급 실패:', result.errorCode, result.message);
+ *       }
+ *   }
+ *
+ *   return <input type="button" onClick={handlePress} value="포인트 지급하기" />;
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // webview
+ * import { grantPromotionRewardForGame } from '@apps-in-toss/web-framework';
+ *
+ * function GrantRewardButton() {
+ *   async function handleClick() {
+ *       const result = await grantPromotionRewardForGame({
+ *         params: {
+ *           promotionCode: 'GAME_EVENT_2024',
+ *           amount: 1000,
+ *         },
+ *       });
+ *
+ *       if (!result) {
+ *         console.warn('지원하지 않는 앱 버전이에요.');
+ *         return;
+ *       }
+ *
+ *       if (result === 'ERROR') {
+ *         console.error('포인트 지급 중 알 수 없는 오류가 발생했어요.');
+ *         return;
+ *       }
+ *
+ *       if ('key' in result) {
+ *         console.log('포인트 지급 성공!', result.key);
+ *       } else if ('errorCode' in result) {
+ *         console.error('포인트 지급 실패:', result.errorCode, result.message);
+ *       }
+ *   }
+ *
+ *   return (
+ *     <button onClick={handleClick}>포인트 지급하기</button>
+ *   );
+ * }
+ * ```
+ */
+export declare function grantPromotionRewardForGame({ params, }: {
+	params: {
+		promotionCode: string;
+		amount: number;
+	};
+}): Promise<GrantPromotionRewardForGameResult>;
+
+export {};

package/built/index.cjs

@@ -303,7 +303,7 @@ var IAP = {
    * @category 인앱결제
    * @name getPendingOrders
    * @description 대기 중인 주문 목록을 가져와요. 이 함수를 사용하면 결제가 아직 완료되지 않은 주문 정보를 확인할 수 있어요.
-   * @returns {Promise<{orderIds: string[]}}>} 대기 중인 주문ID 배열을 반환해요. 앱 버전이 최소 지원 버전(안드로이드 5.231.0, iOS 5.231.0)보다 낮으면 `undefined`를 반환해요.
+   * @returns {Promise<{ orders: { orderId: string; sku: string; }[]}}>} 대기 중인 주문의 배열을 반환해요. 앱 버전이 최소 지원 버전(안드로이드 5.231.0, iOS 5.231.0)보다 낮으면 `undefined`를 반환해요.
    *
    * @example
    * ### 대기 중인 주문 목록 가져오기

package/built/index.d.cts

@@ -230,7 +230,7 @@ declare const IAP: {
      * @category 인앱결제
      * @name getPendingOrders
      * @description 대기 중인 주문 목록을 가져와요. 이 함수를 사용하면 결제가 아직 완료되지 않은 주문 정보를 확인할 수 있어요.
-     * @returns {Promise<{orderIds: string[]}}>} 대기 중인 주문ID 배열을 반환해요. 앱 버전이 최소 지원 버전(안드로이드 5.231.0, iOS 5.231.0)보다 낮으면 `undefined`를 반환해요.
+     * @returns {Promise<{ orders: { orderId: string; sku: string; }[]}}>} 대기 중인 주문의 배열을 반환해요. 앱 버전이 최소 지원 버전(안드로이드 5.231.0, iOS 5.231.0)보다 낮으면 `undefined`를 반환해요.
      *
      * @example
      * ### 대기 중인 주문 목록 가져오기
@@ -248,7 +248,10 @@ declare const IAP: {
      * ```
      */
     getPendingOrders: () => Promise<{
-        orderIds: string[];
+        orders: {
+            orderId: string;
+            sku: string;
+        }[];
     }>;
     /**
      * @public

package/built/index.d.ts

@@ -230,7 +230,7 @@ declare const IAP: {
      * @category 인앱결제
      * @name getPendingOrders
      * @description 대기 중인 주문 목록을 가져와요. 이 함수를 사용하면 결제가 아직 완료되지 않은 주문 정보를 확인할 수 있어요.
-     * @returns {Promise<{orderIds: string[]}}>} 대기 중인 주문ID 배열을 반환해요. 앱 버전이 최소 지원 버전(안드로이드 5.231.0, iOS 5.231.0)보다 낮으면 `undefined`를 반환해요.
+     * @returns {Promise<{ orders: { orderId: string; sku: string; }[]}}>} 대기 중인 주문의 배열을 반환해요. 앱 버전이 최소 지원 버전(안드로이드 5.231.0, iOS 5.231.0)보다 낮으면 `undefined`를 반환해요.
      *
      * @example
      * ### 대기 중인 주문 목록 가져오기
@@ -248,7 +248,10 @@ declare const IAP: {
      * ```
      */
     getPendingOrders: () => Promise<{
-        orderIds: string[];
+        orders: {
+            orderId: string;
+            sku: string;
+        }[];
     }>;
     /**
      * @public

package/built/index.js

@@ -262,7 +262,7 @@ var IAP = {
    * @category 인앱결제
    * @name getPendingOrders
    * @description 대기 중인 주문 목록을 가져와요. 이 함수를 사용하면 결제가 아직 완료되지 않은 주문 정보를 확인할 수 있어요.
-   * @returns {Promise<{orderIds: string[]}}>} 대기 중인 주문ID 배열을 반환해요. 앱 버전이 최소 지원 버전(안드로이드 5.231.0, iOS 5.231.0)보다 낮으면 `undefined`를 반환해요.
+   * @returns {Promise<{ orders: { orderId: string; sku: string; }[]}}>} 대기 중인 주문의 배열을 반환해요. 앱 버전이 최소 지원 버전(안드로이드 5.231.0, iOS 5.231.0)보다 낮으면 `undefined`를 반환해요.
    *
    * @example
    * ### 대기 중인 주문 목록 가져오기

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@apps-in-toss/web-bridge",
   "type": "module",
-  "version": "1.3.0",
+  "version": "1.4.1",
   "description": "Web Bridge for Apps In Toss",
   "scripts": {
     "prepack": "yarn build",
@@ -28,11 +28,11 @@
     "built"
   ],
   "dependencies": {
-    "@apps-in-toss/types": "1.3.0"
+    "@apps-in-toss/types": "1.4.1"
   },
   "devDependencies": {
-    "@apps-in-toss/bridge-core": "1.3.0",
-    "@apps-in-toss/framework": "1.3.0",
+    "@apps-in-toss/bridge-core": "1.4.1",
+    "@apps-in-toss/framework": "1.4.1",
     "@swc/core": "^1.12.7",
     "picocolors": "^1.1.1",
     "ts-morph": "^26.0.0",
@@ -46,5 +46,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "71845fd4a349b630c91f07c3ab3d14f81774335a"
+  "gitHead": "bdf842173b14aa2a8454c1dd77e37b6a9bdc8e31"
 }