@adstage/web-sdk 3.0.1 → 3.0.3

package/dist/index.d.ts

@@ -392,19 +392,34 @@ declare class ConfigModule implements BaseModule {
 }
 
 /**
- * AdStage SDK - Events 모듈
- * 이벤트 추적 시스템
+ * 사용자 속성 타입
+ * API의 UserAttributesInput과 동일한 구조
  */
-
-interface EventProperties {
-    [key: string]: any;
+interface UserProperties {
+    /** 성별 */
+    gender?: 'male' | 'female' | 'other' | 'unknown';
+    /** 국가 코드 (ISO 3166-1 alpha-2) */
+    country?: string;
+    /** 도시명 */
+    city?: string;
+    /** 나이 (문자열) */
+    age?: string;
+    /** 언어 코드 (ISO 639-1) */
+    language?: string;
 }
-interface PageData {
-    page?: string;
-    title?: string;
-    category?: string;
+/**
+ * 이벤트 속성 타입
+ */
+interface EventProperties {
+    /** 이벤트 매개변수 */
     [key: string]: any;
 }
+
+/**
+ * AdStage SDK - Events 모듈
+ * 이벤트 추적 시스템
+ */
+
 declare class EventsModule implements BaseModule {
     private _isReady;
     private _config;
@@ -431,14 +446,7 @@ declare 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;
     /**
      * 현재 사용자 속성 반환
      */
@@ -449,10 +457,6 @@ declare class EventsModule implements BaseModule {
      * @param properties 이벤트 속성
      */
     track(eventName: string, properties?: EventProperties): Promise<void>;
-    /**
-     * 페이지 뷰 이벤트 (track의 편의 메소드)
-     */
-    pageView(pageData?: PageData): Promise<void>;
     /**
      * 서버에 이벤트 전송
      */
@@ -517,11 +521,6 @@ declare class AdStage {
     };
 }
 
-/**
- * AdStage SDK - 전역 이벤트 함수들
- * Firebase Analytics와 유사한 간단한 API 제공
- */
-
 /**
  * 이벤트 추적 (메인 함수)
  * @param eventName 이벤트 이름
@@ -535,14 +534,6 @@ declare class AdStage {
  * });
  */
 declare function track(eventName: string, properties?: EventProperties): Promise<void>;
-/**
- * 페이지 뷰 추적
- * @param pageData 페이지 정보
- *
- * @example
- * pageView({ page: '/products', title: 'Products Page' });
- */
-declare function pageView(pageData?: PageData): Promise<void>;
 /**
  * 사용자 ID 설정
  * @param userId 사용자 ID
@@ -555,6 +546,22 @@ declare function setUserId(userId: string): void;
  * 현재 사용자 ID 반환
  */
 declare function getUserId(): string | undefined;
+/**
+ * 사용자 속성 설정
+ * @param properties 사용자 속성 객체
+ *
+ * @example
+ * setUserProperties({
+ *   gender: 'male',
+ *   country: 'KR',
+ *   age: '25'
+ * });
+ */
+declare function setUserProperties(properties: UserProperties): void;
+/**
+ * 현재 사용자 속성 반환
+ */
+declare function getUserProperties(): any;
 
 interface AdStageContextType {
     isInitialized: boolean;
@@ -591,4 +598,4 @@ declare function useAdStageInstance(): typeof AdStage | null;
 declare const SDK_VERSION = "2.0.0";
 declare const SUPPORTED_MODULES: readonly ["ads", "events", "config"];
 
-export { AdEventType, AdOptions, AdSlot, AdStage, AdStageConfig, AdStageProvider, AdType, Advertisement, ApiResponse, BaseModule, EventProperties, ModuleName, OrganizationInfo, PageData, SDK_VERSION, SUPPORTED_MODULES, getUserId, pageView, setUserId, track, useAdStageContext, useAdStageInstance };
+export { AdEventType, AdOptions, AdSlot, AdStage, AdStageConfig, AdStageProvider, AdType, Advertisement, ApiResponse, BaseModule, EventProperties, ModuleName, OrganizationInfo, SDK_VERSION, SUPPORTED_MODULES, UserProperties, getUserId, getUserProperties, setUserId, setUserProperties, track, useAdStageContext, useAdStageInstance };