customerio-expo-plugin 2.5.0 → 2.7.0

package/plugin/lib/typescript/helpers/utils/patchPluginNativeCode.d.ts

@@ -0,0 +1,7 @@
+import type { NativeSDKConfig } from '../../types/cio-types';
+import { type Platform } from '../constants/common';
+/**
+ * Shared utility function to perform common SDK config replacements
+ * for both iOS and Android template files
+ */
+export declare function patchNativeSDKInitializer(rawContent: string, platform: Platform, sdkConfig: NativeSDKConfig): string;

package/plugin/lib/typescript/ios/utils.d.ts

@@ -1,7 +1,7 @@
-import type { CustomerIOPluginOptionsIOS } from '../types/cio-types';
 import type { ExpoConfig } from '@expo/config-types';
+import type { CustomerIOPluginOptionsIOS } from '../types/cio-types';
 /**
- * Returns t
+ * Returns true if FCM is configured to be used as push provider
  * @param iosOptions The plugin iOS configuration options
  * @returns true if FCM is configured to be used as push provider
  */

package/plugin/lib/typescript/ios/withCIOIos.d.ts

@@ -1,3 +1,3 @@
 import type { ExpoConfig } from '@expo/config-types';
-import type { CustomerIOPluginOptionsIOS } from '../types/cio-types';
-export declare function withCIOIos(config: ExpoConfig, props: CustomerIOPluginOptionsIOS): ExpoConfig;
+import type { CustomerIOPluginOptionsIOS, NativeSDKConfig } from '../types/cio-types';
+export declare function withCIOIos(config: ExpoConfig, sdkConfig: NativeSDKConfig | undefined, props: CustomerIOPluginOptionsIOS): ExpoConfig;

package/plugin/lib/typescript/ios/withCIOIosSwift.d.ts

@@ -1,3 +1,3 @@
-import type { ConfigPlugin } from '@expo/config-plugins';
-import type { CustomerIOPluginOptionsIOS } from '../types/cio-types';
-export declare const withCIOIosSwift: ConfigPlugin<CustomerIOPluginOptionsIOS>;
+import type { ExpoConfig } from '@expo/config-types';
+import type { CustomerIOPluginOptionsIOS, NativeSDKConfig } from '../types/cio-types';
+export declare const withCIOIosSwift: (configOuter: ExpoConfig, sdkConfig: NativeSDKConfig | undefined, props: CustomerIOPluginOptionsIOS) => ExpoConfig;

package/plugin/lib/typescript/types/cio-types.d.ts

@@ -1,7 +1,15 @@
+/**
+ * Properties set by the user in their app config file (e.g: app.json or app.plugin.js)
+ * @public
+ */
 export type CustomerIOPluginProperties = {
     devTeam: string;
     iosDeploymentTarget: string;
 };
+/**
+ * Plugin options for iOS platform configuration
+ * @public
+ */
 export type CustomerIOPluginOptionsIOS = {
     iosPath: string;
     devTeam?: string;
@@ -38,6 +46,10 @@ export type CustomerIOPluginOptionsIOS = {
      */
     disableNotificationRegistration?: boolean;
 };
+/**
+ * Plugin options for Android platform configuration
+ * @public
+ */
 export type CustomerIOPluginOptionsAndroid = {
     androidPath: string;
     googleServicesFile?: string;
@@ -50,10 +62,41 @@ export type CustomerIOPluginOptionsAndroid = {
         };
     };
 };
+/**
+ * SDK configuration options for auto initialization
+ * @public
+ */
+export type NativeSDKConfig = {
+    cdpApiKey: string;
+    region?: 'US' | 'EU';
+    autoTrackDeviceAttributes?: boolean;
+    trackApplicationLifecycleEvents?: boolean;
+    screenViewUse?: 'all' | 'inapp';
+    logLevel?: 'none' | 'error' | 'info' | 'debug';
+    siteId?: string;
+    migrationSiteId?: string;
+};
+/**
+ * Combined plugin options for both iOS and Android platforms
+ * @public
+ */
 export type CustomerIOPluginOptions = {
+    config?: NativeSDKConfig;
     android: CustomerIOPluginOptionsAndroid;
     ios: CustomerIOPluginOptionsIOS;
 };
+/**
+ * Rich push configuration used to initialize Notification Service Extension (NSE) on the native side
+ * @public
+ */
+export type RichPushConfig = {
+    cdpApiKey: string;
+    region?: string;
+};
+/**
+ * Push notification configuration options
+ * @public
+ */
 export type CustomerIOPluginPushNotificationOptions = {
     provider?: 'apn' | 'fcm';
     googleServicesFile?: string;
@@ -64,11 +107,8 @@ export type CustomerIOPluginPushNotificationOptions = {
     disableNotificationRegistration?: boolean;
     handleDeeplinkInKilledState?: boolean;
     /**
-     * These values will be used to initialize the Notification Service Extension (NSE) on the native side.
-     * They should match the values you use to initialize the SDK in your app
+     * Rich push config should match the values used to initialize SDK in the app.
+     * Optional if `config` is provided at the top level.
      */
-    env: {
-        cdpApiKey: string;
-        region: string;
-    };
+    env?: RichPushConfig;
 };

package/plugin/lib/typescript/utils/android.d.ts

@@ -0,0 +1,5 @@
+import type { ExportedConfigWithProps } from '@expo/config-plugins';
+import type { ApplicationProjectFile } from '@expo/config-plugins/build/android/Paths';
+export declare const addImportToFile: (content: string, importStatement: string) => string;
+export declare const addCodeToMethod: (content: string, methodRegex: RegExp, codeToAdd: string) => string;
+export declare const copyTemplateFile: (expoConfig: ExportedConfigWithProps<ApplicationProjectFile>, filename: string, classPackage: string, patchContent: (content: string) => string) => void;

package/plugin/lib/typescript/utils/config.d.ts

@@ -0,0 +1,8 @@
+import type { CustomerIOPluginOptionsIOS, NativeSDKConfig, RichPushConfig } from '../types/cio-types';
+/**
+ * Merges config values with env values for backward compatibility.
+ * If env is provided, it takes precedence. If nativeConfig is provided but env is not,
+ * nativeConfig values are used. This prioritizes existing env configuration for backward compatibility.
+ */
+declare function mergeConfigWithEnvValues(props: CustomerIOPluginOptionsIOS, nativeConfig?: NativeSDKConfig): RichPushConfig | undefined;
+export { mergeConfigWithEnvValues };

package/plugin/lib/typescript/utils/plugin.d.ts

@@ -0,0 +1,4 @@
+export declare const getNativeFilesPath: () => string;
+export declare const getAndroidNativeFilesPath: () => string;
+export declare const getIosNativeFilesPath: () => string;
+export declare const getPluginVersion: () => string;

package/plugin/lib/typescript/utils/validation.d.ts

@@ -0,0 +1,3 @@
+import type { NativeSDKConfig } from '../types/cio-types';
+declare function validateNativeSDKConfig(config: NativeSDKConfig): void;
+export { validateNativeSDKConfig };

package/plugin/lib/typescript/utils/xcode.d.ts

@@ -0,0 +1,28 @@
+import type { XcodeProject } from "@expo/config-plugins";
+/**
+ * Gets an existing CustomerIO group or creates a new one in the Xcode project
+ * @param xcodeProject The Xcode project instance
+ * @param projectName The iOS project name
+ * @returns The CustomerIO group reference
+ */
+export declare function getOrCreateCustomerIOGroup(xcodeProject: XcodeProject, projectName: string): XcodeProject['pbxCreateGroup'];
+/**
+ * Copies template file to iOS project, applies transformations, and registers with Xcode
+ * @param params.xcodeProject Xcode project instance
+ * @param params.iosProjectRoot iOS project root path
+ * @param params.projectName iOS project name
+ * @param params.sourceFilePath Source template file path
+ * @param params.targetFileName Target file name
+ * @param params.transform Content transformation function
+ * @param params.customerIOGroup CustomerIO group (auto-created if not provided)
+ * @returns Destination file path
+ */
+export declare function copyFileToXcode({ xcodeProject, iosProjectRoot, projectName, sourceFilePath, targetFileName, transform, customerIOGroup, }: {
+    xcodeProject: XcodeProject;
+    iosProjectRoot: string;
+    projectName: string;
+    sourceFilePath: string;
+    targetFileName: string;
+    transform: (content: string) => string;
+    customerIOGroup?: XcodeProject['pbxCreateGroup'];
+}): string;

package/plugin/src/android/withAndroidManifestUpdates.ts

@@ -4,44 +4,93 @@ import type { ManifestApplication } from '@expo/config-plugins/build/android/Man
 
 import type { CustomerIOPluginOptionsAndroid } from '../types/cio-types';
 
+// Default low priority for Firebase messaging service when setHighPriorityPushHandler is false
+export const DEFAULT_LOW_PRIORITY = -10;
+
+
 export const withAndroidManifestUpdates: ConfigPlugin<
   CustomerIOPluginOptionsAndroid
-> = (configOuter) => {
+> = (configOuter, options) => {
   return withAndroidManifest(configOuter, (props) => {
     const application = props.modResults.manifest
       .application as ManifestApplication[];
     const customerIOMessagingpush =
       'io.customer.messagingpush.CustomerIOFirebaseMessagingService';
 
-    if (!application[0]['service']) {
-      application[0]['service'] = [];
+    if (!application[0].service) {
+      application[0].service = [];
     }
 
-    const hasService = application[0]['service'].some(
-      (service) => service['$']['android:name'] === customerIOMessagingpush
+    const existingServiceIndex = application[0].service.findIndex(
+      (service) => service.$['android:name'] === customerIOMessagingpush
     );
 
-    if (!hasService) {
-      application[0]['service'].push({
+    if (existingServiceIndex === -1) {
+      // Intent filter structure for Firebase messaging service
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      const intentFilter: any = {
+        action: [
+          {
+            $: {
+              'android:name': 'com.google.firebase.MESSAGING_EVENT',
+            },
+          },
+        ],
+      };
+
+      // Handle priority based on setHighPriorityPushHandler value
+      if (options.setHighPriorityPushHandler === true) {
+        // High priority - no priority attribute means default high priority
+        console.log(
+          'Successfully set CustomerIO push handler as high priority in AndroidManifest.xml'
+        );
+      } else if (options.setHighPriorityPushHandler === false) {
+        // Low priority - set fixed priority
+        intentFilter.$ = {
+          'android:priority': DEFAULT_LOW_PRIORITY.toString(),
+        };
+        console.log(
+          `Successfully set CustomerIO push handler as low priority (${DEFAULT_LOW_PRIORITY}) in AndroidManifest.xml`
+        );
+      }
+
+      application[0].service.push({
         '$': {
           'android:name': customerIOMessagingpush,
           'android:exported': 'false',
         },
-        'intent-filter': [
-          {
-            action: [
-              {
-                $: {
-                  'android:name': 'com.google.firebase.MESSAGING_EVENT',
-                },
-              },
-            ],
-          },
-        ],
+        'intent-filter': [intentFilter],
       });
-      console.log(
-        'Successfully set CustomerIO push handler as priority in AndroidManifest.xml'
-      );
+    } else if (options.setHighPriorityPushHandler === true) {
+      // Service exists, need to ensure it becomes high priority (remove priority attribute)
+      const existingService = application[0].service[existingServiceIndex];
+
+      if (existingService['intent-filter'] && existingService['intent-filter'].length > 0) {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const intentFilter = existingService['intent-filter'][0] as any;
+        if (intentFilter.$ && intentFilter.$['android:priority']) {
+          delete intentFilter.$['android:priority'];
+          console.log(
+            'Successfully updated existing CustomerIO push handler to high priority in AndroidManifest.xml'
+          );
+        }
+      }
+    } else if (options.setHighPriorityPushHandler === false) {
+      // Service exists, update to low priority
+      const existingService = application[0].service[existingServiceIndex];
+
+      // Update existing service intent-filter with fixed priority
+      if (existingService['intent-filter'] && existingService['intent-filter'].length > 0) {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const intentFilter = existingService['intent-filter'][0] as any;
+        if (!intentFilter.$) {
+          intentFilter.$ = {};
+        }
+        intentFilter.$['android:priority'] = DEFAULT_LOW_PRIORITY.toString();
+        console.log(
+          `Successfully updated existing CustomerIO push handler to low priority (${DEFAULT_LOW_PRIORITY}) in AndroidManifest.xml`
+        );
+      }
     }
 
     props.modResults.manifest.application = application;

package/plugin/src/android/withCIOAndroid.ts

@@ -1,16 +1,18 @@
 import type { ExpoConfig } from '@expo/config-types';
 
-import type { CustomerIOPluginOptionsAndroid } from '../types/cio-types';
+import type { CustomerIOPluginOptionsAndroid, NativeSDKConfig } from '../types/cio-types';
 import { withAndroidManifestUpdates } from './withAndroidManifestUpdates';
 import { withAppGoogleServices } from './withAppGoogleServices';
 import { withGistMavenRepository } from './withGistMavenRepository';
 import { withGoogleServicesJSON } from './withGoogleServicesJSON';
+import { withMainApplicationModifications } from './withMainApplicationModifications';
 import { withNotificationChannelMetadata } from './withNotificationChannelMetadata';
 import { withProjectGoogleServices } from './withProjectGoogleServices';
 import { withProjectStrings } from './withProjectStrings';
 
 export function withCIOAndroid(
   config: ExpoConfig,
+  sdkConfig: NativeSDKConfig | undefined,
   props: CustomerIOPluginOptionsAndroid
 ): ExpoConfig {
   config = withGistMavenRepository(config, props);
@@ -18,12 +20,16 @@ export function withCIOAndroid(
   config = withAppGoogleServices(config, props);
   config = withGoogleServicesJSON(config, props);
   config = withProjectStrings(config);
-  if (props.setHighPriorityPushHandler) {
+  if (props.setHighPriorityPushHandler !== undefined) {
     config = withAndroidManifestUpdates(config, props);
   }
   if (props.pushNotification?.channel) {
     config = withNotificationChannelMetadata(config, props);
   }
+  // Add auto initialization if sdkConfig is provided
+  if (sdkConfig) {
+    config = withMainApplicationModifications(config, sdkConfig);
+  }
 
   return config;
 }

package/plugin/src/android/withGoogleServicesJSON.ts

@@ -1,5 +1,5 @@
-import { withProjectBuildGradle } from '@expo/config-plugins';
 import type { ConfigPlugin } from '@expo/config-plugins';
+import { withProjectBuildGradle } from '@expo/config-plugins';
 
 import { FileManagement } from './../helpers/utils/fileManagement';
 import type { CustomerIOPluginOptionsAndroid } from './../types/cio-types';
@@ -20,7 +20,7 @@ export const withGoogleServicesJSON: ConfigPlugin<
             googleServicesFile,
             `${androidPath}/app/google-services.json`
           );
-        } catch (e) {
+        } catch {
           console.log(
             `There was an error copying your google-services.json file. You can copy it manually into ${androidPath}/app/google-services.json`
           );

package/plugin/src/android/withMainApplicationModifications.ts

@@ -0,0 +1,50 @@
+import type { ConfigPlugin, ExportedConfigWithProps } from '@expo/config-plugins';
+import { withMainApplication } from '@expo/config-plugins';
+import type { ApplicationProjectFile } from '@expo/config-plugins/build/android/Paths';
+import { CIO_MAINAPPLICATION_ONCREATE_REGEX, CIO_NATIVE_SDK_INITIALIZE_CALL, CIO_NATIVE_SDK_INITIALIZE_SNIPPET } from '../helpers/constants/android';
+import { PLATFORM } from '../helpers/constants/common';
+import { patchNativeSDKInitializer } from '../helpers/utils/patchPluginNativeCode';
+import type { NativeSDKConfig } from '../types/cio-types';
+import { addCodeToMethod, addImportToFile, copyTemplateFile } from '../utils/android';
+
+export const withMainApplicationModifications: ConfigPlugin<NativeSDKConfig> = (configOuter, sdkConfig) => {
+  return withMainApplication(configOuter, async (config) => {
+    const content = setupCustomerIOSDKInitializer(config, sdkConfig);
+    config.modResults.contents = content;
+    return config;
+  });
+};
+
+/**
+ * Setup CustomerIOSDKInitializer for Android auto initialization
+ */
+const setupCustomerIOSDKInitializer = (
+  config: ExportedConfigWithProps<ApplicationProjectFile>,
+  sdkConfig: NativeSDKConfig,
+): string => {
+  const SDK_INITIALIZER_CLASS = 'CustomerIOSDKInitializer';
+  const SDK_INITIALIZER_PACKAGE = 'io.customer.sdk.expo';
+
+  const SDK_INITIALIZER_FILE = `${SDK_INITIALIZER_CLASS}.kt`;
+  const SDK_INITIALIZER_IMPORT = `import ${SDK_INITIALIZER_PACKAGE}.${SDK_INITIALIZER_CLASS}`;
+
+  let content = config.modResults.contents;
+
+  try {
+    // Always regenerate the CustomerIOSDKInitializer file to reflect config changes
+    copyTemplateFile(config, SDK_INITIALIZER_FILE, SDK_INITIALIZER_PACKAGE, (content) =>
+      patchNativeSDKInitializer(content, PLATFORM.ANDROID, sdkConfig)
+    );
+    // Add import if not already present
+    content = addImportToFile(content, SDK_INITIALIZER_IMPORT);
+    // Add initialization code to onCreate if not already present
+    if (!content.includes(CIO_NATIVE_SDK_INITIALIZE_CALL)) {
+      content = addCodeToMethod(content, CIO_MAINAPPLICATION_ONCREATE_REGEX, CIO_NATIVE_SDK_INITIALIZE_SNIPPET);
+    }
+  } catch (error) {
+    console.warn(`Could not setup ${SDK_INITIALIZER_CLASS}:`, error);
+    return config.modResults.contents;
+  }
+
+  return content;
+};

package/plugin/src/android/withNotificationChannelMetadata.ts

@@ -19,7 +19,7 @@ const addMetadataIfNotExists = (
 
   // Check if metadata already exists
   const hasMetadata = application['meta-data'].some(
-    (metadata) => metadata['$']['android:name'] === name
+    (metadata) => metadata.$['android:name'] === name
   );
 
   // Add metadata if it doesn't exist
@@ -37,11 +37,15 @@ export const withNotificationChannelMetadata: ConfigPlugin<
   CustomerIOPluginOptionsAndroid
 > = (config, props) => {
   return withAndroidManifest(config, (manifestProps) => {
-    const application = manifestProps.modResults.manifest.application as ManifestApplication[];
+    const application = manifestProps.modResults.manifest
+      .application as ManifestApplication[];
     const channel = props.pushNotification?.channel;
 
     // Only proceed if channel configuration exists
-    if (channel && (channel.id || channel.name || channel.importance !== undefined)) {
+    if (
+      channel &&
+      (channel.id || channel.name || channel.importance !== undefined)
+    ) {
       if (channel.id) {
         addMetadataIfNotExists(
           application[0],

package/plugin/src/android/withProjectStrings.ts

@@ -1,12 +1,13 @@
 import type { ConfigPlugin } from '@expo/config-plugins';
 import { withStringsXml } from '@expo/config-plugins';
-import { getPluginVersion } from '../helpers/utils/pluginUtils';
+import type { ResourceXML } from '@expo/config-plugins/build/android/Resources';
+import { getPluginVersion } from '../utils/plugin';
 
 /**
  * Adds or updates string resources in Android's strings.xml required by the plugin
  */
-export const withProjectStrings: ConfigPlugin = (config) => {
-  return withStringsXml(config, (config) => {
+export const withProjectStrings: ConfigPlugin = (configOuter) => {
+  return withStringsXml(configOuter, (config) => {
     const stringsXml = config.modResults;
     const pluginVersion = getPluginVersion();
 
@@ -17,7 +18,10 @@ export const withProjectStrings: ConfigPlugin = (config) => {
     // can be generated correctly for Expo apps
     addStringsToXml(stringsXml, [
       { name: 'customer_io_react_native_sdk_client_source', value: 'Expo' },
-      { name: 'customer_io_react_native_sdk_client_version', value: pluginVersion },
+      {
+        name: 'customer_io_react_native_sdk_client_version',
+        value: pluginVersion,
+      },
     ]);
 
     return config;
@@ -31,25 +35,31 @@ export const withProjectStrings: ConfigPlugin = (config) => {
  * @returns Updated strings.xml object
  */
 export function addStringsToXml(
-  stringsXml: any,
-  stringResources: { name: string, value: string }[]
+  stringsXml: ResourceXML,
+  stringResources: { name: string; value: string }[]
 ) {
   // Ensure the resource exists
   if (!stringsXml.resources) {
     stringsXml.resources = { string: [] };
   }
+  // Ensure the string array exists
+  if (!stringsXml.resources.string) {
+    stringsXml.resources.string = [];
+  }
 
+  // Get a reference to the string array after ensuring it exists
+  const stringArray = stringsXml.resources.string;
   stringResources.forEach(({ name, value }) => {
-    const existingStringIndex = stringsXml.resources.string.findIndex(
-      (item: { $: { name: string } }) => item.$?.name === name
+    const existingStringIndex = stringArray.findIndex(
+      (item) => item.$?.name === name
     );
 
     if (existingStringIndex !== -1) {
       // Update the existing string
-      stringsXml.resources.string[existingStringIndex]._ = value;
+      stringArray[existingStringIndex]._ = value;
     } else {
       // Add a new string resource
-      stringsXml.resources.string.push({
+      stringArray.push({
         $: { name },
         _: value,
       });

package/plugin/src/helpers/constants/android.ts

@@ -12,3 +12,10 @@ export const CIO_APP_GOOGLE_SNIPPET =
   'apply plugin: "com.google.gms.google-services"  // Google Services plugin';
 export const CIO_PROJECT_GOOGLE_SNIPPET =
   '        classpath "com.google.gms:google-services:4.3.13"  // Google Services plugin';
+
+export const CIO_MAINAPPLICATION_ONCREATE_REGEX = /override\s+fun\s+onCreate\s*\(\s*\)\s*\{[\s\S]*?\}/;
+// Actual method call, also used to detect if Customer.io auto initialization is already present
+export const CIO_NATIVE_SDK_INITIALIZE_CALL = 'CustomerIOSDKInitializer.initialize(this)';
+// Complete code snippet to inject into MainActivity.onCreate()
+export const CIO_NATIVE_SDK_INITIALIZE_SNIPPET = `// Auto Initialize Native Customer.io SDK
+    ${CIO_NATIVE_SDK_INITIALIZE_CALL}`;

package/plugin/src/helpers/constants/common.ts

@@ -0,0 +1,12 @@
+/**
+ * Platform constants for native SDK initialization
+ */
+export const PLATFORM = {
+  IOS: 'ios',
+  ANDROID: 'android',
+} as const;
+
+/**
+ * Platform type definition
+ */
+export type Platform = typeof PLATFORM[keyof typeof PLATFORM];

package/plugin/src/helpers/constants/ios.ts

@@ -1,23 +1,15 @@
-const finder = require('find-package-json');
 const path = require('path');
 const resolveFrom = require('resolve-from');
 
-const f = finder(__dirname);
-let pluginPackageRoot = f.next().filename;
-// This is the path to the root of the customerio-expo-plugin package
-pluginPackageRoot = path.dirname(pluginPackageRoot);
-
-export const LOCAL_PATH_TO_CIO_NSE_FILES = path.join(
-  pluginPackageRoot,
-  'plugin/src/helpers/native-files/ios'
-);
-
 export function getRelativePathToRNSDK(iosPath: string) {
   // Root path of the Expo project
   const rootAppPath = path.dirname(iosPath);
 
   // Path of the cio RN package.json file. Example: test-app/node_modules/customerio-reactnative/package.json
-  const pluginPackageJsonPath = resolveFrom.silent(rootAppPath, `customerio-reactnative/package.json`);
+  const pluginPackageJsonPath = resolveFrom.silent(
+    rootAppPath,
+    `customerio-reactnative/package.json`
+  );
 
   // Example: ../node_modules/customerio-reactnative
   return path.relative(iosPath, path.dirname(pluginPackageJsonPath));
@@ -170,4 +162,10 @@ export const CIO_REGISTER_PUSHNOTIFICATION_SNIPPET_v2 = `
       }
     }`;
 
-export const CIO_REGISTER_PUSH_NOTIFICATION_PLACEHOLDER = /\{\{REGISTER_SNIPPET\}\}/;
+export const CIO_REGISTER_PUSH_NOTIFICATION_PLACEHOLDER = /\{\{REGISTER_SNIPPET\}\}/;
+// Regex to match MessagingPush initialization in AppDelegate (different from NSE initialization)
+export const CIO_MESSAGING_PUSH_APP_DELEGATE_INIT_REGEX = /(MessagingPush(?:APN|FCM)\.initialize)/;
+export const CIO_NATIVE_SDK_INITIALIZE_CALL = 'CustomerIOSDKInitializer.initialize()';
+export const CIO_NATIVE_SDK_INITIALIZE_SNIPPET = `// Auto Initialize Native Customer.io SDK
+    ${CIO_NATIVE_SDK_INITIALIZE_CALL}
+    `;

package/plugin/src/helpers/native-files/android/CustomerIOSDKInitializer.kt

@@ -0,0 +1,64 @@
+package io.customer.sdk.expo
+
+import android.app.Application
+import io.customer.datapipelines.config.ScreenView
+import io.customer.messaginginapp.MessagingInAppModuleConfig
+import io.customer.messaginginapp.ModuleMessagingInApp
+import io.customer.messagingpush.MessagingPushModuleConfig
+import io.customer.messagingpush.ModuleMessagingPushFCM
+import io.customer.reactnative.sdk.messaginginapp.ReactInAppEventListener
+import io.customer.sdk.CustomerIOBuilder
+import io.customer.sdk.core.util.CioLogLevel
+import io.customer.sdk.data.model.Region
+
+object CustomerIOSDKInitializer {
+    fun initialize(application: Application) = with(
+        CustomerIOBuilder(application, "{{CDP_API_KEY}}")
+    ) {
+        val siteId: String? = {{SITE_ID}}
+        val migrationSiteId: String? = {{MIGRATION_SITE_ID}}
+        val region = Region.getRegion({{REGION}})
+
+        setIfDefined({{LOG_LEVEL}}, CustomerIOBuilder::logLevel) { CioLogLevel.getLogLevel(it) }
+        setIfDefined(region, CustomerIOBuilder::region)
+        setIfDefined({{AUTO_TRACK_DEVICE_ATTRIBUTES}}, CustomerIOBuilder::autoTrackDeviceAttributes)
+        setIfDefined({{TRACK_APPLICATION_LIFECYCLE_EVENTS}}, CustomerIOBuilder::trackApplicationLifecycleEvents)
+        setIfDefined({{SCREEN_VIEW_USE}}, CustomerIOBuilder::screenViewUse) { ScreenView.getScreenView(it) }
+        setIfDefined(migrationSiteId, CustomerIOBuilder::migrationSiteId)
+
+        // Add messaging modules if siteId is provided
+        if (!(siteId.isNullOrBlank())) {
+            addCustomerIOModule(
+                ModuleMessagingInApp(
+                    MessagingInAppModuleConfig.Builder(siteId, region)
+                        .setEventListener(ReactInAppEventListener())
+                        .build()
+                )
+            )
+        }
+        addCustomerIOModule(
+            ModuleMessagingPushFCM(
+                MessagingPushModuleConfig.Builder().build()
+            )
+        )
+
+        build()
+    }
+}
+
+// Apply a value after transforming it, only if both the original and transformed values are non-nil
+private inline fun <R, T> CustomerIOBuilder.setIfDefined(
+    value: R?,
+    block: CustomerIOBuilder.(T) -> CustomerIOBuilder,
+    transform: (R) -> T,
+): CustomerIOBuilder = value?.let { block(transform(it)) } ?: this
+
+// Apply a value to a setter only if it's non-nil
+private inline fun <T> CustomerIOBuilder.setIfDefined(
+    value: T?,
+    block: CustomerIOBuilder.(T) -> CustomerIOBuilder,
+): CustomerIOBuilder = setIfDefined(
+    value = value,
+    block = block,
+    transform = { it },
+)