@react-native-harness/runtime 1.0.0-alpha.1 → 1.0.0-alpha.11

package/src/client/factory.ts

@@ -1,14 +1,16 @@
 import type {
   TestRunnerEvents,
   TestCollectorEvents,
+  BundlerEvents,
 } from '@react-native-harness/bridge';
 import { getBridgeClient } from '@react-native-harness/bridge/client';
 import { store } from '../ui/state.js';
 import { getTestRunner, TestRunner } from '../runner/index.js';
 import { getTestCollector, TestCollector } from '../collector/index.js';
 import { combineEventEmitters, EventEmitter } from '../utils/emitter.js';
+import { attachProgressLogger } from '../utils/progressLogger.js';
 import { getWSServer } from './getWSServer.js';
-import { fetchModule, evaluateModule } from '../bundler/index.js';
+import { getBundler, evaluateModule, Bundler } from '../bundler/index.js';
 
 export const getClient = async () => {
   const client = await getBridgeClient(getWSServer(), {
@@ -26,24 +28,37 @@ export const getClient = async () => {
 
     let collector: TestCollector | null = null;
     let runner: TestRunner | null = null;
-    let events: EventEmitter<TestRunnerEvents | TestCollectorEvents> | null =
-      null;
+    let events: EventEmitter<
+      TestRunnerEvents | TestCollectorEvents | BundlerEvents
+    > | null = null;
+    let bundler: Bundler | null = null;
 
     try {
       collector = getTestCollector();
       runner = getTestRunner();
-      events = combineEventEmitters(collector.events, runner.events);
+      bundler = getBundler();
+      events = combineEventEmitters(
+        collector.events,
+        runner.events,
+        bundler.events
+      );
 
       events.addListener((event) => {
         client.rpc.emitEvent(event.type, event);
       });
 
-      const moduleJs = await fetchModule(path);
+      // Add console logging for progress information
+      attachProgressLogger(events, path);
+
+      const moduleJs = await bundler.getModule(path);
       const collectionResult = await collector.collect(
         () => evaluateModule(moduleJs, path),
         path
       );
-      return await runner.run(collectionResult.testSuite, path);
+      const result = await runner.run(collectionResult.testSuite, path);
+      return result;
+    } catch (error) {
+      throw error;
     } finally {
       collector?.dispose();
       runner?.dispose();

package/src/initialize.ts

@@ -11,12 +11,15 @@ const { LogBox } = require('react-native');
 LogBox.ignoreAllLogs(true);
 
 // Turn off HMR
-const HMRClient = require('react-native/Libraries/Utilities/HMRClient');
-HMRClient.setup = () => {
-  // No setup = no HMR
-};
+const HMRClientModule = require('react-native/Libraries/Utilities/HMRClient');
+const HMRClient = 'default' in HMRClientModule ? HMRClientModule.default : HMRClientModule;
 
-// Initialize the client
-void getClient().then((client) =>
-  client.rpc.reportReady(getDeviceDescriptor())
-);
+// Wait for HMRClient to be initialized
+setTimeout(() => {
+  HMRClient.disable();
+
+  // Initialize the React Native Harness
+  void getClient().then((client) =>
+    client.rpc.reportReady(getDeviceDescriptor())
+  );
+});

package/src/mocker/registry.ts

@@ -5,9 +5,9 @@ const mockCache = new Map<number, unknown>();
 
 const originalRequire = global.__r;
 
-export const mock = (moduleId: ModuleId, factory: ModuleFactory): void => {
-  mockCache.delete(moduleId);
-  mockRegistry.set(moduleId, factory);
+export const mock = (moduleId: string, factory: ModuleFactory): void => {
+  mockCache.delete(moduleId as unknown as ModuleId);
+  mockRegistry.set(moduleId as unknown as ModuleId, factory);
 };
 
 export const clearMocks = (): void => {

package/src/react-native.d.ts

@@ -7,6 +7,43 @@ declare module 'react-native/Libraries/Core/Devtools/getDevServer' {
   export default function getDevServer(): DevServerInfo;
 }
 
+declare module 'react-native/Libraries/Core/Devtools/symbolicateStackTrace' {
+  import { StackFrame } from 'react-native/Libraries/Core/Devtools/parseErrorStack';
+
+  export type CodeFrame = Readonly<{
+    content: string;
+    location:
+      | {
+          row: number;
+          column: number;
+          [key: string]: any;
+        }
+      | null
+      | undefined;
+    fileName: string;
+  }>;
+
+  export type SymbolicatedStackTrace = Readonly<{
+    stack: ReadonlyArray<StackFrame>;
+    codeFrame: CodeFrame | null | undefined;
+  }>;
+
+  export default function symbolicateStackTrace(
+    stack: ReadonlyArray<StackFrame>,
+    extraData?: any
+  ): Promise<SymbolicatedStackTrace>;
+}
+
+declare module 'react-native/Libraries/Core/Devtools/parseErrorStack' {
+  export type StackFrame = {
+    column: number | null | undefined;
+    file: string | null | undefined;
+    lineNumber: number | null | undefined;
+    methodName: string;
+  };
+  export default function parseErrorStack(errorStack?: string): StackFrame[];
+}
+
 declare global {
   var __r:
     | {

package/src/runner/errors.ts

@@ -1,17 +1,26 @@
-import type { SerializedError } from '@react-native-harness/bridge';
+import type { SerializedError, CodeFrame } from '@react-native-harness/bridge';
+import { getCodeFrame } from '../symbolicate.js';
 
 export class TestExecutionError extends Error {
   file: string;
   suite: string;
   test: string;
+  codeFrame?: CodeFrame;
 
-  constructor(error: unknown, file: string, suite: string, test: string) {
+  constructor(
+    error: unknown,
+    file: string,
+    suite: string,
+    test: string,
+    codeFrame?: CodeFrame
+  ) {
     super('Test execution error');
     this.name = 'TestExecutionError';
     this.file = file;
     this.suite = suite;
     this.test = test;
     this.cause = error;
+    this.codeFrame = codeFrame;
   }
 
   toSerializedJSON(): SerializedError {
@@ -19,13 +28,34 @@ export class TestExecutionError extends Error {
       this.cause instanceof Error ? this.cause.name : 'Unknown name';
     const causeMessage =
       this.cause instanceof Error ? this.cause.message : 'Unknown message';
-    const causeStack =
-      this.cause instanceof Error ? this.cause.stack : undefined;
+    const causeCodeFrame = this.codeFrame;
 
     return {
       name: causeName,
       message: causeMessage,
-      stack: causeStack,
+      codeFrame: causeCodeFrame,
     };
   }
 }
+
+export const getTestExecutionError = async (
+  error: unknown,
+  file: string,
+  suite: string,
+  test: string
+): Promise<TestExecutionError> => {
+  try {
+    if (error instanceof Error) {
+      const codeFrame = await getCodeFrame(error);
+
+      if (codeFrame) {
+        return new TestExecutionError(error, file, suite, test, codeFrame);
+      }
+    }
+
+    return new TestExecutionError(error, file, suite, test);
+  } catch (error) {
+    // If the stack cannot be symbolicated, return the original error
+    return new TestExecutionError(error, file, suite, test);
+  }
+};

package/src/runner/runSuite.ts

@@ -5,7 +5,7 @@ import type {
   TestSuiteResult,
 } from '@react-native-harness/bridge';
 import { runHooks } from './hooks.js';
-import { TestExecutionError } from './errors.js';
+import { getTestExecutionError } from './errors.js';
 import { TestRunnerContext } from './types.js';
 
 const runTest = async (
@@ -94,7 +94,7 @@ const runTest = async (
 
     return result;
   } catch (error) {
-    const testError = new TestExecutionError(
+    const testError = await getTestExecutionError(
       error,
       context.testFilePath,
       suite.name,
@@ -173,13 +173,31 @@ export const runSuite = async (
 
   if (hasFailedTests || hasFailedSuites) {
     status = 'failed';
-  } else if (
-    (testResults.every((result) => result.status === 'skipped') &&
-      suiteResults.every((result) => result.status === 'skipped') &&
-      testResults.length > 0) ||
-    suiteResults.length > 0
-  ) {
-    status = 'skipped';
+  } else {
+    // Check if all tests and suites are skipped (and there are some tests/suites to check)
+    const allTestsSkipped =
+      testResults.length > 0 &&
+      testResults.every((result) => result.status === 'skipped');
+    const allSuitesSkipped =
+      suiteResults.length > 0 &&
+      suiteResults.every((result) => result.status === 'skipped');
+    const hasAnyContent = testResults.length > 0 || suiteResults.length > 0;
+
+    if (
+      hasAnyContent &&
+      ((testResults.length > 0 &&
+        allTestsSkipped &&
+        suiteResults.length === 0) ||
+        (suiteResults.length > 0 &&
+          allSuitesSkipped &&
+          testResults.length === 0) ||
+        (testResults.length > 0 &&
+          suiteResults.length > 0 &&
+          allTestsSkipped &&
+          allSuitesSkipped))
+    ) {
+      status = 'skipped';
+    }
   }
 
   // Emit suite-finished event

package/src/symbolicate.ts

@@ -0,0 +1,22 @@
+import type { CodeFrame } from '@react-native-harness/bridge';
+import parseErrorStack from 'react-native/Libraries/Core/Devtools/parseErrorStack';
+import symbolicateStackTrace from 'react-native/Libraries/Core/Devtools/symbolicateStackTrace';
+
+export const getCodeFrame = async (error: Error): Promise<CodeFrame | null> => {
+  const parsedStack = parseErrorStack(error.stack);
+  const symbolicatedStack = await symbolicateStackTrace(parsedStack);
+
+  if (!symbolicatedStack.codeFrame) {
+    return null;
+  }
+
+  // Normalize optionality (null -> undefined)
+  return {
+    ...symbolicatedStack.codeFrame,
+    location: symbolicatedStack.codeFrame.location
+      ? {
+          ...symbolicatedStack.codeFrame.location,
+        }
+      : undefined,
+  };
+};

package/src/utils/progressLogger.ts

@@ -0,0 +1,98 @@
+import type {
+  TestRunnerEvents,
+  TestCollectorEvents,
+  BundlerEvents,
+} from '@react-native-harness/bridge';
+import type { EventEmitter } from './emitter.js';
+
+/**
+ * Attaches console logging to runtime events to provide progress information.
+ * This function handles all test run lifecycle events including start, progress, and completion.
+ */
+export const attachProgressLogger = (
+  events: EventEmitter<TestRunnerEvents | TestCollectorEvents | BundlerEvents>,
+  testPath: string
+): void => {
+  // Log test run start
+  console.log(`🎯 Starting test run for: ${testPath}`);
+
+  // Handle all runtime events
+  events.addListener((event) => {
+    switch (event.type) {
+      case 'collection-started':
+        console.log(`📄 Collecting tests from: ${event.file}`);
+        break;
+      case 'collection-finished':
+        console.log(`✅ Test collection completed in ${event.duration}ms`);
+        break;
+      case 'module-bundling-started':
+        console.log(`📦 Bundling module: ${event.file}`);
+        break;
+      case 'module-bundling-finished':
+        console.log(`✅ Module bundling completed in ${event.duration}ms`);
+        break;
+      case 'file-started':
+        console.log(`🚀 Running tests in: ${event.file}`);
+        break;
+      case 'file-finished':
+        console.log(`📋 File completed in ${event.duration}ms: ${event.file}`);
+        break;
+      case 'suite-started':
+        console.log(`📦 Suite started: ${event.name}`);
+        break;
+      case 'suite-finished':
+        const suiteStatus =
+          event.status === 'passed'
+            ? '✅'
+            : event.status === 'failed'
+            ? '❌'
+            : '⏭️';
+        console.log(
+          `${suiteStatus} Suite "${event.name}" ${event.status} (${event.duration}ms)`
+        );
+        if (event.error) {
+          console.log(`   Error: ${event.error.message}`);
+        }
+        break;
+      case 'test-started':
+        console.log(`  🧪 Running: ${event.name}`);
+        break;
+      case 'test-finished':
+        const testStatus =
+          event.status === 'passed'
+            ? '✅'
+            : event.status === 'failed'
+            ? '❌'
+            : event.status === 'skipped'
+            ? '⏭️'
+            : '📝';
+        console.log(`  ${testStatus} ${event.name} (${event.duration}ms)`);
+        if (event.error) {
+          console.log(`     Error: ${event.error.message}`);
+          if (event.error.codeFrame) {
+            console.log(`     Code frame: ${event.error.codeFrame.content}`);
+          }
+        }
+        break;
+      default:
+        console.log(`🔔 Event: ${(event as any).type}`, event);
+        break;
+    }
+  });
+
+  // Add completion and error logging through a wrapper
+  const originalEmit = events.emit;
+  let isCompleted = false;
+
+  events.emit = (event) => {
+    const result = originalEmit.call(events, event);
+
+    // Check if this is the last event to log completion
+    if (!isCompleted && event.type === 'file-finished') {
+      console.log(`🏁 Test run completed for: ${testPath}`);
+      isCompleted = true;
+    }
+
+    return result;
+  };
+};

package/dist/bundler/dev-server.d.ts

@@ -1,2 +0,0 @@
-export declare const getDevServerUrl: () => string;
-//# sourceMappingURL=dev-server.d.ts.map

package/dist/bundler/dev-server.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"dev-server.d.ts","sourceRoot":"","sources":["../../src/bundler/dev-server.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,eAAe,QAAO,MAGlC,CAAC"}

package/dist/bundler/dev-server.js

@@ -1,5 +0,0 @@
-import getDevServer from 'react-native/Libraries/Core/Devtools/getDevServer';
-export const getDevServerUrl = () => {
-    const devServer = getDevServer();
-    return devServer.url;
-};

package/dist/exports.d.ts

@@ -1,7 +0,0 @@
-export { UI } from './ui/UI.js';
-export { getEntryComponent } from './getEntryComponent.js';
-export * from './spy/index.js';
-export * from './expect/index.js';
-export * from './collector/index.js';
-export * from './mocker/index.js';
-//# sourceMappingURL=exports.d.ts.map

package/dist/exports.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"exports.d.ts","sourceRoot":"","sources":["../src/exports.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,YAAY,CAAC;AAChC,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC"}

package/dist/exports.js

@@ -1,6 +0,0 @@
-export { UI } from './ui/UI.js';
-export { getEntryComponent } from './getEntryComponent.js';
-export * from './spy/index.js';
-export * from './expect/index.js';
-export * from './collector/index.js';
-export * from './mocker/index.js';

package/dist/getEntryComponent.d.ts

@@ -1,6 +0,0 @@
-import { ComponentType } from 'react';
-declare global {
-    var RN_HARNESS: boolean;
-}
-export declare const getEntryComponent: (Component: ComponentType) => any;
-//# sourceMappingURL=getEntryComponent.d.ts.map

package/dist/getEntryComponent.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"getEntryComponent.d.ts","sourceRoot":"","sources":["../src/getEntryComponent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,aAAa,EAAC,MAAM,OAAO,CAAC;AAEpC,OAAO,CAAC,MAAM,CAAC;IACb,IAAI,UAAU,EAAE,OAAO,CAAC;CACzB;AAED,eAAO,MAAM,iBAAiB,GAAI,WAAW,aAAa,QAMzD,CAAC"}

package/dist/getEntryComponent.js

@@ -1,6 +0,0 @@
-export const getEntryComponent = (Component) => {
-    if ('RN_HARNESS' in global) {
-        return require('./ui/UI').default;
-    }
-    return Component;
-};

package/dist/logger.d.ts

@@ -1,6 +0,0 @@
-export declare const logger: {
-    info: (...args: unknown[]) => void;
-    error: (...args: unknown[]) => void;
-    log: (...args: unknown[]) => void;
-};
-//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,MAAM;oBACD,OAAO,EAAE;qBAGR,OAAO,EAAE;mBAGX,OAAO,EAAE;CAKzB,CAAC"}

package/dist/logger.js

@@ -1,14 +0,0 @@
-const verbose = global.RN_HARNESS.verbose;
-export const logger = {
-    info: (...args) => {
-        console.info(...args);
-    },
-    error: (...args) => {
-        console.error(...args);
-    },
-    log: (...args) => {
-        if (verbose) {
-            console.log(...args);
-        }
-    },
-};

package/dist/mock.d.ts

@@ -1,15 +0,0 @@
-type ModuleId = number;
-type Require = {
-    (moduleId: number): unknown;
-};
-declare global {
-    var __r: Require;
-}
-export type ModuleFactory = () => unknown;
-export declare const mock: (moduleId: ModuleId, factory: ModuleFactory) => void;
-export declare const clearMocks: () => void;
-export declare const getMockRegistry: () => Map<number, ModuleFactory>;
-export declare const getMockImplementation: (moduleId: number) => unknown | null;
-export declare const requireActual: <T = any>(moduleId: ModuleId) => T;
-export {};
-//# sourceMappingURL=mock.d.ts.map

package/dist/mock.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"mock.d.ts","sourceRoot":"","sources":["../src/mock.ts"],"names":[],"mappings":"AAAA,KAAK,QAAQ,GAAG,MAAM,CAAC;AACvB,KAAK,OAAO,GAAG;IACb,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;CAC7B,CAAC;AACF,OAAO,CAAC,MAAM,CAAC;IACb,IAAI,GAAG,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,CAAC;AAO1C,eAAO,MAAM,IAAI,GAAI,UAAU,QAAQ,EAAE,SAAS,aAAa,KAAG,IAGjE,CAAC;AAEF,eAAO,MAAM,UAAU,QAAO,IAG7B,CAAC;AAEF,eAAO,MAAM,eAAe,QAAO,GAAG,CAAC,MAAM,EAAE,aAAa,CAE3D,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAAI,UAAU,MAAM,KAAG,OAAO,GAAG,IAalE,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,CAAC,GAAG,GAAG,EAAE,UAAU,QAAQ,KAAG,CAC5B,CAAC"}

package/dist/mock.js

@@ -1,37 +0,0 @@
-const mockRegistry = new Map();
-const mockCache = new Map();
-const originalRequire = global.__r;
-export const mock = (moduleId, factory) => {
-    mockCache.delete(moduleId);
-    mockRegistry.set(moduleId, factory);
-};
-export const clearMocks = () => {
-    mockRegistry.clear();
-    mockCache.clear();
-};
-export const getMockRegistry = () => {
-    return mockRegistry;
-};
-export const getMockImplementation = (moduleId) => {
-    if (mockCache.has(moduleId)) {
-        return mockCache.get(moduleId);
-    }
-    const factory = mockRegistry.get(moduleId);
-    if (!factory) {
-        return null;
-    }
-    const implementation = factory();
-    mockCache.set(moduleId, implementation);
-    return implementation;
-};
-export const requireActual = (moduleId) => originalRequire(moduleId);
-const mockRequire = (moduleId) => {
-    const mockedModule = getMockImplementation(moduleId);
-    if (mockedModule) {
-        return mockedModule;
-    }
-    return originalRequire(moduleId);
-};
-Object.setPrototypeOf(mockRequire, Object.getPrototypeOf(originalRequire));
-Object.defineProperties(mockRequire, Object.getOwnPropertyDescriptors(originalRequire));
-global.__r = mockRequire;

package/dist/module.d.ts

@@ -1,3 +0,0 @@
-export declare const fetchModule: (fileName: string) => Promise<string>;
-export declare const executeModule: (moduleJs: string) => void;
-//# sourceMappingURL=module.d.ts.map

package/dist/module.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,WAAW,GAAU,UAAU,MAAM,KAAG,OAAO,CAAC,MAAM,CAIlE,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,UAAU,MAAM,KAAG,IAQhD,CAAC"}

package/dist/module.js

@@ -1,19 +0,0 @@
-import { Platform } from 'react-native';
-const METRO_URL = 'http://localhost:8081';
-const getModuleUrl = (fileName) => {
-    const bundleName = fileName.split('.').slice(0, -1).join('.') + '.bundle';
-    return `${METRO_URL}/${bundleName}?modulesOnly=true&platform=${Platform.OS}`;
-};
-export const fetchModule = async (fileName) => {
-    const url = getModuleUrl(fileName);
-    const response = await fetch(url);
-    return response.text();
-};
-export const executeModule = (moduleJs) => {
-    const __rMatch = moduleJs.match(/__r\((\d+)\)/);
-    const __rParam = __rMatch[1];
-    // eslint-disable-next-line no-eval
-    eval(moduleJs);
-    // @ts-ignore - __r is injected by Metro bundler
-    __r(Number(__rParam));
-};

package/dist/module.web.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=module.web.d.ts.map

package/dist/module.web.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"module.web.d.ts","sourceRoot":"","sources":["../src/module.web.ts"],"names":[],"mappings":""}

package/dist/module.web.js

@@ -1,12 +0,0 @@
-// const context = require.context('../..', false, /\.test.tsx$/);
-export {};
-// export const fetchModule = async (fileName: string): Promise<string> => {
-//   return fileName;
-// };
-// export const executeModule = (moduleJs: string): void => {
-//   const modulePath = `./${moduleJs}`;
-//   if (!context.keys().includes(modulePath)) {
-//     throw new Error(`Module ${moduleJs} not found`);
-//   }
-//   return context(modulePath);
-// };

package/dist/rntl/client.d.ts

@@ -1,3 +0,0 @@
-import { BridgeClient } from '@react-native-harness/bridge/client';
-export declare const getClient: () => BridgeClient;
-//# sourceMappingURL=client.d.ts.map

package/dist/rntl/client.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/rntl/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AAGnE,eAAO,MAAM,SAAS,QAAO,YAU5B,CAAC"}

package/dist/rntl/client.js

@@ -1,8 +0,0 @@
-import { state } from '../state.js';
-export const getClient = () => {
-    const client = state.getState().client;
-    if (!client) {
-        throw new Error('Client not found. Are you sure you are running the test in the react-native-harness environment?');
-    }
-    return client;
-};

package/dist/rntl/describe.d.ts

@@ -1,2 +0,0 @@
-export { describe, test, it } from '../collector/functions.js';
-//# sourceMappingURL=describe.d.ts.map

package/dist/rntl/describe.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"describe.d.ts","sourceRoot":"","sources":["../../src/rntl/describe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/rntl/describe.js

@@ -1 +0,0 @@
-export { describe, test, it } from '../collector/functions.js';