Support bundling node native modules (#10066)

parcel-bundler · Jan 2, 2025 · 4f3bcaa · 4f3bcaa
1 parent 1dd802c
commit 4f3bcaa
Show file tree

Hide file tree

Showing 11 changed files with 222 additions and 29 deletions.
diff --git a/packages/configs/default/index.json b/packages/configs/default/index.json
@@ -44,6 +44,7 @@
     ],
     "*.svg": ["@parcel/transformer-svg"],
     "*.{xml,rss,atom}": ["@parcel/transformer-xml"],
+    "*.node": ["@parcel/transformer-node"],
     "url:*": ["...", "@parcel/transformer-raw"]
   },
   "namers": ["@parcel/namer-default"],

diff --git a/packages/configs/default/package.json b/packages/configs/default/package.json
@@ -44,6 +44,7 @@
     "@parcel/transformer-image": "2.13.3",
     "@parcel/transformer-js": "2.13.3",
     "@parcel/transformer-json": "2.13.3",
+    "@parcel/transformer-node": "2.13.3",
     "@parcel/transformer-postcss": "2.13.3",
     "@parcel/transformer-posthtml": "2.13.3",
     "@parcel/transformer-raw": "2.13.3",

diff --git a/packages/core/integration-tests/test/javascript.js b/packages/core/integration-tests/test/javascript.js
@@ -6231,4 +6231,52 @@ describe('javascript', function () {
       assert.equal(res.result, 2);
     });
   }
+
+  for (let defaultTargetOptions of [
+    {shouldScopeHoist: false},
+    {shouldScopeHoist: true, outputFormat: 'commonjs'},
+    {shouldScopeHoist: true, outputFormat: 'esmodule'},
+  ]) {
+    it(
+      'supports native .node modules with options: ' +
+        JSON.stringify(defaultTargetOptions),
+      async function () {
+        await fsFixture(overlayFS, __dirname)`
+        native-node
+          index.js:
+            output = require('@parcel/rust');
+            
+          package.json:
+            {
+              "targets": {
+                "default": {
+                  "context": "node",
+                  "includeNodeModules": true
+                }
+              }
+            }
+            
+          yarn.lock:`;
+
+        let b = await bundle(path.join(__dirname, 'native-node/index.js'), {
+          defaultTargetOptions,
+          inputFS: overlayFS,
+          outputFS: inputFS,
+        });
+
+        let res = await run(
+          b,
+          {output: null},
+          {require: false},
+          {
+            fs: () => require('fs'),
+            path: () => require('path'),
+            module: () => require('module'),
+            url: () => require('url'),
+          },
+        );
+        assert.equal(typeof res.output.hashString, 'function');
+      },
+    );
+  }
 });
diff --git a/packages/core/integration-tests/test/svg.js b/packages/core/integration-tests/test/svg.js
@@ -314,7 +314,7 @@ describe('svg', function () {
 
     assertBundles(b, [
       {
-        assets: ['index.js', 'bundle-url.js'],
+        assets: ['index.js'],
       },
       {
         assets: ['circle.svg'],

diff --git a/packages/core/test-utils/src/utils.js b/packages/core/test-utils/src/utils.js
@@ -365,6 +365,9 @@ export async function runBundles(
       overlayFS,
       externalModules,
       true,
+      target === 'node' ||
+        target === 'electron-main' ||
+        target === 'react-server',
     );
 
     esmOutput = bundles.length === 1 ? res[0] : res;
@@ -927,6 +930,9 @@ function prepareNodeContext(
           readFileSync: (file, encoding) => {
             return overlayFS.readFileSync(file, encoding);
           },
+          existsSync: file => {
+            return overlayFS.existsSync(file);
+          },
         };
       }
 
@@ -939,6 +945,11 @@ function prepareNodeContext(
         return {};
       }
 
+      if (path.extname(res) === '.node') {
+        // $FlowFixMe[unsupported-syntax]
+        return require(res);
+      }
+
       let cached = nodeCache.get(res);
       if (cached) {
         return cached.module.exports;
@@ -1002,6 +1013,7 @@ export async function runESM(
   fs: FileSystem,
   externalModules: ExternalModules = {},
   requireExtensions: boolean = false,
+  isNode: boolean = false,
 ): Promise<Array<{|[string]: mixed|}>> {
   let id = instanceId++;
   let cache = new Map();
@@ -1048,7 +1060,11 @@ export async function runESM(
           entry(specifier, referrer),
         context,
         initializeImportMeta(meta) {
-          meta.url = `http://localhost/${path.basename(filename)}`;
+          if (isNode) {
+            meta.url = url.pathToFileURL(filename).toString();
+          } else {
+            meta.url = `http://localhost/${path.basename(filename)}`;
+          }
         },
       });
       cache.set(filename, m);

diff --git a/packages/runtimes/js/src/JSRuntime.js b/packages/runtimes/js/src/JSRuntime.js
@@ -193,10 +193,23 @@ export default (new Runtime({
         .find(e => e.id === bundleGroup.entryAssetId);
       if (
         dependency.specifierType === 'url' ||
-        mainBundle.type !== 'js' ||
         mainAsset?.meta.jsRuntime === 'url'
       ) {
         assets.push(getURLRuntime(dependency, bundle, mainBundle, options));
+        continue;
+      }
+
+      if (mainBundle.type === 'node' && mainBundle.env.isNode()) {
+        let relativePathExpr = getAbsoluteUrlExpr(
+          getRelativePathExpr(bundle, mainBundle, options),
+          mainBundle,
+        );
+        assets.push({
+          filePath: __filename,
+          code: `module.exports = require('./helpers/node/node-loader.js')(${relativePathExpr});`,
+          dependency,
+          env: {sourceType: 'module'},
+        });
       }
     }
 
@@ -655,7 +668,8 @@ function getAbsoluteUrlExpr(relativePathExpr: string, bundle: NamedBundle) {
   if (
     (bundle.env.outputFormat === 'esmodule' &&
       bundle.env.supports('import-meta-url')) ||
-    bundle.env.outputFormat === 'commonjs'
+    bundle.env.outputFormat === 'commonjs' ||
+    bundle.env.isNode()
   ) {
     // This will be compiled to new URL(url, import.meta.url) or new URL(url, 'file:' + __filename).
     return `new __parcel__URL__(${relativePathExpr}).toString()`;

diff --git a/packages/runtimes/js/src/helpers/node/node-loader.js b/packages/runtimes/js/src/helpers/node/node-loader.js
@@ -0,0 +1,8 @@
+const url = require('url');
+const {createRequire} = require('module');
+
+module.exports = function loadNodeModule(bundle) {
+  let path = url.fileURLToPath(bundle);
+  let require = createRequire(path);
+  return require(path);
+};
diff --git a/packages/transformers/js/core/src/lib.rs b/packages/transformers/js/core/src/lib.rs
@@ -485,10 +485,11 @@ pub fn transform(
                     source_map: source_map.clone(),
                     items: &mut global_deps,
                     global_mark,
-                    globals: HashMap::new(),
+                    globals: IndexMap::new(),
                     filename: Path::new(&config.filename),
                     unresolved_mark,
                     has_node_replacements: &mut result.has_node_replacements,
+                    is_esm: config.is_esm_output,
                   },
                   config.node_replacer(),
                 ),