@adstage/web-sdk 3.0.1 → 3.0.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adstage/web-sdk",
-  "version": "3.0.1",
+  "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",
@@ -25,7 +25,8 @@
   ],
   "scripts": {
     "build:types": "tsc --project tsconfig.types.json",
-    "build": "npm run build:types && rollup -c",
+    "build": "npm run build:types && NODE_ENV=production rollup -c",
+    "build:dev": "npm run build:types && rollup -c",
     "build:watch": "rollup -c -w",
     "dev": "rollup -c -w",
     "clean": "rm -rf dist dist-types",
@@ -65,8 +66,10 @@
     "@rollup/plugin-typescript": "^11.1.0",
     "@types/node": "^20.0.0",
     "@types/react": "^18.0.0",
+    "javascript-obfuscator": "^4.1.1",
     "rollup": "^3.23.0",
     "rollup-plugin-dts": "^5.3.0",
+    "rollup-plugin-obfuscator": "^1.1.0",
     "tslib": "^2.8.1",
     "typescript": "^5.0.0"
   },

package/src/events/global-events.ts

@@ -4,7 +4,7 @@
  */
 
 import AdStage from '../core/adstage';
-import type { EventProperties, PageData } from '../modules/events/events-module';
+import type { EventProperties } from '../modules/events/events-module';
 
 /**
  * 이벤트 추적 (메인 함수)
@@ -27,46 +27,64 @@ export function track(eventName: string, properties?: EventProperties): Promise<
   return AdStage.events.track(eventName, properties);
 }
 
+
+
 /**
- * 페이지 뷰 추적
- * @param pageData 페이지 정보
+ * 사용자 ID 설정
+ * @param userId 사용자 ID
  * 
  * @example
- * pageView({ page: '/products', title: 'Products Page' });
+ * setUserId('user123');
  */
-export function pageView(pageData?: PageData): Promise<void> {
+export function setUserId(userId: string): void {
   if (!AdStage.isReady()) {
     console.warn('AdStage not initialized. Call AdStage.init() first.');
-    return Promise.resolve();
+    return;
   }
   
-  return AdStage.events.pageView(pageData);
+  AdStage.events.setUserId(userId);
 }
 
 /**
- * 사용자 ID 설정
- * @param userId 사용자 ID
+ * 현재 사용자 ID 반환
+ */
+export function getUserId(): string | undefined {
+  if (!AdStage.isReady()) {
+    console.warn('AdStage not initialized. Call AdStage.init() first.');
+    return undefined;
+  }
+  
+  return AdStage.events.getUserId();
+}
+
+/**
+ * 사용자 속성 설정
+ * @param properties 사용자 속성 객체
  * 
  * @example
- * setUserId('user123');
+ * setUserProperties({
+ *   gender: 'male',
+ *   country: 'KR',
+ *   age: '25'
+ * });
  */
-export function setUserId(userId: string): void {
+export function setUserProperties(properties: import('../types/events').UserProperties): void {
   if (!AdStage.isReady()) {
     console.warn('AdStage not initialized. Call AdStage.init() first.');
     return;
   }
   
-  AdStage.events.setUserId(userId);
+  AdStage.events.setUserProperties(properties);
 }
 
 /**
- * 현재 사용자 ID 반환
+ * 현재 사용자 속성 반환
  */
-export function getUserId(): string | undefined {
+export function getUserProperties(): any {
   if (!AdStage.isReady()) {
     console.warn('AdStage not initialized. Call AdStage.init() first.');
     return undefined;
   }
   
-  return AdStage.events.getUserId();
+  return AdStage.events.getUserProperties();
 }

package/src/index.ts

@@ -8,7 +8,7 @@ export { default as AdStage } from './core/adstage';
 import AdStageCore from './core/adstage';
 
 // 전역 이벤트 함수들 (Firebase 스타일)
-export { track, pageView, setUserId, getUserId } from './events/global-events';
+export { track, setUserId, getUserId, setUserProperties, getUserProperties } from './events/global-events';
 
 // React 통합
 export { AdStageProvider, useAdStageContext, useAdStageInstance } from './react';
@@ -18,7 +18,7 @@ export type { AdStageConfig, ModuleName, BaseModule, ApiResponse, OrganizationIn
 
 // 모듈별 타입
 export type { AdOptions } from './modules/ads/ads-module';
-export type { EventProperties, PageData } from './modules/events/events-module';
+export type { EventProperties, UserProperties } from './modules/events/events-module';
 
 // 광고 관련 타입
 export type { AdType, AdEventType, Advertisement, AdSlot } from './types/advertisement';

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';
     }
   }
 

package/src/modules/events/events-module.ts

@@ -10,17 +10,9 @@ import { getSDKVersion } from '../../utils/version';
 import { EventDeviceCollector } from '../../managers/events/event-device-collector';
 import { EventUserCollector } from '../../managers/events/event-user-collector';
 import { EventSessionManager } from '../../managers/events/event-session-manager';
+import type { UserProperties, EventProperties } from '../../types/events';
 
-export interface EventProperties {
-  [key: string]: any;
-}
-
-export interface PageData {
-  page?: string;
-  title?: string;
-  category?: string;
-  [key: string]: any;
-}
+export type { EventProperties, UserProperties };
 
 export class EventsModule implements BaseModule {
   private _isReady = false;
@@ -73,14 +65,7 @@ export class EventsModule implements BaseModule {
   /**
    * 사용자 속성 설정
    */
-  setUserProperties(properties: {
-    gender?: 'male' | 'female' | 'other' | 'unknown';
-    country?: string;
-    city?: string;
-    age?: string;
-    language?: string;
-    [key: string]: any;
-  }): void {
+  setUserProperties(properties: UserProperties): void {
     EventUserCollector.setUserProperties(properties);
     
     if (this._config?.debug) {
@@ -136,35 +121,7 @@ export class EventsModule implements BaseModule {
     }
   }
 
-  /**
-   * 페이지 뷰 이벤트 (track의 편의 메소드)
-   */
-  async pageView(pageData?: PageData): Promise<void> {
-    const properties: EventProperties = {};
-    
-    if (pageData?.page) properties.page = pageData.page;
-    if (pageData?.title) properties.title = pageData.title;
-    if (pageData?.category) properties.category = pageData.category;
-    
-    // pageData의 다른 속성들도 포함
-    if (pageData) {
-      Object.keys(pageData).forEach(key => {
-        if (key !== 'page' && key !== 'title' && key !== 'category') {
-          properties[key] = pageData[key];
-        }
-      });
-    }
-    
-    // 현재 페이지 정보 자동 수집
-    if (typeof window !== 'undefined') {
-      if (!properties.page) properties.page = window.location.pathname;
-      if (!properties.title) properties.title = document.title;
-      properties.url = window.location.href;
-      properties.referrer = document.referrer;
-    }
 
-    await this.track('page_view', properties);
-  }
 
   /**
    * 서버에 이벤트 전송

package/src/types/events.ts

@@ -58,3 +58,28 @@ export interface SDKError extends Error {
 }
 
 import type { AdEvent } from './advertisement';
+
+/**
+ * 사용자 속성 타입
+ * API의 UserAttributesInput과 동일한 구조
+ */
+export interface UserProperties {
+  /** 성별 */
+  gender?: 'male' | 'female' | 'other' | 'unknown';
+  /** 국가 코드 (ISO 3166-1 alpha-2) */
+  country?: string;
+  /** 도시명 */
+  city?: string;
+  /** 나이 (문자열) */
+  age?: string;
+  /** 언어 코드 (ISO 639-1) */
+  language?: string;
+}
+
+/**
+ * 이벤트 속성 타입
+ */
+export interface EventProperties {
+  /** 이벤트 매개변수 */
+  [key: string]: any;
+}