@adstage/web-sdk 1.1.0 → 1.3.1

package/src/index.ts

@@ -314,6 +314,23 @@ export class AdStageSDK {
   getAllSlots(): Map<string, AdSlot> {
     return new Map(this.slots);
   }
+
+  /**
+   * 커스텀 이벤트 추적
+   */
+  trackCustomEvent(eventName: string, params?: Record<string, any>): void {
+    try {
+      this.eventTracker.trackCustomEvent(eventName, {
+        timestamp: new Date().toISOString(),
+        ...params
+      });
+      if (this.config.debug) {
+        console.log(`📊 커스텀 이벤트 추적: ${eventName}`, params);
+      }
+    } catch (error) {
+      console.error('커스텀 이벤트 추적 실패:', error);
+    }
+  }
 }
 
 async function autoInit() {
@@ -346,5 +363,8 @@ export default AdStageSDK;
 export { AdType, AdEventType };
 export type { AdSlot, Advertisement };
 
-// React exports (통합)
-export * from './react';
+// Standalone API (추천 사용법)
+export * from './utils/sdk-standalone';
+
+// React exports (React가 있을 때만 사용 - 레거시)
+// export * from './react';

package/src/managers/event-tracker.ts

@@ -128,4 +128,52 @@ export class EventTracker {
     
     return 0; // 기본값
   }
+
+  /**
+   * 커스텀 이벤트 추적
+   */
+  async trackCustomEvent(eventName: string, params?: Record<string, any>): Promise<void> {
+    try {
+      // 디바이스 정보 수집
+      const deviceInfo = DeviceInfoCollector.collectDeviceInfo();
+
+      // 커스텀 이벤트 데이터 구성
+      const eventData = {
+        eventName,
+        params: params || {},
+        
+        // 기본 메타데이터
+        userAgent: deviceInfo.userAgent,
+        platform: deviceInfo.platform,
+        screenWidth: deviceInfo.screenWidth,
+        screenHeight: deviceInfo.screenHeight,
+        deviceId: deviceInfo.deviceId,
+        sessionId: deviceInfo.sessionId,
+        timestamp: new Date().toISOString(),
+        
+        // SDK 정보
+        sdkVersion: '1.3.1',
+        eventTimestamp: Date.now(),
+      };
+
+      // 커스텀 이벤트 API 엔드포인트로 전송
+      await fetch(
+        `${this.baseUrl}/events/custom`,
+        {
+          method: 'POST',
+          headers: {
+            'x-api-key': this.apiKey,
+            'Content-Type': 'application/json',
+          },
+          body: JSON.stringify(eventData),
+        }
+      );
+
+      if (this.debug) {
+        console.log(`📊 커스텀 이벤트 추적: ${eventName}`, eventData);
+      }
+    } catch (error) {
+      console.error('커스텀 이벤트 추적 실패:', error);
+    }
+  }
 }

package/src/utils/sdk-standalone.ts

@@ -0,0 +1,175 @@
+/**
+ * AdStage SDK Standalone API
+ * 간단하고 직관적인 사용을 위한 통합 API
+ */
+
+import type { AdType, AdSlotConfig } from '../types';
+
+// 간단한 설정 인터페이스
+export interface SimpleAdStageConfig {
+  apiKey: string;
+  debug?: boolean;
+  baseUrl?: string;
+}
+
+let globalSDKInstance: any = null;
+let isInitializing = false;
+
+/**
+ * SDK 초기화 (한 번만 호출)
+ */
+export async function initAdStage(config: SimpleAdStageConfig): Promise<void> {
+  if (globalSDKInstance) {
+    console.warn('AdStage SDK가 이미 초기화되었습니다.');
+    return;
+  }
+
+  if (isInitializing) {
+    console.warn('AdStage SDK 초기화가 진행 중입니다.');
+    return;
+  }
+
+  isInitializing = true;
+  
+  try {
+    // 동적 import로 circular dependency 방지
+    const { AdStageSDK } = await import('../index');
+    globalSDKInstance = AdStageSDK.init({
+      apiKey: config.apiKey,
+      debug: config.debug || false
+    });
+    console.log('✅ AdStage SDK 초기화 완료');
+  } catch (error) {
+    console.error('❌ AdStage SDK 초기화 실패:', error);
+    throw error;
+  } finally {
+    isInitializing = false;
+  }
+}
+
+/**
+ * 배너 광고 생성 (가장 간단한 API)
+ */
+export async function createBanner(
+  containerId: string,
+  options?: {
+    width?: string | number;
+    height?: string | number;
+    autoSlide?: boolean;
+    slideInterval?: number;
+  }
+): Promise<void> {
+  if (!globalSDKInstance) {
+    throw new Error('AdStage SDK가 초기화되지 않았습니다. initAdStage()를 먼저 호출하세요.');
+  }
+
+  const slotId = `banner-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
+  
+  return globalSDKInstance.createSlot(slotId, containerId, 'BANNER' as AdType, {
+    width: options?.width || '100%',
+    height: options?.height || 120,
+    autoSlideInterval: options?.autoSlide ? (options.slideInterval || 5) : 0,
+    sliderEffect: 'fade'
+  });
+}
+
+/**
+ * 텍스트 광고 생성
+ */
+export async function createTextAd(
+  containerId: string,
+  options?: {
+    maxLines?: number;
+    style?: 'minimal' | 'card' | 'banner';
+  }
+): Promise<void> {
+  if (!globalSDKInstance) {
+    throw new Error('AdStage SDK가 초기화되지 않았습니다.');
+  }
+
+  const slotId = `text-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
+  
+  return globalSDKInstance.createSlot(slotId, containerId, 'TEXT' as AdType, {
+    maxLines: options?.maxLines || 3,
+    style: options?.style || 'card'
+  });
+}
+
+/**
+ * 비디오 광고 생성
+ */
+export async function createVideoAd(
+  containerId: string,
+  options?: {
+    width?: string | number;
+    height?: string | number;
+    autoplay?: boolean;
+    muted?: boolean;
+  }
+): Promise<void> {
+  if (!globalSDKInstance) {
+    throw new Error('AdStage SDK가 초기화되지 않았습니다.');
+  }
+
+  const slotId = `video-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
+  
+  return globalSDKInstance.createSlot(slotId, containerId, 'VIDEO' as AdType, {
+    width: options?.width || '100%',
+    height: options?.height || 300,
+    autoplay: options?.autoplay || false,
+    muted: options?.muted || true
+  });
+}
+
+/**
+ * 커스텀 이벤트 추적
+ */
+export function trackEvent(eventName: string, params?: Record<string, any>): void {
+  if (!globalSDKInstance) {
+    console.warn('AdStage SDK가 초기화되지 않았습니다. 이벤트 추적을 건너뜁니다.');
+    return;
+  }
+
+  try {
+    globalSDKInstance.trackCustomEvent(eventName, {
+      timestamp: new Date().toISOString(),
+      ...params
+    });
+    console.log(`📊 이벤트 추적: ${eventName}`, params);
+  } catch (error) {
+    console.error('이벤트 추적 실패:', error);
+  }
+}
+
+/**
+ * SDK 상태 확인
+ */
+export function isAdStageReady(): boolean {
+  return globalSDKInstance !== null && !isInitializing;
+}
+
+/**
+ * SDK 인스턴스 가져오기 (고급 사용자용)
+ */
+export function getAdStageInstance() {
+  if (!globalSDKInstance) {
+    console.warn('AdStage SDK가 초기화되지 않았습니다.');
+    return null;
+  }
+  return globalSDKInstance;
+}
+
+/**
+ * SDK 초기화 해제 (필요시)
+ */
+export function destroyAdStage(): void {
+  if (globalSDKInstance) {
+    try {
+      // SDK cleanup logic here
+      globalSDKInstance = null;
+      console.log('🧹 AdStage SDK 정리 완료');
+    } catch (error) {
+      console.error('SDK 정리 중 오류:', error);
+    }
+  }
+}