vialink-react-native-sdk 3.0.0 → 3.3.0

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

@@ -13,11 +13,15 @@ class ViaLinkModule(reactContext: ReactApplicationContext) :
     ActivityEventListener {
 
     companion object {
-        const val WRAPPER_VERSION = "2.1.0"
+        const val WRAPPER_VERSION = "3.1.0"
     }
 
     private val scope = CoroutineScope(Dispatchers.Main + SupervisorJob())
+    /// onDeepLink가 listenerCount==0 시점에 호출된 경우의 캐시.
+    /// 3.1.0부터 일반 진입에서도 콜백이 호출되므로, link 진입(map != null) / 일반 진입(map == null)을
+    /// 구분하기 위해 별도 플래그(`hasPendingDeepLink`)를 둔다.
     private var pendingDeepLink: WritableMap? = null
+    private var hasPendingDeepLink: Boolean = false
     private var pendingDeferred: WritableMap? = null
     private var listenerCount = 0
 
@@ -40,10 +44,15 @@ class ViaLinkModule(reactContext: ReactApplicationContext) :
         ViaLinkSDK.setWrapper("react-native/$WRAPPER_VERSION")
         ViaLinkSDK.init(context, apiKey)
 
+        // 딥링크 콜백 — SDK 3.1.0+: data == null이면 일반 진입을 의미한다.
+        // JS 측 emitter는 null payload를 그대로 전달받아 `data: null`로 콜백을 호출한다.
         ViaLinkSDK.onDeepLink { data ->
-            val map = data.toWritableMap()
+            val map: WritableMap? = data?.toWritableMap()
             if (listenerCount > 0) sendEvent("onDeepLink", map)
-            else pendingDeepLink = map
+            else {
+                pendingDeepLink = map
+                hasPendingDeepLink = true
+            }
         }
         // 디퍼드 콜백: SDK 3.0+ 시그니처 (data, error) — 항상 1회 호출
         // JS 측 emit 페이로드는 `{data, error}` 객체로 전달한다.
@@ -166,10 +175,11 @@ class ViaLinkModule(reactContext: ReactApplicationContext) :
     @ReactMethod
     fun addListener(eventName: String) {
         listenerCount++
-        // pending 이벤트 flush
-        if (eventName == "onDeepLink") {
-            pendingDeepLink?.let { sendEvent("onDeepLink", it) }
+        // pending 이벤트 flush — 3.1.0부터 일반 진입(null payload)도 flush해야 한다.
+        if (eventName == "onDeepLink" && hasPendingDeepLink) {
+            sendEvent("onDeepLink", pendingDeepLink)   // null payload도 그대로 전달
             pendingDeepLink = null
+            hasPendingDeepLink = false
         }
         if (eventName == "onDeferredDeepLink") {
             pendingDeferred?.let { sendEvent("onDeferredDeepLink", it) }

package/dist/ViaLinkSDK.d.ts

@@ -92,15 +92,29 @@ export declare class ViaLinkSDK {
      */
     configure(apiKey: string): Promise<void>;
     /**
-     * 딥링크 수신 콜백 등록
-     * App Links / Universal Links로 앱이 열렸을 때 호출됩니다.
+     * 딥링크 수신 콜백 등록 (3.1.0+).
+     *
+     * 네이티브 SDK가 진입 알림(`handleIntent`/`handleUniversalLink`/`notifyAppLaunch`)을 처리할 때 항상 1회 호출됩니다.
+     * - App Links / Universal Links 진입이면 매칭된 [DeepLinkData]가 전달됩니다.
+     * - 일반 진입(아이콘 탭 등)이면 `null`이 전달됩니다.
+     *
+     * ```typescript
+     * ViaLinkSDK.shared.onDeepLink((data) => {
+     *   if (!data) {
+     *     // 일반 진입 — 기본 라우트 유지
+     *     return;
+     *   }
+     *   navigation.navigate(data.path, data.params);
+     * });
+     * ```
      */
-    onDeepLink(callback: (data: DeepLinkData) => void): void;
+    onDeepLink(callback: (data: DeepLinkData | null) => void): void;
     /**
      * 디퍼드 딥링크 콜백 등록
      *
-     * 앱 첫 실행 시 매칭 결과가 결정되는 즉시 항상 1회 호출됩니다.
-     * 5초 안에 결과가 결정되지 않으면 `error.code === 'timeout'`으로 호출됩니다.
+     * 앱 진입 시 매번 1회 호출됩니다 (3.2.0+).
+     * - 첫 실행: `/v1/open` 매칭 결과 결정 즉시 호출. 5초 안에 결과가 결정되지 않으면 `error.code === 'timeout'`.
+     * - 비첫 실행: `/v1/open` 호출 없이 즉시 `(null, null)` (organic install과 동일 의미).
      *
      * ```typescript
      * ViaLinkSDK.shared.onDeferredDeepLink((data, error) => {
@@ -109,15 +123,16 @@ export declare class ViaLinkSDK {
      *     return;
      *   }
      *   if (!data) {
-     *     // organic install — 일반 진입
+     *     // organic install 또는 비첫 실행 — 일반 진입
      *     return;
      *   }
      *   navigation.navigate(data.path, data.params);
      * });
      * ```
      *
-     * 콜백은 멱등성을 보장합니다 (총 1회 호출).
-     * `error.retryable`이 true면 다음 앱 실행에서 자동 재시도되며, 그 경우 사용자가 앱을 사용 중일 때 콜백이 도착할 수 있습니다.
+     * 콜백은 멱등성을 보장합니다 (앱 프로세스당 총 1회 호출).
+     * 첫 실행에서 `error.retryable === true` 인 실패가 나오면 다음 앱 실행에서 자동 재시도되며,
+     * 그 경우 사용자가 앱을 사용 중일 때 콜백이 도착할 수 있습니다.
      */
     onDeferredDeepLink(callback: (data: DeepLinkData | null, error: DeferredError | null) => void): void;
     /**

package/dist/index.js

@@ -1 +1 @@
-'use strict';var reactNative=require('react-native');var {ViaLinkSDK:r}=reactNative.NativeModules,i=new reactNative.NativeEventEmitter(r),l=/^[A-Za-z0-9_-]{1,100}$/,n=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"||!l.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 r.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 r.configure(e);}onDeepLink(e){this.deepLinkSub?.remove(),this.deepLinkSub=i.addListener("onDeepLink",e);}onDeferredDeepLink(e){this.deferredSub?.remove(),this.deferredSub=i.addListener("onDeferredDeepLink",t=>{e(t?.data??null,t?.error??null);});}track(e,t){r.track(e,t??null);}async createLink(e,t,o,s="static",d){return r.createLink(e,t??null,o??null,s,d??null)}destroy(){this.deepLinkSub?.remove(),this.deferredSub?.remove();}};exports.ViaLinkSDK=n;
+'use strict';var reactNative=require('react-native');var {ViaLinkSDK:r}=reactNative.NativeModules,i=new reactNative.NativeEventEmitter(r),l=/^[A-Za-z0-9_-]{1,100}$/,n=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"||!l.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 r.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 r.configure(e);}onDeepLink(e){this.deepLinkSub?.remove(),this.deepLinkSub=i.addListener("onDeepLink",t=>{e(t??null);});}onDeferredDeepLink(e){this.deferredSub?.remove(),this.deferredSub=i.addListener("onDeferredDeepLink",t=>{e(t?.data??null,t?.error??null);});}track(e,t){r.track(e,t??null);}async createLink(e,t,o,d="static",s){return r.createLink(e,t??null,o??null,d,s??null)}destroy(){this.deepLinkSub?.remove(),this.deferredSub?.remove();}};exports.ViaLinkSDK=n;

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

@@ -0,0 +1,44 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>AvailableLibraries</key>
+	<array>
+		<dict>
+			<key>BinaryPath</key>
+			<string>ViaLinkCore.framework/ViaLinkCore</string>
+			<key>LibraryIdentifier</key>
+			<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</string>
+			<key>LibraryPath</key>
+			<string>ViaLinkCore.framework</string>
+			<key>SupportedArchitectures</key>
+			<array>
+				<string>arm64</string>
+			</array>
+			<key>SupportedPlatform</key>
+			<string>ios</string>
+		</dict>
+	</array>
+	<key>CFBundlePackageType</key>
+	<string>XFWK</string>
+	<key>XCFrameworkFormatVersion</key>
+	<string>1.0</string>
+</dict>
+</plist>