fix(expo): add Kotlin metadata version check skip to config plugin

clerk-android is compiled with a newer Kotlin version than Expo/RN
ships, causing "Module was compiled with an incompatible version of
Kotlin" build failures. The config plugin now injects
-Xskip-metadata-version-check into the app's kotlinOptions block
during prebuild, matching the flag already set in the library's own
build.gradle.

Author: chriscanin

packages/expo/src/plugin/withClerkExpo.ts

@@ -3,40 +3,63 @@ import { type ConfigPlugin, createRunOncePlugin, withAppBuildGradle, withInfoPli
 import pkg from '../../package.json';
 
 /**
- * Add packaging exclusions to Android app build.gradle to resolve
- * duplicate META-INF file conflicts from clerk-android dependencies.
+ * Add packaging exclusions and Kotlin compatibility flags to Android app build.gradle.
+ *
+ * - Resolves duplicate META-INF file conflicts from clerk-android dependencies
+ * - Adds -Xskip-metadata-version-check to kotlinOptions so the app module can
+ *   consume clerk-android (compiled with a newer Kotlin version than Expo/RN ships)
  */
-const withClerkAndroidPackaging: ConfigPlugin = config => {
+const withClerkAndroidConfig: ConfigPlugin = config => {
   return withAppBuildGradle(config, modConfig => {
     let buildGradle = modConfig.modResults.contents;
 
-    // Check if exclusion already exists
-    if (buildGradle.includes('META-INF/versions/9/OSGI-INF/MANIFEST.MF')) {
-      return modConfig;
-    }
-
-    // AGP 8+ uses `packaging` DSL, older versions use `packagingOptions`
-    const packagingMatch = buildGradle.match(/packaging\s*\{/) || buildGradle.match(/packagingOptions\s*\{/);
-    if (packagingMatch) {
-      const blockName = packagingMatch[0].trim().replace(/\s*\{$/, '');
-      const resourcesExclude = `${blockName} {
+    // --- META-INF exclusion ---
+    if (!buildGradle.includes('META-INF/versions/9/OSGI-INF/MANIFEST.MF')) {
+      // AGP 8+ uses `packaging` DSL, older versions use `packagingOptions`
+      const packagingMatch = buildGradle.match(/packaging\s*\{/) || buildGradle.match(/packagingOptions\s*\{/);
+      if (packagingMatch) {
+        const blockName = packagingMatch[0].trim().replace(/\s*\{$/, '');
+        const resourcesExclude = `${blockName} {
         // Clerk Android SDK: exclude duplicate META-INF files
         resources {
             excludes += ['META-INF/versions/9/OSGI-INF/MANIFEST.MF']
         }`;
 
-      buildGradle = buildGradle.replace(new RegExp(`${blockName}\\s*\\{`), resourcesExclude);
-      modConfig.modResults.contents = buildGradle;
-    } else {
-      // No packaging block found; append one at the end of the android block
-      const androidBlockEnd = buildGradle.lastIndexOf('}');
-      if (androidBlockEnd !== -1) {
-        const packagingBlock = `\n    packaging {\n        resources {\n            excludes += ['META-INF/versions/9/OSGI-INF/MANIFEST.MF']\n        }\n    }\n`;
-        buildGradle = buildGradle.slice(0, androidBlockEnd) + packagingBlock + buildGradle.slice(androidBlockEnd);
-        modConfig.modResults.contents = buildGradle;
+        buildGradle = buildGradle.replace(new RegExp(`${blockName}\\s*\\{`), resourcesExclude);
+      } else {
+        // No packaging block found; append one at the end of the android block
+        const androidBlockEnd = buildGradle.lastIndexOf('}');
+        if (androidBlockEnd !== -1) {
+          const packagingBlock = `\n    packaging {\n        resources {\n            excludes += ['META-INF/versions/9/OSGI-INF/MANIFEST.MF']\n        }\n    }\n`;
+          buildGradle = buildGradle.slice(0, androidBlockEnd) + packagingBlock + buildGradle.slice(androidBlockEnd);
+        }
+      }
+    }
+
+    // --- Kotlin metadata version check skip ---
+    // clerk-android is compiled with a newer Kotlin than Expo/RN ships.
+    // Without this flag, the app module fails to compile with:
+    //   "Module was compiled with an incompatible version of Kotlin"
+    if (!buildGradle.includes('-Xskip-metadata-version-check')) {
+      const kotlinOptionsMatch = buildGradle.match(/kotlinOptions\s*\{/);
+      if (kotlinOptionsMatch) {
+        buildGradle = buildGradle.replace(
+          /kotlinOptions\s*\{/,
+          `kotlinOptions {\n        // Clerk: allow reading metadata from newer Kotlin versions\n        freeCompilerArgs += ['-Xskip-metadata-version-check']`,
+        );
+      } else {
+        // No kotlinOptions block; add one inside the android block
+        const androidMatch = buildGradle.match(/android\s*\{/);
+        if (androidMatch) {
+          buildGradle = buildGradle.replace(
+            /android\s*\{/,
+            `android {\n    kotlinOptions {\n        // Clerk: allow reading metadata from newer Kotlin versions\n        freeCompilerArgs += ['-Xskip-metadata-version-check']\n    }`,
+          );
+        }
       }
     }
 
+    modConfig.modResults.contents = buildGradle;
     return modConfig;
   });
 };
@@ -84,13 +107,14 @@ const withClerkGoogleSignIn: ConfigPlugin = config => {
  * When this plugin is used, it:
  * 1. Configures iOS URL scheme for Google Sign-In (if env var is set)
  * 2. Adds Android packaging exclusions to resolve dependency conflicts
+ * 3. Adds Kotlin metadata version compatibility flag for clerk-android
  *
  * Native modules are registered via react-native.config.js and standard
  * React Native autolinking (RCTViewManager / ReactPackage).
  */
 const withClerkExpo: ConfigPlugin = config => {
   config = withClerkGoogleSignIn(config);
-  config = withClerkAndroidPackaging(config);
+  config = withClerkAndroidConfig(config);
   return config;
 };