import-in-the-middle 1.14.4 → 2.0.0

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## [2.0.0](https://github.com/nodejs/import-in-the-middle/compare/import-in-the-middle-v1.15.0...import-in-the-middle-v2.0.0) (2025-10-14)
+
+
+### ⚠ BREAKING CHANGES
+
+Converting all modules running in the loader thread to ESM should not be a
+breaking change for most users since it primarily affects internal implementation
+details. However, if you were referencing internal CJS files like `hook.js` this will no longer work.
+
+### Features
+
+* convert all modules running in loader thread to ESM ([#210](https://github.com/nodejs/import-in-the-middle/issues/210)) ([da7c7a6](https://github.com/nodejs/import-in-the-middle/commit/da7c7a6904a40bf394b7b2a271a2838711c5417c))
+
+## [1.15.0](https://github.com/nodejs/import-in-the-middle/compare/import-in-the-middle-v1.14.4...import-in-the-middle-v1.15.0) (2025-10-09)
+
+
+### Features
+
+* Compatibility with specifier imports  ([#211](https://github.com/nodejs/import-in-the-middle/issues/211)) ([83d662a](https://github.com/nodejs/import-in-the-middle/commit/83d662a8e1f9a7b8632bc78f7499ccc0ab4d12c2))
+
 ## [1.14.4](https://github.com/nodejs/import-in-the-middle/compare/import-in-the-middle-v1.14.3...import-in-the-middle-v1.14.4) (2025-09-25)
 
 

package/{hook.js → create-hook.mjs}

@@ -2,9 +2,11 @@
 //
 // This product includes software developed at Datadog (https://www.datadoghq.com/). Copyright 2021 Datadog, Inc.
 
-const { URL, fileURLToPath } = require('url')
-const { inspect } = require('util')
-const { builtinModules } = require('module')
+import { URL, fileURLToPath } from 'url'
+import { inspect } from 'util'
+import { builtinModules } from 'module'
+import { getExports as getExportsImpl } from './lib/get-exports.mjs'
+
 const specifiers = new Map()
 const isWin = process.platform === 'win32'
 let experimentalPatchInternals = false
@@ -17,15 +19,15 @@ const NODE_MAJOR = Number(NODE_VERSION[0])
 const NODE_MINOR = Number(NODE_VERSION[1])
 const HANDLED_FORMATS = new Set(['builtin', 'module', 'commonjs'])
 
-let entrypoint
-
 let getExports
 if (NODE_MAJOR >= 20 || (NODE_MAJOR === 18 && NODE_MINOR >= 19)) {
-  getExports = require('./lib/get-exports.js')
+  getExports = getExportsImpl
 } else {
   getExports = (url) => import(url).then(Object.keys)
 }
 
+let entrypoint
+
 function hasIitm (url) {
   try {
     return new URL(url).searchParams.has('iitm')
@@ -35,7 +37,7 @@ function hasIitm (url) {
 }
 
 function isIitm (url, meta) {
-  return url === meta.url || url === meta.url.replace('hook.mjs', 'hook.js')
+  return url === meta.url || url === meta.url.replace('hook.mjs', 'create-hook.mjs')
 }
 
 function deleteIitm (url) {
@@ -284,7 +286,7 @@ function addIitm (url) {
   return needsToAddFileProtocol(urlObj) ? 'file:' + urlObj.href : urlObj.href
 }
 
-function createHook (meta) {
+export function createHook (meta) {
   let cachedResolve
   const iitmURL = new URL('lib/register.js', meta.url).toString()
   let includeModules, excludeModules
@@ -494,5 +496,3 @@ register(${JSON.stringify(realUrl)}, _, set, get, ${JSON.stringify(specifiers.ge
     }
   }
 }
-
-module.exports = { createHook }

package/hook.mjs

@@ -2,7 +2,7 @@
 //
 // This product includes software developed at Datadog (https://www.datadoghq.com/). Copyright 2021 Datadog, Inc.
 
-import { createHook } from './hook.js'
+import { createHook } from './create-hook.mjs'
 
 const { initialize, load, resolve, getFormat, getSource } = createHook(import.meta)
 

package/lib/{get-esm-exports.js → get-esm-exports.mjs}

@@ -1,7 +1,7 @@
 'use strict'
 
-const { Parser } = require('acorn')
-const { importAttributesOrAssertions } = require('acorn-import-attributes')
+import { Parser } from 'acorn'
+import { importAttributesOrAssertions } from 'acorn-import-attributes'
 
 const acornOpts = {
   ecmaVersion: 'latest',
@@ -32,7 +32,7 @@ function warn (txt) {
  * @returns {Set<string>} The identifiers exported by the module along with any
  * custom directives.
  */
-function getEsmExports (moduleSource) {
+export default function getEsmExports (moduleSource) {
   const exportedNames = new Set()
   const tree = parser.parse(moduleSource, acornOpts)
   for (const node of tree.body) {
@@ -114,5 +114,3 @@ function parseSpecifiers (node, exportedNames) {
     }
   }
 }
-
-module.exports = getEsmExports

package/lib/{get-exports.js → get-exports.mjs}

@@ -1,11 +1,13 @@
 'use strict'
 
-const getEsmExports = require('./get-esm-exports.js')
-const { parse: parseCjs } = require('cjs-module-lexer')
-const { readFileSync } = require('fs')
-const { builtinModules } = require('module')
-const { fileURLToPath, pathToFileURL } = require('url')
-const { dirname } = require('path')
+import getEsmExports from './get-esm-exports.mjs'
+import { parse as parseCjs, init as parserInit } from 'cjs-module-lexer'
+import { readFileSync, existsSync } from 'fs'
+import { builtinModules, createRequire } from 'module'
+import { fileURLToPath, pathToFileURL } from 'url'
+import { dirname, join } from 'path'
+
+let parserInitialized = false
 
 function addDefault (arr) {
   return new Set(['default', ...arr])
@@ -14,9 +16,15 @@ function addDefault (arr) {
 // Cached exports for Node built-in modules
 const BUILT_INS = new Map()
 
+let require
+
 function getExportsForNodeBuiltIn (name) {
   let exports = BUILT_INS.get()
 
+  if (!require) {
+    require = createRequire(import.meta.url)
+  }
+
   if (!exports) {
     exports = new Set(addDefault(Object.keys(require(name))))
     BUILT_INS.set(name, exports)
@@ -27,6 +35,62 @@ function getExportsForNodeBuiltIn (name) {
 
 const urlsBeingProcessed = new Set() // Guard against circular imports.
 
+/**
+ * This function looks for the package.json which contains the specifier trying to resolve.
+ * Once the package.json file has been found, we extract the file path from the specifier
+ * @param {string} specifier The specifier that is being search for inside the imports object
+ * @param {URL|string} fromUrl The url from which the search starts from
+ * @returns array with url and resolvedExport
+ */
+function resolvePackageImports (specifier, fromUrl) {
+  try {
+    const fromPath = fileURLToPath(fromUrl)
+    let currentDir = dirname(fromPath)
+
+    // search for package.json file which has the real url to export
+    while (currentDir !== dirname(currentDir)) {
+      const packageJsonPath = join(currentDir, 'package.json')
+
+      if (existsSync(packageJsonPath)) {
+        const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf8'))
+        if (packageJson.imports && packageJson.imports[specifier]) {
+          const imports = packageJson.imports[specifier]
+
+          // Look for path inside packageJson
+          let resolvedExport
+          if (imports && typeof imports === 'object') {
+            const requireExport = imports.require
+            const importExport = imports.import
+            // look for the possibility of require and import which is standard for CJS/ESM
+            if (requireExport || importExport) {
+              // trying to resolve based on order of importance
+              resolvedExport = requireExport.node || requireExport.default || importExport.node || importExport.default
+            } else if (imports.node || imports.default) {
+              resolvedExport = imports.node || imports.default
+            }
+          } else if (typeof imports === 'string') {
+            resolvedExport = imports
+          }
+
+          if (resolvedExport) {
+            const url = resolvedExport.startsWith('.')
+              ? pathToFileURL(join(currentDir, resolvedExport))
+              : fromUrl
+            return [url, resolvedExport]
+          }
+        }
+        // return if we find a package.json but did not find an import
+        return null
+      }
+
+      currentDir = dirname(currentDir)
+    }
+  } catch (cause) {
+    throw Error(`Failed to find export: ${specifier}`, { cause })
+  }
+  return null
+}
+
 async function getCjsExports (url, context, parentLoad, source) {
   if (urlsBeingProcessed.has(url)) {
     return []
@@ -34,6 +98,10 @@ async function getCjsExports (url, context, parentLoad, source) {
   urlsBeingProcessed.add(url)
 
   try {
+    if (!parserInitialized) {
+      await parserInit()
+      parserInitialized = true
+    }
     const result = parseCjs(source)
     const full = addDefault(result.exports)
 
@@ -46,7 +114,18 @@ async function getCjsExports (url, context, parentLoad, source) {
         if (re === '.') {
           re = './'
         }
+
+        // Entries in the import field should always start with #
+        if (re.startsWith('#')) {
+          const resolved = resolvePackageImports(re, url)
+          if (!resolved) return
+          [url, re] = resolved
+        }
+
         // Resolve the re-exported module relative to the current module.
+        if (!require) {
+          require = createRequire(import.meta.url)
+        }
         const newUrl = pathToFileURL(require.resolve(re, { paths: [dirname(fileURLToPath(url))] })).href
 
         if (newUrl.endsWith('.node') || newUrl.endsWith('.json')) {
@@ -81,7 +160,7 @@ async function getCjsExports (url, context, parentLoad, source) {
  * Please see {@link getEsmExports} for caveats on special identifiers that may
  * be included in the result set.
  */
-async function getExports (url, context, parentLoad) {
+export async function getExports (url, context, parentLoad) {
   // `parentLoad` gives us the possibility of getting the source
   // from an upstream loader. This doesn't always work though,
   // so later on we fall back to reading it from disk.
@@ -125,5 +204,3 @@ async function getExports (url, context, parentLoad) {
     throw err
   }
 }
-
-module.exports = getExports

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "import-in-the-middle",
-  "version": "1.14.4",
+  "version": "2.0.0",
   "description": "Intercept imports in Node.js",
   "main": "index.js",
   "scripts": {

package/.editorconfig

@@ -1,14 +0,0 @@
-# http://editorconfig.org
-
-root = true
-
-[*]
-indent_style = space
-indent_size = 2
-end_of_line = lf
-charset = utf-8
-trim_trailing_whitespace = true
-insert_final_newline = true
-
-[*.md]
-trim_trailing_whitespace = false

package/.eslintrc.yaml

@@ -1,26 +0,0 @@
-overrides:
-  - files:
-    - '**/*.{js,cjs,mjs}'
-
-parser: '@babel/eslint-parser'
-parserOptions:
-  ecmaVersion: latest
-  requireConfigFile: false
-  sourceType: 'script'
-  babelOptions:
-    plugins:
-      - '@babel/plugin-syntax-import-assertions'
-
-rules:
-  "import/first": off
-
-extends:
-  - "standard"
-
-ignorePatterns:
-  - test/fixtures/circular-a.js
-  - test/fixtures/circular-b.js
-  - test/fixtures/reexport.js
-  - test/fixtures/duplicate-explicit.mjs
-  - test/fixtures/duplicate.mjs
-  - test/fixtures/export-types/default-call-expression-renamed.mjs

package/.release-please-manifest.json

@@ -1,3 +0,0 @@
-{
-  ".": "1.14.4"
-}

package/release-please-config.json

@@ -1,10 +0,0 @@
-{
-  "$schema": "https://raw.githubusercontent.com/googleapis/release-please/main/schemas/config.json",
-  "bootstrap-sha": "57d2459748492abd55e04a679d8b5752b90dfab4",
-  "packages": {
-    ".": {
-      "pull-request-title-pattern": "chore: release v${version}",
-      "release-type": "node"
-    }
-  }
-}

package/test/README.md

@@ -1,17 +0,0 @@
-These tests are organized as follows:
-
-* Located in the `hook` directory if they use the `Hook` class.
-* Located in the `low-level` directory if they use the "low-level" API,
-  `addHook` and `removeHook`.
-* Other tests are in other adjacent directories.
-
-The tests can be run individually as Node.js programs with non-zero exit codes
-upon failures. They should be run with the following Node.js command-line
-options (assuming they're run from the project root):
-
-```
---require ./test/version-check.js
---experimental-loader ./test/generic-loader.mjs
-```
-
-The entire test suite can be run with `npm test`.

package/test/check-exports/test.mjs

@@ -1,317 +0,0 @@
-import { spawnSync } from 'child_process'
-import { deepStrictEqual } from 'assert'
-import { dirname, resolve } from 'path'
-import { fileURLToPath } from 'url'
-
-const cwd = dirname(fileURLToPath(import.meta.url))
-const hook = resolve(cwd, '..', '..', 'hook.mjs')
-
-const mostPopular240NpmModules = [
-  'ansi-styles',
-  'semver',
-  'supports-color',
-  'chalk', 'has-flag',
-  'debug',
-  'tslib',
-  'color-convert',
-  'ms',
-  'color-name',
-  'lru-cache',
-  'minimatch',
-  'strip-ansi',
-  'source-map',
-  'ansi-regex',
-  'glob',
-  'readable-stream',
-  'commander',
-  'yallist',
-  'string-width',
-  'escape-string-regexp',
-  'brace-expansion',
-  'find-up',
-  'p-locate',
-  'locate-path',
-  'wrap-ansi',
-  'p-limit',
-  'safe-buffer',
-  'kind-of',
-  'minipass',
-  'uuid',
-  'string_decoder',
-  'ajv',
-  'emoji-regex',
-  'isarray',
-  'react-is',
-  'fs-extra',
-  'is-fullwidth-code-point',
-  'get-stream',
-  'json-schema-traverse',
-  'yargs-parser',
-  'glob-parent',
-  'yargs',
-  'rimraf',
-  'acorn',
-  'which',
-  'estraverse',
-  'js-yaml',
-  'path-exists',
-  'argparse',
-  'pretty-format',
-  'resolve-from',
-  'cliui',
-  'schema-utils',
-  'globals',
-  'camelcase',
-  'execa',
-  'punycode',
-  'path-key',
-  'signal-exit',
-  'inherits',
-  'resolve',
-  'mkdirp',
-  'is-stream',
-  'ws',
-  'universalify',
-  'qs',
-  'slash',
-  'json5',
-  'iconv-lite',
-  'form-data',
-  'is-number',
-  'eslint-visitor-keys',
-  '@jest/types',
-  'postcss',
-  'make-dir',
-  'pify',
-  'cross-spawn',
-  'braces',
-  'whatwg-url',
-  'fill-range',
-  'eslint-scope',
-  'tr46',
-  'micromatch',
-  'convert-source-map',
-  'define-property',
-  'agent-base',
-  'shebang-regex',
-  'shebang-command',
-  'mimic-fn',
-  'globby',
-  'npm-run-path',
-  'mime',
-  '@babel/code-frame',
-  'extend-shallow',
-  'to-regex-range',
-  'onetime',
-  'https-proxy-agent',
-  'y18n',
-  'buffer',
-  'strip-bom',
-  'is-glob',
-  'doctrine',
-  'picocolors',
-  'pkg-dir',
-  '@babel/types',
-  'regenerator-runtime',
-  'human-signals',
-  '@jridgewell/trace-mapping',
-  'ignore',
-  'jsesc',
-  'parse-json',
-  'jest-worker',
-  'graceful-fs',
-  'jest-util',
-  'jsonfile',
-  'normalize-path',
-  'strip-json-comments',
-  'cosmiconfig',
-  'minimist',
-  'path-type',
-  '@babel/parser',
-  'balanced-match',
-  'picomatch',
-  'typescript',
-  'isexe',
-  'statuses',
-  'entities',
-  'bytes',
-  'node-fetch',
-  'http-errors',
-  '@babel/highlight',
-  '@babel/helper-validator-identifier',
-  'function-bind',
-  'async',
-  'sprintf-js',
-  '@babel/generator',
-  'is-extendable',
-  'get-intrinsic',
-  'lodash',
-  'mime-db',
-  'source-map-support',
-  'mime-types',
-  'is-arrayish',
-  '@babel/core',
-  'once',
-  'anymatch',
-  'depd',
-  'hosted-git-info',
-  'path-to-regexp',
-  'axios',
-  'is-core-module',
-  '@babel/template',
-  'cookie',
-  'write-file-atomic',
-  'js-tokens',
-  '@typescript-eslint/typescript-estree',
-  '@typescript-eslint/types',
-  'object-inspect',
-  'wrappy',
-  'is-extglob',
-  'chokidar',
-  '@typescript-eslint/visitor-keys',
-  'call-bind',
-  'loader-utils',
-  'browserslist',
-  'http-proxy-agent',
-  'fast-glob',
-  'concat-map',
-  'inflight',
-  'ajv-keywords',
-  'ansi-escapes',
-  'ci-info',
-  'fast-deep-equal',
-  'caniuse-lite',
-  'fs.realpath',
-  '@jridgewell/gen-mapping',
-  'setprototypeof',
-  'strip-final-newline',
-  'optionator',
-  'path-is-absolute',
-  '@babel/traverse',
-  'core-util-is',
-  'has-symbols',
-  'yocto-queue',
-  'p-try',
-  'electron-to-chromium',
-  '@smithy/smithy-client',
-  'yaml',
-  'ini',
-  '@babel/helper-plugin-utils',
-  'jest-get-type',
-  'type-check',
-  'levn',
-  'is-descriptor',
-  'prelude-ls',
-  'slice-ansi',
-  '@typescript-eslint/scope-manager',
-  'isobject',
-  'esprima',
-  '@babel/helper-split-export-declaration',
-  'callsites',
-  'readdirp',
-  'escalade',
-  'import-fresh',
-  'get-caller-file',
-  '@jridgewell/sourcemap-codec',
-  'acorn-walk',
-  'rxjs',
-  'ieee754',
-  'is-plain-obj',
-  'istanbul-lib-instrument',
-  '@babel/helper-module-imports',
-  'side-channel',
-  'normalize-package-data',
-  'is-plain-object',
-  '@jridgewell/resolve-uri',
-  'follow-redirects',
-  'array-union',
-  'json-parse-even-better-errors',
-  'path-parse',
-  'has-property-descriptors',
-  'uri-js',
-  'safer-buffer',
-  '@babel/helpers',
-  'on-finished',
-  '@babel/helper-function-name',
-  'p-map',
-  'postcss-value-parser',
-  'indent-string',
-  '@babel/helper-module-transforms',
-  'object-assign',
-  'delayed-stream',
-  '@nodelib/fs.stat',
-  'require-directory',
-  'diff',
-  'parse5',
-  'asynckit',
-  'tmp',
-  'combined-stream'
-]
-
-const otherCommonModulesUsedWithInstrumentation = [
-  'express',
-  'fastify',
-  '@hapi/hapi',
-  'connect',
-  'svelte',
-  '@sveltejs/kit',
-  'next',
-  'gatsby',
-  '@remix-run/node',
-  '@remix-run/react'
-]
-
-const modules = [...mostPopular240NpmModules, ...otherCommonModulesUsedWithInstrumentation]
-
-function installLibs (names) {
-  spawnSync('npm', ['init', '-y'], { cwd })
-  spawnSync('npm', ['install', ...names], { cwd })
-}
-
-function getExports (name, loader) {
-  const args = ['--input-type=module', '--no-warnings', '-e', `import * as lib from '${name}'; console.log(JSON.stringify(Object.keys(lib)))`]
-  if (loader) args.push(loader)
-  const out = spawnSync(process.execPath, args, { cwd })
-  if (out.status !== 0) {
-    console.error(out.stderr.toString())
-    throw new Error(`Getting exports returned non-zero exit code '${name}'`)
-  }
-  const stdout = out.stdout.toString()
-  return JSON.parse(stdout).sort()
-}
-
-const NPM_LIST_SEMVER_PARSE = /└──.*@((0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\+([0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*))?)/
-
-function getVersion (name) {
-  const result = spawnSync('npm', ['list', name, '--depth', '0'], { cwd })
-  const stdout = result.output.toString()
-  const [, version] = stdout.match(NPM_LIST_SEMVER_PARSE)
-  return version
-}
-
-function testLib (name) {
-  const version = getVersion(name)
-  try {
-    const expected = getExports(name)
-    const actual = getExports(name, `--experimental-loader=${hook}`)
-    deepStrictEqual(actual, expected, `Exports for ${name} are different`)
-    console.log(`✅  Exports for ${name}@${version} match`)
-    return false
-  } catch (err) {
-    console.error(`❌  Error getting exports for ${name}@${version}:`, err)
-    return true
-  }
-}
-
-console.log(`📦  Installing ${modules.length} libraries...`)
-installLibs(modules)
-
-let errored = false
-for (const mod of modules) {
-  errored += testLib(mod)
-}
-
-if (errored) {
-  console.error('❌  Some tests failed')
-  process.exit(1)
-}

package/test/fixtures/a.mjs

@@ -1,7 +0,0 @@
-export const a = 'a'
-
-export function aFunc () {
-  return a
-}
-
-export * from './foo.mjs'

package/test/fixtures/b.mjs

@@ -1,5 +0,0 @@
-export const b = 'b'
-
-export function bFunc () {
-  return b
-}

package/test/fixtures/bundle.mjs

@@ -1,4 +0,0 @@
-import bar from './something.mjs'
-export default bar
-export * from './a.mjs'
-export * from './b.mjs'