vialink-react-native-sdk 3.1.1 → 3.3.1

package/README.md

@@ -3,6 +3,14 @@
 ViaLink 딥링크 인프라 서비스를 위한 React Native SDK입니다.
 v2.0부터 네이티브 브릿지 방식(Android .aar + iOS .xcframework)으로 동작합니다.
 
+## 특징
+
+- **딥링크 라우팅** — App Links / Universal Links 자동 처리
+- **디퍼드 딥링킹** — 앱 설치 후 첫 실행 시 핑거프린트 기반 매칭
+- **이벤트 추적** — 커스텀 이벤트 배치 전송
+- **결제 어트리뷰션** — 결제 시도 기록 + 자동 link_id 첨부
+- **링크 생성** — 앱 내에서 딥링크 생성 (static/dynamic)
+
 ## 요구사항
 
 - React Native 0.73+
@@ -48,34 +56,101 @@ override fun getPackages(): List<ReactPackage> {
 
 ## 사용법
 
+### 1. 초기화
+
 ```typescript
 import { ViaLinkSDK } from 'vialink-react-native-sdk';
 
-// 초기화 (App.tsx)
+// 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);
 });
 
-// 디퍼드 딥링크 (앱 첫 설치 후 실행 시)
-ViaLinkSDK.shared.onDeferredDeepLink((data) => {
-  console.log('디퍼드 딥링크:', data.path);
+// 디퍼드 딥링크 (앱 첫 실행 시 매칭, 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',
+});
+```
 
-// 이벤트 추적
-ViaLinkSDK.shared.track('purchase', { product_id: '123', revenue: 29900 });
+### 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);
+```
 
-// 딥링크 생성
-const url = await ViaLinkSDK.shared.createLink('/product/123', { promo: 'FRIEND' }, 'referral');
+### 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 가이드](https://docs.vialink.app/sdk/react-native)
+
+## 라이선스
+
+MIT License — Aresjoy Inc.

package/android/.gradle/buildOutputCleanup/cache.properties

@@ -0,0 +1,2 @@
+#Sat May 09 09:56:05 KST 2026
+gradle.version=8.9

package/android/.gradle/config.properties

@@ -0,0 +1,2 @@
+#Mon May 11 13:22:47 KST 2026
+java.home=/Applications/Android Studio.app/Contents/jbr/Contents/Home

package/android/.idea/AndroidProjectSystem.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="AndroidProjectSystem">
+    <option name="providerId" value="com.android.tools.idea.GradleProjectSystem" />
+  </component>
+</project>