@adstage/web-sdk 2.5.2 → 2.6.0

package/dist/index.d.ts

@@ -19,14 +19,8 @@ interface AdStageConfig {
     modules?: ModuleName[];
     /** 요청 타임아웃 (ms) */
     timeout?: number;
-    /** 초기화시 API 키 검증 여부 (기본값: false) */
-    validateOnInit?: boolean;
-    /** 네트워크 오류시 fallback 모드 사용 (기본값: true) */
-    fallbackMode?: boolean;
-    /** 오프라인 모드 (기본값: false) */
-    offlineMode?: boolean;
-    /** 프로덕션 모드 (엄격한 검증, 기본값: false) */
-    productionMode?: boolean;
+    /** 플레이스홀더 스타일 모드 (기본값: 'subtle') */
+    placeholderMode?: 'invisible' | 'transparent' | 'subtle' | 'minimal' | 'debug' | 'legacy';
 }
 /**
  * 모듈 기본 인터페이스
@@ -219,6 +213,19 @@ interface AdOptions {
     style?: string;
     autoplay?: boolean;
     muted?: boolean;
+    loop?: boolean;
+    playsinline?: boolean;
+    controls?: boolean;
+    hideControls?: boolean;
+    customControls?: {
+        hidePlayButton?: boolean;
+        hideProgressBar?: boolean;
+        hideCurrentTime?: boolean;
+        hideRemainingTime?: boolean;
+        hideVolumeSlider?: boolean;
+        hideMuteButton?: boolean;
+        hideFullscreenButton?: boolean;
+    };
     onClick?: (adData: any) => void;
     adId?: string;
     language?: 'ko' | 'en' | 'ja' | 'zh';
@@ -231,6 +238,7 @@ declare class AdsModule implements BaseModule {
     private slots;
     private advertisementEventTracker;
     private adRenderer;
+    private mutationObserver;
     /**
      * Ads 모듈 초기화 (동기)
      */
@@ -246,15 +254,15 @@ declare class AdsModule implements BaseModule {
     /**
      * 배너 광고 생성 (동기)
      */
-    banner(containerId: string, options?: AdOptions): string;
+    banner(containerId: string | HTMLElement, options?: AdOptions): string;
     /**
      * 텍스트 광고 생성 (동기)
      */
-    text(containerId: string, options?: AdOptions): string;
+    text(containerId: string | HTMLElement, options?: AdOptions): string;
     /**
-     * 비디오 광고 생성 (동기)
+     * 비디오 광고 생성 (동기) - 단일 비디오만 지원
      */
-    video(containerId: string, options?: AdOptions): string;
+    video(containerId: string | HTMLElement, options?: AdOptions): string;
     /**
      * 네이티브 광고 생성 (동기)
      */
@@ -283,6 +291,8 @@ declare class AdsModule implements BaseModule {
      * 광고 생성 내부 메소드 (동기 + Lazy 로딩)
      */
     private createAd;
+    private createAdWithRetry;
+    private createAdInternal;
     /**
      * 백그라운드에서 광고 콘텐츠 로드
      */
@@ -310,6 +320,22 @@ declare class AdsModule implements BaseModule {
      * 모듈 준비 상태 확인
      */
     private ensureReady;
+    /**
+     * DOM 변화 감지를 통한 자동 정리 설정
+     */
+    private setupAutoCleanup;
+    /**
+     * 제거된 요소에서 광고 슬롯 정리
+     */
+    private handleRemovedElement;
+    /**
+     * 자동 정리 (로그 없이 조용히 정리)
+     */
+    private autoDestroy;
+    /**
+     * 모듈 종료 시 정리
+     */
+    destroyModule(): void;
 }
 
 /**
@@ -461,6 +487,23 @@ declare class AdStage {
      * SDK 리셋 (테스트용)
      */
     static reset(): void;
+    /**
+     * 디버그용 메서드들
+     */
+    static debug: {
+        /**
+         * 모든 viewable 추적 데이터 초기화
+         */
+        clearAllViewable: () => void;
+        /**
+         * 특정 광고의 viewable 추적 초기화
+         */
+        clearAdViewable: (adId: string, slotId: string) => void;
+        /**
+         * 현재 추적 중인 viewable 상태 확인
+         */
+        getViewableStatus: () => void;
+    };
 }
 
 interface AdStageContextType {