Dynamics Community Forum Thread Details

Incompatibility Issue with lru-cache@11.0.2 in MSDyn365 Commerce on Node 18

I am encountering a blocking issue when attempting to build the MSDyn365 Commerce Online repository from GitHub using Node.js 18.20.4 on Bash on Windows with yarn.

After ensuring a clean setup by removing node_modules, yarn.lock, and cleaning the cache, running yarn install fails with the following error:

Key Findings:

The project must run on Node.js 18 since MSDyn365 Commerce does not support later versions.
The same issue occurs even when cloning and attempting to build the original GitHub repo from Microsoft.
lru-cache@11.0.2 requires Node.js 20+, making it incompatible with Node.js 18.

Steps to Reproduce:

Clone the MSDyn365 Commerce repo:

git clone https://github.com/microsoft/Msdyn365.Commerce.Online.git
Navigate to the directory:

cd Msdyn365.Commerce.Online
Ensure the correct Node.js version (18.20.4):

node -v # Should output v18.20.4
Clean the environment:

yarn clean rm -rf node_modules yarn.lock yarn cache clean --force
Attempt installation:

yarn install

Expected Behavior:
The project should successfully install dependencies and build under Node.js 18.

Actual Behavior:
Installation fails due to an incompatible dependency (lru-cache@11.0.2), which requires Node.js 20+.

Impact:
This issue prevents any development, testing, or deployment of MSDyn365 Commerce under its officially supported Node.js version.

Request for Support:
Could you please provide guidance on how to resolve this dependency conflict while ensuring the project remains compatible with Node.js 18? If lru-cache has been inadvertently upgraded in the dependency tree, can it be pinned to a compatible version?

System Information:

Operating System: Windows 11
Shell: Git Bash
Node.js Version: 18.20.4
Yarn Version: 1.22.22

Thank you for your assistance.

Categories:

Dynamics 365 Commerce

The build issue originates from the TestCafe dependency, which has been recently updated and now requires lru-cache@11.0.2, which is not compatible with Node.js 18 (MSDyn365 Commerce's required version).

By tracing the dependency tree, it was found that:

TestCafe → TestCafe Legacy API → TestCafe Hammerhead → lru-cache@11.0.2
Several MSDyn365 Commerce modules import TestCafe with "^1.0.0", leading to unintended upgrades.

Quick Solution:

Lock TestCafe to version 3.7.1 in package.json:
Add the following under "resolutions":

"resolutions": { "testcafe": "3.7.1", "testcafe-hammerhead": "24.7.2", "testcafe-legacy-api": "5.1.4" }
Clean and reinstall dependencies:

rm -rf node_modules yarn.lock yarn cache clean --force yarn install
Verify TestCafe installation:

yarn list --pattern testcafe

Ensure it lists TestCafe 3.7.1 instead of a newer version.

This will prevent TestCafe from updating to versions requiring lru-cache@11.0.2, ensuring compatibility with Node.js 18 and fixing the build issue.

Quick Links