@adstage/react-native-sdk 1.0.0

package/android/src/main/java/io/nbase/adstage/reactnative/AdStagePackage.kt

@@ -0,0 +1,24 @@
+package io.nbase.adstage.reactnative
+
+import com.facebook.react.ReactPackage
+import com.facebook.react.bridge.NativeModule
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.uimanager.ViewManager
+
+/**
+ * AdStage React Native 패키지
+ * 
+ * MainApplication.kt의 getPackages()에서 등록합니다.
+ * 
+ * @since 3.0.0
+ */
+class AdStagePackage : ReactPackage {
+    
+    override fun createNativeModules(reactContext: ReactApplicationContext): List<NativeModule> {
+        return listOf(AdStageModule(reactContext))
+    }
+    
+    override fun createViewManagers(reactContext: ReactApplicationContext): List<ViewManager<*, *>> {
+        return emptyList()
+    }
+}

package/ios/AdStageModule.m

@@ -0,0 +1,70 @@
+//
+//  AdStageModule.m
+//  adstage-react-native
+//
+//  Objective-C 브릿지 헤더
+//
+//  Created by NBase on 2025.
+//
+
+#import <React/RCTBridgeModule.h>
+#import <React/RCTEventEmitter.h>
+
+@interface RCT_EXTERN_MODULE(AdStageModule, RCTEventEmitter)
+
+// Initialization
+RCT_EXTERN_METHOD(initialize:(NSString *)apiKey
+                  serverUrl:(NSString *)serverUrl
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(getVersion:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+// User Attributes
+RCT_EXTERN_METHOD(setUserAttributes:(NSDictionary *)attributes
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(getUserAttributes:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(clearUserAttributes:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+// DeepLink
+RCT_EXTERN_METHOD(setDeepLinkListener)
+
+RCT_EXTERN_METHOD(removeDeepLinkListener)
+
+RCT_EXTERN_METHOD(createDeepLink:(NSDictionary *)request
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(checkPendingDeepLink)
+
+// Promotion
+RCT_EXTERN_METHOD(getPromotionList:(NSDictionary *)params
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(handlePromotionClick:(NSDictionary *)promotionMap
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+// Event Tracking
+RCT_EXTERN_METHOD(trackEvent:(NSString *)eventName
+                  params:(NSDictionary *)params
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+// Required for RN Event Emitter
+RCT_EXTERN_METHOD(addListener:(NSString *)eventName)
+RCT_EXTERN_METHOD(removeListeners:(double)count)
+
++ (BOOL)requiresMainQueueSetup
+{
+    return YES;
+}
+
+@end

package/ios/AdStageModule.swift

@@ -0,0 +1,457 @@
+//
+//  AdStageModule.swift
+//  adstage-react-native
+//
+//  AdStage React Native 네이티브 모듈 (iOS)
+//
+//  Created by NBase on 2025.
+//  Copyright © 2025 NBase. All rights reserved.
+//
+
+import Foundation
+import React
+import AdapterAdStage
+
+@objc(AdStageModule)
+class AdStageModule: RCTEventEmitter {
+    
+    // MARK: - Constants
+    
+    private static let TAG = "AdStageModule"
+    
+    // MARK: - Properties
+    
+    private var hasListeners = false
+    
+    // MARK: - RCTEventEmitter
+    
+    override static func moduleName() -> String! {
+        return "AdStageModule"
+    }
+    
+    override static func requiresMainQueueSetup() -> Bool {
+        return true
+    }
+    
+    override func supportedEvents() -> [String]! {
+        return ["onDeepLinkReceived"]
+    }
+    
+    override func startObserving() {
+        hasListeners = true
+    }
+    
+    override func stopObserving() {
+        hasListeners = false
+    }
+    
+    // MARK: - Initialization
+    
+    @objc
+    func initialize(_ apiKey: String,
+                   serverUrl: String,
+                   resolver resolve: @escaping RCTPromiseResolveBlock,
+                   rejecter reject: @escaping RCTPromiseRejectBlock) {
+        
+        NSLog("[\(Self.TAG)] Initializing AdStage SDK...")
+        
+        DispatchQueue.main.async {
+            // serverUrl이 빈 문자열이면 apiKey만으로 초기화 (네이티브 SDK 기본값 사용)
+            if serverUrl.isEmpty {
+                AdStageManager.shared.initialize(apiKey: apiKey)
+            } else {
+                AdStageManager.shared.initialize(apiKey: apiKey, serverUrl: serverUrl)
+            }
+            
+            NSLog("[\(Self.TAG)] AdStage SDK initialized successfully")
+            resolve(true)
+        }
+    }
+    
+    @objc
+    func getVersion(_ resolve: @escaping RCTPromiseResolveBlock,
+                   rejecter reject: @escaping RCTPromiseRejectBlock) {
+        resolve("3.0.0")
+    }
+    
+    // MARK: - User Attributes
+    
+    @objc
+    func setUserAttributes(_ attributes: NSDictionary,
+                          resolver resolve: @escaping RCTPromiseResolveBlock,
+                          rejecter reject: @escaping RCTPromiseRejectBlock) {
+        
+        let userAttrs = UserAttributes(
+            gender: attributes["gender"] as? String,
+            country: attributes["country"] as? String,
+            city: attributes["city"] as? String,
+            age: attributes["age"] as? String,
+            language: attributes["language"] as? String
+        )
+        
+        AdStageManager.shared.setUserAttributes(userAttrs)
+        resolve(true)
+    }
+    
+    @objc
+    func getUserAttributes(_ resolve: @escaping RCTPromiseResolveBlock,
+                          rejecter reject: @escaping RCTPromiseRejectBlock) {
+        if let attrs = AdStageManager.shared.getUserAttributes() {
+            let dict: [String: Any?] = [
+                "gender": attrs.gender,
+                "country": attrs.country,
+                "city": attrs.city,
+                "age": attrs.age,
+                "language": attrs.language
+            ]
+            resolve(dict.compactMapValues { $0 })
+        } else {
+            resolve(nil)
+        }
+    }
+    
+    @objc
+    func clearUserAttributes(_ resolve: @escaping RCTPromiseResolveBlock,
+                            rejecter reject: @escaping RCTPromiseRejectBlock) {
+        // SDK에서는 nil로 설정하여 초기화
+        AdStageManager.shared.setUserAttributes(UserAttributes())
+        resolve(true)
+    }
+    
+    // MARK: - DeepLink
+    
+    @objc
+    func setDeepLinkListener() {
+        NSLog("[\(Self.TAG)] Setting deep link listener")
+        
+        AdStageManager.shared.setDeepLinkListener { [weak self] data in
+            guard let self = self, self.hasListeners else { return }
+            
+            NSLog("[\(Self.TAG)] Deep link received: \(data.shortPath)")
+            
+            let params: [String: Any] = [
+                "linkId": data.linkId,
+                "shortPath": data.shortPath,
+                "source": data.source.description,
+                "eventType": data.eventType,
+                "parameters": data.parameters
+            ]
+            
+            self.sendEvent(withName: "onDeepLinkReceived", body: params)
+        }
+    }
+    
+    @objc
+    func removeDeepLinkListener() {
+        // AdStageManager에서 리스너 제거 기능 호출
+        NSLog("[\(Self.TAG)] Removing deep link listener")
+    }
+    
+    @objc
+    func createDeepLink(_ request: NSDictionary,
+                       resolver resolve: @escaping RCTPromiseResolveBlock,
+                       rejecter reject: @escaping RCTPromiseRejectBlock) {
+        
+        guard let name = request["name"] as? String else {
+            reject("INVALID_PARAMS", "name is required", nil)
+            return
+        }
+        
+        let builder = AdStageManager.shared.createDeepLinkBuilder()
+        builder.setName(name)
+        
+        if let description = request["description"] as? String {
+            builder.setDescription(description)
+        }
+        if let channel = request["channel"] as? String {
+            builder.setChannel(channel)
+        }
+        if let subChannel = request["subChannel"] as? String {
+            builder.setSubChannel(subChannel)
+        }
+        if let campaign = request["campaign"] as? String {
+            builder.setCampaign(campaign)
+        }
+        if let adGroup = request["adGroup"] as? String {
+            builder.setAdGroup(adGroup)
+        }
+        if let creative = request["creative"] as? String {
+            builder.setCreative(creative)
+        }
+        if let keyword = request["keyword"] as? String {
+            builder.setKeyword(keyword)
+        }
+        
+        // Redirect Config
+        if let redirectConfig = request["redirectConfig"] as? [String: Any] {
+            if let android = redirectConfig["android"] as? [String: String] {
+                builder.setAndroidConfig(
+                    packageName: android["packageName"] ?? "",
+                    appScheme: android["appScheme"] ?? "",
+                    webUrl: android["webUrl"] ?? ""
+                )
+            }
+            if let ios = redirectConfig["ios"] as? [String: String] {
+                builder.setIosConfig(
+                    appStoreId: ios["appStoreId"] ?? "",
+                    appScheme: ios["appScheme"] ?? "",
+                    webUrl: ios["webUrl"] ?? ""
+                )
+            }
+        }
+        
+        // Parameters
+        if let parameters = request["parameters"] as? [String: String] {
+            parameters.forEach { key, value in
+                builder.addParameter(key: key, value: value)
+            }
+        }
+        
+        builder.create { info, error in
+            if let error = error {
+                reject("CREATE_DEEPLINK_ERROR", error.localizedDescription, error)
+                return
+            }
+            
+            guard let info = info else {
+                reject("CREATE_DEEPLINK_ERROR", "Failed to create deep link", nil)
+                return
+            }
+            
+            let dict: [String: Any] = [
+                "shortUrl": info.shortUrl ?? "",
+                "shortPath": info.shortPath ?? "",
+                "linkId": info.linkId ?? ""
+            ]
+            resolve(dict)
+        }
+    }
+    
+    @objc
+    func checkPendingDeepLink() {
+        // iOS에서는 리스너 설정 시 자동으로 pending 딥링크 전달됨
+        NSLog("[\(Self.TAG)] checkPendingDeepLink called")
+    }
+    
+    // MARK: - Promotion
+    
+    @objc
+    func getPromotionList(_ params: NSDictionary,
+                         resolver resolve: @escaping RCTPromiseResolveBlock,
+                         rejecter reject: @escaping RCTPromiseRejectBlock) {
+        
+        let listParams = PromotionListParams()
+        listParams.bannerType = params["bannerType"] as? String
+        listParams.targetAudience = params["targetAudience"] as? String
+        listParams.deviceType = params["deviceType"] as? String
+        listParams.region = params["region"] as? String
+        if let limit = params["limit"] as? Int {
+            listParams.limit = limit
+        }
+        listParams.status = params["status"] as? String
+        listParams.partner = params["partner"] as? String
+        listParams.primaryInterest = params["primaryInterest"] as? String
+        listParams.primaryAgeGroup = params["primaryAgeGroup"] as? String
+        listParams.gameGenrePreference = params["gameGenrePreference"] as? String
+        listParams.playerSpendingTier = params["playerSpendingTier"] as? String
+        listParams.playTimePattern = params["playTimePattern"] as? String
+        
+        AdStageManager.shared.getPromotionList(params: listParams) { promotions, error in
+            if let error = error {
+                reject("GET_PROMOTION_ERROR", error.localizedDescription, error)
+                return
+            }
+            
+            guard let promotions = promotions else {
+                let dict: [String: Any] = [
+                    "totalItems": 0,
+                    "promotions": []
+                ]
+                resolve(dict)
+                return
+            }
+            
+            let promotionDicts = promotions.map { promo -> [String: Any] in
+                return self.promotionToDict(promo)
+            }
+            
+            let dict: [String: Any] = [
+                "totalItems": promotions.count,
+                "promotions": promotionDicts
+            ]
+            resolve(dict)
+        }
+    }
+    
+    @objc
+    func handlePromotionClick(_ promotionMap: NSDictionary,
+                             resolver resolve: @escaping RCTPromiseResolveBlock,
+                             rejecter reject: @escaping RCTPromiseRejectBlock) {
+        
+        guard let promotion = dictToPromotion(promotionMap) else {
+            reject("INVALID_PARAMS", "Invalid promotion data", nil)
+            return
+        }
+        
+        // openPromotionStore 사용 - 동기적으로 스토어 열기
+        AdStageManager.shared.openPromotionStore(promotion)
+        
+        let dict: [String: Any] = [
+            "success": true,
+            "storeUrl": promotion.storeUrls?.ios ?? ""
+        ]
+        resolve(dict)
+    }
+    
+    // MARK: - Event Tracking
+    
+    @objc
+    func trackEvent(_ eventName: String,
+                   params: NSDictionary?,
+                   resolver resolve: @escaping RCTPromiseResolveBlock,
+                   rejecter reject: @escaping RCTPromiseRejectBlock) {
+        
+        let eventParams = params as? [String: Any] ?? [:]
+        
+        // 이벤트 파라미터 빌더 사용
+        var paramsBuilder = TrackEventParams.builder(eventName)
+        
+        // Unity와 동일하게 전체 params Dictionary를 한번에 전달
+        // 이렇게 하면 Array, Number, Boolean 등 모든 타입이 보존됨
+        let convertedParams = convertReactNativeParams(eventParams)
+        paramsBuilder = paramsBuilder.params(convertedParams)
+        
+        let trackParams = paramsBuilder.build()
+        
+        AdStageManager.shared.trackEvent(trackParams) { success, error in
+            if success {
+                let dict: [String: Any] = [
+                    "success": true
+                ]
+                resolve(dict)
+            } else if let error = error {
+                reject("TRACK_EVENT_ERROR", error.localizedDescription, error)
+            } else {
+                reject("TRACK_EVENT_ERROR", "Unknown error", nil)
+            }
+        }
+    }
+    
+    /// React Native에서 전달된 파라미터를 네이티브 타입으로 변환
+    /// - 배열 (items) 처리
+    /// - 중첩 Dictionary 처리  
+    /// - Number/Boolean 타입 보존
+    private func convertReactNativeParams(_ params: [String: Any]) -> [String: Any] {
+        var result: [String: Any] = [:]
+        
+        for (key, value) in params {
+            if let arrayValue = value as? [Any] {
+                // 배열 (items 등) 처리 - 각 요소도 재귀적으로 변환
+                result[key] = arrayValue.map { element -> Any in
+                    if let dictElement = element as? [String: Any] {
+                        return convertReactNativeParams(dictElement)
+                    }
+                    return element
+                }
+            } else if let dictValue = value as? [String: Any] {
+                // 중첩 Dictionary 처리
+                result[key] = convertReactNativeParams(dictValue)
+            } else {
+                // 기본 타입 (String, Number, Boolean) - 그대로 전달
+                result[key] = value
+            }
+        }
+        
+        return result
+    }
+    
+    // MARK: - Required for RN Event Emitter
+    
+    @objc
+    override func addListener(_ eventName: String) {
+        super.addListener(eventName)
+    }
+    
+    @objc
+    override func removeListeners(_ count: Double) {
+        super.removeListeners(count)
+    }
+    
+    // MARK: - Helpers
+    
+    private func promotionToDict(_ promo: Promotion) -> [String: Any] {
+        var dict: [String: Any] = [
+            "id": promo.id,
+            "partner": promo.partner,
+            "appName": promo.appName,
+            "bannerUrl": promo.bannerUrl,
+            "bannerType": promo.bannerType,
+            "appDescription": promo.appDescription
+        ]
+        
+        // DeepLink
+        dict["deeplink"] = [
+            "id": promo.deeplink.id,
+            "name": promo.deeplink.name,
+            "description": promo.deeplink.linkDescription ?? "",
+            "shortPath": promo.deeplink.shortPath,
+            "linkType": promo.deeplink.linkType ?? "",
+            "channel": promo.deeplink.channel ?? "",
+            "subChannel": promo.deeplink.subChannel ?? "",
+            "campaign": promo.deeplink.campaign ?? "",
+            "status": promo.deeplink.status ?? ""
+        ]
+        
+        // Store URLs
+        if let storeUrls = promo.storeUrls {
+            dict["storeUrls"] = [
+                "android": storeUrls.android ?? "",
+                "ios": storeUrls.ios ?? ""
+            ]
+        }
+        
+        return dict
+    }
+    
+    private func dictToPromotion(_ dict: NSDictionary) -> Promotion? {
+        guard let id = dict["id"] as? String,
+              let deeplinkDict = dict["deeplink"] as? [String: Any] else {
+            return nil
+        }
+        
+        let deeplink = PromotionDeepLink(
+            id: deeplinkDict["id"] as? String ?? "",
+            name: deeplinkDict["name"] as? String ?? "",
+            linkDescription: deeplinkDict["description"] as? String ?? "",
+            shortPath: deeplinkDict["shortPath"] as? String ?? "",
+            linkType: deeplinkDict["linkType"] as? String ?? "",
+            channel: deeplinkDict["channel"] as? String ?? "",
+            subChannel: deeplinkDict["subChannel"] as? String ?? "",
+            campaign: deeplinkDict["campaign"] as? String ?? "",
+            content: deeplinkDict["content"] as? String ?? "",
+            keyword: deeplinkDict["keyword"] as? String ?? "",
+            redirectConfig: nil,
+            status: deeplinkDict["status"] as? String ?? "",
+            parameters: nil
+        )
+        
+        var storeUrls: StoreUrls? = nil
+        if let storeUrlsDict = dict["storeUrls"] as? [String: String] {
+            storeUrls = StoreUrls(
+                android: storeUrlsDict["android"] ?? "",
+                ios: storeUrlsDict["ios"] ?? ""
+            )
+        }
+        
+        return Promotion(
+            id: id,
+            partner: dict["partner"] as? String ?? "",
+            appName: dict["appName"] as? String ?? "",
+            bannerUrl: dict["bannerUrl"] as? String ?? "",
+            bannerType: dict["bannerType"] as? String ?? "",
+            appDescription: dict["appDescription"] as? String ?? "",
+            deeplink: deeplink,
+            storeUrls: storeUrls
+        )
+    }
+}