validate api key

Author: jasonpraful

README.md

@@ -757,6 +757,8 @@ Sets the user hash necessary for validation when Identity Verification is enable
 
 Initialize the Intercom SDK manually. This is useful when you want to delay initialization until after your app has started, or when using Expo with the `useManualInit` plugin option.
 
+**Important:** This method configures the SDK but does NOT validate your credentials with Intercom's servers. Invalid API keys or App IDs will only be detected when you attempt to use Intercom features (e.g., login, show messenger). The method will return `true` if the SDK is successfully configured, regardless of credential validity.
+
 ### Options
 
 | Name   | Type   | Required | Description                             |

android/src/newarch/IntercomModule.java

@@ -630,7 +630,7 @@ public void onFailure(@NonNull IntercomError intercomError) {
   public void initialize(String apiKey, String appId, Promise promise) {
     try {
       Activity activity = getCurrentActivity();
-      if (activity != null) {
+      if (activity != null && activity.getApplication() != null) {
         IntercomModule.initialize(activity.getApplication(), apiKey, appId);
         promise.resolve(true);
       } else {

android/src/oldarch/IntercomModule.java

@@ -607,7 +607,7 @@ public void onFailure(@NonNull IntercomError intercomError) {
   public void initialize(String apiKey, String appId, Promise promise) {
     try {
       Activity activity = getCurrentActivity();
-      if (activity != null) {
+      if (activity != null && activity.getApplication() != null) {
         IntercomModule.initialize(activity.getApplication(), apiKey, appId);
         promise.resolve(true);
       } else {

examples/expo-example/app/(tabs)/index.tsx

@@ -47,6 +47,7 @@ export default function App() {
             INTERCOM_CONFIG.appId
           );
           setIsInitialized(true);
+          setInitError(null);
           console.log('Intercom initialized successfully');
         }
       } catch (error) {

src/index.tsx

@@ -323,7 +323,50 @@ export type IntercomType = {
 };
 
 const Intercom: IntercomType = {
-  initialize: (apiKey, appId) => IntercomModule.initialize(apiKey, appId),
+  initialize: (apiKey, appId) => {
+    if (!apiKey || typeof apiKey !== 'string') {
+      return Promise.reject(
+        new Error('Intercom: apiKey is required and must be a string')
+      );
+    }
+
+    const isIOS = Platform.OS === 'ios';
+    const isAndroid = Platform.OS === 'android';
+
+    if (isIOS) {
+      if (!apiKey.startsWith('ios_sdk-')) {
+        return Promise.reject(
+          new Error('Intercom: iOS API key must start with "ios_sdk-"')
+        );
+      }
+      if (apiKey.length < 48) {
+        return Promise.reject(
+          new Error('Intercom: iOS API key must be at least 48 characters long')
+        );
+      }
+    } else if (isAndroid) {
+      if (!apiKey.startsWith('android_sdk-')) {
+        return Promise.reject(
+          new Error('Intercom: Android API key must start with "android_sdk-"')
+        );
+      }
+      if (apiKey.length < 52) {
+        return Promise.reject(
+          new Error(
+            'Intercom: Android API key must be at least 52 characters long'
+          )
+        );
+      }
+    }
+
+    if (!appId || typeof appId !== 'string' || appId.trim() === '') {
+      return Promise.reject(
+        new Error('Intercom: appId is required and must be a non-empty string')
+      );
+    }
+
+    return IntercomModule.initialize(apiKey, appId);
+  },
   loginUnidentifiedUser: () => IntercomModule.loginUnidentifiedUser(),
   loginUserWithUserAttributes: (userAttributes) =>
     IntercomModule.loginUserWithUserAttributes(userAttributes),