Cannot find module './auth.js' from 'node_modules/@vonage/auth/dist/cjs/index.cjs'

TL;DR

For "Cannot find module './auth.js' from 'node_modules/@vonage/auth/dist/cjs/index.cjs'": the permanent fix: upgrade @vonage/server-sdk to 3.25.0, where the build was migrated to tsup and exports were corrected. A September release shipped a misconfigured TypeScript build / package.json exports map, so the ESM/CJS entry points referenced built files (e.g../auth.js) that were not emitted.

Cannot find module './auth.js' from 'node_modules/@vonage/auth/dist/cjs/index.cjs'

Steps

1. A September release shipped a misconfigured TypeScript build / package.json exports map, so the ESM/CJS entry points referenced built files (e.g. ./auth.js) that were not emitted. Workaround that was shared: npm cache clean --force and a resolutions pin (@vonage/auth 1.12.0, @vonage/server-client 1.17.1, @vonage/jwt 1.11.0, @vonage/vetch 1.8.0, @vonage/conversations 1.9.3 alongside server-sdk 3.24.1). The permanent fix: upgrade @vonage/server-sdk to 3.25.0, where the build was migrated to tsup and exports were corrected. The maintainer confirmed the SDK loads correctly for ESM and CJS after that release.

Expected: The maintainer confirmed the SDK loads correctly for ESM and CJS after that release.

When to use

You are seeing this: After updating @vonage/server-sdk to around 3.24.1 (with @vonage/auth 1.12.1), any import of the SDK fails with Cannot find module './auth.js' from 'node\modules/@vonage/auth/dist/cjs/index.cjs' (later reports show Cannot find module './errors/index.js'). Use this skill when you run into "Cannot find module './auth.js' from 'nodemodules/@vonage/auth/dist/cjs/index.cjs'".

When not to use

If your error message or symptom does not match what is described above, this is probably not your fix. Search for your exact error text instead of forcing this one to fit.

Versions

Versions mentioned in the source: around 3.24.1, vonageauth 1.12.1, vonageauth 1.12.0, vonageserver-client 1.17.1, vonagejwt 1.11.0, vonagevetch 1.8.0, vonageconversations 1.9.3, 3.25.0. If you are on something much newer or older, the details may have shifted.

Why this happens

The original report does not dig into a root cause. It documents the symptom and the fix that resolved it.

Asked in the thread (https://vectle.com/threads/thrmN2GJzBWalT4uSfJiAuhQ): After updating @vonage/server-sdk to around 3.24.1 (with @vonage/auth 1.12.1), any import of the SDK fails with Cannot find module './auth.js' from 'node_modules/@vonage/auth/dist/cjs/index.cjs' (later reports show Cannot find module './errors/index.js'). Node 22, seen on Mac and in jest test suites. Pinning older versions did not help other than a specific resolutions combo. The verified answer: A September release shipped a misconfigured TypeScript build / package.json exports map, so the ESM/CJS entry points referenced built files (e.g. ./auth.js) that were not emitted. Workaround that was shared: npm cache clean --force and a resolutions pin (@vonage/auth 1.12.0, @vonage/server-client 1.17.1, @vonage/jwt 1.11.0, @vonage/vetch 1.8.0, @vonage/conversations 1.9.3 alongside server-sdk 3.24.1). The permanent fix: upgrade @vonage/server-sdk to 3.25.0, where the build was migrated to tsup and exports were corrected. The maintainer confirmed the SDK loads correctly for ESM and CJS after that release. Source: https://github.com/Vonage/vonage-node-sdk/issues/1023 Thread: https://vectle.com/threads/thrmN2GJzBWalT4uSfJiAuhQ