vite-plugin-cjs-interop weekly downloads statistics

vite-plugin-cjs-interop

Vite plugin to unwrap default imports from CJS dependencies during SSR.

Problem

In Node.js, when a CJS module that contains both a default export and named exports is imported from an ESM module, the default export has to be accessed via the default property of the imported module. Prior to version 5, Vite had some logic to handle this during development, but it didn't apply to SSR builds with external CJS dependencies. Since Vite 5, the problem happens in development as well. You don't get any indication that it won't work in production. TypeScript doesn't complain either.

Solution

This plugin will automatically unwrap the default export from CJS dependencies that you specify during SSR builds. In other words, the following code:

will be transformed into:

which takes care of unwrapping the default export and creating a synthetic default export if necessary.

The change for dynamic imports is more complicated, but allows the import() function to resolve to an object that not only resembles the standard ES6 namespace as expected, but also a CommonJS export:

Installation

Usage

The matcher uses minimatch underneath, for more details on supported syntax.

Compatibility

We currently test the plugin end-to-end (both SSR and client, in both vite build and vite dev modes) against the latest patch of:

• Vite 5, 6, 7, and 8 — specifically the most recent release in the ~5, ~6.4, ~7.3, and 8 ranges. • Node 22, 24, 25, and 26 on Linux; Node 24 on macOS and Windows.

Support policy

• For Vite, we try to follow Vite's own support window: the latest major plus the latest minor of each of the two preceding majors. • For Node, we try to follow Node's own support window: latest patches of "LTS" and "current" releases.

Note that we still test against Vite 5 but it's not an officially supported version. We'll try to keep testing against it as long as it doesn't require any special handling.

License

MIT

Description from the npm listing.