adwhale-sdk-react-native 2.7.100

package/package.json

@@ -0,0 +1,168 @@
+{
+  "name": "adwhale-sdk-react-native",
+  "version": "2.7.100",
+  "description": "Adwhale SDK React Native library for integrating Adwhale advertising mediation SDK into React Native applications.",
+  "main": "./lib/module/index.js",
+  "react-native": "./lib/module/index.js",
+  "types": "./lib/typescript/src/index.d.ts",
+  "exports": {
+    ".": {
+      "react-native": "./lib/module/index.js",
+      "types": "./lib/typescript/src/index.d.ts",
+      "source": "./src/index.ts",
+      "default": "./lib/module/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "src",
+    "lib",
+    "android",
+    "ios",
+    "cpp",
+    "*.podspec",
+    "react-native.config.js",
+    "plugin",
+    "app.plugin.js",
+    "!ios/build",
+    "!android/build",
+    "!android/gradle",
+    "!android/gradlew",
+    "!android/gradlew.bat",
+    "!android/local.properties",
+    "!**/__tests__",
+    "!**/__fixtures__",
+    "!**/__mocks__",
+    "!**/.*"
+  ],
+  "scripts": {
+    "example": "yarn workspace adwhale-sdk-react-native-example",
+    "clean": "del-cli android/build example/android/build example/android/app/build example/ios/build lib",
+    "prepare": "bob build",
+    "typecheck": "tsc",
+    "lint": "eslint \"**/*.{js,ts,tsx}\"",
+    "release": "release-it --only-version",
+    "test": "jest"
+  },
+  "keywords": [
+    "react-native",
+    "ios",
+    "android",
+    "adwhale",
+    "ads",
+    "mediation"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dev-adwhale/adwhale-sdk-react-native.git"
+  },
+  "author": "adwhale_sdk <adwhale_sdk@fsn.co.kr> (https://github.com/dev-adwhale)",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/dev-adwhale/adwhale-sdk-react-native/issues"
+  },
+  "homepage": "https://github.com/dev-adwhale/adwhale-sdk-react-native#readme",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "devDependencies": {
+    "@eslint/compat": "^1.3.2",
+    "@eslint/eslintrc": "^3.3.1",
+    "@eslint/js": "^9.35.0",
+    "@react-native-community/cli": "20.0.1",
+    "@react-native/babel-preset": "0.81.1",
+    "@react-native/eslint-config": "^0.81.1",
+    "@release-it/conventional-changelog": "^10.0.1",
+    "@types/jest": "^29.5.14",
+    "@types/react": "^19.1.0",
+    "del-cli": "^6.0.0",
+    "eslint": "^9.35.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.4",
+    "jest": "^29.7.0",
+    "prettier": "^2.8.8",
+    "react": "19.1.0",
+    "react-native": "0.81.1",
+    "react-native-builder-bob": "^0.40.16",
+    "release-it": "^19.0.4",
+    "turbo": "^2.5.6",
+    "typescript": "^5.9.2"
+  },
+  "peerDependencies": {
+    "react": "*",
+    "react-native": "*"
+  },
+  "workspaces": [
+    "example"
+  ],
+  "packageManager": "yarn@4.11.0",
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      [
+        "module",
+        {
+          "esm": true
+        }
+      ],
+      [
+        "typescript",
+        {
+          "project": "tsconfig.build.json"
+        }
+      ]
+    ]
+  },
+  "codegenConfig": {
+    "name": "AdwhaleSdkReactNativeSpec",
+    "type": "modules",
+    "jsSrcsDir": "src",
+    "android": {
+      "javaPackageName": "com.adwhalesdkreactnative"
+    }
+  },
+  "prettier": {
+    "quoteProps": "consistent",
+    "singleQuote": true,
+    "tabWidth": 2,
+    "trailingComma": "es5",
+    "useTabs": false
+  },
+  "release-it": {
+    "git": {
+      "commitMessage": "chore: release ${version}",
+      "tagName": "v${version}"
+    },
+    "npm": {
+      "publish": true
+    },
+    "github": {
+      "release": true
+    },
+    "plugins": {
+      "@release-it/conventional-changelog": {
+        "preset": {
+          "name": "angular"
+        }
+      }
+    }
+  },
+  "jest": {
+    "preset": "react-native",
+    "modulePathIgnorePatterns": [
+      "<rootDir>/example/node_modules",
+      "<rootDir>/lib/"
+    ]
+  },
+  "create-react-native-library": {
+    "languages": "kotlin-objc",
+    "type": "turbo-module",
+    "tools": [
+      "eslint",
+      "release-it",
+      "jest"
+    ],
+    "version": "0.55.1"
+  }
+}

package/plugin/index.js

@@ -0,0 +1,16 @@
+// plugin/index.js
+const { createRunOncePlugin } = require('@expo/config-plugins');
+const pkg = require('../package.json');
+
+// Expo config plugin (no-op)
+// - Expo prebuild 시 호출되지만, 실제로는 config를 그대로 반환만 함.
+const withAdwhaleSdkReactNative = (config, props = {}) => {
+  // 나중에 필요해지면 여기서 AndroidManifest / build.gradle 수정 로직만 추가하면 됨.
+  return config;
+};
+
+module.exports = createRunOncePlugin(
+  withAdwhaleSdkReactNative,
+  pkg.name,
+  pkg.version
+);

package/react-native.config.js

@@ -0,0 +1,30 @@
+const path = require('path');
+
+module.exports = {
+  dependencies: {
+    'adwhale-sdk-react-native': {
+      root: path.resolve(__dirname),
+      platforms: {
+        android: {
+          sourceDir: path.join(__dirname, 'android'),
+        },
+        ios: {
+          // iOS는 나중에 구현할 예정이라면 비워둬도 됨
+          // podspec이 있으므로 autolinking은 자동됨
+        },
+      },
+    },
+  },
+
+  // TurboModule codegen 위치 지정
+  project: {
+    android: {
+      // Optional—없어도 되지만 넣어두면 안전함
+    },
+    ios: {
+      // Optional
+    },
+  },
+
+  assets: [],
+};

package/src/AdWhaleBannerView.tsx

@@ -0,0 +1,53 @@
+// src/AdWhaleBannerView.tsx
+import React from 'react';
+import { requireNativeComponent } from 'react-native';
+import type { NativeSyntheticEvent, StyleProp, ViewStyle } from 'react-native';
+
+export type AdWhaleBannerSize =
+  | '320x50'
+  | '320x100'
+  | '300x250'
+  | '250x250'
+  | 'ADAPTIVE_ANCHOR';
+
+export interface AdWhaleBannerError {
+  statusCode: number;
+  message: string;
+}
+
+export interface AdWhaleBannerViewProps {
+  style?: StyleProp<ViewStyle>;
+  placementUid: string;
+  adSize: AdWhaleBannerSize;
+  loadAd?: boolean;
+
+  onAdLoaded?: () => void;
+  onAdLoadFailed?: (event: AdWhaleBannerError) => void;
+  onAdClicked?: () => void;
+}
+
+type NativeErrorEvent = NativeSyntheticEvent<AdWhaleBannerError>;
+
+interface NativeAdViewProps
+  extends Omit<AdWhaleBannerViewProps, 'onAdLoadFailed'> {
+  onAdLoadFailed?: (e: NativeErrorEvent) => void;
+}
+
+const RNAdWhaleMediationAdView =
+  requireNativeComponent<NativeAdViewProps>('RNAdWhaleMediationAdView');
+
+export const AdWhaleBannerView: React.FC<AdWhaleBannerViewProps> = ({
+  onAdLoadFailed,
+  ...restProps
+}) => {
+  const handleAdLoadFailed: NativeAdViewProps['onAdLoadFailed'] = e => {
+    onAdLoadFailed?.(e.nativeEvent);
+  };
+
+  return (
+    <RNAdWhaleMediationAdView
+      {...restProps}
+      onAdLoadFailed={onAdLoadFailed ? handleAdLoadFailed : undefined}
+    />
+  );
+};

package/src/AdWhaleInterstitialAd.ts

@@ -0,0 +1,93 @@
+// src/AdWhaleInterstitialAd.ts
+import { NativeEventEmitter, NativeModules } from 'react-native';
+import type { EmitterSubscription } from 'react-native';
+
+export interface AdWhaleInterstitialErrorEvent {
+  statusCode: number;
+  message: string;
+}
+
+export interface AdWhaleInterstitialEvents {
+  onLoaded?: () => void;
+  onLoadFailed?: (event: AdWhaleInterstitialErrorEvent) => void;
+  onShowed?: () => void;
+  onShowFailed?: (event: AdWhaleInterstitialErrorEvent) => void;
+  onClosed?: () => void;
+  onClicked?: () => void;
+}
+
+interface RNAdWhaleMediationInterstitialAdNativeModule {
+  loadAd(placementUid: string): void;
+  showAd(): void;
+  addListener(eventName: string): void;
+  removeListeners(count: number): void;
+}
+
+const { RNAdWhaleMediationInterstitialAd } = NativeModules as {
+  RNAdWhaleMediationInterstitialAd: RNAdWhaleMediationInterstitialAdNativeModule;
+};
+
+const interstitialEmitter = new NativeEventEmitter(
+  RNAdWhaleMediationInterstitialAd,
+);
+
+export const AdWhaleInterstitialAd = {
+  loadAd(placementUid: string) {
+    RNAdWhaleMediationInterstitialAd.loadAd(placementUid);
+  },
+
+  showAd() {
+    RNAdWhaleMediationInterstitialAd.showAd();
+  },
+
+  addEventListeners(listeners: AdWhaleInterstitialEvents): EmitterSubscription[] {
+    const subs: EmitterSubscription[] = [];
+
+    if (listeners.onLoaded) {
+      subs.push(
+        interstitialEmitter.addListener('onInterstitialAdLoaded', () => {
+          listeners.onLoaded?.();
+        }),
+      );
+    }
+    if (listeners.onLoadFailed) {
+      subs.push(
+        interstitialEmitter.addListener(
+          'onInterstitialAdLoadFailed',
+          event => listeners.onLoadFailed?.(event as AdWhaleInterstitialErrorEvent),
+        ),
+      );
+    }
+    if (listeners.onShowed) {
+      subs.push(
+        interstitialEmitter.addListener('onInterstitialAdShowed', () => {
+          listeners.onShowed?.();
+        }),
+      );
+    }
+    if (listeners.onShowFailed) {
+      subs.push(
+        interstitialEmitter.addListener(
+          'onInterstitialAdShowFailed',
+          event => listeners.onShowFailed?.(event as AdWhaleInterstitialErrorEvent),
+        ),
+      );
+    }
+    if (listeners.onClosed) {
+      subs.push(
+        interstitialEmitter.addListener('onInterstitialAdClosed', () => {
+          listeners.onClosed?.();
+        }),
+      );
+    }
+    if (listeners.onClicked) {
+      subs.push(
+        interstitialEmitter.addListener('onInterstitialAdClicked', () => {
+          listeners.onClicked?.();
+        }),
+      );
+    }
+
+    return subs;
+  },
+};

package/src/AdWhaleMediationSdk.ts

@@ -0,0 +1,93 @@
+// src/AdWhaleMediationSdk.ts
+import { NativeModules, Platform } from 'react-native';
+
+const LINKING_ERROR =
+  `AdWhale Mediation SDK native modules not linked.\n` +
+  `Make sure:\n` +
+  `  • Android: AdwhaleSdkReactNative / RNAdWhaleMediationLoggerModule 등록 여부\n` +
+  `  • iOS: Pod install 및 빌드 완료 여부\n` +
+  `  • Web 환경에서 실행 중이 아닌지\n` +
+  `Platform: ${Platform.OS}`;
+
+// 네이티브 이름에 맞게 수정 👇
+interface AdwhaleSdkReactNativeModule {
+  initialize(): Promise<number>;
+
+  // 아래 메서드들은 네이티브에 없으면 자동으로 undefined라서
+  // JS에서 optional로 안전하게 처리됨
+  setCoppa?(enabled: boolean): void;
+  requestGdprConsent?(): Promise<{
+    isSuccess: boolean;
+    message: string;
+  }>;
+  getConsentStatus?(): Promise<{
+    coppa: boolean;
+    gdpr: string;
+    personalizedConsent: boolean;
+  }>;
+  resetGdprConsentStatus?(): void;
+  setGdpr?(consent: boolean): void;
+}
+
+interface RNAdWhaleMediationLoggerModule {
+  setLogLevel?(enabled: boolean): void;
+}
+
+const {
+  AdwhaleSdkReactNative,
+  RNAdWhaleMediationLoggerModule,
+} = NativeModules as {
+  AdwhaleSdkReactNative?: AdwhaleSdkReactNativeModule;
+  RNAdWhaleMediationLoggerModule?: RNAdWhaleMediationLoggerModule;
+};
+
+if (!AdwhaleSdkReactNative) {
+  console.warn(LINKING_ERROR);
+}
+
+export const AdWhaleMediationSdk = {
+  initialize(): Promise<number> {
+    if (!AdwhaleSdkReactNative?.initialize) {
+      return Promise.reject(new Error(LINKING_ERROR));
+    }
+    return AdwhaleSdkReactNative.initialize();
+  },
+
+  setLoggerEnabled(enabled: boolean) {
+    RNAdWhaleMediationLoggerModule?.setLogLevel?.(enabled);
+  },
+
+  setCoppa(enabled: boolean) {
+    AdwhaleSdkReactNative?.setCoppa?.(enabled);
+  },
+
+  requestGdprConsent(): Promise<{ isSuccess: boolean; message: string }> {
+    if (!AdwhaleSdkReactNative?.requestGdprConsent) {
+      return Promise.reject(
+        new Error('requestGdprConsent is not implemented in native module'),
+      );
+    }
+    return AdwhaleSdkReactNative.requestGdprConsent();
+  },
+
+  getConsentStatus(): Promise<{
+    coppa: boolean;
+    gdpr: string;
+    personalizedConsent: boolean;
+  }> {
+    if (!AdwhaleSdkReactNative?.getConsentStatus) {
+      return Promise.reject(
+        new Error('getConsentStatus is not implemented in native module'),
+      );
+    }
+    return AdwhaleSdkReactNative.getConsentStatus();
+  },
+
+  resetGdprConsentStatus() {
+    AdwhaleSdkReactNative?.resetGdprConsentStatus?.();
+  },
+
+  setGdpr(consent: boolean) {
+    AdwhaleSdkReactNative?.setGdpr?.(consent);
+  },
+};

package/src/AdWhaleNativeCustomView.tsx

@@ -0,0 +1,87 @@
+// src/AdWhaleNativeCustomView.tsx
+import React, { forwardRef, useImperativeHandle, useRef } from 'react';
+import { requireNativeComponent, UIManager, findNodeHandle } from 'react-native';
+import type {
+  NativeSyntheticEvent,
+  StyleProp,
+  ViewStyle,
+} from 'react-native';
+
+export interface AdWhaleNativeCustomError {
+  errorCode: number;
+  errorMessage: string;
+}
+
+export interface AdWhaleNativeCustomViewProps {
+  style?: StyleProp<ViewStyle>;
+  placementUid: string;
+  layoutName: string;
+
+  onAdLoaded?: () => void;
+  onAdFailedToLoad?: (event: AdWhaleNativeCustomError) => void;
+}
+
+export interface AdWhaleNativeCustomHandle {
+  loadAd(): void;
+  showAd(): void;
+}
+
+type NativeErrorEvent = NativeSyntheticEvent<AdWhaleNativeCustomError>;
+
+interface NativeProps
+  extends Omit<AdWhaleNativeCustomViewProps, 'onAdFailedToLoad'> {
+  onAdFailedToLoad?: (e: NativeErrorEvent) => void;
+}
+
+const VIEW_MANAGER_NAME = 'RNAdWhaleMediationCustomNativeAdView';
+
+const NativeComponent =
+  requireNativeComponent<NativeProps>(VIEW_MANAGER_NAME);
+
+export const AdWhaleNativeCustomView = forwardRef<
+  AdWhaleNativeCustomHandle,
+  AdWhaleNativeCustomViewProps
+>((props, ref) => {
+  const innerRef = useRef<React.ElementRef<typeof NativeComponent>>(null);
+
+  useImperativeHandle(ref, () => ({
+    loadAd() {
+      const handle = findNodeHandle(innerRef.current);
+      if (!handle) return;
+      const config = UIManager.getViewManagerConfig(VIEW_MANAGER_NAME) as
+        | { Commands?: { loadAd?: number; showAd?: number } }
+        | undefined;
+      if (!config?.Commands?.loadAd) return;
+      UIManager.dispatchViewManagerCommand(
+        handle,
+        config.Commands.loadAd,
+        [],
+      );
+    },
+    showAd() {
+      const handle = findNodeHandle(innerRef.current);
+      if (!handle) return;
+      const config = UIManager.getViewManagerConfig(VIEW_MANAGER_NAME) as
+        | { Commands?: { loadAd?: number; showAd?: number } }
+        | undefined;
+      if (!config?.Commands?.showAd) return;
+      UIManager.dispatchViewManagerCommand(
+        handle,
+        config.Commands.showAd,
+        [],
+      );
+    },
+  }));
+
+  const handleFailedToLoad: NativeProps['onAdFailedToLoad'] = e => {
+    props.onAdFailedToLoad?.(e.nativeEvent);
+  };
+
+  return (
+    <NativeComponent
+      ref={innerRef}
+      {...props}
+      onAdFailedToLoad={props.onAdFailedToLoad ? handleFailedToLoad : undefined}
+    />
+  );
+});

package/src/AdWhaleNativeTemplateView.tsx

@@ -0,0 +1,119 @@
+// src/AdWhaleNativeTemplateView.tsx
+import React, { forwardRef, useImperativeHandle, useRef } from 'react';
+import { requireNativeComponent, UIManager, findNodeHandle } from 'react-native';
+import type {
+  NativeSyntheticEvent,
+  StyleProp,
+  ViewStyle,
+} from 'react-native';
+
+export type AdWhaleNativeTemplateType = 'SMALL' | 'MEDIUM';
+
+export interface AdWhaleNativeTemplateStyle {
+  mainBackgroundColor?: string;
+  primaryTextTypefaceColor?: string;
+  primaryTextSize?: number;
+  primaryTextBackgroundColor?: string;
+  secondaryTextTypefaceColor?: string;
+  secondaryTextSize?: number;
+  secondaryTextBackgroundColor?: string;
+  tertiaryTextTypefaceColor?: string;
+  tertiaryTextSize?: number;
+  tertiaryTextBackgroundColor?: string;
+  callToActionTypefaceColor?: string;
+  callToActionTextSize?: number;
+  callToActionBackgroundColor?: string;
+  primaryTextTypeface?: 'bold' | 'italic';
+  secondaryTextTypeface?: 'bold' | 'italic';
+  callToActionTextTypeface?: 'bold' | 'italic';
+}
+
+export interface AdWhaleNativeTemplateError {
+  errorCode: number;
+  errorMessage: string;
+}
+
+export interface AdWhaleNativeTemplateViewProps {
+  style?: StyleProp<ViewStyle>;
+  placementUid: string;
+  template: AdWhaleNativeTemplateType;
+  templateStyle?: AdWhaleNativeTemplateStyle;
+
+  onAdLoaded?: () => void;
+  onAdFailedToLoad?: (event: AdWhaleNativeTemplateError) => void;
+  onAdShowFailed?: (event: AdWhaleNativeTemplateError) => void;
+}
+
+export interface AdWhaleNativeTemplateHandle {
+  loadAd(): void;
+  showAd(): void;
+}
+
+type NativeErrorEvent = NativeSyntheticEvent<AdWhaleNativeTemplateError>;
+
+interface NativeProps
+  extends Omit<
+    AdWhaleNativeTemplateViewProps,
+    'onAdFailedToLoad' | 'onAdShowFailed'
+  > {
+  onAdFailedToLoad?: (e: NativeErrorEvent) => void;
+  onAdShowFailed?: (e: NativeErrorEvent) => void;
+}
+
+const VIEW_MANAGER_NAME = 'RNAdWhaleMediationTemplateNativeAdView';
+
+const NativeComponent =
+  requireNativeComponent<NativeProps>(VIEW_MANAGER_NAME);
+
+export const AdWhaleNativeTemplateView = forwardRef<
+  AdWhaleNativeTemplateHandle,
+  AdWhaleNativeTemplateViewProps
+>((props, ref) => {
+  const innerRef = useRef<React.ElementRef<typeof NativeComponent>>(null);
+
+  useImperativeHandle(ref, () => ({
+    loadAd() {
+      const handle = findNodeHandle(innerRef.current);
+      if (!handle) return;
+      const config = UIManager.getViewManagerConfig(VIEW_MANAGER_NAME) as
+        | { Commands?: { loadAd?: number; showAd?: number } }
+        | undefined;
+      if (!config?.Commands?.loadAd) return;
+      UIManager.dispatchViewManagerCommand(
+        handle,
+        config.Commands.loadAd,
+        [],
+      );
+    },
+    showAd() {
+      const handle = findNodeHandle(innerRef.current);
+      if (!handle) return;
+      const config = UIManager.getViewManagerConfig(VIEW_MANAGER_NAME) as
+        | { Commands?: { loadAd?: number; showAd?: number } }
+        | undefined;
+      if (!config?.Commands?.showAd) return;
+      UIManager.dispatchViewManagerCommand(
+        handle,
+        config.Commands.showAd,
+        [],
+      );
+    },
+  }));
+
+  const handleFailedToLoad: NativeProps['onAdFailedToLoad'] = e => {
+    props.onAdFailedToLoad?.(e.nativeEvent);
+  };
+
+  const handleShowFailed: NativeProps['onAdShowFailed'] = e => {
+    props.onAdShowFailed?.(e.nativeEvent);
+  };
+
+  return (
+    <NativeComponent
+      ref={innerRef}
+      {...props}
+      onAdFailedToLoad={props.onAdFailedToLoad ? handleFailedToLoad : undefined}
+      onAdShowFailed={props.onAdShowFailed ? handleShowFailed : undefined}
+    />
+  );
+});