@1selfworld/adchain-sdk-react-native 1.0.15 → 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/lib/typescript/src/AdchainOfferwallView.d.ts

@@ -34,13 +34,13 @@ export interface AdchainOfferwallViewProps {
     /**
      * 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.42
+     * @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.42
+     * @since 1.0.45
      */
     onBackNavigated?: () => void;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@1selfworld/adchain-sdk-react-native",
-  "version": "1.0.15",
+  "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

@@ -87,19 +87,19 @@ export interface AdchainOfferwallViewProps {
    */
   onDataRequest?: (requestType: string, params: any) => any;
 
-  // ===== NEW: Back Button Handling (v1.0.42+) =====
+  // ===== 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.42
+   * @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.42
+   * @since 1.0.45
    */
   onBackNavigated?: () => void;
 }
@@ -117,8 +117,8 @@ interface NativeOfferwallViewProps {
   onHeightChange?: (event: OfferwallHeightChangeEvent) => void;
   onCustomEvent?: (event: OfferwallCustomEvent) => void;
   onDataRequest?: (event: OfferwallDataRequestEvent) => void;
-  onBackPressOnFirstPage?: () => void; // NEW (v1.0.42)
-  onBackNavigated?: () => void; // NEW (v1.0.42)
+  onBackPressOnFirstPage?: () => void; // NEW (v1.0.45)
+  onBackNavigated?: () => void; // NEW (v1.0.45)
 }
 
 // Require native component