feat(migrate-legacy-buffer-atob-btoa): wip

Author: nekojanai

recipes/buffer-atob-btoa/README.md

@@ -0,0 +1,39 @@
+# migrate legacy `buffer.atob()` and `buffer.btoa()` APIs
+
+Migrates usage of the legacy APIs `buffer.atob()` and `buffer.btoa()` to the current recommended approaches.
+
+## Example
+
+### Migrating buffer.atob(data)
+
+**Before:**
+```
+const buffer = require('node:buffer');
+const data = 'SGVsbG8gV29ybGQh'; // "Hello World!" in base64
+const decodedData = buffer.atob(data);
+console.log(decodedData); // Outputs: Hello World!
+```
+
+**After:**
+```
+const data = 'SGVsbG8gV29ybGQh'; // "Hello World!" in base64
+const decodedData = Buffer.from(data, 'base64').toString('binary');
+console.log(decodedData); // Outputs: Hello World!
+```
+
+### Migrating buffer.btoa(data)
+
+**Before:**
+```
+const buffer = require('node:buffer');
+const data = 'Hello World!';
+const encodedData = buffer.btoa(data);
+console.log(encodedData); // Outputs: SGVsbG8gV29ybGQh
+```
+
+**After:**
+```
+const data = 'Hello World!';
+const encodedData = Buffer.from(data, 'binary').toString('base64');
+console.log(encodedData); // Outputs: SGVsbG8gV29ybGQh
+```

recipes/buffer-atob-btoa/codemod.yaml

@@ -0,0 +1,21 @@
+schema_version: "1.0"
+name: "@nodejs/buffer-atob-btoa"
+version: "1.0.0"
+description: Migrates usage of the legacy APIs `buffer.atob()` and `buffer.btoa()` to the current recommended approaches
+author: nekojanai (Jana)
+license: MIT
+workflow: workflow.yaml
+category: migration
+
+targets:
+  languages:
+    - javascript
+    - typescript
+
+keywords:
+  - transformation
+  - migration
+
+registry:
+  access: public
+  visibility: public

recipes/buffer-atob-btoa/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@nodejs/buffer-atob-btoa",
+  "version": "1.0.0",
+  "description": "Migrates usage of the legacy APIs `buffer.atob()` and `buffer.btoa()` to the current recommended approaches",
+  "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/buffer-atob-btoa",
+    "bugs": "https://github.com/nodejs/userland-migrations/issues"
+  },
+  "author": "nekojanai (Jana)",
+  "license": "MIT",
+  "homepage": "https://github.com/nodejs/userland-migrations/blob/main/recipes/buffer-atob-btoa/README.md",
+  "dependencies": {
+    "@nodejs/codemod-utils": "*"
+  }
+}

recipes/buffer-atob-btoa/src/workflow.ts

@@ -0,0 +1 @@
+// TODO: implement

recipes/buffer-atob-btoa/workflow.yaml

@@ -0,0 +1,27 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/codemod-com/codemod/refs/heads/main/schemas/workflow.json
+
+version: "1"
+
+nodes:
+  - id: apply-transforms
+    name: Apply AST Transformations
+    type: automatic
+    runtime:
+      type: direct
+    steps:
+      - name: Migrates usage of the legacy APIs `buffer.atob()` and `buffer.btoa()` to the current recommended approaches
+        js-ast-grep:
+          js_file: src/workflow.ts
+          base_path: .
+          include:
+            - "**/*.cjs"
+            - "**/*.js"
+            - "**/*.jsx"
+            - "**/*.mjs"
+            - "**/*.cts"
+            - "**/*.mts"
+            - "**/*.ts"
+            - "**/*.tsx"
+          exclude:
+            - "**/node_modules/**"
+          language: typescript