@apps-in-toss/native-modules 2.1.0 → 2.2.0

package/dist/index.cjs

@@ -77,7 +77,7 @@ __export(index_exports, {
 });
 module.exports = __toCommonJS(index_exports);
 
-// src/MiniAppModule.brick.ts
+// src/MiniAppModule/postMessage.ts
 var import_brick_module = require("brick-module");
 var MiniAppModule = import_brick_module.BrickModule.get("MiniAppModule");
 function safePostMessage(method, params) {
@@ -94,13 +94,13 @@ var import_react_native4 = require("@granite-js/react-native");
 var import_types = require("@apps-in-toss/types");
 var import_react_native = require("@granite-js/react-native");
 
-// src/TossCoreModule.brick.ts
+// src/BedrockModule/commonModule.ts
 var import_brick_module2 = require("brick-module");
-var TossCoreModule = import_brick_module2.BrickModule.get("TossCoreModule");
+var CommonModule = import_brick_module2.BrickModule.get("CommonModule");
 
-// src/CommonModule.brick.ts
+// src/TossCoreModule/instance.ts
 var import_brick_module3 = require("brick-module");
-var CommonModule = import_brick_module3.BrickModule.get("CommonModule");
+var TossCoreModule = import_brick_module3.BrickModule.get("TossCoreModule");
 
 // src/MiniAppModule/native-modules/permissions/openPermissionDialog.ts
 function openPermissionDialog(permission) {
@@ -784,6 +784,16 @@ async function completeProductGrant(params) {
   }
   return safePostMessage("completeProductGrant", params.params);
 }
+async function getSubscriptionInfo(params) {
+  const isSupported = isMinVersionSupported({
+    android: "5.253.0",
+    ios: "5.250.0"
+  });
+  if (!isSupported) {
+    return;
+  }
+  return safePostMessage("getSubscriptionInfo", params);
+}
 function createSubscriptionPurchaseOrder(params) {
   const isSupported = isMinVersionSupported({
     android: "5.248.0",
@@ -818,7 +828,8 @@ var IAP = {
   getProductItemList,
   getPendingOrders,
   getCompletedOrRefundedOrders,
-  completeProductGrant
+  completeProductGrant,
+  getSubscriptionInfo
 };
 
 // src/MiniAppModule/native-modules/saveBase64Data.ts

package/dist/index.d.cts

@@ -741,6 +741,57 @@ declare function completeProductGrant(params: {
         orderId: string;
     };
 }): Promise<boolean | undefined>;
+/**
+ * @public
+ * @category 인앱결제
+ * @name IapSubscriptionInfoResult
+ * @description 구독 주문의 현재 상태 정보를 담은 객체예요.
+ * @property {number} catalogId 구독 상품의 식별자예요.
+ * @property {"ACTIVE" |"EXPIRED"|"IN_GRACE_PERIOD"|"ON_HOLD"|"PAUSED"|"REVOKED"} status 구독 상태를 나타내는 값이에요.
+ * @property {string | null} expiresAt 구독 만료 예정 시각이에요. 만료 정보가 없으면 `null`이에요.
+ * @property {boolean} isAutoRenew 구독 자동 갱신 여부예요.
+ * @property {string | null} gracePeriodExpiresAt 결제 유예 기간 만료 시각이에요. 유예 기간이 없으면 `null`이에요.
+ * @property {boolean} isAccessible 현재 구독 상품을 이용할 수 있는지 여부예요.
+ */
+interface IapSubscriptionInfoResult {
+    catalogId: number;
+    status: 'ACTIVE' | 'EXPIRED' | 'IN_GRACE_PERIOD' | 'ON_HOLD' | 'PAUSED' | 'REVOKED';
+    expiresAt: string | null;
+    isAutoRenew: boolean;
+    gracePeriodExpiresAt: string | null;
+    isAccessible: boolean;
+}
+/**
+ * @public
+ * @category 인앱결제
+ * @name getSubscriptionInfo
+ * @description 구독 주문의 현재 상태 정보를 가져와요.
+ * @param {{ params: { orderId: string } }} params 조회할 구독 주문 정보를 담은 객체예요.
+ * @param {string} params.orderId 주문의 고유 ID예요.
+ * @returns {Promise<{ subscription: IapSubscriptionInfoResult } | undefined>} 구독 상태 정보를 담은 객체를 반환해요. 앱 버전이 최소 지원 버전(안드로이드 5.253.0, iOS 5.250.0)보다 낮으면 `undefined`를 반환해요.
+ *
+ * @example
+ * ### 주문 ID로 구독 상태 조회하기
+ * ```typescript
+ * import { IAP } from '@apps-in-toss/framework';
+ *
+ * async function fetchSubscriptionInfo(orderId: string) {
+ *   try {
+ *     const response = await IAP.getSubscriptionInfo({ params: { orderId } });
+ *     return response?.subscription;
+ *   } catch (error) {
+ *     console.error(error);
+ *   }
+ * }
+ * ```
+ */
+declare function getSubscriptionInfo(params: {
+    params: {
+        orderId: string;
+    };
+}): Promise<{
+    subscription: IapSubscriptionInfoResult;
+} | undefined>;
 /**
  * @public
  * @category 인앱결제
@@ -835,6 +886,7 @@ declare function createSubscriptionPurchaseOrder(params: CreateSubscriptionPurch
  * @property {typeof getPendingOrders} [getPendingOrders] 대기 중인 주문 목록을 가져와요. 자세한 내용은 [getPendingOrders](https://developers-apps-in-toss.toss.im/bedrock/reference/framework/%EC%9D%B8%EC%95%B1%20%EA%B2%B0%EC%A0%9C/getPendingOrders.htm) 문서를 참고하세요.
  * @property {typeof getCompletedOrRefundedOrders} [getCompletedOrRefundedOrders] 인앱결제로 구매하거나 환불한 주문 목록을 가져와요. 자세한 내용은 [getCompletedOrRefundedOrders](https://developers-apps-in-toss.toss.im/bedrock/reference/framework/%EC%9D%B8%EC%95%B1%20%EA%B2%B0%EC%A0%9C/getCompletedOrRefundedOrders.html) 문서를 참고하세요.
  * @property {typeof completeProductGrant} [completeProductGrant] 상품 지급 처리를 완료했다는 메시지를 앱에 전달해요. 자세한 내용은 [completeProductGrant](https://developers-apps-in-toss.toss.im/bedrock/reference/framework/%EC%9D%B8%EC%95%B1%20%EA%B2%B0%EC%A0%9C/completeProductGrant.html) 문서를 참고하세요.
+ * @property {typeof getSubscriptionInfo} [getSubscriptionInfo] 구독 주문의 현재 상태 정보를 가져와요.
  */
 declare const IAP: {
     createOneTimePurchaseOrder: typeof createOneTimePurchaseOrder;
@@ -843,6 +895,7 @@ declare const IAP: {
     getPendingOrders: typeof getPendingOrders;
     getCompletedOrRefundedOrders: typeof getCompletedOrRefundedOrders;
     completeProductGrant: typeof completeProductGrant;
+    getSubscriptionInfo: typeof getSubscriptionInfo;
 };
 
 interface SaveBase64DataParams {
@@ -1024,6 +1077,13 @@ interface AsyncMethodsMap {
     completeProductGrant: (params: {
         orderId: string;
     }) => Promise<boolean>;
+    getSubscriptionInfo: (params: {
+        params: {
+            orderId: string;
+        };
+    }) => Promise<{
+        subscription: IapSubscriptionInfoResult;
+    }>;
     eventLog: (params: {
         log_name: string;
         log_type: string;
@@ -3233,4 +3293,4 @@ declare const INTERNAL__module: {
     tossCoreEventLog: typeof tossCoreEventLog;
 };
 
-export { type AppsInTossSignTossCertParams, type CheckoutPaymentOptions, type CheckoutPaymentResult, type CompletedOrRefundedOrdersResult, type ConsumableProductListItem, type ContactsViralParams, type CreateSubscriptionPurchaseOrderOptions, type EventLogParams, type GameCenterGameProfileResponse, type GetUserKeyForGameErrorResponse, type GetUserKeyForGameResponse, type GetUserKeyForGameSuccessResponse, GoogleAdMob, type GrantPromotionRewardErrorResponse, type GrantPromotionRewardErrorResult, type GrantPromotionRewardForGameErrorResponse, type GrantPromotionRewardForGameErrorResult, type GrantPromotionRewardForGameResponse, type GrantPromotionRewardForGameSuccessResponse, type GrantPromotionRewardResponse, type GrantPromotionRewardSuccessResponse, type HapticFeedbackType, IAP, INTERNAL__appBridgeHandler, INTERNAL__module, type IapCreateOneTimePurchaseOrderOptions, type IapCreateOneTimePurchaseOrderResult, type IapCreateSubscriptionPurchaseOrderResult, type IapProductListItem, type NetworkStatus, type NonConsumableProductListItem, type Primitive, type SaveBase64DataParams, Storage, type SubmitGameCenterLeaderBoardScoreResponse, type SubscriptionProductListItem, TossPay, type UpdateLocationEventEmitter, appLogin, appsInTossEvent, appsInTossSignTossCert, checkoutPayment, closeView, contactsViral, eventLog, fetchAlbumPhotos, fetchContacts, generateHapticFeedback, getClipboardText, getCurrentLocation, getDeviceId, getGameCenterGameProfile, getGroupId, getIsTossLoginIntegratedService, getLocale, getNetworkStatus, getOperationalEnvironment, getPlatformOS, getSchemeUri, getServerTime, getTossAppVersion, getTossShareLink, getUserKeyForGame, grantPromotionReward, grantPromotionRewardForGame, iapCreateOneTimePurchaseOrder, isMinVersionSupported, onVisibilityChangedByTransparentServiceWeb, openCamera, openGameCenterLeaderboard, openURL, processProductGrant, requestOneTimePurchase, safePostMessage, safeSyncPostMessage, saveBase64Data, setClipboardText, setDeviceOrientation, setIosSwipeGestureEnabled, setScreenAwakeMode, setSecureScreen, share, shareWithScheme, startUpdateLocation, submitGameCenterLeaderBoardScore };
+export { type AppsInTossSignTossCertParams, type CheckoutPaymentOptions, type CheckoutPaymentResult, type CompletedOrRefundedOrdersResult, type ConsumableProductListItem, type ContactsViralParams, type CreateSubscriptionPurchaseOrderOptions, type EventLogParams, type GameCenterGameProfileResponse, type GetUserKeyForGameErrorResponse, type GetUserKeyForGameResponse, type GetUserKeyForGameSuccessResponse, GoogleAdMob, type GrantPromotionRewardErrorResponse, type GrantPromotionRewardErrorResult, type GrantPromotionRewardForGameErrorResponse, type GrantPromotionRewardForGameErrorResult, type GrantPromotionRewardForGameResponse, type GrantPromotionRewardForGameSuccessResponse, type GrantPromotionRewardResponse, type GrantPromotionRewardSuccessResponse, type HapticFeedbackType, IAP, INTERNAL__appBridgeHandler, INTERNAL__module, type IapCreateOneTimePurchaseOrderOptions, type IapCreateOneTimePurchaseOrderResult, type IapCreateSubscriptionPurchaseOrderResult, type IapProductListItem, type IapSubscriptionInfoResult, type NetworkStatus, type NonConsumableProductListItem, type Primitive, type SaveBase64DataParams, Storage, type SubmitGameCenterLeaderBoardScoreResponse, type SubscriptionProductListItem, TossPay, type UpdateLocationEventEmitter, appLogin, appsInTossEvent, appsInTossSignTossCert, checkoutPayment, closeView, contactsViral, eventLog, fetchAlbumPhotos, fetchContacts, generateHapticFeedback, getClipboardText, getCurrentLocation, getDeviceId, getGameCenterGameProfile, getGroupId, getIsTossLoginIntegratedService, getLocale, getNetworkStatus, getOperationalEnvironment, getPlatformOS, getSchemeUri, getServerTime, getTossAppVersion, getTossShareLink, getUserKeyForGame, grantPromotionReward, grantPromotionRewardForGame, iapCreateOneTimePurchaseOrder, isMinVersionSupported, onVisibilityChangedByTransparentServiceWeb, openCamera, openGameCenterLeaderboard, openURL, processProductGrant, requestOneTimePurchase, safePostMessage, safeSyncPostMessage, saveBase64Data, setClipboardText, setDeviceOrientation, setIosSwipeGestureEnabled, setScreenAwakeMode, setSecureScreen, share, shareWithScheme, startUpdateLocation, submitGameCenterLeaderBoardScore };

package/dist/index.d.ts

@@ -741,6 +741,57 @@ declare function completeProductGrant(params: {
         orderId: string;
     };
 }): Promise<boolean | undefined>;
+/**
+ * @public
+ * @category 인앱결제
+ * @name IapSubscriptionInfoResult
+ * @description 구독 주문의 현재 상태 정보를 담은 객체예요.
+ * @property {number} catalogId 구독 상품의 식별자예요.
+ * @property {"ACTIVE" |"EXPIRED"|"IN_GRACE_PERIOD"|"ON_HOLD"|"PAUSED"|"REVOKED"} status 구독 상태를 나타내는 값이에요.
+ * @property {string | null} expiresAt 구독 만료 예정 시각이에요. 만료 정보가 없으면 `null`이에요.
+ * @property {boolean} isAutoRenew 구독 자동 갱신 여부예요.
+ * @property {string | null} gracePeriodExpiresAt 결제 유예 기간 만료 시각이에요. 유예 기간이 없으면 `null`이에요.
+ * @property {boolean} isAccessible 현재 구독 상품을 이용할 수 있는지 여부예요.
+ */
+interface IapSubscriptionInfoResult {
+    catalogId: number;
+    status: 'ACTIVE' | 'EXPIRED' | 'IN_GRACE_PERIOD' | 'ON_HOLD' | 'PAUSED' | 'REVOKED';
+    expiresAt: string | null;
+    isAutoRenew: boolean;
+    gracePeriodExpiresAt: string | null;
+    isAccessible: boolean;
+}
+/**
+ * @public
+ * @category 인앱결제
+ * @name getSubscriptionInfo
+ * @description 구독 주문의 현재 상태 정보를 가져와요.
+ * @param {{ params: { orderId: string } }} params 조회할 구독 주문 정보를 담은 객체예요.
+ * @param {string} params.orderId 주문의 고유 ID예요.
+ * @returns {Promise<{ subscription: IapSubscriptionInfoResult } | undefined>} 구독 상태 정보를 담은 객체를 반환해요. 앱 버전이 최소 지원 버전(안드로이드 5.253.0, iOS 5.250.0)보다 낮으면 `undefined`를 반환해요.
+ *
+ * @example
+ * ### 주문 ID로 구독 상태 조회하기
+ * ```typescript
+ * import { IAP } from '@apps-in-toss/framework';
+ *
+ * async function fetchSubscriptionInfo(orderId: string) {
+ *   try {
+ *     const response = await IAP.getSubscriptionInfo({ params: { orderId } });
+ *     return response?.subscription;
+ *   } catch (error) {
+ *     console.error(error);
+ *   }
+ * }
+ * ```
+ */
+declare function getSubscriptionInfo(params: {
+    params: {
+        orderId: string;
+    };
+}): Promise<{
+    subscription: IapSubscriptionInfoResult;
+} | undefined>;
 /**
  * @public
  * @category 인앱결제
@@ -835,6 +886,7 @@ declare function createSubscriptionPurchaseOrder(params: CreateSubscriptionPurch
  * @property {typeof getPendingOrders} [getPendingOrders] 대기 중인 주문 목록을 가져와요. 자세한 내용은 [getPendingOrders](https://developers-apps-in-toss.toss.im/bedrock/reference/framework/%EC%9D%B8%EC%95%B1%20%EA%B2%B0%EC%A0%9C/getPendingOrders.htm) 문서를 참고하세요.
  * @property {typeof getCompletedOrRefundedOrders} [getCompletedOrRefundedOrders] 인앱결제로 구매하거나 환불한 주문 목록을 가져와요. 자세한 내용은 [getCompletedOrRefundedOrders](https://developers-apps-in-toss.toss.im/bedrock/reference/framework/%EC%9D%B8%EC%95%B1%20%EA%B2%B0%EC%A0%9C/getCompletedOrRefundedOrders.html) 문서를 참고하세요.
  * @property {typeof completeProductGrant} [completeProductGrant] 상품 지급 처리를 완료했다는 메시지를 앱에 전달해요. 자세한 내용은 [completeProductGrant](https://developers-apps-in-toss.toss.im/bedrock/reference/framework/%EC%9D%B8%EC%95%B1%20%EA%B2%B0%EC%A0%9C/completeProductGrant.html) 문서를 참고하세요.
+ * @property {typeof getSubscriptionInfo} [getSubscriptionInfo] 구독 주문의 현재 상태 정보를 가져와요.
  */
 declare const IAP: {
     createOneTimePurchaseOrder: typeof createOneTimePurchaseOrder;
@@ -843,6 +895,7 @@ declare const IAP: {
     getPendingOrders: typeof getPendingOrders;
     getCompletedOrRefundedOrders: typeof getCompletedOrRefundedOrders;
     completeProductGrant: typeof completeProductGrant;
+    getSubscriptionInfo: typeof getSubscriptionInfo;
 };
 
 interface SaveBase64DataParams {
@@ -1024,6 +1077,13 @@ interface AsyncMethodsMap {
     completeProductGrant: (params: {
         orderId: string;
     }) => Promise<boolean>;
+    getSubscriptionInfo: (params: {
+        params: {
+            orderId: string;
+        };
+    }) => Promise<{
+        subscription: IapSubscriptionInfoResult;
+    }>;
     eventLog: (params: {
         log_name: string;
         log_type: string;
@@ -3233,4 +3293,4 @@ declare const INTERNAL__module: {
     tossCoreEventLog: typeof tossCoreEventLog;
 };
 
-export { type AppsInTossSignTossCertParams, type CheckoutPaymentOptions, type CheckoutPaymentResult, type CompletedOrRefundedOrdersResult, type ConsumableProductListItem, type ContactsViralParams, type CreateSubscriptionPurchaseOrderOptions, type EventLogParams, type GameCenterGameProfileResponse, type GetUserKeyForGameErrorResponse, type GetUserKeyForGameResponse, type GetUserKeyForGameSuccessResponse, GoogleAdMob, type GrantPromotionRewardErrorResponse, type GrantPromotionRewardErrorResult, type GrantPromotionRewardForGameErrorResponse, type GrantPromotionRewardForGameErrorResult, type GrantPromotionRewardForGameResponse, type GrantPromotionRewardForGameSuccessResponse, type GrantPromotionRewardResponse, type GrantPromotionRewardSuccessResponse, type HapticFeedbackType, IAP, INTERNAL__appBridgeHandler, INTERNAL__module, type IapCreateOneTimePurchaseOrderOptions, type IapCreateOneTimePurchaseOrderResult, type IapCreateSubscriptionPurchaseOrderResult, type IapProductListItem, type NetworkStatus, type NonConsumableProductListItem, type Primitive, type SaveBase64DataParams, Storage, type SubmitGameCenterLeaderBoardScoreResponse, type SubscriptionProductListItem, TossPay, type UpdateLocationEventEmitter, appLogin, appsInTossEvent, appsInTossSignTossCert, checkoutPayment, closeView, contactsViral, eventLog, fetchAlbumPhotos, fetchContacts, generateHapticFeedback, getClipboardText, getCurrentLocation, getDeviceId, getGameCenterGameProfile, getGroupId, getIsTossLoginIntegratedService, getLocale, getNetworkStatus, getOperationalEnvironment, getPlatformOS, getSchemeUri, getServerTime, getTossAppVersion, getTossShareLink, getUserKeyForGame, grantPromotionReward, grantPromotionRewardForGame, iapCreateOneTimePurchaseOrder, isMinVersionSupported, onVisibilityChangedByTransparentServiceWeb, openCamera, openGameCenterLeaderboard, openURL, processProductGrant, requestOneTimePurchase, safePostMessage, safeSyncPostMessage, saveBase64Data, setClipboardText, setDeviceOrientation, setIosSwipeGestureEnabled, setScreenAwakeMode, setSecureScreen, share, shareWithScheme, startUpdateLocation, submitGameCenterLeaderBoardScore };
+export { type AppsInTossSignTossCertParams, type CheckoutPaymentOptions, type CheckoutPaymentResult, type CompletedOrRefundedOrdersResult, type ConsumableProductListItem, type ContactsViralParams, type CreateSubscriptionPurchaseOrderOptions, type EventLogParams, type GameCenterGameProfileResponse, type GetUserKeyForGameErrorResponse, type GetUserKeyForGameResponse, type GetUserKeyForGameSuccessResponse, GoogleAdMob, type GrantPromotionRewardErrorResponse, type GrantPromotionRewardErrorResult, type GrantPromotionRewardForGameErrorResponse, type GrantPromotionRewardForGameErrorResult, type GrantPromotionRewardForGameResponse, type GrantPromotionRewardForGameSuccessResponse, type GrantPromotionRewardResponse, type GrantPromotionRewardSuccessResponse, type HapticFeedbackType, IAP, INTERNAL__appBridgeHandler, INTERNAL__module, type IapCreateOneTimePurchaseOrderOptions, type IapCreateOneTimePurchaseOrderResult, type IapCreateSubscriptionPurchaseOrderResult, type IapProductListItem, type IapSubscriptionInfoResult, type NetworkStatus, type NonConsumableProductListItem, type Primitive, type SaveBase64DataParams, Storage, type SubmitGameCenterLeaderBoardScoreResponse, type SubscriptionProductListItem, TossPay, type UpdateLocationEventEmitter, appLogin, appsInTossEvent, appsInTossSignTossCert, checkoutPayment, closeView, contactsViral, eventLog, fetchAlbumPhotos, fetchContacts, generateHapticFeedback, getClipboardText, getCurrentLocation, getDeviceId, getGameCenterGameProfile, getGroupId, getIsTossLoginIntegratedService, getLocale, getNetworkStatus, getOperationalEnvironment, getPlatformOS, getSchemeUri, getServerTime, getTossAppVersion, getTossShareLink, getUserKeyForGame, grantPromotionReward, grantPromotionRewardForGame, iapCreateOneTimePurchaseOrder, isMinVersionSupported, onVisibilityChangedByTransparentServiceWeb, openCamera, openGameCenterLeaderboard, openURL, processProductGrant, requestOneTimePurchase, safePostMessage, safeSyncPostMessage, saveBase64Data, setClipboardText, setDeviceOrientation, setIosSwipeGestureEnabled, setScreenAwakeMode, setSecureScreen, share, shareWithScheme, startUpdateLocation, submitGameCenterLeaderBoardScore };

package/dist/index.js

@@ -1,4 +1,4 @@
-// src/MiniAppModule.brick.ts
+// src/MiniAppModule/postMessage.ts
 import { BrickModule } from "brick-module";
 var MiniAppModule = BrickModule.get("MiniAppModule");
 function safePostMessage(method, params) {
@@ -15,13 +15,13 @@ import { GraniteEvent } from "@granite-js/react-native";
 import { GetCurrentLocationPermissionError } from "@apps-in-toss/types";
 import { GraniteEventDefinition } from "@granite-js/react-native";
 
-// src/TossCoreModule.brick.ts
+// src/BedrockModule/commonModule.ts
 import { BrickModule as BrickModule2 } from "brick-module";
-var TossCoreModule = BrickModule2.get("TossCoreModule");
+var CommonModule = BrickModule2.get("CommonModule");
 
-// src/CommonModule.brick.ts
+// src/TossCoreModule/instance.ts
 import { BrickModule as BrickModule3 } from "brick-module";
-var CommonModule = BrickModule3.get("CommonModule");
+var TossCoreModule = BrickModule3.get("TossCoreModule");
 
 // src/MiniAppModule/native-modules/permissions/openPermissionDialog.ts
 function openPermissionDialog(permission) {
@@ -705,6 +705,16 @@ async function completeProductGrant(params) {
   }
   return safePostMessage("completeProductGrant", params.params);
 }
+async function getSubscriptionInfo(params) {
+  const isSupported = isMinVersionSupported({
+    android: "5.253.0",
+    ios: "5.250.0"
+  });
+  if (!isSupported) {
+    return;
+  }
+  return safePostMessage("getSubscriptionInfo", params);
+}
 function createSubscriptionPurchaseOrder(params) {
   const isSupported = isMinVersionSupported({
     android: "5.248.0",
@@ -739,7 +749,8 @@ var IAP = {
   getProductItemList,
   getPendingOrders,
   getCompletedOrRefundedOrders,
-  completeProductGrant
+  completeProductGrant,
+  getSubscriptionInfo
 };
 
 // src/MiniAppModule/native-modules/saveBase64Data.ts

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@apps-in-toss/native-modules",
   "type": "module",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "description": "Native Modules for Apps In Toss",
   "scripts": {
     "typecheck": "tsc --noEmit",
@@ -29,8 +29,8 @@
   ],
   "devDependencies": {
     "@babel/runtime": "^7",
-    "@granite-js/native": "1.0.4",
-    "@granite-js/react-native": "1.0.4",
+    "@granite-js/native": "1.0.10",
+    "@granite-js/react-native": "1.0.10",
     "@types/react": "19.2.3",
     "dts-bundle-generator": "^9.5.1",
     "esbuild": "0.25.5",
@@ -42,7 +42,7 @@
     "vitest": "^3.2.4"
   },
   "dependencies": {
-    "@apps-in-toss/types": "2.1.0",
+    "@apps-in-toss/types": "2.2.0",
     "brick-module": "0.5.0",
     "es-toolkit": "^1.39.3"
   },
@@ -51,5 +51,8 @@
     "@granite-js/react-native": "*",
     "react": "*",
     "react-native": "*"
+  },
+  "brickModule": {
+    "specSrc": "./src/spec"
   }
 }

package/src/BedrockModule/commonModule.ts

@@ -0,0 +1,14 @@
+import { BrickModule } from 'brick-module';
+import type { CommonModuleSpec } from '../spec/CommonModule.brick';
+
+/**
+ * CommonModule Instance
+ * Native module instance accessed through BrickModule
+ */
+export const CommonModule = BrickModule.get<CommonModuleSpec>('CommonModule');
+
+/**
+ * Deprecated exports for backward compatibility
+ */
+/** @deprecated Use CommonModule instead */
+export const BedrockModule = CommonModule;

package/src/BedrockModule/native-modules/natives/getNetworkStatus/index.ts

@@ -52,7 +52,8 @@ import { CommonModule } from '../BedrockModule';
  * ```
  */
 export function getNetworkStatus(): Promise<NetworkStatus> {
-  return CommonModule.getNetworkStatus();
+  // RN84에서는 동기, RN72에서는 비동기로 동작하지만, 안정성을 위해 항상 비동기로 처리해요.
+  return CommonModule.getNetworkStatus() as unknown as Promise<NetworkStatus>;
 }
 
 /** export type */

package/src/MiniAppModule/native-modules/getOperationalEnvironment.ts

@@ -33,5 +33,5 @@ import { MiniAppModule } from '../../natives';
  * ```
  */
 export function getOperationalEnvironment(): 'toss' | 'sandbox' {
-  return MiniAppModule.getConstants().operationalEnvironment;
+  return MiniAppModule.getConstants().operationalEnvironment as 'toss' | 'sandbox';
 }

package/src/MiniAppModule/native-modules/iap.ts

@@ -520,6 +520,66 @@ async function completeProductGrant(params: { params: { orderId: string } }) {
   return safePostMessage('completeProductGrant', params.params);
 }
 
+/**
+ * @public
+ * @category 인앱결제
+ * @name IapSubscriptionInfoResult
+ * @description 구독 주문의 현재 상태 정보를 담은 객체예요.
+ * @property {number} catalogId 구독 상품의 식별자예요.
+ * @property {"ACTIVE" |"EXPIRED"|"IN_GRACE_PERIOD"|"ON_HOLD"|"PAUSED"|"REVOKED"} status 구독 상태를 나타내는 값이에요.
+ * @property {string | null} expiresAt 구독 만료 예정 시각이에요. 만료 정보가 없으면 `null`이에요.
+ * @property {boolean} isAutoRenew 구독 자동 갱신 여부예요.
+ * @property {string | null} gracePeriodExpiresAt 결제 유예 기간 만료 시각이에요. 유예 기간이 없으면 `null`이에요.
+ * @property {boolean} isAccessible 현재 구독 상품을 이용할 수 있는지 여부예요.
+ */
+export interface IapSubscriptionInfoResult {
+  catalogId: number;
+  status: 'ACTIVE' | 'EXPIRED' | 'IN_GRACE_PERIOD' | 'ON_HOLD' | 'PAUSED' | 'REVOKED';
+  expiresAt: string | null;
+  isAutoRenew: boolean;
+  gracePeriodExpiresAt: string | null;
+  isAccessible: boolean;
+}
+
+/**
+ * @public
+ * @category 인앱결제
+ * @name getSubscriptionInfo
+ * @description 구독 주문의 현재 상태 정보를 가져와요.
+ * @param {{ params: { orderId: string } }} params 조회할 구독 주문 정보를 담은 객체예요.
+ * @param {string} params.orderId 주문의 고유 ID예요.
+ * @returns {Promise<{ subscription: IapSubscriptionInfoResult } | undefined>} 구독 상태 정보를 담은 객체를 반환해요. 앱 버전이 최소 지원 버전(안드로이드 5.253.0, iOS 5.250.0)보다 낮으면 `undefined`를 반환해요.
+ *
+ * @example
+ * ### 주문 ID로 구독 상태 조회하기
+ * ```typescript
+ * import { IAP } from '@apps-in-toss/framework';
+ *
+ * async function fetchSubscriptionInfo(orderId: string) {
+ *   try {
+ *     const response = await IAP.getSubscriptionInfo({ params: { orderId } });
+ *     return response?.subscription;
+ *   } catch (error) {
+ *     console.error(error);
+ *   }
+ * }
+ * ```
+ */
+async function getSubscriptionInfo(params: {
+  params: { orderId: string };
+}): Promise<{ subscription: IapSubscriptionInfoResult } | undefined> {
+  const isSupported = isMinVersionSupported({
+    android: '5.253.0',
+    ios: '5.250.0',
+  });
+
+  if (!isSupported) {
+    return;
+  }
+
+  return safePostMessage('getSubscriptionInfo', params);
+}
+
 /**
  * @public
  * @category 인앱결제
@@ -646,6 +706,7 @@ function createSubscriptionPurchaseOrder(params: CreateSubscriptionPurchaseOrder
  * @property {typeof getPendingOrders} [getPendingOrders] 대기 중인 주문 목록을 가져와요. 자세한 내용은 [getPendingOrders](https://developers-apps-in-toss.toss.im/bedrock/reference/framework/%EC%9D%B8%EC%95%B1%20%EA%B2%B0%EC%A0%9C/getPendingOrders.htm) 문서를 참고하세요.
  * @property {typeof getCompletedOrRefundedOrders} [getCompletedOrRefundedOrders] 인앱결제로 구매하거나 환불한 주문 목록을 가져와요. 자세한 내용은 [getCompletedOrRefundedOrders](https://developers-apps-in-toss.toss.im/bedrock/reference/framework/%EC%9D%B8%EC%95%B1%20%EA%B2%B0%EC%A0%9C/getCompletedOrRefundedOrders.html) 문서를 참고하세요.
  * @property {typeof completeProductGrant} [completeProductGrant] 상품 지급 처리를 완료했다는 메시지를 앱에 전달해요. 자세한 내용은 [completeProductGrant](https://developers-apps-in-toss.toss.im/bedrock/reference/framework/%EC%9D%B8%EC%95%B1%20%EA%B2%B0%EC%A0%9C/completeProductGrant.html) 문서를 참고하세요.
+ * @property {typeof getSubscriptionInfo} [getSubscriptionInfo] 구독 주문의 현재 상태 정보를 가져와요.
  */
 export const IAP = {
   createOneTimePurchaseOrder,
@@ -654,4 +715,5 @@ export const IAP = {
   getPendingOrders,
   getCompletedOrRefundedOrders,
   completeProductGrant,
+  getSubscriptionInfo,
 };

package/src/{MiniAppModule.brick.ts → MiniAppModule/postMessage.ts}

@@ -1,48 +1,22 @@
 import type {
   CompatiblePlaceholderArgument,
-  PermissionName,
-  PermissionAccess,
-  PermissionStatus,
-  ImageResponse,
   ContactResult,
+  ImageResponse,
   Location,
+  PermissionAccess,
+  PermissionName,
+  PermissionStatus,
 } from '@apps-in-toss/types';
-import { Any, AnyObject, BrickModule, BrickModuleSpec } from 'brick-module';
-import { CodegenTypes } from 'react-native';
-import type { AppsInTossSignTossCertParams } from './MiniAppModule/native-modules/appsInTossSignTossCert';
-import type { CheckoutPaymentOptions, CheckoutPaymentResult } from './MiniAppModule/native-modules/checkoutPayment';
-import type { GameCenterGameProfileResponse } from './MiniAppModule/native-modules/getGameCenterGameProfile';
-import type { GetUserKeyForGameResponse } from './MiniAppModule/native-modules/getUserKeyForGame';
-import type { GrantPromotionRewardForGameResponse } from './MiniAppModule/native-modules/grantPromotionRewardForGame';
-import type { IapCreateOneTimePurchaseOrderResult } from './MiniAppModule/native-modules/iap';
-import type { SaveBase64DataParams } from './MiniAppModule/native-modules/saveBase64Data';
-import type { SubmitGameCenterLeaderBoardScoreResponse } from './MiniAppModule/native-modules/submitGameCenterLeaderBoardScore';
-
-/**
- * MiniAppModule Spec
- * Unified type definition for MiniAppModule (formerly AppsInTossModule)
- */
-export interface MiniAppModuleSpec extends BrickModuleSpec {
-  readonly moduleName: 'MiniAppModule';
-  // readonly supportedEvents: ['updateLocation', 'visibilityChangedByTransparentServiceWeb', 'appBridgeCallback'];
-
-  readonly onSendEvent: CodegenTypes.EventEmitter<{
-    eventName: string; // updateLocation, visibilityChangedByTransparentServiceWeb, appBridgeCallback
-    body: AnyObject;
-  }>;
-
-  getConstants(): {
-    // Constants
-    groupId: string;
-    operationalEnvironment: 'sandbox' | 'toss';
-    tossAppVersion: string;
-    deviceId: string;
-  };
-
-  // All async/sync methods are now handled via postMessage/postMessageSync
-  postMessage(name: string, params: AnyObject, callbacks: AnyObject): Promise<Any>;
-  postMessageSync(name: string, params: AnyObject, callbacks: AnyObject): Any;
-}
+import { BrickModule } from 'brick-module';
+import type { AppsInTossSignTossCertParams } from './native-modules/appsInTossSignTossCert';
+import type { CheckoutPaymentOptions, CheckoutPaymentResult } from './native-modules/checkoutPayment';
+import type { GameCenterGameProfileResponse } from './native-modules/getGameCenterGameProfile';
+import type { GetUserKeyForGameResponse } from './native-modules/getUserKeyForGame';
+import type { GrantPromotionRewardForGameResponse } from './native-modules/grantPromotionRewardForGame';
+import type { IapCreateOneTimePurchaseOrderResult, IapSubscriptionInfoResult } from './native-modules/iap';
+import type { SaveBase64DataParams } from './native-modules/saveBase64Data';
+import type { SubmitGameCenterLeaderBoardScoreResponse } from './native-modules/submitGameCenterLeaderBoardScore';
+import type { MiniAppModuleSpec } from '../spec/MiniAppModule.brick';
 
 /**
  * Async Methods Map
@@ -72,7 +46,7 @@ export interface AsyncMethodsMap {
   startUpdateLocation: (params: { accuracy: number; timeInterval: number; distanceInterval: number }) => Promise<void>;
   getCurrentLocation: (params: { accuracy: number }) => Promise<Location>;
 
-  // IAP (6)
+  // IAP (7)
   iapCreateOneTimePurchaseOrder: (params: { productId: string }) => Promise<IapCreateOneTimePurchaseOrderResult>;
   processProductGrant: (params: { orderId: string; isProductGranted: boolean }) => Promise<void>;
   iapGetProductItemList: (params: CompatiblePlaceholderArgument) => Promise<{ products: any[] }>;
@@ -81,6 +55,9 @@ export interface AsyncMethodsMap {
   ) => Promise<{ orders: Array<{ orderId: string; sku: string }> }>;
   getCompletedOrRefundedOrders: (params: { key?: string | null }) => Promise<any>;
   completeProductGrant: (params: { orderId: string }) => Promise<boolean>;
+  getSubscriptionInfo: (params: {
+    params: { orderId: string };
+  }) => Promise<{ subscription: IapSubscriptionInfoResult }>;
 
   // Other (9)
   eventLog: (params: { log_name: string; log_type: string; params: Record<string, string> }) => Promise<void>;

package/src/TossCoreModule/instance.ts

@@ -0,0 +1,8 @@
+import { BrickModule } from 'brick-module';
+import type { TossCoreModuleSpec } from '../spec/TossCoreModule.brick';
+
+/**
+ * TossCoreModule Instance
+ * Native module instance accessed through BrickModule
+ */
+export const TossCoreModule = BrickModule.get<TossCoreModuleSpec>('TossCoreModule');

package/src/index.ts

@@ -1,5 +1,5 @@
 // MiniAppModule (formerly AppsInTossModule)
-export { safePostMessage, safeSyncPostMessage } from './MiniAppModule.brick';
+export { safePostMessage, safeSyncPostMessage } from './MiniAppModule/postMessage';
 export * from './MiniAppModule/native-event-emitter';
 export * from './MiniAppModule/native-modules';
 

package/src/natives.ts

@@ -5,6 +5,10 @@
  * This file re-exports all native module definitions for backward compatibility.
  */
 
-export * from './MiniAppModule.brick';
-export * from './TossCoreModule.brick';
-export * from './CommonModule.brick';
+export * from './spec/MiniAppModule.brick';
+export * from './spec/TossCoreModule.brick';
+export * from './spec/CommonModule.brick';
+
+export * from './MiniAppModule/postMessage';
+export * from './BedrockModule/commonModule';
+export * from './TossCoreModule/instance';

package/src/spec/CommonModule.brick.ts

@@ -0,0 +1,48 @@
+import { BrickModuleSpec } from 'brick-module';
+
+interface ScreenAwakeModeParameter {
+  enabled: boolean;
+}
+
+interface SecureScreenParameter {
+  enabled: boolean;
+}
+
+interface HapticParameter {
+  type: string;
+}
+
+interface IosSwipeGestureParameters {
+  isEnabled: boolean;
+}
+
+interface ShareParameter {
+  message: string;
+}
+
+interface LeftEdgeTouchEnabledParameter {
+  isEnabled: boolean;
+}
+
+/**
+ * CommonModule Spec
+ * Unified type definition for CommonModule (formerly BedrockModule)
+ */
+export interface CommonModuleSpec extends BrickModuleSpec {
+  readonly moduleName: 'CommonModule';
+
+  getConstants(): {
+    schemeUri: string;
+    locale: string;
+  };
+
+  getNetworkStatus(): string;
+  closeView(): void;
+  generateHapticFeedback(parameter: HapticParameter): Promise<void>;
+  share(parameter: ShareParameter): void;
+  setSecureScreen(parameter: SecureScreenParameter): Promise<{ enabled: boolean }>;
+  setScreenAwakeMode(parameter: ScreenAwakeModeParameter): Promise<{ enabled: boolean }>;
+  setIosSwipeGestureEnabled(parameter: IosSwipeGestureParameters): Promise<void>;
+
+  setLeftEdgeTouchEnabled(parameter: LeftEdgeTouchEnabledParameter): void;
+}

package/src/spec/MiniAppBundleLoaderModule.brick.ts

@@ -0,0 +1,13 @@
+/**
+ * Granite Screen module for Brick framework
+ * Provides bundle loading and management with automatic bridge generation
+ */
+
+import type { BrickModuleSpec } from 'brick-module';
+
+export interface MiniAppBundleLoaderModuleSpec extends BrickModuleSpec {
+  readonly moduleName: 'MiniAppBundleLoader';
+
+  // Import bundle lazily
+  importLazy(): Promise<void>;
+}

package/src/spec/MiniAppModule.brick.ts

@@ -0,0 +1,27 @@
+import { Any, AnyObject, BrickModuleSpec } from 'brick-module';
+import { CodegenTypes } from 'react-native';
+
+/**
+ * MiniAppModule Spec
+ * Unified type definition for MiniAppModule (formerly AppsInTossModule)
+ */
+export interface MiniAppModuleSpec extends BrickModuleSpec {
+  readonly moduleName: 'MiniAppModule';
+
+  getConstants(): {
+    groupId: string;
+    operationalEnvironment: string;
+    tossAppVersion: string;
+    deviceId: string;
+  };
+
+  // All async/sync methods are now handled via postMessage/postMessageSync
+  postMessage(name: string, params: AnyObject, callbacks: AnyObject): Promise<Any>;
+  postMessageSync(name: string, params: AnyObject, callbacks: AnyObject): Any;
+
+  // readonly supportedEvents: ['sendEvent'];
+  readonly onSendEvent: CodegenTypes.EventEmitter<{
+    eventName: string; // updateLocation, visibilityChangedByTransparentServiceWeb, appBridgeCallback
+    body: AnyObject;
+  }>;
+}

package/src/spec/TossCoreModule.brick.ts

@@ -0,0 +1,11 @@
+import { AnyObject, BrickModuleSpec } from 'brick-module';
+
+/**
+ * TossCoreModule Spec
+ * Unified type definition for TossCoreModule (Toss App internal logging)
+ */
+export interface TossCoreModuleSpec extends BrickModuleSpec {
+  readonly moduleName: 'TossCoreModule';
+
+  eventLog(params: AnyObject): Promise<void>;
+}

package/src/CommonModule.brick.ts

@@ -1,36 +0,0 @@
-import { BrickModule, BrickModuleSpec } from 'brick-module';
-import type { HapticFeedbackOptions } from './BedrockModule/native-modules/natives/generateHapticFeedback/types';
-import type { NetworkStatus } from './BedrockModule/native-modules/natives/getNetworkStatus/types';
-
-/**
- * CommonModule Spec
- * Unified type definition for CommonModule (formerly BedrockModule)
- */
-export interface CommonModuleSpec extends BrickModuleSpec {
-  readonly moduleName: 'BedrockModule';
-
-  getConstants(): {
-    locale: string;
-    schemeUri: string;
-  };
-
-  closeView: () => void;
-  generateHapticFeedback: (options: HapticFeedbackOptions) => Promise<void>;
-  share: (message: { message: string }) => void;
-  setSecureScreen: (options: { enabled: boolean }) => Promise<{ enabled: boolean }>;
-  setScreenAwakeMode: (options: { enabled: boolean }) => Promise<{ enabled: boolean }>;
-  getNetworkStatus: () => Promise<NetworkStatus>;
-  setIosSwipeGestureEnabled: ({ isEnabled }: { isEnabled: boolean }) => Promise<void>;
-}
-
-/**
- * CommonModule Instance
- * Native module instance accessed through BrickModule
- */
-export const CommonModule = BrickModule.get<CommonModuleSpec>('CommonModule');
-
-/**
- * Deprecated exports for backward compatibility
- */
-/** @deprecated Use CommonModule instead */
-export const BedrockModule = CommonModule;

package/src/TossCoreModule.brick.ts

@@ -1,17 +0,0 @@
-import { BrickModule, BrickModuleSpec } from 'brick-module';
-
-/**
- * TossCoreModule Spec
- * Unified type definition for TossCoreModule (Toss App internal logging)
- */
-export interface TossCoreModuleSpec extends BrickModuleSpec {
-  readonly moduleName: 'TossCoreModule';
-
-  eventLog: (params: { log_name: string; log_type: string; params: Record<string, unknown> }) => Promise<void>;
-}
-
-/**
- * TossCoreModule Instance
- * Native module instance accessed through BrickModule
- */
-export const TossCoreModule = BrickModule.get<TossCoreModuleSpec>('TossCoreModule');