@apps-in-toss/native-modules 2.9.3 → 2.10.1

package/dist/bridges-meta.json

@@ -151,6 +151,10 @@
     "identifier": "requestReview",
     "dts": "/**\n * @public\n * @category 리뷰\n * @name requestReview\n * @description\n * 유저에게 미니앱 리뷰를 요청해요.\n *\n * @property {() => boolean} isSupported 현재 앱 버전이 이 기능을 지원하는지 확인하는 함수예요.\n */\nexport declare function requestReview(): Promise<void>;\nexport declare namespace requestReview {\n\tvar isSupported: () => boolean;\n}\n\nexport {};\n"
   },
+  {
+    "identifier": "getDeclaredAgeRange",
+    "dts": "export interface DeclaredAgeRange {\n\tstatus: \"SHARING\" | \"DECLINED_SHARING\" | \"UNSUPPORTED_OS\" | \"NOT_AVAILABLE\" | \"INVALID_REQUEST\" | \"FAILED\";\n\tlowerBound?: number;\n\tupperBound?: number;\n\tageRangeDeclaration?: string;\n\tactiveParentalControls: string[];\n\tisEligibleForAgeFeatures?: boolean;\n\terrorCode?: string;\n}\nexport declare function getDeclaredAgeRange(params: {\n\tageGates: number[];\n}): Promise<DeclaredAgeRange>;\nexport declare namespace getDeclaredAgeRange {\n\tvar isSupported: () => boolean;\n}\n\nexport {};\n"
+  },
   {
     "identifier": "getLocale",
     "dts": "/**\n * @public\n * @category 언어\n * @kind function\n * @name getLocale\n * @description\n * 사용자의 로케일(locale) 정보를 반환해요. 네이티브 모듈에서 로케일 정보를 가져올 수 없을 때는 기본값으로 'ko-KR'을 반환합니다. 앱의 현지화 및 언어 설정과 관련된 기능을 구현할 때 사용하세요.\n *\n * @returns {string} 사용자의 로케일 정보를 반환해요.\n *\n * @example\n * ### 현재 사용자의 로케일 정보 가져오기\n *\n * ```tsx\n * import { getLocale } from '@apps-in-toss/native-modules';\n * import { Text } from 'react-native';\n *\n * function MyPage() {\n *  const locale = getLocale();\n *\n *  return (\n *    <Text>사용자의 로케일 정보: {locale}</Text>\n *  )\n * }\n *\n * ```\n */\nexport declare function getLocale(): string;\n\nexport {};\n"

package/dist/index.cjs

@@ -42,6 +42,7 @@ __export(index_exports, {
   getClipboardText: () => getClipboardText,
   getConsentedUserData: () => getConsentedUserData,
   getCurrentLocation: () => getCurrentLocation,
+  getDeclaredAgeRange: () => getDeclaredAgeRange,
   getDeviceId: () => getDeviceId,
   getGameCenterGameProfile: () => getGameCenterGameProfile,
   getGroupId: () => getGroupId,
@@ -1186,6 +1187,22 @@ function requestNotificationAgreement(params) {
   });
 }
 
+// src/MiniAppModule/native-modules/getDeclaredAgeRange.ts
+var import_react_native8 = require("react-native");
+var isSupportedPlatform = import_react_native8.Platform.OS === "ios" && parseInt(import_react_native8.Platform.Version, 10) >= 26;
+var MIN_IOS_TOSSAPP_VERSION = "5.266.0";
+var isSupportedTossApp = isMinVersionSupported({ ios: MIN_IOS_TOSSAPP_VERSION, android: "never" });
+async function getDeclaredAgeRange(params) {
+  if (!isSupportedPlatform) {
+    throw new Error("getDeclaredAgeRange\uB294 iOS 26 \uC774\uC0C1\uC5D0\uC11C\uB9CC \uC0AC\uC6A9 \uAC00\uB2A5\uD569\uB2C8\uB2E4.");
+  }
+  if (!isSupportedTossApp) {
+    throw new Error(`getDeclaredAgeRange\uB294 \uD1A0\uC2A4\uC571 ${MIN_IOS_TOSSAPP_VERSION} \uBC84\uC804 \uC774\uC0C1\uC5D0\uC11C\uB9CC \uC0AC\uC6A9 \uAC00\uB2A5\uD569\uB2C8\uB2E4.`);
+  }
+  return await MiniAppModule.postMessage("getDeclaredAgeRange", params, {});
+}
+getDeclaredAgeRange.isSupported = () => isSupportedPlatform && isSupportedTossApp;
+
 // src/MiniAppModule/native-modules/index.ts
 var TossPay = {
   checkoutPayment,
@@ -1221,10 +1238,10 @@ async function closeView() {
 }
 
 // src/BedrockModule/native-modules/natives/getLocale.ts
-var import_react_native8 = require("react-native");
+var import_react_native9 = require("react-native");
 function getLocale() {
   const locale = CommonModule2?.getConstants().locale ?? "ko-KR";
-  if (import_react_native8.Platform.OS === "android") {
+  if (import_react_native9.Platform.OS === "android") {
     return replaceUnderbarToHypen(locale);
   }
   return locale;
@@ -1272,15 +1289,15 @@ async function setIosSwipeGestureEnabled(options) {
 }
 
 // src/BedrockModule/native-modules/natives/openURL.ts
-var import_react_native9 = require("react-native");
+var import_react_native10 = require("react-native");
 function openURL2(url) {
-  return import_react_native9.Linking.openURL(url);
+  return import_react_native10.Linking.openURL(url);
 }
 
 // src/BedrockModule/native-modules/natives/getPlatformOS.ts
-var import_react_native10 = require("react-native");
+var import_react_native11 = require("react-native");
 function getPlatformOS() {
-  return import_react_native10.Platform.OS;
+  return import_react_native11.Platform.OS;
 }
 
 // src/MiniAppModule/native-modules/tossCore.ts
@@ -1325,6 +1342,7 @@ var INTERNAL__module = {
   getClipboardText,
   getConsentedUserData,
   getCurrentLocation,
+  getDeclaredAgeRange,
   getDeviceId,
   getGameCenterGameProfile,
   getGroupId,

package/dist/index.d.cts

@@ -3213,6 +3213,22 @@ declare namespace requestReview {
     var isSupported: () => boolean;
 }
 
+interface DeclaredAgeRange {
+    status: 'SHARING' | 'DECLINED_SHARING' | 'UNSUPPORTED_OS' | 'NOT_AVAILABLE' | 'INVALID_REQUEST' | 'FAILED';
+    lowerBound?: number;
+    upperBound?: number;
+    ageRangeDeclaration?: string;
+    activeParentalControls: string[];
+    isEligibleForAgeFeatures?: boolean;
+    errorCode?: string;
+}
+declare function getDeclaredAgeRange(params: {
+    ageGates: number[];
+}): Promise<DeclaredAgeRange>;
+declare namespace getDeclaredAgeRange {
+    var isSupported: () => boolean;
+}
+
 /**
  * @public
  * @category 토스페이
@@ -3672,4 +3688,4 @@ declare const INTERNAL__module: {
     tossCoreEventLog: typeof tossCoreEventLog;
 };
 
-export { type AlbumItemResponse, type AlbumItemType, type AppsInTossSignTossCertParams, type CheckoutPaymentOptions, type CheckoutPaymentResult, type CompletedOrRefundedOrdersResult, type ConsentedUserData, type ConsumableProductListItem, type ContactsViralParams, type CreateSubscriptionPurchaseOrderOptions, type EventLogParams, type FetchAlbumItemsOptions, type GameCenterGameProfileResponse, type GetAnonymousKeyResponse, type GetAnonymousKeySuccessResponse, type GetConsentedUserDataErrorCode, type GetConsentedUserDataOptions, 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 NotificationAgreementResult, type OpenPDFViewerParams, type OpenPDFViewerResult, type Primitive, type RequestNotificationAgreementOptions, type RequestTossPayPaysBillingOptions, type RequestTossPayPaysBillingResult, type SaveBase64DataParams, Storage, type SubmitGameCenterLeaderBoardScoreResponse, type SubscriptionProductListItem, TossPay, type UpdateLocationEventEmitter, appLogin, appsInTossEvent, appsInTossSignTossCert, checkoutPayment, closeView, contactsViral, eventLog, fetchAlbumItems, fetchAlbumPhotos, fetchContacts, generateHapticFeedback, getAnonymousKey, getClipboardText, getConsentedUserData, getCurrentLocation, getDeviceId, getGameCenterGameProfile, getGroupId, getIsTossLoginIntegratedService, getLocale, getNetworkStatus, getOperationalEnvironment, getPlatformOS, getSchemeUri, getServerTime, getTossAppVersion, getTossShareLink, getUserKeyForGame, grantPromotionReward, grantPromotionRewardForGame, iapCreateOneTimePurchaseOrder, isMinVersionSupported, onVisibilityChangedByTransparentServiceWeb, openCamera, openGameCenterLeaderboard, openPDFViewer, openURL, processProductGrant, requestNotificationAgreement, requestOneTimePurchase, requestReview, requestSubscriptionPurchase, requestTossPayPaysBilling, safePostMessage, safeSyncPostMessage, saveBase64Data, setClipboardText, setDeviceOrientation, setIosSwipeGestureEnabled, setScreenAwakeMode, setSecureScreen, share, shareWithScheme, startUpdateLocation, submitGameCenterLeaderBoardScore };
+export { type AlbumItemResponse, type AlbumItemType, type AppsInTossSignTossCertParams, type CheckoutPaymentOptions, type CheckoutPaymentResult, type CompletedOrRefundedOrdersResult, type ConsentedUserData, type ConsumableProductListItem, type ContactsViralParams, type CreateSubscriptionPurchaseOrderOptions, type DeclaredAgeRange, type EventLogParams, type FetchAlbumItemsOptions, type GameCenterGameProfileResponse, type GetAnonymousKeyResponse, type GetAnonymousKeySuccessResponse, type GetConsentedUserDataErrorCode, type GetConsentedUserDataOptions, 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 NotificationAgreementResult, type OpenPDFViewerParams, type OpenPDFViewerResult, type Primitive, type RequestNotificationAgreementOptions, type RequestTossPayPaysBillingOptions, type RequestTossPayPaysBillingResult, type SaveBase64DataParams, Storage, type SubmitGameCenterLeaderBoardScoreResponse, type SubscriptionProductListItem, TossPay, type UpdateLocationEventEmitter, appLogin, appsInTossEvent, appsInTossSignTossCert, checkoutPayment, closeView, contactsViral, eventLog, fetchAlbumItems, fetchAlbumPhotos, fetchContacts, generateHapticFeedback, getAnonymousKey, getClipboardText, getConsentedUserData, getCurrentLocation, getDeclaredAgeRange, getDeviceId, getGameCenterGameProfile, getGroupId, getIsTossLoginIntegratedService, getLocale, getNetworkStatus, getOperationalEnvironment, getPlatformOS, getSchemeUri, getServerTime, getTossAppVersion, getTossShareLink, getUserKeyForGame, grantPromotionReward, grantPromotionRewardForGame, iapCreateOneTimePurchaseOrder, isMinVersionSupported, onVisibilityChangedByTransparentServiceWeb, openCamera, openGameCenterLeaderboard, openPDFViewer, openURL, processProductGrant, requestNotificationAgreement, requestOneTimePurchase, requestReview, requestSubscriptionPurchase, requestTossPayPaysBilling, safePostMessage, safeSyncPostMessage, saveBase64Data, setClipboardText, setDeviceOrientation, setIosSwipeGestureEnabled, setScreenAwakeMode, setSecureScreen, share, shareWithScheme, startUpdateLocation, submitGameCenterLeaderBoardScore };

package/dist/index.d.ts

@@ -3213,6 +3213,22 @@ declare namespace requestReview {
     var isSupported: () => boolean;
 }
 
+interface DeclaredAgeRange {
+    status: 'SHARING' | 'DECLINED_SHARING' | 'UNSUPPORTED_OS' | 'NOT_AVAILABLE' | 'INVALID_REQUEST' | 'FAILED';
+    lowerBound?: number;
+    upperBound?: number;
+    ageRangeDeclaration?: string;
+    activeParentalControls: string[];
+    isEligibleForAgeFeatures?: boolean;
+    errorCode?: string;
+}
+declare function getDeclaredAgeRange(params: {
+    ageGates: number[];
+}): Promise<DeclaredAgeRange>;
+declare namespace getDeclaredAgeRange {
+    var isSupported: () => boolean;
+}
+
 /**
  * @public
  * @category 토스페이
@@ -3672,4 +3688,4 @@ declare const INTERNAL__module: {
     tossCoreEventLog: typeof tossCoreEventLog;
 };
 
-export { type AlbumItemResponse, type AlbumItemType, type AppsInTossSignTossCertParams, type CheckoutPaymentOptions, type CheckoutPaymentResult, type CompletedOrRefundedOrdersResult, type ConsentedUserData, type ConsumableProductListItem, type ContactsViralParams, type CreateSubscriptionPurchaseOrderOptions, type EventLogParams, type FetchAlbumItemsOptions, type GameCenterGameProfileResponse, type GetAnonymousKeyResponse, type GetAnonymousKeySuccessResponse, type GetConsentedUserDataErrorCode, type GetConsentedUserDataOptions, 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 NotificationAgreementResult, type OpenPDFViewerParams, type OpenPDFViewerResult, type Primitive, type RequestNotificationAgreementOptions, type RequestTossPayPaysBillingOptions, type RequestTossPayPaysBillingResult, type SaveBase64DataParams, Storage, type SubmitGameCenterLeaderBoardScoreResponse, type SubscriptionProductListItem, TossPay, type UpdateLocationEventEmitter, appLogin, appsInTossEvent, appsInTossSignTossCert, checkoutPayment, closeView, contactsViral, eventLog, fetchAlbumItems, fetchAlbumPhotos, fetchContacts, generateHapticFeedback, getAnonymousKey, getClipboardText, getConsentedUserData, getCurrentLocation, getDeviceId, getGameCenterGameProfile, getGroupId, getIsTossLoginIntegratedService, getLocale, getNetworkStatus, getOperationalEnvironment, getPlatformOS, getSchemeUri, getServerTime, getTossAppVersion, getTossShareLink, getUserKeyForGame, grantPromotionReward, grantPromotionRewardForGame, iapCreateOneTimePurchaseOrder, isMinVersionSupported, onVisibilityChangedByTransparentServiceWeb, openCamera, openGameCenterLeaderboard, openPDFViewer, openURL, processProductGrant, requestNotificationAgreement, requestOneTimePurchase, requestReview, requestSubscriptionPurchase, requestTossPayPaysBilling, safePostMessage, safeSyncPostMessage, saveBase64Data, setClipboardText, setDeviceOrientation, setIosSwipeGestureEnabled, setScreenAwakeMode, setSecureScreen, share, shareWithScheme, startUpdateLocation, submitGameCenterLeaderBoardScore };
+export { type AlbumItemResponse, type AlbumItemType, type AppsInTossSignTossCertParams, type CheckoutPaymentOptions, type CheckoutPaymentResult, type CompletedOrRefundedOrdersResult, type ConsentedUserData, type ConsumableProductListItem, type ContactsViralParams, type CreateSubscriptionPurchaseOrderOptions, type DeclaredAgeRange, type EventLogParams, type FetchAlbumItemsOptions, type GameCenterGameProfileResponse, type GetAnonymousKeyResponse, type GetAnonymousKeySuccessResponse, type GetConsentedUserDataErrorCode, type GetConsentedUserDataOptions, 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 NotificationAgreementResult, type OpenPDFViewerParams, type OpenPDFViewerResult, type Primitive, type RequestNotificationAgreementOptions, type RequestTossPayPaysBillingOptions, type RequestTossPayPaysBillingResult, type SaveBase64DataParams, Storage, type SubmitGameCenterLeaderBoardScoreResponse, type SubscriptionProductListItem, TossPay, type UpdateLocationEventEmitter, appLogin, appsInTossEvent, appsInTossSignTossCert, checkoutPayment, closeView, contactsViral, eventLog, fetchAlbumItems, fetchAlbumPhotos, fetchContacts, generateHapticFeedback, getAnonymousKey, getClipboardText, getConsentedUserData, getCurrentLocation, getDeclaredAgeRange, getDeviceId, getGameCenterGameProfile, getGroupId, getIsTossLoginIntegratedService, getLocale, getNetworkStatus, getOperationalEnvironment, getPlatformOS, getSchemeUri, getServerTime, getTossAppVersion, getTossShareLink, getUserKeyForGame, grantPromotionReward, grantPromotionRewardForGame, iapCreateOneTimePurchaseOrder, isMinVersionSupported, onVisibilityChangedByTransparentServiceWeb, openCamera, openGameCenterLeaderboard, openPDFViewer, openURL, processProductGrant, requestNotificationAgreement, requestOneTimePurchase, requestReview, requestSubscriptionPurchase, requestTossPayPaysBilling, safePostMessage, safeSyncPostMessage, saveBase64Data, setClipboardText, setDeviceOrientation, setIosSwipeGestureEnabled, setScreenAwakeMode, setSecureScreen, share, shareWithScheme, startUpdateLocation, submitGameCenterLeaderBoardScore };

package/dist/index.js

@@ -1099,6 +1099,22 @@ function requestNotificationAgreement(params) {
   });
 }
 
+// src/MiniAppModule/native-modules/getDeclaredAgeRange.ts
+import { Platform as Platform2 } from "react-native";
+var isSupportedPlatform = Platform2.OS === "ios" && parseInt(Platform2.Version, 10) >= 26;
+var MIN_IOS_TOSSAPP_VERSION = "5.266.0";
+var isSupportedTossApp = isMinVersionSupported({ ios: MIN_IOS_TOSSAPP_VERSION, android: "never" });
+async function getDeclaredAgeRange(params) {
+  if (!isSupportedPlatform) {
+    throw new Error("getDeclaredAgeRange\uB294 iOS 26 \uC774\uC0C1\uC5D0\uC11C\uB9CC \uC0AC\uC6A9 \uAC00\uB2A5\uD569\uB2C8\uB2E4.");
+  }
+  if (!isSupportedTossApp) {
+    throw new Error(`getDeclaredAgeRange\uB294 \uD1A0\uC2A4\uC571 ${MIN_IOS_TOSSAPP_VERSION} \uBC84\uC804 \uC774\uC0C1\uC5D0\uC11C\uB9CC \uC0AC\uC6A9 \uAC00\uB2A5\uD569\uB2C8\uB2E4.`);
+  }
+  return await MiniAppModule.postMessage("getDeclaredAgeRange", params, {});
+}
+getDeclaredAgeRange.isSupported = () => isSupportedPlatform && isSupportedTossApp;
+
 // src/MiniAppModule/native-modules/index.ts
 var TossPay = {
   checkoutPayment,
@@ -1134,10 +1150,10 @@ async function closeView() {
 }
 
 // src/BedrockModule/native-modules/natives/getLocale.ts
-import { Platform as Platform2 } from "react-native";
+import { Platform as Platform3 } from "react-native";
 function getLocale() {
   const locale = CommonModule2?.getConstants().locale ?? "ko-KR";
-  if (Platform2.OS === "android") {
+  if (Platform3.OS === "android") {
     return replaceUnderbarToHypen(locale);
   }
   return locale;
@@ -1191,9 +1207,9 @@ function openURL2(url) {
 }
 
 // src/BedrockModule/native-modules/natives/getPlatformOS.ts
-import { Platform as Platform3 } from "react-native";
+import { Platform as Platform4 } from "react-native";
 function getPlatformOS() {
-  return Platform3.OS;
+  return Platform4.OS;
 }
 
 // src/MiniAppModule/native-modules/tossCore.ts
@@ -1237,6 +1253,7 @@ export {
   getClipboardText,
   getConsentedUserData,
   getCurrentLocation,
+  getDeclaredAgeRange,
   getDeviceId,
   getGameCenterGameProfile,
   getGroupId,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@apps-in-toss/native-modules",
   "type": "module",
-  "version": "2.9.3",
+  "version": "2.10.1",
   "description": "Native Modules for Apps In Toss",
   "scripts": {
     "typecheck": "tsc --noEmit",
@@ -42,7 +42,7 @@
     "vitest": "^3.2.4"
   },
   "dependencies": {
-    "@apps-in-toss/types": "2.9.3",
+    "@apps-in-toss/types": "2.10.1",
     "brick-module": "0.5.2",
     "es-toolkit": "^1.39.3"
   },

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

@@ -0,0 +1,30 @@
+import { Platform } from 'react-native';
+import { isMinVersionSupported } from './isMinVersionSupported';
+import { MiniAppModule } from '../../natives';
+
+export interface DeclaredAgeRange {
+  status: 'SHARING' | 'DECLINED_SHARING' | 'UNSUPPORTED_OS' | 'NOT_AVAILABLE' | 'INVALID_REQUEST' | 'FAILED';
+  lowerBound?: number;
+  upperBound?: number;
+  ageRangeDeclaration?: string;
+  activeParentalControls: string[];
+  isEligibleForAgeFeatures?: boolean;
+  errorCode?: string;
+}
+
+const isSupportedPlatform = Platform.OS === 'ios' && parseInt(Platform.Version, 10) >= 26;
+const MIN_IOS_TOSSAPP_VERSION = '5.266.0';
+const isSupportedTossApp = isMinVersionSupported({ ios: MIN_IOS_TOSSAPP_VERSION, android: 'never' });
+
+export async function getDeclaredAgeRange(params: { ageGates: number[] }): Promise<DeclaredAgeRange> {
+  if (!isSupportedPlatform) {
+    throw new Error('getDeclaredAgeRange는 iOS 26 이상에서만 사용 가능합니다.');
+  }
+
+  if (!isSupportedTossApp) {
+    throw new Error(`getDeclaredAgeRange는 토스앱 ${MIN_IOS_TOSSAPP_VERSION} 버전 이상에서만 사용 가능합니다.`);
+  }
+
+  return await MiniAppModule.postMessage('getDeclaredAgeRange', params, {});
+}
+getDeclaredAgeRange.isSupported = () => isSupportedPlatform && isSupportedTossApp;

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

@@ -57,6 +57,7 @@ export * from './getServerTime';
 export * from './getConsentedUserData';
 export * from './requestReview';
 export * from './requestNotificationAgreement';
+export * from './getDeclaredAgeRange';
 
 export type {
   CheckoutPaymentOptions,

package/src/async-bridges.ts

@@ -39,3 +39,4 @@ export * from './MiniAppModule/native-modules/getIsTossLoginIntegratedService';
 export * from './MiniAppModule/native-modules/getServerTime';
 export * from './MiniAppModule/native-modules/getConsentedUserData';
 export * from './MiniAppModule/native-modules/requestReview';
+export * from './MiniAppModule/native-modules/getDeclaredAgeRange';