@apps-in-toss/web-bridge 0.0.0-dev.1753241576118 → 0.0.0-dev.1754978484791

package/build/bridge.d.ts

@@ -27,4 +27,5 @@ export * from './openGameCenterLeaderboard.js';
 export * from './submitGameCenterLeaderBoardScore.js';
 export * from './getTossAppVersion.js';
 export * from './getDeviceId.js';
-export * from './startUpdateLocation.js';
+export * from './startUpdateLocation.js';
+export * from './contactsViral.js';

package/build/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.__BEDROCK_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 getLocale=createConstantBridge("getLocale");export var getSchemeUri=createConstantBridge("getSchemeUri");export var getPlatformOS=createConstantBridge("getPlatformOS");export var setClipboardText=createAsyncBridge("setClipboardText");export var getClipboardText=createAsyncBridge("getClipboardText");export var fetchContacts=createAsyncBridge("fetchContacts");export var fetchAlbumPhotos=createAsyncBridge("fetchAlbumPhotos");export var Accuracy=function(Accuracy){Accuracy[Accuracy["Lowest"]=1]="Lowest";Accuracy[Accuracy["Low"]=2]="Low";Accuracy[Accuracy["Balanced"]=3]="Balanced";Accuracy[Accuracy["High"]=4]="High";Accuracy[Accuracy["Highest"]=5]="Highest";Accuracy[Accuracy["BestForNavigation"]=6]="BestForNavigation";return Accuracy}({});export var getCurrentLocation=createAsyncBridge("getCurrentLocation");export var openCamera=createAsyncBridge("openCamera");export var appLogin=createAsyncBridge("appLogin");export var checkoutPayment=createAsyncBridge("checkoutPayment");export var eventLog=createAsyncBridge("eventLog");export var getTossShareLink=createAsyncBridge("getTossShareLink");export var setDeviceOrientation=createAsyncBridge("setDeviceOrientation");export var saveBase64Data=createAsyncBridge("saveBase64Data");export var getGameCenterGameProfile=createAsyncBridge("getGameCenterGameProfile");export var getOperationalEnvironment=createConstantBridge("getOperationalEnvironment");export var openGameCenterLeaderboard=createAsyncBridge("openGameCenterLeaderboard");export var submitGameCenterLeaderBoardScore=createAsyncBridge("submitGameCenterLeaderBoardScore");export var getTossAppVersion=createConstantBridge("getTossAppVersion");export var getDeviceId=createConstantBridge("getDeviceId");export var startUpdateLocation=createEventBridge("startUpdateLocation");
+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.__BEDROCK_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 getLocale=createConstantBridge("getLocale");export var getSchemeUri=createConstantBridge("getSchemeUri");export var getPlatformOS=createConstantBridge("getPlatformOS");export var setClipboardText=createAsyncBridge("setClipboardText");export var getClipboardText=createAsyncBridge("getClipboardText");export var fetchContacts=createAsyncBridge("fetchContacts");export var fetchAlbumPhotos=createAsyncBridge("fetchAlbumPhotos");export var Accuracy=function(Accuracy){Accuracy[Accuracy["Lowest"]=1]="Lowest";Accuracy[Accuracy["Low"]=2]="Low";Accuracy[Accuracy["Balanced"]=3]="Balanced";Accuracy[Accuracy["High"]=4]="High";Accuracy[Accuracy["Highest"]=5]="Highest";Accuracy[Accuracy["BestForNavigation"]=6]="BestForNavigation";return Accuracy}({});export var getCurrentLocation=createAsyncBridge("getCurrentLocation");export var openCamera=createAsyncBridge("openCamera");export var appLogin=createAsyncBridge("appLogin");export var checkoutPayment=createAsyncBridge("checkoutPayment");export var eventLog=createAsyncBridge("eventLog");export var getTossShareLink=createAsyncBridge("getTossShareLink");export var setDeviceOrientation=createAsyncBridge("setDeviceOrientation");export var saveBase64Data=createAsyncBridge("saveBase64Data");export var getGameCenterGameProfile=createAsyncBridge("getGameCenterGameProfile");export var getOperationalEnvironment=createConstantBridge("getOperationalEnvironment");export var openGameCenterLeaderboard=createAsyncBridge("openGameCenterLeaderboard");export var submitGameCenterLeaderBoardScore=createAsyncBridge("submitGameCenterLeaderBoardScore");export var getTossAppVersion=createConstantBridge("getTossAppVersion");export var getDeviceId=createConstantBridge("getDeviceId");export var startUpdateLocation=createEventBridge("startUpdateLocation");export var contactsViral=createEventBridge("contactsViral");

package/build/contactsViral.d.ts

@@ -0,0 +1,110 @@
+/**
+ * @public
+ * @category 친구초대
+ * @name RewardFromContactsViralEvent
+ * @description 친구에게 공유하기를 완료했을 때 지급할 리워드 정보를 담는 타입이에요. 이 타입을 사용하면 공유가 완료됐을 때 지급할 리워드 정보를 확인할 수 있어요.
+ * @property {'sendViral'} type - 이벤트의 타입이에요. `'sendViral'`은 사용자가 친구에게 공유를 완료했을 때 돌아와요.
+ * @property {Object} data - 지급할 리워드 관련 정보를 담고 있어요.
+ * @property {number} data.rewardAmount - 지급할 리워드 수량이에요. 앱인토스 콘솔에서 설정한 수량 및 금액 값이에요.
+ * @property {string} data.rewardUnit - 리워드의 단위예요. 앱인토스 콘솔에 설정된 리워드 이름인 '하트', '보석' 등이 리워드 단위예요.
+ */
+export type RewardFromContactsViralEvent = {
+	type: "sendViral";
+	data: {
+		rewardAmount: number;
+		rewardUnit: string;
+	};
+};
+/**
+ * @public
+ * @category 친구초대
+ * @name SuccessEvent
+ * @description 연락처 공유 모듈이 정상적으로 종료됐을 때 전달되는 이벤트 객체예요. 종료 이유와 함께 리워드 상태 및 남은 친구 수 등 관련 정보를 제공해요.
+ * @property {'close'} type - 이벤트의 타입이에요. `'close'`는 공유 모듈이 종료됐을 때 돌아와요.
+ * @property {Object} data - 모듈 종료와 관련된 세부 정보를 담고 있어요.
+ * @property {'clickBackButton' | 'noReward'} data.closeReason - 모듈이 종료된 이유예요. `'clickBackButton'`은 사용자가 뒤로 가기 버튼을 눌러 종료한 경우이고, `'noReward'`는 받을 수 있는 리워드가 없어서 종료된 경우예요.
+ * @property {number} data.sentRewardAmount - 사용자가 받은 전체 리워드 수량이에요.
+ * @property {number} data.sendableRewardsCount - 아직 공유할 수 있는 친구 수예요.
+ * @property {number} data.sentRewardsCount - 사용자가 공유를 완료한 친구 수예요.
+ * @property {string} data.rewardUnit - 리워드의 단위예요. 앱인토스 콘솔에 설정된 리워드 이름인 '하트', '보석' 등이 리워드 단위예요.
+ */
+export type ContactsViralSuccessEvent = {
+	type: "close";
+	data: {
+		closeReason: "clickBackButton" | "noReward";
+		sentRewardAmount?: number;
+		sendableRewardsCount?: number;
+		sentRewardsCount: number;
+		rewardUnit?: string;
+	};
+};
+export type ContactsViralEvent = RewardFromContactsViralEvent | ContactsViralSuccessEvent;
+/**
+ * @public
+ * @category 친구초대
+ * @name ContactsViralOption
+ * @description [연락처 공유 기능](/bedrock/reference/framework/친구초대/contactsViral.html)을 사용할 때 필요한 옵션이에요.
+ * @property {string} moduleId - 공유 리워드를 구분하는 UUID 형식의 고유 ID예요. 앱인토스 콘솔의 미니앱 > 공유 리워드 메뉴에서 확인할 수 있어요.
+ */
+export type ContactsViralOption = {
+	moduleId: string;
+};
+/**
+ * @public
+ * @category 친구초대
+ * @description `ContactsViralParams`는 연락처 공유 기능을 사용할 때 전달해야 하는 파라미터 타입이에요. 옵션을 설정하고, 이벤트 및 에러 처리 콜백을 지정할 수 있어요.
+ * @property {ContactsViralOption} options - 공유 기능에 사용할 옵션 객체예요.
+ * @property {(event: ContactsViralEvent) => void} onEvent - 공유 이벤트가 발생했을 때 실행되는 함수예요. [`RewardFromContactsViralEvent`](/bedrock/reference/framework/친구초대/RewardFromContactsViralEvent.html) 또는 [`ContactsViralSuccessEvent`](/bedrock/reference/framework/친구초대/ContactsViralSuccessEvent.html) 타입의 이벤트 객체가 전달돼요.
+ * @property {(error: unknown) => void} onError - 예기치 않은 에러가 발생했을 때 실행되는 함수예요.
+ */
+export interface ContactsViralParams {
+	options: ContactsViralOption;
+	onEvent: (event: ContactsViralEvent) => void;
+	onError: (error: unknown) => void;
+}
+/**
+ * @public
+ * @category 친구초대
+ * @name contactsViral
+ * @description 친구에게 공유하고 리워드를 받을 수 있는 기능을 제공해요. 사용자가 친구에게 공유를 완료하면 앱브릿지가 이벤트를 통해 리워드 정보를 전달해요.
+ * @param {ContactsViralParams} params - 연락처 공유 기능을 실행할 때 사용하는 파라미터예요. 옵션 설정과 이벤트 핸들러를 포함해요. 자세한 내용은 [ContactsViralParams](/bedrock/reference/framework/친구초대/ContactsViralParams.html) 문서를 참고하세요.
+ * @returns {() => void} 앱브릿지 cleanup 함수를 반환해요. 공유 기능이 끝나면 반드시 이 함수를 호출해서 리소스를 해제해야 해요.
+ *
+ * @example
+ * ### 친구에게 공유하고 리워드 받기
+ *
+ * ```tsx
+ * import { useCallback } from 'react';
+ * 
+ * import { contactsViral } from '@apps-in-toss/web-framework';
+ *
+ * function ContactsViralButton({ moduleId }: { moduleId: string }) {
+ *   const handleContactsViral = useCallback(() => {
+ *     try {
+ *       const cleanup = contactsViral({
+ *         options: { moduleId: moduleId.trim() },
+ *         onEvent: (event) => {
+ *           if (event.type === 'sendViral') {
+ *             console.log('리워드 지급:', event.data.rewardAmount, event.data.rewardUnit);
+ *           } else if (event.type === 'close') {
+ *             console.log('모듈 종료:', event.data.closeReason);
+ *           }
+ *         },
+ *         onError: (error) => {
+ *           console.error('에러 발생:', error);
+ *         },
+ *       });
+ *
+ *       return cleanup;
+ *     } catch (error) {
+ *       console.error('실행 중 에러:', error);
+ *     }
+ *   }, [moduleId]);
+ *
+ *   return <input type="button" value="친구에게 공유하고 리워드 받기" onClick={handleContactsViral} />;
+ * }
+ * ```
+ */
+export declare function contactsViral(params: ContactsViralParams): () => void;
+
+export {};

package/build/index.d.ts

@@ -154,7 +154,7 @@ declare const IAP: {
      */
     createOneTimePurchaseOrder: (args_0: {
         productId: string;
-    }, args_1: IapCreateOneTimePurchaseOrderResult) => Promise<any>;
+    }) => Promise<IapCreateOneTimePurchaseOrderResult>;
     /**
      * @public
      * @category 인앱결제
@@ -539,4 +539,119 @@ interface AppsInTossGlobals {
 }
 declare const getAppsInTossGlobals: () => AppsInTossGlobals;
 
-export { type AppsInTossEvent, type AppsInTossGlobals, type BedrockEvent, GoogleAdMob, IAP, type IapCreateOneTimePurchaseOrderResult, type IapProductListItem, Storage, appsInTossEvent, bedrockEvent, env, getAppsInTossGlobals, getSafeAreaInsets, isMinVersionSupported };
+type TdsEvent = {
+    navigationAccessoryEvent: {
+        onEvent: (data: {
+            id: string;
+        }) => void;
+        onError?: (error: Error) => void;
+        options: undefined;
+    };
+};
+/**
+ * @public
+ * @category TDS
+ * @name tdsEvent
+ * @description 토스 이벤트를 사용해요.
+ * @property {typeof addEventListener} [addEventListener] 이벤트를 추가해요.
+ */
+declare const tdsEvent: {
+    /**
+     * @public
+     * @category TDS
+     * @name addEventListener
+     * @description 이벤트를 추가해요.
+     * @param {string} event 이벤트 이름예요.
+     * @param {TdsEvent[K]['onEvent']} onEvent 이벤트 핸들러예요.
+     * @param {TdsEvent[K]['onError']} onError 이벤트 에러 핸들러예요.
+     * @param {TdsEvent[K]['options']} options 이벤트 옵션예요.
+     * @returns {void} 이벤트를 추가했을 때 아무 값도 반환하지 않아요.
+     * @example
+     * ### 네비게이션 악세서리 이벤트 추가하기
+     * ```tsx
+     * import { tdsEvent } from '@apps-in-toss/framework';
+     *
+     * tdsEvent.addEventListener('navigationAccessoryEvent', {
+     *   onEvent: ({ id }) => {
+     *     if(id === 'heart') {
+     *       router.push('/heart');
+     *     }
+     *   },
+     * });
+     * ```
+     */
+    addEventListener: <K extends keyof TdsEvent>(event: K, { onEvent, onError, options, }: {
+        onEvent: TdsEvent[K]["onEvent"];
+        onError?: TdsEvent[K]["onError"];
+        options?: TdsEvent[K]["options"];
+    }) => () => void;
+};
+
+type AddAccessoryButtonOptions = {
+    id: string;
+    type: 'icon';
+    name: string;
+    alt: string;
+} | {
+    type: 'icon-double';
+    color?: string;
+    leftIconName: string;
+    leftIconAlt: string;
+    rightIconName: string;
+    rightIconAlt: string;
+    id: [string, string];
+};
+/**
+ * @public
+ * @category 파트너
+ * @name partner
+ * @description 파트너 기능을 사용해요.
+ * @property {typeof addAccessoryButton} [addAccessoryButton] 상단 네비게이션의 악세서리 버튼을 추가해요.
+ */
+declare const partner: {
+    /**
+     * @public
+     * @category 파트너
+     * @name addAccessoryButton
+     * @description 상단 네비게이션의 악세서리 버튼을 추가해요. callback에 대한 정의는 `tdsEvent.addEventListener("navigationAccessoryEvent", callback)`를 참고해주세요.
+     * @param {AddAccessoryButtonOptions} options - 악세서리 버튼의 고유 ID예요.
+     * @returns {void} 악세서리 버튼을 추가했을 때 아무 값도 반환하지 않아요.
+     * @example
+     * ```tsx
+     * import { partner } from '@apps-in-toss/framework';
+     *
+     * partner.addAccessoryButton({
+     *   id: 'heart',
+     *   type: 'icon',
+     *   name: 'icon-heart-mono',
+     *   alt: '하트',
+     * });
+     *
+     * partner.addAccessoryButton({
+     *   id: ['heart', 'heart2'],
+     *   type: 'icon-double',
+     *   leftIconName: 'icon-heart-mono',
+     *   leftIconAlt: '하트',
+     *   rightIconName: 'icon-heart-mono',
+     *   rightIconAlt: '하트',
+     * });
+     * ```
+     */
+    addAccessoryButton: (args_0: AddAccessoryButtonOptions) => Promise<void>;
+    /**
+     * @public
+     * @category 파트너
+     * @name removeAccessoryButton
+     * @description 상단 네비게이션의 악세서리 버튼을 제거해요.
+     * @returns {void} 악세서리 버튼을 제거했을 때 아무 값도 반환하지 않아요.
+     * @example
+     * ```tsx
+     * import { partner } from '@apps-in-toss/framework';
+     *
+     * partner.removeAccessoryButton();
+     * ```
+     */
+    removeAccessoryButton: () => Promise<void>;
+};
+
+export { type AddAccessoryButtonOptions, type AppsInTossEvent, type AppsInTossGlobals, type BedrockEvent, GoogleAdMob, IAP, type IapCreateOneTimePurchaseOrderResult, type IapProductListItem, Storage, type TdsEvent, appsInTossEvent, bedrockEvent, env, getAppsInTossGlobals, getSafeAreaInsets, isMinVersionSupported, partner, tdsEvent };

package/build/index.js

@@ -121,7 +121,7 @@ function getSafeAreaInsets() {
 }
 
 // src/googleAdMob.ts
-import { createEventBridge, createConstantBridge as createConstantBridge2 } from "@apps-in-toss/bridge-core";
+import { createConstantBridge as createConstantBridge2, createEventBridge } from "@apps-in-toss/bridge-core";
 var GoogleAdMob = {
   /**
    * @public
@@ -542,6 +542,93 @@ var getAppsInTossGlobals = () => {
     brandBridgeColorMode: brandBridgeColorMode()
   };
 };
+
+// src/tdsEvent.ts
+import { createEventBridge as createEventBridge4 } from "@apps-in-toss/bridge-core";
+var tdsEvent = {
+  /**
+   * @public
+   * @category TDS
+   * @name addEventListener
+   * @description 이벤트를 추가해요.
+   * @param {string} event 이벤트 이름예요.
+   * @param {TdsEvent[K]['onEvent']} onEvent 이벤트 핸들러예요.
+   * @param {TdsEvent[K]['onError']} onError 이벤트 에러 핸들러예요.
+   * @param {TdsEvent[K]['options']} options 이벤트 옵션예요.
+   * @returns {void} 이벤트를 추가했을 때 아무 값도 반환하지 않아요.
+   * @example
+   * ### 네비게이션 악세서리 이벤트 추가하기
+   * ```tsx
+   * import { tdsEvent } from '@apps-in-toss/framework';
+   *
+   * tdsEvent.addEventListener('navigationAccessoryEvent', {
+   *   onEvent: ({ id }) => {
+   *     if(id === 'heart') {
+   *       router.push('/heart');
+   *     }
+   *   },
+   * });
+   * ```
+   */
+  addEventListener: (event, {
+    onEvent,
+    onError,
+    options
+  }) => createEventBridge4(event)({
+    onEvent,
+    onError: onError ?? (() => {
+    }),
+    options
+  })
+};
+
+// src/partner.ts
+import { createAsyncBridge as createAsyncBridge3 } from "@apps-in-toss/bridge-core";
+var partner = {
+  /**
+   * @public
+   * @category 파트너
+   * @name addAccessoryButton
+   * @description 상단 네비게이션의 악세서리 버튼을 추가해요. callback에 대한 정의는 `tdsEvent.addEventListener("navigationAccessoryEvent", callback)`를 참고해주세요.
+   * @param {AddAccessoryButtonOptions} options - 악세서리 버튼의 고유 ID예요.
+   * @returns {void} 악세서리 버튼을 추가했을 때 아무 값도 반환하지 않아요.
+   * @example
+   * ```tsx
+   * import { partner } from '@apps-in-toss/framework';
+   *
+   * partner.addAccessoryButton({
+   *   id: 'heart',
+   *   type: 'icon',
+   *   name: 'icon-heart-mono',
+   *   alt: '하트',
+   * });
+   *
+   * partner.addAccessoryButton({
+   *   id: ['heart', 'heart2'],
+   *   type: 'icon-double',
+   *   leftIconName: 'icon-heart-mono',
+   *   leftIconAlt: '하트',
+   *   rightIconName: 'icon-heart-mono',
+   *   rightIconAlt: '하트',
+   * });
+   * ```
+   */
+  addAccessoryButton: createAsyncBridge3("addAccessoryButton"),
+  /**
+   * @public
+   * @category 파트너
+   * @name removeAccessoryButton
+   * @description 상단 네비게이션의 악세서리 버튼을 제거해요.
+   * @returns {void} 악세서리 버튼을 제거했을 때 아무 값도 반환하지 않아요.
+   * @example
+   * ```tsx
+   * import { partner } from '@apps-in-toss/framework';
+   *
+   * partner.removeAccessoryButton();
+   * ```
+   */
+  removeAccessoryButton: createAsyncBridge3("removeAccessoryButton")
+};
 export {
   GoogleAdMob,
   IAP,
@@ -551,5 +638,7 @@ export {
   env,
   getAppsInTossGlobals,
   getSafeAreaInsets,
-  isMinVersionSupported
+  isMinVersionSupported,
+  partner,
+  tdsEvent
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@apps-in-toss/web-bridge",
   "type": "module",
-  "version": "0.0.0-dev.1753241576118",
+  "version": "0.0.0-dev.1754978484791",
   "description": "Web Bridge for Apps In Toss",
   "scripts": {
     "prepack": "yarn build",
@@ -23,9 +23,9 @@
     "build"
   ],
   "devDependencies": {
-    "@apps-in-toss-internal/bridgepack": "0.0.0-dev.1753241576118",
-    "@apps-in-toss/bridge-core": "0.0.0-dev.1753241576118",
-    "@apps-in-toss/framework": "0.0.0-dev.1753241576118",
+    "@apps-in-toss-internal/bridgepack": "0.0.0-dev.1754978484791",
+    "@apps-in-toss/bridge-core": "0.0.0-dev.1754978484791",
+    "@apps-in-toss/framework": "0.0.0-dev.1754978484791",
     "react-native-bedrock": "0.0.25",
     "tsup": "^8.3.5",
     "typescript": "4.9.5",
@@ -37,5 +37,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "739c606380e6a8681e5dbc55f70b7f72f3f7721b"
+  "gitHead": "06a0031d089ee8986ffcb00a206ec5e10345fa95"
 }