fix!: update to CMA.js v12 and drop Node <22 support [DX-781] (#2194)

* chore: update to v12

* chore: bump contentful-management to 12.0.0-new-beta.14

Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>

* fix: update get-space-data to use PlainClientAPI

Replace chain client entity methods with PlainClientAPI equivalents:
- client.space.get() / client.environment.get() for connecting
- client.contentType/entry/asset/locale/tag/webhook/role.getMany()
- client.editorInterface.get() instead of contentType.getEditorInterface()
- Refactor pagedGet to accept a fetcher function

Update unit tests to mock the new PlainClientAPI structure.

Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>

* chore: bump contentful-management to 12.0.0-new-beta.16

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* chore: update contentful-management to 12.0.0

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* fix!: drop Node <22 support, bump CI and .nvmrc to Node 24 LTS

BREAKING CHANGE: Node >=22 is now required. Older Node versions are no longer supported.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix: use CMA v12 legacy client to preserve existing API surface

Passes { type: 'legacy' } to createClient so get-space-data.js continues
using the high-level nested client (space.getEnvironment, environment.getEntries,
etc.) without requiring a functional migration.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix: bump contentful-management to ^12.2.0

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

---------

Co-authored-by: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>

Author: chasepoirier

.github/workflows/build.yaml

@@ -17,7 +17,7 @@ jobs:
       - name: Setup Node.js
         uses: actions/setup-node@v6
         with:
-          node-version: '22'
+          node-version: '24'
           cache: 'npm'
 
       - name: Install dependencies

.github/workflows/check.yaml

@@ -26,7 +26,7 @@ jobs:
       - name: Setup Node.js
         uses: actions/setup-node@v6
         with:
-          node-version: '22'
+          node-version: '24'
           cache: 'npm'
 
       - name: Install dependencies

.github/workflows/release.yaml

@@ -47,7 +47,7 @@ jobs:
       - name: Setup Node.js
         uses: actions/setup-node@v6
         with:
-          node-version: '22'
+          node-version: '24'
           cache: 'npm'
 
       - name: Install latest npm

.nvmrc

@@ -1 +1 @@
-v18
+24

lib/tasks/init-client.js

@@ -25,5 +25,5 @@ export default function initClient (opts, useCda = false) {
     }
     return createCdaClient(cdaConfig).withoutLinkResolution
   }
-  return createCmaClient(config)
+  return createCmaClient(config, { type: 'legacy' })
 }

package-lock.json

@@ -5,7 +5,7 @@
   "main": "dist/index.js",
   "types": "types.d.ts",
   "engines": {
-    "node": ">=18"
+    "node": ">=22"
   },
   "bin": {
     "contentful-export": "./bin/contentful-export"
@@ -51,7 +51,7 @@
     "cli-table3": "^0.6.0",
     "contentful": "^11.5.10",
     "contentful-batch-libs": "^10.1.3",
-    "contentful-management": "^11.48.1",
+    "contentful-management": "^12.2.0",
     "date-fns": "^4.1.0",
     "figures": "^3.2.0",
     "jsonwebtoken": "^9.0.0",