@adstage/react-native-sdk 1.0.0

package/lib/typescript/src/types.d.ts

@@ -0,0 +1,305 @@
+/**
+ * AdStage SDK 타입 정의
+ *
+ * Android/iOS 네이티브 SDK와 동일한 타입 구조를 제공합니다.
+ *
+ * @since 3.0.0
+ */
+/**
+ * AdStage SDK 초기화 설정
+ */
+export interface AdStageConfig {
+    /** API 인증 키 (필수) */
+    apiKey: string;
+    /** 서버 URL (선택, 기본값: https://api.adstage.app) */
+    serverUrl?: string;
+}
+/**
+ * 딥링크 소스 타입
+ */
+export type DeepLinkSource = 'realtime' | 'install' | 'unknown';
+/**
+ * 딥링크 데이터
+ */
+export interface DeepLinkData {
+    /** 딥링크 ID (서버 발급) */
+    linkId: string;
+    /** Short Path (예: "SDGWNBB") */
+    shortPath: string;
+    /** 딥링크 파라미터 */
+    parameters: Record<string, string>;
+    /** 딥링크 소스 */
+    source: DeepLinkSource;
+    /** 이벤트 타입 (OPEN, INSTALL) */
+    eventType: string;
+    /** 타임스탬프 (Unity 호환) */
+    timestamp?: string;
+}
+/**
+ * 딥링크 리스너
+ */
+export type DeepLinkListener = (data: DeepLinkData) => void;
+/**
+ * 플랫폼별 리다이렉트 설정
+ */
+export interface PlatformConfig {
+    /** 앱 스토어 URL */
+    storeUrl?: string;
+    /** 앱 커스텀 스킴 */
+    appScheme?: string;
+    /** 웹 폴백 URL */
+    webUrl?: string;
+    /** 패키지명 (Android) / 번들 ID (iOS) */
+    packageName?: string;
+    /** App Store ID (iOS) */
+    appStoreId?: string;
+}
+/**
+ * 리다이렉트 설정
+ */
+export interface RedirectConfig {
+    /** 리다이렉트 타입: STORE, APP, WEB */
+    type: 'STORE' | 'APP' | 'WEB';
+    /** Android 플랫폼 설정 */
+    android?: PlatformConfig;
+    /** iOS 플랫폼 설정 */
+    ios?: PlatformConfig;
+    /** 데스크톱 설정 */
+    desktop?: {
+        webUrl?: string;
+    };
+}
+/**
+ * 딥링크 생성 요청
+ */
+export interface CreateDeepLinkRequest {
+    /** 딥링크 이름 (필수) */
+    name: string;
+    /** 딥링크 설명 */
+    description?: string;
+    /** Short Path 커스텀 */
+    shortPath?: string;
+    /** 채널 */
+    channel?: string;
+    /** 서브 채널 */
+    subChannel?: string;
+    /** 캠페인 */
+    campaign?: string;
+    /** 광고 그룹 */
+    adGroup?: string;
+    /** 광고 크리에이티브 */
+    creative?: string;
+    /** 콘텐츠 (Unity 호환) */
+    content?: string;
+    /** 키워드 */
+    keyword?: string;
+    /** 리다이렉트 설정 */
+    redirectConfig?: RedirectConfig;
+    /** 커스텀 파라미터 */
+    parameters?: Record<string, string>;
+}
+/**
+ * 딥링크 생성 응답
+ */
+export interface CreateDeepLinkResponse {
+    /** 생성된 Short URL */
+    shortUrl: string;
+    /** Short Path */
+    shortPath: string;
+    /** 딥링크 ID */
+    linkId: string;
+}
+/**
+ * 프로모션 조회 파라미터
+ */
+export interface PromotionListParams {
+    /** 배너 타입: NATIVE, INTERSTITIAL, REWARDED_VIDEO, POPUP */
+    bannerType?: string;
+    /** 타겟 사용자 필터 */
+    targetAudience?: string;
+    /** 디바이스 타입: LOW_END, MID_END, HIGH_END */
+    deviceType?: string;
+    /** 지역: KR, JP, US, SEA, EU, GLOBAL */
+    region?: string;
+    /** 조회 개수 제한 */
+    limit?: number;
+    /** 상태: ACTIVE, PENDING, PAUSED, ENDED */
+    status?: string;
+    /** 파트너(광고주) 필터 */
+    partner?: string;
+    /** 주요 관심사 */
+    primaryInterest?: string;
+    /** 주요 연령대: 13-17, 18-24, 25-34, 35-44, 45+ */
+    primaryAgeGroup?: string;
+    /** 게임 장르 선호도 */
+    gameGenrePreference?: string;
+    /** 플레이어 지출 티어: F2P, DOLPHIN, WHALE */
+    playerSpendingTier?: string;
+    /** 플레이 시간 패턴 */
+    playTimePattern?: string;
+}
+/**
+ * 프로모션 딥링크 정보
+ */
+export interface PromotionDeepLink {
+    id: string;
+    name: string;
+    description: string;
+    shortPath: string;
+    linkType: string;
+    channel: string;
+    subChannel: string;
+    campaign: string;
+    content: string;
+    keyword: string;
+    status: string;
+}
+/**
+ * 프로모션 데이터
+ */
+export interface Promotion {
+    /** 프로모션 ID */
+    id: string;
+    /** 파트너(광고주) 이름 */
+    partner: string;
+    /** 앱 이름 */
+    appName: string;
+    /** 배너 이미지 URL */
+    bannerUrl: string;
+    /** 배너 타입 */
+    bannerType: string;
+    /** 앱 설명 */
+    appDescription: string;
+    /** 딥링크 정보 */
+    deeplink: PromotionDeepLink;
+    /** 스토어 URL */
+    storeUrls?: {
+        android?: string;
+        ios?: string;
+    };
+}
+/**
+ * 프로모션 리스트 응답
+ */
+export interface PromotionListResponse {
+    /** 전체 개수 */
+    totalItems: number;
+    /** 프로모션 목록 */
+    promotions: Promotion[];
+}
+/**
+ * 프로모션 클릭 결과
+ */
+export interface PromotionClickResult {
+    /** 성공 여부 */
+    success: boolean;
+    /** 이동한 스토어 URL */
+    storeUrl?: string;
+    /** 에러 메시지 */
+    error?: string;
+}
+/**
+ * 사용자 속성
+ */
+export interface UserAttributes {
+    /** 성별: male, female, other */
+    gender?: string;
+    /** 국가 코드: KR, US, JP 등 */
+    country?: string;
+    /** 도시 */
+    city?: string;
+    /** 나이 */
+    age?: string;
+    /** 언어: ko-KR, en-US 등 */
+    language?: string;
+}
+/**
+ * 이벤트 파라미터 (자유 형식)
+ */
+export type TrackEventParams = Record<string, unknown>;
+/**
+ * 이벤트 전송 결과
+ */
+export interface TrackEventResult {
+    /** 성공 여부 */
+    success: boolean;
+    /** 이벤트 ID */
+    eventId?: string;
+    /** 에러 메시지 */
+    error?: string;
+}
+/**
+ * 회원가입 방법
+ */
+export type SignUpMethod = 'email' | 'google' | 'apple' | 'facebook' | 'kakao' | 'naver' | 'twitter' | 'line' | 'guest';
+/**
+ * 결제 방법
+ */
+export type PaymentMethod = 'credit_card' | 'debit_card' | 'paypal' | 'google_pay' | 'apple_pay' | 'samsung_pay' | 'kakao_pay' | 'naver_pay' | 'toss' | 'bank_transfer' | 'virtual_account' | 'carrier_billing' | 'gift_card' | 'cryptocurrency' | 'other';
+/**
+ * 이커머스 아이템
+ */
+export interface EcommerceItem {
+    itemId: string;
+    itemName: string;
+    price?: number;
+    quantity?: number;
+    itemCategory?: string;
+    itemBrand?: string;
+}
+/**
+ * 광고 플랫폼 타입
+ */
+export type AdPlatform = 'admob' | 'applovin' | 'ironsource' | 'unity_ads' | 'facebook' | 'vungle' | 'chartboost' | 'mopub' | 'other';
+/**
+ * 광고 포맷 타입
+ */
+export type AdFormat = 'banner' | 'interstitial' | 'rewarded' | 'rewarded_interstitial' | 'native' | 'app_open' | 'other';
+/**
+ * 게임 서버 정보 (Unity 문서 기준)
+ */
+export interface GameServerInfo {
+    /** 서버 ID (Unity: contentId) */
+    contentId?: string;
+    /** 서버 타입 (Unity: contentType) - 예: 'pvp', 'pve' */
+    contentType?: string;
+    /** 서버 이름 (Unity: itemName) */
+    itemName?: string;
+}
+/**
+ * 패치 정보 (Unity 문서 기준)
+ */
+export interface PatchInfo {
+    /** 패치 ID (Unity: contentId) - 예: 'PATCH_2.1.0' */
+    contentId?: string;
+    /** 패치 타입 (Unity: contentType) - 예: 'update', 'hotfix' */
+    contentType?: string;
+}
+/**
+ * 금융 거래 정보
+ */
+export interface StockTransactionInfo {
+    itemId?: string;
+    itemName?: string;
+    quantity?: number;
+    price?: number;
+    value?: number;
+    currency?: string;
+}
+/**
+ * 계좌 개설 정보
+ */
+export interface AccountOpenInfo {
+    contentType?: string;
+    contentId?: string;
+    method?: string;
+}
+/**
+ * 카드 신청 정보
+ */
+export interface CardApplicationInfo {
+    contentType?: string;
+    itemName?: string;
+    itemId?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/typescript/src/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,105 @@
+{
+  "name": "@adstage/react-native-sdk",
+  "version": "1.0.0",
+  "description": "AdStage SDK for React Native - 광고 어트리뷰션, 딥링크, 인앱 이벤트 트래킹",
+  "main": "lib/commonjs/index",
+  "module": "lib/module/index",
+  "types": "lib/typescript/src/index.d.ts",
+  "react-native": "src/index",
+  "source": "src/index",
+  "files": [
+    "src",
+    "lib",
+    "android",
+    "ios",
+    "*.podspec",
+    "!ios/build",
+    "!android/build",
+    "!android/gradle",
+    "!android/gradlew",
+    "!android/gradlew.bat",
+    "!android/local.properties",
+    "!**/__tests__",
+    "!**/__fixtures__",
+    "!**/__mocks__",
+    "!**/.*"
+  ],
+  "scripts": {
+    "test": "jest",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint \"**/*.{js,ts,tsx}\"",
+    "clean": "del-cli lib",
+    "prepare": "bob build"
+  },
+  "keywords": [
+    "react-native",
+    "ios",
+    "android",
+    "adstage",
+    "attribution",
+    "deeplink",
+    "promotion",
+    "analytics"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nbase-io/NBase-SDK-ReactNative.git"
+  },
+  "author": "NBase <support@nbase.io>",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/nbase-io/NBase-SDK-ReactNative/issues"
+  },
+  "homepage": "https://github.com/nbase-io/NBase-SDK-ReactNative#readme",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "devDependencies": {
+    "@react-native/eslint-config": "^0.73.0",
+    "@types/jest": "^29.5.0",
+    "@types/react": "^18.2.0",
+    "del-cli": "^5.0.0",
+    "eslint": "^8.50.0",
+    "eslint-config-prettier": "^9.0.0",
+    "eslint-plugin-prettier": "^5.0.0",
+    "jest": "^29.7.0",
+    "prettier": "^3.0.0",
+    "react": "18.2.0",
+    "react-native": "0.73.0",
+    "react-native-builder-bob": "^0.23.0",
+    "typescript": "^5.2.0"
+  },
+  "peerDependencies": {
+    "react": ">=17.0.0",
+    "react-native": ">=0.70.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "jest": {
+    "preset": "react-native",
+    "modulePathIgnorePatterns": [
+      "<rootDir>/lib/"
+    ]
+  },
+  "prettier": {
+    "singleQuote": true,
+    "tabWidth": 2,
+    "trailingComma": "es5",
+    "useTabs": false
+  },
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      "commonjs",
+      "module",
+      [
+        "typescript",
+        {
+          "project": "tsconfig.build.json"
+        }
+      ]
+    ]
+  }
+}

package/src/AdStage.ts

@@ -0,0 +1,212 @@
+/**
+ * AdStage SDK 메인 클래스
+ *
+ * React Native용 AdStage SDK의 통합 진입점입니다.
+ * Android/iOS 네이티브 SDK(AdStage, AdStageManager)와 동일한 API를 제공합니다.
+ *
+ * @since 3.0.0
+ */
+
+import { NativeModules, Platform } from 'react-native';
+import { AdStageDeepLink } from './deeplink/AdStageDeepLink';
+import { AdStagePromotion } from './promotion/AdStagePromotion';
+import { AdStageEvent } from './event/AdStageEvent';
+import type { AdStageConfig, UserAttributes } from './types';
+
+const { AdStageModule } = NativeModules;
+
+/**
+ * AdStage SDK
+ *
+ * @example
+ * ```typescript
+ * // 초기화
+ * await AdStage.initialize({
+ *   apiKey: 'your-api-key',
+ *   serverUrl: 'https://api.adstage.app'
+ * });
+ *
+ * // 딥링크 리스너 설정
+ * AdStage.deepLink.setListener((data) => {
+ *   console.log('딥링크 수신:', data.shortPath);
+ * });
+ *
+ * // 프로모션 조회
+ * const promotions = await AdStage.promotion.getList({ bannerType: 'NATIVE' });
+ *
+ * // 이벤트 전송
+ * await AdStage.event.trackPurchase({
+ *   value: 29.99,
+ *   currency: 'USD',
+ *   transactionId: 'TX_123'
+ * });
+ * ```
+ */
+export class AdStage {
+  // ============================================
+  // Static Properties
+  // ============================================
+
+  private static _isInitialized = false;
+  private static _config: AdStageConfig | null = null;
+
+  // ============================================
+  // Sub-modules
+  // ============================================
+
+  /** 딥링크 관련 기능 */
+  static readonly deepLink = AdStageDeepLink;
+
+  /** 프로모션 관련 기능 */
+  static readonly promotion = AdStagePromotion;
+
+  /** 이벤트 트래킹 관련 기능 */
+  static readonly event = AdStageEvent;
+
+  // ============================================
+  // Initialization
+  // ============================================
+
+  /**
+   * AdStage SDK 초기화
+   *
+   * 앱 시작 시 가장 먼저 호출해야 합니다.
+   *
+   * @param config - SDK 설정
+   * @throws SDK 초기화 실패 시 에러
+   *
+   * @example
+   * ```typescript
+   * await AdStage.initialize({
+   *   apiKey: 'your-api-key',
+   *   serverUrl: 'https://your-server.com' // 선택사항, 없으면 네이티브 SDK 기본값 사용
+   * });
+   * ```
+   */
+  static async initialize(config: AdStageConfig): Promise<void> {
+    if (!config.apiKey) {
+      throw new Error('AdStage: apiKey is required');
+    }
+
+    if (this._isInitialized) {
+      console.warn('AdStage: SDK is already initialized');
+      return;
+    }
+
+    if (!AdStageModule) {
+      throw new Error('AdStage: Native module is not available');
+    }
+
+    // serverUrl이 없으면 빈 문자열 전달 - 네이티브 SDK에서 기본값 사용
+    const serverUrl = config.serverUrl ?? '';
+
+    await AdStageModule.initialize(config.apiKey, serverUrl);
+
+    this._config = config;
+    this._isInitialized = true;
+
+    console.log(`AdStage: SDK initialized (${Platform.OS})`);
+  }
+
+  /**
+   * SDK 초기화 여부 확인
+   *
+   * @returns 초기화되었으면 true
+   */
+  static isInitialized(): boolean {
+    return this._isInitialized;
+  }
+
+  /**
+   * SDK 버전 조회
+   *
+   * @returns SDK 버전 문자열
+   */
+  static async getVersion(): Promise<string> {
+    if (!AdStageModule) {
+      return '3.0.0';
+    }
+    return AdStageModule.getVersion();
+  }
+
+  // ============================================
+  // User Attributes
+  // ============================================
+
+  /**
+   * 전역 사용자 속성 설정
+   *
+   * 설정된 사용자 속성은 이후 모든 이벤트에 자동으로 포함됩니다.
+   *
+   * @param attributes - 사용자 속성
+   *
+   * @example
+   * ```typescript
+   * AdStage.setUserAttributes({
+   *   gender: 'female',
+   *   country: 'KR',
+   *   city: 'Seoul',
+   *   age: '28',
+   *   language: 'ko-KR'
+   * });
+   * ```
+   */
+  static async setUserAttributes(attributes: UserAttributes): Promise<void> {
+    if (!AdStageModule) {
+      throw new Error('AdStage: Native module is not available');
+    }
+    await AdStageModule.setUserAttributes(attributes);
+  }
+
+  /**
+   * 전역 사용자 속성 조회
+   *
+   * @returns 설정된 사용자 속성 또는 null
+   */
+  static async getUserAttributes(): Promise<UserAttributes | null> {
+    if (!AdStageModule) {
+      return null;
+    }
+    return AdStageModule.getUserAttributes();
+  }
+
+  /**
+   * 전역 사용자 속성 초기화
+   *
+   * @example
+   * ```typescript
+   * // 로그아웃 시
+   * await AdStage.clearUserAttributes();
+   * ```
+   */
+  static async clearUserAttributes(): Promise<void> {
+    if (!AdStageModule) {
+      return;
+    }
+    await AdStageModule.clearUserAttributes();
+  }
+
+  // ============================================
+  // Internal
+  // ============================================
+
+  /**
+   * 초기화 상태 검증
+   * @internal
+   */
+  static ensureInitialized(): void {
+    if (!this._isInitialized) {
+      throw new Error(
+        'AdStage: SDK is not initialized. Call AdStage.initialize() first.'
+      );
+    }
+  }
+
+  /**
+   * 현재 설정 조회
+   * @internal
+   */
+  static getConfig(): AdStageConfig | null {
+    return this._config;
+  }
+}