feat: add routes scanner

Author: thetutlage

package.json

@@ -5,19 +5,20 @@
   "engines": {
     "node": ">=24.0.0"
   },
+  "imports": {
+    "#tests/*": "./tests/*.ts"
+  },
   "main": "build/index.js",
   "type": "module",
   "files": [
     "build",
     "!build/bin",
     "!build/tests"
   ],
-  "imports": {
-    "#src/*": "./src/*.ts"
-  },
   "exports": {
     ".": "./build/index.js",
     "./code_transformer": "./build/src/code_transformer/main.js",
+    "./routes_scanner": "./build/src/code_scanners/routes_scanner/main.js",
     "./types": "./build/src/types/main.js"
   },
   "scripts": {
@@ -33,7 +34,7 @@
     "release": "release-it",
     "version": "npm run build",
     "prepublishOnly": "npm run build",
-    "quick:test": "cross-env NODE_DEBUG=adonisjs:assembler node --enable-source-maps --import=@poppinss/ts-exec bin/test.ts"
+    "quick:test": "cross-env NODE_DEBUG=adonisjs:assembler node --enable-source-maps --import=@poppinss/ts-exec --experimental-import-meta-resolve bin/test.ts"
   },
   "devDependencies": {
     "@adonisjs/eslint-config": "^3.0.0-next.0",

src/ast_file_system.ts

@@ -0,0 +1,46 @@
+/*
+ * @adonisjs/assembler
+ *
+ * (c) AdonisJS
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+import { readFile } from 'node:fs/promises'
+import { Lang, parse, type SgNode } from '@ast-grep/napi'
+
+import debug from './debug.ts'
+
+/**
+ * An abstraction around converting files to an AST and caching
+ * them forever. The cache could be cleared manually.
+ */
+export class AstFileSystem {
+  #cache: Map<string, SgNode> = new Map()
+
+  /**
+   * Returns the file contents as AST-grep node and caches it
+   * forever.
+   */
+  async get(filePath: string): Promise<SgNode> {
+    const cached = this.#cache.get(filePath)
+    if (cached) {
+      debug('returning AST nodes from cache "%s"', filePath)
+      return cached
+    }
+
+    const fileContents = await readFile(filePath, 'utf-8')
+    debug('parsing "%s" file to AST', filePath)
+    this.#cache.set(filePath, parse(Lang.TypeScript, fileContents).root())
+    return this.#cache.get(filePath)!
+  }
+
+  /**
+   * Clear AST cache for a single file or all the files
+   */
+  clear(filePath?: string) {
+    debug('clear AST cache "%s"', filePath)
+    filePath ? this.#cache.delete(filePath) : this.#cache.clear()
+  }
+}