Close two test gaps: unverified prebuild Info.plist and a missing .node fixture

verify-prebuilds.mts now parses each Apple framework's Info.plist and
asserts CFBundleExecutable/CFBundleIdentifier match what
writeFrameworkInfoPlist wrote, instead of skipping the file.

The Babel plugin test for "does not touch required JS files" now includes
a sibling my-addon.apple.node next to my-addon.js, so the assertion is
exercised rather than vacuously true. That exposed a real bug:
isNodeApiModule didn't check whether a same-named .js/.cjs/.mjs/.json file
would already satisfy the require() before ever considering a .node
prebuild, so the plugin could rewrite a require() call that Node's own
resolution would never route to the addon. Fixed to defer to a colliding
source file, matching Node's own module resolution order.

Closes #424

Author: claude

.changeset/babel-plugin-js-precedence.md

@@ -0,0 +1,14 @@
+---
+"react-native-node-api": patch
+---
+
+Fix the Babel plugin rewriting `require(...)` calls that resolve to a
+same-named `.js`/`.cjs`/`.mjs`/`.json` file sitting next to a Node-API
+prebuild. Node's own module resolution always picks the source file over a
+`.node` addon in that case, so the plugin now leaves those calls alone
+instead of rewriting them to `requireNodeAddon(...)`, which would have loaded
+the wrong module at runtime.
+
+Also exports `escapeBundleIdentifier`, used internally to derive a
+framework's `CFBundleIdentifier`, so it can be reused to verify one against
+its expected value.

packages/host/src/node/babel-plugin/plugin.test.ts

@@ -129,7 +129,8 @@ describe("plugin", () => {
     itTransforms("and does not touch required JS files", {
       files: {
         "package.json": `{ "name": "my-package" }`,
-        // TODO: Add a ./my-addon.node to make this test complete
+        "my-addon.apple.node/my-addon.node":
+          "// This is supposed to be a binary file",
         "my-addon.js": "// Some JS file",
         "index.js": `
           const addon = require('./my-addon');

packages/host/src/node/index.ts

@@ -20,6 +20,7 @@ export {
   createXCframework,
   createUniversalAppleLibrary,
   determineXCFrameworkFilename,
+  escapeBundleIdentifier,
 } from "./prebuilds/apple.js";
 
 export {

packages/host/src/node/path-utils.ts

@@ -59,18 +59,37 @@ export type NamingStrategy = {
 // Cache mapping package directory to package name across calls
 const packageNameCache = new Map<string, string>();
 
+/**
+ * Extensions Node's own `require()` resolves before it would ever consider `.node` -
+ * see https://nodejs.org/api/modules.html#file-modules. A colliding file always wins,
+ * so a module path resolving to one of these isn't ours to rewrite.
+ */
+const JS_RESOLVABLE_EXTENSIONS = [".js", ".cjs", ".mjs", ".json"];
+
 /**
  * @param modulePath  Batch-scans the path to the module to check (must be extensionless or end in .node)
  * @returns True if a platform specific prebuild exists for the module path, warns on unreadable modules.
  * @throws If the parent directory cannot be read, or if a detected module is unreadable.
  * TODO: Consider checking for a specific platform extension.
  */
 export function isNodeApiModule(modulePath: string): boolean {
+  const hasExplicitNodeExtension = modulePath.endsWith(".node");
+  if (!hasExplicitNodeExtension) {
+    const dir = path.dirname(modulePath);
+    const baseName = path.basename(modulePath);
+    if (
+      JS_RESOLVABLE_EXTENSIONS.some((extension) =>
+        fs.existsSync(path.join(dir, baseName + extension)),
+      )
+    ) {
+      return false;
+    }
+  }
   {
     // HACK: Take a shortcut (if applicable): existing `.node` files are addons
     try {
       fs.accessSync(
-        modulePath.endsWith(".node") ? modulePath : `${modulePath}.node`,
+        hasExplicitNodeExtension ? modulePath : `${modulePath}.node`,
       );
       return true;
     } catch {

packages/node-addon-examples/package.json

@@ -30,6 +30,7 @@
     "bootstrap": "node --run copy-and-build"
   },
   "devDependencies": {
+    "@expo/plist": "0.4.7",
     "cmake-rn": "workspace:*",
     "node-addon-examples": "github:nodejs/node-addon-examples#4b7dd86a85644610e6de80154df9acac9329b509",
     "gyp-to-cmake": "workspace:*",

packages/node-addon-examples/scripts/verify-prebuilds.mts

@@ -2,8 +2,15 @@ import fs from "node:fs";
 import assert from "node:assert/strict";
 import path from "node:path";
 
+import plistPackage from "@expo/plist";
+import { escapeBundleIdentifier } from "react-native-node-api";
+
 import { DIRS } from "./cmake-projects.mjs";
 
+// `@expo/plist` is CommonJS; under Node's ESM interop the default import lands
+// one level deeper than TS's `esModuleInterop` cjs-compiled callers see it.
+const plist = plistPackage.default;
+
 const EXPECTED_ANDROID_ARCHS = ["armeabi-v7a", "arm64-v8a", "x86_64", "x86"];
 
 const EXPECTED_XCFRAMEWORK_PLATFORMS = [
@@ -37,6 +44,29 @@ async function verifyAndroidPrebuild(dirent: fs.Dirent) {
   }
 }
 
+/**
+ * Asserts an Info.plist matches what `writeFrameworkInfoPlist` (in
+ * `packages/host/src/node/prebuilds/apple.ts`) writes for a framework named
+ * `libraryName`, built without a custom `--apple-bundle-identifier`.
+ */
+async function verifyFrameworkInfoPlist(
+  infoPlistPath: string,
+  libraryName: string,
+) {
+  const contents = await fs.promises.readFile(infoPlistPath, "utf8");
+  const infoPlist = plist.parse(contents) as Record<string, unknown>;
+  assert.equal(
+    infoPlist.CFBundleExecutable,
+    libraryName,
+    `Unexpected CFBundleExecutable in ${infoPlistPath}`,
+  );
+  assert.equal(
+    infoPlist.CFBundleIdentifier,
+    escapeBundleIdentifier(`com.callstackincubator.node-api.${libraryName}`),
+    `Unexpected CFBundleIdentifier in ${infoPlistPath}`,
+  );
+}
+
 async function verifyApplePrebuild(dirent: fs.Dirent) {
   console.log("Verifying Apple prebuild", dirent.name, "in", dirent.parentPath);
   for (const arch of EXPECTED_XCFRAMEWORK_PLATFORMS) {
@@ -50,6 +80,7 @@ async function verifyApplePrebuild(dirent: fs.Dirent) {
       );
       assert(file.name.endsWith(".framework"), "Expected framework directory");
       const frameworkDir = path.join(file.parentPath, file.name);
+      const libraryName = path.basename(file.name, ".framework");
       for (const file of await fs.promises.readdir(frameworkDir, {
         withFileTypes: true,
       })) {
@@ -65,8 +96,10 @@ async function verifyApplePrebuild(dirent: fs.Dirent) {
             "Expected only directory and files in framework",
           );
           if (file.name === "Info.plist") {
-            // TODO: Verify the contents of the Info.plist file
-            continue;
+            await verifyFrameworkInfoPlist(
+              path.join(frameworkDir, file.name),
+              libraryName,
+            );
           } else {
             assert(
               !file.name.endsWith(".node"),