@adstage/web-sdk 1.3.4 → 2.0.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@adstage/web-sdk",
-  "version": "1.3.4",
-  "description": "AdStage Web SDK for displaying advertisements with auto DOM-ready detection",
+  "version": "2.0.0",
+  "description": "AdStage Web SDK - Production-ready marketing platform SDK with namespace architecture for ads, events, and config management",
   "type": "module",
   "main": "dist/index.cjs.js",
   "module": "dist/index.esm.js",
@@ -16,10 +16,8 @@
   "files": [
     "dist",
     "src",
-    "examples",
     "README.md",
-    "REACT_GUIDE.md",
-    "PUBLISH_GUIDE.md"
+    "LICENSE"
   ],
   "scripts": {
     "build:types": "tsc --project tsconfig.types.json",
@@ -40,17 +38,18 @@
     "advertisement",
     "ads",
     "banner",
+    "text",
+    "video", 
+    "native",
+    "interstitial",
     "sdk",
     "web",
-    "react",
-    "hooks",
-    "component",
     "typescript",
-    "text",
-    "native",
-    "video",
+    "namespace",
     "marketing",
-    "monetization"
+    "tracking",
+    "deeplink",
+    "analytics"
   ],
   "author": "AdStage",
   "license": "MIT",
@@ -77,7 +76,7 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/nbase-io/adstage.git",
+    "url": "git+https://github.com/nbase-io/adstage.git",
     "directory": "sdk"
   },
   "bugs": {

package/src/constants/endpoints.ts

@@ -0,0 +1,93 @@
+/**
+ * AdStage SDK 엔드포인트 상수 관리
+ * 모든 API URL을 중앙에서 관리
+ */
+
+/**
+ * 환경별 API 엔드포인트 (읽기 전용)
+ */
+export const API_ENDPOINTS = {
+  /** 프로덕션 환경 */
+  production: 'https://api.adstage.io',
+  
+  /** 베타 환경 (기본값) */
+  beta: 'https://beta-api.adstage.app'
+} as const;
+
+/**
+ * 기본 엔드포인트 (베타 환경)
+ */
+export const DEFAULT_API_ENDPOINT = API_ENDPOINTS.beta;
+
+/**
+ * API 경로 상수
+ */
+export const API_PATHS = {
+  /** 광고 관련 */
+  advertisements: {
+    list: '/advertisements/list',
+    events: '/advertisements/events'
+  },
+  
+  /** 이벤트 관련 */
+  events: {
+    track: '/events/track',
+    batch: '/events/batch'
+  }
+} as const;
+
+/**
+ * 완전한 API URL 생성 헬퍼
+ */
+export class EndpointBuilder {
+  private baseUrl: string;
+
+  constructor(baseUrl?: string) {
+    // 기본값은 베타 환경 사용
+    this.baseUrl = baseUrl || API_ENDPOINTS.beta;
+  }
+
+  /**
+   * 기본 URL 변경
+   */
+  setBaseUrl(url: string): void {
+    this.baseUrl = url;
+    console.log('🔄 API endpoint changed:', url);
+  }
+
+  /**
+   * 기본 URL 반환
+   */
+  getBaseUrl(): string {
+    return this.baseUrl;
+  }
+
+  /**
+   * 광고 엔드포인트
+   */
+  advertisements = {
+    list: () => `${this.baseUrl}${API_PATHS.advertisements.list}`,
+    events: (adId: string, eventType: string) => 
+      `${this.baseUrl}${API_PATHS.advertisements.events}/${adId}/${eventType}`
+  };
+
+  /**
+   * 이벤트 엔드포인트
+   */
+  events = {
+    track: () => `${this.baseUrl}${API_PATHS.events.track}`,
+    batch: () => `${this.baseUrl}${API_PATHS.events.batch}`
+  };
+
+  /**
+   * 커스텀 경로 생성
+   */
+  custom(path: string): string {
+    return `${this.baseUrl}${path.startsWith('/') ? path : `/${path}`}`;
+  }
+}
+
+/**
+ * 전역 엔드포인트 빌더 인스턴스 (기본: 베타 환경)
+ */
+export const endpoints = new EndpointBuilder();

package/src/core/AdStage.ts

@@ -0,0 +1,128 @@
+/**
+ * AdStage SDK - 메인 네임스페이스 클래스
+ * v2.0.0 - 확장 가능한 모듈 아키텍처
+ */
+
+import { AdStageConfig, ModuleName } from '../types/config';
+import { AdsModule } from '../modules/ads/AdsModule';
+import { ConfigModule } from '../modules/config/ConfigModule';
+import { EventsModule } from '../modules/events/EventsModule';
+
+export class AdStage {
+  private static instance: AdStage;
+  private _isInitialized = false;
+  private _config: AdStageConfig | null = null;
+  
+  // 모듈 인스턴스들
+  public readonly ads: AdsModule;
+  public readonly config: ConfigModule;
+  public readonly events: EventsModule;
+
+  private constructor() {
+    // 모듈 초기화 (ads, config는 완전 구현, events는 기본 구조)
+    this.config = new ConfigModule();
+    this.ads = new AdsModule();
+    this.events = new EventsModule();
+  }
+
+  /**
+   * AdStage SDK 초기화 (동기)
+   */
+  public static init(config: AdStageConfig): void {
+    if (!AdStage.instance) {
+      AdStage.instance = new AdStage();
+    }
+
+    const instance = AdStage.instance;
+    
+    // 설정 검증
+    if (!config.apiKey) {
+      throw new Error('API key is required for AdStage initialization');
+    }
+
+    // 설정 저장 (서버 검증 없음)
+    instance._config = {
+      timeout: 30000,
+      debug: false,
+      modules: ['ads', 'events', 'config'],
+      validateOnInit: false,
+      fallbackMode: true,
+      offlineMode: false,
+      productionMode: false,
+      ...config
+    };
+
+    // 모듈 동기 초기화
+    const enabledModules = instance._config.modules || ['ads', 'events', 'config'];
+    
+    for (const moduleName of enabledModules) {
+      const module = instance[moduleName as keyof AdStage] as any;
+      if (module && typeof module.init === 'function') {
+        module.init(instance._config);
+      }
+    }
+
+    instance._isInitialized = true;
+
+    if (config.debug) {
+      console.log('🚀 AdStage SDK initialized (sync mode)', {
+        version: '2.0.0',
+        modules: enabledModules,
+        apiKey: config.apiKey.substring(0, 8) + '...',
+        mode: config.productionMode ? 'production' : 'development'
+      });
+    }
+  }
+
+  /**
+   * SDK 초기화 상태 확인
+   */
+  public static isReady(): boolean {
+    return AdStage.instance?._isInitialized || false;
+  }
+
+  /**
+   * 현재 설정 반환
+   */
+  public static getConfig(): AdStageConfig | null {
+    return AdStage.instance?._config || null;
+  }
+
+  /**
+   * SDK 인스턴스 반환 (공개 메소드로 변경)
+   */
+  public static getInstance(): AdStage {
+    if (!AdStage.instance) {
+      throw new Error('AdStage not initialized. Call AdStage.init() first.');
+    }
+    return AdStage.instance;
+  }
+
+  /**
+   * 편의성을 위한 정적 모듈 접근자들
+   */
+  public static get ads() {
+    return AdStage.getInstance().ads;
+  }
+
+  public static get events() {
+    return AdStage.getInstance().events;
+  }
+
+  public static get config() {
+    return AdStage.getInstance().config;
+  }
+
+  /**
+   * SDK 리셋 (테스트용)
+   */
+  public static reset(): void {
+    if (AdStage.instance) {
+      AdStage.instance._isInitialized = false;
+      AdStage.instance._config = null;
+    }
+  }
+}
+
+// 전역 네임스페이스로 내보내기
+export default AdStage;