tagworks-sdk-v1-react 1.1.21 → 1.1.23

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tagworks-sdk-v1-react",
-  "version": "1.1.21",
+  "version": "1.1.23",
   "description": "TagWorks SDK React Native Library",
   "source": "./src/index.js",
   "main": "./lib/commonjs/index.js",
@@ -55,7 +55,7 @@
     "url": "git+http://192.168.20.44:8443/etc/mobile/sdk/tagworks-sdk-v1-react.git"
   },
   "author": "pudaegii <pudaegii@obzen.com> (https://github.com/JongCheol-obzen)",
-  "license": "MIT",
+  "license": "Apache-2.0",
   "bugs": {
     "url": "http://192.168.20.44:8443/etc/mobile/sdk/tagworks-sdk-v1-react/issues"
   },
@@ -75,7 +75,7 @@
     "eslint-plugin-prettier": "^5.0.1",
     "jest": "^29.7.0",
     "prettier": "^3.0.3",
-    "react": "^18.3.1",
+    "react": "18.3.1",
     "react-native": "^0.76.5",
     "react-native-builder-bob": "^0.35.2",
     "release-it": "^17.10.0",
@@ -89,8 +89,26 @@
     "@types/react": "^18.2.44"
   },
   "peerDependencies": {
+    "@react-navigation/native": "*",
+    "@react-navigation/native-stack": "*",
     "react": "*",
-    "react-native": "*"
+    "react-native": "*",
+    "react-native-safe-area-context": "*",
+    "react-native-screens": "*"
+  },
+  "peerDependenciesMeta": {
+    "@react-navigation/native": {
+      "optional": true
+    },
+    "@react-navigation/native-stack": {
+      "optional": true
+    },
+    "react-native-safe-area-context": {
+      "optional": true
+    },
+    "react-native-screens": {
+      "optional": true
+    }
   },
   "workspaces": [
     "example"

package/src/OnCmsBannerCommands.js

@@ -0,0 +1,31 @@
+// OnCmsBannerCommands.js
+import { UIManager, findNodeHandle, Platform } from 'react-native';
+
+const VIEW_NAME = 'OnCmsBannerView';
+
+export function attachBanner(ref, params) {
+    console.log('🟡 attachBannerRef:', ref);
+    console.log('🟡 attachBannerParams:', params);
+    const tag = findNodeHandle(ref.current);
+    if (!tag) return;
+
+    // 'VIEW_NAME'에 해당하는 네이티브 ViewManager 정보 조회
+    const config = UIManager.getViewManagerConfig(VIEW_NAME);
+//   console.log('🟡 ViewManagerConfig:', config);
+    // const commandId = config.Commands.setOnCmsBannerParam;
+    const commandId = config?.Constants?.Commands?.setOnCmsBannerParam;
+
+    if (commandId === undefined) {
+        console.error('❌ attach command not found', config);
+        return;
+    }
+
+    console.log('🟡 dispatchViewManagerCommand tag:', tag);
+    console.log('🟡 dispatchViewManagerCommand commandId:', commandId);
+    UIManager.dispatchViewManagerCommand(tag, commandId, [
+        params.url,
+        params.custId,
+        params.areaCd,
+        params.defaultImage,
+    ]);
+}

package/src/RegisterOnCmsBannerView.js

@@ -0,0 +1,5 @@
+import { requireNativeComponent } from 'react-native';
+
+const OnCmsBannerView = requireNativeComponent('OnCmsBannerView');
+
+export default OnCmsBannerView;

package/src/autoTrackers/ReactNavigationPageTracker.js

@@ -0,0 +1,137 @@
+// autoTrackers/reactNavigationPageTracker.js
+// React Navigation 전용
+
+import * as React from 'react';
+import { useRef, useCallback } from 'react';
+import * as ReactNavigation from '@react-navigation/native';
+import { NavigationContainer } from '@react-navigation/native';
+import { NativeModules } from 'react-native';
+
+// 로그 전송 함수 
+const logEventPageView = (currentScreen, previousScreen, indexPath) => {
+    const { TagWorksModule, DataBundleModule, StandardEventModule } = NativeModules;
+
+    if (currentScreen) {
+        console.log(`[TagWorks SDK] 화면 전환 완료: ${previousScreen || '앱 시작'} -> ${currentScreen}, indexPath: ${indexPath}`);
+
+        // TODO: 여기에 SDK의 실제 로그 전송 API 호출 로직을 구현합니다.
+        DataBundleModule.initialize();
+        DataBundleModule.putString(
+          DataBundleModule.EVENT_TAG_NAME, StandardEventModule.PAGE_VIEW
+        );
+        DataBundleModule.putString(
+          DataBundleModule.EVENT_TAG_PARAM_TITLE, currentScreen
+        );
+        DataBundleModule.putString(
+          DataBundleModule.EVENT_TAG_PARAM_PAGE_PATH, indexPath
+        );
+        DataBundleModule.getDataBundle((bundleString) => {
+          console.log('Received Dictionary String:', bundleString);
+
+          TagWorksModule.logEvent(
+            TagWorksModule.EVENT_TYPE_PAGE,
+            bundleString,
+            (result) => {
+              console.log(result);
+            }
+          );
+        });
+    }
+};
+
+function buildPathFromStack(state) {
+    const segments = state.routes.map(r => r.name);
+    return segments.join('/');
+}
+
+/**
+ * React Navigation 기반 앱의 화면 전환 로그를 자동으로 추적하는 래퍼 컴포넌트입니다.
+ * * @param {object} props
+ * @param {React.ReactNode} props.children - NavigationContainer 내부의 모든 내비게이터
+ * @param {(state: NavigationState | undefined) => void} [props.onStateChange] - 앱 개발자가 정의한 onStateChange 핸들러 (체인 연결)
+ */
+export function TagWorksNavigationContainer({ 
+    children, 
+    onReady,
+    onStateChange,              // <-- onReady, onStateChange prop 추가
+    excludedScreenNames = [],   // ✨ 기본값으로 빈 배열을 설정하고 prop으로 받습니다.
+    ...restProps                // ✨ 나머지 모든 prop을 받습니다. 
+}) {     
+    // 이전 화면 이름을 저장하기 위한 Ref
+    const routeNameRef = useRef(null);
+    // NavigationContainer의 Ref (navigation 객체 접근용)
+    const navigationRef = useRef(null);
+
+    // onReady 핸들러를 체인으로 연결하는 함수
+    const chainedHandleReady = useCallback(() => {
+        // 1. SDK의 내부 로직 실행
+        if (navigationRef.current) {
+            const initialRoute = navigationRef.current.getCurrentRoute();
+            routeNameRef.current = initialRoute ? initialRoute.name : null;
+            // SDK의 로그 전송 로직 실행
+            // 초기 화면이 제외 목록에 포함되지 않는 경우에만 로그 전송
+            if (routeNameRef.current && !excludedScreenNames.includes(routeNameRef.current)) {      // ✨ 제외 로직 추가
+                logEventPageView(routeNameRef.current, "", routeNameRef.current);
+            }
+            console.log(`[TagWorks SDK] NavigationContainer 준비 완료. 초기 화면: ${routeNameRef.current}`);
+        }
+
+        // 2. 외부에서 전달된 onReady prop이 있다면 실행
+        if (onReady) {
+            onReady();
+        }
+    }, [onReady]); // onReady prop이 변경될 때마다 함수가 재생성됩니다.
+
+    // SDK의 로그 로직과 외부 prop을 연결하는 체인 함수
+    const chainedHandleStateChange = useCallback((state) => {
+        
+        // 1. **널 체크:** navigationRef.current가 설정되지 않았으면 (초기화 전) 로직 중단
+        if (!navigationRef.current) {
+            if (onStateChange) {
+                onStateChange(state); // 외부 함수는 호출
+            }
+            return;
+        }
+
+        // 2. 현재 활성화된 화면 정보 가져오기 (React Navigation 내부 함수 활용)
+        const currentRoute = navigationRef.current.getCurrentRoute();
+        const currentRouteName = currentRoute ? currentRoute.name : null;
+        const previousRouteName = routeNameRef.current;
+
+        // 3. **로그 중복 방지 및 화면 전환 확인**
+        // 이전 화면 이름과 현재 화면 이름이 다를 때만 로그 전송
+        if (currentRouteName && previousRouteName !== currentRouteName) {
+            // ✨ 핵심: 현재 화면 이름이 제외 대상 목록에 포함되는지 확인
+            const shouldExclude = excludedScreenNames.includes(currentRouteName);
+
+            if (!shouldExclude) {       // 제외 대상이 아닐 경우에만 로그 전송
+                // SDK의 로그 전송 로직 실행
+                logEventPageView(currentRouteName, previousRouteName, buildPathFromStack(state));
+                console.log(`[TagWorks SDK] 로그 전송: ${previousRouteName} -> ${currentRouteName}`);
+            } else {
+                console.log(`[TagWorks SDK] 로그 제외 (Excluded Screen): ${currentRouteName}`);
+            }
+            
+            // 현재 화면 이름을 저장하여 다음 전환 시 이전 화면으로 사용
+            routeNameRef.current = currentRouteName;
+        }
+
+        // 4. **체이닝:** 외부에서 전달된 onStateChange prop이 있다면 실행
+        if (onStateChange) {
+            onStateChange(state);
+        }
+        
+    }, [onStateChange, excludedScreenNames]);   // onStateChange prop이 변경될 때마다 useCallback이 최신 함수를 참조하도록 합니다.
+                                                // excludedScreenNames도 의존성 배열에 추가합니다.
+
+    return (
+        <NavigationContainer
+            ref={navigationRef}
+            onReady={chainedHandleReady}              // <-- 체인된 함수를 전달합니다.
+            onStateChange={chainedHandleStateChange}
+            {...restProps}                            // ✨ 나머지 prop을 여기에 전달합니다.
+        >
+            {children}
+        </NavigationContainer>
+    );
+}

package/src/index.js

@@ -1,11 +1,28 @@
-// import { NativeModules, Platform } from 'react-native';
-import { NativeModules, requireNativeComponent } from 'react-native';
+import { NativeModules } from 'react-native';
 import TagWorksDeeplink from './TagWorksDeeplink';
+import OnCmsBannerView from './RegisterOnCmsBannerView';
+// import { attachBanner } from './OnCmsBannerCommands';
+import { TagWorksNavigationContainer } from './autoTrackers/ReactNavigationPageTracker';
 
-const OnCmsBannerView = requireNativeComponent('OnCmsBannerView');
+// NativeModules
+const {
+  TagWorksModule,
+  DataBundleModule,
+  StandardEventModule,
+  TagWorksPopupModule,
+  TagWorksDeeplinkModule,
+} = NativeModules;
 
-const { TagWorksModule, DataBundleModule, StandardEventModule, TagWorksPopupModule, TagWorksDeeplinkModule } = NativeModules;
-export { TagWorksModule, DataBundleModule, StandardEventModule, TagWorksPopupModule, TagWorksDeeplinkModule, OnCmsBannerView, TagWorksDeeplink };
+export { 
+  TagWorksModule, 
+  DataBundleModule, 
+  StandardEventModule, 
+  TagWorksPopupModule, 
+  TagWorksDeeplinkModule, 
+  TagWorksDeeplink,
+  OnCmsBannerView, 
+  TagWorksNavigationContainer,
+};
 
 
 
@@ -13,7 +30,7 @@ export { TagWorksModule, DataBundleModule, StandardEventModule, TagWorksPopupMod
 // const LINKING_ERROR =
 //   `The package 'tagworks-sdk-v1' doesn't seem to be linked. Make sure: \n\n` +
 //   Platform.select({ ios: "- You have run 'pod install'\n", default: '' }) +
-//   '- You rebuilt the app after installing the package\n' +
+//   '- You rebuilt the app after installing the package\n' +33        
 //   '- You are not using Expo Go\n';
 
 // const TagworksSdkV1 = NativeModules.TagworksSdkV1

package/tagworks-sdk-v1-react.podspec

@@ -12,11 +12,12 @@ Pod::Spec.new do |s|
   s.authors      = package["author"]
 
   s.platforms    = { :ios => min_ios_version_supported }
-  # s.source       = { :git => "http://192.168.20.44:8443/etc/mobile/sdk/tagworks-sdk-v1-react.git", :tag => "#{s.version}" }
+  s.source       = { :git => "http://192.168.20.44:8443/etc/mobile/sdk/tagworks-sdk-v1-react.git", :tag => "#{s.version}" }
 
   s.source_files = "ios/**/*.{h,m,mm,swift}"
   s.requires_arc = true
-  s.dependency "TagWorks-SDK-iOS", '~> 1.1.30'
+  s.dependency "TagWorks_SDK_iOS_v1", '~> 1.1.7'
+  #s.dependency "TagWorks-SDK-iOS", '~> 1.1.30'
   
 
   # XCFramework 배포

package/android/src/main/java/com/tagworkssdkv1/TagWorks.kt

@@ -1,37 +0,0 @@
-package com.tagworkssdkv1
-
-import android.content.Context
-import com.obzen.tagworks.TagWorks
-import com.obzen.tagworks.TagWorksConfig
-
-object TagWorks {
-
-  fun initializeTagWorks(
-    context: Context,  // ApplicationContext 사용
-    siteId: String,
-    baseUrl: String,
-    isUseIntervals: Boolean,
-    dispatchInterval: Long,
-    sessionTimeout: Long,
-    isManualDispatch: Boolean,
-    appVersion: String? = null,
-    appName: String? = null,
-    isUseDynamicParameter: Boolean,
-    deeplinkServerUrl: String
-  ) {
-    val config = TagWorksConfig.Builder()
-      .setSiteId(siteId)
-      .setBaseUrl(baseUrl)
-      .setDispatchInterval(dispatchInterval)
-      .setSessionTimeOut((sessionTimeout * 1000))
-      .setAppVersion(appVersion)
-      .setAppName(appName)
-      .setManualDispatch(isManualDispatch)
-      .setIsUseIntervals(isUseIntervals)
-      .setIsUseDynamicParameter(isUseDynamicParameter)
-      .setDeeplinkServerUrl(deeplinkServerUrl)
-      .build()
-    TagWorks.initializeSdk(context, config)  // ReactApplicationContext 필요 없음
-  }
-}
-

package/android/src/main/java/com/tagworkssdkv1/TagworksSdkV1Module.kt

@@ -1,25 +0,0 @@
-package com.tagworkssdkv1
-
-import com.facebook.react.bridge.ReactApplicationContext
-import com.facebook.react.bridge.ReactContextBaseJavaModule
-import com.facebook.react.bridge.ReactMethod
-import com.facebook.react.bridge.Promise
-
-class TagworksSdkV1Module(reactContext: ReactApplicationContext) :
-  ReactContextBaseJavaModule(reactContext) {
-
-  override fun getName(): String {
-    return NAME
-  }
-
-  // Example method
-  // See https://reactnative.dev/docs/native-modules-android
-  @ReactMethod
-  fun multiply(a: Double, b: Double, promise: Promise) {
-    promise.resolve(a * b)
-  }
-
-  companion object {
-    const val NAME = "TagworksSdkV1"
-  }
-}