@vircle/sdk-web 0.2.0 → 0.2.1

package/dist/index.d.ts

@@ -1,5 +1,410 @@
-import { VircleCore, VircleConfig, VircleCoreOptions, EventContext, DeviceContext, PageContext, AppContext, StorageAdapter } from '@vircle/sdk-core-ts';
-export { AppContext, DeviceContext, EventContext, PageContext, StorageAdapter, UserProperties, VircleConfig } from '@vircle/sdk-core-ts';
+import { StorageAdapter, VircleCore, VircleConfig, VircleCoreOptions, EventContext, DeviceContext, PageContext, AppContext, ExtendedCryptoAdapter, EncryptedPayload } from '@vircle/sdk-core-ts';
+export { AppContext, DeviceContext, EventContext, PageContext, StorageAdapter, UserTraits, VircleConfig } from '@vircle/sdk-core-ts';
+
+/**
+ * 브라우저 LocalStorage를 사용하는 스토리지 어댑터
+ *
+ * @description
+ * 브라우저의 LocalStorage API를 활용하여 데이터를 영구 저장합니다.
+ * LocalStorage를 사용할 수 없는 환경에서는 자동으로 대체 스토리지로 폴백합니다.
+ * 용량 초과 시 자동으로 오래된 항목을 정리하는 LRU 방식을 지원합니다.
+ *
+ * @example
+ * ```typescript
+ * const storage = new LocalStorageAdapter('vircle_')
+ * await storage.set('user_id', '12345')
+ * const userId = await storage.get('user_id')
+ * ```
+ */
+declare class LocalStorageAdapter implements StorageAdapter {
+    private prefix;
+    private isAvailable;
+    constructor(prefix?: string);
+    /**
+     * LocalStorage 사용 가능 여부 확인
+     *
+     * @description
+     * LocalStorage API의 사용 가능 여부를 테스트합니다.
+     * 개인정보 보호 모드나 보안 제한으로 인해 LocalStorage가 비활성화된 경우를 감지합니다.
+     *
+     * @private
+     * @returns {boolean} LocalStorage 사용 가능 여부
+     */
+    private checkAvailability;
+    /**
+     * 키에 접두사 추가
+     *
+     * @description
+     * 키에 접두사를 추가하여 다른 애플리케이션과의 충돌을 방지합니다.
+     *
+     * @param {string} key - 원본 키
+     * @returns {string} 접두사가 추가된 키
+     * @private
+     */
+    private getKey;
+    /**
+     * 전체 키 반환 (접두사 포함)
+     */
+    private getFullKey;
+    /**
+     * 값 저장
+     *
+     * @description
+     * LocalStorage에 값을 저장합니다. 자동으로 타임스탬프를 추가하여 LRU 정리를 지원합니다.
+     * 용량 초과 시 자동으로 오래된 항목을 정리한 후 재시도합니다.
+     *
+     * @example
+     * ```typescript
+     * await storage.set('preferences', { theme: 'dark', lang: 'ko' })
+     * ```
+     *
+     * @template T - 저장할 값의 타입
+     * @param {string} key - 키
+     * @param {T} value - 저장할 값
+     * @throws {VircleStorageError} 저장 실패 시
+     * @returns {Promise<void>}
+     */
+    set<T = unknown>(key: string, value: T): Promise<void>;
+    /**
+     * 값 가져오기
+     *
+     * @description
+     * LocalStorage에서 값을 가져옵니다. 이전 버전과의 호환성을 지원합니다.
+     *
+     * @example
+     * ```typescript
+     * const preferences = await storage.get<{ theme: string }>('preferences')
+     * if (preferences) {
+     *   console.log(preferences.theme)
+     * }
+     * ```
+     *
+     * @template T - 반환할 값의 타입
+     * @param {string} key - 키
+     * @returns {Promise<T | null>} 저장된 값 또는 null
+     */
+    get<T = unknown>(key: string): Promise<T | null>;
+    /**
+     * 값 삭제
+     *
+     * @description
+     * LocalStorage에서 특정 키의 값을 삭제합니다.
+     *
+     * @example
+     * ```typescript
+     * const removed = await storage.remove('old_data')
+     * console.log(removed ? '삭제 성공' : '키가 존재하지 않음')
+     * ```
+     *
+     * @param {string} key - 키
+     * @returns {Promise<boolean>} 삭제 성공 여부
+     */
+    remove(key: string): Promise<boolean>;
+    /**
+     * 모든 값 삭제
+     *
+     * @description
+     * 현재 접두사로 시작하는 모든 키의 값을 LocalStorage에서 삭제합니다.
+     * 성능 최적화를 위해 모든 키를 한 번에 가져와서 필터링합니다.
+     *
+     * @example
+     * ```typescript
+     * await storage.clear()
+     * console.log('모든 데이터 삭제 완료')
+     * ```
+     *
+     * @returns {Promise<void>}
+     */
+    clear(): Promise<void>;
+    /**
+     * 키 존재 여부 확인
+     *
+     * @description
+     * LocalStorage에 특정 키가 존재하는지 확인합니다.
+     *
+     * @example
+     * ```typescript
+     * if (await storage.has('user_preferences')) {
+     *   const prefs = await storage.get('user_preferences')
+     * }
+     * ```
+     *
+     * @param {string} key - 키
+     * @returns {Promise<boolean>} 존재 여부
+     */
+    has(key: string): Promise<boolean>;
+    /**
+     * 저장된 항목 수
+     *
+     * @description
+     * 현재 접두사로 저장된 모든 항목의 개수를 반환합니다.
+     *
+     * @example
+     * ```typescript
+     * const count = await storage.size()
+     * console.log(`저장된 항목 수: ${count}`)
+     * ```
+     *
+     * @returns {Promise<number>} 항목 수
+     */
+    size(): Promise<number>;
+    /**
+     * 모든 키 반환
+     *
+     * @description
+     * 현재 접두사로 저장된 모든 키를 배열로 반환합니다.
+     * 접두사는 제거된 원본 키를 반환합니다.
+     *
+     * @example
+     * ```typescript
+     * const allKeys = await storage.keys()
+     * for (const key of allKeys) {
+     *   console.log(`Key: ${key}`)
+     * }
+     * ```
+     *
+     * @returns {Promise<string[]>} 키 배열
+     */
+    keys(): Promise<string[]>;
+    /**
+     * 오래된 항목 정리 (LRU 방식)
+     *
+     * @description
+     * LocalStorage 용량이 부족할 때 가장 오래된 항목들을 삭제합니다.
+     * 타임스탬프를 기준으로 오래된 순으로 정렬하여 하위 20%를 삭제합니다.
+     *
+     * @private
+     * @returns {Promise<void>}
+     */
+    private clearOldItems;
+    /**
+     * 타임스탬프와 함께 저장 (LRU 지원)
+     *
+     * @deprecated set 메서드가 이미 타임스탬프를 포함합니다
+     * @param {string} key - 키
+     * @param {T} value - 저장할 값
+     * @returns {Promise<void>}
+     */
+    setWithTimestamp<T = unknown>(key: string, value: T): Promise<void>;
+}
+
+/**
+ * IndexedDB를 사용하는 비동기 스토리지 어댑터
+ *
+ * @description
+ * 브라우저의 IndexedDB API를 활용하여 대용량 데이터를 비동기적으로 저장합니다.
+ * LocalStorage와 달리 메인 스레드를 차단하지 않으며, 더 큰 용량을 지원합니다.
+ *
+ * @example
+ * ```typescript
+ * const storage = new IndexedDBAdapter('vircle_')
+ * await storage.set('user_id', '12345')
+ * const userId = await storage.get('user_id')
+ * ```
+ */
+declare class IndexedDBAdapter implements StorageAdapter {
+    private db;
+    private readonly dbName;
+    private readonly storeName;
+    private readonly dbVersion;
+    private readonly prefix;
+    private initPromise;
+    private isClosed;
+    constructor(prefix?: string);
+    /**
+     * IndexedDB 초기화
+     *
+     * @description
+     * IndexedDB 연결을 초기화하고 스토어를 생성합니다.
+     * 여러 번 호출되어도 한 번만 초기화됩니다.
+     *
+     * @private
+     * @returns {Promise<void>}
+     */
+    private init;
+    /**
+     * IndexedDB 연결 열기
+     *
+     * @private
+     * @returns {Promise<void>}
+     */
+    private openDB;
+    /**
+     * 키에 접두사 추가
+     *
+     * @private
+     * @param {string} key - 원본 키
+     * @returns {string} 접두사가 추가된 키
+     */
+    private getKey;
+    /**
+     * 값 저장
+     *
+     * @description
+     * IndexedDB에 값을 비동기적으로 저장합니다.
+     * 메인 스레드를 차단하지 않아 성능이 향상됩니다.
+     *
+     * @template T - 저장할 값의 타입
+     * @param {string} key - 키
+     * @param {T} value - 저장할 값
+     * @returns {Promise<void>}
+     */
+    set<T = unknown>(key: string, value: T): Promise<void>;
+    /**
+     * 값 가져오기
+     *
+     * @description
+     * IndexedDB에서 값을 비동기적으로 가져옵니다.
+     *
+     * @template T - 반환할 값의 타입
+     * @param {string} key - 키
+     * @returns {Promise<T | null>} 저장된 값 또는 null
+     */
+    get<T = unknown>(key: string): Promise<T | null>;
+    /**
+     * 값 삭제
+     *
+     * @description
+     * IndexedDB에서 특정 키의 값을 삭제합니다.
+     *
+     * @param {string} key - 키
+     * @returns {Promise<boolean>} 삭제 성공 여부
+     */
+    remove(key: string): Promise<boolean>;
+    /**
+     * 모든 값 삭제
+     *
+     * @description
+     * 현재 접두사로 시작하는 모든 키의 값을 삭제합니다.
+     *
+     * @returns {Promise<void>}
+     */
+    clear(): Promise<void>;
+    /**
+     * 키 존재 여부 확인
+     *
+     * @param {string} key - 키
+     * @returns {Promise<boolean>} 존재 여부
+     */
+    has(key: string): Promise<boolean>;
+    /**
+     * 저장된 항목 수
+     *
+     * @description
+     * 현재 접두사로 저장된 모든 항목의 개수를 반환합니다.
+     *
+     * @returns {Promise<number>} 항목 수
+     */
+    size(): Promise<number>;
+    /**
+     * 모든 키 반환
+     *
+     * @description
+     * 현재 접두사로 저장된 모든 키를 배열로 반환합니다.
+     *
+     * @returns {Promise<string[]>} 키 배열
+     */
+    keys(): Promise<string[]>;
+    /**
+     * 오래된 항목 정리 (LRU 방식)
+     *
+     * @description
+     * 용량이 부족할 때 타임스탬프 기준으로 오래된 항목을 삭제합니다.
+     *
+     * @param {number} percentage - 삭제할 비율 (0-1)
+     * @returns {Promise<void>}
+     */
+    clearOldItems(percentage?: number): Promise<void>;
+    /**
+     * 연결 종료
+     *
+     * @description
+     * IndexedDB 연결을 명시적으로 종료합니다.
+     *
+     * @returns {Promise<void>}
+     */
+    close(): Promise<void>;
+}
+
+type StorageType = 'auto' | 'localStorage' | 'indexedDB';
+/**
+ * 스토리지 어댑터 팩토리
+ *
+ * @description
+ * 환경과 요구사항에 맞는 최적의 스토리지 어댑터를 생성합니다.
+ * IndexedDB를 우선 사용하고, 지원하지 않으면 LocalStorage로 폴백합니다.
+ */
+declare class StorageFactory {
+    /**
+     * 스토리지 어댑터 생성 (동기)
+     *
+     * @description
+     * 동기적으로 스토리지 어댑터를 생성합니다.
+     * 'auto' 모드에서는 API 존재 여부만 확인하고 IndexedDB를 우선 사용합니다.
+     * Safari Private 모드 등에서 실제 사용 불가 시 런타임 에러가 발생할 수 있습니다.
+     *
+     * @param {string} prefix - 키 접두사
+     * @param {StorageType} type - 스토리지 타입
+     * @returns {StorageAdapter} 생성된 스토리지 어댑터
+     */
+    static create(prefix?: string, type?: StorageType): StorageAdapter;
+    /**
+     * 스토리지 어댑터 생성 (비동기, 권장)
+     *
+     * @description
+     * 비동기적으로 스토리지 어댑터를 생성합니다.
+     * 'auto' 모드에서는 실제 IndexedDB 사용 가능 여부를 테스트한 후 결정합니다.
+     * Safari Private 모드 등에서도 안전하게 LocalStorage로 폴백됩니다.
+     *
+     * @param {string} prefix - 키 접두사
+     * @param {StorageType} type - 스토리지 타입
+     * @returns {Promise<StorageAdapter>} 생성된 스토리지 어댑터
+     */
+    static createAsync(prefix?: string, type?: StorageType): Promise<StorageAdapter>;
+    /**
+     * 자동으로 최적의 스토리지 선택 (비동기)
+     *
+     * @private
+     * @param {string} prefix - 키 접두사
+     * @returns {Promise<StorageAdapter>} 선택된 스토리지 어댑터
+     */
+    private static createAutoAsync;
+    /**
+     * 자동으로 최적의 스토리지 선택
+     *
+     * @private
+     * @param {string} prefix - 키 접두사
+     * @returns {StorageAdapter} 선택된 스토리지 어댑터
+     */
+    private static createAuto;
+    /**
+     * IndexedDB 사용 가능 여부 확인 (동기)
+     *
+     * @description
+     * API 존재 여부만 동기적으로 확인합니다.
+     * Safari Private 모드 등에서의 실제 사용 가능 여부는 IndexedDBAdapter.init()에서 확인됩니다.
+     *
+     * @private
+     * @returns {boolean} API 존재 여부
+     */
+    private static isIndexedDBAvailable;
+    /**
+     * IndexedDB 사용 가능 여부 확인 (비동기)
+     *
+     * @description
+     * 실제로 IndexedDB를 열어서 사용 가능 여부를 확인합니다.
+     * Safari Private 모드 등에서의 제한도 감지합니다.
+     *
+     * @returns {Promise<boolean>} 사용 가능 여부
+     */
+    static isIndexedDBAvailableAsync(): Promise<boolean>;
+    /**
+     * LocalStorage 사용 가능 여부 확인
+     *
+     * @returns {boolean} 사용 가능 여부
+     */
+    static isLocalStorageAvailable(): boolean;
+}
 
 interface VircleWebConfig extends VircleConfig {
     /**
@@ -26,6 +431,23 @@ interface VircleWebConfig extends VircleConfig {
      * 커스텀 스토리지 키 접두사
      */
     storagePrefix?: string;
+    /**
+     * 스토리지 타입 선택 (기본값: 'auto')
+     * - 'auto': 자동으로 최적 선택 (IndexedDB 우선)
+     * - 'localStorage': 항상 LocalStorage 사용
+     * - 'indexedDB': 항상 IndexedDB 사용
+     */
+    storageType?: StorageType;
+    /**
+     * 암호화 활성화 (기본값: false)
+     * Web Crypto API를 사용하여 이벤트 데이터를 암호화합니다.
+     */
+    enableEncryption?: boolean;
+    /**
+     * 세션 타임아웃 (밀리초, 기본값: 30분)
+     * 지정된 시간 동안 비활성 상태이면 새 세션을 시작합니다.
+     */
+    sessionTimeout?: number;
 }
 interface VircleWebOptions extends Partial<VircleCoreOptions> {
     /**
@@ -36,10 +458,6 @@ interface VircleWebOptions extends Partial<VircleCoreOptions> {
      * 컨텍스트 캐싱 시간 (ms)
      */
     contextCacheTime?: number;
-    /**
-     * 성능 측정 활성화
-     */
-    enablePerformance?: boolean;
 }
 /**
  * Web 플랫폼용 Vircle SDK
@@ -59,7 +477,6 @@ declare class VircleWeb extends VircleCore {
     private contextCollector;
     private webConfig;
     private webOptions;
-    private performanceTracker?;
     private pageViewTracked;
     private errorHandler?;
     private unhandledRejectionHandler?;
@@ -67,6 +484,11 @@ declare class VircleWeb extends VircleCore {
     private submitHandler?;
     private popstateHandler?;
     private unloadHandler?;
+    private visibilityChangeHandler?;
+    private originalPushState?;
+    private originalReplaceState?;
+    private lastActivityTime;
+    private sessionTimeout;
     constructor(config: VircleWebConfig, options?: VircleWebOptions);
     /**
      * SDK 초기화 및 자동 추적 설정
@@ -90,6 +512,13 @@ declare class VircleWeb extends VircleCore {
      * @returns {Promise<void>}
      */
     initialize(): Promise<void>;
+    /**
+     * 사용자 식별 (컨텍스트 캐시 무효화 포함)
+     *
+     * @description
+     * 사용자를 식별하고 컨텍스트 캐시를 무효화하여 이후 이벤트에 정확한 컨텍스트가 포함되도록 합니다.
+     */
+    identify<TTraits extends Record<string, unknown> = Record<string, unknown>>(userId: string, traits?: TTraits): Promise<void>;
     /**
      * 페이지뷰 추적
      *
@@ -115,7 +544,7 @@ declare class VircleWeb extends VircleCore {
     trackPageView(properties?: Record<string, unknown>, context?: EventContext): Promise<void>;
     /**
      * 웹 환경에 최적화된 이벤트 추적
-     * AIDEV-NOTE: 이제 코어의 TaskScheduler를 사용하여 requestIdleCallback 기반의
+     * 이제 코어의 TaskScheduler를 사용하여 requestIdleCallback 기반의
      * 일관된 성능 최적화 구현
      */
     track<TProperties extends Record<string, unknown> = Record<string, unknown>>(name: string, properties?: TProperties, context?: EventContext): Promise<void>;
@@ -129,7 +558,7 @@ declare class VircleWeb extends VircleCore {
      * @private
      * @returns {Promise<EventContext>} 이벤트 컨텍스트
      *
-     * AIDEV-NOTE: 컨텍스트 수집은 DOM 접근이 많아 비용이 높으므로
+     * 컨텍스트 수집은 DOM 접근이 많아 비용이 높으므로
      * 캐싱을 통해 성능을 최적화. 중복 수집 방지를 위한 Promise 재사용 구현
      */
     private getCachedContext;
@@ -195,6 +624,16 @@ declare class VircleWeb extends VircleCore {
      * @private
      */
     private handleRouteChange;
+    /**
+     * 세션 타임아웃 체크
+     *
+     * @description
+     * 마지막 활동 시간으로부터 세션 타임아웃이 경과했는지 확인합니다.
+     * 만료 시 새 세션을 생성하고 session_start 이벤트를 추적합니다.
+     *
+     * @private
+     */
+    private checkSessionTimeout;
     /**
      * 요소가 추적 대상인지 확인
      *
@@ -337,265 +776,62 @@ declare class WebContextCollector {
 }
 
 /**
- * 브라우저 LocalStorage를 사용하는 스토리지 어댑터
+ * Web Crypto API 기반 암호화 어댑터
  *
  * @description
- * 브라우저의 LocalStorage API를 활용하여 데이터를 영구 저장합니다.
- * LocalStorage를 사용할 수 없는 환경에서는 자동으로 대체 스토리지로 폴백합니다.
- * 용량 초과 시 자동으로 오래된 항목을 정리하는 LRU 방식을 지원합니다.
- *
- * @example
- * ```typescript
- * const storage = new LocalStorageAdapter('vircle_')
- * await storage.set('user_id', '12345')
- * const userId = await storage.get('user_id')
- * ```
+ * 브라우저의 Web Crypto API를 사용하여 하이브리드 암호화(AES-256-GCM + RSA-OAEP)를 구현합니다.
+ * 모든 암호화 작업은 브라우저의 네이티브 암호화 엔진을 사용하여 보안성과 성능을 보장합니다.
  */
-declare class LocalStorageAdapter implements StorageAdapter {
-    private prefix;
-    private isAvailable;
-    constructor(prefix?: string);
-    /**
-     * LocalStorage 사용 가능 여부 확인
-     *
-     * @description
-     * LocalStorage API의 사용 가능 여부를 테스트합니다.
-     * 개인정보 보호 모드나 보안 제한으로 인해 LocalStorage가 비활성화된 경우를 감지합니다.
-     *
-     * @private
-     * @returns {boolean} LocalStorage 사용 가능 여부
-     */
-    private checkAvailability;
-    /**
-     * 키에 접두사 추가
-     *
-     * @description
-     * 키에 접두사를 추가하여 다른 애플리케이션과의 충돌을 방지합니다.
-     *
-     * @param {string} key - 원본 키
-     * @returns {string} 접두사가 추가된 키
-     * @private
-     */
-    private getKey;
-    /**
-     * 값 저장
-     *
-     * @description
-     * LocalStorage에 값을 저장합니다. 자동으로 타임스탬프를 추가하여 LRU 정리를 지원합니다.
-     * 용량 초과 시 자동으로 오래된 항목을 정리한 후 재시도합니다.
-     *
-     * @example
-     * ```typescript
-     * await storage.set('preferences', { theme: 'dark', lang: 'ko' })
-     * ```
-     *
-     * @template T - 저장할 값의 타입
-     * @param {string} key - 키
-     * @param {T} value - 저장할 값
-     * @throws {VircleStorageError} 저장 실패 시
-     * @returns {Promise<void>}
-     */
-    set<T = unknown>(key: string, value: T): Promise<void>;
-    /**
-     * 값 가져오기
-     *
-     * @description
-     * LocalStorage에서 값을 가져옵니다. 이전 버전과의 호환성을 지원합니다.
-     *
-     * @example
-     * ```typescript
-     * const preferences = await storage.get<{ theme: string }>('preferences')
-     * if (preferences) {
-     *   console.log(preferences.theme)
-     * }
-     * ```
-     *
-     * @template T - 반환할 값의 타입
-     * @param {string} key - 키
-     * @returns {Promise<T | null>} 저장된 값 또는 null
-     */
-    get<T = unknown>(key: string): Promise<T | null>;
-    /**
-     * 값 삭제
-     *
-     * @description
-     * LocalStorage에서 특정 키의 값을 삭제합니다.
-     *
-     * @example
-     * ```typescript
-     * const removed = await storage.remove('old_data')
-     * console.log(removed ? '삭제 성공' : '키가 존재하지 않음')
-     * ```
-     *
-     * @param {string} key - 키
-     * @returns {Promise<boolean>} 삭제 성공 여부
-     */
-    remove(key: string): Promise<boolean>;
-    /**
-     * 모든 값 삭제
-     *
-     * @description
-     * 현재 접두사로 시작하는 모든 키의 값을 LocalStorage에서 삭제합니다.
-     * 성능 최적화를 위해 모든 키를 한 번에 가져와서 필터링합니다.
-     *
-     * @example
-     * ```typescript
-     * await storage.clear()
-     * console.log('모든 데이터 삭제 완료')
-     * ```
-     *
-     * @returns {Promise<void>}
-     */
-    clear(): Promise<void>;
-    /**
-     * 키 존재 여부 확인
-     *
-     * @description
-     * LocalStorage에 특정 키가 존재하는지 확인합니다.
-     *
-     * @example
-     * ```typescript
-     * if (await storage.has('user_preferences')) {
-     *   const prefs = await storage.get('user_preferences')
-     * }
-     * ```
-     *
-     * @param {string} key - 키
-     * @returns {Promise<boolean>} 존재 여부
-     */
-    has(key: string): Promise<boolean>;
-    /**
-     * 저장된 항목 수
-     *
-     * @description
-     * 현재 접두사로 저장된 모든 항목의 개수를 반환합니다.
-     *
-     * @example
-     * ```typescript
-     * const count = await storage.size()
-     * console.log(`저장된 항목 수: ${count}`)
-     * ```
-     *
-     * @returns {Promise<number>} 항목 수
-     */
-    size(): Promise<number>;
-    /**
-     * 모든 키 반환
-     *
-     * @description
-     * 현재 접두사로 저장된 모든 키를 배열로 반환합니다.
-     * 접두사는 제거된 원본 키를 반환합니다.
-     *
-     * @example
-     * ```typescript
-     * const allKeys = await storage.keys()
-     * for (const key of allKeys) {
-     *   console.log(`Key: ${key}`)
-     * }
-     * ```
-     *
-     * @returns {Promise<string[]>} 키 배열
-     */
-    keys(): Promise<string[]>;
-    /**
-     * 오래된 항목 정리 (LRU 방식)
-     *
-     * @description
-     * LocalStorage 용량이 부족할 때 가장 오래된 항목들을 삭제합니다.
-     * 타임스탬프를 기준으로 오래된 순으로 정렬하여 하위 20%를 삭제합니다.
-     *
-     * @private
-     * @returns {Promise<void>}
-     */
-    private clearOldItems;
-    /**
-     * 타임스탬프와 함께 저장 (LRU 지원)
-     *
-     * @deprecated set 메서드가 이미 타임스탬프를 포함합니다
-     * @param {string} key - 키
-     * @param {T} value - 저장할 값
-     * @returns {Promise<void>}
-     */
-    setWithTimestamp<T = unknown>(key: string, value: T): Promise<void>;
-}
 
 /**
- * 웹 성능 측정 및 추적
+ * Web Crypto API를 사용하는 ExtendedCryptoAdapter 구현
  */
-declare class WebPerformanceTracker {
-    private observer?;
-    private marks;
-    /**
-     * 성능 추적 시작
-     */
-    startTracking(): void;
-    /**
-     * 성능 추적 중지
-     */
-    stopTracking(): void;
+declare class WebExtendedCryptoAdapter implements ExtendedCryptoAdapter {
+    private crypto;
+    private subtle;
+    private available;
+    constructor();
     /**
-     * Performance API 지원 여부 확인
+     * Web Crypto API 초기화
      */
-    private isSupported;
+    private initCrypto;
     /**
-     * Long Task 감지
+     * UUID v4 생성
      */
-    private observeLongTasks;
+    generateUUID(): string;
     /**
-     * Layout Shift 감지
+     * HMAC-SHA256 서명 생성
      */
-    private observeLayoutShifts;
+    createHmacSignature(payload: any, secret: string): Promise<string>;
     /**
-     * Largest Contentful Paint 감지
+     * 하이브리드 암호화 (AES-256-GCM + RSA-OAEP)
+     *
+     * @description
+     * 1. AES-256-GCM으로 데이터 암호화
+     * 2. RSA-OAEP로 AES 키 암호화
      */
-    private observeLCP;
+    encryptPayload(data: Record<string, any>, publicKeyBase64: string): Promise<EncryptedPayload>;
     /**
-     * First Input Delay 감지
+     * Web Crypto API 사용 가능 여부
      */
-    private observeFID;
+    isAvailable(): boolean;
     /**
-     * 커스텀 성능 마크 시작
-     * @param name - 마크 이름
+     * RSA 공개키 가져오기 (PEM/Base64 → CryptoKey)
      */
-    mark(name: string): void;
+    private importRsaPublicKey;
     /**
-     * 커스텀 성능 측정
-     * @param name - 마크 이름
-     * @returns 측정된 시간 (ms)
+     * ArrayBuffer를 Base64 문자열로 변환
      */
-    measure(name: string): number | null;
+    private arrayBufferToBase64;
     /**
-     * 페이지 로드 메트릭 가져오기
+     * Base64 문자열을 ArrayBuffer로 변환
      */
-    getLoadMetrics(): Record<string, number>;
+    private base64ToArrayBuffer;
     /**
-     * 리소스 타이밍 데이터 가져오기
+     * ArrayBuffer를 Hex 문자열로 변환
      */
-    getResourceTimings(): Array<{
-        name: string;
-        type: string;
-        duration: number;
-        size: number;
-    }>;
+    private arrayBufferToHex;
 }
-/**
- * 함수 실행 시간 측정 데코레이터
- */
-declare function measurePerformance(target: unknown, propertyKey: string, descriptor: PropertyDescriptor): PropertyDescriptor;
-/**
- * 디바운스 유틸리티
- * @param func - 디바운스할 함수
- * @param wait - 대기 시간 (ms)
- * @returns 디바운스된 함수
- */
-declare function debounce<T extends (...args: unknown[]) => unknown>(func: T, wait: number): (...args: Parameters<T>) => void;
-/**
- * 쓰로틀 유틸리티
- * @param func - 쓰로틀할 함수
- * @param limit - 제한 시간 (ms)
- * @returns 쓰로틀된 함수
- */
-declare function throttle<T extends (...args: unknown[]) => unknown>(func: T, limit: number): (...args: Parameters<T>) => void;
 
 /**
  * Vircle Web SDK 전용 에러 클래스
@@ -697,5 +933,5 @@ declare class VircleBrowserCompatibilityError extends VircleWebError {
     constructor(message: string, details?: Record<string, any>);
 }
 
-export { LocalStorageAdapter, VircleBrowserCompatibilityError, VircleConfigError, VircleInitializationError, VircleStorageError, VircleWeb, VircleWebError, WebContextCollector, WebPerformanceTracker, debounce, VircleWeb as default, measurePerformance, throttle };
-export type { VircleWebConfig, VircleWebOptions };
+export { IndexedDBAdapter, LocalStorageAdapter, StorageFactory, VircleBrowserCompatibilityError, VircleConfigError, VircleInitializationError, VircleStorageError, VircleWeb, VircleWebError, WebContextCollector, WebExtendedCryptoAdapter, VircleWeb as default };
+export type { StorageType, VircleWebConfig, VircleWebOptions };