@1selfworld/adchain-sdk-react-native 1.0.13 → 1.0.16

package/README.md

@@ -96,6 +96,33 @@ export default function App() {
 - `openAdjoeOfferwall(placementId?)` - ADJOE 오퍼월 열기
 - `openOfferwallNestAds(placementId)` - NestAds 오퍼월 열기
 
+### 임베디드 오퍼월 컴포넌트
+`AdchainOfferwallView`는 탭이나 화면에 직접 임베드할 수 있는 React Native 컴포넌트입니다.
+
+```typescript
+import { AdchainOfferwallView } from '@1selfworld/adchain-sdk-react-native';
+
+<AdchainOfferwallView
+  placementId="tab_embedded_offerwall"
+  style={{ flex: 1 }}
+  onOfferwallOpened={() => console.log('Opened')}
+  onOfferwallClosed={() => console.log('Closed')}
+  onBackPressOnFirstPage={() => {
+    // Android: WebView가 첫 페이지일 때 백버튼 처리
+    // 앱 종료, 다른 탭 이동 등의 로직 구현
+  }}
+  onBackNavigated={() => {
+    // Android: WebView 내부에서 뒤로가기 성공
+  }}
+/>
+```
+
+**백버튼 이벤트 (Android, v1.0.15+)**:
+- `onBackPressOnFirstPage`: WebView 스택에 페이지가 1개만 있을 때 (더 이상 뒤로갈 수 없음)
+- `onBackNavigated`: WebView 스택에서 성공적으로 뒤로 이동했을 때
+
+앱 개발자는 이 이벤트를 받아서 앱 종료, 탭 전환 등의 동작을 직접 구현할 수 있습니다.
+
 ### 퀴즈 & 미션
 - `loadQuizList(unitId)` - 퀴즈 목록 로드
 - `clickQuiz(unitId, quizId)` - 퀴즈 클릭
@@ -180,14 +207,16 @@ npx expo run:ios
 
 ### Pod install 실패 (iOS)
 - Git URL이 올바른지 확인
-- 태그 v1.0.42가 존재하는지 확인
+- 태그 v1.0.45가 존재하는지 확인
 - 시도: `cd ios && rm -rf Pods Podfile.lock && pod install`
 
 ## 버전 호환성
 
-| 패키지 버전 | Android SDK | iOS SDK | Swift | Expo SDK |
-|------------|-------------|---------|-------|----------|
-| 1.0.0      | v1.0.28     | v1.0.42 | 5.5   | 50-53    |
+| 패키지 버전 | Android SDK | iOS SDK | Swift | Expo SDK | 주요 변경사항 |
+|------------|-------------|---------|-------|----------|--------------|
+| 1.0.15     | v1.0.29     | v1.0.45 | 5.5   | 50-53    | 백버튼 이벤트, NestAds 지원 |
+| 1.0.13     | v1.0.28     | v1.0.45 | 5.5   | 50-53    | NestAds 오퍼월 추가 |
+| 1.0.0      | v1.0.28     | v1.0.45 | 5.5   | 50-53    | 초기 릴리즈 |
 
 ## 알려진 제한사항
 

package/android/build.gradle

@@ -35,5 +35,5 @@ dependencies {
   implementation 'com.facebook.react:react-native:+'
   implementation "org.jetbrains.kotlin:kotlin-stdlib:1.9.21"
   // AdChain Android SDK via JitPack
-  implementation 'com.github.1selfworld-labs:adchain-sdk-android:v1.0.28'
+  implementation 'com.github.1selfworld-labs:adchain-sdk-android:v1.0.29'
 }

package/android/src/main/java/com/adchain/exposdk/AdchainOfferwallViewManager.kt

@@ -58,6 +58,17 @@ class AdchainOfferwallViewManager : SimpleViewManager<AdchainOfferwallView>() {
                 Log.d(TAG, "handleBackPress command")
                 val handled = root.handleBackPress()
                 Log.d(TAG, "handleBackPress result: $handled")
+
+                // Send event to React Native based on result
+                if (!handled) {
+                    // WebView stack has only 1 item (first page)
+                    Log.d(TAG, "Sending onBackPressOnFirstPage event")
+                    sendEvent(root, "onBackPressOnFirstPage", Arguments.createMap())
+                } else {
+                    // WebView stack has 2+ items (navigated back)
+                    Log.d(TAG, "Sending onBackNavigated event")
+                    sendEvent(root, "onBackNavigated", Arguments.createMap())
+                }
             }
             "sendDataResponse" -> {  // NEW
                 val requestId = args?.getString(0) ?: ""
@@ -236,8 +247,10 @@ class AdchainOfferwallViewManager : SimpleViewManager<AdchainOfferwallView>() {
             "onOfferwallError" to mapOf("registrationName" to "onOfferwallError"),
             "onRewardEarned" to mapOf("registrationName" to "onRewardEarned"),
             "onHeightChange" to mapOf("registrationName" to "onHeightChange"),
-            "onCustomEvent" to mapOf("registrationName" to "onCustomEvent"),  // NEW
-            "onDataRequest" to mapOf("registrationName" to "onDataRequest")   // NEW
+            "onCustomEvent" to mapOf("registrationName" to "onCustomEvent"),
+            "onDataRequest" to mapOf("registrationName" to "onDataRequest"),
+            "onBackPressOnFirstPage" to mapOf("registrationName" to "onBackPressOnFirstPage"),
+            "onBackNavigated" to mapOf("registrationName" to "onBackNavigated")
         )
     }
 

package/lib/module/AdchainOfferwallView.js

@@ -53,7 +53,9 @@ export const AdchainOfferwallView = /*#__PURE__*/React.forwardRef(({
   onOfferwallError,
   onRewardEarned,
   onCustomEvent,
-  onDataRequest
+  onDataRequest,
+  onBackPressOnFirstPage,
+  onBackNavigated
 }, ref) => {
   const viewRef = useRef(null);
 
@@ -132,9 +134,11 @@ export const AdchainOfferwallView = /*#__PURE__*/React.forwardRef(({
     onOfferwallClosed: onOfferwallClosed,
     onOfferwallError: handleOfferwallError,
     onRewardEarned: handleRewardEarned,
-    onCustomEvent: handleCustomEvent // NEW
+    onCustomEvent: handleCustomEvent,
+    onDataRequest: handleDataRequest,
+    onBackPressOnFirstPage: onBackPressOnFirstPage // NEW (v1.0.42)
     ,
-    onDataRequest: handleDataRequest // NEW
+    onBackNavigated: onBackNavigated // NEW (v1.0.42)
   });
 });
 export default AdchainOfferwallView;

package/lib/module/AdchainOfferwallView.js.map

@@ -1 +1 @@
-{"version":3,"names":["React","useEffect","useRef","requireNativeComponent","UIManager","findNodeHandle","Platform","jsx","_jsx","NativeOfferwallView","AdchainOfferwallView","forwardRef","placementId","style","onOfferwallOpened","onOfferwallClosed","onOfferwallError","onRewardEarned","onCustomEvent","onDataRequest","ref","viewRef","useImperativeHandle","current","viewId","OS","dispatchViewManagerCommand","error","console","handleOfferwallError","event","nativeEvent","handleRewardEarned","amount","handleCustomEvent","eventType","payload","handleDataRequest","requestId","requestType","params","responseData","undefined"],"sourceRoot":"../../src","sources":["AdchainOfferwallView.tsx"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["React","useEffect","useRef","requireNativeComponent","UIManager","findNodeHandle","Platform","jsx","_jsx","NativeOfferwallView","AdchainOfferwallView","forwardRef","placementId","style","onOfferwallOpened","onOfferwallClosed","onOfferwallError","onRewardEarned","onCustomEvent","onDataRequest","onBackPressOnFirstPage","onBackNavigated","ref","viewRef","useImperativeHandle","current","viewId","OS","dispatchViewManagerCommand","error","console","handleOfferwallError","event","nativeEvent","handleRewardEarned","amount","handleCustomEvent","eventType","payload","handleDataRequest","requestId","requestType","params","responseData","undefined"],"sourceRoot":"../../src","sources":["AdchainOfferwallView.tsx"],"mappings":"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","ignoreList":[]}

package/lib/typescript/src/AdchainOfferwallView.d.ts

@@ -31,6 +31,18 @@ export interface AdchainOfferwallViewProps {
      * @since 1.0.41
      */
     onDataRequest?: (requestType: string, params: any) => any;
+    /**
+     * Callback when back button is pressed on the first page (WebView stack has only 1 item)
+     * This means the WebView cannot go back further, so the app should handle it (e.g., exit app or navigate to another tab)
+     * @since 1.0.45
+     */
+    onBackPressOnFirstPage?: () => void;
+    /**
+     * Callback when back button successfully navigated back in WebView (WebView stack has 2+ items)
+     * This means the WebView went back in its history
+     * @since 1.0.45
+     */
+    onBackNavigated?: () => void;
 }
 /**
  * AdChain Offerwall View Component

package/lib/typescript/src/AdchainOfferwallView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AdchainOfferwallView.d.ts","sourceRoot":"","sources":["../../../src/AdchainOfferwallView.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA4B,MAAM,OAAO,CAAC;AAOjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AA8C9C;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,8CAA8C;IAC9C,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB;IACjB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,wCAAwC;IACxC,iBAAiB,CAAC,EAAE,MAAM,IAAI,CAAC;IAC/B,wCAAwC;IACxC,iBAAiB,CAAC,EAAE,MAAM,IAAI,CAAC;IAC/B,oCAAoC;IACpC,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,wCAAwC;IACxC,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAI1C;;;;;OAKG;IACH,aAAa,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,KAAK,IAAI,CAAC;IAE1D;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,GAAG,CAAC;CAC3D;AAsBD;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,oBAAoB,uFAmHhC,CAAC;AAEF,eAAe,oBAAoB,CAAC"}
+{"version":3,"file":"AdchainOfferwallView.d.ts","sourceRoot":"","sources":["../../../src/AdchainOfferwallView.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA4B,MAAM,OAAO,CAAC;AAOjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AA8C9C;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,8CAA8C;IAC9C,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB;IACjB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,wCAAwC;IACxC,iBAAiB,CAAC,EAAE,MAAM,IAAI,CAAC;IAC/B,wCAAwC;IACxC,iBAAiB,CAAC,EAAE,MAAM,IAAI,CAAC;IAC/B,oCAAoC;IACpC,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,wCAAwC;IACxC,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAI1C;;;;;OAKG;IACH,aAAa,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,KAAK,IAAI,CAAC;IAE1D;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,GAAG,CAAC;IAI1D;;;;OAIG;IACH,sBAAsB,CAAC,EAAE,MAAM,IAAI,CAAC;IAEpC;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,IAAI,CAAC;CAC9B;AAwBD;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,oBAAoB,uFAuHhC,CAAC;AAEF,eAAe,oBAAoB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@1selfworld/adchain-sdk-react-native",
-  "version": "1.0.13",
+  "version": "1.0.16",
   "description": "AdChain SDK for React Native with Expo support",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",

package/plugin/src/withAdchainIOS.js

@@ -28,10 +28,10 @@ function withAdchainIOS(config) {
       if (targetMatch) {
         const targetName = targetMatch[1];
         const podDeclaration = `
-  # AdChain SDK (Git Pod) - v1.0.42
+  # AdChain SDK (Git Pod) - v1.0.45
   # CocoaPods Trunk에 없으므로 Git 방식 사용
   # Swift 5.5 (5.9 optional 파라미터 버그 회피)
-  pod 'AdChainSDK', :git => 'https://github.com/1selfworld-labs/adchain-sdk-ios-release.git', :tag => 'v1.0.42'
+  pod 'AdChainSDK', :git => 'https://github.com/1selfworld-labs/adchain-sdk-ios-release.git', :tag => 'v1.0.45'
 `;
 
         podfile = podfile.replace(
@@ -41,8 +41,8 @@ function withAdchainIOS(config) {
       } else {
         // Fallback
         const podDeclaration = `
-  # AdChain SDK (Git Pod) - v1.0.42
-  pod 'AdChainSDK', :git => 'https://github.com/1selfworld-labs/adchain-sdk-ios-release.git', :tag => 'v1.0.42'
+  # AdChain SDK (Git Pod) - v1.0.45
+  pod 'AdChainSDK', :git => 'https://github.com/1selfworld-labs/adchain-sdk-ios-release.git', :tag => 'v1.0.45'
 `;
 
         podfile = podfile.replace(

package/src/AdchainOfferwallView.tsx

@@ -86,6 +86,22 @@ export interface AdchainOfferwallViewProps {
    * @since 1.0.41
    */
   onDataRequest?: (requestType: string, params: any) => any;
+
+  // ===== NEW: Back Button Handling (v1.0.45+) =====
+
+  /**
+   * Callback when back button is pressed on the first page (WebView stack has only 1 item)
+   * This means the WebView cannot go back further, so the app should handle it (e.g., exit app or navigate to another tab)
+   * @since 1.0.45
+   */
+  onBackPressOnFirstPage?: () => void;
+
+  /**
+   * Callback when back button successfully navigated back in WebView (WebView stack has 2+ items)
+   * This means the WebView went back in its history
+   * @since 1.0.45
+   */
+  onBackNavigated?: () => void;
 }
 
 /**
@@ -99,8 +115,10 @@ interface NativeOfferwallViewProps {
   onOfferwallError?: (event: OfferwallErrorEvent) => void;
   onRewardEarned?: (event: OfferwallRewardEvent) => void;
   onHeightChange?: (event: OfferwallHeightChangeEvent) => void;
-  onCustomEvent?: (event: OfferwallCustomEvent) => void; // NEW
-  onDataRequest?: (event: OfferwallDataRequestEvent) => void; // NEW
+  onCustomEvent?: (event: OfferwallCustomEvent) => void;
+  onDataRequest?: (event: OfferwallDataRequestEvent) => void;
+  onBackPressOnFirstPage?: () => void; // NEW (v1.0.45)
+  onBackNavigated?: () => void; // NEW (v1.0.45)
 }
 
 // Require native component
@@ -139,6 +157,8 @@ export const AdchainOfferwallView = React.forwardRef<
       onRewardEarned,
       onCustomEvent,
       onDataRequest,
+      onBackPressOnFirstPage,
+      onBackNavigated,
     },
     ref
   ) => {
@@ -235,8 +255,10 @@ export const AdchainOfferwallView = React.forwardRef<
         onOfferwallClosed={onOfferwallClosed}
         onOfferwallError={handleOfferwallError}
         onRewardEarned={handleRewardEarned}
-        onCustomEvent={handleCustomEvent} // NEW
-        onDataRequest={handleDataRequest} // NEW
+        onCustomEvent={handleCustomEvent}
+        onDataRequest={handleDataRequest}
+        onBackPressOnFirstPage={onBackPressOnFirstPage} // NEW (v1.0.42)
+        onBackNavigated={onBackNavigated} // NEW (v1.0.42)
       />
     );
   }