fix: align Expo preview navigation spec with Android consumer delegate

Author: artus9033

apps/ExpoApp57/brownfield.navigation.ts

@@ -22,4 +22,14 @@ export interface BrownfieldNavigationSpec {
    * @param userId - The user's unique identifier
    */
   navigateToReferrals(userId: string): void;
+
+  /**
+   * Ask the native host to confirm an action. Resolves with the user's choice.
+   */
+  requestNativeConfirmation(title: string): Promise<boolean>;
+
+  /**
+   * Show a native banner. The native host calls onDismiss when the banner is dismissed.
+   */
+  showNativeBanner(message: string, onDismiss: () => void): void;
 }

scripts/__tests__/check-expo-preview.test.ts

@@ -2,6 +2,7 @@ import assert from 'node:assert/strict';
 import test from 'node:test';
 
 import {
+  ensureConsumerNavigationSpec,
   findLatestPreviewVersion,
   replaceHomeScreenTitle,
   replaceTemplateAppReferences,
@@ -94,6 +95,29 @@ test('rewrites brownfield.config.json for ExpoApp57 template', () => {
   assert.doesNotMatch(output, /expoapp57/);
 });
 
+test('adds consumer road-test navigation methods when missing from template', () => {
+  const input = `export interface BrownfieldNavigationSpec {
+  navigateToSettings(user: UserType): void;
+  navigateToReferrals(userId: string): void;
+}`;
+
+  const output = ensureConsumerNavigationSpec(input);
+
+  assert.match(output, /requestNativeConfirmation/);
+  assert.match(output, /showNativeBanner/);
+});
+
+test('does not duplicate consumer road-test navigation methods', () => {
+  const input = `export interface BrownfieldNavigationSpec {
+  navigateToReferrals(userId: string): void;
+  requestNativeConfirmation(title: string): Promise<boolean>;
+}`;
+
+  const output = ensureConsumerNavigationSpec(input);
+
+  assert.equal(output, input);
+});
+
 test('rewrites the home screen title for the latest Expo template version', () => {
   const input = 'Welcome to&nbsp;Expo&nbsp;57';
 

scripts/check-expo-preview.ts

@@ -42,6 +42,10 @@ const EXPO_PREVIEW_BROWNFIELD_CONFIG_PATH = path.join(
   EXPO_PREVIEW_APP_DIR,
   'brownfield.config.json'
 );
+const EXPO_PREVIEW_NAVIGATION_SPEC_PATH = path.join(
+  EXPO_PREVIEW_APP_DIR,
+  'brownfield.navigation.ts'
+);
 const EXPO_NPM_REGISTRY_URL = 'https://registry.npmjs.org/expo';
 
 function parseArgs(argv: string[]): CliOptions {
@@ -176,6 +180,29 @@ export function replaceHomeScreenTitle(
     .replaceAll(`Expo ${version}`, 'Expo Preview');
 }
 
+const CONSUMER_ROAD_TEST_NAVIGATION_METHODS = `
+  /**
+   * Ask the native host to confirm an action. Resolves with the user's choice.
+   */
+  requestNativeConfirmation(title: string): Promise<boolean>;
+
+  /**
+   * Show a native banner. The native host calls onDismiss when the banner is dismissed.
+   */
+  showNativeBanner(message: string, onDismiss: () => void): void;
+`;
+
+export function ensureConsumerNavigationSpec(contents: string): string {
+  if (contents.includes('requestNativeConfirmation')) {
+    return contents;
+  }
+
+  return contents.replace(
+    '  navigateToReferrals(userId: string): void;\n}',
+    `  navigateToReferrals(userId: string): void;${CONSUMER_ROAD_TEST_NAVIGATION_METHODS}\n}`
+  );
+}
+
 function generateExpoPreviewApp(): void {
   const templateApp = getExpoTemplateApp();
   const replaceReferences = (contents: string) =>
@@ -197,6 +224,10 @@ function generateExpoPreviewApp(): void {
     updateFileContents(EXPO_PREVIEW_BROWNFIELD_CONFIG_PATH, replaceReferences);
   }
 
+  if (existsSync(EXPO_PREVIEW_NAVIGATION_SPEC_PATH)) {
+    updateFileContents(EXPO_PREVIEW_NAVIGATION_SPEC_PATH, ensureConsumerNavigationSpec);
+  }
+
   const testPath = path.join(
     EXPO_PREVIEW_APP_DIR,
     '__tests__',