cloudx-react-native 3.11.0 → 3.11.1

package/ios/CloudXNativeAdHolder.mm

@@ -0,0 +1,247 @@
+//
+//  CloudXNativeAdHolder.mm
+//  cloudx-react-native
+//
+
+#import "CloudXNativeAdHolder.h"
+#import "CloudX.h"
+#import "CloudXNativeAdView.h"
+
+@interface CloudXNativeAdHolder ()
+@property (nonatomic, assign, readwrite, getter=isImpressed) BOOL impressed;
+@end
+
+@implementation CloudXNativeAdHolder
+
+// The registry lives on the CloudX module instance, not in a static: after a
+// JS reload the old module's teardown must only release the old context's
+// ads, never ones the new context has already preloaded.
++ (nullable NSMutableDictionary<NSString *, CloudXNativeAdHolder *> *)registry
+{
+    NSAssert([NSThread isMainThread], @"CloudXNativeAdHolder registry must be accessed on the main thread");
+    return [CloudX shared].nativeAdHolders;
+}
+
++ (void)registerHolder:(CloudXNativeAdHolder *)holder
+{
+    if ( holder.nativeAdId.length == 0 ) return;
+    [self registry][holder.nativeAdId] = holder;
+}
+
++ (nullable CloudXNativeAdHolder *)holderForId:(NSString *)nativeAdId
+{
+    if ( nativeAdId.length == 0 ) return nil;
+    return [self registry][nativeAdId];
+}
+
++ (void)removeHolderForId:(NSString *)nativeAdId
+{
+    if ( nativeAdId.length == 0 ) return;
+    [[self registry] removeObjectForKey: nativeAdId];
+}
+
++ (void)destroyAllHoldersInRegistry:(NSMutableDictionary<NSString *, CloudXNativeAdHolder *> *)registry
+{
+    NSAssert([NSThread isMainThread], @"CloudXNativeAdHolder registry must be accessed on the main thread");
+    NSArray<CloudXNativeAdHolder *> *holders = [registry.allValues copy];
+    [registry removeAllObjects];
+    for ( CloudXNativeAdHolder *holder in holders )
+    {
+        [holder destroy];
+    }
+}
+
++ (void)configureLoader:(CLXNativeAdLoader *)loader
+              placement:(nullable NSString *)placement
+             customData:(nullable NSString *)customData
+ disableVideoFullScreen:(BOOL)disableVideoFullScreen
+      startVideoUnmuted:(BOOL)startVideoUnmuted
+ hideVideoMediaControls:(BOOL)hideVideoMediaControls
+  extraParameterEntries:(nullable NSArray<NSDictionary *> *)extraParameterEntries
+localExtraParameterEntries:(nullable NSArray<NSDictionary *> *)localExtraParameterEntries
+{
+    loader.placement              = placement;
+    loader.customData             = customData;
+    loader.disableVideoFullScreen = disableVideoFullScreen;
+    loader.startVideoUnmuted      = startVideoUnmuted;
+    loader.hideVideoMediaControls = hideVideoMediaControls;
+
+    // JS null crosses the bridge as NSNull; normalize to nil so the loader
+    // never receives NSNull.
+    //
+    // extraParameters are bid-level auction signals (setExtraParameter:value:);
+    // localExtraParameters are adapter-only and never sent in the bid request
+    // (setLocalExtraParameterForKey:value:) — see CLXNativeAdLoader.h.
+    for ( NSDictionary *entry in extraParameterEntries )
+    {
+        if ( ![entry isKindOfClass: [NSDictionary class]] ) continue;
+        NSString *key = [entry[@"key"] isKindOfClass: [NSString class]] ? entry[@"key"] : nil;
+        if ( key.length == 0 ) continue;
+        id value = entry[@"value"];
+        if ( value == [NSNull null] ) value = nil;
+        [loader setExtraParameter: key value: value];
+    }
+
+    for ( NSDictionary *entry in localExtraParameterEntries )
+    {
+        if ( ![entry isKindOfClass: [NSDictionary class]] ) continue;
+        NSString *key = [entry[@"key"] isKindOfClass: [NSString class]] ? entry[@"key"] : nil;
+        if ( key.length == 0 ) continue;
+        id value = entry[@"value"];
+        if ( value == [NSNull null] ) value = nil;
+        [loader setLocalExtraParameterForKey: key value: value];
+    }
+}
+
+- (instancetype)initWithNativeAdId:(NSString *)nativeAdId
+                          adUnitId:(NSString *)adUnitId
+                            loader:(CLXNativeAdLoader *)loader
+{
+    self = [super init];
+    if ( self )
+    {
+        _nativeAdId = [nativeAdId copy];
+        _adUnitId   = [adUnitId copy];
+        _loader     = loader;
+    }
+    return self;
+}
+
+- (void)destroy
+{
+    NSAssert([NSThread isMainThread], @"CloudXNativeAdHolder destroy must be called on the main thread");
+
+    self.loader.nativeAdDelegate = nil;
+    self.loader.revenueDelegate  = nil;
+
+    CloudXNativeAdView *bound = self.boundView;
+    if ( bound )
+    {
+        self.boundView = nil;
+        [bound handleBoundAdDestroyed];
+    }
+
+    if ( self.ad )
+    {
+        [self.loader destroyAd: self.ad];
+        self.ad = nil;
+    }
+    [self.loader destroy];
+
+    if ( self.rejectBlock )
+    {
+        self.rejectBlock(@"400", @"native ad destroyed", nil);
+        self.resolveBlock = nil;
+        self.rejectBlock = nil;
+    }
+}
+
+- (void)dealloc
+{
+    CLXNativeAdLoader *loader = _loader;
+    CLXAd *ad = _ad;
+    if ( !loader ) return;
+
+    loader.nativeAdDelegate = nil;
+    loader.revenueDelegate = nil;
+
+    dispatch_async(dispatch_get_main_queue(), ^{
+        if ( ad ) [loader destroyAd: ad];
+        [loader destroy];
+    });
+}
+
+#pragma mark - CLXNativeAdDelegate
+
+- (void)didLoadNativeAd:(nullable CLXNativeAdView *)nativeAdView forAd:(CLXAd *)ad
+{
+    NSAssert([NSThread isMainThread], @"didLoadNativeAd must be called on the main thread");
+    self.ad = ad;
+
+    if ( self.resolveBlock )
+    {
+        NSDictionary *adInfo = [[CloudX shared] adInfoForAd: ad];
+        self.resolveBlock(@{@"nativeAdId": self.nativeAdId, @"adInfo": adInfo});
+        self.resolveBlock = nil;
+        self.rejectBlock = nil;
+    }
+}
+
+- (void)didFailToLoadNativeAdForAdUnitIdentifier:(NSString *)adUnitId error:(CLXError *)error
+{
+    NSAssert([NSThread isMainThread], @"didFailToLoadNativeAd must be called on the main thread");
+    [[CloudX shared] log: @"Preloaded native ad load failed. nativeAdId=%@ adUnitId=%@ code=%ld message=%@",
+                          self.nativeAdId, adUnitId ?: @"", (long)(error ? error.code : CLXErrorCodeInternalError),
+                          error.localizedDescription ?: @""];
+
+    if ( self.rejectBlock )
+    {
+        NSString *codeStr = [NSString stringWithFormat: @"%ld", (long)(error ? error.code : CLXErrorCodeInternalError)];
+        NSString *message = error.localizedDescription ?: @"Ad failed to load";
+        self.rejectBlock(codeStr, message, nil);
+        self.resolveBlock = nil;
+        self.rejectBlock = nil;
+    }
+
+    [self.loader destroy];
+    [CloudXNativeAdHolder removeHolderForId: self.nativeAdId];
+}
+
+- (void)didClickNativeAd:(CLXAd *)ad
+{
+    NSAssert([NSThread isMainThread], @"didClickNativeAd must be called on the main thread");
+    NSMutableDictionary *payload = [[[CloudX shared] adInfoForAd: ad] mutableCopy];
+    payload[@"nativeAdId"] = self.nativeAdId;
+    [[CloudX shared] sendReactNativeEventWithName: ON_NATIVE_AD_CLICKED_EVENT body: payload];
+}
+
+- (void)didExpireNativeAd:(CLXAd *)ad
+{
+    NSAssert([NSThread isMainThread], @"didExpireNativeAd must be called on the main thread");
+    self.expired = YES;
+
+    if ( self.isImpressed )
+    {
+        [[CloudX shared] log: @"Preloaded native ad expired after its impression; ignoring. nativeAdId=%@", self.nativeAdId];
+        return;
+    }
+
+    NSMutableDictionary *payload = [[[CloudX shared] adInfoForAd: ad] mutableCopy];
+    payload[@"nativeAdId"] = self.nativeAdId;
+    [[CloudX shared] sendReactNativeEventWithName: ON_NATIVE_AD_EXPIRED_EVENT body: payload];
+
+    CloudXNativeAdView *bound = self.boundView;
+    if ( bound )
+    {
+        self.boundView = nil;
+        [bound handleBoundAdExpired];
+    }
+
+    if ( self.ad )
+    {
+        [self.loader destroyAd: self.ad];
+        self.ad = nil;
+    }
+    [self.loader destroy];
+}
+
+- (void)didCloseNativeAd:(CLXAd *)ad
+{
+    NSAssert([NSThread isMainThread], @"didCloseNativeAd must be called on the main thread");
+    NSMutableDictionary *payload = [[[CloudX shared] adInfoForAd: ad] mutableCopy];
+    payload[@"nativeAdId"] = self.nativeAdId;
+    [[CloudX shared] sendReactNativeEventWithName: ON_NATIVE_AD_CLOSED_EVENT body: payload];
+}
+
+#pragma mark - CLXAdRevenueDelegate
+
+- (void)didPayRevenueForAd:(CLXAd *)ad
+{
+    NSAssert([NSThread isMainThread], @"didPayRevenueForAd must be called on the main thread");
+    self.impressed = YES;
+    NSMutableDictionary *payload = [[[CloudX shared] adInfoForAd: ad] mutableCopy];
+    payload[@"nativeAdId"] = self.nativeAdId;
+    [[CloudX shared] sendReactNativeEventWithName: ON_NATIVE_AD_REVENUE_PAID body: payload];
+}
+
+@end

package/ios/CloudXNativeAdView.h

@@ -22,6 +22,7 @@
 NS_ASSUME_NONNULL_BEGIN
 
 @property (nonatomic, copy, nullable) NSString *adUnitId;
+@property (nonatomic, copy, nullable) NSString *nativeAdId;
 @property (nonatomic, copy, nullable) NSString *templateName;
 @property (nonatomic, copy, nullable) NSString *placement;
 @property (nonatomic, copy, nullable) NSString *customData;
@@ -38,13 +39,21 @@ NS_ASSUME_NONNULL_BEGIN
 // Nil by default on the Old Architecture (only set when the publisher passes
 // the corresponding callback); delegate call sites guard with `if (self.onX)`.
 @property (nonatomic, copy, nullable) RCTDirectEventBlock onAdLoadedEvent;
+@property (nonatomic, copy, nullable) RCTDirectEventBlock onAdDisplayedEvent;
 @property (nonatomic, copy, nullable) RCTDirectEventBlock onAdLoadFailedEvent;
 @property (nonatomic, copy, nullable) RCTDirectEventBlock onAdDisplayFailedEvent;
+// Internal: the preloaded ad left this view (destroy, expiry, or a newer view
+// took it), so the JS view clears its asset components. Not a publisher callback.
+@property (nonatomic, copy, nullable) RCTDirectEventBlock onAdBindingClearedEvent;
 @property (nonatomic, copy, nullable) RCTDirectEventBlock onAdClickedEvent;
 @property (nonatomic, copy, nullable) RCTDirectEventBlock onAdExpiredEvent;
 @property (nonatomic, copy, nullable) RCTDirectEventBlock onAdClosedEvent;
 @property (nonatomic, copy, nullable) RCTDirectEventBlock onAdRevenuePaidEvent;
 
+- (void)handleBoundAdDestroyed;
+- (void)handleBoundAdExpired;
+- (void)clearRenderedAdSilently;
+
 - (void)setExtraParametersFromEntryArray:(nullable NSArray<NSDictionary<NSString *, id> *> *)extraParameters;
 - (void)setLocalExtraParametersFromEntryArray:(nullable NSArray<NSDictionary<NSString *, id> *> *)localExtraParameters;