feat(axios-to-whatwg-fetch): introduce

recipes/axios-to-whatwg-fetch/README.md

@@ -0,0 +1,104 @@
+# Axios to WHATWG Fetch Codemod
+
+## Description
+
+This codemod transforms code using Axios to leverage the WHATWG Fetch API, which is now natively available in Node.js. By replacing Axios with Fetch, you can reduce dependencies, mitigate risks, and improve performance.
+
+## Supported Transformations
+
+The codemod supports the following Axios methods and converts them to their Fetch equivalents:
+
+- `axios.request(config)`
+- `axios.get(url[, config])`
+- `axios.delete(url[, config])`
+- `axios.head(url[, config])`
+- `axios.options(url[, config])`
+- `axios.post(url[, data[, config]])`
+- `axios.put(url[, data[, config]])`
+- `axios.patch(url[, data[, config]])`
+
+### Examples
+
+#### GET Request
+
+```diff
+ const base = 'https://dummyjson.com/todos';
+
+- const all = await axios.get(base);
++ const all = await fetch(base).then(async (res) => Object.assign(res, { data: await res.json() })).catch(() => null);
+	console.log('\nGET /todos ->', all.status);
+	console.log(`Preview: ${all.data.todos.length} todos`);
+```
+
+#### POST Request
+
+```diff
+ const base = 'https://dummyjson.com/todos';
+
+- const created = await axios.post(
+-     `${base}/add`, {
+-         todo: 'Use DummyJSON in the project',
+-         completed: false,
+-         userId: 5,
+-     }, {
+-         headers: { 'Content-Type': 'application/json' }
+-     }
+- );
++ const created = await fetch(`${base}/add`, {
++     method: 'POST',
++     headers: { 'Content-Type': 'application/json' },
++     body: JSON.stringify({
++         todo: 'Use DummyJSON in the project',
++         completed: false,
++         userId: 5,
++     }),
++ }).then(async (res) => Object.assign(res, { data: await res.json() }));
+	console.log('\nPOST /todos/add ->', created.status);
+	console.log('Preview:', created.data?.id ? `created id ${created.data.id}` : JSON.stringify(created.data).slice(0,200));
+```
+
+#### PUT Request
+
+```diff
+ const base = 'https://dummyjson.com/todos';
+
+- const updatedPut = await axios.put(
+-     `${base}/1`,
+-     { completed: false },
+-     { headers: { 'Content-Type': 'application/json' } }
+- );
++ const updatedPut = await fetch(`${base}/1`, {
++     method: 'PUT',
++     headers: { 'Content-Type': 'application/json' },
++     body: JSON.stringify({ completed: false }),
++ }).then(async (res) => Object.assign(res, { data: await res.json() }));
+	console.log('\nPUT /todos/1 ->', updatedPut.status);
+	console.log('Preview:', updatedPut.data?.completed !== undefined ? `completed=${updatedPut.data.completed}` : JSON.stringify(updatedPut.data).slice(0,200));
+```
+
+#### DELETE Request
+
+```diff
+ const base = 'https://dummyjson.com/todos';
+
+- const deleted = await axios.delete(`${base}/1`);
++ const deleted = await fetch(`${base}/1`, { method: 'DELETE' })
++ .then(async (res) => Object.assign(res, { data: await res.json() }));
+	console.log('\nDELETE /todos/1 ->', deleted.status);
+	console.log('Preview:', deleted.data ? JSON.stringify(deleted.data).slice(0,200) : typeof deleted.data);
+```
+
+## Unsupported APIs
+
+The following Axios methods are not supported by this codemod and will generate warnings:
+
+- `axios.postForm(url[, data[, config]])`
+- `axios.putForm(url[, data[, config]])`
+- `axios.patchForm(url[, data[, config]])`
+
+## References
+
+- [Fetch Spec](https://fetch.spec.whatwg.org)
+- [Axios Documentation](https://axios-http.com)
+- [Node.js Documentation](https://nodejs.org/docs/latest/api/globals.html#fetch)
+

recipes/axios-to-whatwg-fetch/codemod.yaml

@@ -0,0 +1,21 @@
+schema_version: "1.0"
+name: "@nodejs/util-print-to-console-log"
+version: 1.0.0
+description: Replace `axios` with `fetch`
+author: Bruno Rodrigues
+license: MIT
+workflow: workflow.yaml
+category: migration
+
+targets:
+  languages:
+    - javascript
+    - typescript
+
+keywords:
+  - transformation
+  - migration
+
+registry:
+  access: public
+  visibility: public

recipes/axios-to-whatwg-fetch/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@nodejs/axios-to-whatwg-fetch",
+  "version": "1.0.0",
+  "description": "Replace `axios` with `fetch`",
+  "type": "module",
+  "scripts": {
+    "test": "npx codemod jssg test -l typescript ./src/workflow.ts ./"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/nodejs/userland-migrations.git",
+    "directory": "recipes/axios-to-whatwg-fetch",
+    "bugs": "https://github.com/nodejs/userland-migrations/issues"
+  },
+  "author": "Bruno Rodrigues",
+  "license": "MIT",
+  "homepage": "https://github.com/nodejs/userland-migrations/blob/main/recipes/axios-to-whatwg-fetch/README.md",
+  "devDependencies": {
+    "@codemod.com/jssg-types": "^1.0.9"
+  },
+  "dependencies": {
+    "@nodejs/codemod-utils": "*",
+    "dedent": "^1.7.0"
+  }
+}