@apps-in-toss/web-bridge 2.4.6 → 2.5.0

package/dist/bridge.d.ts

@@ -20,6 +20,7 @@ export * from './eventLog';
 export * from './getTossShareLink';
 export * from './setDeviceOrientation';
 export * from './checkoutPayment';
+export * from './requestTossPayPaysBilling';
 export * from './saveBase64Data';
 export * from './appsInTossSignTossCert';
 export * from './getGameCenterGameProfile';

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 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 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/index.cjs

@@ -44,6 +44,7 @@ __export(index_exports, {
   loadFullScreenAd: () => loadFullScreenAd,
   openCamera: () => openCamera,
   partner: () => partner,
+  requestNotificationAgreement: () => requestNotificationAgreement,
   requestReview: () => requestReview,
   setClipboardText: () => setClipboardText,
   showFullScreenAd: () => showFullScreenAd,
@@ -1479,6 +1480,9 @@ var TossAds = {
   initialize: Object.assign(initialize, {
     isSupported: fetchTossAd.isSupported
   }),
+  /**
+   * @deprecated attach는 더 이상 권장되지 않습니다. attachBanner를 사용해주세요.
+   */
   attach: Object.assign(attach, {
     isSupported: fetchTossAd.isSupported
   }),
@@ -1503,6 +1507,21 @@ var requestReview = Object.assign(createAsyncBridge("requestReview"), {
   isSupported: createConstantBridge("requestReview_isSupported")
 });
 
+// src/requestNotificationAgreement.ts
+function requestNotificationAgreement(params) {
+  const { options, onEvent, onError } = params;
+  const unregisterCallbacks = createEventBridge("requestNotificationAgreement")({
+    options,
+    onEvent: (result) => {
+      onEvent(result);
+    },
+    onError: (error) => {
+      onError(error);
+    }
+  });
+  return unregisterCallbacks;
+}
+
 // src/index.ts
 __reExport(index_exports, require("@apps-in-toss/types"), module.exports);
 // Annotate the CommonJS export names for ESM import in node:
@@ -1529,6 +1548,7 @@ __reExport(index_exports, require("@apps-in-toss/types"), module.exports);
   loadFullScreenAd,
   openCamera,
   partner,
+  requestNotificationAgreement,
   requestReview,
   setClipboardText,
   showFullScreenAd,

package/dist/index.d.cts

@@ -1033,6 +1033,9 @@ declare const TossAds: {
     initialize: typeof initialize & {
         isSupported: () => boolean;
     };
+    /**
+     * @deprecated attach는 더 이상 권장되지 않습니다. attachBanner를 사용해주세요.
+     */
     attach: typeof attach & {
         isSupported: () => boolean;
     };
@@ -1064,4 +1067,32 @@ declare const requestReview: (() => Promise<void>) & {
     isSupported: () => boolean;
 };
 
-export { type AddAccessoryButtonOptions, type AppsInTossEvent, type AppsInTossGlobals, type CompletedOrRefundedOrdersResult, type ConsumableProductListItem, type CreateSubscriptionPurchaseOrderOptions, GoogleAdMob, type GraniteEvent, IAP, type IapCreateOneTimePurchaseOrderOptions, type IapProductListItem, type IapSubscriptionInfoResponse, type IapSubscriptionInfoResult, type NonConsumableProductListItem, SafeAreaInsets$1 as SafeAreaInsets, Storage, type SubscriptionProductListItem, type TdsEvent, TossAds, type AttachBannerOptions as TossAdsAttachBannerOptions, type AttachBannerResult as TossAdsAttachBannerResult, type AttachOptions as TossAdsAttachOptions, type BannerSlotCallbacks as TossAdsBannerSlotCallbacks, type BannerSlotErrorPayload as TossAdsBannerSlotErrorPayload, type BannerSlotEventPayload as TossAdsBannerSlotEventPayload, type InitializeOptions as TossAdsInitializeOptions, appsInTossEvent, env, fetchAlbumPhotos, fetchContacts, getAppsInTossGlobals, getClipboardText, getCurrentLocation, getSafeAreaInsets, getServerTime, graniteEvent, isMinVersionSupported, loadFullScreenAd, openCamera, partner, requestReview, setClipboardText, showFullScreenAd, startUpdateLocation, tdsEvent };
+/**
+ * @public
+ * @category 알림
+ * @name NotificationAgreementResult
+ */
+type NotificationAgreementResult = 'newAgreement' | 'alreadyAgreed' | 'agreementRejected';
+/**
+ * @public
+ * @category 알림
+ * @name RequestNotificationAgreementOptions
+ */
+interface RequestNotificationAgreementOptions {
+    options: {
+        templateCode: string;
+    };
+    onEvent: (result: {
+        type: NotificationAgreementResult;
+    }) => void;
+    onError: (error: unknown) => void | Promise<void>;
+}
+/**
+ * @public
+ * @category 알림
+ * @name requestNotificationAgreement
+ * @description 푸시 알림 동의 UI를 요청해요.
+ */
+declare function requestNotificationAgreement(params: RequestNotificationAgreementOptions): () => void;
+
+export { type AddAccessoryButtonOptions, type AppsInTossEvent, type AppsInTossGlobals, type CompletedOrRefundedOrdersResult, type ConsumableProductListItem, type CreateSubscriptionPurchaseOrderOptions, GoogleAdMob, type GraniteEvent, IAP, type IapCreateOneTimePurchaseOrderOptions, type IapProductListItem, type IapSubscriptionInfoResponse, type IapSubscriptionInfoResult, type NonConsumableProductListItem, type NotificationAgreementResult, type RequestNotificationAgreementOptions, SafeAreaInsets$1 as SafeAreaInsets, Storage, type SubscriptionProductListItem, type TdsEvent, TossAds, type AttachBannerOptions as TossAdsAttachBannerOptions, type AttachBannerResult as TossAdsAttachBannerResult, type AttachOptions as TossAdsAttachOptions, type BannerSlotCallbacks as TossAdsBannerSlotCallbacks, type BannerSlotErrorPayload as TossAdsBannerSlotErrorPayload, type BannerSlotEventPayload as TossAdsBannerSlotEventPayload, type InitializeOptions as TossAdsInitializeOptions, appsInTossEvent, env, fetchAlbumPhotos, fetchContacts, getAppsInTossGlobals, getClipboardText, getCurrentLocation, getSafeAreaInsets, getServerTime, graniteEvent, isMinVersionSupported, loadFullScreenAd, openCamera, partner, requestNotificationAgreement, requestReview, setClipboardText, showFullScreenAd, startUpdateLocation, tdsEvent };

package/dist/index.d.ts

@@ -1033,6 +1033,9 @@ declare const TossAds: {
     initialize: typeof initialize & {
         isSupported: () => boolean;
     };
+    /**
+     * @deprecated attach는 더 이상 권장되지 않습니다. attachBanner를 사용해주세요.
+     */
     attach: typeof attach & {
         isSupported: () => boolean;
     };
@@ -1064,4 +1067,32 @@ declare const requestReview: (() => Promise<void>) & {
     isSupported: () => boolean;
 };
 
-export { type AddAccessoryButtonOptions, type AppsInTossEvent, type AppsInTossGlobals, type CompletedOrRefundedOrdersResult, type ConsumableProductListItem, type CreateSubscriptionPurchaseOrderOptions, GoogleAdMob, type GraniteEvent, IAP, type IapCreateOneTimePurchaseOrderOptions, type IapProductListItem, type IapSubscriptionInfoResponse, type IapSubscriptionInfoResult, type NonConsumableProductListItem, SafeAreaInsets$1 as SafeAreaInsets, Storage, type SubscriptionProductListItem, type TdsEvent, TossAds, type AttachBannerOptions as TossAdsAttachBannerOptions, type AttachBannerResult as TossAdsAttachBannerResult, type AttachOptions as TossAdsAttachOptions, type BannerSlotCallbacks as TossAdsBannerSlotCallbacks, type BannerSlotErrorPayload as TossAdsBannerSlotErrorPayload, type BannerSlotEventPayload as TossAdsBannerSlotEventPayload, type InitializeOptions as TossAdsInitializeOptions, appsInTossEvent, env, fetchAlbumPhotos, fetchContacts, getAppsInTossGlobals, getClipboardText, getCurrentLocation, getSafeAreaInsets, getServerTime, graniteEvent, isMinVersionSupported, loadFullScreenAd, openCamera, partner, requestReview, setClipboardText, showFullScreenAd, startUpdateLocation, tdsEvent };
+/**
+ * @public
+ * @category 알림
+ * @name NotificationAgreementResult
+ */
+type NotificationAgreementResult = 'newAgreement' | 'alreadyAgreed' | 'agreementRejected';
+/**
+ * @public
+ * @category 알림
+ * @name RequestNotificationAgreementOptions
+ */
+interface RequestNotificationAgreementOptions {
+    options: {
+        templateCode: string;
+    };
+    onEvent: (result: {
+        type: NotificationAgreementResult;
+    }) => void;
+    onError: (error: unknown) => void | Promise<void>;
+}
+/**
+ * @public
+ * @category 알림
+ * @name requestNotificationAgreement
+ * @description 푸시 알림 동의 UI를 요청해요.
+ */
+declare function requestNotificationAgreement(params: RequestNotificationAgreementOptions): () => void;
+
+export { type AddAccessoryButtonOptions, type AppsInTossEvent, type AppsInTossGlobals, type CompletedOrRefundedOrdersResult, type ConsumableProductListItem, type CreateSubscriptionPurchaseOrderOptions, GoogleAdMob, type GraniteEvent, IAP, type IapCreateOneTimePurchaseOrderOptions, type IapProductListItem, type IapSubscriptionInfoResponse, type IapSubscriptionInfoResult, type NonConsumableProductListItem, type NotificationAgreementResult, type RequestNotificationAgreementOptions, SafeAreaInsets$1 as SafeAreaInsets, Storage, type SubscriptionProductListItem, type TdsEvent, TossAds, type AttachBannerOptions as TossAdsAttachBannerOptions, type AttachBannerResult as TossAdsAttachBannerResult, type AttachOptions as TossAdsAttachOptions, type BannerSlotCallbacks as TossAdsBannerSlotCallbacks, type BannerSlotErrorPayload as TossAdsBannerSlotErrorPayload, type BannerSlotEventPayload as TossAdsBannerSlotEventPayload, type InitializeOptions as TossAdsInitializeOptions, appsInTossEvent, env, fetchAlbumPhotos, fetchContacts, getAppsInTossGlobals, getClipboardText, getCurrentLocation, getSafeAreaInsets, getServerTime, graniteEvent, isMinVersionSupported, loadFullScreenAd, openCamera, partner, requestNotificationAgreement, requestReview, setClipboardText, showFullScreenAd, startUpdateLocation, tdsEvent };

package/dist/index.js

@@ -1431,6 +1431,9 @@ var TossAds = {
   initialize: Object.assign(initialize, {
     isSupported: fetchTossAd.isSupported
   }),
+  /**
+   * @deprecated attach는 더 이상 권장되지 않습니다. attachBanner를 사용해주세요.
+   */
   attach: Object.assign(attach, {
     isSupported: fetchTossAd.isSupported
   }),
@@ -1455,6 +1458,21 @@ var requestReview = Object.assign(createAsyncBridge("requestReview"), {
   isSupported: createConstantBridge("requestReview_isSupported")
 });
 
+// src/requestNotificationAgreement.ts
+function requestNotificationAgreement(params) {
+  const { options, onEvent, onError } = params;
+  const unregisterCallbacks = createEventBridge("requestNotificationAgreement")({
+    options,
+    onEvent: (result) => {
+      onEvent(result);
+    },
+    onError: (error) => {
+      onError(error);
+    }
+  });
+  return unregisterCallbacks;
+}
+
 // src/index.ts
 export * from "@apps-in-toss/types";
 export {
@@ -1480,6 +1498,7 @@ export {
   loadFullScreenAd,
   openCamera,
   partner,
+  requestNotificationAgreement,
   requestReview,
   setClipboardText,
   showFullScreenAd,

package/dist/requestTossPayPaysBilling.d.ts

@@ -0,0 +1,81 @@
+/**
+ * @public
+ * @category 토스페이
+ * @name RequestTossPayPaysBillingOptions
+ * @description 토스페이 정기결제창을 띄울 때 필요한 옵션이에요.
+ * @property {string} wrappedToken 정기결제 래핑 토큰이에요.
+ */
+export interface RequestTossPayPaysBillingOptions {
+	/**
+	 * 정기결제 래핑 토큰이에요.
+	 */
+	wrappedToken: string;
+}
+/**
+ * @public
+ * @category 토스페이
+ * @name RequestTossPayPaysBillingResult
+ * @description 토스페이 정기결제창에서 사용자가 인증에 성공했는지 여부예요.
+ * @property {boolean} success 인증이 성공했는지 여부예요.
+ * @property {string} [reason] 인증이 실패했을 경우의 이유예요.
+ */
+export interface RequestTossPayPaysBillingResult {
+	/**
+	 * 인증이 성공했는지 여부예요.
+	 */
+	success: boolean;
+	/**
+	 * 인증이 실패했을 경우의 이유예요.
+	 */
+	reason?: string;
+}
+/**
+ * @public
+ * @category 토스페이
+ * @name requestTossPayPaysBilling
+ * @description 토스페이 정기결제창을 띄우고, 사용자 인증을 수행해요. 인증이 완료되면 성공 여부를 반환해요.
+ *
+ * 이 함수는 결제창을 통해 사용자 인증만 해요. 실제 결제 처리는 인증 성공 후 서버에서 별도로 해야 해요.
+ *
+ * @property {() => boolean} isSupported 현재 앱 버전이 이 기능을 지원하는지 확인하는 함수예요.
+ * @param {RequestTossPayPaysBillingOptions} options 정기결제창을 띄울 때 필요한 옵션이에요.
+ * @returns {Promise<RequestTossPayPaysBillingResult>} 인증 성공 여부를 포함한 결과를 반환해요.
+ *
+ * @example
+ *
+ * ### 토스페이 정기결제창 띄우고 인증 처리하기
+ *
+ * ```tsx
+ * import { TossPay } from '@apps-in-toss/web-framework';
+ *
+ * async function handleBilling() {
+ *   try {
+ *     // 실제 구현 시 정기결제 생성 역할을 하는 API 엔드포인트로 대체해주세요.
+ *     const { wrappedToken } = await fetch('/my-api/billing/create').then(res => res.json());
+ *
+ *     const { success, reason } = await TossPay.requestTossPayPaysBilling({ wrappedToken });
+ *
+ *     if (success) {
+ *       // 실제 구현 시 정기결제를 실행하는 API 엔드포인트로 대체해주세요.
+ *       await fetch('/my-api/billing/execute', {
+ *         method: 'POST',
+ *         body: JSON.stringify({ wrappedToken }),
+ *         headers: { 'Content-Type': 'application/json' },
+ *       });
+ *     } else {
+ *       console.log('인증 실패:', reason);
+ *     }
+ *   } catch (error) {
+ *     console.error('정기결제 인증 중 오류가 발생했어요:', error);
+ *   }
+ * }
+ * ```
+ */
+export declare function requestTossPayPaysBilling(options: {
+	params: RequestTossPayPaysBillingOptions;
+}): Promise<RequestTossPayPaysBillingResult | undefined>;
+export declare namespace requestTossPayPaysBilling {
+	var isSupported: () => boolean;
+}
+
+export {};

package/package.json

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