@apps-in-toss/framework 0.0.22 → 0.0.24

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.cts CHANGED
@@ -1,12 +1,23 @@
1
+ import * as react from 'react';
1
2
  import { ComponentType, PropsWithChildren } from 'react';
2
- import { InitialProps, BedrockProps } from 'react-native-bedrock';
3
- import { EmitterSubscription } from 'react-native';
4
3
  import * as react_jsx_runtime from 'react/jsx-runtime';
4
+ import * as _apps_in_toss_analytics from '@apps-in-toss/analytics';
5
+ export * from '@apps-in-toss/analytics';
6
+ import { InitialProps, BedrockProps, BedrockEventDefinition, BedrockEvent } from 'react-native-bedrock';
7
+ import { EmitterSubscription } from 'react-native';
5
8
  import { PartnerWebViewScreenProps, ExternalWebViewScreenProps } from '@toss-design-system/react-native';
6
9
  import { WebViewProps as WebViewProps$1 } from '@react-native-bedrock/native/react-native-webview';
7
10
 
8
- type AppsInTossProps = Pick<BedrockProps, 'context'>;
9
- declare function registerApp(container: ComponentType<PropsWithChildren<InitialProps>>, { context }: AppsInTossProps): (initialProps: InitialProps) => JSX.Element;
11
+ interface AppsInTossProps {
12
+ context: BedrockProps['context'];
13
+ analytics?: {
14
+ /**
15
+ * 분석 로그 출력 여부를 설정해요. 기본값은 `__DEV__` 예요.
16
+ */
17
+ debug?: boolean;
18
+ };
19
+ }
20
+ declare function registerApp(container: ComponentType<PropsWithChildren<InitialProps>>, { context, analytics }: AppsInTossProps): (initialProps: InitialProps) => JSX.Element;
10
21
 
11
22
  declare const AppsInToss: {
12
23
  registerApp: typeof registerApp;
@@ -116,7 +127,7 @@ interface ImageResponse {
116
127
  dataUri: string;
117
128
  }
118
129
 
119
- interface StartUpdateLocationOptions {
130
+ interface StartUpdateLocationOptions$1 {
120
131
  /**
121
132
  * 위치 정확도를 설정해요.
122
133
  */
@@ -204,397 +215,552 @@ interface UpdateLocationEventEmitter extends EventEmitterSchema<'updateLocation'
204
215
  declare function startUpdateLocation(eventParams: {
205
216
  onEvent: (response: Location) => void;
206
217
  onError: (error: unknown) => void;
207
- options: StartUpdateLocationOptions;
218
+ options: StartUpdateLocationOptions$1;
208
219
  }): () => void;
209
220
 
210
221
  /**
211
222
  * @public
212
- * @category 토스페이
213
- * @name CheckoutPaymentOptions
214
- * @description 토스페이 결제를 생성할 필요한 옵션 객체예요.
215
- * @property {string} orderNo 가맹점의 상품 주문번호예요.
216
- * @property {string} productDesc 상품 설명이에요.
217
- * @property {number} amount 결제 금액이에요.
218
- * @property {number} amountTaxFree 결제 금액 중 비과세 금액이에요.
219
- * @property {number} [amountTaxable] 결제 금액 중 과세 금액이에요.
220
- * @property {number} [amountVat] 결제 금액 중 부가세예요.
221
- * @property {number} [amountServiceFee] 결제 금액 중 봉사료예요.
222
- * @property {'TOSS_MONEY' | 'CARD' | null} [enablePayMethods] 결제수단 구분 변수예요. (TOSS_MONEY: 토스머니만, CARD: 카드만, null: 기본 결제수단)
223
- * @property {boolean} [cashReceipt] 현금영수증 발급 가능 여부예요.
224
- * @property {'CULTURE' | 'GENERAL' | 'PUBLIC_TP'} [cashReceiptTradeOption] 현금영수증 발급 타입이에요. (CULTURE: 문화비, GENERAL: 일반, PUBLIC_TP: 교통비)
225
- * @property {'USE' | 'NO_USE'} [installment] 할부를 사용할 지 말 지 여부에요. (USE: 사용, NO_USE: 할부 미사용)
223
+ * @category 광고
224
+ * @name AdMobFullScreenEvent
225
+ * @description 화면을 덮는 광고(예: 전면 광고, 보상형 광고)를 사용하는 경우에 발생하는 이벤트 타입이에요.
226
+ * @example
227
+ * ### 광고 이벤트 처리하기
228
+ * ```ts
229
+ * function handleEvent(event: AdMobFullScreenEvent) {
230
+ * switch (event.type) {
231
+ * case 'clicked':
232
+ * console.log('광고가 클릭됐어요.');
233
+ * break;
234
+ *
235
+ * case 'dismissed':
236
+ * console.log('광고가 닫혔어요.');
237
+ * break;
238
+ *
239
+ * case 'failedToShow':
240
+ * console.log('광고가 보여지지 않았어요.');
241
+ * break;
242
+ *
243
+ * case 'impression':
244
+ * console.log('광고가 노출됐어요.');
245
+ * break;
246
+ *
247
+ * case 'show':
248
+ * console.log('광고가 보여졌어요.');
249
+ * break;
250
+ * }
251
+ * }
252
+ * ```
226
253
  */
227
- interface CheckoutPaymentOptions {
228
- /**
229
- * 가맹점의 상품 주문번호에요.
230
- */
231
- orderNo: string;
232
- /**
233
- * 상품 설명이에요.
234
- */
235
- productDesc: string;
236
- /**
237
- * 결제 금액이예요.
238
- */
239
- amount: number;
240
- /**
241
- * 결제 금액 중 비과세 금액이에요.
242
- */
243
- amountTaxFree: number;
244
- /**
245
- * 결제 금액 과세 금액이에요.
246
- */
247
- amountTaxable?: number;
248
- /**
249
- * 결제 금액 중 부가세예요.
250
- */
251
- amountVat?: number;
252
- /**
253
- * 결제 금액 봉사료예요.
254
- */
255
- amountServiceFee?: number;
256
- /**
257
- * 결제수단 구분 변수예요.
258
- *
259
- * - 'TOSS_MONEY': 결제수단 토스머니만 노출
260
- * - 'CARD': 결제수단 카드만 노출
261
- * - null: 상점에 설정된 기본 결제 수단 노출
262
- */
263
- enablePayMethods?: 'TOSS_MONEY' | 'CARD' | null;
264
- /**
265
- * 현금영수증 발급 가능 여부예요.
266
- */
267
- cashReceipt?: boolean;
268
- /**
269
- * 현금영수증 발급 타입이에요.
270
- *
271
- * - 'CULTURE': 문화비
272
- * - 'GENERAL': 일반(기본값)
273
- * - 'PUBLIC_TP': 교통비
274
- */
275
- cashReceiptTradeOption?: 'CULTURE' | 'GENERAL' | 'PUBLIC_TP';
254
+ type AdMobFullScreenEvent = AdClicked | AdDismissed | AdFailedToShow | AdImpression | AdShow;
255
+ type AdClicked = {
256
+ type: 'clicked';
257
+ };
258
+ type AdDismissed = {
259
+ type: 'dismissed';
260
+ };
261
+ type AdFailedToShow = {
262
+ type: 'failedToShow';
263
+ };
264
+ type AdImpression = {
265
+ type: 'impression';
266
+ };
267
+ type AdShow = {
268
+ type: 'show';
269
+ };
270
+ interface AdMobHandlerParams<Options = void, Event = AdMobFullScreenEvent> {
271
+ options: Options;
272
+ onEvent: (event: Event) => void;
273
+ onError: (error: unknown) => void;
274
+ }
275
+ /**
276
+ * @public
277
+ * @category 광고
278
+ * @name ResponseInfo
279
+ * @description 광고 로드 응답 정보를 담고 있는 객체예요.
280
+ * @property {Array<AdNetworkResponseInfo>} adNetworkInfoArray 광고 네트워크 응답 정보 배열예요.
281
+ * @property {AdNetworkResponseInfo | null} loadedAdNetworkInfo 로드된 광고 네트워크 응답 정보예요.
282
+ * @property {string | null} responseId 광고 응답 ID예요.
283
+ */
284
+ interface ResponseInfo {
285
+ adNetworkInfoArray: Array<AdNetworkResponseInfo>;
286
+ loadedAdNetworkInfo: AdNetworkResponseInfo | null;
287
+ responseId: string | null;
288
+ }
289
+ /**
290
+ * @public
291
+ * @category 광고
292
+ * @name AdNetworkResponseInfo
293
+ * @description 광고 네트워크 응답 정보를 담고 있는 객체예요.
294
+ * @property {string} adSourceId 광고 소스 ID예요.
295
+ * @property {string} adSourceName 광고 소스 이름이예요.
296
+ * @property {string} adSourceInstanceId 광고 소스 인스턴스 ID예요.
297
+ * @property {string} adSourceInstanceName 광고 소스 인스턴스 이름이예요.
298
+ * @property {string | null} adNetworkClassName 광고 네트워크 클래스 이름이예요.
299
+ */
300
+ interface AdNetworkResponseInfo {
301
+ adSourceId: string;
302
+ adSourceName: string;
303
+ adSourceInstanceId: string;
304
+ adSourceInstanceName: string;
305
+ adNetworkClassName: string | null;
306
+ }
307
+ /**
308
+ * @public
309
+ * @category 광고
310
+ * @name InterstitialAd
311
+ * @description 전면 광고의 ID와 응답 정보를 담고 있는 객체예요. 광고를 로드한 뒤, 관련 정보를 확인할 때 유용해요.
312
+ * @property {string} adUnitId 광고 ID예요.
313
+ * @property {ResponseInfo} responseInfo 광고 로드 응답 정보예요. 자세한 내용은 [ResponseInfo](/react-native/reference/framework/광고/ResponseInfo.html)를 참고하세요.
314
+ */
315
+ interface InterstitialAd {
316
+ adUnitId: string;
317
+ responseInfo: ResponseInfo;
318
+ }
319
+ /**
320
+ * @public
321
+ * @category 광고
322
+ * @name RewardedAd
323
+ * @description 보상형 광고의 ID와 응답 정보를 담고 있는 객체예요. 광고를 로드한 뒤, 관련 정보를 확인할 때 유용해요.
324
+ * @property {string} adUnitId 광고 ID예요.
325
+ * @property {ResponseInfo} responseInfo 광고 로드 응답 정보예요. 자세한 내용은 [ResponseInfo](/react-native/reference/framework/광고/ResponseInfo.html)를 참고하세요.
326
+ */
327
+ interface RewardedAd {
328
+ adUnitId: string;
329
+ responseInfo: ResponseInfo;
330
+ }
331
+
332
+ interface LoadAdMobInterstitialAdOptions {
276
333
  /**
277
- * 할부를 사용할 지 말 지 여부에요.
278
- *
279
- * - 'USE': 사용(기본값)
280
- * - 'NO_USE': 할부 미사용
334
+ * 광고 단위 ID
281
335
  */
282
- installment?: 'USE' | 'NO_USE';
336
+ adUnitId: string;
283
337
  }
284
338
  /**
285
339
  * @public
286
- * @category 토스페이
287
- * @name checkoutPayment
288
- * @description 토스페이 결제를 생성하는 함수예요.
289
- *
290
- * @param {CheckoutPaymentOptions} options 결제를 생성할 때 필요한 옵션 객체예요.
291
- * @param {string} options.orderNo 가맹점의 상품 주문번호예요.
292
- * @param {string} options.productDesc 상품 설명이에요.
293
- * @param {number} options.amount 결제 금액이에요.
294
- * @param {number} options.amountTaxFree 결제 금액 중 비과세 금액이에요.
295
- * @param {number} [options.amountTaxable] 결제 금액 중 과세 금액이에요.
296
- * @param {number} [options.amountVat] 결제 금액 중 부가세예요.
297
- * @param {number} [options.amountServiceFee] 결제 금액 중 봉사료예요.
298
- * @param {'TOSS_MONEY' | 'CARD' | null} [options.enablePayMethods] 결제수단 구분 변수예요. (TOSS_MONEY: 토스머니만, CARD: 카드만, null: 기본 결제수단)
299
- * @param {boolean} [options.cashReceipt] 현금영수증 발급 가능 여부예요.
300
- * @param {'CULTURE' | 'GENERAL' | 'PUBLIC_TP'} [options.cashReceiptTradeOption] 현금영수증 발급 타입이에요. (CULTURE: 문화비, GENERAL: 일반, PUBLIC_TP: 교통비)
301
- * @param {'USE' | 'NO_USE'} [options.installment] 할부를 사용할 지 말 지 여부에요. (USE: 사용, NO_USE: 할부 미사용)
302
- * @returns {Promise<{ payToken: string }>} 결제 인증 후 발급된 결제 토큰 값이 포함된 객체를 반환해요.
340
+ * @category 광고
341
+ * @name LoadAdMobInterstitialAdEvent
342
+ * @description 전면 광고를 불러오는 함수에서 발생하는 이벤트 타입이에요. `loaded` 이벤트가 발생하면 광고를 성공적으로 불러온 거예요. 이때 [InterstitialAd](/react-native/reference/framework/광고/InterstitialAd.html) 객체가 함께 반환돼요.
343
+ */
344
+ type LoadAdMobInterstitialAdEvent = AdMobFullScreenEvent | {
345
+ type: 'loaded';
346
+ data: InterstitialAd;
347
+ };
348
+ /**
349
+ * @public
350
+ * @category 광고
351
+ * @name LoadAdMobInterstitialAdParams
352
+ * @description 전면 광고를 불러오는 함수에 필요한 옵션 객체예요.
353
+ */
354
+ type LoadAdMobInterstitialAdParams = AdMobHandlerParams<LoadAdMobInterstitialAdOptions, LoadAdMobInterstitialAdEvent>;
355
+ /**
356
+ * @public
357
+ * @category 광고
358
+ * @name loadAdMobInterstitialAd
359
+ * @description 앱 화면 전체를 덮는 전면 광고를 미리 불러와서, 광고가 필요한 시점에 바로 보여줄 수 있도록 준비하는 함수예요.
360
+ * @param {LoadAdMobInterstitialAdParams} params 광고를 불러올 때 사용할 설정 값이에요. 광고 ID와 광고의 동작에 대한 콜백을 설정할 수 있어요.
361
+ * @param {LoadAdMobInterstitialAdOptions} params.options 광고를 불러올 때 전달할 옵션 객체예요.
362
+ * @param {string} params.options.adUnitId 광고 단위 ID예요. 발급받은 전면 광고용 ID를 입력해요.
363
+ * @param {(event: LoadAdMobInterstitialAdEvent) => void} [params.onEvent] 광고 관련 이벤트가 발생했을 때 호출돼요. (예시: 광고가 닫히거나 클릭됐을 때). 자세한 이벤트 타입은 [LoadAdMobInterstitialAdEvent](/react-native/reference/framework/광고/LoadAdMobInterstitialAdEvent.html)를 참고하세요.
364
+ * @param {(reason: unknown) => void} [params.onError] 광고를 불러오지 못했을 때 호출돼요. (예시: 네트워크 오류나 지원하지 않는 환경일 때)
365
+ * @property {() => boolean} [isSupported] 현재 실행 중인 앱(예: 토스 앱, 개발용 샌드박스 앱 등)에서 Google AdMob 광고 기능을 지원하는지 확인하는 함수예요. 기능을 사용하기 전에 지원 여부를 확인해야 해요.
303
366
  *
304
367
  * @example
305
- * ### 결제 생성하기
306
- *
368
+ * ### 진입 시 전면광고 불러오기
307
369
  * ```tsx
308
- * import { TossPay } from '@apps-in-toss/framework';
370
+ * import { GoogleAdMob } from '@apps-in-toss/framework';
371
+ * import { useEffect } from 'react';
372
+ * import { View, Text } from 'react-native';
309
373
  *
310
- * async function handlePayment() {
311
- * try {
312
- * const result = await TossPay.checkoutPayment({
313
- * orderNo: 'ORDER_12345',
314
- * productDesc: '티셔츠',
315
- * amount: 15000,
316
- * amountTaxFree: 0,
317
- * amountTaxable: 13636,
318
- * amountVat: 1364,
319
- * enablePayMethods: 'CARD',
320
- * installment: 'USE'
374
+ * const AD_UNIT_ID = '<YOUR_AD_UNIT_ID>';
375
+ *
376
+ * function Page() {
377
+ * useEffect(() => {
378
+ * if (GoogleAdMob.loadAdMobInterstitialAd.isSupported() !== true) {
379
+ * return;
380
+ * }
381
+ *
382
+ * const cleanup = GoogleAdMob.loadAdMobInterstitialAd({
383
+ * options: {
384
+ * adUnitId: AD_UNIT_ID,
385
+ * },
386
+ * onEvent: (event) => {
387
+ * switch (event.type) {
388
+ * case 'loaded':
389
+ * console.log('광고 로드 성공', event.data);
390
+ * break;
391
+ *
392
+ * case 'clicked':
393
+ * console.log('광고 클릭');
394
+ * break;
395
+ *
396
+ * case 'dismissed':
397
+ * console.log('광고 닫힘');
398
+ * break;
399
+ *
400
+ * case 'failedToShow':
401
+ * console.log('광고 보여주기 실패');
402
+ * break;
403
+ *
404
+ * case 'impression':
405
+ * console.log('광고 노출');
406
+ * break;
407
+ *
408
+ * case 'show':
409
+ * console.log('광고 컨텐츠 보여졌음');
410
+ * break;
411
+ * }
412
+ * },
413
+ * onError: (error) => {
414
+ * console.error('광고 불러오기 실패', error);
415
+ * },
321
416
  * });
322
417
  *
323
- * console.log('결제 토큰:', result.payToken);
324
- * } catch (error) {
325
- * console.error('결제 생성에 실패했어요:', error);
326
- * }
418
+ * return cleanup;
419
+ * }, []);
420
+ *
421
+ * return (
422
+ * <View>
423
+ * <Text>Page</Text>
424
+ * </View>
425
+ * );
327
426
  * }
328
427
  * ```
329
428
  */
330
- declare function checkoutPayment(options: CheckoutPaymentOptions): Promise<{
331
- payToken: string;
332
- }>;
333
-
429
+ declare function loadAdMobInterstitialAd(params: LoadAdMobInterstitialAdParams): () => void;
430
+ declare namespace loadAdMobInterstitialAd {
431
+ var isSupported: () => boolean;
432
+ }
433
+ interface ShowAdMobInterstitialAdOptions {
434
+ /**
435
+ * 광고 단위 ID
436
+ */
437
+ adUnitId: string;
438
+ }
334
439
  /**
335
440
  * @public
336
- * @category 토스페이
337
- * @name ExecutePaymentOptions
338
- * @description 생성한 토스페이 결제를 실행할 필요한 옵션이에요.
339
- * @property {string} orderNo 결제를 생성할 때 사용한 주문번호예요.
340
- * @property {string} payToken 결제 인증 과정에서 전달받은 결제 토큰이에요. 결제를 실행할 때 사용해요.
441
+ * @category 광고
442
+ * @name ShowAdMobInterstitialAdEvent
443
+ * @description 전면 광고를 보여주는 함수에서 발생하는 이벤트 타입이에요. `requested` 이벤트가 발생하면 광고 노출 요청이 Google AdMob에 성공적으로 전달된 거예요.
444
+ */
445
+ type ShowAdMobInterstitialAdEvent = {
446
+ type: 'requested';
447
+ };
448
+ /**
449
+ * @public
450
+ * @category 광고
451
+ * @name ShowAdMobInterstitialAdParams
452
+ * @description 불러온 전면 광고를 보여주는 함수에 필요한 옵션 객체예요.
453
+ */
454
+ type ShowAdMobInterstitialAdParams = AdMobHandlerParams<ShowAdMobInterstitialAdOptions, ShowAdMobInterstitialAdEvent>;
455
+ /**
456
+ * @public
457
+ * @category 광고
458
+ * @name showAdMobInterstitialAd
459
+ * @description 앱 화면 전체를 덮는 전면 광고를 사용자에게 노출해요. 이 함수는 `loadAdMobInterstitialAd` 로 미리 불러온 광고를 실제로 사용자에게 노출해요.
460
+ * @param {ShowAdMobInterstitialAdParams} params 광고를 보여주기 위해 사용할 설정 값이에요. 광고 ID와과 광고의 동작에 대한 콜백을 설정할 수 있어요.
461
+ * @param {ShowAdMobInterstitialAdOptions} params.options 광고를 보여줄 때 전달할 옵션 객체예요.
462
+ * @param {string} params.options.adUnitId 광고 단위 ID예요. `loadAdMobInterstitialAd` 로 불러온 전면 광고용 ID를 입력해요.
463
+ * @param {(event: ShowAdMobInterstitialAdEvent) => void} [params.onEvent] 광고 관련 이벤트가 발생했을 때 호출돼요. (예시: 광고 노출을 요청했을 때). 자세한 이벤트 타입은 [ShowAdMobInterstitialAdEvent](/react-native/reference/framework/광고/ShowAdMobInterstitialAdEvent.html)를 참고하세요.
464
+ * @param {(reason: unknown) => void} [params.onError] 광고를 노출하지 못했을 때 호출돼요. (예시: 네트워크 오류나 지원하지 않는 환경일 때)
465
+ * @property {() => boolean} [isSupported] 현재 실행 중인 앱(예: 토스 앱, 개발용 샌드박스 앱 등)에서 Google AdMob 광고 기능을 지원하는지 확인하는 함수예요. 기능을 사용하기 전에 지원 여부를 확인해야 해요.
466
+ *
467
+ * @example
468
+ * ### 버튼 눌러 불러온 전면 광고 보여주기
469
+ * ```tsx
470
+ * import { GoogleAdMob } from '@apps-in-toss/framework';
471
+ * import { View, Button } from 'react-native';
472
+ *
473
+ * const AD_UNIT_ID = '<YOUR_AD_UNIT_ID>';
474
+ *
475
+ * function Page() {
476
+ * const handlePress = () => {
477
+ * if (GoogleAdMob.showAdMobInterstitialAd.isSupported() !== true) {
478
+ * return;
479
+ * }
480
+ *
481
+ * GoogleAdMob.showAdMobInterstitialAd({
482
+ * options: {
483
+ * adUnitId: AD_UNIT_ID,
484
+ * },
485
+ * onEvent: (event) => {
486
+ * switch (event.type) {
487
+ * case 'requested':
488
+ * console.log('광고 보여주기 요청 완료');
489
+ * break;
490
+ * }
491
+ * },
492
+ * onError: (error) => {
493
+ * console.error('광고 보여주기 실패', error);
494
+ * },
495
+ * });
496
+ * }
497
+ *
498
+ * return (
499
+ * <Button onPress={handlePress} title="광고 보기" />
500
+ * );
501
+ * }
502
+ * ```
341
503
  */
342
- interface ExecutePaymentOptions {
504
+ declare function showAdMobInterstitialAd(params: ShowAdMobInterstitialAdParams): () => void;
505
+ declare namespace showAdMobInterstitialAd {
506
+ var isSupported: () => boolean;
507
+ }
508
+ interface LoadAdMobRewardedAdOptions {
343
509
  /**
344
- * 결제를 생성할 때 사용한 주문번호예요.
510
+ * 광고 단위 ID
345
511
  */
346
- orderNo: string;
512
+ adUnitId: string;
513
+ }
514
+ /**
515
+ * @public
516
+ * @category 광고
517
+ * @name LoadAdMobInterstitialAdEvent
518
+ * @description 보상형 광고를 불러오는 함수에서 발생하는 이벤트 타입이에요. `loaded` 이벤트가 발생하면 광고를 성공적으로 불러온 거예요. 이때 [RewardedAd](/react-native/reference/framework/광고/RewardedAd.html) 객체가 함께 반환돼요. `userEarnedReward` 이벤트는 사용자가 광고를 끝까지 시청해, 보상 조건을 충족했을 때 발생해요.
519
+ */
520
+ type LoadAdMobRewardedAdEvent = AdMobFullScreenEvent | {
521
+ type: 'loaded';
522
+ data: RewardedAd;
523
+ } | {
524
+ type: 'userEarnedReward';
525
+ };
526
+ /**
527
+ * @public
528
+ * @category 광고
529
+ * @name LoadAdMobRewardedAdParams
530
+ * @description 보상형 광고를 불러오는 함수에 필요한 옵션 객체예요.
531
+ */
532
+ type LoadAdMobRewardedAdParams = AdMobHandlerParams<LoadAdMobRewardedAdOptions, LoadAdMobRewardedAdEvent>;
533
+ /**
534
+ * @public
535
+ * @category 광고
536
+ * @name loadAdMobRewardedAd
537
+ * @description 사용자가 광고를 끝까지 시청하면 리워드를 제공할 수 있는 보상형 광고를 미리 불러와서, 광고가 필요한 시점에 바로 보여줄 수 있도록 준비하는 함수예요.
538
+ * @param {LoadAdMobRewardedAdParams} params 광고를 불러올 때 사용할 설정 값이에요. 광고 ID와 광고의 동작에 대한 콜백을 설정할 수 있어요.
539
+ * @param {LoadAdMobRewardedAdOptions} params.options 광고를 불러올 때 전달할 옵션 객체예요.
540
+ * @param {string} params.options.adUnitId 광고 단위 ID예요. 발급받은 보상형 광고용 ID를 입력해요.
541
+ * @param {(event: LoadAdMobRewardedAdEvent) => void} [params.onEvent] 광고 관련 이벤트가 발생했을 때 호출돼요. (예시: 광고가 닫히거나 클릭됐을 때). 자세한 이벤트 타입은 [LoadAdMobRewardedAdEvent](/react-native/reference/framework/광고/LoadAdMobRewardedAdEvent.html)를 참고하세요.
542
+ * @param {(reason: unknown) => void} [params.onError] 광고를 불러오지 못했을 때 호출돼요. (예시: 네트워크 오류나 지원하지 않는 환경일 때)
543
+ * @property {() => boolean} [isSupported] 현재 실행 중인 앱(예: 토스 앱, 개발용 샌드박스 앱 등)에서 Google AdMob 광고 기능을 지원하는지 확인하는 함수예요. 기능을 사용하기 전에 지원 여부를 확인해야 해요.
544
+ *
545
+ * @example
546
+ * ### 뷰 진입 시 보상형 광고 불러오기
547
+ * ```tsx
548
+ * import { GoogleAdMob } from '@apps-in-toss/framework';
549
+ * import { useEffect } from 'react';
550
+ * import { View, Text } from 'react-native';
551
+ *
552
+ * const AD_UNIT_ID = '<YOUR_AD_UNIT_ID>';
553
+ *
554
+ * function Page() {
555
+ * useEffect(() => {
556
+ * if (GoogleAdMob.loadAdMobRewardedAd.isSupported() !== true) {
557
+ * return;
558
+ * }
559
+ *
560
+ * const cleanup = GoogleAdMob.loadAdMobRewardedAd({
561
+ * options: {
562
+ * adUnitId: AD_UNIT_ID,
563
+ * },
564
+ * onEvent: (event) => {
565
+ * switch (event.type) {
566
+ * case 'loaded':
567
+ * console.log('광고 로드 성공', event.data);
568
+ * break;
569
+ *
570
+ * case 'clicked':
571
+ * console.log('광고 클릭');
572
+ * break;
573
+ *
574
+ * case 'dismissed':
575
+ * console.log('광고 닫힘');
576
+ * break;
577
+ *
578
+ * case 'failedToShow':
579
+ * console.log('광고 보여주기 실패');
580
+ * break;
581
+ *
582
+ * case 'impression':
583
+ * console.log('광고 노출');
584
+ * break;
585
+ *
586
+ * case 'show':
587
+ * console.log('광고 컨텐츠 보여졌음');
588
+ * break;
589
+ *
590
+ * case 'userEarnedReward':
591
+ * console.log('사용자가 광고 시청을 완료했음');
592
+ * break;
593
+ * }
594
+ * },
595
+ * onError: (error) => {
596
+ * console.error('광고 불러오기 실패', error);
597
+ * },
598
+ * });
599
+ *
600
+ * return cleanup;
601
+ * }, []);
602
+ *
603
+ * return (
604
+ * <View>
605
+ * <Text>Page</Text>
606
+ * </View>
607
+ * );
608
+ * }
609
+ * ```
610
+ */
611
+ declare function loadAdMobRewardedAd(params: LoadAdMobRewardedAdParams): () => void;
612
+ declare namespace loadAdMobRewardedAd {
613
+ var isSupported: () => boolean;
614
+ }
615
+ interface ShowAdMobRewardedAdOptions {
347
616
  /**
348
- * 결제 인증 과정에서 전달받은 Pay 토큰이에요.
617
+ * 광고 단위 ID
349
618
  */
350
- payToken: string;
619
+ adUnitId: string;
620
+ }
621
+ /**
622
+ * @public
623
+ * @category 광고
624
+ * @name ShowAdMobRewardedAdEvent
625
+ * @description 보상형 광고를 보여주는 함수에서 발생하는 이벤트 타입이에요. `requested` 이벤트가 발생하면 광고 노출 요청이 Google AdMob에 성공적으로 전달된 거예요.
626
+ */
627
+ type ShowAdMobRewardedAdEvent = {
628
+ type: 'requested';
629
+ };
630
+ /**
631
+ * @public
632
+ * @category 광고
633
+ * @name ShowAdMobRewardedAdParams
634
+ * @description 불러온 보상형 광고를 보여주는 함수에 필요한 옵션 객체예요.
635
+ */
636
+ type ShowAdMobRewardedAdParams = AdMobHandlerParams<ShowAdMobRewardedAdOptions, ShowAdMobRewardedAdEvent>;
637
+ /**
638
+ * @public
639
+ * @category 광고
640
+ * @name showAdMobRewardedAd
641
+ * @description 사용자가 광고를 끝까지 보면 리워드를 받을 수 있도록, 보상형 광고를 화면에 보여줘요. 이 함수는 `loadAdMobRewardedAd` 로 미리 불러온 광고를 실제로 사용자에게 노출해요.
642
+ * @param {ShowAdMobRewardedAdParams} params 광고를 보여주기 위해 사용할 설정 값이에요. 광고 ID와 광고의 동작에 대한 콜백을 설정할 수 있어요.
643
+ * @param {ShowAdMobRewardedAdOptions} params.options 광고를 보여줄 때 전달할 옵션 객체예요.
644
+ * @param {string} params.options.adUnitId 광고 단위 ID예요. `loadAdMobRewardedAd` 로 불러온 보상형 광고용 ID를 입력해요.
645
+ * @param {(event: ShowAdMobRewardedAdEvent) => void} [params.onEvent] 광고 관련 이벤트가 발생했을 때 호출돼요. (예시: 광고 노출을 요청했을 때). 자세한 이벤트 타입은 [ShowAdMobRewardedAdEvent](/react-native/reference/framework/광고/ShowAdMobRewardedAdEvent.html)를 참고하세요.
646
+ * @param {(reason: unknown) => void} [params.onError] 광고를 불러오지 못했을 때 호출돼요. (예시: 네트워크 오류나 지원하지 않는 환경일 때)
647
+ * @property {() => boolean} [isSupported] 현재 실행 중인 앱(예: 토스 앱, 개발용 샌드박스 앱 등)에서 Google AdMob 광고 기능을 지원하는지 확인하는 함수예요. 기능을 사용하기 전에 지원 여부를 확인해야 해요.
648
+ *
649
+ * @example
650
+ * ### 버튼 눌러 불러온 보상형 광고 보여주기
651
+ * ```tsx
652
+ * import { GoogleAdMob } from '@apps-in-toss/framework';
653
+ * import { View, Text, Button } from 'react-native';
654
+ *
655
+ * const AD_UNIT_ID = '<YOUR_AD_UNIT_ID>';
656
+ *
657
+ * function Page() {
658
+ * const handlePress = () => {
659
+ * if (GoogleAdMob.showAdMobRewardedAd.isSupported() !== true) {
660
+ * return;
661
+ * }
662
+ *
663
+ * GoogleAdMob.showAdMobRewardedAd({
664
+ * options: {
665
+ * adUnitId: AD_UNIT_ID,
666
+ * },
667
+ * onEvent: (event) => {
668
+ * switch (event.type) {
669
+ * case 'requested':
670
+ * console.log('광고 보여주기 요청 완료');
671
+ * break;
672
+ * }
673
+ * },
674
+ * onError: (error) => {
675
+ * console.error('광고 보여주기 실패', error);
676
+ * },
677
+ * });
678
+ * }
679
+ *
680
+ * return (
681
+ * <Button onPress={handlePress} title="광고 보기" />
682
+ * );
683
+ * }
684
+ * ```
685
+ */
686
+ declare function showAdMobRewardedAd(params: ShowAdMobRewardedAdParams): () => void;
687
+ declare namespace showAdMobRewardedAd {
688
+ var isSupported: () => boolean;
351
689
  }
690
+
352
691
  /**
353
692
  * @public
354
693
  * @category 토스페이
355
- * @name CardExecutePaymentResult
356
- * @description 카드로 결제 요청을 실행한 돌아오는 결제 결과 객체예요. 결제 승인 여부, 결제된 금액, 주문 정보 등을 담고 있어요.
357
- * @property {'CARD'} payMethod 결제 수단이에요.
358
- * @property {number} code 결제 요청의 결과 코드예요.
359
- * @property {'LIVE' | 'TEST'} mode 현재 결제 환경이에요.
360
- * @property {string} orderNo 주문번호예요.
361
- * @property {number} amount 총 결제 금액이에요.
362
- * @property {string} approvalTime 결제가 승인된 시간이에요. (ISO 8601 형식)
363
- * @property {string} stateMsg 결제 상태 메시지예요.
364
- * @property {number} discountedAmount 적용된 할인 금액이에요.
365
- * @property {number} paidAmount 실제 결제된 금액이에요.
366
- * @property {string} payToken 결제 요청 시 사용한 Pay 토큰이에요.
367
- * @property {string} transactionId 거래 ID예요.
368
- * @property {number} cardCompanyCode 카드사 코드예요.
369
- * @property {string} cardCompanyName 카드사 이름이에요.
370
- * @property {string} cardAuthorizationNo 카드사 승인 번호예요. (라이브 결제 환경에서만 확인 가능해요)
371
- * @property {number} spreadOut 할부 개월 수예요. (5만원 미만 금액 및 일시불 결제의 경우에는 `0`)
372
- * @property {boolean} noInterest 무이자 할부 여부예요.
373
- * @property {string} salesCheckLinkUrl 결제 내역을 확인할 수 있는 매출전표 URL이에요.
374
- * @property {'CREDIT' | 'CHECK' | 'PREPAYMENT'} cardMethodType 카드 유형이에요.
375
- * @property {string} cardNumber 마스킹된 카드 번호예요. (`****-****-****-1234` 형식)
376
- * @property {string} cardNum4Print 카드 번호의 마지막 4자리예요.
377
- * @property {string} cardBinNumber 카드 BIN 번호예요.
694
+ * @name CheckoutPaymentOptions
695
+ * @description 토스페이 결제창을 띄울 필요한 옵션이에요.
696
+ * @property {string} payToken 결제 토큰이에요.
378
697
  */
379
- interface CardExecutePaymentResult {
380
- /**
381
- * 결제 수단이에요.
382
- */
383
- payMethod: 'CARD';
384
- /**
385
- * 결제 요청의 결과 코드예요.
386
- */
387
- code: number;
388
- /**
389
- * 현재 결제 환경이에요.
390
- *
391
- * - `LIVE`: 실제 환경
392
- * - `TEST`: 테스트 환경
393
- */
394
- mode: 'LIVE' | 'TEST';
395
- /**
396
- * 주문번호예요.
397
- */
398
- orderNo: string;
399
- /**
400
- * 총 결제 금액이에요.
401
- */
402
- amount: number;
403
- /**
404
- * 결제가 승인된 시간이에요. (ISO 8601 형식)
405
- */
406
- approvalTime: string;
407
- /**
408
- * 결제 상태 메시지예요.
409
- */
410
- stateMsg: string;
411
- /**
412
- * 적용된 할인 금액이에요.
413
- */
414
- discountedAmount: number;
415
- /**
416
- * 실제 결제된 금액이에요.
417
- */
418
- paidAmount: number;
698
+ interface CheckoutPaymentOptions {
419
699
  /**
420
- * 결제 요청 시 사용한 Pay 토큰이에요.
700
+ * 결제 토큰이에요.
421
701
  */
422
702
  payToken: string;
423
- /**
424
- * 거래 ID예요.
425
- */
426
- transactionId: string;
427
- /**
428
- * 카드사 코드예요.
429
- */
430
- cardCompanyCode: number;
431
- /**
432
- * 카드사 이름이에요.
433
- */
434
- cardCompanyName: string;
435
- /**
436
- * 카드사 승인 번호예요. (라이브 결제 환경에서만 확인 가능해요)
437
- */
438
- cardAuthorizationNo: string;
439
- /**
440
- * 할부 개월 수예요. (5만원 미만 금액 및 일시불 결제의 경우에는 `0`)
441
- */
442
- spreadOut: number;
443
- /**
444
- * 무이자 할부 여부예요.
445
- */
446
- noInterest: boolean;
447
- /**
448
- * 결제 내역을 확인할 수 있는 매출전표 URL이에요.
449
- */
450
- salesCheckLinkUrl: string;
451
- /**
452
- * 카드 유형이에요.
453
- *
454
- * - 'CREDIT': 신용카드
455
- * - 'CHECK': 체크카드
456
- * - 'PREPAYMENT': 선불카드
457
- */
458
- cardMethodType: 'CREDIT' | 'CHECK' | 'PREPAYMENT';
459
- /**
460
- * 마스킹된 카드 번호예요. (`****-****-****-1234` 형식)
461
- */
462
- cardNumber: string;
463
- /**
464
- * 카드 사용자 구분을 나타내는 값이에요.
465
- *
466
- * - 'PERSONAL': 개인 카드
467
- * - 'PERSONAL_FAMILY': 가족 카드
468
- * - 'CORP_PERSONAL': 법인지정 결제계좌 (임직원)
469
- * - 'CORP_PRIVATE': 법인 공용
470
- * - 'CORP_COMPANY': 법인지정 결제계좌 회사 (하나카드 Only)
471
- */
472
- cardUserType: 'PERSONAL' | 'PERSONAL_FAMILY' | 'CORP_PERSONAL' | 'CORP_PRIVATE' | 'CORP_COMPANY';
473
- /**
474
- * 카드 번호의 마지막 4자리예요.
475
- */
476
- cardNum4Print: string;
477
- /**
478
- * 카드 BIN 번호예요.
479
- */
480
- cardBinNumber: string;
481
703
  }
482
704
  /**
483
705
  * @public
484
706
  * @category 토스페이
485
- * @name TossMoneyExecutePaymentResult
486
- * @description 토스머니로 결제 요청을 실행한 돌아오는 결제 결과 객체예요. 결제 승인 여부, 결제된 금액, 주문 정보 등을 담고 있어요.
487
- * @property {'TOSS_MONEY'} payMethod 결제 수단이에요.
488
- * @property {number} code 결제 요청의 결과 코드예요.
489
- * @property {'LIVE' | 'TEST'} mode 현재 결제 환경이에요.
490
- * @property {string} orderNo 주문번호예요.
491
- * @property {number} amount 총 결제 금액이에요.
492
- * @property {string} approvalTime 결제가 승인된 시간이에요. (ISO 8601 형식)
493
- * @property {string} stateMsg 결제 상태 메시지예요.
494
- * @property {number} discountedAmount 적용된 할인 금액이에요.
495
- * @property {number} paidAmount 실제 결제된 금액이에요.
496
- * @property {string} payToken 결제 요청 시 사용한 Pay 토큰이에요.
497
- * @property {string} transactionId 거래 ID예요.
498
- * @property {string} cashReceiptMgtKey 현금영수증 관리번호 식별값이에요.
499
- * @property {string} accountBankName 결제된 은행의 코드예요.
500
- * @property {string} accountNumber 결제된 계좌번호예요.
707
+ * @name CheckoutPaymentResult
708
+ * @description 토스페이 결제창에서 사용자가 인증에 성공했는지 여부예요.
709
+ * @property {boolean} success 인증이 성공했는지 여부예요.
710
+ * @property {string} [reason] 인증이 실패했을 경우의 이유예요.
501
711
  */
502
- interface TossMoneyExecutePaymentResult {
503
- /**
504
- * 결제에 사용된 결제 수단이에요.
505
- */
506
- payMethod: 'TOSS_MONEY';
507
- /**
508
- * 결제 요청의 결과 코드예요.
509
- */
510
- code: number;
511
- /**
512
- * 현재 결제 환경이에요.
513
- *
514
- * - `LIVE`: 실제 환경
515
- * - `TEST`: 테스트 환경
516
- */
517
- mode: 'LIVE' | 'TEST';
518
- /**
519
- * 결제 승인된 상품의 주문번호예요.
520
- */
521
- orderNo: string;
522
- /**
523
- * 결제 승인된 상품의 총 결제 금액이에요.
524
- */
525
- amount: number;
526
- /**
527
- * 결제가 승인된 시간이에요. (ISO 8601 형식)
528
- */
529
- approvalTime: string;
530
- /**
531
- * 결제 상태 메시지예요.
532
- */
533
- stateMsg: string;
712
+ interface CheckoutPaymentResult {
534
713
  /**
535
- * 적용된 할인 금액이에요.
714
+ * 인증이 성공했는지 여부예요.
536
715
  */
537
- discountedAmount: number;
716
+ success: boolean;
538
717
  /**
539
- * 실제 결제 승인된 금액이에요.
718
+ * 인증이 실패했을 경우의 이유예요.
540
719
  */
541
- paidAmount: number;
542
- /**
543
- * 결제 요청 시 사용한 Pay 토큰이에요.
544
- */
545
- payToken: string;
546
- /**
547
- * 거래 ID예요.
548
- */
549
- transactionId: string;
550
- /**
551
- * 현금영수증 관리번호 식별값이에요.
552
- */
553
- cashReceiptMgtKey: string;
554
- /**
555
- * 결제된 은행의 코드예요.
556
- */
557
- accountBankName: string;
558
- /**
559
- * 결제된 계좌번호예요.
560
- */
561
- accountNumber: string;
720
+ reason?: string;
562
721
  }
563
722
  /**
564
723
  * @public
565
724
  * @category 토스페이
566
- * @name executePayment
567
- * @description 구매자가 결제를 시도하면, 먼저 결제 정보를 생성하고 인증을 받아요. 이때 결제 상태는 '대기' 중이에요. 이후 결제를 실제로 승인하려면 주어진 주문번호와 결제 토큰을 사용해서 이 함수로 생성된 결제를 승인해요. 결제 승인이 완료되면, 구매자의 결제 수단(예: 카드, 계좌)에서 실제로 금액이 출금돼요. 이 함수를 호출하지 않으면 결제가 자동으로 만료되고, 출금도 발생하지 않아요.
725
+ * @name checkoutPayment
726
+ * @description 토스페이 결제창을 띄우고, 사용자 인증을 수행해요. 인증이 완료되면 성공 여부를 반환해요.
727
+ *
728
+ * 이 함수는 결제창을 통해 사용자 인증만 해요. 실제 결제 처리는 인증 성공 후 서버에서 별도로 해야 해요.
568
729
  *
569
- * @param {ExecutePaymentOptions} options 결제를 실행할 때 필요한 옵션이에요.
570
- * @param {string} options.orderNo 결제를 생성할 사용한 주문번호예요.
571
- * @param {string} options.payToken 결제 인증 과정에서 전달받은 결제 토큰이에요. 결제를 실행할 때 사용해요.
572
- * @returns {Promise<CardExecutePaymentResult | TossMoneyExecutePaymentResult>} 결제 결과 객체를 반환해요. 자세한 내용은 [카드 결제 결과](/react-native/reference/framework/토스페이/CardExecutePaymentResult.html) 또는 [토스머니 결제 결과](/react-native/reference/framework/토스페이/TossMoneyExecutePaymentResult.html)를 참고하세요.
730
+ * @param {CheckoutPaymentOptions} options 결제창을 띄울 때 필요한 옵션이에요.
731
+ * @returns {Promise<CheckoutPaymentResult>} 인증 성공 여부를 포함한 결과를 반환해요.
573
732
  *
574
733
  * @example
575
734
  *
576
- * ### 카드 결제 실행하기
735
+ * ### 토스페이 결제창 띄우고 인증 처리하기
577
736
  *
578
737
  * ```tsx
579
738
  * import { TossPay } from '@apps-in-toss/framework';
580
739
  *
581
740
  * async function handlePayment() {
582
741
  * try {
583
- * const payToken = 'PAY_TOKEN_12345'; // 결제 인증 받은 토큰
742
+ * // 실제 구현 결제 생성 역할을 하는 API 엔드포인트로 대체해주세요.
743
+ * const { payToken } = await fetch('/my-api/payment/create').then(res => res.json());
584
744
  *
585
- * const result = await TossPay.executePayment({
586
- * orderNo: 'ORDER_12345',
587
- * payToken,
588
- * });
745
+ * const { success, reason } = await TossPay.checkoutPayment({ payToken });
589
746
  *
590
- * console.log('결제가 완료되었어요:', result);
747
+ * if (success) {
748
+ * // 실제 구현 시 결제를 실행하는 API 엔드포인트로 대체해주세요.
749
+ * await fetch('/my-api/payment/execute', {
750
+ * method: 'POST',
751
+ * body: JSON.stringify({ payToken }),
752
+ * headers: { 'Content-Type': 'application/json' },
753
+ * });
754
+ * } else {
755
+ * console.log('인증 실패:', reason);
756
+ * }
591
757
  * } catch (error) {
592
- * console.error('결제에 실패했어요:', error);
758
+ * console.error('결제 인증 중 오류가 발생했어요:', error);
593
759
  * }
594
760
  * }
595
761
  * ```
596
762
  */
597
- declare function executePayment(options: ExecutePaymentOptions): Promise<CardExecutePaymentResult | TossMoneyExecutePaymentResult>;
763
+ declare function checkoutPayment(options: CheckoutPaymentOptions): Promise<CheckoutPaymentResult>;
598
764
 
599
765
  /**
600
766
  * @public
@@ -1159,10 +1325,10 @@ declare function clearItems(): Promise<void>;
1159
1325
  * @category 저장소
1160
1326
  * @name Storage
1161
1327
  * @description 네이티브의 저장소를 사용해요.
1162
- * @property {typeof getItem} [getItem] 모바일 앱의 로컬 저장소에서 아이템을 가져오는 함수예요. 자세한 내용은 [getItem](/react-native/reference/framework/저장소/getItem)을 참고하세요.
1163
- * @property {typeof setItem} [setItem] 모바일 앱의 로컬 저장소에 아이템을 저장하는 함수예요. 자세한 내용은 [setItem](/react-native/reference/framework/저장소/setItem)을 참고하세요.
1164
- * @property {typeof removeItem} [removeItem] 모바일 앱의 로컬 저장소에서 아이템을 삭제하는 함수예요. 자세한 내용은 [removeItem](/react-native/reference/framework/저장소/removeItem)을 참고하세요.
1165
- * @property {typeof clearItems} [clearItems] 모바일 앱의 로컬 저장소를 초기화하는 함수예요. 자세한 내용은 [clearItems](/react-native/reference/framework/저장소/clearItems)을 참고하세요.
1328
+ * @property {typeof getItem} [getItem] 모바일 앱의 로컬 저장소에서 아이템을 가져오는 함수예요. 자세한 내용은 [getItem](/react-native/reference/framework/저장소/getItem.html)을 참고하세요.
1329
+ * @property {typeof setItem} [setItem] 모바일 앱의 로컬 저장소에 아이템을 저장하는 함수예요. 자세한 내용은 [setItem](/react-native/reference/framework/저장소/setItem.html)을 참고하셰요.
1330
+ * @property {typeof removeItem} [removeItem] 모바일 앱의 로컬 저장소에서 아이템을 삭제하는 함수예요. 자세한 내용은 [removeItem](/react-native/reference/framework/저장소/removeItem.html)을 참고하세요.
1331
+ * @property {typeof clearItems} [clearItems] 모바일 앱의 로컬 저장소를 초기화하는 함수예요. 자세한 내용은 [clearItems](/react-native/reference/framework/저장소/clearItems.html)을 참고하세요.
1166
1332
  */
1167
1333
  declare const Storage: {
1168
1334
  getItem: typeof getItem;
@@ -1171,13 +1337,100 @@ declare const Storage: {
1171
1337
  clearItems: typeof clearItems;
1172
1338
  };
1173
1339
 
1340
+ /**
1341
+ * @public
1342
+ * @category 환경 확인
1343
+ * @kind function
1344
+ * @name isMinVersionSupported
1345
+ * @description
1346
+ * 현재 토스 앱 버전이 지정한 최소 버전 이상인지 확인해요.
1347
+ *
1348
+ * 이 함수는 현재 실행 중인 토스 앱의 버전이 파라미터로 전달된 최소 버전 요구사항을 충족하는지 확인해요. 특정 기능이 최신 버전에서만 동작할 때, 사용자에게 앱 업데이트를 안내할 수 있어요.
1349
+ *
1350
+ * @param {Object} minVersions 플랫폼별 최소 버전 요구사항을 지정하는 객체예요.
1351
+ * @param {(`${number}.${number}.${number}` | 'always' | 'never')} minVersions.android 안드로이드 플랫폼의 최소 버전 요구사항이에요.
1352
+ * @param {(`${number}.${number}.${number}` | 'always' | 'never')} minVersions.ios iOS 플랫폼의 최소 버전 요구사항이에요.
1353
+ * @returns {boolean} 현재 앱 버전이 최소 버전 이상이면 true, 그렇지 않으면 false를 반환해요.
1354
+ *
1355
+ * @example
1356
+ * ### 앱 버전 확인하기
1357
+ *
1358
+ * ```tsx
1359
+ * import { isMinVersionSupported } from '@apps-in-toss/framework';
1360
+ * import { Text, View } from 'react-native';
1361
+ *
1362
+ * function VersionCheck() {
1363
+ * const isSupported = isMinVersionSupported({
1364
+ * android: '1.2.0',
1365
+ * ios: '1.3.0'
1366
+ * });
1367
+ *
1368
+ * return (
1369
+ * <View>
1370
+ * {!isSupported && (
1371
+ * <Text>최신 버전으로 업데이트가 필요해요.</Text>
1372
+ * )}
1373
+ * </View>
1374
+ * );
1375
+ * }
1376
+ * ```
1377
+ */
1378
+ declare function isMinVersionSupported(minVersions: {
1379
+ android: `${number}.${number}.${number}` | 'always' | 'never';
1380
+ ios: `${number}.${number}.${number}` | 'always' | 'never';
1381
+ }): boolean;
1382
+
1383
+ type Primitive = string | number | boolean | null | undefined | symbol;
1384
+
1385
+ interface EventLogParams {
1386
+ log_name: string;
1387
+ log_type: 'debug' | 'info' | 'warn' | 'error' | 'screen' | 'impression' | 'click';
1388
+ params: Record<string, Primitive>;
1389
+ }
1390
+ /**
1391
+ * @category 로깅
1392
+ * @kind function
1393
+ * @name eventLog
1394
+ * @description
1395
+ * 이벤트 로그를 기록하는 함수예요.
1396
+ *
1397
+ * 이 함수는 앱 내에서 발생하는 다양한 이벤트를 로깅하는 데 사용돼요. 디버깅, 정보 제공, 경고, 오류 등 다양한 유형의 로그를 기록할 수 있어요. 샌드박스 환경에서는 콘솔에 로그가 출력되고, 실제 환경에서는 로그 시스템에 기록돼요.
1398
+ *
1399
+ * @param {Object} params 로그 기록에 필요한 매개변수 객체예요.
1400
+ * @param {string} params.log_name 로그의 이름이에요.
1401
+ * @param {'debug' | 'info' | 'warn' | 'error' | 'screen' | 'impression' | 'click'} params.log_type 로그의 유형이에요.
1402
+ * @param {Record<string, Primitive>} params.params 로그에 포함할 추가 매개변수 객체예요.
1403
+ *
1404
+ * @returns {Promise<void>} 로그 기록이 완료되면 해결되는 Promise예요.
1405
+ *
1406
+ * @example
1407
+ * ### 이벤트 로그 기록하기
1408
+ *
1409
+ * ```tsx
1410
+ * import { eventLog } from '@apps-in-toss/framework';
1411
+ *
1412
+ * function logUserAction() {
1413
+ * eventLog({
1414
+ * log_name: 'user_action',
1415
+ * log_type: 'info',
1416
+ * params: {
1417
+ * action: 'button_click',
1418
+ * screen: 'main',
1419
+ * userId: 12345
1420
+ * }
1421
+ * });
1422
+ * }
1423
+ * ```
1424
+ */
1425
+ declare function eventLog(params: EventLogParams): Promise<void>;
1426
+
1174
1427
  /**
1175
1428
  * @public
1176
1429
  * @category 공유
1177
1430
  * @kind function
1178
1431
  * @name getTossShareLink
1179
1432
  * @description
1180
- * `getTossShareLink` 함수는 사용자가 지정한 경로를 토스 앱에서 열 수 공유 링크를 반환해요.
1433
+ * `getTossShareLink` 함수는 사용자가 지정한 경로를 토스 앱에서 열 수 있는 공유 링크를 반환해요.
1181
1434
  * 이 링크를 다른 사람과 공유하면 토스 앱이 실행되면서 지정한 경로로 진입해요. 토스앱이 없는 사람은 iOS 일 때는 앱스토어로 이동하고, Android 일 때는 플레이스토어로 이동해요.
1182
1435
  *
1183
1436
  * 경로는 토스 앱 내부 특정 화면을 나타내는 딥링크(deep link) 형식이어야 해요.
@@ -1190,7 +1443,8 @@ declare const Storage: {
1190
1443
  *
1191
1444
  * @example
1192
1445
  * ```tsx
1193
- * import { getTossShareLink, share } from '@apps-in-toss/framework';
1446
+ * import { share } from 'react-native-bedrock';
1447
+ * import { getTossShareLink } from '@apps-in-toss/framework';
1194
1448
  *
1195
1449
  * // '/' 경로를 딥링크로 포함한 토스 공유 링크를 생성해요.
1196
1450
  * const tossLink = await getTossShareLink('intoss://my-app');
@@ -1206,12 +1460,26 @@ declare function getTossShareLink(path: string): Promise<string>;
1206
1460
  * @category 토스페이
1207
1461
  * @name TossPay
1208
1462
  * @description 토스페이 결제 관련 함수를 모아둔 객체예요.
1209
- * @property {typeof checkoutPayment} [checkoutPayment] 토스페이 결제를 생성하는 함수예요. 자세한 내용은 [checkoutPayment](/react-native/reference/framework/토스페이/checkoutPayment)를 참고하세요.
1210
- * @property {typeof executePayment} [executePayment] 토스페이 결제를 실행하는 함수예요. 자세한 내용은 [executePayment](/react-native/reference/framework/토스페이/executePayment)를 참고하세요.
1463
+ * @property {typeof checkoutPayment} [checkoutPayment] 토스페이 결제를 인증하는 함수예요. 자세한 내용은 [checkoutPayment](/react-native/reference/framework/토스페이/checkoutPayment)를 참고하세요.
1211
1464
  */
1212
1465
  declare const TossPay: {
1213
1466
  checkoutPayment: typeof checkoutPayment;
1214
- executePayment: typeof executePayment;
1467
+ };
1468
+ /**
1469
+ * @public
1470
+ * @category 광고
1471
+ * @name GoogleAdMob
1472
+ * @description Google AdMob 광고 관련 함수를 모아둔 객체예요.
1473
+ * @property {typeof loadAdMobInterstitialAd} [loadAdMobInterstitialAd] 전면 광고를 로드하는 함수예요. 자세한 내용은 [loadAdMobInterstitialAd](/react-native/reference/framework/광고/loadAdMobInterstitialAd.html)를 참고하세요.
1474
+ * @property {typeof showAdMobInterstitialAd} [showAdMobInterstitialAd] 로드한 전면 광고를 보여주는 함수예요. 자세한 내용은 [showAdMobInterstitialAd](/react-native/reference/framework/광고/showAdMobInterstitialAd.html)를 참고하세요.
1475
+ * @property {typeof loadAdMobRewardedAd} [loadAdMobRewardedAd] 보상형 광고를 로드하는 함수예요. 자세한 내용은 [loadAdMobRewardedAd](/react-native/reference/framework/광고/loadAdMobRewardedAd.html)를 참고하세요.
1476
+ * @property {typeof showAdMobRewardedAd} [showAdMobRewardedAd] 로드한 보상형 광고를 보여주는 함수예요. 자세한 내용은 [showAdMobRewardedAd](/react-native/reference/framework/광고/showAdMobRewardedAd.html)를 참고하세요.
1477
+ */
1478
+ declare const GoogleAdMob: {
1479
+ loadAdMobInterstitialAd: typeof loadAdMobInterstitialAd;
1480
+ showAdMobInterstitialAd: typeof showAdMobInterstitialAd;
1481
+ loadAdMobRewardedAd: typeof loadAdMobRewardedAd;
1482
+ showAdMobRewardedAd: typeof showAdMobRewardedAd;
1215
1483
  };
1216
1484
 
1217
1485
  type GameWebViewProps$1 = WebViewProps$1;
@@ -1236,7 +1504,7 @@ interface LocalNetwork {
1236
1504
  type InternalProps = 'source' | 'cacheEnabled' | 'sharedCookiesEnabled' | 'thirdPartyCookiesEnabled' | 'injectedJavaScriptBeforeContentLoaded';
1237
1505
  declare function WebView({ type, local, onMessage, ...props }: WebViewProps): react_jsx_runtime.JSX.Element;
1238
1506
 
1239
- type UseGeolocationOptions = Omit<StartUpdateLocationOptions, 'callback'>;
1507
+ type UseGeolocationOptions = Omit<StartUpdateLocationOptions$1, 'callback'>;
1240
1508
  /**
1241
1509
  * @public
1242
1510
  * @category 위치 정보
@@ -1286,4 +1554,57 @@ declare const env: {
1286
1554
  getDeploymentId: () => string | undefined;
1287
1555
  };
1288
1556
 
1289
- export { Accuracy, AppsInToss, type ContactEntity, type ExternalWebViewProps, type FetchAlbumPhotosOptions, type GameWebViewProps, type GetCurrentLocationOptions, type ImageResponse, type Location, type LocationCoords, type OpenCameraOptions, type PartnerWebViewProps, type StartUpdateLocationOptions, type StartUpdateLocationSubscription, Storage, TossPay, type UpdateLocationEventEmitter, type UseGeolocationOptions, WebView, type WebViewProps, appLogin, env, fetchAlbumPhotos, fetchContacts, getClipboardText, getCurrentLocation, getDeviceId, getOperationalEnvironment, getTossAppVersion, getTossShareLink, openCamera, setClipboardText, startUpdateLocation, useGeolocation };
1557
+ declare class EntryMessageExitedEvent extends BedrockEventDefinition<undefined, undefined> {
1558
+ name: "entryMessageExited";
1559
+ remove(): void;
1560
+ listener(_: undefined): void;
1561
+ }
1562
+
1563
+ interface StartUpdateLocationOptions {
1564
+ /**
1565
+ * 위치 정확도를 설정해요.
1566
+ */
1567
+ accuracy: Accuracy;
1568
+ /**
1569
+ * 위치 업데이트 주기를 밀리초(ms) 단위로 설정해요.
1570
+ */
1571
+ timeInterval: number;
1572
+ /**
1573
+ * 위치 변경 거리를 미터(m) 단위로 설정해요.
1574
+ */
1575
+ distanceInterval: number;
1576
+ }
1577
+ declare class UpdateLocationEvent extends BedrockEventDefinition<StartUpdateLocationOptions, Location> {
1578
+ name: "updateLocationEvent";
1579
+ subscriptionCount: number;
1580
+ ref: {
1581
+ remove: () => void;
1582
+ };
1583
+ remove(): void;
1584
+ listener(options: StartUpdateLocationOptions, onEvent: (response: Location) => void, onError: (error: unknown) => void): void;
1585
+ }
1586
+
1587
+ interface AppBridgeCallbackResult {
1588
+ name: string;
1589
+ params?: any;
1590
+ }
1591
+ declare class AppBridgeCallbackEvent extends BedrockEventDefinition<void, AppBridgeCallbackResult> {
1592
+ private static INTERNAL__appBridgeSubscription?;
1593
+ name: "appBridgeCallbackEvent";
1594
+ constructor();
1595
+ remove(): void;
1596
+ listener(): void;
1597
+ private registerAppBridgeCallbackEventListener;
1598
+ private ensureInvokeAppBridgeCallback;
1599
+ }
1600
+
1601
+ declare const appsInTossEvent: BedrockEvent<EntryMessageExitedEvent | AppBridgeCallbackEvent | UpdateLocationEvent>;
1602
+
1603
+ declare const Analytics: {
1604
+ init: (options: _apps_in_toss_analytics.AnalyticsConfig) => void;
1605
+ Impression: ({ enabled, impression: impressionType, ...props }: _apps_in_toss_analytics.LoggingImpressionProps) => react_jsx_runtime.JSX.Element;
1606
+ Press: react.ForwardRefExoticComponent<_apps_in_toss_analytics.LoggingPressProps & react.RefAttributes<unknown>>;
1607
+ Area: ({ children, params: _params, ...props }: _apps_in_toss_analytics.LoggingAreaProps) => react_jsx_runtime.JSX.Element;
1608
+ };
1609
+
1610
+ export { Accuracy, Analytics, AppsInToss, type ContactEntity, type EventLogParams, type ExternalWebViewProps, type FetchAlbumPhotosOptions, type GameWebViewProps, type GetCurrentLocationOptions, GoogleAdMob, type ImageResponse, type LoadAdMobInterstitialAdEvent, type LoadAdMobInterstitialAdOptions, type LoadAdMobRewardedAdEvent, type LoadAdMobRewardedAdOptions, type Location, type LocationCoords, type OpenCameraOptions, type PartnerWebViewProps, type ShowAdMobInterstitialAdEvent, type ShowAdMobInterstitialAdOptions, type ShowAdMobRewardedAdEvent, type ShowAdMobRewardedAdOptions, type StartUpdateLocationOptions$1 as StartUpdateLocationOptions, type StartUpdateLocationSubscription, Storage, TossPay, type UpdateLocationEventEmitter, type UseGeolocationOptions, WebView, type WebViewProps, appLogin, appsInTossEvent, env, eventLog, fetchAlbumPhotos, fetchContacts, getClipboardText, getCurrentLocation, getDeviceId, getOperationalEnvironment, getTossAppVersion, getTossShareLink, isMinVersionSupported, openCamera, setClipboardText, startUpdateLocation, useGeolocation };