@advergic-ads/react-native-sdk 1.0.0

package/index.d.ts

@@ -0,0 +1,135 @@
+import type * as React from "react";
+import type { ViewStyle } from "react-native";
+
+export interface SDKInitializedEvent {
+  initialized: boolean;
+  adUnitCount?: number;
+}
+
+export interface BotDetectionEvent {
+  passed: boolean;
+}
+
+export interface AdUnitEvent {
+  adUnitId: string;
+}
+
+export interface AdUnitErrorEvent extends AdUnitEvent {
+  error: string;
+}
+
+export interface BannerAdLoadedEvent {
+  adUnitId: string;
+}
+
+export interface AdError {
+  adUnitId: string;
+  error: string;
+}
+
+export interface NativeAdData {
+  title: string;
+  body: string;
+  callToAction: string;
+  mainImage: string;
+  icon: string;
+  sponsoredBy: string;
+  advertiserDomain: string;
+  clickUrl: string;
+}
+
+export interface AdvergicConfig {
+  apiKey: string;
+}
+
+export type AdFormat =
+  | "banner"
+  | "interstitial"
+  | "rewarded"
+  | "native"
+  | "appopen";
+
+export interface AdvergicBannerAdProps {
+  adUnitId: string;
+  style?: ViewStyle;
+  onAdLoaded?: () => void;
+  onAdFailedToLoad?: (error: string) => void;
+  onAdClicked?: () => void;
+  onAdImpression?: () => void;
+}
+
+export interface AdvergicInterface {
+  initialize: (apiKey: string) => Promise<boolean>;
+  canServeAds: () => Promise<boolean>;
+  getAdUnits: () => Promise<Array<{ id: string; name: string; type: string }>>;
+  performFollowUpBotDetection: () => void;
+
+  showBannerAd: (adUnitId: string, containerId?: number) => void;
+  showInterstitialAd: (adUnitId: string) => void;
+  showRewardedAd: (adUnitId: string) => void;
+  showAppOpenAd: (adUnitId: string) => void;
+  showNativeAd: (adUnitId: string, containerId?: number) => void;
+  loadNativeAd: (adUnitId: string) => Promise<NativeAdData>;
+
+  addListener: <K extends string>(
+    event: K,
+    callback: (event: any) => void,
+  ) => any;
+  removeAllListeners: () => void;
+
+  onSDKInitialized: (callback: (event: SDKInitializedEvent) => void) => any;
+  onBotDetectionResult: (callback: (event: BotDetectionEvent) => void) => any;
+
+  onBannerAdLoaded: (callback: (event: AdUnitEvent) => void) => any;
+  onBannerAdFailedToLoad: (callback: (event: AdUnitErrorEvent) => void) => any;
+  onBannerAdClicked: (callback: (event: AdUnitEvent) => void) => any;
+  onBannerAdImpression: (callback: (event: AdUnitEvent) => void) => any;
+
+  onInterstitialAdLoaded: (callback: (event: AdUnitEvent) => void) => any;
+  onInterstitialAdFailedToLoad: (
+    callback: (event: AdUnitErrorEvent) => void,
+  ) => any;
+  onInterstitialAdShowed: (callback: (event: AdUnitEvent) => void) => any;
+  onInterstitialAdDismissed: (callback: (event: AdUnitEvent) => void) => any;
+  onInterstitialAdFailedToShow: (
+    callback: (event: AdUnitErrorEvent) => void,
+  ) => any;
+  onInterstitialAdClicked: (callback: (event: AdUnitEvent) => void) => any;
+  onInterstitialAdImpression: (callback: (event: AdUnitEvent) => void) => any;
+
+  onRewardedAdLoaded: (callback: (event: AdUnitEvent) => void) => any;
+  onRewardedAdFailedToLoad: (
+    callback: (event: AdUnitErrorEvent) => void,
+  ) => any;
+  onRewardedAdShowed: (callback: (event: AdUnitEvent) => void) => any;
+  onRewardedAdFailedToShow: (
+    callback: (event: AdUnitErrorEvent) => void,
+  ) => any;
+  onRewardedAdOpened: (callback: (event: AdUnitEvent) => void) => any;
+  onRewardedAdClicked: (callback: (event: AdUnitEvent) => void) => any;
+  onRewardedAdClosed: (callback: (event: AdUnitEvent) => void) => any;
+  onRewardedAdUserEarnedReward: (
+    callback: (reward: { type: string; amount: number }) => void,
+  ) => any;
+
+  onAppOpenAdLoaded: (callback: (event: AdUnitEvent) => void) => any;
+  onAppOpenAdFailedToLoad: (callback: (event: AdUnitErrorEvent) => void) => any;
+  onAppOpenAdShowed: (callback: (event: AdUnitEvent) => void) => any;
+  onAppOpenAdDismissed: (callback: (event: AdUnitEvent) => void) => any;
+  onAppOpenAdFailedToShow: (callback: (event: AdUnitErrorEvent) => void) => any;
+  onAppOpenAdClicked: (callback: (event: AdUnitEvent) => void) => any;
+  onAppOpenAdImpression: (callback: (event: AdUnitEvent) => void) => any;
+
+  onNativeAdLoaded: (callback: (event: AdUnitEvent) => void) => any;
+  onNativeAdFailedToLoad: (callback: (event: AdUnitErrorEvent) => void) => any;
+  onNativeAdClicked: (callback: (event: AdUnitEvent) => void) => any;
+  onNativeAdImpression: (callback: (event: AdUnitEvent) => void) => any;
+  onNativePrebidAdNotFound: (callback: (event: AdUnitEvent) => void) => any;
+  onNativePrebidAdNotValid: (callback: (event: AdUnitEvent) => void) => any;
+}
+
+declare const Advergic: AdvergicInterface;
+export default Advergic;
+export type { AdvergicInterface };
+
+export declare const AdvergicBannerAd: React.FC<AdvergicBannerAdProps>;

package/index.js

@@ -0,0 +1,27 @@
+import type {
+  AdvergicInterface,
+  SDKInitializedEvent,
+  BotDetectionEvent,
+  AdUnitEvent,
+  AdUnitErrorEvent,
+  AdvergicConfig,
+  AdvergicBannerAdProps,
+  NativeAdData,
+} from './index.d';
+
+export type {
+  AdvergicInterface,
+  SDKInitializedEvent,
+  BotDetectionEvent,
+  AdUnitEvent,
+  AdUnitErrorEvent,
+  AdvergicConfig,
+  AdvergicBannerAdProps,
+  NativeAdData,
+};
+
+import Advergic from './src/advergic/AdvergicSDK';
+import { AdvergicBannerAd } from './src/advergic/AdvergicBannerAd';
+
+export default Advergic;
+export { AdvergicBannerAd };

package/install.js

@@ -0,0 +1,158 @@
+#!/usr/bin/env node
+/**
+ * advergic-react-native post-install script
+ * Minimal setup - React Native auto-linking handles most configuration
+ */
+
+const fs = require("fs");
+const path = require("path");
+
+const PACKAGE_ROOT = __dirname;
+const AAR_SOURCE = path.join(PACKAGE_ROOT, "android", "libs", "advergic-sdk.aar");
+const PROJECT_ROOT = path.resolve(PACKAGE_ROOT, "..", "..");
+
+const checkReactNativeVersion = () => {
+  try {
+    const rnPkgPath = path.join(PROJECT_ROOT, "node_modules", "react-native", "package.json");
+    if (!fs.existsSync(rnPkgPath)) {
+      console.warn("[Advergic] React Native not found. Installing it first?");
+      return;
+    }
+    const rnPkg = require(rnPkgPath);
+    const version = rnPkg.version;
+    const major = parseInt(rnPkg.version.split(".")[0]);
+
+    if (major < 76) {
+      console.warn(
+        `[Advergic] Warning: React Native ${version} detected. This package requires RN 0.76+.`,
+      );
+    } else {
+      console.log(`[Advergic] ✓ React Native ${version} detected`);
+    }
+  } catch (e) {
+    // React Native might not be installed yet during initial setup
+  }
+};
+
+const verifyAAR = () => {
+  if (!fs.existsSync(AAR_SOURCE)) {
+    console.error("");
+    console.error("[Advergic] ERROR: advergic-sdk.aar not found!");
+    console.error(`[Advergic] Expected at: ${AAR_SOURCE}`);
+    console.error("[Advergic]");
+    console.error("[Advergic] The AAR file must be included in the npm package.");
+    console.error("[Advergic] If you're building from source, run:");
+    console.error("[Advergic]   cd android-sdk");
+    console.error("[Advergic]   ./gradlew :advergic-sdk:assembleRelease");
+    console.error("[Advergic]   cp advergic-sdk/build/outputs/aar/advergic-sdk-release.aar ../advergic-react-native/android/libs/");
+    console.error("");
+    process.exit(1);
+  }
+  console.log("[Advergic] ✓ advergic-sdk.aar found");
+};
+
+const copyAARToNodeModules = () => {
+  // Copy AAR to bridge module libs for auto-linking
+  const bridgeLibsDir = path.join(PACKAGE_ROOT, "android", "advergic-bridge", "libs");
+  if (!fs.existsSync(bridgeLibsDir)) {
+    fs.mkdirSync(bridgeLibsDir, { recursive: true });
+  }
+
+  const AAR_DEST = path.join(bridgeLibsDir, "advergic-sdk.aar");
+  if (!fs.existsSync(AAR_DEST)) {
+    fs.copyFileSync(AAR_SOURCE, AAR_DEST);
+    console.log("[Advergic] ✓ Copied AAR to bridge module");
+  } else {
+    console.log("[Advergic] ✓ AAR already in bridge module");
+  }
+
+  // Always copy to app/libs for fallback access (create directory if needed)
+  const appLibsDir = path.join(PROJECT_ROOT, "android", "app", "libs");
+  if (fs.existsSync(path.join(PROJECT_ROOT, "android", "app"))) {
+    if (!fs.existsSync(appLibsDir)) {
+      fs.mkdirSync(appLibsDir, { recursive: true });
+    }
+    const AAR_APP_DEST = path.join(appLibsDir, "advergic-sdk.aar");
+    if (!fs.existsSync(AAR_APP_DEST)) {
+      fs.copyFileSync(AAR_SOURCE, AAR_APP_DEST);
+      console.log("[Advergic] ✓ Copied AAR to app/libs");
+    }
+  }
+};
+
+const ensureAppBuildGradleRepositories = () => {
+  const appBuildGradlePath = path.join(PROJECT_ROOT, "android", "app", "build.gradle");
+
+  if (!fs.existsSync(appBuildGradlePath)) {
+    return; // App not set up yet
+  }
+
+  let content = fs.readFileSync(appBuildGradlePath, "utf8");
+
+  // Check if repositories block already exists
+  if (content.includes("repositories {")) {
+    console.log("[Advergic] ✓ app/build.gradle repositories already configured");
+    return;
+  }
+
+  // Add repositories block before dependencies
+  const repositoriesBlock = `
+repositories {
+    flatDir {
+        dirs file("${projectDir}/libs")
+    }
+}
+`;
+
+  // Insert before the first "dependencies" block
+  if (content.includes("dependencies {")) {
+    content = content.replace("dependencies {", repositoriesBlock + "\ndependencies {");
+    fs.writeFileSync(appBuildGradlePath, content, "utf8");
+    console.log("[Advergic] ✓ Added repositories configuration to app/build.gradle");
+  }
+};
+
+const printSetupComplete = () => {
+  console.log("");
+  console.log("╔════════════════════════════════════════════════════════════════╗");
+  console.log("║            Advergic SDK Setup Complete!                        ║");
+  console.log("╚════════════════════════════════════════════════════════════════╝");
+  console.log("");
+  console.log("✓ React Native auto-linking will handle the module integration");
+  console.log("✓ AAR files are automatically set up");
+  console.log("");
+  console.log("Next step - Add to AndroidManifest.xml:");
+  console.log("");
+  console.log('  <application>');
+  console.log('    <meta-data');
+  console.log('      android:name="com.google.android.gms.ads.APPLICATION_ID"');
+  console.log('      android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy" />');
+  console.log('    <!-- Replace with YOUR Google Ads Application ID -->');
+  console.log("  </application>");
+  console.log("");
+  console.log("Get your Application ID from:");
+  console.log("  https://admob.google.com/");
+  console.log("");
+};
+
+const setup = () => {
+  console.log("");
+  console.log("[Advergic] Starting post-install setup...");
+
+  checkReactNativeVersion();
+  verifyAAR();
+  copyAARToNodeModules();
+  ensureAppBuildGradleRepositories();
+  printSetupComplete();
+};
+
+if (require.main === module) {
+  try {
+    setup();
+  } catch (error) {
+    console.error("[Advergic] Post-install failed:", error.message);
+    process.exit(1);
+  }
+}
+
+module.exports = { setup };

package/ios/AdvergicBannerView.swift

@@ -0,0 +1,59 @@
+//
+//  AdvergicBannerView.swift
+//  AdvergicReactNative
+//
+//  Native view backing the `AdvergicBannerAd` React component. The view itself
+//  is the container the iOS SDK renders the banner into. It auto-loads as soon
+//  as `adUnitId` is set, mirroring the Android `AdvergicBannerContainerView`.
+//
+
+import UIKit
+import React
+
+class AdvergicBannerView: UIView {
+
+  @objc var onAdLoaded: RCTBubblingEventBlock?
+  @objc var onAdFailedToLoad: RCTBubblingEventBlock?
+  @objc var onAdClicked: RCTBubblingEventBlock?
+  @objc var onAdImpression: RCTBubblingEventBlock?
+
+  private var hasLoadedAd = false
+
+  @objc var adUnitId: NSString? {
+    didSet {
+      if let id = adUnitId as String?, !id.isEmpty, !hasLoadedAd {
+        loadAd()
+      }
+    }
+  }
+
+  private func loadAd() {
+    guard let adUnitId = adUnitId as String?, !adUnitId.isEmpty else { return }
+    guard let module = AdvergicReactNativeModule.shared else {
+      onAdFailedToLoad?(["error": "AdvergicSDK native module not available"])
+      return
+    }
+
+    hasLoadedAd = true
+    module.loadBanner(
+      adUnitId: adUnitId,
+      container: self,
+      onLoaded: { [weak self] in
+        self?.onAdLoaded?([:])
+      },
+      onFailed: { [weak self] error in
+        self?.onAdFailedToLoad?(["error": error])
+      }
+    )
+  }
+
+  // Called by the module when the SDK reports a click / impression via its
+  // shared delegate (these are not delivered through the banner completion).
+  func dispatchClicked() {
+    onAdClicked?([:])
+  }
+
+  func dispatchImpression() {
+    onAdImpression?([:])
+  }
+}

package/ios/AdvergicBannerViewManager.m

@@ -0,0 +1,18 @@
+//
+//  AdvergicBannerViewManager.m
+//  AdvergicReactNative
+//
+//  Exposes the banner view manager and its props / events to React Native.
+//
+
+#import <React/RCTViewManager.h>
+
+@interface RCT_EXTERN_MODULE(AdvergicBannerViewManager, RCTViewManager)
+
+RCT_EXPORT_VIEW_PROPERTY(adUnitId, NSString)
+RCT_EXPORT_VIEW_PROPERTY(onAdLoaded, RCTBubblingEventBlock)
+RCT_EXPORT_VIEW_PROPERTY(onAdFailedToLoad, RCTBubblingEventBlock)
+RCT_EXPORT_VIEW_PROPERTY(onAdClicked, RCTBubblingEventBlock)
+RCT_EXPORT_VIEW_PROPERTY(onAdImpression, RCTBubblingEventBlock)
+
+@end

package/ios/AdvergicBannerViewManager.swift

@@ -0,0 +1,24 @@
+//
+//  AdvergicBannerViewManager.swift
+//  AdvergicReactNative
+//
+//  Registers the `AdvergicBannerView` native component (the "Manager" suffix is
+//  stripped by React Native, yielding the component name `AdvergicBannerView`
+//  used by `requireNativeComponent` on the JS side).
+//
+
+import Foundation
+import React
+
+@objc(AdvergicBannerViewManager)
+class AdvergicBannerViewManager: RCTViewManager {
+
+  override func view() -> UIView! {
+    return AdvergicBannerView()
+  }
+
+  @objc
+  override static func requiresMainQueueSetup() -> Bool {
+    return true
+  }
+}

package/ios/AdvergicReactNativeModule.m

@@ -0,0 +1,36 @@
+//
+//  AdvergicReactNativeModule.m
+//  AdvergicReactNative
+//
+//  Exposes the Swift `AdvergicReactNativeModule` (registered as `AdvergicSDK`)
+//  and its methods to the React Native bridge.
+//
+
+#import <React/RCTBridgeModule.h>
+#import <React/RCTEventEmitter.h>
+
+@interface RCT_EXTERN_MODULE(AdvergicSDK, RCTEventEmitter)
+
+RCT_EXTERN_METHOD(initialize:(NSString *)apiKey
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(canServeAds:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(getAdUnits:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(performFollowUpBotDetection)
+
+RCT_EXTERN_METHOD(showBannerAd:(NSString *)adUnitId containerId:(nonnull NSNumber *)containerId)
+
+RCT_EXTERN_METHOD(showInterstitialAd:(NSString *)adUnitId)
+
+RCT_EXTERN_METHOD(showRewardedAd:(NSString *)adUnitId)
+
+RCT_EXTERN_METHOD(showAppOpenAd:(NSString *)adUnitId)
+
+RCT_EXTERN_METHOD(showNativeAd:(NSString *)adUnitId containerId:(nonnull NSNumber *)containerId)
+
+@end