@apps-in-toss/web-framework 0.0.21 → 0.0.23

package/dist/prebuilt/prod.json

@@ -1,14 +1,14 @@
 [
   {
     "platform": "ios",
-    "totalModuleCount": 1602,
-    "duration": 929.8815419999999,
-    "size": 426193
+    "totalModuleCount": 1607,
+    "duration": 994.5753750000001,
+    "size": 435419
   },
   {
     "platform": "android",
-    "totalModuleCount": 1602,
-    "duration": 932.4692919999998,
-    "size": 425572
+    "totalModuleCount": 1607,
+    "duration": 1003.9547079999998,
+    "size": 434798
   }
 ]

package/dist-web/bridge.d.ts

@@ -17,7 +17,8 @@ export * from './getCurrentLocation';
 export * from './openCamera';
 export * from './appLogin';
 export * from './checkoutPayment';
-export * from './executePayment';
+export * from './eventLog';
+export * from './getTossShareLink';
 export * from './getOperationalEnvironment';
 export * from './getTossAppVersion';
 export * from './getDeviceId';

package/dist-web/bridge.js

@@ -1 +1 @@
-export const createEvents=()=>({emit(event,args){for(let callbacks=this.events[event]||[],i=0,length=callbacks.length;i<length;i++){callbacks[i](args)}},events:{},on(event,cb){var _this_events,_event;((_this_events=this.events)[_event=event]||(_this_events[_event]=[])).push(cb);return()=>{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(i=>cb!==i)}}});const createEventId=()=>Math.random().toString(36).substring(2,15);const deserializeError=value=>{if(value&&value.__isError){const err=new Error(value.message);err.name=value.name;err.stack=value.stack;return err}return value};window.__BEDROCK_NATIVE_EMITTER=createEvents();export function closeView(...args){if(!window.ReactNativeWebView){throw new Error("This closeView is not available in browser environment")}const eventId=createEventId();const emitters=[];const unsubscribe=()=>{for(const emitter of emitters){emitter()}};return new Promise((resolve,reject)=>{emitters.push(window.__BEDROCK_NATIVE_EMITTER.on(`closeView/resolve/${eventId}`,args=>{unsubscribe();resolve(args)}));emitters.push(window.__BEDROCK_NATIVE_EMITTER.on(`closeView/reject/${eventId}`,error=>{unsubscribe();reject(deserializeError(error))}));window.ReactNativeWebView.postMessage(JSON.stringify({type:"method",functionName:"closeView",eventId,args}))})}export function generateHapticFeedback(...args){if(!window.ReactNativeWebView){throw new Error("This generateHapticFeedback is not available in browser environment")}const eventId=createEventId();const emitters=[];const unsubscribe=()=>{for(const emitter of emitters){emitter()}};return new Promise((resolve,reject)=>{emitters.push(window.__BEDROCK_NATIVE_EMITTER.on(`generateHapticFeedback/resolve/${eventId}`,args=>{unsubscribe();resolve(args)}));emitters.push(window.__BEDROCK_NATIVE_EMITTER.on(`generateHapticFeedback/reject/${eventId}`,error=>{unsubscribe();reject(deserializeError(error))}));window.ReactNativeWebView.postMessage(JSON.stringify({type:"method",functionName:"generateHapticFeedback",eventId,args}))})}export function share(...args){if(!window.ReactNativeWebView){throw new Error("This share is not available in browser environment")}const eventId=createEventId();const emitters=[];const unsubscribe=()=>{for(const emitter of emitters){emitter()}};return new Promise((resolve,reject)=>{emitters.push(window.__BEDROCK_NATIVE_EMITTER.on(`share/resolve/${eventId}`,args=>{unsubscribe();resolve(args)}));emitters.push(window.__BEDROCK_NATIVE_EMITTER.on(`share/reject/${eventId}`,error=>{unsubscribe();reject(deserializeError(error))}));window.ReactNativeWebView.postMessage(JSON.stringify({type:"method",functionName:"share",eventId,args}))})}export function setSecureScreen(...args){if(!window.ReactNativeWebView){throw new Error("This setSecureScreen is not available in browser environment")}const eventId=createEventId();const emitters=[];const unsubscribe=()=>{for(const emitter of emitters){emitter()}};return new Promise((resolve,reject)=>{emitters.push(window.__BEDROCK_NATIVE_EMITTER.on(`setSecureScreen/resolve/${eventId}`,args=>{unsubscribe();resolve(args)}));emitters.push(window.__BEDROCK_NATIVE_EMITTER.on(`setSecureScreen/reject/${eventId}`,error=>{unsubscribe();reject(deserializeError(error))}));window.ReactNativeWebView.postMessage(JSON.stringify({type:"method",functionName:"setSecureScreen",eventId,args}))})}export function setScreenAwakeMode(...args){if(!window.ReactNativeWebView){throw new Error("This setScreenAwakeMode is not available in browser environment")}const eventId=createEventId();const emitters=[];const unsubscribe=()=>{for(const emitter of emitters){emitter()}};return new Promise((resolve,reject)=>{emitters.push(window.__BEDROCK_NATIVE_EMITTER.on(`setScreenAwakeMode/resolve/${eventId}`,args=>{unsubscribe();resolve(args)}));emitters.push(window.__BEDROCK_NATIVE_EMITTER.on(`setScreenAwakeMode/reject/${eventId}`,error=>{unsubscribe();reject(deserializeError(error))}));window.ReactNativeWebView.postMessage(JSON.stringify({type:"method",functionName:"setScreenAwakeMode",eventId,args}))})}export function getNetworkStatus(...args){if(!window.ReactNativeWebView){throw new Error("This getNetworkStatus is not available in browser environment")}const eventId=createEventId();const emitters=[];const unsubscribe=()=>{for(const emitter of emitters){emitter()}};return new Promise((resolve,reject)=>{emitters.push(window.__BEDROCK_NATIVE_EMITTER.on(`getNetworkStatus/resolve/${eventId}`,args=>{unsubscribe();resolve(args)}));emitters.push(window.__BEDROCK_NATIVE_EMITTER.on(`getNetworkStatus/reject/${eventId}`,error=>{unsubscribe();reject(deserializeError(error))}));window.ReactNativeWebView.postMessage(JSON.stringify({type:"method",functionName:"getNetworkStatus",eventId,args}))})}export function setIosSwipeGestureEnabled(...args){if(!window.ReactNativeWebView){throw new Error("This setIosSwipeGestureEnabled is not available in browser environment")}const eventId=createEventId();const emitters=[];const unsubscribe=()=>{for(const emitter of emitters){emitter()}};return new Promise((resolve,reject)=>{emitters.push(window.__BEDROCK_NATIVE_EMITTER.on(`setIosSwipeGestureEnabled/resolve/${eventId}`,args=>{unsubscribe();resolve(args)}));emitters.push(window.__BEDROCK_NATIVE_EMITTER.on(`setIosSwipeGestureEnabled/reject/${eventId}`,error=>{unsubscribe();reject(deserializeError(error))}));window.ReactNativeWebView.postMessage(JSON.stringify({type:"method",functionName:"setIosSwipeGestureEnabled",eventId,args}))})}export function openURL(...args){if(!window.ReactNativeWebView){throw new Error("This openURL is not available in browser environment")}const eventId=createEventId();const emitters=[];const unsubscribe=()=>{for(const emitter of emitters){emitter()}};return new Promise((resolve,reject)=>{emitters.push(window.__BEDROCK_NATIVE_EMITTER.on(`openURL/resolve/${eventId}`,args=>{unsubscribe();resolve(args)}));emitters.push(window.__BEDROCK_NATIVE_EMITTER.on(`openURL/reject/${eventId}`,error=>{unsubscribe();reject(deserializeError(error))}));window.ReactNativeWebView.postMessage(JSON.stringify({type:"method",functionName:"openURL",eventId,args}))})}export function getLocale(){if(!window.ReactNativeWebView){throw new Error("This getLocale is not available in browser environment")}if("getLocale"in window.__CONSTANT_HANDLER_MAP){return window.__CONSTANT_HANDLER_MAP["getLocale"]}throw new Error("getLocale is not a constant handler")}export function getSchemeUri(){if(!window.ReactNativeWebView){throw new Error("This getSchemeUri is not available in browser environment")}if("getSchemeUri"in window.__CONSTANT_HANDLER_MAP){return window.__CONSTANT_HANDLER_MAP["getSchemeUri"]}throw new Error("getSchemeUri is not a constant handler")}export function getPlatformOS(){if(!window.ReactNativeWebView){throw new Error("This getPlatformOS is not available in browser environment")}if("getPlatformOS"in window.__CONSTANT_HANDLER_MAP){return window.__CONSTANT_HANDLER_MAP["getPlatformOS"]}throw new Error("getPlatformOS is not a constant handler")}export function setClipboardText(...args){if(!window.ReactNativeWebView){throw new Error("This setClipboardText is not available in browser environment")}const eventId=createEventId();const emitters=[];const unsubscribe=()=>{for(const emitter of emitters){emitter()}};return new Promise((resolve,reject)=>{emitters.push(window.__BEDROCK_NATIVE_EMITTER.on(`setClipboardText/resolve/${eventId}`,args=>{unsubscribe();resolve(args)}));emitters.push(window.__BEDROCK_NATIVE_EMITTER.on(`setClipboardText/reject/${eventId}`,error=>{unsubscribe();reject(deserializeError(error))}));window.ReactNativeWebView.postMessage(JSON.stringify({type:"method",functionName:"setClipboardText",eventId,args}))})}export function getClipboardText(...args){if(!window.ReactNativeWebView){throw new Error("This getClipboardText is not available in browser environment")}const eventId=createEventId();const emitters=[];const unsubscribe=()=>{for(const emitter of emitters){emitter()}};return new Promise((resolve,reject)=>{emitters.push(window.__BEDROCK_NATIVE_EMITTER.on(`getClipboardText/resolve/${eventId}`,args=>{unsubscribe();resolve(args)}));emitters.push(window.__BEDROCK_NATIVE_EMITTER.on(`getClipboardText/reject/${eventId}`,error=>{unsubscribe();reject(deserializeError(error))}));window.ReactNativeWebView.postMessage(JSON.stringify({type:"method",functionName:"getClipboardText",eventId,args}))})}export function fetchContacts(...args){if(!window.ReactNativeWebView){throw new Error("This fetchContacts is not available in browser environment")}const eventId=createEventId();const emitters=[];const unsubscribe=()=>{for(const emitter of emitters){emitter()}};return new Promise((resolve,reject)=>{emitters.push(window.__BEDROCK_NATIVE_EMITTER.on(`fetchContacts/resolve/${eventId}`,args=>{unsubscribe();resolve(args)}));emitters.push(window.__BEDROCK_NATIVE_EMITTER.on(`fetchContacts/reject/${eventId}`,error=>{unsubscribe();reject(deserializeError(error))}));window.ReactNativeWebView.postMessage(JSON.stringify({type:"method",functionName:"fetchContacts",eventId,args}))})}export function fetchAlbumPhotos(...args){if(!window.ReactNativeWebView){throw new Error("This fetchAlbumPhotos is not available in browser environment")}const eventId=createEventId();const emitters=[];const unsubscribe=()=>{for(const emitter of emitters){emitter()}};return new Promise((resolve,reject)=>{emitters.push(window.__BEDROCK_NATIVE_EMITTER.on(`fetchAlbumPhotos/resolve/${eventId}`,args=>{unsubscribe();resolve(args)}));emitters.push(window.__BEDROCK_NATIVE_EMITTER.on(`fetchAlbumPhotos/reject/${eventId}`,error=>{unsubscribe();reject(deserializeError(error))}));window.ReactNativeWebView.postMessage(JSON.stringify({type:"method",functionName:"fetchAlbumPhotos",eventId,args}))})}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 function getCurrentLocation(...args){if(!window.ReactNativeWebView){throw new Error("This getCurrentLocation is not available in browser environment")}const eventId=createEventId();const emitters=[];const unsubscribe=()=>{for(const emitter of emitters){emitter()}};return new Promise((resolve,reject)=>{emitters.push(window.__BEDROCK_NATIVE_EMITTER.on(`getCurrentLocation/resolve/${eventId}`,args=>{unsubscribe();resolve(args)}));emitters.push(window.__BEDROCK_NATIVE_EMITTER.on(`getCurrentLocation/reject/${eventId}`,error=>{unsubscribe();reject(deserializeError(error))}));window.ReactNativeWebView.postMessage(JSON.stringify({type:"method",functionName:"getCurrentLocation",eventId,args}))})}export function openCamera(...args){if(!window.ReactNativeWebView){throw new Error("This openCamera is not available in browser environment")}const eventId=createEventId();const emitters=[];const unsubscribe=()=>{for(const emitter of emitters){emitter()}};return new Promise((resolve,reject)=>{emitters.push(window.__BEDROCK_NATIVE_EMITTER.on(`openCamera/resolve/${eventId}`,args=>{unsubscribe();resolve(args)}));emitters.push(window.__BEDROCK_NATIVE_EMITTER.on(`openCamera/reject/${eventId}`,error=>{unsubscribe();reject(deserializeError(error))}));window.ReactNativeWebView.postMessage(JSON.stringify({type:"method",functionName:"openCamera",eventId,args}))})}export function appLogin(...args){if(!window.ReactNativeWebView){throw new Error("This appLogin is not available in browser environment")}const eventId=createEventId();const emitters=[];const unsubscribe=()=>{for(const emitter of emitters){emitter()}};return new Promise((resolve,reject)=>{emitters.push(window.__BEDROCK_NATIVE_EMITTER.on(`appLogin/resolve/${eventId}`,args=>{unsubscribe();resolve(args)}));emitters.push(window.__BEDROCK_NATIVE_EMITTER.on(`appLogin/reject/${eventId}`,error=>{unsubscribe();reject(deserializeError(error))}));window.ReactNativeWebView.postMessage(JSON.stringify({type:"method",functionName:"appLogin",eventId,args}))})}export function checkoutPayment(...args){if(!window.ReactNativeWebView){throw new Error("This checkoutPayment is not available in browser environment")}const eventId=createEventId();const emitters=[];const unsubscribe=()=>{for(const emitter of emitters){emitter()}};return new Promise((resolve,reject)=>{emitters.push(window.__BEDROCK_NATIVE_EMITTER.on(`checkoutPayment/resolve/${eventId}`,args=>{unsubscribe();resolve(args)}));emitters.push(window.__BEDROCK_NATIVE_EMITTER.on(`checkoutPayment/reject/${eventId}`,error=>{unsubscribe();reject(deserializeError(error))}));window.ReactNativeWebView.postMessage(JSON.stringify({type:"method",functionName:"checkoutPayment",eventId,args}))})}export function executePayment(...args){if(!window.ReactNativeWebView){throw new Error("This executePayment is not available in browser environment")}const eventId=createEventId();const emitters=[];const unsubscribe=()=>{for(const emitter of emitters){emitter()}};return new Promise((resolve,reject)=>{emitters.push(window.__BEDROCK_NATIVE_EMITTER.on(`executePayment/resolve/${eventId}`,args=>{unsubscribe();resolve(args)}));emitters.push(window.__BEDROCK_NATIVE_EMITTER.on(`executePayment/reject/${eventId}`,error=>{unsubscribe();reject(deserializeError(error))}));window.ReactNativeWebView.postMessage(JSON.stringify({type:"method",functionName:"executePayment",eventId,args}))})}export function getOperationalEnvironment(){if(!window.ReactNativeWebView){throw new Error("This getOperationalEnvironment is not available in browser environment")}if("getOperationalEnvironment"in window.__CONSTANT_HANDLER_MAP){return window.__CONSTANT_HANDLER_MAP["getOperationalEnvironment"]}throw new Error("getOperationalEnvironment is not a constant handler")}export function getTossAppVersion(){if(!window.ReactNativeWebView){throw new Error("This getTossAppVersion is not available in browser environment")}if("getTossAppVersion"in window.__CONSTANT_HANDLER_MAP){return window.__CONSTANT_HANDLER_MAP["getTossAppVersion"]}throw new Error("getTossAppVersion is not a constant handler")}export function getDeviceId(){if(!window.ReactNativeWebView){throw new Error("This getDeviceId is not available in browser environment")}if("getDeviceId"in window.__CONSTANT_HANDLER_MAP){return window.__CONSTANT_HANDLER_MAP["getDeviceId"]}throw new Error("getDeviceId is not a constant handler")}export function startUpdateLocation({onEvent,onError,options}){if(!window.ReactNativeWebView){onError(new Error("This startUpdateLocation is not available in browser environment"));return()=>{}}const eventId=createEventId();const removes=[window.__BEDROCK_NATIVE_EMITTER.on(`startUpdateLocation/onEvent/${eventId}`,response=>{onEvent(response)}),window.__BEDROCK_NATIVE_EMITTER.on(`startUpdateLocation/onError/${eventId}`,error=>{onError(deserializeError(error))})];window.ReactNativeWebView.postMessage(JSON.stringify({type:"addEventListener",functionName:"startUpdateLocation",eventId,args:options}));return()=>{window.ReactNativeWebView.postMessage(JSON.stringify({type:"removeEventListener",functionName:"startUpdateLocation",eventId}));for(const remove of removes){remove()}}}
+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 getOperationalEnvironment=createConstantBridge("getOperationalEnvironment");export var getTossAppVersion=createConstantBridge("getTossAppVersion");export var getDeviceId=createConstantBridge("getDeviceId");export var startUpdateLocation=createEventBridge("startUpdateLocation");

package/dist-web/checkoutPayment.d.ts

@@ -2,124 +2,74 @@
  * @public
  * @category 토스페이
  * @name CheckoutPaymentOptions
- * @description 토스페이 결제를 생성할 때 필요한 옵션 객체예요.
- * @property {string} orderNo 가맹점의 상품 주문번호예요.
- * @property {string} productDesc 상품 설명이에요.
- * @property {number} amount 결제 금액이에요.
- * @property {number} amountTaxFree 결제 금액 중 비과세 금액이에요.
- * @property {number} [amountTaxable] 결제 금액 중 과세 금액이에요.
- * @property {number} [amountVat] 결제 금액 중 부가세예요.
- * @property {number} [amountServiceFee] 결제 금액 중 봉사료예요.
- * @property {'TOSS_MONEY' | 'CARD' | null} [enablePayMethods] 결제수단 구분 변수예요. (TOSS_MONEY: 토스머니만, CARD: 카드만, null: 기본 결제수단)
- * @property {boolean} [cashReceipt] 현금영수증 발급 가능 여부예요.
- * @property {'CULTURE' | 'GENERAL' | 'PUBLIC_TP'} [cashReceiptTradeOption] 현금영수증 발급 타입이에요. (CULTURE: 문화비, GENERAL: 일반, PUBLIC_TP: 교통비)
- * @property {'USE' | 'NO_USE'} [installment] 할부를 사용할 지 말 지 여부에요. (USE: 사용, NO_USE: 할부 미사용)
+ * @description 토스페이 결제창을 띄울 때 필요한 옵션이에요.
+ * @property {string} payToken 결제 토큰이에요.
  */
 export interface CheckoutPaymentOptions {
 	/**
-	 * 가맹점의 상품 주문번호에요.
+	 * 결제 토큰이에요.
 	 */
-	orderNo: string;
-	/**
-	 * 상품 설명이에요.
-	 */
-	productDesc: string;
-	/**
-	 * 결제 금액이예요.
-	 */
-	amount: number;
-	/**
-	 * 결제 금액 중 비과세 금액이에요.
-	 */
-	amountTaxFree: number;
-	/**
-	 * 결제 금액 중 과세 금액이에요.
-	 */
-	amountTaxable?: number;
-	/**
-	 * 결제 금액 중 부가세예요.
-	 */
-	amountVat?: number;
-	/**
-	 * 결제 금액 중 봉사료예요.
-	 */
-	amountServiceFee?: number;
-	/**
-	 * 결제수단 구분 변수예요.
-	 *
-	 * - 'TOSS_MONEY': 결제수단 중 토스머니만 노출
-	 * - 'CARD': 결제수단 중 카드만 노출
-	 * - null: 상점에 설정된 기본 결제 수단 노출
-	 */
-	enablePayMethods?: "TOSS_MONEY" | "CARD" | null;
-	/**
-	 * 현금영수증 발급 가능 여부예요.
-	 */
-	cashReceipt?: boolean;
+	payToken: string;
+}
+/**
+ * @public
+ * @category 토스페이
+ * @name CheckoutPaymentResult
+ * @description 토스페이 결제창에서 사용자가 인증에 성공했는지 여부예요.
+ * @property {boolean} success 인증이 성공했는지 여부예요.
+ * @property {string} [reason] 인증이 실패했을 경우의 이유예요.
+ */
+export interface CheckoutPaymentResult {
 	/**
-	 * 현금영수증 발급 타입이에요.
-	 *
-	 * - 'CULTURE': 문화비
-	 * - 'GENERAL': 일반(기본값)
-	 * - 'PUBLIC_TP': 교통비
+	 * 인증이 성공했는지 여부예요.
 	 */
-	cashReceiptTradeOption?: "CULTURE" | "GENERAL" | "PUBLIC_TP";
+	success: boolean;
 	/**
-	 * 할부를 사용할 지 말 지 여부에요.
-	 *
-	 * - 'USE': 사용(기본값)
-	 * - 'NO_USE': 할부 미사용
+	 * 인증이 실패했을 경우의 이유예요.
 	 */
-	installment?: "USE" | "NO_USE";
+	reason?: string;
 }
 /**
  * @public
  * @category 토스페이
  * @name checkoutPayment
- * @description 토스페이 결제를 생성하는 함수예요.
+ * @description 토스페이 결제창을 띄우고, 사용자 인증을 수행해요. 인증이 완료되면 성공 여부를 반환해요.
+ *
+ * 이 함수는 결제창을 통해 사용자 인증만 해요. 실제 결제 처리는 인증 성공 후 서버에서 별도로 해야 해요.
  *
- * @param {CheckoutPaymentOptions} options 결제를 생성할 때 필요한 옵션 객체예요.
- * @param {string} options.orderNo 가맹점의 상품 주문번호예요.
- * @param {string} options.productDesc 상품 설명이에요.
- * @param {number} options.amount 결제 금액이에요.
- * @param {number} options.amountTaxFree 결제 금액 중 비과세 금액이에요.
- * @param {number} [options.amountTaxable] 결제 금액 중 과세 금액이에요.
- * @param {number} [options.amountVat] 결제 금액 중 부가세예요.
- * @param {number} [options.amountServiceFee] 결제 금액 중 봉사료예요.
- * @param {'TOSS_MONEY' | 'CARD' | null} [options.enablePayMethods] 결제수단 구분 변수예요. (TOSS_MONEY: 토스머니만, CARD: 카드만, null: 기본 결제수단)
- * @param {boolean} [options.cashReceipt] 현금영수증 발급 가능 여부예요.
- * @param {'CULTURE' | 'GENERAL' | 'PUBLIC_TP'} [options.cashReceiptTradeOption] 현금영수증 발급 타입이에요. (CULTURE: 문화비, GENERAL: 일반, PUBLIC_TP: 교통비)
- * @param {'USE' | 'NO_USE'} [options.installment] 할부를 사용할 지 말 지 여부에요. (USE: 사용, NO_USE: 할부 미사용)
- * @returns {Promise<{ payToken: string }>} 결제 인증 후 발급된 결제 토큰 값이 포함된 객체를 반환해요.
+ * @param {CheckoutPaymentOptions} options 결제창을 띄울 때 필요한 옵션이에요.
+ * @returns {Promise<CheckoutPaymentResult>} 인증 성공 여부를 포함한 결과를 반환해요.
  *
  * @example
- * ### 결제 생성하기
+ *
+ * ### 토스페이 결제창 띄우고 인증 처리하기
  *
  * ```tsx
  * import { TossPay } from '@apps-in-toss/web-framework';
  *
  * async function handlePayment() {
  *   try {
- *     const result = await TossPay.checkoutPayment({
- *       orderNo: 'ORDER_12345',
- *       productDesc: '티셔츠',
- *       amount: 15000,
- *       amountTaxFree: 0,
- *       amountTaxable: 13636,
- *       amountVat: 1364,
- *       enablePayMethods: 'CARD',
- *       installment: 'USE'
- *     });
+ *     // 실제 구현 시 결제 생성 역할을 하는 API 엔드포인트로 대체해주세요.
+ *     const { payToken } = await fetch('/my-api/payment/create').then(res => res.json());
+ *
+ *     const { success, reason } = await TossPay.checkoutPayment({ payToken });
  *
- *     console.log('결제 토큰:', result.payToken);
+ *     if (success) {
+ *       // 실제 구현 시 결제를 실행하는 API 엔드포인트로 대체해주세요.
+ *       await fetch('/my-api/payment/execute', {
+ *         method: 'POST',
+ *         body: JSON.stringify({ payToken }),
+ *         headers: { 'Content-Type': 'application/json' },
+ *       });
+ *     } else {
+ *       console.log('인증 실패:', reason);
+ *     }
  *   } catch (error) {
- *     console.error('결제 생성에 실패했어요:', error);
+ *     console.error('결제 인증 중 오류가 발생했어요:', error);
  *   }
  * }
  * ```
  */
-export declare function checkoutPayment(options: CheckoutPaymentOptions): Promise<{
-	payToken: string;
-}>;
+export declare function checkoutPayment(options: CheckoutPaymentOptions): Promise<CheckoutPaymentResult>;
 
 export {};

package/dist-web/eventLog.d.ts

@@ -0,0 +1,43 @@
+export type Primitive = string | number | boolean | null | undefined | symbol;
+/**
+ * @category 로깅
+ * @kind function
+ * @name eventLog
+ * @description
+ * 이벤트 로그를 기록하는 함수예요.
+ *
+ * 이 함수는 앱 내에서 발생하는 다양한 이벤트를 로깅하는 데 사용돼요. 디버깅, 정보 제공, 경고, 오류 등 다양한 유형의 로그를 기록할 수 있어요. 샌드박스 환경에서는 콘솔에 로그가 출력되고, 실제 환경에서는 로그 시스템에 기록돼요.
+ *
+ * @param {Object} params 로그 기록에 필요한 매개변수 객체예요.
+ * @param {string} params.log_name 로그의 이름이에요.
+ * @param {'debug' | 'info' | 'warn' | 'error'} params.log_type 로그의 유형이에요.
+ * @param {Record<string, Primitive>} params.params 로그에 포함할 추가 매개변수 객체예요.
+ *
+ * @returns {Promise<void>} 로그 기록이 완료되면 해결되는 Promise예요.
+ *
+ * @example
+ * ### 이벤트 로그 기록하기
+ *
+ * ```tsx
+ * import { eventLog } from '@apps-in-toss/web-framework';
+ *
+ * function logUserAction() {
+ *   eventLog({
+ *     log_name: 'user_action',
+ *     log_type: 'info',
+ *     params: {
+ *       action: 'button_click',
+ *       screen: 'main',
+ *       userId: 12345
+ *     }
+ *   });
+ * }
+ * ```
+ */
+export declare function eventLog(params: {
+	log_name: string;
+	log_type: "debug" | "info" | "warn" | "error";
+	params: Record<string, Primitive>;
+}): Promise<void>;
+
+export {};

package/dist-web/getTossShareLink.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @public
+ * @category 공유
+ * @kind function
+ * @name getTossShareLink
+ * @description
+ * `getTossShareLink` 함수는 사용자가 지정한 경로를 토스 앱에서 열 수 있는 공유 링크를 반환해요.
+ * 이 링크를 다른 사람과 공유하면 토스 앱이 실행되면서 지정한 경로로 진입해요. 토스앱이 없는 사람은 iOS 일 때는 앱스토어로 이동하고, Android 일 때는 플레이스토어로 이동해요.
+ *
+ * 경로는 토스 앱 내부 특정 화면을 나타내는 딥링크(deep link) 형식이어야 해요.
+ * 예를 들어 `intoss://<앱 이름>`이나 `intoss://<앱 이름>/about?name=test`처럼 작성해요.
+ *
+ * 이 함수를 사용하면 `deep_link_value`를 포함한 완성된 공유 링크를 만들 수 있어요.
+ *
+ * @param path - 딥링크로 열고 싶은 경로예요. `intoss://`로 시작하는 문자열이어야 해요.
+ * @returns {Promise<string>} `deep_link_value`가 포함된 토스 공유 링크를 반환해요.
+ *
+ * @example
+ * ```tsx
+ * import { share } from '@apps-in-toss/web-framework';
+ * import { getTossShareLink } from '@apps-in-toss/web-framework';
+ *
+ * // '/' 경로를 딥링크로 포함한 토스 공유 링크를 생성해요.
+ * const tossLink = await getTossShareLink('intoss://my-app');
+ *
+ * // 생성한 링크를 메시지로 공유해요.
+ * await share({ message: tossLink });
+ * ```
+ */
+export declare function getTossShareLink(path: string): Promise<string>;
+
+export {};