@react-native-harness/platform-windows 1.5.0

package/LICENSE

@@ -0,0 +1,20 @@
+MIT License
+
+Copyright (c) 2025 Callstack
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,76 @@
+![harness-banner](https://react-native-harness.dev/harness-banner.jpg)
+
+[![mit licence][license-badge]][license]
+[![npm downloads][npm-downloads-badge]][npm-downloads]
+[![Chat][chat-badge]][chat]
+[![PRs Welcome][prs-welcome-badge]][prs-welcome]
+
+React Native Windows platform for React Native Harness — runs your harness tests against a deployed React Native Windows app.
+
+## Installation
+
+```bash
+npm install --save-dev @react-native-harness/platform-windows
+# or
+pnpm add -D @react-native-harness/platform-windows
+# or
+yarn add -D @react-native-harness/platform-windows
+```
+
+## Usage
+
+Add the Windows platform to your `rn-harness.config.mjs`:
+
+```javascript
+import { windowsPlatform } from '@react-native-harness/platform-windows';
+
+export default {
+  entryPoint: './index.js',
+  appRegistryComponentName: 'MyApp',
+  runners: [
+    windowsPlatform({
+      name: 'windows',
+      // Package.appxmanifest Identity/@Name
+      packageName: 'MyApp',
+    }),
+  ],
+};
+```
+
+Deploy the app before running the harness — the runner launches an already
+installed package, it does not build:
+
+```bash
+npx react-native run-windows --arch x64 --no-launch --no-packager
+npx react-native-harness --harnessRunner windows
+```
+
+## API
+
+### `windowsPlatform(config)`
+
+**Parameters:**
+
+- `config.name` — unique name for the runner.
+- `config.packageName` — the app's `Identity/@Name` from `Package.appxmanifest`. Used to look the deployed package up with `Get-AppxPackage`.
+- `config.appId` — the app's `Application/@Id` from `Package.appxmanifest`. Combined with the package family name into the AUMID used to launch the app. Defaults to `App` (the React Native Windows template value).
+- `config.processName` — the app's process name (without `.exe`), for tracking whether it is still running. Defaults to `packageName`.
+
+## Requirements
+
+- Windows 10/11 with the app already deployed (`react-native run-windows`).
+- The harness Metro server reachable at the app's configured bundle URL (`http://localhost:8081` by default).
+
+## Made with ❤️ at Callstack
+
+`react-native-harness` is an open source project and will always remain free to use. If you think it's cool, please star it 🌟. [Callstack][callstack-readme-with-love] is a group of React and React Native geeks, contact us at [hello@callstack.com](mailto:hello@callstack.com) if you need any help with these or just want to say hi!
+
+[callstack-readme-with-love]: https://callstack.com/?utm_source=github.com&utm_medium=referral&utm_campaign=react-native-harness&utm_term=readme-with-love
+[license-badge]: https://img.shields.io/npm/l/react-native-harness?style=for-the-badge
+[license]: https://github.com/callstackincubator/react-native-harness/blob/main/LICENSE
+[npm-downloads-badge]: https://img.shields.io/npm/dm/react-native-harness?style=for-the-badge
+[npm-downloads]: https://www.npmjs.com/package/react-native-harness
+[prs-welcome-badge]: https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=for-the-badge
+[prs-welcome]: ./CONTRIBUTING.md
+[chat-badge]: https://img.shields.io/discord/426714625279524876.svg?style=for-the-badge
+[chat]: https://discord.gg/xgGt7KAjxv

package/dist/config.d.ts

@@ -0,0 +1,41 @@
+import { z } from 'zod';
+export declare const WindowsAppLaunchOptionsSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export declare const WindowsPlatformConfigSchema: z.ZodObject<{
+    name: z.ZodString;
+    /**
+     * The app's `Identity/@Name` from `Package.appxmanifest` — e.g.
+     * `ReactNativeNitroExample`. Used to look the deployed package up with
+     * `Get-AppxPackage`.
+     */
+    packageName: z.ZodString;
+    /**
+     * The app's `Application/@Id` from `Package.appxmanifest`. Combined with the
+     * package family name into the AUMID used to launch the app. Defaults to
+     * `App`, which is what the React Native Windows template generates.
+     */
+    appId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    /**
+     * The name of the app's process (without `.exe`), for tracking whether it is
+     * still running. Defaults to `packageName`, which is correct for the RNW
+     * template.
+     */
+    processName: z.ZodOptional<z.ZodString>;
+    appLaunchOptions: z.ZodOptional<z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    packageName: string;
+    appId: string;
+    processName?: string | undefined;
+    appLaunchOptions?: {} | undefined;
+}, {
+    name: string;
+    packageName: string;
+    appId?: string | undefined;
+    processName?: string | undefined;
+    appLaunchOptions?: {} | undefined;
+}>;
+export type WindowsAppLaunchOptions = z.infer<typeof WindowsAppLaunchOptionsSchema>;
+export type WindowsPlatformConfig = z.infer<typeof WindowsPlatformConfigSchema>;
+/** The `WindowsPlatformConfig` before Zod applies defaults (e.g. `appId`). */
+export type WindowsPlatformConfigInput = z.input<typeof WindowsPlatformConfigSchema>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,6BAA6B,gDAAe,CAAC;AAE1D,eAAO,MAAM,2BAA2B;;IAEtC;;;;OAIG;;IAEH;;;;OAIG;;IAEH;;;;OAIG;;;;;;;;;;;;;;;EAGH,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAC3C,OAAO,6BAA6B,CACrC,CAAC;AACF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF,8EAA8E;AAC9E,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAC9C,OAAO,2BAA2B,CACnC,CAAC"}

package/dist/config.js

@@ -0,0 +1,24 @@
+import { z } from 'zod';
+export const WindowsAppLaunchOptionsSchema = z.object({});
+export const WindowsPlatformConfigSchema = z.object({
+    name: z.string().min(1, 'Name is required'),
+    /**
+     * The app's `Identity/@Name` from `Package.appxmanifest` — e.g.
+     * `ReactNativeNitroExample`. Used to look the deployed package up with
+     * `Get-AppxPackage`.
+     */
+    packageName: z.string().min(1, 'packageName is required'),
+    /**
+     * The app's `Application/@Id` from `Package.appxmanifest`. Combined with the
+     * package family name into the AUMID used to launch the app. Defaults to
+     * `App`, which is what the React Native Windows template generates.
+     */
+    appId: z.string().min(1).optional().default('App'),
+    /**
+     * The name of the app's process (without `.exe`), for tracking whether it is
+     * still running. Defaults to `packageName`, which is correct for the RNW
+     * template.
+     */
+    processName: z.string().min(1).optional(),
+    appLaunchOptions: WindowsAppLaunchOptionsSchema.optional(),
+});

package/dist/factory.d.ts

@@ -0,0 +1,4 @@
+import { HarnessPlatform } from '@react-native-harness/platforms';
+import type { WindowsPlatformConfigInput } from './config.js';
+export declare const windowsPlatform: (config: WindowsPlatformConfigInput) => HarnessPlatform<WindowsPlatformConfigInput>;
+//# sourceMappingURL=factory.d.ts.map

package/dist/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAE9D,eAAO,MAAM,eAAe,GAC1B,QAAQ,0BAA0B,KACjC,eAAe,CAAC,0BAA0B,CAO3C,CAAC"}

package/dist/factory.js

@@ -0,0 +1,8 @@
+export const windowsPlatform = (config) => ({
+    name: config.name,
+    config,
+    runner: import.meta.resolve('./runner.js'),
+    metroConfigEnhancer: import.meta.resolve('./metro-config-enhancer.js'),
+    platformId: 'windows',
+    getResourceLockKey: () => `windows:${config.packageName}`,
+});

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { windowsPlatform } from './factory.js';
+export type { WindowsPlatformConfig, WindowsPlatformConfigInput, WindowsAppLaunchOptions, } from './config.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,YAAY,EACV,qBAAqB,EACrB,0BAA0B,EAC1B,uBAAuB,GACxB,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1 @@
+export { windowsPlatform } from './factory.js';

package/dist/metro-config-enhancer.d.ts

@@ -0,0 +1,4 @@
+import type { MetroConfigEnhancer } from '@react-native-harness/bundler-metro';
+declare const enhanceMetroConfig: MetroConfigEnhancer;
+export default enhanceMetroConfig;
+//# sourceMappingURL=metro-config-enhancer.d.ts.map

package/dist/metro-config-enhancer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metro-config-enhancer.d.ts","sourceRoot":"","sources":["../src/metro-config-enhancer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,mBAAmB,EAEpB,MAAM,qCAAqC,CAAC;AAqE7C,QAAA,MAAM,kBAAkB,EAAE,mBAmCzB,CAAC;AAEF,eAAe,kBAAkB,CAAC"}

package/dist/metro-config-enhancer.js

@@ -0,0 +1,79 @@
+import { createRequire } from 'node:module';
+import { logger } from '@react-native-harness/tools';
+const require = createRequire(import.meta.url);
+const log = logger.child('platform-windows');
+const RNW_PACKAGE = 'react-native-windows';
+/**
+ * Redirects `react-native` / `react-native/*` imports to `react-native-windows`
+ * when Metro is bundling for the `windows` platform, delegating to whatever
+ * `resolveRequest` the harness has already composed.
+ *
+ * `react-native start` installs this via `@react-native/community-cli-plugin`'s
+ * `reactNativePlatformResolver`, keyed off the platform's `npmPackageName` in
+ * the React Native CLI config. The harness loads Metro's config directly and
+ * never runs that plugin, so the platform package supplies the redirect itself.
+ */
+const withWindowsPackageRedirect = (next) => {
+    const passThrough = next ?? ((ctx, name, plat) => ctx.resolveRequest(ctx, name, plat));
+    return (context, moduleName, platform) => {
+        if (platform !== 'windows') {
+            return passThrough(context, moduleName, platform);
+        }
+        let redirected = moduleName;
+        if (moduleName === 'react-native') {
+            redirected = RNW_PACKAGE;
+        }
+        else if (moduleName.startsWith('react-native/')) {
+            redirected = `${RNW_PACKAGE}/${moduleName.slice('react-native/'.length)}`;
+        }
+        return passThrough(context, redirected, platform);
+    };
+};
+/**
+ * Resolves `react-native-windows/Libraries/Core/InitializeCore` from the
+ * project. Without it running before the entry point a `windows` bundle never
+ * calls `setUpBatchedBridge`, so `HMRClient` is not a registered callable
+ * module and React Native Windows redboxes the instance before the harness can
+ * attach. Metro only emits a `require()` for a run-before module that ends up
+ * in the graph, so this is inert for any non-Windows bundle.
+ */
+const resolveInitializeCore = (projectRoot) => {
+    const specifier = `${RNW_PACKAGE}/Libraries/Core/InitializeCore`;
+    try {
+        return require.resolve(specifier, { paths: [projectRoot] });
+    }
+    catch {
+        log.warn('could not resolve %s from %s; Windows bundles may fail to initialize', specifier, projectRoot);
+        return null;
+    }
+};
+const enhanceMetroConfig = (metroConfig, { projectRoot }) => {
+    const initializeCore = resolveInitializeCore(projectRoot);
+    const existingRunBeforeMainModule = metroConfig.serializer?.getModulesRunBeforeMainModule;
+    return {
+        ...metroConfig,
+        resolver: {
+            ...metroConfig.resolver,
+            platforms: [
+                ...new Set([
+                    ...(metroConfig.resolver?.platforms ?? ['ios', 'android']),
+                    'windows',
+                    'native',
+                ]),
+            ],
+            resolveRequest: withWindowsPackageRedirect(metroConfig.resolver?.resolveRequest ?? undefined),
+        },
+        serializer: {
+            ...metroConfig.serializer,
+            ...(initializeCore
+                ? {
+                    getModulesRunBeforeMainModule: (entryPoint) => [
+                        ...(existingRunBeforeMainModule?.(entryPoint) ?? []),
+                        initializeCore,
+                    ],
+                }
+                : {}),
+        },
+    };
+};
+export default enhanceMetroConfig;

package/dist/pwsh.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Runs a PowerShell snippet non-interactively and returns its trimmed stdout.
+ * `-NoProfile` keeps it fast and hermetic; `-NonInteractive` makes sure it
+ * never blocks on a prompt.
+ */
+export declare const runPowerShell: (script: string) => Promise<string>;
+/**
+ * Resolves the PackageFamilyName of a deployed MSIX package from its identity
+ * name (`Package.appxmanifest` `Identity/@Name`). Returns `null` when the app
+ * is not deployed.
+ */
+export declare const getPackageFamilyName: (identityName: string) => Promise<string | null>;
+/** Whether at least one process with the given name (no `.exe`) is running. */
+export declare const isProcessRunning: (processName: string) => Promise<boolean>;
+/**
+ * Launches a deployed MSIX app by its AUMID
+ * (`<PackageFamilyName>!<Application Id>`).
+ *
+ * `explorer.exe shell:AppsFolder\<aumid>` is the reliable activation path, but
+ * `explorer.exe` almost always exits non-zero even on success, so its failure
+ * is swallowed — the caller confirms the app came up by polling for its
+ * process.
+ */
+export declare const launchAppByAumid: (aumid: string) => Promise<void>;
+/** Force-terminates every process with the given name. Safe to call when none exist. */
+export declare const stopProcess: (processName: string) => Promise<void>;
+//# sourceMappingURL=pwsh.d.ts.map

package/dist/pwsh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pwsh.d.ts","sourceRoot":"","sources":["../src/pwsh.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAU,QAAQ,MAAM,KAAG,OAAO,CAAC,MAAM,CAOlE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAC/B,cAAc,MAAM,KACnB,OAAO,CAAC,MAAM,GAAG,IAAI,CAKvB,CAAC;AAEF,+EAA+E;AAC/E,eAAO,MAAM,gBAAgB,GAC3B,aAAa,MAAM,KAClB,OAAO,CAAC,OAAO,CASjB,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB,GAAU,OAAO,MAAM,KAAG,OAAO,CAAC,IAAI,CAQlE,CAAC;AAEF,wFAAwF;AACxF,eAAO,MAAM,WAAW,GAAU,aAAa,MAAM,KAAG,OAAO,CAAC,IAAI,CAQnE,CAAC"}

package/dist/pwsh.js

@@ -0,0 +1,57 @@
+import { spawn } from '@react-native-harness/tools';
+/**
+ * Runs a PowerShell snippet non-interactively and returns its trimmed stdout.
+ * `-NoProfile` keeps it fast and hermetic; `-NonInteractive` makes sure it
+ * never blocks on a prompt.
+ */
+export const runPowerShell = async (script) => {
+    const { stdout } = await spawn('powershell', ['-NoProfile', '-NonInteractive', '-Command', script], { windowsHide: true });
+    return stdout.trim();
+};
+/**
+ * Resolves the PackageFamilyName of a deployed MSIX package from its identity
+ * name (`Package.appxmanifest` `Identity/@Name`). Returns `null` when the app
+ * is not deployed.
+ */
+export const getPackageFamilyName = async (identityName) => {
+    const pfn = await runPowerShell(`(Get-AppxPackage -Name '${identityName}' | Select-Object -First 1).PackageFamilyName`);
+    return pfn === '' ? null : pfn;
+};
+/** Whether at least one process with the given name (no `.exe`) is running. */
+export const isProcessRunning = async (processName) => {
+    try {
+        const count = await runPowerShell(`(Get-Process -Name '${processName}' -ErrorAction SilentlyContinue | Measure-Object).Count`);
+        return Number(count) > 0;
+    }
+    catch {
+        return false;
+    }
+};
+/**
+ * Launches a deployed MSIX app by its AUMID
+ * (`<PackageFamilyName>!<Application Id>`).
+ *
+ * `explorer.exe shell:AppsFolder\<aumid>` is the reliable activation path, but
+ * `explorer.exe` almost always exits non-zero even on success, so its failure
+ * is swallowed — the caller confirms the app came up by polling for its
+ * process.
+ */
+export const launchAppByAumid = async (aumid) => {
+    try {
+        await spawn('explorer.exe', [`shell:AppsFolder\\${aumid}`], {
+            windowsHide: true,
+        });
+    }
+    catch {
+        // Expected: explorer.exe reports a non-zero exit even on success.
+    }
+};
+/** Force-terminates every process with the given name. Safe to call when none exist. */
+export const stopProcess = async (processName) => {
+    try {
+        await runPowerShell(`Get-Process -Name '${processName}' -ErrorAction SilentlyContinue | Stop-Process -Force`);
+    }
+    catch {
+        // Nothing to stop, or it exited between the query and the kill.
+    }
+};

package/dist/runner.d.ts

@@ -0,0 +1,6 @@
+import { type HarnessPlatformRunnerFactory } from '@react-native-harness/platforms';
+import type { Config as HarnessConfig } from '@react-native-harness/config';
+import { type WindowsPlatformConfigInput } from './config.js';
+declare const getWindowsRunner: HarnessPlatformRunnerFactory<WindowsPlatformConfigInput, HarnessConfig>;
+export default getWindowsRunner;
+//# sourceMappingURL=runner.d.ts.map

package/dist/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,4BAA4B,EAClC,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,MAAM,IAAI,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAE5E,OAAO,EAEL,KAAK,0BAA0B,EAChC,MAAM,aAAa,CAAC;AA+BrB,QAAA,MAAM,gBAAgB,EAAE,4BAA4B,CAClD,0BAA0B,EAC1B,aAAa,CA6Hd,CAAC;AAEF,eAAe,gBAAgB,CAAC"}

package/dist/runner.js

@@ -0,0 +1,128 @@
+import { createAppSessionEmitter, AppNotInstalledError, } from '@react-native-harness/platforms';
+import { logger } from '@react-native-harness/tools';
+import { WindowsPlatformConfigSchema, } from './config.js';
+import { getPackageFamilyName, isProcessRunning, launchAppByAumid, stopProcess, } from './pwsh.js';
+const log = logger.child('platform-windows');
+const APP_EXIT_POLL_INTERVAL_MS = 1000;
+const APP_START_POLL_INTERVAL_MS = 400;
+const APP_START_POLL_ATTEMPTS = 15;
+const delay = (ms, signal) => new Promise((resolve, reject) => {
+    if (signal.aborted) {
+        reject(signal.reason);
+        return;
+    }
+    const timer = setTimeout(() => {
+        signal.removeEventListener('abort', onAbort);
+        resolve();
+    }, ms);
+    const onAbort = () => {
+        clearTimeout(timer);
+        reject(signal.reason);
+    };
+    signal.addEventListener('abort', onAbort, { once: true });
+});
+const getWindowsRunner = async (config, _harnessConfig, init) => {
+    void _harnessConfig;
+    const parsedConfig = WindowsPlatformConfigSchema.parse(config);
+    const { packageName, appId } = parsedConfig;
+    const processName = parsedConfig.processName ?? packageName;
+    const packageFamilyName = await getPackageFamilyName(packageName);
+    if (packageFamilyName == null) {
+        throw new AppNotInstalledError(packageName, 'this machine');
+    }
+    const aumid = `${packageFamilyName}!${appId}`;
+    log.debug('resolved AUMID %s for package %s', aumid, packageName);
+    return {
+        createAppSession: async () => {
+            // Clean slate: never attach to an instance left over from a previous run.
+            await stopProcess(processName);
+            await launchAppByAumid(aumid);
+            // `explorer.exe` returns before the app is up (and lies about its exit
+            // code), so confirm the process actually started. `init.signal` cancels
+            // this finite readiness wait; it is not a disposal signal.
+            let started = false;
+            for (let attempt = 0; attempt < APP_START_POLL_ATTEMPTS; attempt += 1) {
+                if (await isProcessRunning(processName)) {
+                    started = true;
+                    break;
+                }
+                await delay(APP_START_POLL_INTERVAL_MS, init.signal);
+            }
+            if (!started) {
+                await stopProcess(processName);
+                throw new Error(`The Windows app '${processName}' did not start after launching ${aumid}. ` +
+                    `Deploy it first, e.g. \`npx react-native run-windows --arch x64 --no-launch\`.`);
+            }
+            const emitter = createAppSessionEmitter();
+            let state = { status: 'running' };
+            let disposed = false;
+            let stopPolling = false;
+            let pollDelayTimeout = null;
+            let resolvePollDelay = null;
+            // Unlike a raced delay() loser (which is fine to just discard), this
+            // wait is directly `await`ed by pollTask with nothing else racing it,
+            // so cancelling it must also resolve the promise immediately —
+            // otherwise dispose() blocks on `await pollTask` for up to
+            // APP_EXIT_POLL_INTERVAL_MS instead of returning right away.
+            const waitForNextPoll = () => new Promise((resolve) => {
+                resolvePollDelay = () => {
+                    resolvePollDelay = null;
+                    pollDelayTimeout = null;
+                    resolve();
+                };
+                pollDelayTimeout = setTimeout(() => {
+                    resolvePollDelay?.();
+                }, APP_EXIT_POLL_INTERVAL_MS);
+            });
+            const cancelPendingPollDelay = () => {
+                if (pollDelayTimeout) {
+                    clearTimeout(pollDelayTimeout);
+                    pollDelayTimeout = null;
+                }
+                resolvePollDelay?.();
+            };
+            const pollTask = (async () => {
+                while (!stopPolling) {
+                    if (!(await isProcessRunning(processName))) {
+                        if (!disposed && state.status === 'running') {
+                            state = {
+                                status: 'exited',
+                                occurredAt: Date.now(),
+                                reason: 'process-gone',
+                            };
+                            emitter.emit({ type: 'app_exited' });
+                        }
+                        return;
+                    }
+                    if (stopPolling) {
+                        return;
+                    }
+                    await waitForNextPoll();
+                }
+            })();
+            const session = {
+                dispose: async () => {
+                    if (disposed) {
+                        return;
+                    }
+                    disposed = true;
+                    stopPolling = true;
+                    cancelPendingPollDelay();
+                    state = { status: 'disposed', occurredAt: Date.now() };
+                    emitter.clear();
+                    await stopProcess(processName);
+                    await pollTask;
+                },
+                getState: async () => state,
+                getLogs: () => [],
+                addListener: emitter.addListener,
+                removeListener: emitter.removeListener,
+            };
+            return session;
+        },
+        dispose: async () => {
+            await stopProcess(processName);
+        },
+    };
+};
+export default getWindowsRunner;

package/eslint.config.mjs

@@ -0,0 +1,23 @@
+import baseConfig from '../../eslint.config.mjs';
+
+export default [
+  ...baseConfig,
+  {
+    files: ['**/*.json'],
+    rules: {
+      '@nx/dependency-checks': [
+        'error',
+        {
+          ignoredDependencies: ['vite', 'vitest'],
+          ignoredFiles: [
+            '{projectRoot}/eslint.config.{js,cjs,mjs,ts,cts,mts}',
+            '{projectRoot}/src/**/__tests__/**',
+          ],
+        },
+      ],
+    },
+    languageOptions: {
+      parser: await import('jsonc-eslint-parser'),
+    },
+  },
+];

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@react-native-harness/platform-windows",
+  "description": "React Native Windows platform for React Native Harness",
+  "version": "1.5.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "development": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "zod": "^3.25.67",
+    "tslib": "^2.3.0",
+    "@react-native-harness/bundler-metro": "1.5.0",
+    "@react-native-harness/config": "1.5.0",
+    "@react-native-harness/tools": "1.5.0",
+    "@react-native-harness/platforms": "1.5.0"
+  },
+  "peerDependencies": {
+    "metro-config": "*",
+    "metro-resolver": "*"
+  },
+  "devDependencies": {
+    "metro-config": "*",
+    "metro-resolver": "*"
+  },
+  "license": "MIT"
+}

package/src/config.ts

@@ -0,0 +1,36 @@
+import { z } from 'zod';
+
+export const WindowsAppLaunchOptionsSchema = z.object({});
+
+export const WindowsPlatformConfigSchema = z.object({
+  name: z.string().min(1, 'Name is required'),
+  /**
+   * The app's `Identity/@Name` from `Package.appxmanifest` — e.g.
+   * `ReactNativeNitroExample`. Used to look the deployed package up with
+   * `Get-AppxPackage`.
+   */
+  packageName: z.string().min(1, 'packageName is required'),
+  /**
+   * The app's `Application/@Id` from `Package.appxmanifest`. Combined with the
+   * package family name into the AUMID used to launch the app. Defaults to
+   * `App`, which is what the React Native Windows template generates.
+   */
+  appId: z.string().min(1).optional().default('App'),
+  /**
+   * The name of the app's process (without `.exe`), for tracking whether it is
+   * still running. Defaults to `packageName`, which is correct for the RNW
+   * template.
+   */
+  processName: z.string().min(1).optional(),
+  appLaunchOptions: WindowsAppLaunchOptionsSchema.optional(),
+});
+
+export type WindowsAppLaunchOptions = z.infer<
+  typeof WindowsAppLaunchOptionsSchema
+>;
+export type WindowsPlatformConfig = z.infer<typeof WindowsPlatformConfigSchema>;
+
+/** The `WindowsPlatformConfig` before Zod applies defaults (e.g. `appId`). */
+export type WindowsPlatformConfigInput = z.input<
+  typeof WindowsPlatformConfigSchema
+>;

package/src/factory.ts

@@ -0,0 +1,13 @@
+import { HarnessPlatform } from '@react-native-harness/platforms';
+import type { WindowsPlatformConfigInput } from './config.js';
+
+export const windowsPlatform = (
+  config: WindowsPlatformConfigInput
+): HarnessPlatform<WindowsPlatformConfigInput> => ({
+  name: config.name,
+  config,
+  runner: import.meta.resolve('./runner.js'),
+  metroConfigEnhancer: import.meta.resolve('./metro-config-enhancer.js'),
+  platformId: 'windows',
+  getResourceLockKey: () => `windows:${config.packageName}`,
+});

package/src/index.ts

@@ -0,0 +1,6 @@
+export { windowsPlatform } from './factory.js';
+export type {
+  WindowsPlatformConfig,
+  WindowsPlatformConfigInput,
+  WindowsAppLaunchOptions,
+} from './config.js';

package/src/metro-config-enhancer.ts

@@ -0,0 +1,112 @@
+import { createRequire } from 'node:module';
+import { logger } from '@react-native-harness/tools';
+import type {
+  MetroConfigEnhancer,
+  MetroConfigEnhancerContext,
+} from '@react-native-harness/bundler-metro';
+import type { MetroConfig } from 'metro-config';
+import type { CustomResolutionContext, Resolution } from 'metro-resolver';
+
+const require = createRequire(import.meta.url);
+const log = logger.child('platform-windows');
+
+const RNW_PACKAGE = 'react-native-windows';
+
+type MetroResolveRequest = (
+  context: CustomResolutionContext,
+  moduleName: string,
+  platform: string | null
+) => Resolution;
+
+/**
+ * Redirects `react-native` / `react-native/*` imports to `react-native-windows`
+ * when Metro is bundling for the `windows` platform, delegating to whatever
+ * `resolveRequest` the harness has already composed.
+ *
+ * `react-native start` installs this via `@react-native/community-cli-plugin`'s
+ * `reactNativePlatformResolver`, keyed off the platform's `npmPackageName` in
+ * the React Native CLI config. The harness loads Metro's config directly and
+ * never runs that plugin, so the platform package supplies the redirect itself.
+ */
+const withWindowsPackageRedirect = (
+  next: MetroResolveRequest | undefined
+): MetroResolveRequest => {
+  const passThrough: MetroResolveRequest =
+    next ?? ((ctx, name, plat) => ctx.resolveRequest(ctx, name, plat));
+
+  return (context, moduleName, platform) => {
+    if (platform !== 'windows') {
+      return passThrough(context, moduleName, platform);
+    }
+
+    let redirected = moduleName;
+    if (moduleName === 'react-native') {
+      redirected = RNW_PACKAGE;
+    } else if (moduleName.startsWith('react-native/')) {
+      redirected = `${RNW_PACKAGE}/${moduleName.slice('react-native/'.length)}`;
+    }
+
+    return passThrough(context, redirected, platform);
+  };
+};
+
+/**
+ * Resolves `react-native-windows/Libraries/Core/InitializeCore` from the
+ * project. Without it running before the entry point a `windows` bundle never
+ * calls `setUpBatchedBridge`, so `HMRClient` is not a registered callable
+ * module and React Native Windows redboxes the instance before the harness can
+ * attach. Metro only emits a `require()` for a run-before module that ends up
+ * in the graph, so this is inert for any non-Windows bundle.
+ */
+const resolveInitializeCore = (projectRoot: string): string | null => {
+  const specifier = `${RNW_PACKAGE}/Libraries/Core/InitializeCore`;
+  try {
+    return require.resolve(specifier, { paths: [projectRoot] });
+  } catch {
+    log.warn(
+      'could not resolve %s from %s; Windows bundles may fail to initialize',
+      specifier,
+      projectRoot
+    );
+    return null;
+  }
+};
+
+const enhanceMetroConfig: MetroConfigEnhancer = (
+  metroConfig: MetroConfig,
+  { projectRoot }: MetroConfigEnhancerContext
+): MetroConfig => {
+  const initializeCore = resolveInitializeCore(projectRoot);
+  const existingRunBeforeMainModule =
+    metroConfig.serializer?.getModulesRunBeforeMainModule;
+
+  return {
+    ...metroConfig,
+    resolver: {
+      ...metroConfig.resolver,
+      platforms: [
+        ...new Set([
+          ...(metroConfig.resolver?.platforms ?? ['ios', 'android']),
+          'windows',
+          'native',
+        ]),
+      ],
+      resolveRequest: withWindowsPackageRedirect(
+        metroConfig.resolver?.resolveRequest ?? undefined
+      ),
+    },
+    serializer: {
+      ...metroConfig.serializer,
+      ...(initializeCore
+        ? {
+            getModulesRunBeforeMainModule: (entryPoint: string) => [
+              ...(existingRunBeforeMainModule?.(entryPoint) ?? []),
+              initializeCore,
+            ],
+          }
+        : {}),
+    },
+  };
+};
+
+export default enhanceMetroConfig;

package/src/pwsh.ts

@@ -0,0 +1,73 @@
+import { spawn } from '@react-native-harness/tools';
+
+/**
+ * Runs a PowerShell snippet non-interactively and returns its trimmed stdout.
+ * `-NoProfile` keeps it fast and hermetic; `-NonInteractive` makes sure it
+ * never blocks on a prompt.
+ */
+export const runPowerShell = async (script: string): Promise<string> => {
+  const { stdout } = await spawn(
+    'powershell',
+    ['-NoProfile', '-NonInteractive', '-Command', script],
+    { windowsHide: true }
+  );
+  return stdout.trim();
+};
+
+/**
+ * Resolves the PackageFamilyName of a deployed MSIX package from its identity
+ * name (`Package.appxmanifest` `Identity/@Name`). Returns `null` when the app
+ * is not deployed.
+ */
+export const getPackageFamilyName = async (
+  identityName: string
+): Promise<string | null> => {
+  const pfn = await runPowerShell(
+    `(Get-AppxPackage -Name '${identityName}' | Select-Object -First 1).PackageFamilyName`
+  );
+  return pfn === '' ? null : pfn;
+};
+
+/** Whether at least one process with the given name (no `.exe`) is running. */
+export const isProcessRunning = async (
+  processName: string
+): Promise<boolean> => {
+  try {
+    const count = await runPowerShell(
+      `(Get-Process -Name '${processName}' -ErrorAction SilentlyContinue | Measure-Object).Count`
+    );
+    return Number(count) > 0;
+  } catch {
+    return false;
+  }
+};
+
+/**
+ * Launches a deployed MSIX app by its AUMID
+ * (`<PackageFamilyName>!<Application Id>`).
+ *
+ * `explorer.exe shell:AppsFolder\<aumid>` is the reliable activation path, but
+ * `explorer.exe` almost always exits non-zero even on success, so its failure
+ * is swallowed — the caller confirms the app came up by polling for its
+ * process.
+ */
+export const launchAppByAumid = async (aumid: string): Promise<void> => {
+  try {
+    await spawn('explorer.exe', [`shell:AppsFolder\\${aumid}`], {
+      windowsHide: true,
+    });
+  } catch {
+    // Expected: explorer.exe reports a non-zero exit even on success.
+  }
+};
+
+/** Force-terminates every process with the given name. Safe to call when none exist. */
+export const stopProcess = async (processName: string): Promise<void> => {
+  try {
+    await runPowerShell(
+      `Get-Process -Name '${processName}' -ErrorAction SilentlyContinue | Stop-Process -Force`
+    );
+  } catch {
+    // Nothing to stop, or it exited between the query and the kill.
+  }
+};

package/src/runner.ts

@@ -0,0 +1,173 @@
+import {
+  createAppSessionEmitter,
+  type AppSession,
+  type AppSessionState,
+  AppNotInstalledError,
+  type HarnessPlatformRunnerFactory,
+} from '@react-native-harness/platforms';
+import type { Config as HarnessConfig } from '@react-native-harness/config';
+import { logger } from '@react-native-harness/tools';
+import {
+  WindowsPlatformConfigSchema,
+  type WindowsPlatformConfigInput,
+} from './config.js';
+import {
+  getPackageFamilyName,
+  isProcessRunning,
+  launchAppByAumid,
+  stopProcess,
+} from './pwsh.js';
+
+const log = logger.child('platform-windows');
+
+const APP_EXIT_POLL_INTERVAL_MS = 1000;
+const APP_START_POLL_INTERVAL_MS = 400;
+const APP_START_POLL_ATTEMPTS = 15;
+
+const delay = (ms: number, signal: AbortSignal) =>
+  new Promise<void>((resolve, reject) => {
+    if (signal.aborted) {
+      reject(signal.reason);
+      return;
+    }
+    const timer = setTimeout(() => {
+      signal.removeEventListener('abort', onAbort);
+      resolve();
+    }, ms);
+    const onAbort = () => {
+      clearTimeout(timer);
+      reject(signal.reason);
+    };
+    signal.addEventListener('abort', onAbort, { once: true });
+  });
+
+const getWindowsRunner: HarnessPlatformRunnerFactory<
+  WindowsPlatformConfigInput,
+  HarnessConfig
+> = async (config, _harnessConfig, init) => {
+  void _harnessConfig;
+
+  const parsedConfig = WindowsPlatformConfigSchema.parse(config);
+  const { packageName, appId } = parsedConfig;
+  const processName = parsedConfig.processName ?? packageName;
+
+  const packageFamilyName = await getPackageFamilyName(packageName);
+
+  if (packageFamilyName == null) {
+    throw new AppNotInstalledError(packageName, 'this machine');
+  }
+
+  const aumid = `${packageFamilyName}!${appId}`;
+  log.debug('resolved AUMID %s for package %s', aumid, packageName);
+
+  return {
+    createAppSession: async (): Promise<AppSession> => {
+      // Clean slate: never attach to an instance left over from a previous run.
+      await stopProcess(processName);
+      await launchAppByAumid(aumid);
+
+      // `explorer.exe` returns before the app is up (and lies about its exit
+      // code), so confirm the process actually started. `init.signal` cancels
+      // this finite readiness wait; it is not a disposal signal.
+      let started = false;
+      for (let attempt = 0; attempt < APP_START_POLL_ATTEMPTS; attempt += 1) {
+        if (await isProcessRunning(processName)) {
+          started = true;
+          break;
+        }
+        await delay(APP_START_POLL_INTERVAL_MS, init.signal);
+      }
+
+      if (!started) {
+        await stopProcess(processName);
+        throw new Error(
+          `The Windows app '${processName}' did not start after launching ${aumid}. ` +
+            `Deploy it first, e.g. \`npx react-native run-windows --arch x64 --no-launch\`.`
+        );
+      }
+
+      const emitter = createAppSessionEmitter();
+      let state: AppSessionState = { status: 'running' };
+      let disposed = false;
+      let stopPolling = false;
+      let pollDelayTimeout: ReturnType<typeof setTimeout> | null = null;
+      let resolvePollDelay: (() => void) | null = null;
+
+      // Unlike a raced delay() loser (which is fine to just discard), this
+      // wait is directly `await`ed by pollTask with nothing else racing it,
+      // so cancelling it must also resolve the promise immediately —
+      // otherwise dispose() blocks on `await pollTask` for up to
+      // APP_EXIT_POLL_INTERVAL_MS instead of returning right away.
+      const waitForNextPoll = () =>
+        new Promise<void>((resolve) => {
+          resolvePollDelay = () => {
+            resolvePollDelay = null;
+            pollDelayTimeout = null;
+            resolve();
+          };
+
+          pollDelayTimeout = setTimeout(() => {
+            resolvePollDelay?.();
+          }, APP_EXIT_POLL_INTERVAL_MS);
+        });
+
+      const cancelPendingPollDelay = () => {
+        if (pollDelayTimeout) {
+          clearTimeout(pollDelayTimeout);
+          pollDelayTimeout = null;
+        }
+
+        resolvePollDelay?.();
+      };
+
+      const pollTask = (async () => {
+        while (!stopPolling) {
+          if (!(await isProcessRunning(processName))) {
+            if (!disposed && state.status === 'running') {
+              state = {
+                status: 'exited',
+                occurredAt: Date.now(),
+                reason: 'process-gone',
+              };
+              emitter.emit({ type: 'app_exited' });
+            }
+            return;
+          }
+
+          if (stopPolling) {
+            return;
+          }
+
+          await waitForNextPoll();
+        }
+      })();
+
+      const session: AppSession = {
+        dispose: async () => {
+          if (disposed) {
+            return;
+          }
+
+          disposed = true;
+          stopPolling = true;
+          cancelPendingPollDelay();
+          state = { status: 'disposed', occurredAt: Date.now() };
+          emitter.clear();
+          await stopProcess(processName);
+          await pollTask;
+        },
+        getState: async () => state,
+        getLogs: () => [],
+        addListener: emitter.addListener,
+        removeListener: emitter.removeListener,
+      };
+
+      return session;
+    },
+    dispose: async () => {
+      await stopProcess(processName);
+    },
+  };
+};
+
+export default getWindowsRunner;

package/tsconfig.json

@@ -0,0 +1,22 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "files": [],
+  "include": [],
+  "references": [
+    {
+      "path": "../tools"
+    },
+    {
+      "path": "../platforms"
+    },
+    {
+      "path": "../config"
+    },
+    {
+      "path": "../bundler-metro"
+    },
+    {
+      "path": "./tsconfig.lib.json"
+    }
+  ]
+}

package/tsconfig.lib.json

@@ -0,0 +1,27 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "baseUrl": ".",
+    "rootDir": "src",
+    "outDir": "dist",
+    "tsBuildInfoFile": "dist/tsconfig.lib.tsbuildinfo",
+    "emitDeclarationOnly": false,
+    "forceConsistentCasingInFileNames": true,
+    "types": ["node"]
+  },
+  "include": ["src/**/*.ts"],
+  "references": [
+    {
+      "path": "../tools/tsconfig.lib.json"
+    },
+    {
+      "path": "../platforms/tsconfig.lib.json"
+    },
+    {
+      "path": "../config/tsconfig.lib.json"
+    },
+    {
+      "path": "../bundler-metro/tsconfig.lib.json"
+    }
+  ]
+}

package/vite.config.ts

@@ -0,0 +1,18 @@
+/// <reference types='vitest' />
+import { defineConfig } from 'vite';
+
+export default defineConfig(() => ({
+  root: __dirname,
+  cacheDir: '../../node_modules/.vite/packages/platform-windows',
+  test: {
+    watch: false,
+    globals: true,
+    environment: 'node',
+    include: ['{src,tests}/**/*.{test,spec}.{js,mjs,cjs,ts,mts,cts,jsx,tsx}'],
+    reporters: ['default'],
+    coverage: {
+      reportsDirectory: './test-output/vitest/coverage',
+      provider: 'v8' as const,
+    },
+  },
+}));