vialink-react-native-sdk 3.3.8 → 3.3.12

package/README.ko.md

@@ -0,0 +1,158 @@
+# ViaLink React Native SDK
+
+[English](README.md) | **한국어**
+
+ViaLink 딥링크 인프라 서비스를 위한 React Native SDK입니다.
+v2.0부터 네이티브 브릿지 방식(Android .aar + iOS .xcframework)으로 동작합니다.
+
+## 특징
+
+- **딥링크 라우팅** — App Links / Universal Links 자동 처리
+- **디퍼드 딥링킹** — 앱 설치 후 첫 실행 시 핑거프린트 기반 매칭
+- **이벤트 추적** — 커스텀 이벤트 배치 전송
+- **결제 어트리뷰션** — 결제 시도 기록 + 자동 link_id 첨부
+- **링크 생성** — 앱 내에서 딥링크 생성 (static/dynamic)
+
+## 요구사항
+
+- React Native 0.73+
+- Android: minSdk 24, compileSdk 34
+- iOS: 15.0+, Swift 5.9+
+
+## 설치
+
+```bash
+npm install vialink-react-native-sdk
+```
+
+### iOS 추가 설정
+
+```bash
+cd ios && pod install
+```
+
+### Android 추가 설정
+
+`android/app/build.gradle`에서 설정 확인:
+
+```groovy
+android {
+    compileSdkVersion 34
+    defaultConfig {
+        minSdkVersion 24
+    }
+}
+```
+
+`MainApplication.kt` (또는 `.java`)에 패키지 등록:
+
+```kotlin
+import com.vialink.reactnative.ViaLinkPackage
+
+override fun getPackages(): List<ReactPackage> {
+    val packages = PackageList(this).packages.toMutableList()
+    packages.add(ViaLinkPackage())
+    return packages
+}
+```
+
+## 사용법
+
+### 1. 초기화
+
+```typescript
+import { ViaLinkSDK } from 'vialink-react-native-sdk';
+
+// App.tsx 최상위에서 호출
+await ViaLinkSDK.shared.configure('YOUR_API_KEY');
+```
+
+### 2. 딥링크 콜백
+
+```typescript
+// App Links / Universal Links 수신
+ViaLinkSDK.shared.onDeepLink((data) => {
+  console.log('딥링크:', data.path, data.params);
+  navigation.navigate(data.path, data.params);
+});
+
+// 디퍼드 딥링크 (앱 첫 실행 시 매칭, 5초 데드라인)
+ViaLinkSDK.shared.onDeferredDeepLink((data, error) => {
+  if (error) {
+    // 매칭 실패 (timeout/network/server_error 등) — 일반 진입
+    console.log('매칭 실패:', error.code, error.message);
+    return;
+  }
+  if (!data) {
+    // organic install — 일반 진입
+    return;
+  }
+  // 매칭 성공 — 딥링크 경로로 이동
+  navigation.navigate(data.path, data.params);
+});
+```
+
+### 3. Pull API
+
+```typescript
+// 동기 (캐시된 값 즉시 반환)
+const deepLink = await ViaLinkSDK.shared.getDeepLinkData();
+const deferred = await ViaLinkSDK.shared.getDeferredLinkData();
+
+// 비동기 (결과 도착까지 대기)
+const deepLinkAsync = await ViaLinkSDK.shared.awaitDeepLinkData();    // 3초 타임아웃
+const deferredAsync = await ViaLinkSDK.shared.awaitDeferredLinkData(); // 결과까지 대기
+```
+
+### 4. 이벤트 추적
+
+```typescript
+ViaLinkSDK.shared.track('purchase', {
+  product_id: '12345',
+  revenue: 29900,
+  currency: 'KRW',
+});
+```
+
+### 5. 결제 추적
+
+```typescript
+const result = await ViaLinkSDK.shared.payment.initiated({
+  orderId: 'ORD-2026-0001',
+  amount: 19900,
+  currency: 'KRW',
+  paymentMethod: 'card',
+});
+console.log('success:', result.success, 'id:', result.paymentEventId);
+```
+
+### 6. 링크 생성
+
+```typescript
+const url = await ViaLinkSDK.shared.createLink(
+  '/product/123',
+  { promo_code: 'FRIEND_SHARE' },
+  'referral',
+  'dynamic', // 클릭 추적 필요 시
+);
+console.log('생성된 링크:', url);
+```
+
+### 7. 정리
+
+```typescript
+// 앱 종료 또는 unmount 시
+ViaLinkSDK.shared.destroy();
+```
+
+## 샘플 프로젝트
+
+`sample/` 디렉토리에서 실행 가능한 샘플 앱을 확인하세요.
+
+## 문서
+
+- [SDK 가이드](https://docs.vialink.app/sdk/react-native)
+
+## 라이선스
+
+MIT License — Aresjoy Inc.

package/README.md

@@ -1,37 +1,39 @@
 # ViaLink React Native SDK
 
-ViaLink 딥링크 인프라 서비스를 위한 React Native SDK입니다.
-v2.0부터 네이티브 브릿지 방식(Android .aar + iOS .xcframework)으로 동작합니다.
+**English** | [한국어](README.ko.md)
 
-## 특징
+React Native SDK for the ViaLink deep link infrastructure service.
+Since v2.0 it runs through a native bridge (Android .aar + iOS .xcframework).
 
-- **딥링크 라우팅** — App Links / Universal Links 자동 처리
-- **디퍼드 딥링킹** — 앱 설치 후 첫 실행 시 핑거프린트 기반 매칭
-- **이벤트 추적** — 커스텀 이벤트 배치 전송
-- **결제 어트리뷰션** — 결제 시도 기록 + 자동 link_id 첨부
-- **링크 생성** — 앱 내에서 딥링크 생성 (static/dynamic)
+## Features
 
-## 요구사항
+- **Deep link routing** — automatic handling of App Links / Universal Links
+- **Deferred deep linking** — fingerprint-based matching on the first launch after install
+- **Event tracking** — batched delivery of custom events
+- **Payment attribution** — records payment attempts and automatically attaches `link_id`
+- **Link creation** — generate deep links from within the app (static/dynamic)
+
+## Requirements
 
 - React Native 0.73+
 - Android: minSdk 24, compileSdk 34
 - iOS: 15.0+, Swift 5.9+
 
-## 설치
+## Installation
 
 ```bash
 npm install vialink-react-native-sdk
 ```
 
-### iOS 추가 설정
+### iOS additional setup
 
 ```bash
 cd ios && pod install
 ```
 
-### Android 추가 설정
+### Android additional setup
 
-`android/app/build.gradle`에서 설정 확인:
+Verify the configuration in `android/app/build.gradle`:
 
 ```groovy
 android {
@@ -42,7 +44,7 @@ android {
 }
 ```
 
-`MainApplication.kt` (또는 `.java`)에 패키지 등록:
+Register the package in `MainApplication.kt` (or `.java`):
 
 ```kotlin
 import com.vialink.reactnative.ViaLinkPackage
@@ -54,38 +56,38 @@ override fun getPackages(): List<ReactPackage> {
 }
 ```
 
-## 사용법
+## Usage
 
-### 1. 초기화
+### 1. Initialization
 
 ```typescript
 import { ViaLinkSDK } from 'vialink-react-native-sdk';
 
-// App.tsx 최상위에서 호출
+// Call at the top level of App.tsx
 await ViaLinkSDK.shared.configure('YOUR_API_KEY');
 ```
 
-### 2. 딥링크 콜백
+### 2. Deep link callbacks
 
 ```typescript
-// App Links / Universal Links 수신
+// Receive App Links / Universal Links
 ViaLinkSDK.shared.onDeepLink((data) => {
-  console.log('딥링크:', data.path, data.params);
+  console.log('deep link:', data.path, data.params);
   navigation.navigate(data.path, data.params);
 });
 
-// 디퍼드 딥링크 (앱 첫 실행 시 매칭, 5초 데드라인)
+// Deferred deep link (matched on first app launch, 5-second deadline)
 ViaLinkSDK.shared.onDeferredDeepLink((data, error) => {
   if (error) {
-    // 매칭 실패 (timeout/network/server_error 등) — 일반 진입
-    console.log('매칭 실패:', error.code, error.message);
+    // match failed (timeout/network/server_error, etc.) — normal entry
+    console.log('match failed:', error.code, error.message);
     return;
   }
   if (!data) {
-    // organic install — 일반 진입
+    // organic install — normal entry
     return;
   }
-  // 매칭 성공 — 딥링크 경로로 이동
+  // match succeeded — navigate to the deep link path
   navigation.navigate(data.path, data.params);
 });
 ```
@@ -93,16 +95,16 @@ ViaLinkSDK.shared.onDeferredDeepLink((data, error) => {
 ### 3. Pull API
 
 ```typescript
-// 동기 (캐시된 값 즉시 반환)
+// Synchronous (returns the cached value immediately)
 const deepLink = await ViaLinkSDK.shared.getDeepLinkData();
 const deferred = await ViaLinkSDK.shared.getDeferredLinkData();
 
-// 비동기 (결과 도착까지 대기)
-const deepLinkAsync = await ViaLinkSDK.shared.awaitDeepLinkData();    // 3초 타임아웃
-const deferredAsync = await ViaLinkSDK.shared.awaitDeferredLinkData(); // 결과까지 대기
+// Asynchronous (waits until the result arrives)
+const deepLinkAsync = await ViaLinkSDK.shared.awaitDeepLinkData();    // 3-second timeout
+const deferredAsync = await ViaLinkSDK.shared.awaitDeferredLinkData(); // waits until the result
 ```
 
-### 4. 이벤트 추적
+### 4. Event tracking
 
 ```typescript
 ViaLinkSDK.shared.track('purchase', {
@@ -112,7 +114,7 @@ ViaLinkSDK.shared.track('purchase', {
 });
 ```
 
-### 5. 결제 추적
+### 5. Payment tracking
 
 ```typescript
 const result = await ViaLinkSDK.shared.payment.initiated({
@@ -124,33 +126,33 @@ const result = await ViaLinkSDK.shared.payment.initiated({
 console.log('success:', result.success, 'id:', result.paymentEventId);
 ```
 
-### 6. 링크 생성
+### 6. Link creation
 
 ```typescript
 const url = await ViaLinkSDK.shared.createLink(
   '/product/123',
   { promo_code: 'FRIEND_SHARE' },
   'referral',
-  'dynamic', // 클릭 추적 필요 시
+  'dynamic', // when click tracking is needed
 );
-console.log('생성된 링크:', url);
+console.log('created link:', url);
 ```
 
-### 7. 정리
+### 7. Cleanup
 
 ```typescript
-// 앱 종료 또는 unmount 시
+// On app shutdown or unmount
 ViaLinkSDK.shared.destroy();
 ```
 
-## 샘플 프로젝트
+## Sample project
 
-`sample/` 디렉토리에서 실행 가능한 샘플 앱을 확인하세요.
+See the runnable sample app in the `sample/` directory.
 
-## 문서
+## Documentation
 
-- [SDK 가이드](https://docs.vialink.app/sdk/react-native)
+- [SDK Guide](https://docs.vialink.app/sdk/react-native)
 
-## 라이선스
+## License
 
 MIT License — Aresjoy Inc.

package/dist/ViaLinkSDK.d.ts

@@ -14,12 +14,14 @@ export interface DeepLinkData {
  *   - `'timeout'`: 5초 데드라인 만료
  *   - `'network'`: DNS 실패, 연결 거부 등 (3회 재시도 모두 실패)
  *   - `'server_error'`: HTTP 5xx (3회 재시도 모두 실패)
+ *   - `'client_error'`: HTTP 4xx (429 할당량 초과 포함) — 재시도 불가, 즉시 실패
  *   - `'invalid_response'`: 응답 JSON 파싱 실패
  *   - `'unknown'`: 그 외 모든 예외
- * - `retryable`이 true면 SDK가 다음 앱 실행에서 자동으로 다시 시도한다.
+ * - `retryable`은 항상 `false`다. 디퍼드 매칭은 기기당 1회(fire-once)만 수행하므로
+ *   실패하더라도 다음 앱 실행에서 자동 재시도하지 않는다. (필드는 호환성을 위해 유지)
  */
 export interface DeferredError {
-    code: 'timeout' | 'network' | 'server_error' | 'invalid_response' | 'unknown';
+    code: 'timeout' | 'network' | 'server_error' | 'client_error' | 'invalid_response' | 'unknown';
     message: string;
     httpStatus?: number;
     retryable: boolean;
@@ -124,7 +126,7 @@ export declare class ViaLinkSDK {
      * ```
      *
      * 콜백은 멱등성을 보장합니다 (총 1회 호출).
-     * `error.retryable`이 true면 다음 앱 실행에서 자동 재시도되며, 그 경우 사용자가 앱을 사용 중일 때 콜백이 도착할 수 있습니다.
+     * 디퍼드 매칭은 기기당 1회(fire-once)만 수행하므로, 실패하더라도 다음 앱 실행에서 자동 재시도하지 않습니다(`error.retryable`은 항상 false).
      */
     onDeferredDeepLink(callback: (data: DeepLinkData | null, error: DeferredError | null) => void): void;
     private _handleDeferredOnce;

package/dist/index.js

@@ -1 +1 @@
-'use strict';var reactNative=require('react-native');var {ViaLinkSDK:t}=reactNative.NativeModules,l=/^[A-Za-z0-9_-]{1,100}$/,n=class a{constructor(){this._deferredDelivered=false;this._isConfigured=false;this._deepLinkLoopActive=false;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 r=await t.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:!!r?.success,paymentEventId:String(r?.paymentEventId??"")}}};}static get shared(){return this._instance||(this._instance=new a),this._instance}async configure(e){await t.configure(e),this._isConfigured=true,this._handleDeferredOnce(),this._flushPendingDeepLink(),this._startDeepLinkLoop();}onDeepLink(e){this.deepLinkCallback=e,this._isConfigured&&this._flushPendingDeepLink();}onDeferredDeepLink(e){this.deferredCallback=e,this._isConfigured&&!this._deferredDelivered&&this._handleDeferredOnce();}async _handleDeferredOnce(){if(!this._deferredDelivered)try{let e=await t.awaitDeferredLinkData();if(this._deferredDelivered)return;this._deferredDelivered=!0,this.deferredCallback?.(e??null,null);}catch(e){if(this._deferredDelivered)return;this._deferredDelivered=true;let r=e?.code||"unknown",i={code:r,message:e?.message??"\uB514\uD37C\uB4DC \uB9E4\uCE6D \uC2E4\uD328",retryable:r==="timeout"||r==="network"||r==="server_error"};this.deferredCallback?.(null,i);}}async _flushPendingDeepLink(){if(this.deepLinkCallback)try{let e=await t.getDeepLinkData();e&&this.deepLinkCallback&&this.deepLinkCallback(e);}catch{}}async _startDeepLinkLoop(){if(!this._deepLinkLoopActive&&typeof t.awaitNextDeepLink=="function")for(this._deepLinkLoopActive=true;this._deepLinkLoopActive;)try{let e=await t.awaitNextDeepLink();if(!this._deepLinkLoopActive)break;e&&this.deepLinkCallback&&this.deepLinkCallback(e);}catch{await new Promise(e=>setTimeout(e,1e3));}}track(e,r){t.track(e,r??null);}async getDeferredLinkData(){return t.getDeferredLinkData()}async awaitDeferredLinkData(){return t.awaitDeferredLinkData()}async getDeepLinkData(){return t.getDeepLinkData()}async awaitDeepLinkData(){return t.awaitDeepLinkData()}async createLink(e,r,i,o="static",d){return t.createLink(e,r??null,i??null,o,d??null)}destroy(){this._deepLinkLoopActive=false,this.deepLinkCallback=void 0,this.deferredCallback=void 0;}};exports.ViaLinkSDK=n;
+'use strict';var reactNative=require('react-native');var {ViaLinkSDK:t}=reactNative.NativeModules,l=/^[A-Za-z0-9_-]{1,100}$/,n=class a{constructor(){this._deferredDelivered=false;this._isConfigured=false;this._deepLinkLoopActive=false;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 r=await t.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:!!r?.success,paymentEventId:String(r?.paymentEventId??"")}}};}static get shared(){return this._instance||(this._instance=new a),this._instance}async configure(e){await t.configure(e),this._isConfigured=true,this._handleDeferredOnce(),this._flushPendingDeepLink(),this._startDeepLinkLoop();}onDeepLink(e){this.deepLinkCallback=e,this._isConfigured&&this._flushPendingDeepLink();}onDeferredDeepLink(e){this.deferredCallback=e,this._isConfigured&&!this._deferredDelivered&&this._handleDeferredOnce();}async _handleDeferredOnce(){if(!this._deferredDelivered)try{let e=await t.awaitDeferredLinkData();if(this._deferredDelivered)return;this._deferredDelivered=!0,this.deferredCallback?.(e??null,null);}catch(e){if(this._deferredDelivered)return;this._deferredDelivered=true;let i={code:e?.code||"unknown",message:e?.message??"\uB514\uD37C\uB4DC \uB9E4\uCE6D \uC2E4\uD328",retryable:false};this.deferredCallback?.(null,i);}}async _flushPendingDeepLink(){if(this.deepLinkCallback)try{let e=await t.getDeepLinkData();e&&this.deepLinkCallback&&this.deepLinkCallback(e);}catch{}}async _startDeepLinkLoop(){if(!this._deepLinkLoopActive&&typeof t.awaitNextDeepLink=="function")for(this._deepLinkLoopActive=true;this._deepLinkLoopActive;)try{let e=await t.awaitNextDeepLink();if(!this._deepLinkLoopActive)break;e&&this.deepLinkCallback&&this.deepLinkCallback(e);}catch{await new Promise(e=>setTimeout(e,1e3));}}track(e,r){t.track(e,r??null);}async getDeferredLinkData(){return t.getDeferredLinkData()}async awaitDeferredLinkData(){return t.awaitDeferredLinkData()}async getDeepLinkData(){return t.getDeepLinkData()}async awaitDeepLinkData(){return t.awaitDeepLinkData()}async createLink(e,r,i,o="static",d){return t.createLink(e,r??null,i??null,o,d??null)}destroy(){this._deepLinkLoopActive=false,this.deepLinkCallback=void 0,this.deferredCallback=void 0;}};exports.ViaLinkSDK=n;

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_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>
 		<dict>
 			<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>
 	</array>
 	<key>CFBundlePackageType</key>

package/ios/Frameworks/ViaLinkCore.xcframework/ios-arm64/ViaLinkCore.framework/Modules/ViaLinkCore.swiftmodule/arm64-apple-ios.abi.json

@@ -736,6 +736,43 @@
                 "mangledName": "$s11ViaLinkCore13DeferredErrorV4CodeO06serverE0yA2EmF",
                 "moduleName": "ViaLinkCore"
               },
+              {
+                "kind": "Var",
+                "name": "clientError",
+                "printedName": "clientError",
+                "children": [
+                  {
+                    "kind": "TypeFunc",
+                    "name": "Function",
+                    "printedName": "(ViaLinkCore.DeferredError.Code.Type) -> ViaLinkCore.DeferredError.Code",
+                    "children": [
+                      {
+                        "kind": "TypeNominal",
+                        "name": "Code",
+                        "printedName": "ViaLinkCore.DeferredError.Code",
+                        "usr": "s:11ViaLinkCore13DeferredErrorV4CodeO"
+                      },
+                      {
+                        "kind": "TypeNominal",
+                        "name": "Metatype",
+                        "printedName": "ViaLinkCore.DeferredError.Code.Type",
+                        "children": [
+                          {
+                            "kind": "TypeNominal",
+                            "name": "Code",
+                            "printedName": "ViaLinkCore.DeferredError.Code",
+                            "usr": "s:11ViaLinkCore13DeferredErrorV4CodeO"
+                          }
+                        ]
+                      }
+                    ]
+                  }
+                ],
+                "declKind": "EnumElement",
+                "usr": "s:11ViaLinkCore13DeferredErrorV4CodeO06clientE0yA2EmF",
+                "mangledName": "$s11ViaLinkCore13DeferredErrorV4CodeO06clientE0yA2EmF",
+                "moduleName": "ViaLinkCore"
+              },
               {
                 "kind": "Var",
                 "name": "invalidResponse",
@@ -5770,7 +5807,7 @@
     {
       "filePath": "\/Users\/hong\/sources\/vialink_claude\/vialink-p-manager\/sdk\/ios-sdk\/Sources\/ViaLinkCore\/Internal\/NetworkClient.swift",
       "kind": "IntegerLiteral",
-      "offset": 1929,
+      "offset": 2405,
       "length": 1,
       "value": "0"
     },
@@ -5791,14 +5828,21 @@
     {
       "filePath": "\/Users\/hong\/sources\/vialink_claude\/vialink-p-manager\/sdk\/ios-sdk\/Sources\/ViaLinkCore\/Models\/DeferredError.swift",
       "kind": "StringLiteral",
-      "offset": 1019,
+      "offset": 1186,
       "length": 14,
       "value": "\"server_error\""
     },
     {
       "filePath": "\/Users\/hong\/sources\/vialink_claude\/vialink-p-manager\/sdk\/ios-sdk\/Sources\/ViaLinkCore\/Models\/DeferredError.swift",
       "kind": "StringLiteral",
-      "offset": 1065,
+      "offset": 1228,
+      "length": 14,
+      "value": "\"client_error\""
+    },
+    {
+      "filePath": "\/Users\/hong\/sources\/vialink_claude\/vialink-p-manager\/sdk\/ios-sdk\/Sources\/ViaLinkCore\/Models\/DeferredError.swift",
+      "kind": "StringLiteral",
+      "offset": 1274,
       "length": 18,
       "value": "\"invalid_response\""
     },
@@ -5807,7 +5851,7 @@
       "kind": "StringLiteral",
       "offset": 999,
       "length": 8,
-      "value": "\"3.0.16\""
+      "value": "\"3.0.18\""
     },
     {
       "filePath": "\/Users\/hong\/sources\/vialink_claude\/vialink-p-manager\/sdk\/ios-sdk\/Sources\/ViaLinkCore\/ViaLinkSDK.swift",
@@ -5875,14 +5919,14 @@
     {
       "filePath": "\/Users\/hong\/sources\/vialink_claude\/vialink-p-manager\/sdk\/ios-sdk\/Sources\/ViaLinkCore\/ViaLinkSDK.swift",
       "kind": "StringLiteral",
-      "offset": 26071,
+      "offset": 26337,
       "length": 8,
       "value": "\"static\""
     },
     {
       "filePath": "\/Users\/hong\/sources\/vialink_claude\/vialink-p-manager\/sdk\/ios-sdk\/Sources\/ViaLinkCore\/ViaLinkSDK.swift",
       "kind": "StringLiteral",
-      "offset": 29519,
+      "offset": 29785,
       "length": 26,
       "value": "\"^[A-Za-z0-9_\\-]{1,100}$\""
     }

package/ios/Frameworks/ViaLinkCore.xcframework/ios-arm64/ViaLinkCore.framework/Modules/ViaLinkCore.swiftmodule/arm64-apple-ios.package.swiftinterface

@@ -28,6 +28,7 @@ public struct DeferredError : Swift.Error, Swift.Sendable, Swift.Equatable {
     case timeout
     case network
     case serverError
+    case clientError
     case invalidResponse
     case unknown
     #if compiler(>=5.3) && $NonescapableTypes

package/ios/Frameworks/ViaLinkCore.xcframework/ios-arm64/ViaLinkCore.framework/Modules/ViaLinkCore.swiftmodule/arm64-apple-ios.private.swiftinterface

@@ -28,6 +28,7 @@ public struct DeferredError : Swift.Error, Swift.Sendable, Swift.Equatable {
     case timeout
     case network
     case serverError
+    case clientError
     case invalidResponse
     case unknown
     #if compiler(>=5.3) && $NonescapableTypes

package/ios/Frameworks/ViaLinkCore.xcframework/ios-arm64/ViaLinkCore.framework/Modules/ViaLinkCore.swiftmodule/arm64-apple-ios.swiftinterface

@@ -28,6 +28,7 @@ public struct DeferredError : Swift.Error, Swift.Sendable, Swift.Equatable {
     case timeout
     case network
     case serverError
+    case clientError
     case invalidResponse
     case unknown
     #if compiler(>=5.3) && $NonescapableTypes

package/ios/Frameworks/ViaLinkCore.xcframework/ios-arm64_x86_64-simulator/ViaLinkCore.framework/Modules/ViaLinkCore.swiftmodule/arm64-apple-ios-simulator.abi.json

@@ -736,6 +736,43 @@
                 "mangledName": "$s11ViaLinkCore13DeferredErrorV4CodeO06serverE0yA2EmF",
                 "moduleName": "ViaLinkCore"
               },
+              {
+                "kind": "Var",
+                "name": "clientError",
+                "printedName": "clientError",
+                "children": [
+                  {
+                    "kind": "TypeFunc",
+                    "name": "Function",
+                    "printedName": "(ViaLinkCore.DeferredError.Code.Type) -> ViaLinkCore.DeferredError.Code",
+                    "children": [
+                      {
+                        "kind": "TypeNominal",
+                        "name": "Code",
+                        "printedName": "ViaLinkCore.DeferredError.Code",
+                        "usr": "s:11ViaLinkCore13DeferredErrorV4CodeO"
+                      },
+                      {
+                        "kind": "TypeNominal",
+                        "name": "Metatype",
+                        "printedName": "ViaLinkCore.DeferredError.Code.Type",
+                        "children": [
+                          {
+                            "kind": "TypeNominal",
+                            "name": "Code",
+                            "printedName": "ViaLinkCore.DeferredError.Code",
+                            "usr": "s:11ViaLinkCore13DeferredErrorV4CodeO"
+                          }
+                        ]
+                      }
+                    ]
+                  }
+                ],
+                "declKind": "EnumElement",
+                "usr": "s:11ViaLinkCore13DeferredErrorV4CodeO06clientE0yA2EmF",
+                "mangledName": "$s11ViaLinkCore13DeferredErrorV4CodeO06clientE0yA2EmF",
+                "moduleName": "ViaLinkCore"
+              },
               {
                 "kind": "Var",
                 "name": "invalidResponse",
@@ -5770,7 +5807,7 @@
     {
       "filePath": "\/Users\/hong\/sources\/vialink_claude\/vialink-p-manager\/sdk\/ios-sdk\/Sources\/ViaLinkCore\/Internal\/NetworkClient.swift",
       "kind": "IntegerLiteral",
-      "offset": 1929,
+      "offset": 2405,
       "length": 1,
       "value": "0"
     },
@@ -5791,14 +5828,21 @@
     {
       "filePath": "\/Users\/hong\/sources\/vialink_claude\/vialink-p-manager\/sdk\/ios-sdk\/Sources\/ViaLinkCore\/Models\/DeferredError.swift",
       "kind": "StringLiteral",
-      "offset": 1019,
+      "offset": 1186,
       "length": 14,
       "value": "\"server_error\""
     },
     {
       "filePath": "\/Users\/hong\/sources\/vialink_claude\/vialink-p-manager\/sdk\/ios-sdk\/Sources\/ViaLinkCore\/Models\/DeferredError.swift",
       "kind": "StringLiteral",
-      "offset": 1065,
+      "offset": 1228,
+      "length": 14,
+      "value": "\"client_error\""
+    },
+    {
+      "filePath": "\/Users\/hong\/sources\/vialink_claude\/vialink-p-manager\/sdk\/ios-sdk\/Sources\/ViaLinkCore\/Models\/DeferredError.swift",
+      "kind": "StringLiteral",
+      "offset": 1274,
       "length": 18,
       "value": "\"invalid_response\""
     },
@@ -5807,7 +5851,7 @@
       "kind": "StringLiteral",
       "offset": 999,
       "length": 8,
-      "value": "\"3.0.16\""
+      "value": "\"3.0.18\""
     },
     {
       "filePath": "\/Users\/hong\/sources\/vialink_claude\/vialink-p-manager\/sdk\/ios-sdk\/Sources\/ViaLinkCore\/ViaLinkSDK.swift",
@@ -5875,14 +5919,14 @@
     {
       "filePath": "\/Users\/hong\/sources\/vialink_claude\/vialink-p-manager\/sdk\/ios-sdk\/Sources\/ViaLinkCore\/ViaLinkSDK.swift",
       "kind": "StringLiteral",
-      "offset": 26071,
+      "offset": 26337,
       "length": 8,
       "value": "\"static\""
     },
     {
       "filePath": "\/Users\/hong\/sources\/vialink_claude\/vialink-p-manager\/sdk\/ios-sdk\/Sources\/ViaLinkCore\/ViaLinkSDK.swift",
       "kind": "StringLiteral",
-      "offset": 29519,
+      "offset": 29785,
       "length": 26,
       "value": "\"^[A-Za-z0-9_\\-]{1,100}$\""
     }

package/ios/Frameworks/ViaLinkCore.xcframework/ios-arm64_x86_64-simulator/ViaLinkCore.framework/Modules/ViaLinkCore.swiftmodule/arm64-apple-ios-simulator.package.swiftinterface

@@ -28,6 +28,7 @@ public struct DeferredError : Swift.Error, Swift.Sendable, Swift.Equatable {
     case timeout
     case network
     case serverError
+    case clientError
     case invalidResponse
     case unknown
     #if compiler(>=5.3) && $NonescapableTypes

package/ios/Frameworks/ViaLinkCore.xcframework/ios-arm64_x86_64-simulator/ViaLinkCore.framework/Modules/ViaLinkCore.swiftmodule/arm64-apple-ios-simulator.private.swiftinterface

@@ -28,6 +28,7 @@ public struct DeferredError : Swift.Error, Swift.Sendable, Swift.Equatable {
     case timeout
     case network
     case serverError
+    case clientError
     case invalidResponse
     case unknown
     #if compiler(>=5.3) && $NonescapableTypes

package/ios/Frameworks/ViaLinkCore.xcframework/ios-arm64_x86_64-simulator/ViaLinkCore.framework/Modules/ViaLinkCore.swiftmodule/arm64-apple-ios-simulator.swiftinterface

@@ -28,6 +28,7 @@ public struct DeferredError : Swift.Error, Swift.Sendable, Swift.Equatable {
     case timeout
     case network
     case serverError
+    case clientError
     case invalidResponse
     case unknown
     #if compiler(>=5.3) && $NonescapableTypes

package/ios/Frameworks/ViaLinkCore.xcframework/ios-arm64_x86_64-simulator/ViaLinkCore.framework/Modules/ViaLinkCore.swiftmodule/x86_64-apple-ios-simulator.abi.json

@@ -736,6 +736,43 @@
                 "mangledName": "$s11ViaLinkCore13DeferredErrorV4CodeO06serverE0yA2EmF",
                 "moduleName": "ViaLinkCore"
               },
+              {
+                "kind": "Var",
+                "name": "clientError",
+                "printedName": "clientError",
+                "children": [
+                  {
+                    "kind": "TypeFunc",
+                    "name": "Function",
+                    "printedName": "(ViaLinkCore.DeferredError.Code.Type) -> ViaLinkCore.DeferredError.Code",
+                    "children": [
+                      {
+                        "kind": "TypeNominal",
+                        "name": "Code",
+                        "printedName": "ViaLinkCore.DeferredError.Code",
+                        "usr": "s:11ViaLinkCore13DeferredErrorV4CodeO"
+                      },
+                      {
+                        "kind": "TypeNominal",
+                        "name": "Metatype",
+                        "printedName": "ViaLinkCore.DeferredError.Code.Type",
+                        "children": [
+                          {
+                            "kind": "TypeNominal",
+                            "name": "Code",
+                            "printedName": "ViaLinkCore.DeferredError.Code",
+                            "usr": "s:11ViaLinkCore13DeferredErrorV4CodeO"
+                          }
+                        ]
+                      }
+                    ]
+                  }
+                ],
+                "declKind": "EnumElement",
+                "usr": "s:11ViaLinkCore13DeferredErrorV4CodeO06clientE0yA2EmF",
+                "mangledName": "$s11ViaLinkCore13DeferredErrorV4CodeO06clientE0yA2EmF",
+                "moduleName": "ViaLinkCore"
+              },
               {
                 "kind": "Var",
                 "name": "invalidResponse",
@@ -5770,7 +5807,7 @@
     {
       "filePath": "\/Users\/hong\/sources\/vialink_claude\/vialink-p-manager\/sdk\/ios-sdk\/Sources\/ViaLinkCore\/Internal\/NetworkClient.swift",
       "kind": "IntegerLiteral",
-      "offset": 1929,
+      "offset": 2405,
       "length": 1,
       "value": "0"
     },
@@ -5791,14 +5828,21 @@
     {
       "filePath": "\/Users\/hong\/sources\/vialink_claude\/vialink-p-manager\/sdk\/ios-sdk\/Sources\/ViaLinkCore\/Models\/DeferredError.swift",
       "kind": "StringLiteral",
-      "offset": 1019,
+      "offset": 1186,
       "length": 14,
       "value": "\"server_error\""
     },
     {
       "filePath": "\/Users\/hong\/sources\/vialink_claude\/vialink-p-manager\/sdk\/ios-sdk\/Sources\/ViaLinkCore\/Models\/DeferredError.swift",
       "kind": "StringLiteral",
-      "offset": 1065,
+      "offset": 1228,
+      "length": 14,
+      "value": "\"client_error\""
+    },
+    {
+      "filePath": "\/Users\/hong\/sources\/vialink_claude\/vialink-p-manager\/sdk\/ios-sdk\/Sources\/ViaLinkCore\/Models\/DeferredError.swift",
+      "kind": "StringLiteral",
+      "offset": 1274,
       "length": 18,
       "value": "\"invalid_response\""
     },
@@ -5807,7 +5851,7 @@
       "kind": "StringLiteral",
       "offset": 999,
       "length": 8,
-      "value": "\"3.0.16\""
+      "value": "\"3.0.18\""
     },
     {
       "filePath": "\/Users\/hong\/sources\/vialink_claude\/vialink-p-manager\/sdk\/ios-sdk\/Sources\/ViaLinkCore\/ViaLinkSDK.swift",
@@ -5875,14 +5919,14 @@
     {
       "filePath": "\/Users\/hong\/sources\/vialink_claude\/vialink-p-manager\/sdk\/ios-sdk\/Sources\/ViaLinkCore\/ViaLinkSDK.swift",
       "kind": "StringLiteral",
-      "offset": 26071,
+      "offset": 26337,
       "length": 8,
       "value": "\"static\""
     },
     {
       "filePath": "\/Users\/hong\/sources\/vialink_claude\/vialink-p-manager\/sdk\/ios-sdk\/Sources\/ViaLinkCore\/ViaLinkSDK.swift",
       "kind": "StringLiteral",
-      "offset": 29519,
+      "offset": 29785,
       "length": 26,
       "value": "\"^[A-Za-z0-9_\\-]{1,100}$\""
     }

package/ios/Frameworks/ViaLinkCore.xcframework/ios-arm64_x86_64-simulator/ViaLinkCore.framework/Modules/ViaLinkCore.swiftmodule/x86_64-apple-ios-simulator.package.swiftinterface

@@ -28,6 +28,7 @@ public struct DeferredError : Swift.Error, Swift.Sendable, Swift.Equatable {
     case timeout
     case network
     case serverError
+    case clientError
     case invalidResponse
     case unknown
     #if compiler(>=5.3) && $NonescapableTypes

package/ios/Frameworks/ViaLinkCore.xcframework/ios-arm64_x86_64-simulator/ViaLinkCore.framework/Modules/ViaLinkCore.swiftmodule/x86_64-apple-ios-simulator.private.swiftinterface

@@ -28,6 +28,7 @@ public struct DeferredError : Swift.Error, Swift.Sendable, Swift.Equatable {
     case timeout
     case network
     case serverError
+    case clientError
     case invalidResponse
     case unknown
     #if compiler(>=5.3) && $NonescapableTypes

package/ios/Frameworks/ViaLinkCore.xcframework/ios-arm64_x86_64-simulator/ViaLinkCore.framework/Modules/ViaLinkCore.swiftmodule/x86_64-apple-ios-simulator.swiftinterface

@@ -28,6 +28,7 @@ public struct DeferredError : Swift.Error, Swift.Sendable, Swift.Equatable {
     case timeout
     case network
     case serverError
+    case clientError
     case invalidResponse
     case unknown
     #if compiler(>=5.3) && $NonescapableTypes

package/ios/Frameworks/ViaLinkCore.xcframework/ios-arm64_x86_64-simulator/ViaLinkCore.framework/_CodeSignature/CodeResources

@@ -6,7 +6,7 @@
 	<dict>
 		<key>Info.plist</key>
 		<data>
-		E3r1KNCDpRPKnAoRNqOCWAva/Xk=
+		7FgiE944pxr6YUxFnfcoib2yRs8=
 		</data>
 	</dict>
 	<key>files2</key>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vialink-react-native-sdk",
-  "version": "3.3.8",
+  "version": "3.3.12",
   "description": "ViaLink 딥링크 SDK for React Native (네이티브 브릿지)",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -21,7 +21,8 @@
     "dist/",
     "android/",
     "ios/",
-    "vialink-react-native-sdk.podspec"
+    "vialink-react-native-sdk.podspec",
+    "README.ko.md"
   ],
   "repository": {
     "type": "git",

package/vialink-react-native-sdk.podspec

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