@adstage/react-native-sdk 1.0.0

package/lib/commonjs/index.js

@@ -0,0 +1,34 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "AdStage", {
+  enumerable: true,
+  get: function () {
+    return _AdStage.AdStage;
+  }
+});
+Object.defineProperty(exports, "AdStageDeepLink", {
+  enumerable: true,
+  get: function () {
+    return _AdStageDeepLink.AdStageDeepLink;
+  }
+});
+Object.defineProperty(exports, "AdStageEvent", {
+  enumerable: true,
+  get: function () {
+    return _AdStageEvent.AdStageEvent;
+  }
+});
+Object.defineProperty(exports, "AdStagePromotion", {
+  enumerable: true,
+  get: function () {
+    return _AdStagePromotion.AdStagePromotion;
+  }
+});
+var _AdStage = require("./AdStage");
+var _AdStageDeepLink = require("./deeplink/AdStageDeepLink");
+var _AdStagePromotion = require("./promotion/AdStagePromotion");
+var _AdStageEvent = require("./event/AdStageEvent");
+//# sourceMappingURL=index.js.map

package/lib/commonjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_AdStage","require","_AdStageDeepLink","_AdStagePromotion","_AdStageEvent"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAQA,IAAAA,QAAA,GAAAC,OAAA;AACA,IAAAC,gBAAA,GAAAD,OAAA;AACA,IAAAE,iBAAA,GAAAF,OAAA;AACA,IAAAG,aAAA,GAAAH,OAAA","ignoreList":[]}

package/lib/commonjs/promotion/AdStagePromotion.js

@@ -0,0 +1,158 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.AdStagePromotion = void 0;
+var _reactNative = require("react-native");
+/**
+ * AdStage Promotion 모듈
+ *
+ * 프로모션 조회, 표시, 클릭 처리를 담당합니다.
+ * Android/iOS PromotionHandler, PromotionManager와 동일한 API를 제공합니다.
+ *
+ * @since 3.0.0
+ */
+
+const {
+  AdStageModule
+} = _reactNative.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]);
+ * ```
+ */
+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;
+  }
+}
+exports.AdStagePromotion = AdStagePromotion;
+//# sourceMappingURL=AdStagePromotion.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["_reactNative","require","AdStageModule","NativeModules","AdStagePromotion","getList","params","Error","result","getPromotionList","totalItems","promotions","handleClick","promotion","handlePromotionClick","success","storeUrl","error","message","trackImpression","trackPromotionImpression","getStoreUrl","platform","Platform","OS","storeUrls","exports"],"sourceRoot":"../../../src","sources":["promotion/AdStagePromotion.ts"],"mappings":";;;;;;AASA,IAAAA,YAAA,GAAAC,OAAA;AATA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAUA,MAAM;EAAEC;AAAc,CAAC,GAAGC,0BAAa;;AAEvC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMC,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,CAACJ,aAAa,EAAE;MAClB,MAAM,IAAIK,KAAK,CAAC,yCAAyC,CAAC;IAC5D;IAEA,MAAMC,MAAM,GAAG,MAAMN,aAAa,CAACO,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,CAACX,aAAa,EAAE;MAClB,MAAM,IAAIK,KAAK,CAAC,yCAAyC,CAAC;IAC5D;IAEA,IAAI;MACF,MAAMC,MAAM,GAAG,MAAMN,aAAa,CAACY,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,CAACX,aAAa,EAAE;MAClB;IACF;IACA,MAAMA,aAAa,CAACkB,wBAAwB,GAAGP,SAAS,CAAC;EAC3D;;EAEA;EACA;EACA;;EAEA;AACF;AACA;AACA;AACA;AACA;EACE,OAAOQ,WAAWA,CAACR,SAAoB,EAAiB;IACtD,MAAMS,QAAQ,GACZrB,OAAO,CAAC,cAAc,CAAC,CAACsB,QAAQ,CAACC,EAAE,KAAK,KAAK,GAAG,KAAK,GAAG,SAAS;IACnE,OAAOX,SAAS,CAACY,SAAS,GAAGH,QAAQ,CAAC,IAAI,IAAI;EAChD;AACF;AAACI,OAAA,CAAAtB,gBAAA,GAAAA,gBAAA","ignoreList":[]}

package/lib/commonjs/types.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=types.js.map

package/lib/commonjs/types.js.map

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

package/lib/module/AdStage.js

@@ -0,0 +1,206 @@
+/**
+ * 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';
+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
+  // ============================================
+
+  static _isInitialized = false;
+  static _config = null;
+
+  // ============================================
+  // Sub-modules
+  // ============================================
+
+  /** 딥링크 관련 기능 */
+  static deepLink = AdStageDeepLink;
+
+  /** 프로모션 관련 기능 */
+  static promotion = AdStagePromotion;
+
+  /** 이벤트 트래킹 관련 기능 */
+  static 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) {
+    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() {
+    return this._isInitialized;
+  }
+
+  /**
+   * SDK 버전 조회
+   *
+   * @returns SDK 버전 문자열
+   */
+  static async getVersion() {
+    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) {
+    if (!AdStageModule) {
+      throw new Error('AdStage: Native module is not available');
+    }
+    await AdStageModule.setUserAttributes(attributes);
+  }
+
+  /**
+   * 전역 사용자 속성 조회
+   *
+   * @returns 설정된 사용자 속성 또는 null
+   */
+  static async getUserAttributes() {
+    if (!AdStageModule) {
+      return null;
+    }
+    return AdStageModule.getUserAttributes();
+  }
+
+  /**
+   * 전역 사용자 속성 초기화
+   *
+   * @example
+   * ```typescript
+   * // 로그아웃 시
+   * await AdStage.clearUserAttributes();
+   * ```
+   */
+  static async clearUserAttributes() {
+    if (!AdStageModule) {
+      return;
+    }
+    await AdStageModule.clearUserAttributes();
+  }
+
+  // ============================================
+  // Internal
+  // ============================================
+
+  /**
+   * 초기화 상태 검증
+   * @internal
+   */
+  static ensureInitialized() {
+    if (!this._isInitialized) {
+      throw new Error('AdStage: SDK is not initialized. Call AdStage.initialize() first.');
+    }
+  }
+
+  /**
+   * 현재 설정 조회
+   * @internal
+   */
+  static getConfig() {
+    return this._config;
+  }
+}
+//# sourceMappingURL=AdStage.js.map

package/lib/module/AdStage.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["NativeModules","Platform","AdStageDeepLink","AdStagePromotion","AdStageEvent","AdStageModule","AdStage","_isInitialized","_config","deepLink","promotion","event","initialize","config","apiKey","Error","console","warn","serverUrl","log","OS","isInitialized","getVersion","setUserAttributes","attributes","getUserAttributes","clearUserAttributes","ensureInitialized","getConfig"],"sourceRoot":"../../src","sources":["AdStage.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/deeplink/AdStageDeepLink.js

@@ -0,0 +1,228 @@
+/**
+ * AdStage DeepLink 모듈
+ *
+ * 딥링크 생성, 수신, 처리를 담당합니다.
+ * Android DeeplinkHandler, iOS DeepLinkManager와 동일한 API를 제공합니다.
+ *
+ * @since 3.0.0
+ */
+
+import { NativeModules, NativeEventEmitter, Platform } from 'react-native';
+const {
+  AdStageModule
+} = NativeModules;
+const eventEmitter = AdStageModule ? new NativeEventEmitter(AdStageModule) : null;
+
+/**
+ * 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 class AdStageDeepLink {
+  static subscription = null;
+
+  // ============================================
+  // Listener Management
+  // ============================================
+
+  /**
+   * 딥링크 리스너 설정
+   *
+   * 딥링크가 수신되면 콜백이 호출됩니다.
+   * 반환된 함수를 호출하면 리스너가 해제됩니다.
+   *
+   * @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) {
+    if (!eventEmitter) {
+      console.warn('AdStage: Native event emitter is not available');
+      return () => {};
+    }
+
+    // 기존 리스너 제거
+    this.removeListener();
+    this.subscription = eventEmitter.addListener('onDeepLinkReceived', event => {
+      listener(event);
+    });
+
+    // 네이티브에 리스너 설정 알림
+    AdStageModule?.setDeepLinkListener?.();
+    return () => this.removeListener();
+  }
+
+  /**
+   * 딥링크 리스너 제거
+   */
+  static removeListener() {
+    if (this.subscription) {
+      this.subscription.remove();
+      this.subscription = null;
+    }
+    AdStageModule?.removeDeepLinkListener?.();
+  }
+
+  // ============================================
+  // DeepLink Creation
+  // ============================================
+
+  /**
+   * 딥링크 생성
+   *
+   * @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 async create(request) {
+    if (!AdStageModule) {
+      throw new Error('AdStage: Native module is not available');
+    }
+    if (!request.name) {
+      throw new Error('AdStage: name is required for creating a deep link');
+    }
+    const result = await AdStageModule.createDeepLink(request);
+    return {
+      shortUrl: result.shortUrl,
+      shortPath: result.shortPath,
+      linkId: result.linkId
+    };
+  }
+
+  // ============================================
+  // DeepLink Handling
+  // ============================================
+
+  /**
+   * Pending 딥링크 확인 및 처리
+   *
+   * 앱이 종료된 상태에서 딥링크로 실행된 경우,
+   * SDK 초기화 후 이 메서드를 호출하여 pending 딥링크를 처리합니다.
+   *
+   * @example
+   * ```typescript
+   * // SDK 초기화 후
+   * await AdStage.initialize({ apiKey: '...' });
+   *
+   * // 리스너 설정
+   * AdStage.deepLink.setListener((data) => {
+   *   console.log('딥링크:', data);
+   * });
+   *
+   * // Pending 딥링크 확인
+   * AdStage.deepLink.checkPendingDeepLink();
+   * ```
+   */
+  static checkPendingDeepLink() {
+    AdStageModule?.checkPendingDeepLink?.();
+  }
+
+  /**
+   * 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() {
+    if (Platform.OS === 'android') {
+      AdStageModule?.handleIntent?.();
+    }
+  }
+
+  /**
+   * 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) {
+    try {
+      const urlObj = new URL(url);
+      const pathParts = urlObj.pathname.split('/').filter(Boolean);
+      return pathParts[0] ?? null;
+    } catch {
+      // URL Scheme인 경우
+      const match = url.match(/adstage\.(?:net|app)\/([A-Za-z0-9]+)/);
+      return match?.[1] ?? null;
+    }
+  }
+}
+//# sourceMappingURL=AdStageDeepLink.js.map

package/lib/module/deeplink/AdStageDeepLink.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["NativeModules","NativeEventEmitter","Platform","AdStageModule","eventEmitter","AdStageDeepLink","subscription","setListener","listener","console","warn","removeListener","addListener","event","setDeepLinkListener","remove","removeDeepLinkListener","create","request","Error","name","result","createDeepLink","shortUrl","shortPath","linkId","checkPendingDeepLink","handleIntent","OS","extractShortPath","url","urlObj","URL","pathParts","pathname","split","filter","Boolean","match"],"sourceRoot":"../../../src","sources":["deeplink/AdStageDeepLink.ts"],"mappings":"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","ignoreList":[]}