Update Node.js version requirements from 20.19+ to 22.12+ for Vite compatibility

- Update package.json engines to require Node.js 22.12+ and npm 11+
- Update UI README.md to specify NodeJS 22.12+ requirement
- Update documentation (deployment.md, setup guides) to use Node.js 22
- Update CI/CD configurations (.gitlab-ci.yml, CodeBuild templates)
- Update setup scripts to install Node.js 22
- Update publish.sh validation to require Node.js 22+
- Add evaluation extras to GitLab CI to fix munkres dependency errors
- Regenerate package-lock.json with new requirements

Author: Taniya Mathur

.gitlab-ci.yml

@@ -43,7 +43,7 @@ developer_tests:
     - uv venv .venv
     - source .venv/bin/activate
     # Install Node.js and npm for basedpyright
-    - curl -fsSL https://deb.nodesource.com/setup_20.x | bash -
+    - curl -fsSL https://deb.nodesource.com/setup_22.x | bash -
     - apt-get install -y nodejs
     - npm install -g basedpyright
     - uv pip install ruff

docs/deployment.md

@@ -114,7 +114,7 @@ You need to have the following packages installed on your computer:
 4. python 3.11 or later
 5. A local Docker daemon
 6. Python packages for publish.py: `pip install boto3 rich typer PyYAML botocore setuptools ruff`
-7. **Node.js 20.19+** and **npm** (required for UI validation in publish script)
+7. **Node.js 22.12+** and **npm** (required for UI validation in publish script)
 
 For guidance on setting up a development environment, see:
 

docs/setup-development-env-WSL.md

@@ -44,7 +44,7 @@ cd accelerated-intelligent-document-processing-on-aws
 ```
 This script automatically installs:
 - Git, Python 3, pip, and build tools
-- Node.js 20
+- Node.js 22
 - AWS CLI v2
 - AWS SAM CLI
 - Python dependencies
@@ -77,8 +77,8 @@ Enter your AWS credentials when prompted. Refer to: https://docs.aws.amazon.com/
 python3 --version (Example: Python 3.12.3)
 aws --version (Example: aws-cli/2.28.26)
 sam --version (Example: SAM CLI, version 1.143.0)
-node --version (Example: v20.19.0)
-npm --version (Example: 10.8.2)
+node --version (Example: v22.12.0)
+npm --version (Example: 11.0.0)
 ```
 ### 4.2 Test Build Process
 ```

docs/setup-development-env-macos.md

@@ -142,7 +142,7 @@ sam --version
 ```
 
 
-## 7) Node.js via nvm (Node 20 LTS)
+## 7) Node.js via nvm (Node 22 LTS)
 
 Use nvm to manage Node versions. This mirrors your Linux section but uses zsh-friendly profile updates.
 
@@ -156,9 +156,9 @@ fi
 export NVM_DIR="$HOME/.nvm"
 [ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh"
 
-# Install Node 20 LTS
-nvm install 20
-nvm alias default 20
+# Install Node 22 LTS
+nvm install 22
+nvm alias default 22
 
 # Test
 node -v

package.json

@@ -17,7 +17,7 @@
     "typecheck:stats": "basedpyright --stats"
   },
   "engines": {
-    "node": ">=20.19.0",
-    "npm": ">=9.0.0"
+    "node": ">=22.12.0",
+    "npm": ">=11.0.0"
   }
 }

publish.sh

@@ -108,8 +108,8 @@ check_nodejs_dependencies() {
   node_version=$(node --version 2>/dev/null | sed 's/v//')
   node_major=$(echo "$node_version" | cut -d'.' -f1)
 
-  if [[ "$node_major" -lt 20 ]]; then
-    print_error "Node.js $node_version found, but 20+ is required for UI validation"
+  if [[ "$node_major" -lt 22 ]]; then
+    print_error "Node.js $node_version found, but 22+ is required for UI validation"
     print_info "Please upgrade Node.js to version 18 or later"
     exit 1
   else

scripts/dev_setup_al2023.sh

@@ -48,7 +48,7 @@ wget https://github.com/aws/aws-sam-cli/releases/latest/download/aws-sam-cli-lin
 unzip aws-sam-cli-linux-x86_64.zip -d ./sam-cli
 sudo ./sam-cli/install --update
 
-# node 20
+# node 22
 curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash  # nosemgrep: bash.curl.security.curl-pipe-bash.curl-pipe-bash - Official NVM installation script for development environment only
 source ~/.bashrc
 nvm install 18

scripts/dev_setup_ubuntu.sh

@@ -43,7 +43,7 @@ wget -q https://github.com/aws/aws-sam-cli/releases/latest/download/aws-sam-cli-
 unzip -q aws-sam-cli-linux-x86_64.zip -d ./sam-cli
 sudo ./sam-cli/install --update
 
-# node 20
+# node 22
 curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
 export NVM_DIR="$HOME/.nvm"
 [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"

scripts/sdlc/cfn/codepipeline-s3.yml

@@ -197,8 +197,8 @@ Resources:
               runtime-versions:
                 python: 3.12
               commands:
-                - n 20 && node --version || { echo "Node setup failed"; exit 1; }
-                - npm install -g npm@10 || { echo "npm upgrade failed"; exit 1; }
+                - n 22 && node --version || { echo "Node setup failed"; exit 1; }
+                - npm install -g npm@11 || { echo "npm upgrade failed"; exit 1; }
                 - export IDP_ADMIN_EMAIL=$(aws s3api head-object --bucket genaiic-sdlc-sourcecode-${AWS_ACCOUNT_ID:-020432867916}-${AWS_DEFAULT_REGION:-us-east-1} --key deploy/code.zip --query 'Metadata."gitlab-user-email"' --output text 2>/dev/null || echo "")
                 - cd idp_cli && pip install -e . && cd .. || { echo "IDP CLI installation failed"; exit 1; }
                 - pip install rich || echo "Rich installation failed, using fallback formatting"

scripts/wsl_setup.sh

@@ -29,7 +29,7 @@ sudo apt install build-essential make -y
 python3 --version
 
 # Install Node.js 18
-curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -  # nosemgrep: bash.curl.security.curl-pipe-bash.curl-pipe-bash - Official NodeSource repository with HTTPS verification for development environment only
+curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -  # nosemgrep: bash.curl.security.curl-pipe-bash.curl-pipe-bash - Official NodeSource repository with HTTPS verification for development environment only
 sudo apt-get install -y nodejs
 
 # Install AWS CLI