chore: remove @next and clean (#176)

AugustinMauroy · web-flow · commit b22db020d4a6 · 2025-08-12T23:57:49.000+02:00
diff --git a/.github/workflows/codemod_publish.yml b/.github/workflows/codemod_publish.yml
@@ -106,11 +106,11 @@ jobs:
       - name: Authenticate with Codemod registry
         env:
           CODEMOD_TOKEN: ${{ secrets.CODEMOD_TOKEN }}
-        run: npx codemod@next login --api-key "$CODEMOD_TOKEN"
+        run: npx codemod login --api-key "$CODEMOD_TOKEN"
 
       - name: Publish codemod
         working-directory: ${{ steps.parse-tag.outputs.codemod-path }}
-        run: npx codemod@next publish
+        run: npx codemod publish
 
       - name: Create release summary
         env:
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -89,7 +89,7 @@ registry:
 - [Codemod CLI Reference](https://docs.codemod.com/cli/cli-reference)
 - [Codemod Workflow Documentation](https://docs.codemod.com/cli/workflows)
 - [Codemod Studio Documentation](https://docs.codemod.com/codemod-studio)
-- [JSSG API Reference](https://docs.codemod.com/cli/cli-reference#cli-command-reference)
+- [JS ast-grep (jssg) API reference](https://docs.codemod.com/cli/cli-reference#cli-command-reference)
 - [ast-grep Documentation](https://ast-grep.github.io/)
 
 ## Development Workflow
diff --git a/README.md b/README.md
@@ -13,17 +13,14 @@ This repository contains codemods (automated migrations) for "userland" code. Th
 To run the transform scripts use [`codemod`](https://go.codemod.com/github) command below:
 
 ```console
-$ npx codemod <transform> --target <path> [...options]
+npx codemod @nodejs/<recipe>
 ```
 
-* `transform` - name of transform. see available transforms below.
-* `path` - directory to transform. defaults to the current directory.
-
 See the [codemod CLI doc](https://go.codemod.com/cli-docs) for a full list of available commands.
 
 ## Available codemods
 
-You can find official Node.js codemods in the [Codemod Registry](https://codemod.com/registry?author=nodejs). Additionally, community-contributed Node.js codemods are available in the [Codemod Registry](https://codemod.link/nodejs-official).
+You can find official Node.js codemods in the [Codemod Registry](https://codemod.link/nodejs-official).
 
 ## Acknowledgments
 
diff --git a/package-lock.json b/package-lock.json
diff --git a/recipes/create-require-from-path/package.json b/recipes/create-require-from-path/package.json
@@ -4,7 +4,7 @@
   "description": "Handle DEP0130 via transforming `createRequireFromPath` to `createRequire`.",
   "type": "module",
   "scripts": {
-    "test": "npx codemod@next jssg test -l typescript ./src/workflow.ts ./"
+    "test": "npx codemod jssg test -l typescript ./src/workflow.ts ./"
   },
   "repository": {
     "type": "git",
@@ -16,10 +16,9 @@
   "license": "MIT",
   "homepage": "https://github.com/nodejs/userland-migrations/blob/main/recipes/create-require-from-path/README.md",
   "devDependencies": {
-    "@types/node": "^24.2.1",
     "@codemod.com/jssg-types": "^1.0.3"
   },
   "dependencies": {
-    "@nodejs/codemod-utils": "0.0.0"
+    "@nodejs/codemod-utils": "*"
   }
 }
diff --git a/recipes/create-require-from-path/src/workflow.ts b/recipes/create-require-from-path/src/workflow.ts
@@ -26,7 +26,6 @@ export default function transform(root: SgRoot): string | null {
 	let hasChanges = false;
 
 	// Step 1: Find and update destructuring assignments from require('module') or require('node:module')
-	// @ts-ignore - ast-grep types are not fully compatible with JSSG types
 	const requireStatements = getNodeRequireCalls(root, "module");
 
 	for (const statement of requireStatements) {
@@ -48,7 +47,6 @@ export default function transform(root: SgRoot): string | null {
 		}
 	}
 
-	// @ts-ignore - ast-grep types are not fully compatible with JSSG types
 	const importStatements = getNodeImportStatements(root, "module");
 
 	for (const statement of importStatements) {
diff --git a/recipes/import-assertions-to-attributes/README.md b/recipes/import-assertions-to-attributes/README.md
@@ -15,7 +15,7 @@ import data from './data.json' with { type: 'json' };
 Run this codemod with:
 
 ```sh
-npx codemod@next nodejs/import-assertions-to-attributes
+npx codemod nodejs/import-assertions-to-attributes
 ```
 
 ## When is it useful?
diff --git a/recipes/import-assertions-to-attributes/package.json b/recipes/import-assertions-to-attributes/package.json
@@ -4,7 +4,7 @@
   "description": "Replace `assert` import attribute to the `with` ECMAScript import attribute.",
   "type": "module",
   "scripts": {
-    "test": "npx codemod@next jssg test -l typescript ./src/workflow.ts ./"
+    "test": "npx codemod jssg test -l typescript ./src/workflow.ts ./"
   },
   "repository": {
     "type": "git",
@@ -16,7 +16,6 @@
   "license": "MIT",
   "homepage": "https://github.com/nodejs/userland-migrations/tree/main/import-assertions-to-attributes#readme",
   "devDependencies": {
-    "@types/node": "^24.2.1",
     "@codemod.com/jssg-types": "^1.0.3"
   }
 }
diff --git a/recipes/process-main-module/package.json b/recipes/process-main-module/package.json
@@ -4,7 +4,7 @@
   "description": "Handle DEP0138 via transforming `process.mainModule` to `require.main`.",
   "type": "module",
   "scripts": {
-    "test": "npx codemod@next jssg test -l typescript ./src/workflow.ts ./"
+    "test": "npx codemod jssg test -l typescript ./src/workflow.ts ./"
   },
   "repository": {
     "type": "git",
@@ -16,10 +16,9 @@
   "license": "MIT",
   "homepage": "https://github.com/nodejs/userland-migrations/blob/main/recipes/process-main-module/README.md",
   "devDependencies": {
-    "@types/node": "^24.2.1",
     "@codemod.com/jssg-types": "^1.0.3"
   },
   "dependencies": {
-    "@nodejs/codemod-utils": "0.0.0"
+    "@nodejs/codemod-utils": "*"
   }
 }
diff --git a/recipes/process-main-module/src/workflow.ts b/recipes/process-main-module/src/workflow.ts
@@ -29,7 +29,6 @@ export default function transform(root: SgRoot): string | null {
 		},
 	];
 
-	// @ts-ignore - ast-grep types are not fully compatible with JSSG types
 	const requireDeclarations = getNodeRequireCalls(root, "process");
 
 	const destructureDeclarations = rootNode.findAll({
@@ -48,7 +47,6 @@ export default function transform(root: SgRoot): string | null {
 	for (const declarationNode of [...requireDeclarations, ...destructureDeclarations]) {
 		// Step 1: Get all requires from module nodule:process that is destructuring mainModule:
 		if (declarationNode.text().includes("mainModule")) {
-			// @ts-ignore - ast-grep types are not fully compatible with JSSG types
 			const result = removeBinding(declarationNode, "mainModule");
 
 			if (result) {
diff --git a/recipes/rmdir/package.json b/recipes/rmdir/package.json
@@ -4,7 +4,7 @@
   "description": "Handle DEP0147 via transforming `fs.rmdir` to `fs.rm` with the appropriate options.",
   "type": "module",
   "scripts": {
-    "test": "npx codemod@next jssg test -l typescript ./src/workflow.ts ./"
+    "test": "npx codemod jssg test -l typescript ./src/workflow.ts ./"
   },
   "repository": {
     "type": "git",
@@ -16,7 +16,6 @@
   "license": "MIT",
   "homepage": "https://github.com/nodejs/userland-migrations/blob/main/recipes/rmdirs/README.md",
   "devDependencies": {
-    "@types/node": "^24.2.1",
     "@codemod.com/jssg-types": "^1.0.3"
   },
   "dependencies": {
diff --git a/recipes/rmdir/src/workflow.ts b/recipes/rmdir/src/workflow.ts
@@ -141,7 +141,6 @@ export default function transform(root: SgRoot): string | null {
 	}
 
 	// Transform named alias import when recursive set to true
-	// @ts-ignore - ast-grep types are not fully compatible with JSSG types
 	const importStatements = getNodeImportStatements(root, "fs");
 
 	for (const eachNode of importStatements) {
@@ -211,7 +210,6 @@ export default function transform(root: SgRoot): string | null {
 
 	// Update imports/requires only if we have destructured calls that need new imports
 	if (needsRmImport || needsRmSyncImport) {
-		// @ts-ignore - ast-grep types are not fully compatible with JSSG types
 		const importStatements = getNodeImportStatements(root, 'fs');
 
 		// Update import statements
@@ -247,7 +245,6 @@ export default function transform(root: SgRoot): string | null {
 			}
 		}
 
-		// @ts-ignore - ast-grep types are not fully compatible with JSSG types
 		const requireStatements = getNodeRequireCalls(root, 'fs');
 
 		// Update require statements
diff --git a/recipes/tmpdir-to-tmpdir/package.json b/recipes/tmpdir-to-tmpdir/package.json
@@ -4,7 +4,7 @@
   "description": "Handle DEP0022 via transforming `tmpDir` to `tmpdir`.",
   "type": "module",
   "scripts": {
-    "test": "npx codemod@next jssg test -l typescript ./src/workflow.ts ./"
+    "test": "npx codemod jssg test -l typescript ./src/workflow.ts ./"
   },
   "repository": {
     "type": "git",
@@ -16,10 +16,9 @@
   "license": "MIT",
   "homepage": "https://github.com/nodejs/userland-migrations/blob/main/recipes/tmpdir-to-tmpdir/README.md",
   "devDependencies": {
-    "@types/node": "^24.2.1"
+    "@codemod.com/jssg-types": "^1.0.3"
   },
   "dependencies": {
-    "@ast-grep/napi": "^0.39.3",
-    "@nodejs/codemod-utils": "0.0.0"
+    "@nodejs/codemod-utils": "*"
   }
-}
+}
diff --git a/recipes/tmpdir-to-tmpdir/src/workflow.ts b/recipes/tmpdir-to-tmpdir/src/workflow.ts
@@ -1,6 +1,6 @@
 import { getNodeImportStatements } from "@nodejs/codemod-utils/ast-grep/import-statement";
 import { getNodeRequireCalls } from "@nodejs/codemod-utils/ast-grep/require-call";
-import type { SgRoot, Edit } from "@ast-grep/napi";
+import type { SgRoot, Edit } from "@codemod.com/jssg-types/main";
 
 /**
  * Transform function that updates code to replace deprecated `tmpDir` usage
diff --git a/utils/package.json b/utils/package.json
@@ -15,6 +15,7 @@
   "type": "module",
   "devDependencies": {
     "@ast-grep/napi": "^0.39.3",
+    "@codemod.com/jssg-types": "^1.0.3",
     "dedent": "^1.6.0"
   }
 }
diff --git a/utils/src/ast-grep/import-statement.ts b/utils/src/ast-grep/import-statement.ts
@@ -1,4 +1,4 @@
-import type { SgRoot, SgNode } from '@ast-grep/napi';
+import type { SgRoot, SgNode } from '@codemod.com/jssg-types/main';
 
 export const getNodeImportStatements = (rootNode: SgRoot, nodeModuleName: string): SgNode[] =>
 	rootNode
diff --git a/utils/src/ast-grep/remove-binding.ts b/utils/src/ast-grep/remove-binding.ts
@@ -1,5 +1,4 @@
-import type { Kinds, TypesMap } from "@ast-grep/napi/types/staticTypes.js";
-import type { SgNode, Edit, Range } from "@ast-grep/napi";
+import type { SgNode, Edit, Range, Kinds, TypesMap } from "@codemod.com/jssg-types/main";
 
 const requireKinds = ["lexical_declaration", "variable_declarator"];
 const importKinds = ["import_statement", "import_clause"];
diff --git a/utils/src/ast-grep/remove-lines.ts b/utils/src/ast-grep/remove-lines.ts
@@ -1,4 +1,4 @@
-import type { Range } from "@ast-grep/napi";
+import type { Range } from "@codemod.com/jssg-types/main";
 
 export function removeLines(sourceCode: string, ranges: Range[]) {
 	const lines = sourceCode.split("\n");
diff --git a/utils/src/ast-grep/require-call.ts b/utils/src/ast-grep/require-call.ts
@@ -1,4 +1,4 @@
-import type { SgRoot, SgNode } from '@ast-grep/napi';
+import type { SgRoot, SgNode } from '@codemod.com/jssg-types/main';
 
 /**
  *  We just catch `variable_declarator` nodes that use `require` to import a module
diff --git a/utils/src/ast-grep/resolve-binding-path.ts b/utils/src/ast-grep/resolve-binding-path.ts
@@ -1,5 +1,4 @@
-import type { Kinds, TypesMap } from "@ast-grep/napi/types/staticTypes.js";
-import type { SgNode } from "@ast-grep/napi";
+import type { SgNode, Kinds, TypesMap } from "@codemod.com/jssg-types/main";
 
 const requireKinds = ["lexical_declaration", "variable_declarator"];
 const importKinds = ["import_statement", "import_clause"];

Original file line number	Diff line number	Diff line change
`@@ -26,7 +26,6 @@ export default function transform(root: SgRoot): string \| null {`
`26`	`26`	`let hasChanges = false;`
`27`	`27`
`28`	`28`	`// Step 1: Find and update destructuring assignments from require('module') or require('node:module')`
`29`		`- // @ts-ignore - ast-grep types are not fully compatible with JSSG types`
`30`	`29`	`const requireStatements = getNodeRequireCalls(root, "module");`
`31`	`30`
`32`	`31`	`for (const statement of requireStatements) {`
`@@ -48,7 +47,6 @@ export default function transform(root: SgRoot): string \| null {`
`48`	`47`	`}`
`49`	`48`	`}`
`50`	`49`
`51`		`- // @ts-ignore - ast-grep types are not fully compatible with JSSG types`
`52`	`50`	`const importStatements = getNodeImportStatements(root, "module");`
`53`	`51`
`54`	`52`	`for (const statement of importStatements) {`