@adstage/web-sdk 1.1.0 → 1.3.1

package/dist/index.d.ts

@@ -1,6 +1,3 @@
-import React, { Component, ErrorInfo, ReactNode } from 'react';
-import * as react_jsx_runtime from 'react/jsx-runtime';
-
 declare enum AdType {
     BANNER = "BANNER",
     POPUP = "POPUP",
@@ -155,176 +152,60 @@ interface AdSlot {
     destroy(): void;
 }
 
-interface BannerAdProps {
-    slotId: string;
-    width?: string | number;
-    height?: string | number;
-    className?: string;
-    style?: React.CSSProperties;
-    autoSlideInterval?: number;
-    sliderEffect?: 'slide' | 'fade';
-    language?: string;
-    deviceType?: string;
-    country?: string;
-}
 /**
- * 배너 광고 전용 컴포넌트
- * AdSlot의 래퍼로 adType이 BANNER로 고정됨
+ * AdStage SDK Standalone API
+ * 간단하고 직관적인 사용을 위한 통합 API
  */
-declare const BannerAd: React.FC<BannerAdProps>;
-
-interface TextAdProps {
-    slotId: string;
-    width?: string | number;
-    height?: string | number;
-    className?: string;
-    style?: React.CSSProperties;
-    autoSlideInterval?: number;
-    sliderEffect?: 'slide' | 'fade';
-    language?: string;
-    deviceType?: string;
-    country?: string;
+interface SimpleAdStageConfig {
+    apiKey: string;
+    debug?: boolean;
+    baseUrl?: string;
 }
 /**
- * 텍스트 광고 전용 컴포넌트
- * AdSlot의 래퍼로 adType이 TEXT로 고정됨
+ * SDK 초기화 (한 번만 호출)
  */
-declare const TextAd: React.FC<TextAdProps>;
-
-interface NativeAdProps {
-    slotId: string;
-    width?: string | number;
-    height?: string | number;
-    className?: string;
-    style?: React.CSSProperties;
-    autoSlideInterval?: number;
-    sliderEffect?: 'slide' | 'fade';
-    language?: string;
-    deviceType?: string;
-    country?: string;
-}
+declare function initAdStage(config: SimpleAdStageConfig): Promise<void>;
 /**
- * 네이티브 광고 전용 컴포넌트
- * AdSlot의 래퍼로 adType이 NATIVE로 고정됨
+ * 배너 광고 생성 (가장 간단한 API)
  */
-declare const NativeAd: React.FC<NativeAdProps>;
-
-interface VideoAdProps {
-    slotId: string;
+declare function createBanner(containerId: string, options?: {
     width?: string | number;
     height?: string | number;
-    className?: string;
-    style?: React.CSSProperties;
-    autoSlideInterval?: number;
-    sliderEffect?: 'slide' | 'fade';
-    language?: string;
-    deviceType?: string;
-    country?: string;
-}
+    autoSlide?: boolean;
+    slideInterval?: number;
+}): Promise<void>;
 /**
- * 비디오 광고 전용 컴포넌트
- * AdSlot의 래퍼로 adType이 VIDEO로 고정됨
+ * 텍스트 광고 생성
  */
-declare const VideoAd: React.FC<VideoAdProps>;
-
-interface InterstitialAdProps {
-    slotId: string;
-    width?: string | number;
-    height?: string | number;
-    className?: string;
-    style?: React.CSSProperties;
-    autoSlideInterval?: number;
-    sliderEffect?: 'slide' | 'fade';
-    language?: string;
-    deviceType?: string;
-    country?: string;
-}
+declare function createTextAd(containerId: string, options?: {
+    maxLines?: number;
+    style?: 'minimal' | 'card' | 'banner';
+}): Promise<void>;
 /**
- * 인터스티셜 광고 전용 컴포넌트
- * AdSlot의 래퍼로 adType이 INTERSTITIAL로 고정됨
+ * 비디오 광고 생성
  */
-declare const InterstitialAd: React.FC<InterstitialAdProps>;
-
-interface AdErrorBoundaryProps {
-    children: ReactNode;
-    fallback?: ReactNode;
-    onError?: (error: Error, errorInfo: ErrorInfo) => void;
-}
-interface AdErrorBoundaryState {
-    hasError: boolean;
-    error: Error | null;
-}
+declare function createVideoAd(containerId: string, options?: {
+    width?: string | number;
+    height?: string | number;
+    autoplay?: boolean;
+    muted?: boolean;
+}): Promise<void>;
 /**
- * 광고 컴포넌트에서 발생하는 오류를 포착하는 Error Boundary
- * 광고 로딩 실패 시 fallback UI를 표시하고 앱 전체가 크래시되는 것을 방지
+ * 커스텀 이벤트 추적
  */
-declare class AdErrorBoundary extends Component<AdErrorBoundaryProps, AdErrorBoundaryState> {
-    constructor(props: AdErrorBoundaryProps);
-    static getDerivedStateFromError(error: Error): AdErrorBoundaryState;
-    componentDidCatch(error: Error, errorInfo: ErrorInfo): void;
-    render(): string | number | boolean | Iterable<React.ReactNode> | react_jsx_runtime.JSX.Element | null | undefined;
-}
-
-interface AdStageSDKInstance {
-    createSlot: (...args: any[]) => Promise<void>;
-    removeSlot?: (slotId: string) => void;
-}
-interface AdStageContextValue {
-    sdk: AdStageSDKInstance | null;
-    isLoading: boolean;
-    error: string | null;
-    isInitialized: boolean;
-}
-interface AdStageProviderProps {
-    config: AdStageConfig;
-    children: ReactNode;
-    autoInit?: boolean;
-}
-declare const AdStageProvider: React.FC<AdStageProviderProps>;
-
+declare function trackEvent(eventName: string, params?: Record<string, any>): void;
 /**
- * AdStage SDK 인스턴스에 접근하기 위한 Hook
- * AdStageProvider 내부에서만 사용 가능
+ * SDK 상태 확인
  */
-declare const useAdStage: () => AdStageContextValue;
-
-interface UseAdSlotOptions {
-    slotId: string;
-    containerId: string;
-    adType: AdType;
-    width?: string | number;
-    height?: string | number;
-    language?: string;
-    deviceType?: string;
-    country?: string;
-    autoSlideInterval?: number;
-    sliderEffect?: 'slide' | 'fade';
-}
-interface UseAdSlotReturn {
-    isLoading: boolean;
-    error: string | null;
-    isCreated: boolean;
-    createSlot: () => Promise<void>;
-    resetSlot: () => void;
-}
+declare function isAdStageReady(): boolean;
 /**
- * 광고 슬롯 생성 및 관리를 위한 Hook
- * 컴포넌트에서 직접 슬롯을 제어하고 싶을 때 사용
+ * SDK 인스턴스 가져오기 (고급 사용자용)
  */
-declare const useAdSlot: (options: UseAdSlotOptions) => UseAdSlotReturn;
-
-interface UseAdTrackingReturn {
-    trackEvent: (adId: string, slotId: string, eventType: AdEventType) => void;
-    trackClick: (adId: string, slotId: string) => void;
-    trackImpression: (adId: string, slotId: string) => void;
-    trackView: (adId: string, slotId: string) => void;
-    trackClose: (adId: string, slotId: string) => void;
-}
+declare function getAdStageInstance(): any;
 /**
- * 광고 이벤트 추적을 위한 Hook
- * 커스텀 이벤트 추적이 필요할 때 사용
+ * SDK 초기화 해제 (필요시)
  */
-declare const useAdTracking: () => UseAdTrackingReturn;
+declare function destroyAdStage(): void;
 
 /**
  * AdStage SDK 설정
@@ -411,6 +292,10 @@ declare class AdStageSDK {
      * 모든 슬롯 정보 가져오기
      */
     getAllSlots(): Map<string, AdSlot>;
+    /**
+     * 커스텀 이벤트 추적
+     */
+    trackCustomEvent(eventName: string, params?: Record<string, any>): void;
 }
 
-export { AdErrorBoundary, AdEventType, AdSlot, AdStageConfig, AdStageProvider, AdStageSDK, AdType, Advertisement, BannerAd, InterstitialAd, NativeAd, TextAd, VideoAd, AdStageSDK as default, useAdSlot, useAdStage, useAdTracking };
+export { AdEventType, AdSlot, AdStageConfig, AdStageSDK, AdType, Advertisement, SimpleAdStageConfig, createBanner, createTextAd, createVideoAd, AdStageSDK as default, destroyAdStage, getAdStageInstance, initAdStage, isAdStageReady, trackEvent };