cm-sdk-react-native-v3 3.6.0 → 3.6.2

package/src/NativeCmSdkReactNativeV3.ts

@@ -1,5 +1,4 @@
-import type { TurboModule } from 'react-native';
-import { TurboModuleRegistry } from 'react-native';
+import { NativeModules } from 'react-native';
 
 // Event payload types for better TypeScript support
 export type ConsentReceivedEvent = {
@@ -30,16 +29,53 @@ export type UrlConfig = {
   noHash?: boolean;
 };
 
+export enum WebViewPosition {
+  FullScreen = 'fullScreen',
+  HalfScreenTop = 'halfScreenTop',
+  HalfScreenBottom = 'halfScreenBottom',
+  Custom = 'custom',
+}
+
+export type WebViewRect = {
+  x: number;
+  y: number;
+  width: number;
+  height: number;
+};
+
+export enum BackgroundStyleType {
+  Dimmed = 'dimmed',
+  Color = 'color',
+  Blur = 'blur',
+  None = 'none',
+}
+
+export enum BlurEffectStyle {
+  Light = 'light',
+  Dark = 'dark',
+  ExtraLight = 'extraLight',
+}
+
+export enum ATTStatus {
+  NotDetermined = 0,
+  Restricted = 1,
+  Denied = 2,
+  Authorized = 3,
+}
+
+export type WebViewBackgroundStyle =
+  | { type: BackgroundStyleType.Dimmed; color?: string | number; opacity?: number }
+  | { type: BackgroundStyleType.Color; color: string | number }
+  | { type: BackgroundStyleType.Blur; blurEffectStyle?: BlurEffectStyle }
+  | { type: BackgroundStyleType.None };
+
 export type WebViewConfig = {
-  position?: string;
+  position?: WebViewPosition;
+  customRect?: WebViewRect;
   cornerRadius?: number;
   respectsSafeArea?: boolean;
   allowsOrientationChanges?: boolean;
-  backgroundStyle?: {
-    type?: string;
-    color?: string;
-    opacity?: number;
-  };
+  backgroundStyle?: WebViewBackgroundStyle;
 };
 
 export type UserStatus = {
@@ -53,14 +89,14 @@ export type UserStatus = {
 
 export type GoogleConsentModeStatus = Object;
 
-export interface Spec extends TurboModule {
+export interface CmSdkReactNativeV3Module {
   // Configuration methods
   setUrlConfig(config: UrlConfig): Promise<void>;
-  
+
   setWebViewConfig(config: WebViewConfig): Promise<void>;
 
   // iOS-only ATT status method
-  setATTStatus(status: number): Promise<void>;
+  setATTStatus(status: ATTStatus | number): Promise<void>;
 
   // Main interaction methods
   checkAndOpen(jumpToSettings: boolean): Promise<boolean>;
@@ -84,9 +120,11 @@ export interface Spec extends TurboModule {
   rejectAll(): Promise<boolean>;
   acceptAll(): Promise<boolean>;
 
-  // Event emitter methods (required for TurboModule)
+  // Event emitter methods used by NativeEventEmitter
   addListener(eventName: string): void;
   removeListeners(count: number): void;
 }
 
-export default TurboModuleRegistry.getEnforcing<Spec>('CmSdkReactNativeV3');
+const { CmSdkReactNativeV3 } = NativeModules;
+
+export default CmSdkReactNativeV3 as CmSdkReactNativeV3Module;

package/src/index.tsx

@@ -1,4 +1,4 @@
-import { NativeModules, Platform, NativeEventEmitter } from 'react-native';
+import { NativeModules, Platform, NativeEventEmitter, processColor } from 'react-native';
 import NativeCmSdkReactNativeV3, {
   type ConsentReceivedEvent,
   type ErrorEvent,
@@ -6,27 +6,37 @@ import NativeCmSdkReactNativeV3, {
   type ATTStatusChangeEvent,
   type UrlConfig,
   type WebViewConfig,
+  type WebViewRect,
+  type WebViewBackgroundStyle,
+  WebViewPosition,
+  BackgroundStyleType,
+  BlurEffectStyle,
+  ATTStatus,
   type UserStatus,
   type GoogleConsentModeStatus,
+  type CmSdkReactNativeV3Module,
 } from './NativeCmSdkReactNativeV3';
 
+// Re-export enums/constants for consumers
+export { WebViewPosition, BackgroundStyleType, BlurEffectStyle, ATTStatus };
+
 const LINKING_ERROR =
   `The package 'react-native-cm-sdk-react-native-v3' doesn't seem to be linked. Make sure: \n\n` +
   Platform.select({ ios: "- You have run 'pod install'\n", default: '' }) +
   '- You rebuilt the app after installing the package\n' +
   '- You are not using Expo Go\n';
 
-// Use TurboModule if available (New Architecture), fallback to legacy NativeModules
-const CmSdkReactNativeV3 = NativeCmSdkReactNativeV3 ?? (NativeModules.CmSdkReactNativeV3
-  ? NativeModules.CmSdkReactNativeV3
-  : new Proxy(
-      {},
-      {
-        get() {
-          throw new Error(LINKING_ERROR);
-        },
-      }
-    ));
+const CmSdkReactNativeV3: CmSdkReactNativeV3Module =
+  NativeCmSdkReactNativeV3 ??
+  (NativeModules.CmSdkReactNativeV3 as CmSdkReactNativeV3Module | undefined) ??
+  (new Proxy(
+    {},
+    {
+      get() {
+        throw new Error(LINKING_ERROR);
+      },
+    }
+  ) as CmSdkReactNativeV3Module);
 
 const eventEmitter = new NativeEventEmitter(CmSdkReactNativeV3);
 
@@ -68,10 +78,22 @@ export const setUrlConfig = (config: UrlConfig): Promise<void> => {
 };
 
 export const setWebViewConfig = (config: WebViewConfig): Promise<void> => {
-  return CmSdkReactNativeV3.setWebViewConfig(config);
+  const normalized = normalizeWebViewConfig(config);
+  return CmSdkReactNativeV3.setWebViewConfig(normalized);
 };
 
-export const setATTStatus = (status: number): Promise<void> => {
+export const setATTStatus = (status: ATTStatus | number): Promise<void> => {
+  const allowed = new Set<ATTStatus>([
+    ATTStatus.NotDetermined,
+    ATTStatus.Restricted,
+    ATTStatus.Denied,
+    ATTStatus.Authorized,
+  ]);
+  if (!allowed.has(status as ATTStatus)) {
+    throw new Error(
+      `[cm-sdk-react-native-v3] Invalid ATT status ${status}. Use ATTStatus enum (0–3 from Apple's ATTrackingManagerAuthorizationStatus).`
+    );
+  }
   return CmSdkReactNativeV3.setATTStatus(status);
 };
 
@@ -89,6 +111,96 @@ export const getUserStatus = (): Promise<UserStatus> => {
   return CmSdkReactNativeV3.getUserStatus();
 };
 
+// Helpers
+const normalizeWebViewConfig = (config: WebViewConfig): WebViewConfig => {
+  const position = (config.position as WebViewPosition | undefined) ?? WebViewPosition.FullScreen;
+  const allowedPositions = [
+    WebViewPosition.FullScreen,
+    WebViewPosition.HalfScreenTop,
+    WebViewPosition.HalfScreenBottom,
+    WebViewPosition.Custom,
+  ];
+  if (!allowedPositions.includes(position)) {
+    throw new Error(`Invalid WebView position: ${position}`);
+  }
+
+  if (position === WebViewPosition.Custom) {
+    if (!config.customRect) {
+      throw new Error('customRect is required when position is "custom"');
+    }
+    if (Platform.OS === 'android') {
+      console.warn(
+        '[cm-sdk-react-native-v3] Android native SDK currently ignores customRect/position "custom"; it will fall back to full screen.'
+      );
+    }
+  }
+
+  const backgroundStyle = (() => {
+    if (!config.backgroundStyle) {
+      return {
+        type: BackgroundStyleType.Dimmed,
+        color: normalizeColor('black'),
+        opacity: 0.5,
+      } as WebViewBackgroundStyle;
+    }
+    const { type } = config.backgroundStyle;
+    switch (type) {
+      case BackgroundStyleType.Dimmed:
+        return {
+          type,
+          color: normalizeColor(config.backgroundStyle.color ?? 'black'),
+          opacity: config.backgroundStyle.opacity ?? 0.5,
+        } as WebViewBackgroundStyle;
+      case BackgroundStyleType.Color:
+        if (!config.backgroundStyle.color) throw new Error('color is required for backgroundStyle "color"');
+        return { type, color: normalizeColor(config.backgroundStyle.color) } as WebViewBackgroundStyle;
+      case BackgroundStyleType.Blur: {
+        const blurStyle =
+          config.backgroundStyle.blurEffectStyle ?? (Platform.OS === 'ios'
+            ? BlurEffectStyle.Dark
+            : BlurEffectStyle.Dark);
+        if (
+          blurStyle !== BlurEffectStyle.Dark &&
+          blurStyle !== BlurEffectStyle.Light &&
+          blurStyle !== BlurEffectStyle.ExtraLight
+        ) {
+          throw new Error(`Invalid blurEffectStyle: ${blurStyle}`);
+        }
+        if (Platform.OS === 'android') {
+          console.warn('[cm-sdk-react-native-v3] Android native SDK currently ignores blur backgrounds; using dimmed.');
+        }
+        return { type, blurEffectStyle: blurStyle } as WebViewBackgroundStyle;
+      }
+      case BackgroundStyleType.None:
+        return { type } as WebViewBackgroundStyle;
+      default:
+        throw new Error(`Invalid backgroundStyle type: ${(config.backgroundStyle as any).type}`);
+    }
+  })();
+
+  if (Platform.OS === 'android' && config.backgroundStyle) {
+    console.warn(
+      '[cm-sdk-react-native-v3] Android native SDK currently ignores backgroundStyle overrides; it always uses a dimmed background.'
+    );
+  }
+
+  return {
+    position,
+    customRect: config.customRect,
+    cornerRadius: config.cornerRadius ?? 5,
+    respectsSafeArea: config.respectsSafeArea ?? true,
+    allowsOrientationChanges: config.allowsOrientationChanges ?? true,
+    backgroundStyle,
+  };
+};
+
+const normalizeColor = (color: string | number | undefined) => {
+  if (color === undefined) return undefined;
+  const processed = processColor(color);
+  if (processed == null) throw new Error(`Invalid color value: ${color}`);
+  return processed;
+};
+
 export const getStatusForPurpose = (purposeId: string): Promise<string> => {
   return CmSdkReactNativeV3.getStatusForPurpose(purposeId);
 };
@@ -145,9 +257,31 @@ export type {
   LinkClickEvent,
   ATTStatusChangeEvent,
   UrlConfig,
+  WebViewRect,
+  WebViewBackgroundStyle,
   WebViewConfig,
   UserStatus,
   GoogleConsentModeStatus,
 };
 
+/**
+ * Helper factory to build strongly-typed background styles.
+ */
+export const BackgroundStyle = {
+  dimmed: (color?: string | number, opacity?: number): WebViewBackgroundStyle => ({
+    type: BackgroundStyleType.Dimmed,
+    color,
+    opacity,
+  }),
+  color: (color: string | number): WebViewBackgroundStyle => ({
+    type: BackgroundStyleType.Color,
+    color,
+  }),
+  blur: (blurEffectStyle: BlurEffectStyle = BlurEffectStyle.Dark): WebViewBackgroundStyle => ({
+    type: BackgroundStyleType.Blur,
+    blurEffectStyle,
+  }),
+  none: (): WebViewBackgroundStyle => ({ type: BackgroundStyleType.None }),
+} as const;
+
 export default CmSdkReactNativeV3;