react-native-bootpay-api 13.13.42 → 13.13.46

package/src/CommerceTypes.ts

@@ -0,0 +1,123 @@
+import { ViewProps } from 'react-native';
+
+export interface CommerceEventData {
+  event: string;
+  receipt_id?: string;
+  order_id?: string;
+  request_id?: string;
+  price?: number;
+  message?: string;
+  code?: number | string;
+  metadata?: Record<string, unknown>;
+  [key: string]: unknown;
+}
+
+export interface BootpayCommerceProps extends ViewProps {
+  ref?: React.RefObject<unknown>;
+  onCancel?: (data: CommerceEventData) => void;
+  onError?: (data: CommerceEventData) => void;
+  onDone?: (data: CommerceEventData) => void;
+  onIssued?: (data: CommerceEventData) => void; // 가상계좌 발급 완료 콜백 (iOS SDK와 동일)
+  onClose?: () => void;
+}
+
+export class CommerceUser {
+  membershipType?: string = 'guest'; // 'guest' | 'member'
+  userId?: string;
+  name?: string;
+  phone?: string;
+  email?: string;
+
+  constructor() {}
+}
+
+export class CommerceProduct {
+  productId: string = '';
+  duration: number = -1; // -1: 무기한
+  quantity: number = 1;
+
+  constructor() {}
+}
+
+export class CommerceExtra {
+  separatelyConfirmed?: boolean = false;
+  createOrderImmediately?: boolean = true;
+
+  constructor() {}
+}
+
+export class CommercePayload {
+  clientKey: string = '';
+  name?: string;
+  memo?: string;
+  user?: CommerceUser;
+  price: number = 0;
+  redirectUrl?: string;
+  usageApiUrl?: string;
+  useAutoLogin?: boolean = false;
+  requestId?: string;
+  useNotification?: boolean = false;
+  products?: CommerceProduct[];
+  metadata?: Record<string, string>;
+  metadataAny?: Record<string, unknown>;
+  extra?: CommerceExtra;
+
+  constructor() {}
+
+  toJSON(): Record<string, unknown> {
+    const json: Record<string, unknown> = {
+      client_key: this.clientKey,
+    };
+
+    // price > 0 일 때만 포함 (iOS SDK와 동일)
+    if (this.price > 0) json.price = this.price;
+
+    if (this.name) json.name = this.name;
+    if (this.memo) json.memo = this.memo;
+    if (this.redirectUrl) json.redirect_url = this.redirectUrl;
+    if (this.usageApiUrl) json.usage_api_url = this.usageApiUrl;
+    json.use_auto_login = this.useAutoLogin ?? false;
+    if (this.requestId) json.request_id = this.requestId;
+    json.use_notification = this.useNotification ?? false;
+
+    if (this.user) {
+      const userJson: Record<string, unknown> = {
+        membership_type: this.user.membershipType ?? 'guest',
+      };
+      if (this.user.userId) userJson.user_id = this.user.userId;
+      if (this.user.name) userJson.name = this.user.name;
+      if (this.user.phone) userJson.phone = this.user.phone;
+      if (this.user.email) userJson.email = this.user.email;
+      json.user = userJson;
+    }
+
+    if (this.products && this.products.length > 0) {
+      json.products = this.products.map((p) => ({
+        product_id: p.productId,
+        duration: p.duration,
+        quantity: p.quantity,
+      }));
+    }
+
+    // metadataAny 우선, 없으면 metadata 사용 (iOS SDK와 동일)
+    if (this.metadataAny && Object.keys(this.metadataAny).length > 0) {
+      json.metadata = this.metadataAny;
+    } else if (this.metadata && Object.keys(this.metadata).length > 0) {
+      json.metadata = this.metadata;
+    }
+
+    if (this.extra) {
+      const extraJson: Record<string, unknown> = {
+        separately_confirmed: this.extra.separatelyConfirmed ?? false,
+        create_order_immediately: this.extra.createOrderImmediately ?? true,
+      };
+      json.extra = extraJson;
+    }
+
+    return json;
+  }
+
+  toJSONString(): string {
+    return JSON.stringify(this.toJSON());
+  }
+}

package/src/UserInfo.ts

@@ -13,7 +13,10 @@ export default class UserInfo {
       console.error(`Error setting Bootpay info for key ${key}:`, error);
 
       // 특정 에러 코드에 따라 처리 (iOS와 Android 모두 고려)
-      if (error.message.includes('null is not an object')) {
+      if (
+        error instanceof Error &&
+        error.message.includes('null is not an object')
+      ) {
         console.warn('Keychain configuration or capability might be missing.');
       }
 

package/src/WidgetTypes.ts

@@ -0,0 +1,110 @@
+/**
+ * Widget 관련 타입 정의
+ * Flutter의 widget_data.dart를 참고하여 구현
+ */
+
+export interface WidgetTerm {
+  term_id?: string;
+  pk?: string;
+  title?: string;
+  agree?: boolean;
+  term_type?: number;
+}
+
+export interface WidgetExtra {
+  direct_card_company?: string;
+  direct_card_quota?: number;
+  card_quota?: number;
+}
+
+export interface WidgetData {
+  pg?: string;
+  method?: string;
+  wallet_id?: string;
+  select_terms?: WidgetTerm[];
+  currency?: string; // KRW, USD
+  term_passed?: boolean;
+  completed?: boolean;
+  extra?: WidgetExtra;
+  // 네이티브 SDK와 호환을 위한 추가 필드
+  method_origin_symbol?: string;
+  method_symbol?: string;
+  easy_pay?: string;
+  card_quota?: string;
+}
+
+export type WidgetReadyCallback = () => void;
+export type WidgetResizeCallback = (height: number) => void;
+export type WidgetChangePaymentCallback = (data: WidgetData | null) => void;
+export type WidgetChangeTermsCallback = (data: WidgetData | null) => void;
+
+export interface BootpayWidgetProps {
+  // 앱 ID
+  ios_application_id?: string;
+  android_application_id?: string;
+
+  // Widget 전용 콜백
+  onWidgetReady?: WidgetReadyCallback;
+  onWidgetResize?: WidgetResizeCallback;
+  onWidgetChangePayment?: WidgetChangePaymentCallback;
+  onWidgetChangeTerms?: WidgetChangeTermsCallback;
+
+  // 결제 콜백
+  onCancel?: (data: unknown) => void;
+  onError?: (data: unknown) => void;
+  onIssued?: (data: unknown) => void;
+  onConfirm?: (data: unknown) => boolean;
+  onDone?: (data: unknown) => void;
+  onClose?: () => void;
+
+  // 스타일
+  height?: number;
+  style?: object;
+  widgetTop?: number; // Widget 위치 (위젯 모드에서 position: absolute의 top 값)
+}
+
+export class WidgetPayload {
+  widget_key?: string;
+  widget_sandbox?: boolean;
+  widget_use_terms?: boolean;
+
+  // 기본 Payload 필드
+  application_id?: string;
+  pg?: string;
+  method?: string;
+  methods?: string[];
+  order_name?: string;
+  price?: number;
+  tax_free?: number;
+  order_id?: string;
+  subscription_id?: string;
+  metadata?: Record<string, unknown>;
+  extra?: WidgetPayloadExtra;
+
+  constructor() {
+    this.widget_sandbox = false;
+    this.widget_use_terms = false;
+  }
+}
+
+export class WidgetPayloadExtra {
+  app_scheme?: string;
+  card_quota?: string;
+  show_close_button?: boolean;
+  separately_confirmed?: boolean;
+  display_success_result?: boolean;
+  display_error_result?: boolean;
+  locale?: string;
+  offer_period?: string;
+  open_type?: string;
+  use_bootpay_inapp_sdk?: boolean; // native app에서 redirect를 완성도있게 지원하기 위한 옵션
+  redirect_url?: string;
+
+  constructor() {
+    this.separately_confirmed = true;
+    this.display_success_result = false;
+    this.display_error_result = false;
+    this.use_bootpay_inapp_sdk = true;
+    this.redirect_url = 'https://api.bootpay.co.kr/v2/callback';
+  }
+}

package/src/__tests__/index.test.d.ts

@@ -1 +1 @@
-//# sourceMappingURL=index.test.d.ts.map
+//# sourceMappingURL=index.test.d.ts.map

package/src/__tests__/index.test.js

@@ -1,2 +1,2 @@
-"use strict";
+'use strict';
 it.todo('write a test');

package/src/index.tsx

@@ -1,4 +1,134 @@
+import { NativeModules, Platform } from 'react-native';
 import { Bootpay } from './Bootpay';
-import { Payload, Extra, Item, User } from './BootpayTypes';
+import { BootpayWidget } from './BootpayWidget';
+import { BootpayCommerce } from './BootpayCommerce';
+import {
+  Payload,
+  Extra,
+  Item,
+  User,
+  BootpayEventData,
+  BootpayTypesProps,
+} from './BootpayTypes';
+import {
+  WidgetData,
+  WidgetTerm,
+  WidgetExtra,
+  WidgetPayload,
+  WidgetPayloadExtra,
+  BootpayWidgetProps,
+  WidgetReadyCallback,
+  WidgetResizeCallback,
+  WidgetChangePaymentCallback,
+  WidgetChangeTermsCallback,
+} from './WidgetTypes';
+import {
+  CommercePayload,
+  CommerceUser,
+  CommerceProduct,
+  CommerceExtra,
+  CommerceEventData,
+  BootpayCommerceProps,
+} from './CommerceTypes';
 
-export { Bootpay, Payload, Extra, Item, User };
+const BPCWebViewModule = NativeModules.BPCWebViewModule;
+
+// 자동 warmUp 상태 관리
+let _autoWarmUpCalled = false;
+
+/**
+ * 내부 자동 warmUp 함수
+ * 패키지 import 시 자동으로 호출되어 WebView 프로세스를 미리 초기화합니다.
+ */
+const _autoWarmUp = (): void => {
+  if (_autoWarmUpCalled) return;
+  _autoWarmUpCalled = true;
+
+  // iOS/Android에서만 동작
+  if (Platform.OS !== 'ios' && Platform.OS !== 'android') return;
+
+  try {
+    if (BPCWebViewModule?.warmUp) {
+      BPCWebViewModule.warmUp();
+      if (__DEV__) {
+        console.log('[Bootpay] WebView auto warm-up initiated');
+      }
+    }
+  } catch (e) {
+    // warmUp 실패해도 결제 기능에는 영향 없음
+  }
+};
+
+/**
+ * WebView 프로세스를 미리 초기화하여 첫 결제 화면 로딩 속도를 개선합니다.
+ *
+ * iOS: WKWebView의 첫 생성 시 GPU, Networking, WebContent 프로세스 초기화에 3-7초 소요
+ * Android: Chromium 엔진 초기화에 200-300ms 소요
+ *
+ * 참고: SDK import 시 자동으로 warmUp이 호출되므로, 일반적으로 명시적 호출이 필요하지 않습니다.
+ *
+ * @example
+ * ```tsx
+ * // 자동 warmUp이 기본 동작이므로, 별도 호출 불필요
+ * // 필요한 경우에만 명시적으로 호출
+ * import { warmUp } from 'react-native-bootpay-api';
+ * warmUp();
+ * ```
+ */
+export const warmUp = (): void => {
+  if (BPCWebViewModule?.warmUp) {
+    BPCWebViewModule.warmUp();
+  }
+};
+
+/**
+ * 프리워밍된 WebView 리소스를 해제합니다.
+ * 메모리가 부족할 때 호출할 수 있습니다.
+ *
+ * @example
+ * ```tsx
+ * import { releaseWarmUp } from 'react-native-bootpay-api';
+ *
+ * // 메모리 정리가 필요할 때
+ * releaseWarmUp();
+ * ```
+ */
+export const releaseWarmUp = (): void => {
+  if (BPCWebViewModule?.releaseWarmUp) {
+    BPCWebViewModule.releaseWarmUp();
+  }
+};
+
+// 패키지 import 시 자동으로 warmUp 실행
+_autoWarmUp();
+
+export {
+  // 기존 결제 컴포넌트
+  Bootpay,
+  Payload,
+  Extra,
+  Item,
+  User,
+  BootpayEventData,
+  BootpayTypesProps,
+  // Widget 컴포넌트
+  BootpayWidget,
+  WidgetData,
+  WidgetTerm,
+  WidgetExtra,
+  WidgetPayload,
+  WidgetPayloadExtra,
+  BootpayWidgetProps,
+  WidgetReadyCallback,
+  WidgetResizeCallback,
+  WidgetChangePaymentCallback,
+  WidgetChangeTermsCallback,
+  // Commerce 컴포넌트
+  BootpayCommerce,
+  CommercePayload,
+  CommerceUser,
+  CommerceProduct,
+  CommerceExtra,
+  CommerceEventData,
+  BootpayCommerceProps,
+};