test(expo): drive the expo-native fixture from verify launch inputs

The expo-native fixture reads `verify*` launch inputs: iOS launch
arguments and Android string extras. A caller can open one screen, sign
in with a ticket, and read auth state from a footer and the log without
tapping through the app. With no `verify*` input the fixture renders as
before.

- `modules/verify-launch-config` is a local Expo module. It reads the
  inputs and clears stored Clerk state when `verifyStorageScope` changes.
- `verify/launch.ts` parses the inputs. `verify/VerifyHost.tsx` picks the
  screen, signs in with `verifySignInTicket`, and renders the state as
  one line of JSON.
- `screens/` adds the custom sign-in, custom sign-up, and token cache
  screens.
- `metro.config.js` watches the monorepo when `@clerk/expo` links to the
  workspace, so a Debug dev client serves the local package.
- On SDK 57, `app.config.js` turns on `ios.enableSceneSupport` through
  `expo-build-properties`.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

Author: mikepitre

.changeset/large-aliens-arrive.md

@@ -0,0 +1,2 @@
+---
+---

integration/templates/expo-native/App.tsx

@@ -2,14 +2,22 @@ import { ClerkProvider, useAuth, useUser } from '@clerk/expo';
 import { AuthView, UserButton, UserProfileView } from '@clerk/expo/native';
 import { tokenCache } from '@clerk/expo/token-cache';
 import { useState } from 'react';
-import { Button, Modal, StyleSheet, Text, View } from 'react-native';
+import { Button, LogBox, Modal, StyleSheet, Text, View } from 'react-native';
 
 import { BiometricAvailabilityButton } from './components/BiometricAvailabilityButton';
 import { GoogleSignInButton } from './components/GoogleSignInButton';
+import { readVerifyLaunch } from './verify/launch';
+import { logRequests, VerifyHost } from './verify/VerifyHost';
 
 const publishableKey = process.env.EXPO_PUBLIC_CLERK_PUBLISHABLE_KEY;
+const verifyLaunch = readVerifyLaunch();
 
-if (!publishableKey) {
+if (verifyLaunch) {
+  LogBox.ignoreAllLogs();
+  if (verifyLaunch.debugLogging) {
+    logRequests();
+  }
+} else if (!publishableKey) {
   throw new Error('Missing EXPO_PUBLIC_CLERK_PUBLISHABLE_KEY');
 }
 
@@ -111,6 +119,15 @@ function NativeBuildFixture() {
 }
 
 export default function App() {
+  if (verifyLaunch) {
+    return (
+      <VerifyHost
+        launch={verifyLaunch}
+        home={<NativeBuildFixture />}
+      />
+    );
+  }
+
   return (
     <ClerkProvider
       publishableKey={publishableKey}

integration/templates/expo-native/app.config.js

@@ -0,0 +1,6 @@
+const { version: expoVersion } = require('expo/package.json');
+
+module.exports = ({ config }) =>
+  expoVersion.startsWith('57.')
+    ? { ...config, plugins: [...config.plugins, ['expo-build-properties', { ios: { enableSceneSupport: true } }]] }
+    : config;

integration/templates/expo-native/metro.config.js

@@ -0,0 +1,37 @@
+const fs = require('node:fs');
+const path = require('node:path');
+const { getDefaultConfig } = require('expo/metro-config');
+const { dependencies, devDependencies } = require('./package.json');
+
+const config = getDefaultConfig(__dirname);
+const monorepoRoot = path.resolve(__dirname, '../../..');
+const fixtureEntry = path.join(__dirname, 'index.js');
+const fixturePackages = new Set(Object.keys({ ...dependencies, ...devDependencies }));
+
+function linksToWorkspace() {
+  try {
+    return (
+      fs.realpathSync(path.join(__dirname, 'node_modules/@clerk/expo')) === path.join(monorepoRoot, 'packages/expo')
+    );
+  } catch {
+    return false;
+  }
+}
+
+function packageName(moduleName) {
+  const [scope, name] = moduleName.split('/');
+  return scope.startsWith('@') ? `${scope}/${name}` : scope;
+}
+
+if (linksToWorkspace()) {
+  config.watchFolders = [monorepoRoot];
+  config.resolver.resolveRequest = (context, moduleName, platform) => {
+    const fromWorkspace = !context.originModulePath.startsWith(__dirname + path.sep);
+    if (fromWorkspace && fixturePackages.has(packageName(moduleName))) {
+      return context.resolveRequest({ ...context, originModulePath: fixtureEntry }, moduleName, platform);
+    }
+    return context.resolveRequest(context, moduleName, platform);
+  };
+}
+
+module.exports = config;

integration/templates/expo-native/modules/verify-launch-config/android/build.gradle

@@ -0,0 +1,15 @@
+plugins {
+  id 'com.android.library'
+  id 'expo-module-gradle-plugin'
+}
+
+group = 'expo.modules.verifylaunchconfig'
+version = '1.0.0'
+
+android {
+  namespace "expo.modules.verifylaunchconfig"
+  defaultConfig {
+    versionCode 1
+    versionName "1.0.0"
+  }
+}

integration/templates/expo-native/modules/verify-launch-config/android/src/main/AndroidManifest.xml

@@ -0,0 +1,2 @@
+<manifest>
+</manifest>

integration/templates/expo-native/modules/verify-launch-config/android/src/main/java/expo/modules/verifylaunchconfig/VerifyLaunchConfigModule.kt

@@ -0,0 +1,34 @@
+package expo.modules.verifylaunchconfig
+
+import android.content.Context
+import expo.modules.kotlin.modules.Module
+import expo.modules.kotlin.modules.ModuleDefinition
+
+private const val PREFERENCES = "verify_launch_config"
+private const val STORAGE_SCOPE_KEY = "storageScope"
+private val CLERK_STORAGE = listOf("clerk_preferences", "SecureStore")
+
+class VerifyLaunchConfigModule : Module() {
+  override fun definition() = ModuleDefinition {
+    Name("VerifyLaunchConfig")
+
+    Function("readLaunchInputs") {
+      val extras = appContext.currentActivity?.intent?.extras ?: return@Function emptyMap<String, String>()
+      extras.keySet()
+        .filter { it.startsWith("verify") }
+        .mapNotNull { key -> extras.getString(key)?.let { key to it } }
+        .toMap()
+    }
+
+    Function("applyStorageScope") { scope: String ->
+      val context = appContext.reactContext ?: return@Function
+      val preferences = context.getSharedPreferences(PREFERENCES, Context.MODE_PRIVATE)
+      if (preferences.getString(STORAGE_SCOPE_KEY, null) == scope) {
+        return@Function
+      }
+
+      CLERK_STORAGE.forEach { context.deleteSharedPreferences(it) }
+      preferences.edit().putString(STORAGE_SCOPE_KEY, scope).commit()
+    }
+  }
+}

integration/templates/expo-native/modules/verify-launch-config/expo-module.config.json

@@ -0,0 +1,9 @@
+{
+  "platforms": ["apple", "android"],
+  "apple": {
+    "modules": ["VerifyLaunchConfigModule"]
+  },
+  "android": {
+    "modules": ["expo.modules.verifylaunchconfig.VerifyLaunchConfigModule"]
+  }
+}

integration/templates/expo-native/modules/verify-launch-config/index.ts

@@ -0,0 +1,8 @@
+import { requireOptionalNativeModule } from 'expo';
+
+type VerifyLaunchConfigModule = {
+  readLaunchInputs(): Record<string, string>;
+  applyStorageScope(scope: string): void;
+};
+
+export const VerifyLaunchConfig = requireOptionalNativeModule<VerifyLaunchConfigModule>('VerifyLaunchConfig');

integration/templates/expo-native/modules/verify-launch-config/ios/VerifyLaunchConfig.podspec

@@ -0,0 +1,18 @@
+Pod::Spec.new do |s|
+  s.name           = 'VerifyLaunchConfig'
+  s.version        = '1.0.0'
+  s.summary        = 'Reads verify launch inputs for the Expo native fixture'
+  s.author         = ''
+  s.homepage       = 'https://github.com/clerk/javascript'
+  s.platforms      = { :ios => '15.1' }
+  s.source         = { git: '' }
+  s.static_framework = true
+
+  s.dependency 'ExpoModulesCore'
+
+  s.pod_target_xcconfig = {
+    'DEFINES_MODULE' => 'YES',
+  }
+
+  s.source_files = "**/*.swift"
+end