vialink-react-native-sdk 2.0.15 → 2.1.1

package/android/src/main/java/com/vialink/reactnative/ViaLinkModule.kt

@@ -4,6 +4,7 @@ import com.facebook.react.bridge.*
 import com.facebook.react.modules.core.DeviceEventManagerModule
 import com.vialink.sdk.ViaLinkSDK
 import com.vialink.sdk.model.DeepLinkData
+import com.vialink.sdk.model.PaymentInitiatedArgs
 import kotlinx.coroutines.*
 
 class ViaLinkModule(reactContext: ReactApplicationContext) :
@@ -11,7 +12,7 @@ class ViaLinkModule(reactContext: ReactApplicationContext) :
     ActivityEventListener {
 
     companion object {
-        const val WRAPPER_VERSION = "2.0.5"
+        const val WRAPPER_VERSION = "2.1.0"
     }
 
     private val scope = CoroutineScope(Dispatchers.Main + SupervisorJob())
@@ -60,14 +61,71 @@ class ViaLinkModule(reactContext: ReactApplicationContext) :
     }
 
     @ReactMethod
-    fun createLink(path: String, data: ReadableMap?, campaign: String?, promise: Promise) {
+    fun createLink(path: String, data: ReadableMap?, campaign: String?, linkType: String, promise: Promise) {
         scope.launch {
+            // linkType("dynamic" | "static") 을 native SDK에 전달.
+            // Android core SDK가 linkType 인자를 지원하면 아래 호출에 linkType을 함께 넘긴다.
             val result = ViaLinkSDK.createLink(path, data?.toHashMap()?.mapValues { it.value as Any }, campaign)
             result.onSuccess { promise.resolve(it) }
             result.onFailure { promise.reject("CREATE_LINK_ERROR", it.message) }
         }
     }
 
+    /// 결제 시도 이벤트를 native SDK(payment.initiated)로 전달.
+    /// args: { orderId, amount, currency, linkId?, paymentMethod?, metadata? }
+    /// resolve: { success: Boolean, paymentEventId: String }
+    @ReactMethod
+    fun paymentInitiated(args: ReadableMap, promise: Promise) {
+        try {
+            val orderId = if (args.hasKey("orderId") && !args.isNull("orderId"))
+                args.getString("orderId") else null
+            if (orderId.isNullOrEmpty()) {
+                return promise.reject("E_INVALID_ARG", "orderId가 필요합니다.")
+            }
+
+            if (!args.hasKey("amount") || args.isNull("amount")) {
+                return promise.reject("E_INVALID_ARG", "amount가 필요합니다.")
+            }
+            val amount = args.getDouble("amount")
+
+            val currency = if (args.hasKey("currency") && !args.isNull("currency"))
+                args.getString("currency") else null
+            if (currency.isNullOrEmpty()) {
+                return promise.reject("E_INVALID_ARG", "currency가 필요합니다.")
+            }
+
+            val linkId = if (args.hasKey("linkId") && !args.isNull("linkId"))
+                args.getInt("linkId") else null
+            val paymentMethod = if (args.hasKey("paymentMethod") && !args.isNull("paymentMethod"))
+                args.getString("paymentMethod") else null
+            val metadata = if (args.hasKey("metadata") && !args.isNull("metadata"))
+                args.getMap("metadata")?.toHashMap()?.mapValues { it.value as Any? } else null
+
+            val payArgs = PaymentInitiatedArgs(
+                orderId = orderId,
+                amount = amount,
+                currency = currency,
+                linkId = linkId,
+                paymentMethod = paymentMethod,
+                metadata = metadata,
+            )
+
+            scope.launch {
+                try {
+                    val result = ViaLinkSDK.payment.initiated(payArgs)
+                    val map = Arguments.createMap()
+                    map.putBoolean("success", result.success)
+                    map.putString("paymentEventId", result.paymentEventId)
+                    promise.resolve(map)
+                } catch (e: Exception) {
+                    promise.reject("E_PAYMENT_FAILED", e.message ?: e.toString(), e)
+                }
+            }
+        } catch (e: Exception) {
+            promise.reject("E_PAYMENT_FAILED", e.message ?: e.toString(), e)
+        }
+    }
+
     @ReactMethod
     fun addListener(eventName: String) {
         listenerCount++

package/dist/ViaLinkSDK.d.ts

@@ -3,6 +3,34 @@ export interface DeepLinkData {
     params: Record<string, string>;
     shortCode?: string;
 }
+/**
+ * 결제 시도 이벤트 입력 인자.
+ *
+ * - orderId: 운영자가 발급하는 주문번호 (1~100자, 영문/숫자/하이픈/언더스코어)
+ * - amount: 결제 금액 (통화 단위 그대로, > 0)
+ * - currency: ISO 4217 통화 코드 (예: "KRW", "USD", "JPY")
+ * - linkId: (옵션) 사용자가 진입한 링크 id
+ * - paymentMethod: (옵션) 결제 수단 식별자 (예: "card", "kakao_pay")
+ * - metadata: (옵션) 운영자 자유 메타데이터 (iOS 호환을 위해 string-only)
+ */
+export interface PaymentInitiatedArgs {
+    orderId: string;
+    amount: number;
+    currency: string;
+    linkId?: number;
+    paymentMethod?: string;
+    metadata?: Record<string, string>;
+}
+/**
+ * 결제 시도 응답.
+ *
+ * - success: 서버에서 성공 처리되었는지 여부
+ * - paymentEventId: 서버에서 발급한 결제 이벤트 ID (문자열로 정규화)
+ */
+export interface PaymentInitiatedResult {
+    success: boolean;
+    paymentEventId: string;
+}
 /**
  * ViaLink React Native SDK
  *
@@ -51,10 +79,39 @@ export declare class ViaLinkSDK {
     /**
      * 앱 내에서 딥링크 생성
      *
+     * - `dynamic` (기본값): 클릭할 때마다 통계·어트리뷰션이 집계되는 동적 링크
+     * - `static`: 고정된 목적지 URL만 제공하는 정적 링크 (통계 미집계)
+     *
      * ```typescript
+     * // 동적 링크 (기본값 — 생략 가능)
      * const url = await ViaLinkSDK.shared.createLink('/product/123', { promo: 'FRIEND' }, 'referral');
+     *
+     * // 정적 링크 (통계 미집계)
+     * const url = await ViaLinkSDK.shared.createLink('/product/123', { promo: 'FRIEND' }, 'referral', 'static');
+     * ```
+     */
+    createLink(path: string, data?: Record<string, unknown>, campaign?: string, linkType?: 'dynamic' | 'static'): Promise<string>;
+    /**
+     * 결제 추적 namespace.
+     *
+     * `succeeded`/`failed`는 서버-투-서버(S2S) 엔드포인트라 클라이언트 SDK에서는 노출하지 않습니다.
+     *
+     * ```typescript
+     * const result = await ViaLinkSDK.shared.payment.initiated({
+     *   orderId: 'ORD-2026-0001',
+     *   amount: 19900,
+     *   currency: 'KRW',
+     *   paymentMethod: 'card',
+     * });
+     * // result.success === true, result.paymentEventId === '123'
      * ```
      */
-    createLink(path: string, data?: Record<string, unknown>, campaign?: string): Promise<string>;
+    readonly payment: {
+        /**
+         * 결제 시도 기록 (POST /v1/payments/initiated).
+         * 결제창을 띄우기 직전에 호출합니다. 즉시 전송 (배치 X).
+         */
+        initiated: (args: PaymentInitiatedArgs) => Promise<PaymentInitiatedResult>;
+    };
     destroy(): void;
 }

package/dist/index.d.ts

@@ -1,2 +1,2 @@
 export { ViaLinkSDK } from './ViaLinkSDK';
-export type { DeepLinkData } from './ViaLinkSDK';
+export type { DeepLinkData, PaymentInitiatedArgs, PaymentInitiatedResult, } from './ViaLinkSDK';

package/dist/index.js

@@ -1 +1 @@
-'use strict';var reactNative=require('react-native');var {ViaLinkSDK:i}=reactNative.NativeModules,r=new reactNative.NativeEventEmitter(i),n=class a{constructor(){}static get shared(){return this._instance||(this._instance=new a),this._instance}async configure(e){await i.configure(e);}onDeepLink(e){this.deepLinkSub?.remove(),this.deepLinkSub=r.addListener("onDeepLink",e);}onDeferredDeepLink(e){this.deferredSub?.remove(),this.deferredSub=r.addListener("onDeferredDeepLink",e);}track(e,t){i.track(e,t??null);}async createLink(e,t,s){return i.createLink(e,t??null,s??null)}destroy(){this.deepLinkSub?.remove(),this.deferredSub?.remove();}};exports.ViaLinkSDK=n;
+'use strict';var reactNative=require('react-native');var {ViaLinkSDK:n}=reactNative.NativeModules,i=new reactNative.NativeEventEmitter(n),m=/^[A-Za-z0-9_-]{1,100}$/,r=class a{constructor(){this.payment={initiated:async e=>{if(!e||typeof e!="object")throw new Error("args\uAC00 \uD544\uC694\uD569\uB2C8\uB2E4.");if(typeof e.orderId!="string"||!m.test(e.orderId))throw new Error("order_id \uD615\uC2DD\uC774 \uC62C\uBC14\uB974\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4 (1~100\uC790, \uC601\uBB38/\uC22B\uC790/\uD558\uC774\uD508/\uC5B8\uB354\uC2A4\uCF54\uC5B4).");if(typeof e.amount!="number"||!Number.isFinite(e.amount)||e.amount<=0)throw new Error("amount\uB294 0\uBCF4\uB2E4 \uD070 \uC22B\uC790\uC5EC\uC57C \uD569\uB2C8\uB2E4.");if(typeof e.currency!="string"||e.currency.trim().length===0)throw new Error("currency\uAC00 \uD544\uC694\uD569\uB2C8\uB2E4.");let t=await n.paymentInitiated({orderId:e.orderId,amount:e.amount,currency:e.currency.trim().toUpperCase(),linkId:e.linkId??null,paymentMethod:e.paymentMethod??null,metadata:e.metadata??null});return {success:!!t?.success,paymentEventId:String(t?.paymentEventId??"")}}};}static get shared(){return this._instance||(this._instance=new a),this._instance}async configure(e){await n.configure(e);}onDeepLink(e){this.deepLinkSub?.remove(),this.deepLinkSub=i.addListener("onDeepLink",e);}onDeferredDeepLink(e){this.deferredSub?.remove(),this.deferredSub=i.addListener("onDeferredDeepLink",e);}track(e,t){n.track(e,t??null);}async createLink(e,t,o,d="dynamic"){return n.createLink(e,t??null,o??null,d)}destroy(){this.deepLinkSub?.remove(),this.deferredSub?.remove();}};exports.ViaLinkSDK=r;

package/ios/Frameworks/ViaLinkCore.xcframework/Info.plist

@@ -8,32 +8,32 @@
 			<key>BinaryPath</key>
 			<string>ViaLinkCore.framework/ViaLinkCore</string>
 			<key>LibraryIdentifier</key>
-			<string>ios-arm64</string>
+			<string>ios-arm64_x86_64-simulator</string>
 			<key>LibraryPath</key>
 			<string>ViaLinkCore.framework</string>
 			<key>SupportedArchitectures</key>
 			<array>
 				<string>arm64</string>
+				<string>x86_64</string>
 			</array>
 			<key>SupportedPlatform</key>
 			<string>ios</string>
+			<key>SupportedPlatformVariant</key>
+			<string>simulator</string>
 		</dict>
 		<dict>
 			<key>BinaryPath</key>
 			<string>ViaLinkCore.framework/ViaLinkCore</string>
 			<key>LibraryIdentifier</key>
-			<string>ios-arm64_x86_64-simulator</string>
+			<string>ios-arm64</string>
 			<key>LibraryPath</key>
 			<string>ViaLinkCore.framework</string>
 			<key>SupportedArchitectures</key>
 			<array>
 				<string>arm64</string>
-				<string>x86_64</string>
 			</array>
 			<key>SupportedPlatform</key>
 			<string>ios</string>
-			<key>SupportedPlatformVariant</key>
-			<string>simulator</string>
 		</dict>
 	</array>
 	<key>CFBundlePackageType</key>

package/ios/ViaLinkModule.m

@@ -13,6 +13,11 @@ RCT_EXTERN_METHOD(track:(NSString *)eventName
 RCT_EXTERN_METHOD(createLink:(NSString *)path
                   data:(NSDictionary *)data
                   campaign:(NSString *)campaign
+                  linkType:(NSString *)linkType
+                  resolve:(RCTPromiseResolveBlock)resolve
+                  reject:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(paymentInitiated:(NSDictionary *)args
                   resolve:(RCTPromiseResolveBlock)resolve
                   reject:(RCTPromiseRejectBlock)reject)
 

package/ios/ViaLinkModule.swift

@@ -1,11 +1,11 @@
 import Foundation
 import React
-import ViaLinkSDK  // xcframework
+import ViaLinkCore  // xcframework module: ViaLinkCore (class: ViaLinkSDK)
 
 @objc(ViaLinkSDK)
 class ViaLinkModule: RCTEventEmitter {
 
-    static let wrapperVersion = "2.0.5"
+    static let wrapperVersion = "2.1.0"
 
     private var pendingDeepLink: [String: Any?]?
     private var pendingDeferred: [String: Any?]?
@@ -65,10 +65,13 @@ class ViaLinkModule: RCTEventEmitter {
     }
 
     @objc func createLink(_ path: String, data: NSDictionary?, campaign: String?,
+                          linkType: String,
                           resolve: @escaping RCTPromiseResolveBlock,
                           reject: @escaping RCTPromiseRejectBlock) {
         Task {
             do {
+                // TODO: ViaLinkCore가 linkType을 지원하면 아래 호출에 linkType 전달 필요.
+                //       현재 iOS core SDK는 다른 sub-agent가 linkType 인자를 추가 중.
                 let url = try await ViaLinkSDK.shared.createLink(path: path, data: data as? [String: Any], campaign: campaign)
                 DispatchQueue.main.async { resolve(url) }
             } catch {
@@ -76,6 +79,55 @@ class ViaLinkModule: RCTEventEmitter {
             }
         }
     }
+
+    /// 결제 시도 이벤트를 native iOS SDK(ViaLinkSDK.shared.payment.initiated)로 전달.
+    /// args: { orderId, amount, currency, linkId?, paymentMethod?, metadata? }
+    /// resolve: { success: Bool, paymentEventId: String }
+    @objc func paymentInitiated(_ args: NSDictionary,
+                                resolve: @escaping RCTPromiseResolveBlock,
+                                reject: @escaping RCTPromiseRejectBlock) {
+        guard let orderId = args["orderId"] as? String, !orderId.isEmpty else {
+            reject("E_INVALID_ARG", "orderId가 필요합니다.", nil)
+            return
+        }
+        guard let amountValue = args["amount"] as? NSNumber else {
+            reject("E_INVALID_ARG", "amount가 필요합니다.", nil)
+            return
+        }
+        guard let currency = args["currency"] as? String, !currency.isEmpty else {
+            reject("E_INVALID_ARG", "currency가 필요합니다.", nil)
+            return
+        }
+
+        let linkId = args["linkId"] as? Int
+        let paymentMethod = args["paymentMethod"] as? String
+        let metadata = args["metadata"] as? [String: String]
+
+        let payArgs = PaymentInitiatedArgs(
+            orderId: orderId,
+            amount: amountValue.doubleValue,
+            currency: currency,
+            linkId: linkId,
+            paymentMethod: paymentMethod,
+            metadata: metadata
+        )
+
+        Task {
+            do {
+                let result = try await ViaLinkSDK.shared.payment.initiated(payArgs)
+                DispatchQueue.main.async {
+                    resolve([
+                        "success": result.success,
+                        "paymentEventId": result.paymentEventId,
+                    ])
+                }
+            } catch {
+                DispatchQueue.main.async {
+                    reject("E_PAYMENT_FAILED", error.localizedDescription, error)
+                }
+            }
+        }
+    }
 }
 
 extension DeepLinkData {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vialink-react-native-sdk",
-  "version": "2.0.15",
+  "version": "2.1.1",
   "description": "ViaLink 딥링크 SDK for React Native (네이티브 브릿지)",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/vialink-react-native-sdk.podspec

@@ -1,6 +1,6 @@
 Pod::Spec.new do |s|
   s.name         = "vialink-react-native-sdk"
-  s.version      = "2.0.15"
+  s.version      = "2.1.1"
   s.summary      = "ViaLink Deep Link SDK for React Native"
   s.homepage     = "https://vialink.app"
   s.license      = "MIT"