Upgrade Node.js to v24 and modernize development tooling (#595)

razor-x · claude · web-flow · commit e71a02e84be7 · 2026-07-28T14:43:18.000-05:00
Adopt the toolchain patterns from @seamapi/makenew-tsmodule v3.0.4, mirroring the update already applied to seamapi/javascript-http and seamapi/docs. - Add engines and devEngines and drop .nvmrc. Node v24 is now the default in CI and the devcontainer, with v22.11.0 still supported. - Update the workflow action versions and install dependencies with npm ci --ignore-scripts followed by npm rebuild. - Update the npm dependencies. Refreshing the lockfile also records the esbuild platform packages that npm tracks for tsx. - Fix the tsconfig.json schema URL. TypeScript v6 is already in place through @seamapi/smith v1.1.0, which declares typescript, tsx, eslint, and jiti as peer dependencies and depends on @types/node directly, so none of them are declared here. The Python toolchain is unchanged: Poetry, pylint, black, and the Python version matrices in CI are untouched. Running the codegen produces byte for byte identical output under the updated toolchain. Claude-Session: https://claude.ai/code/session_01Y2XoVcysK4XshKsKtsbK4U Co-authored-by: Claude <noreply@anthropic.com>
diff --git a/.devcontainer/Dockerfile b/.devcontainer/Dockerfile
@@ -2,7 +2,7 @@ ARG VARIANT="3"
 
 FROM mcr.microsoft.com/vscode/devcontainers/python:${VARIANT}
 
-ARG NODE_VERSION="20"
+ARG NODE_VERSION="24"
 ARG POETRY_VERSION="1.8.2"
 ARG POETRY_SRC="https://install.python-poetry.org"
 
diff --git a/.devcontainer/devcontainer.json b/.devcontainer/devcontainer.json
@@ -4,7 +4,7 @@
   "build": {
     "dockerfile": "Dockerfile",
     "args": {
-      "NODE_VERSION": "20",
+      "NODE_VERSION": "24",
       "POETRY_VERSION": "1.8.2",
       "VARIANT": "3.12"
     }
diff --git a/.github/actions/setup-node/action.yml b/.github/actions/setup-node/action.yml
@@ -6,7 +6,7 @@ inputs:
   node_version:
     description: The Node.js version.
     required: false
-    default: '20'
+    default: '24'
   registry_url:
     description: The Node.js package registry URL.
     required: false
@@ -20,19 +20,27 @@ runs:
   using: composite
   steps:
     - name: Setup Node.js
-      uses: actions/setup-node@v4
+      uses: actions/setup-node@v7
       if: inputs.install_dependencies == 'true'
       with:
-        cache: npm
         node-version: ${{ inputs.node_version }}
         registry-url: ${{ inputs.registry_url }}
     - name: Setup Node.js without cache
-      uses: actions/setup-node@v4
+      uses: actions/setup-node@v7
       if: inputs.install_dependencies == 'false'
       with:
         node-version: ${{ inputs.node_version }}
         registry-url: ${{ inputs.registry_url }}
     - name: Install dependencies
       if: inputs.install_dependencies == 'true'
       shell: bash
-      run: npm ci
+      run: npm ci --ignore-scripts
+    - name: Rebuild Node.js modules
+      shell: bash
+      run: npm rebuild
+    - name: Run postinstall script
+      shell: bash
+      run: npm run postinstall --if-present
+    - name: Run prepare script
+      shell: bash
+      run: npm run prepare --if-present
diff --git a/.github/workflows/_build.yml b/.github/workflows/_build.yml
@@ -31,15 +31,15 @@ jobs:
     timeout-minutes: 30
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v7
       - name: Setup
         uses: ./.github/actions/setup
         with:
           python_version: ${{ inputs.python_version }}
       - name: Build
         run: make build
       - name: Upload artifact
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@v7
         if: inputs.upload_artifact == 'true'
         with:
           name: build-${{ github.sha }}
diff --git a/.github/workflows/_publish.yml b/.github/workflows/_publish.yml
@@ -20,13 +20,13 @@ jobs:
     timeout-minutes: 30
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v7
       - name: Setup
         uses: ./.github/actions/setup
         with:
           install_dependencies: 'false'
       - name: Download artifact
-        uses: actions/download-artifact@v4
+        uses: actions/download-artifact@v8
         with:
           name: ${{ inputs.artifact_name }}
           path: dist/
diff --git a/.github/workflows/check.yml b/.github/workflows/check.yml
@@ -28,7 +28,7 @@ jobs:
             os_name: Linux
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v7
       - name: Setup
         uses: ./.github/actions/setup
         with:
@@ -49,7 +49,7 @@ jobs:
           - '3.12'
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v7
       - name: Setup
         uses: ./.github/actions/setup
         with:
@@ -98,12 +98,12 @@ jobs:
         with:
           python-version: ${{ matrix.python }}
       - name: Download artifact
-        uses: actions/download-artifact@v4
+        uses: actions/download-artifact@v8
         with:
           name: ${{ needs.build.outputs.artifact_name }}
           path: .
       - name: Find wheels
-        uses: tj-actions/glob@v21
+        uses: tj-actions/glob@v22
         id: wheels
         with:
           files: '*.whl'
diff --git a/.github/workflows/format.yml b/.github/workflows/format.yml
@@ -14,12 +14,12 @@ jobs:
     timeout-minutes: 30
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v7
         with:
           ref: ${{ github.head_ref }}
           token: ${{ secrets.GH_TOKEN }}
       - name: Import GPG key
-        uses: crazy-max/ghaction-import-gpg@v6
+        uses: crazy-max/ghaction-import-gpg@v7
         with:
           git_user_signingkey: true
           git_commit_gpgsign: true
@@ -36,7 +36,7 @@ jobs:
       - name: Format with Prettier
         run: npm run format
       - name: Commit
-        uses: stefanzweifel/git-auto-commit-action@v5
+        uses: stefanzweifel/git-auto-commit-action@v7
         if: always()
         with:
           commit_message: 'ci: Format code'
diff --git a/.github/workflows/generate.yml b/.github/workflows/generate.yml
@@ -14,12 +14,12 @@ jobs:
     timeout-minutes: 30
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v7
         with:
           ref: ${{ github.head_ref }}
           token: ${{ secrets.GH_TOKEN }}
       - name: Import GPG key
-        uses: crazy-max/ghaction-import-gpg@v6
+        uses: crazy-max/ghaction-import-gpg@v7
         with:
           git_user_signingkey: true
           git_commit_gpgsign: true
@@ -44,7 +44,7 @@ jobs:
       - name: Generate code
         run: npm run generate
       - name: Commit
-        uses: stefanzweifel/git-auto-commit-action@v5
+        uses: stefanzweifel/git-auto-commit-action@v7
         with:
           commit_message: 'ci: Generate code'
           commit_user_name: ${{ secrets.GIT_USER_NAME }}
diff --git a/.github/workflows/publish.yml b/.github/workflows/publish.yml
@@ -21,11 +21,11 @@ jobs:
     needs: build
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v7
         with:
           fetch-depth: 0
       - name: Download artifact
-        uses: actions/download-artifact@v4
+        uses: actions/download-artifact@v8
         with:
           name: ${{ needs.build.outputs.artifact_name }}
           path: dist/
@@ -38,7 +38,7 @@ jobs:
           npx standard-changelog@^5.0.0 --release-count 2 --infile $outfile.tmp --outfile $outfile.tmp
           sed '1,3d' $outfile.tmp > $outfile
       - name: Create GitHub release
-        uses: softprops/action-gh-release@v2
+        uses: softprops/action-gh-release@v3
         with:
           token: ${{ secrets.GH_TOKEN }}
           fail_on_unmatched_files: true
diff --git a/.github/workflows/semantic-release.yml b/.github/workflows/semantic-release.yml
@@ -22,12 +22,12 @@ jobs:
       new_release_version: ${{ steps.release.outputs.new_release_version }}
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v7
         with:
           fetch-depth: 0
       - name: Semantic release
         id: release
-        uses: cycjimmy/semantic-release-action@v4
+        uses: cycjimmy/semantic-release-action@v6
         with:
           dry_run: true
   release:
@@ -38,7 +38,7 @@ jobs:
     if: needs.semantic.outputs.new_release_published == 'true' && needs.semantic.outputs.new_release_version != '1.0.0'
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v7
         with:
           fetch-depth: 1
       - name: Release version ${{ needs.semantic.outputs.new_release_version }} on ${{ github.ref_name }}
diff --git a/.github/workflows/version.yml b/.github/workflows/version.yml
@@ -17,11 +17,11 @@ jobs:
     timeout-minutes: 30
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v7
         with:
           token: ${{ secrets.GH_TOKEN }}
       - name: Import GPG key
-        uses: crazy-max/ghaction-import-gpg@v6
+        uses: crazy-max/ghaction-import-gpg@v7
         with:
           git_user_signingkey: true
           git_commit_gpgsign: true
diff --git a/.nvmrc b/.nvmrc
diff --git a/package-lock.json b/package-lock.json
diff --git a/package.json b/package.json
diff --git a/tsconfig.json b/tsconfig.json

Original file line number	Diff line number	Diff line change
`@@ -4,7 +4,7 @@`
`4`	`4`	`"build": {`
`5`	`5`	`"dockerfile": "Dockerfile",`
`6`	`6`	`"args": {`
`7`		`- "NODE_VERSION": "20",`
	`7`	`+ "NODE_VERSION": "24",`
`8`	`8`	`"POETRY_VERSION": "1.8.2",`
`9`	`9`	`"VARIANT": "3.12"`
`10`	`10`	`}`