@apps-in-toss/framework 0.0.22 → 0.0.23

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