@adstage/react-native-sdk 1.0.0

package/lib/module/index.js

@@ -0,0 +1,15 @@
+/**
+ * AdStage React Native SDK
+ *
+ * 광고 어트리뷰션, 딥링크, 프로모션을 위한 통합 SDK
+ *
+ * @since 3.0.0
+ */
+
+export { AdStage } from './AdStage';
+export { AdStageDeepLink } from './deeplink/AdStageDeepLink';
+export { AdStagePromotion } from './promotion/AdStagePromotion';
+export { AdStageEvent } from './event/AdStageEvent';
+
+// Types
+//# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["AdStage","AdStageDeepLink","AdStagePromotion","AdStageEvent"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,OAAO,QAAQ,WAAW;AACnC,SAASC,eAAe,QAAQ,4BAA4B;AAC5D,SAASC,gBAAgB,QAAQ,8BAA8B;AAC/D,SAASC,YAAY,QAAQ,sBAAsB;;AAEnD","ignoreList":[]}

package/lib/module/promotion/AdStagePromotion.js

@@ -0,0 +1,151 @@
+/**
+ * AdStage Promotion 모듈
+ *
+ * 프로모션 조회, 표시, 클릭 처리를 담당합니다.
+ * Android/iOS PromotionHandler, PromotionManager와 동일한 API를 제공합니다.
+ *
+ * @since 3.0.0
+ */
+
+import { NativeModules } from 'react-native';
+const {
+  AdStageModule
+} = NativeModules;
+
+/**
+ * AdStage Promotion 클래스
+ *
+ * @example
+ * ```typescript
+ * // 프로모션 목록 조회
+ * const response = await AdStage.promotion.getList({
+ *   bannerType: 'NATIVE',
+ *   region: 'KR',
+ *   limit: 10
+ * });
+ *
+ * // 프로모션 클릭 처리
+ * const result = await AdStage.promotion.handleClick(response.promotions[0]);
+ * ```
+ */
+export class AdStagePromotion {
+  // ============================================
+  // Promotion List
+  // ============================================
+
+  /**
+   * 프로모션 목록 조회
+   *
+   * @param params - 조회 파라미터
+   * @returns 프로모션 목록 응답
+   *
+   * @example
+   * ```typescript
+   * const response = await AdStage.promotion.getList({
+   *   bannerType: 'NATIVE',          // NATIVE, INTERSTITIAL, REWARDED_VIDEO, POPUP
+   *   region: 'KR',                   // KR, JP, US, SEA, EU, GLOBAL
+   *   deviceType: 'HIGH_END',         // LOW_END, MID_END, HIGH_END
+   *   limit: 10,
+   *   status: 'ACTIVE',
+   *   partner: 'game_company',
+   *   primaryInterest: 'GAMES',
+   *   primaryAgeGroup: '18-24',
+   *   gameGenrePreference: 'RPG',
+   *   playerSpendingTier: 'DOLPHIN',  // F2P, DOLPHIN, WHALE
+   *   playTimePattern: 'EVENING'
+   * });
+   *
+   * console.log('Total:', response.totalItems);
+   * response.promotions.forEach(promo => {
+   *   console.log(`${promo.appName}: ${promo.bannerUrl}`);
+   * });
+   * ```
+   */
+  static async getList(params = {}) {
+    if (!AdStageModule) {
+      throw new Error('AdStage: Native module is not available');
+    }
+    const result = await AdStageModule.getPromotionList(params);
+    return {
+      totalItems: result.totalItems ?? 0,
+      promotions: result.promotions ?? []
+    };
+  }
+
+  // ============================================
+  // Promotion Click Handling
+  // ============================================
+
+  /**
+   * 프로모션 클릭 처리
+   *
+   * 클릭 이벤트를 서버에 전송하고 스토어를 엽니다.
+   *
+   * @param promotion - 클릭할 프로모션
+   * @returns 클릭 처리 결과
+   *
+   * @example
+   * ```typescript
+   * const result = await AdStage.promotion.handleClick(promotion);
+   *
+   * if (result.success) {
+   *   console.log('스토어로 이동:', result.storeUrl);
+   * } else {
+   *   console.error('클릭 처리 실패:', result.error);
+   * }
+   * ```
+   */
+  static async handleClick(promotion) {
+    if (!AdStageModule) {
+      throw new Error('AdStage: Native module is not available');
+    }
+    try {
+      const result = await AdStageModule.handlePromotionClick(promotion);
+      return {
+        success: true,
+        storeUrl: result.storeUrl
+      };
+    } catch (error) {
+      return {
+        success: false,
+        error: error instanceof Error ? error.message : 'Unknown error occurred'
+      };
+    }
+  }
+
+  /**
+   * 프로모션 노출 이벤트 전송
+   *
+   * 프로모션이 화면에 표시될 때 호출합니다.
+   *
+   * @param promotion - 노출된 프로모션
+   *
+   * @example
+   * ```typescript
+   * // 프로모션 배너가 화면에 보일 때
+   * AdStage.promotion.trackImpression(promotion);
+   * ```
+   */
+  static async trackImpression(promotion) {
+    if (!AdStageModule) {
+      return;
+    }
+    await AdStageModule.trackPromotionImpression?.(promotion);
+  }
+
+  // ============================================
+  // Utility
+  // ============================================
+
+  /**
+   * 플랫폼에 맞는 스토어 URL 추출
+   *
+   * @param promotion - 프로모션
+   * @returns 스토어 URL 또는 null
+   */
+  static getStoreUrl(promotion) {
+    const platform = require('react-native').Platform.OS === 'ios' ? 'ios' : 'android';
+    return promotion.storeUrls?.[platform] ?? null;
+  }
+}
+//# sourceMappingURL=AdStagePromotion.js.map

package/lib/module/promotion/AdStagePromotion.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["NativeModules","AdStageModule","AdStagePromotion","getList","params","Error","result","getPromotionList","totalItems","promotions","handleClick","promotion","handlePromotionClick","success","storeUrl","error","message","trackImpression","trackPromotionImpression","getStoreUrl","platform","require","Platform","OS","storeUrls"],"sourceRoot":"../../../src","sources":["promotion/AdStagePromotion.ts"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,aAAa,QAAQ,cAAc;AAQ5C,MAAM;EAAEC;AAAc,CAAC,GAAGD,aAAa;;AAEvC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAME,gBAAgB,CAAC;EAC5B;EACA;EACA;;EAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACE,aAAaC,OAAOA,CAClBC,MAA2B,GAAG,CAAC,CAAC,EACA;IAChC,IAAI,CAACH,aAAa,EAAE;MAClB,MAAM,IAAII,KAAK,CAAC,yCAAyC,CAAC;IAC5D;IAEA,MAAMC,MAAM,GAAG,MAAML,aAAa,CAACM,gBAAgB,CAACH,MAAM,CAAC;IAE3D,OAAO;MACLI,UAAU,EAAEF,MAAM,CAACE,UAAU,IAAI,CAAC;MAClCC,UAAU,EAAEH,MAAM,CAACG,UAAU,IAAI;IACnC,CAAC;EACH;;EAEA;EACA;EACA;;EAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACE,aAAaC,WAAWA,CAACC,SAAoB,EAAiC;IAC5E,IAAI,CAACV,aAAa,EAAE;MAClB,MAAM,IAAII,KAAK,CAAC,yCAAyC,CAAC;IAC5D;IAEA,IAAI;MACF,MAAMC,MAAM,GAAG,MAAML,aAAa,CAACW,oBAAoB,CAACD,SAAS,CAAC;MAClE,OAAO;QACLE,OAAO,EAAE,IAAI;QACbC,QAAQ,EAAER,MAAM,CAACQ;MACnB,CAAC;IACH,CAAC,CAAC,OAAOC,KAAK,EAAE;MACd,OAAO;QACLF,OAAO,EAAE,KAAK;QACdE,KAAK,EACHA,KAAK,YAAYV,KAAK,GAAGU,KAAK,CAACC,OAAO,GAAG;MAC7C,CAAC;IACH;EACF;;EAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACE,aAAaC,eAAeA,CAACN,SAAoB,EAAiB;IAChE,IAAI,CAACV,aAAa,EAAE;MAClB;IACF;IACA,MAAMA,aAAa,CAACiB,wBAAwB,GAAGP,SAAS,CAAC;EAC3D;;EAEA;EACA;EACA;;EAEA;AACF;AACA;AACA;AACA;AACA;EACE,OAAOQ,WAAWA,CAACR,SAAoB,EAAiB;IACtD,MAAMS,QAAQ,GACZC,OAAO,CAAC,cAAc,CAAC,CAACC,QAAQ,CAACC,EAAE,KAAK,KAAK,GAAG,KAAK,GAAG,SAAS;IACnE,OAAOZ,SAAS,CAACa,SAAS,GAAGJ,QAAQ,CAAC,IAAI,IAAI;EAChD;AACF","ignoreList":[]}

package/lib/module/types.js

@@ -0,0 +1,2 @@
+
+//# sourceMappingURL=types.js.map

package/lib/module/types.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../src","sources":["types.ts"],"mappings":"","ignoreList":[]}

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

@@ -0,0 +1,124 @@
+/**
+ * AdStage SDK 메인 클래스
+ *
+ * React Native용 AdStage SDK의 통합 진입점입니다.
+ * Android/iOS 네이티브 SDK(AdStage, AdStageManager)와 동일한 API를 제공합니다.
+ *
+ * @since 3.0.0
+ */
+import { AdStageDeepLink } from './deeplink/AdStageDeepLink';
+import { AdStagePromotion } from './promotion/AdStagePromotion';
+import { AdStageEvent } from './event/AdStageEvent';
+import type { AdStageConfig, UserAttributes } from './types';
+/**
+ * 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 declare class AdStage {
+    private static _isInitialized;
+    private static _config;
+    /** 딥링크 관련 기능 */
+    static readonly deepLink: typeof AdStageDeepLink;
+    /** 프로모션 관련 기능 */
+    static readonly promotion: typeof AdStagePromotion;
+    /** 이벤트 트래킹 관련 기능 */
+    static readonly event: typeof AdStageEvent;
+    /**
+     * AdStage SDK 초기화
+     *
+     * 앱 시작 시 가장 먼저 호출해야 합니다.
+     *
+     * @param config - SDK 설정
+     * @throws SDK 초기화 실패 시 에러
+     *
+     * @example
+     * ```typescript
+     * await AdStage.initialize({
+     *   apiKey: 'your-api-key',
+     *   serverUrl: 'https://your-server.com' // 선택사항, 없으면 네이티브 SDK 기본값 사용
+     * });
+     * ```
+     */
+    static initialize(config: AdStageConfig): Promise<void>;
+    /**
+     * SDK 초기화 여부 확인
+     *
+     * @returns 초기화되었으면 true
+     */
+    static isInitialized(): boolean;
+    /**
+     * SDK 버전 조회
+     *
+     * @returns SDK 버전 문자열
+     */
+    static getVersion(): Promise<string>;
+    /**
+     * 전역 사용자 속성 설정
+     *
+     * 설정된 사용자 속성은 이후 모든 이벤트에 자동으로 포함됩니다.
+     *
+     * @param attributes - 사용자 속성
+     *
+     * @example
+     * ```typescript
+     * AdStage.setUserAttributes({
+     *   gender: 'female',
+     *   country: 'KR',
+     *   city: 'Seoul',
+     *   age: '28',
+     *   language: 'ko-KR'
+     * });
+     * ```
+     */
+    static setUserAttributes(attributes: UserAttributes): Promise<void>;
+    /**
+     * 전역 사용자 속성 조회
+     *
+     * @returns 설정된 사용자 속성 또는 null
+     */
+    static getUserAttributes(): Promise<UserAttributes | null>;
+    /**
+     * 전역 사용자 속성 초기화
+     *
+     * @example
+     * ```typescript
+     * // 로그아웃 시
+     * await AdStage.clearUserAttributes();
+     * ```
+     */
+    static clearUserAttributes(): Promise<void>;
+    /**
+     * 초기화 상태 검증
+     * @internal
+     */
+    static ensureInitialized(): void;
+    /**
+     * 현재 설정 조회
+     * @internal
+     */
+    static getConfig(): AdStageConfig | null;
+}
+//# sourceMappingURL=AdStage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AdStage.d.ts","sourceRoot":"","sources":["../../../src/AdStage.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAI7D;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,OAAO;IAKlB,OAAO,CAAC,MAAM,CAAC,cAAc,CAAS;IACtC,OAAO,CAAC,MAAM,CAAC,OAAO,CAA8B;IAMpD,gBAAgB;IAChB,MAAM,CAAC,QAAQ,CAAC,QAAQ,yBAAmB;IAE3C,iBAAiB;IACjB,MAAM,CAAC,QAAQ,CAAC,SAAS,0BAAoB;IAE7C,oBAAoB;IACpB,MAAM,CAAC,QAAQ,CAAC,KAAK,sBAAgB;IAMrC;;;;;;;;;;;;;;;OAeG;WACU,UAAU,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAyB7D;;;;OAIG;IACH,MAAM,CAAC,aAAa,IAAI,OAAO;IAI/B;;;;OAIG;WACU,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAW1C;;;;;;;;;;;;;;;;;OAiBG;WACU,iBAAiB,CAAC,UAAU,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAOzE;;;;OAIG;WACU,iBAAiB,IAAI,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAOhE;;;;;;;;OAQG;WACU,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAWjD;;;OAGG;IACH,MAAM,CAAC,iBAAiB,IAAI,IAAI;IAQhC;;;OAGG;IACH,MAAM,CAAC,SAAS,IAAI,aAAa,GAAG,IAAI;CAGzC"}

package/lib/typescript/src/deeplink/AdStageDeepLink.d.ts

@@ -0,0 +1,154 @@
+/**
+ * AdStage DeepLink 모듈
+ *
+ * 딥링크 생성, 수신, 처리를 담당합니다.
+ * Android DeeplinkHandler, iOS DeepLinkManager와 동일한 API를 제공합니다.
+ *
+ * @since 3.0.0
+ */
+import type { DeepLinkListener, CreateDeepLinkRequest, CreateDeepLinkResponse } from '../types';
+/**
+ * AdStage DeepLink 클래스
+ *
+ * @example
+ * ```typescript
+ * // 딥링크 리스너 설정
+ * const unsubscribe = AdStage.deepLink.setListener((data) => {
+ *   console.log('딥링크 수신:', data.shortPath);
+ *   console.log('파라미터:', data.parameters);
+ * });
+ *
+ * // 딥링크 생성
+ * const result = await AdStage.deepLink.create({
+ *   name: '여름 프로모션',
+ *   channel: 'google-ads',
+ *   campaign: 'summer_2024'
+ * });
+ * console.log('Short URL:', result.shortUrl);
+ *
+ * // 리스너 해제
+ * unsubscribe();
+ * ```
+ */
+export declare class AdStageDeepLink {
+    private static subscription;
+    /**
+     * 딥링크 리스너 설정
+     *
+     * 딥링크가 수신되면 콜백이 호출됩니다.
+     * 반환된 함수를 호출하면 리스너가 해제됩니다.
+     *
+     * @param listener - 딥링크 수신 콜백
+     * @returns 리스너 해제 함수
+     *
+     * @example
+     * ```typescript
+     * const unsubscribe = AdStage.deepLink.setListener((data) => {
+     *   // URL Scheme: myapp://adstage.net/ABCDEF
+     *   // Universal Link: https://adstage.net/ABCDEF
+     *   console.log('Short Path:', data.shortPath);      // "ABCDEF"
+     *   console.log('Link ID:', data.linkId);
+     *   console.log('Parameters:', data.parameters);
+     *   console.log('Source:', data.source);             // "realtime" | "install"
+     *   console.log('Event Type:', data.eventType);     // "OPEN" | "INSTALL"
+     * });
+     *
+     * // 컴포넌트 unmount 시
+     * unsubscribe();
+     * ```
+     */
+    static setListener(listener: DeepLinkListener): () => void;
+    /**
+     * 딥링크 리스너 제거
+     */
+    static removeListener(): void;
+    /**
+     * 딥링크 생성
+     *
+     * @param request - 딥링크 생성 요청
+     * @returns 생성된 딥링크 정보
+     *
+     * @example
+     * ```typescript
+     * const result = await AdStage.deepLink.create({
+     *   name: '여름 프로모션 링크',
+     *   description: '2024년 여름 시즌용',
+     *   channel: 'google-ads',
+     *   campaign: 'summer_promotion_2024',
+     *   redirectConfig: {
+     *     type: 'STORE',
+     *     android: {
+     *       packageName: 'com.example.app',
+     *       appScheme: 'myapp://promo'
+     *     },
+     *     ios: {
+     *       appStoreId: '123456789',
+     *       appScheme: 'myapp://promo'
+     *     }
+     *   },
+     *   parameters: {
+     *     productId: 'SUMMER_2024',
+     *     discount: '20'
+     *   }
+     * });
+     *
+     * console.log('Short URL:', result.shortUrl);   // https://adstage.net/ABCDEF
+     * console.log('Short Path:', result.shortPath); // ABCDEF
+     * ```
+     */
+    static create(request: CreateDeepLinkRequest): Promise<CreateDeepLinkResponse>;
+    /**
+     * Pending 딥링크 확인 및 처리
+     *
+     * 앱이 종료된 상태에서 딥링크로 실행된 경우,
+     * SDK 초기화 후 이 메서드를 호출하여 pending 딥링크를 처리합니다.
+     *
+     * @example
+     * ```typescript
+     * // SDK 초기화 후
+     * await AdStage.initialize({ apiKey: '...' });
+     *
+     * // 리스너 설정
+     * AdStage.deepLink.setListener((data) => {
+     *   console.log('딥링크:', data);
+     * });
+     *
+     * // Pending 딥링크 확인
+     * AdStage.deepLink.checkPendingDeepLink();
+     * ```
+     */
+    static checkPendingDeepLink(): void;
+    /**
+     * Intent 처리 (Android 전용)
+     *
+     * MainActivity에서 새로운 Intent가 들어올 때 호출합니다.
+     * iOS에서는 호출해도 무시됩니다.
+     *
+     * @example
+     * ```typescript
+     * // React Native에서 AppState 변경 감지
+     * import { Linking } from 'react-native';
+     *
+     * Linking.addEventListener('url', ({ url }) => {
+     *   // Android에서는 네이티브에서 자동 처리되므로 필요 없음
+     *   // 필요한 경우 수동 호출
+     *   AdStage.deepLink.handleIntent();
+     * });
+     * ```
+     */
+    static handleIntent(): void;
+    /**
+     * URL에서 Short Path 추출
+     *
+     * @param url - 딥링크 URL
+     * @returns Short Path 또는 null
+     *
+     * @example
+     * ```typescript
+     * const shortPath = AdStage.deepLink.extractShortPath('https://adstage.net/ABCDEF');
+     * console.log(shortPath); // "ABCDEF"
+     * ```
+     */
+    static extractShortPath(url: string): string | null;
+}
+//# sourceMappingURL=AdStageDeepLink.d.ts.map

package/lib/typescript/src/deeplink/AdStageDeepLink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AdStageDeepLink.d.ts","sourceRoot":"","sources":["../../../../src/deeplink/AdStageDeepLink.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAEV,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,EACvB,MAAM,UAAU,CAAC;AAOlB;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAC,YAAY,CAEX;IAMhB;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,MAAM,CAAC,WAAW,CAAC,QAAQ,EAAE,gBAAgB,GAAG,MAAM,IAAI;IAsB1D;;OAEG;IACH,MAAM,CAAC,cAAc,IAAI,IAAI;IAY7B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;WACU,MAAM,CACjB,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,sBAAsB,CAAC;IAsBlC;;;;;;;;;;;;;;;;;;;OAmBG;IACH,MAAM,CAAC,oBAAoB,IAAI,IAAI;IAInC;;;;;;;;;;;;;;;;;OAiBG;IACH,MAAM,CAAC,YAAY,IAAI,IAAI;IAM3B;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;CAWpD"}