@adstage/web-sdk 2.4.2 → 2.4.4

package/dist/index.cjs.js

@@ -3371,21 +3371,22 @@ function AdStageProvider({ children, config }) {
  * AdStage Context Hook
  * AdStageProvider 내에서 SDK 상태에 접근할 수 있습니다.
  */
-function useAdStage() {
+function useAdStageContext() {
     const context = react.useContext(AdStageContext);
     if (!context) {
-        throw new Error('useAdStage must be used within an AdStageProvider');
+        throw new Error('useAdStageContext must be used within an AdStageProvider');
     }
     return context;
 }
 /**
- * AdStage SDK Hook
+ * AdStage Instance Hook
  * 초기화된 AdStage 인스턴스에 직접 접근할 수 있습니다.
  */
-function useAdStageSDK() {
-    const { isInitialized } = useAdStage();
+function useAdStageInstance() {
+    const { isInitialized } = useAdStageContext();
     if (!isInitialized) {
-        throw new Error('AdStage SDK is not initialized. Please call initialize() first or provide config to AdStageProvider.');
+        console.warn('AdStage SDK is not initialized. Please call initialize() first or provide config to AdStageProvider.');
+        return null;
     }
     return AdStage;
 }
@@ -3403,4 +3404,5 @@ exports.AdStage = AdStage;
 exports.AdStageProvider = AdStageProvider;
 exports.SDK_VERSION = SDK_VERSION;
 exports.SUPPORTED_MODULES = SUPPORTED_MODULES;
-exports.useAdStage = useAdStageSDK;
+exports.useAdStageContext = useAdStageContext;
+exports.useAdStageInstance = useAdStageInstance;

package/dist/index.d.ts

@@ -486,6 +486,13 @@ declare class AdStage {
     static reset(): void;
 }
 
+interface AdStageContextType {
+    isInitialized: boolean;
+    config: AdStageConfig | null;
+    initialize: (config: AdStageConfig) => void;
+    reset: () => void;
+    error: string | null;
+}
 interface AdStageProviderProps {
     children: ReactNode;
     /**
@@ -496,10 +503,15 @@ interface AdStageProviderProps {
 }
 declare function AdStageProvider({ children, config }: AdStageProviderProps): react_jsx_runtime.JSX.Element;
 /**
- * AdStage SDK Hook
+ * AdStage Context Hook
+ * AdStageProvider 내에서 SDK 상태에 접근할 수 있습니다.
+ */
+declare function useAdStageContext(): AdStageContextType;
+/**
+ * AdStage Instance Hook
  * 초기화된 AdStage 인스턴스에 직접 접근할 수 있습니다.
  */
-declare function useAdStageSDK(): typeof AdStage;
+declare function useAdStageInstance(): typeof AdStage | null;
 
 /**
  * AdStage Web SDK
@@ -509,4 +521,4 @@ declare function useAdStageSDK(): typeof AdStage;
 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, useAdStageSDK as useAdStage };
+export { AdEventType, AdOptions, AdSlot, AdStage, AdStageConfig, AdStageProvider, AdType, Advertisement, ApiResponse, BaseModule, EventProperties, ModuleName, OrganizationInfo, PageData, SDK_VERSION, SUPPORTED_MODULES, useAdStageContext, useAdStageInstance };

package/dist/index.esm.js

@@ -3369,21 +3369,22 @@ function AdStageProvider({ children, config }) {
  * AdStage Context Hook
  * AdStageProvider 내에서 SDK 상태에 접근할 수 있습니다.
  */
-function useAdStage() {
+function useAdStageContext() {
     const context = useContext(AdStageContext);
     if (!context) {
-        throw new Error('useAdStage must be used within an AdStageProvider');
+        throw new Error('useAdStageContext must be used within an AdStageProvider');
     }
     return context;
 }
 /**
- * AdStage SDK Hook
+ * AdStage Instance Hook
  * 초기화된 AdStage 인스턴스에 직접 접근할 수 있습니다.
  */
-function useAdStageSDK() {
-    const { isInitialized } = useAdStage();
+function useAdStageInstance() {
+    const { isInitialized } = useAdStageContext();
     if (!isInitialized) {
-        throw new Error('AdStage SDK is not initialized. Please call initialize() first or provide config to AdStageProvider.');
+        console.warn('AdStage SDK is not initialized. Please call initialize() first or provide config to AdStageProvider.');
+        return null;
     }
     return AdStage;
 }
@@ -3397,4 +3398,4 @@ function useAdStageSDK() {
 const SDK_VERSION = '2.0.0';
 const SUPPORTED_MODULES = ['ads', 'events', 'config'];
 
-export { AdStage, AdStageProvider, SDK_VERSION, SUPPORTED_MODULES, useAdStageSDK as useAdStage };
+export { AdStage, AdStageProvider, SDK_VERSION, SUPPORTED_MODULES, useAdStageContext, useAdStageInstance };

package/dist/index.standalone.js

@@ -3441,21 +3441,22 @@ function AdStageProvider({ children, config }) {
  * AdStage Context Hook
  * AdStageProvider 내에서 SDK 상태에 접근할 수 있습니다.
  */
-function useAdStage() {
+function useAdStageContext() {
     const context = reactExports.useContext(AdStageContext);
     if (!context) {
-        throw new Error('useAdStage must be used within an AdStageProvider');
+        throw new Error('useAdStageContext must be used within an AdStageProvider');
     }
     return context;
 }
 /**
- * AdStage SDK Hook
+ * AdStage Instance Hook
  * 초기화된 AdStage 인스턴스에 직접 접근할 수 있습니다.
  */
-function useAdStageSDK() {
-    const { isInitialized } = useAdStage();
+function useAdStageInstance() {
+    const { isInitialized } = useAdStageContext();
     if (!isInitialized) {
-        throw new Error('AdStage SDK is not initialized. Please call initialize() first or provide config to AdStageProvider.');
+        console.warn('AdStage SDK is not initialized. Please call initialize() first or provide config to AdStageProvider.');
+        return null;
     }
     return AdStage;
 }
@@ -3469,4 +3470,4 @@ function useAdStageSDK() {
 const SDK_VERSION = '2.0.0';
 const SUPPORTED_MODULES = ['ads', 'events', 'config'];
 
-export { AdStage, AdStageProvider, SDK_VERSION, SUPPORTED_MODULES, useAdStageSDK as useAdStage };
+export { AdStage, AdStageProvider, SDK_VERSION, SUPPORTED_MODULES, useAdStageContext, useAdStageInstance };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adstage/web-sdk",
-  "version": "2.4.2",
+  "version": "2.4.4",
   "description": "AdStage Web SDK - Production-ready marketing platform SDK with React Provider support for seamless integration",
   "type": "module",
   "main": "dist/index.cjs.js",

package/src/index.ts

@@ -7,7 +7,7 @@
 export { default as AdStage } from './core/AdStage';
 
 // React 통합
-export { AdStageProvider, useAdStage } from './react';
+export { AdStageProvider, useAdStageContext, useAdStageInstance } from './react';
 
 // 설정 및 타입
 export type { AdStageConfig, ModuleName, BaseModule, ApiResponse, OrganizationInfo } from './types/config';

package/src/react/AdStageProvider.tsx

@@ -94,23 +94,24 @@ export function AdStageProvider({ children, config }: AdStageProviderProps) {
  * AdStage Context Hook
  * AdStageProvider 내에서 SDK 상태에 접근할 수 있습니다.
  */
-export function useAdStage(): AdStageContextType {
+export function useAdStageContext(): AdStageContextType {
   const context = useContext(AdStageContext);
   if (!context) {
-    throw new Error('useAdStage must be used within an AdStageProvider');
+    throw new Error('useAdStageContext must be used within an AdStageProvider');
   }
   return context;
 }
 
 /**
- * AdStage SDK Hook
+ * AdStage Instance Hook
  * 초기화된 AdStage 인스턴스에 직접 접근할 수 있습니다.
  */
-export function useAdStageSDK() {
-  const { isInitialized } = useAdStage();
+export function useAdStageInstance() {
+  const { isInitialized } = useAdStageContext();
   
   if (!isInitialized) {
-    throw new Error('AdStage SDK is not initialized. Please call initialize() first or provide config to AdStageProvider.');
+    console.warn('AdStage SDK is not initialized. Please call initialize() first or provide config to AdStageProvider.');
+    return null;
   }
   
   return AdStage;

package/src/react/index.ts

@@ -3,7 +3,7 @@
  * React 애플리케이션을 위한 컴포넌트와 훅들
  */
 
-export { AdStageProvider, useAdStage as useAdStageContext, useAdStageSDK as useAdStage } from './AdStageProvider';
+export { AdStageProvider, useAdStageContext, useAdStageInstance } from './AdStageProvider';
 
 // 타입들도 재export
 export type { AdStageConfig, ModuleName, BaseModule } from '../types/config';