@adstage/web-sdk 3.0.2 → 3.0.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adstage/web-sdk",
-  "version": "3.0.2",
+  "version": "3.0.3",
   "description": "AdStage Web SDK - Production-ready marketing platform SDK with React Provider support for seamless integration",
   "type": "module",
   "main": "dist/index.cjs.js",

package/src/managers/events/event-device-collector.ts

@@ -6,12 +6,19 @@
 
 import { DOMUtils } from '../../utils/dom-utils';
 import { DeviceInfoCollector } from '../device-info-collector';
-import { getSDKVersion } from '../../utils/version';
 import { ConfigUtils } from '../../utils/config-utils';
 
 export class EventDeviceCollector {
+  private static _userProvidedDeviceInfo: Partial<{
+    category: 'mobile' | 'desktop' | 'tablet' | 'other';
+    platform: string;
+    model: string;
+    appVersion: string;
+    osVersion: string;
+  }> = {};
   /**
-   * Events API용 디바이스 정보 반환
+   * Events API용 디바이스 정보 반환 (하이브리드 방식)
+   * 사용자 제공 정보 + 자동 수집 정보 병합
    * TrackEventDto.DeviceInfoInput 형태에 맞춤
    */
   static getDeviceInfo(): {
@@ -20,13 +27,33 @@ export class EventDeviceCollector {
     model?: string;
     appVersion?: string;
     osVersion?: string;
+  } {
+    // 자동 수집된 기본 정보 가져오기
+    const autoDetectedInfo = EventDeviceCollector.getAutoDetectedDeviceInfo();
+    
+    // 사용자 제공 정보와 병합 (사용자 정보가 우선)
+    return {
+      ...autoDetectedInfo,
+      ...EventDeviceCollector._userProvidedDeviceInfo
+    };
+  }
+
+  /**
+   * 자동 감지된 디바이스 정보만 반환
+   */
+  private static getAutoDetectedDeviceInfo(): {
+    category: 'mobile' | 'desktop' | 'tablet' | 'other';
+    platform?: string;
+    model?: string;
+    appVersion?: string;
+    osVersion?: string;
   } {
     if (!DOMUtils.isBrowser()) {
       return {
         category: 'other',
         platform: 'SSR',
         model: 'SSR',
-        appVersion: ConfigUtils.getAppVersion(), // AdStage.init()에서 설정 또는 기본값 '1.0.0'
+        appVersion: ConfigUtils.getAppVersion(),
         osVersion: 'SSR'
       };
     }
@@ -49,21 +76,58 @@ export class EventDeviceCollector {
       category,
       platform: platformString,
       model: navigator.platform,
-      appVersion: ConfigUtils.getAppVersion(), // AdStage.init()에서 설정 또는 기본값 '1.0.0'
+      appVersion: ConfigUtils.getAppVersion(),
       osVersion: navigator.platform
     };
   }
 
+  /**
+   * 디바이스 정보 설정 (런타임 업데이트)
+   */
+  static setDeviceInfo(deviceInfo: Partial<{
+    category: 'mobile' | 'desktop' | 'tablet' | 'other';
+    platform: string;
+    model: string;
+    appVersion: string;
+    osVersion: string;
+  }>): void {
+    EventDeviceCollector._userProvidedDeviceInfo = {
+      ...EventDeviceCollector._userProvidedDeviceInfo,
+      ...deviceInfo
+    };
+  }
+
+  /**
+   * 개별 디바이스 속성 설정
+   */
+  static setDeviceProperty(key: 'category' | 'platform' | 'model' | 'appVersion' | 'osVersion', value: string): void {
+    EventDeviceCollector._userProvidedDeviceInfo[key] = value as any;
+  }
+
+  /**
+   * 사용자 제공 디바이스 정보 초기화
+   */
+  static clearUserProvidedDeviceInfo(): void {
+    EventDeviceCollector._userProvidedDeviceInfo = {};
+  }
+
+  /**
+   * 현재 사용자가 설정한 디바이스 정보 반환
+   */
+  static getUserProvidedDeviceInfo(): typeof EventDeviceCollector._userProvidedDeviceInfo {
+    return { ...EventDeviceCollector._userProvidedDeviceInfo };
+  }
+
   /**
    * 플랫폼 타입을 Events API용 문자열로 매핑
    */
   private static mapPlatformForEvents(platformType: 'ios' | 'android' | 'web' | 'desktop'): string {
     switch (platformType) {
-      case 'ios': return 'ios';
-      case 'android': return 'android';
-      case 'web': return 'mobile-web';
-      case 'desktop': return 'desktop-web';
-      default: return 'unknown';
+      case 'ios': return 'iOS';
+      case 'android': return 'Android';
+      case 'web': return 'Mobile Web';
+      case 'desktop': return 'Desktop Web';
+      default: return 'Unknown';
     }
   }