fridayy 1.2.0 → 1.3.0

package/README.md

@@ -17,7 +17,8 @@ Instead of rewriting backend code or exposing raw endpoints to AI agents without
 ```
 ┌───────────────────────────────┐
 │     Existing Application      │
-│  (OpenAPI / REST / Node.js)   │
+│ (OpenAPI / REST / Node.js /   │
+│          Laravel)             │
 └───────────────┬───────────────┘
                 │
                 ▼
@@ -57,6 +58,8 @@ Connecting existing production software to LLMs presents three major challenges:
 
 ## 🚀 Quick Start
 
+**Requirements:** Node.js ≥ 18 (Windows, macOS, or Linux). fridayy uses no OS-specific shell commands and resolves per-project config with `path.resolve` and per-device credentials via an OS-appropriate config directory, so it behaves the same on any of the three.
+
 ### 1. Installation
 
 Install globally via npm:
@@ -97,6 +100,40 @@ fridayy start
 
 ---
 
+### 🔌 Supported Source Adapters
+
+| Source | Detection | `--source` value | Notes |
+|---|---|---|---|
+| OpenAPI / Swagger | `openapi.yaml`, `swagger.json`, etc. found in the project | `openapi` | Works with any backend language that can export a spec |
+| Node.js (Express / Fastify / Koa / NestJS / Next.js) | `package.json` + route scan | `nodejs` | Scans your JS/TS source directly, no spec needed |
+| **Laravel** | `artisan` file or `laravel/framework` in `composer.json` | `laravel` | Scans `routes/*.php` directly, no spec needed — see below |
+| Generic REST | Fallback when nothing else is detected | `rest` | Works with literally any HTTP backend, less granular |
+
+#### Using fridayy with a Laravel project
+
+Run these from your Laravel project root (where `artisan` lives):
+
+```bash
+fridayy init --source laravel --url http://localhost:8000
+fridayy scan       # lists routes discovered in routes/web.php and routes/api.php
+fridayy generate   # generates one tool per route
+fridayy review --approve-read
+fridayy start
+```
+
+The Laravel adapter reads `routes/*.php` directly — no OpenAPI spec required — and understands:
+- Plain declarations: `Route::get('/users', [UserController::class, 'index'])`
+- `Route::apiResource('users', UserController::class)` / `Route::resource(...)`, including `->only([...])` / `->except([...])`
+- `Route::prefix('v1')->group(function () { ... })` and nested groups
+- Laravel's convention that everything in `routes/api.php` is served under `/api`
+- Route parameters (`{id}`, `{id?}`) mapped to tool input parameters
+
+As with every other adapter, `DELETE` routes (and `apiResource`'s `destroy` action) are classified `DESTRUCTIVE` and `BLOCKED` until you explicitly approve them via `fridayy review`.
+
+> This is a regex-based scanner, not a full PHP parser — it expects conventionally-formatted route files (one route or group-opener per line, as Laravel's own docs and starter kits write them). Routes built up dynamically in a loop, or registered from third-party service providers, won't be discovered; use an OpenAPI spec (e.g. via `l5-swagger`) for full coverage in those cases.
+
+---
+
 ### 🤖 Pointing AI Assistants to Your Project
 
 Simply point any LLM or AI agent (Cursor, Claude, ChatGPT, Gemini, Antigravity) to:
@@ -129,6 +166,7 @@ fridayy/
 │   ├── openapi/         # OpenAPI 3.0, 3.1 & Swagger 2.0 parser & request builder
 │   ├── rest/            # Generic HTTP / REST executor
 │   ├── nodejs/          # Express / Fastify / Koa AST route scanner
+│   ├── laravel/         # Laravel routes/*.php scanner (Route::, resource/apiResource, groups)
 │   ├── manual/          # Custom user-defined tools
 │   └── registry.ts      # Adapter Registry (extensible to GraphQL, SQL, etc.)
 │
@@ -164,13 +202,31 @@ Every operation is automatically classified:
 
 ### 2. Zero-Leak Secret Isolation
 - Secrets and tokens are **never** embedded in tool schemas, descriptions, or LLM-visible payloads.
-- Authentication tokens are resolved strictly from environment variables at execution time:
+- Authentication tokens are resolved from, in priority order: an explicit `envKey`, standard `FRIDAYY_*` environment variables, and the global per-device credentials store:
   ```env
   FRIDAYY_API_KEY=your_api_key_here
   FRIDAYY_BEARER_TOKEN=your_bearer_token_here
   FRIDAYY_API_URL=http://localhost:4000
   ```
-- Sensitive headers (`Authorization`, `x-api-key`, `Cookie`) and payload fields (`password`, `token`, `secret`) are automatically redacted in audit logs and error messages.
+  Prefer environment variables (or `fridayy secrets set FRIDAYY_API_KEY <value>` to store it once per machine) over the `auth.<scheme>.value` config field — anything in `fridayy.config.json` is easy to accidentally commit to source control.
+- Sensitive headers (`Authorization`, `x-api-key`, `Cookie`) and payload fields (`password`, `token`, `secret`), along with JWTs, common vendor API-key formats, and long hex tokens found anywhere in a value, are automatically redacted in audit logs and error messages — regardless of the field name they're stored under.
+
+### 2b. Global Credentials Store (works the same on any device)
+Instead of duplicating a secret in every project's `fridayy.config.json`, store it once per machine:
+```bash
+fridayy secrets set FRIDAYY_API_KEY sk_live_...
+fridayy secrets list
+fridayy secrets remove FRIDAYY_API_KEY
+```
+This writes to an OS-appropriate, user-scoped location (`%APPDATA%\fridayy` on Windows, `~/Library/Application Support/fridayy` on macOS, `$XDG_CONFIG_HOME/fridayy` or `~/.config/fridayy` on Linux) with owner-only file permissions. It's a convenience layer over plain JSON, not an OS keychain — for production deployments, prefer real environment variables or a secrets manager.
+
+### 2c. Securing the SSE/HTTP Transport
+`fridayy start --transport sse` has **no authentication by default**, since it's designed primarily for local, single-user use. Before exposing it beyond `localhost`, set an API key:
+```bash
+export FRIDAYY_SERVER_API_KEY=some-long-random-value
+fridayy start --transport sse --host 0.0.0.0 --port 3000
+```
+Every request (except `/health`) must then present the key via `Authorization: Bearer <key>`, an `x-api-key` header, or an `?apiKey=` query parameter. Starting `sse` on a non-loopback host without a key refuses to start unless you pass `--allow-insecure` — which is not recommended.
 
 ### 3. Dynamic Schema Validation
 All input arguments provided by AI agents are validated against the tool's JSON Schema (types, required fields, ranges, and enum constraints) prior to dispatching HTTP requests.
@@ -192,6 +248,7 @@ All input arguments provided by AI agents are validated against the tool's JSON
 | `fridayy start` | Boots standard MCP server (Stdio or SSE) | `fridayy start --transport sse --port 3000` |
 | `fridayy tools` | Lists tool statuses and permission types | `fridayy tools --approved` |
 | `fridayy config` | Displays or updates configuration | `fridayy config get source.baseUrl` |
+| `fridayy secrets` | Manages the global per-device credentials store | `fridayy secrets set FRIDAYY_API_KEY <value>` |
 | `fridayy doctor` | Runs diagnostics on config, secrets, and API | `fridayy doctor` |
 
 ---
@@ -279,6 +336,7 @@ npm run example:demo
 
 - [x] OpenAPI 3.0, 3.1 & Swagger 2.0 support
 - [x] Node.js / Express / Fastify route discovery
+- [x] Laravel PHP route discovery (`routes/*.php`, resource/apiResource, groups)
 - [x] Stdio & SSE Transport support
 - [x] Granular permission classifier & destructive blocking
 - [x] Zero-leak secret isolation

package/dist/adapters/laravel/adapter.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Fridayy - Laravel Framework Adapter
+ * Discovers endpoints from a Laravel application's routes/*.php files and
+ * executes them the same way the generic REST adapter does (Laravel is just
+ * an HTTP API from the caller's point of view; no PHP runtime is needed here).
+ */
+import { BaseAdapter, AdapterScanContext, AdapterGenerationContext, AdapterExecutionContext } from '../base.js';
+import { FridayyToolDefinition, ToolExecutionResult } from '../../core/schema/types.js';
+export declare class LaravelAdapter extends BaseAdapter {
+    readonly name = "laravel";
+    readonly description = "Adapter for Laravel PHP applications (routes/web.php, routes/api.php)";
+    private scanner;
+    private restExecutor;
+    detect(context: AdapterScanContext): Promise<{
+        detected: boolean;
+        details?: any;
+    }>;
+    generateTools(context: AdapterGenerationContext): Promise<FridayyToolDefinition[]>;
+    executeTool(tool: FridayyToolDefinition, input: Record<string, any>, context?: AdapterExecutionContext): Promise<ToolExecutionResult>;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/dist/adapters/laravel/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/laravel/adapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,wBAAwB,EACxB,uBAAuB,EACxB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EAEpB,MAAM,4BAA4B,CAAC;AAWpC,qBAAa,cAAe,SAAQ,WAAW;IAC7C,SAAgB,IAAI,aAAa;IACjC,SAAgB,WAAW,2EAA2E;IAEtG,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,YAAY,CAAuB;IAE9B,MAAM,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,GAAG,CAAA;KAAE,CAAC;IA2BlF,aAAa,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAkFlF,WAAW,CACtB,IAAI,EAAE,qBAAqB,EAC3B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC1B,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,mBAAmB,CAAC;CAmBhC"}

package/dist/adapters/laravel/adapter.js

@@ -0,0 +1,133 @@
+/**
+ * Fridayy - Laravel Framework Adapter
+ * Discovers endpoints from a Laravel application's routes/*.php files and
+ * executes them the same way the generic REST adapter does (Laravel is just
+ * an HTTP API from the caller's point of view; no PHP runtime is needed here).
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { BaseAdapter } from '../base.js';
+import { LaravelRouteScanner } from './route-scanner.js';
+import { generateToolNameFromRoute } from '../../core/tool-generator/name-sanitizer.js';
+import { classifyOperation } from '../../core/permissions/classifier.js';
+import { buildToolDescription } from '../../core/tool-generator/description-builder.js';
+import { buildUnifiedInputSchema } from '../../core/schema/json-schema.js';
+import { defaultRestExecutor } from '../rest/executor.js';
+import { buildHttpRequest } from '../openapi/request-builder.js';
+import { AuthenticationManager } from '../../core/authentication/manager.js';
+import { defaultSecretResolver } from '../../core/authentication/secret-resolver.js';
+export class LaravelAdapter extends BaseAdapter {
+    name = 'laravel';
+    description = 'Adapter for Laravel PHP applications (routes/web.php, routes/api.php)';
+    scanner = new LaravelRouteScanner();
+    restExecutor = defaultRestExecutor;
+    async detect(context) {
+        const rootDir = context.rootDir;
+        const hasArtisan = fs.existsSync(path.join(rootDir, 'artisan'));
+        let hasLaravelComposerDep = false;
+        const composerPath = path.join(rootDir, 'composer.json');
+        if (fs.existsSync(composerPath)) {
+            try {
+                const composer = JSON.parse(fs.readFileSync(composerPath, 'utf-8'));
+                const allDeps = { ...composer.require, ...composer['require-dev'] };
+                hasLaravelComposerDep = Boolean(allDeps['laravel/framework'] || allDeps['laravel/lumen-framework']);
+            }
+            catch {
+                // ignore malformed composer.json
+            }
+        }
+        const routes = await this.scanner.scanDirectory(rootDir, 50);
+        return {
+            detected: Boolean(hasArtisan || hasLaravelComposerDep || routes.length > 0),
+            details: {
+                framework: hasArtisan || hasLaravelComposerDep ? 'laravel' : routes.length > 0 ? 'custom-php' : undefined,
+                discoveredRoutesCount: routes.length
+            }
+        };
+    }
+    async generateTools(context) {
+        const rootDir = context.rootDir || process.cwd();
+        const routes = await this.scanner.scanDirectory(rootDir);
+        const tools = [];
+        const usedToolNames = new Set();
+        // `php artisan serve` defaults to :8000, unlike the Node.js adapter's :3000.
+        const baseUrl = defaultSecretResolver.resolveBaseUrl(context.config?.source?.baseUrl) ||
+            'http://localhost:8000';
+        for (const r of routes) {
+            let toolName = generateToolNameFromRoute(r.method, r.path);
+            if (usedToolNames.has(toolName)) {
+                let suffix = 2;
+                while (usedToolNames.has(`${toolName}_${suffix}`))
+                    suffix++;
+                toolName = `${toolName}_${suffix}`;
+            }
+            usedToolNames.add(toolName);
+            const pathParams = r.pathParams.map(name => ({
+                name,
+                in: 'path',
+                required: true,
+                schema: { type: 'string' },
+                description: `Path parameter ${name}`
+            }));
+            const classification = classifyOperation({
+                method: r.method,
+                path: r.path,
+                name: toolName,
+                summary: r.description
+            }, context.config);
+            const description = buildToolDescription({
+                summary: r.description,
+                method: r.method,
+                path: r.path,
+                permissionType: classification.permissions.type,
+                risk: classification.risk
+            });
+            const inputSchema = buildUnifiedInputSchema({
+                parameters: { path: pathParams }
+            });
+            const tool = {
+                id: `tool_${toolName}`,
+                name: toolName,
+                description,
+                inputSchema,
+                source: {
+                    type: 'laravel',
+                    method: r.method,
+                    path: r.path,
+                    baseUrl
+                },
+                parameters: {
+                    path: pathParams
+                },
+                permissions: classification.permissions,
+                risk: classification.risk,
+                status: classification.status,
+                metadata: {
+                    createdAt: new Date().toISOString(),
+                    autoGenerated: true,
+                    sourceFile: r.file,
+                    line: r.line,
+                    ...(r.controller ? { controller: r.controller } : {})
+                }
+            };
+            tools.push(tool);
+        }
+        return tools;
+    }
+    async executeTool(tool, input, context = {}) {
+        const authManager = new AuthenticationManager(context.config);
+        const baseUrl = defaultSecretResolver.resolveBaseUrl(context.config?.source?.baseUrl);
+        const preparedReq = buildHttpRequest(tool, input, baseUrl);
+        if (context.headers) {
+            Object.assign(preparedReq.headers, context.headers);
+        }
+        authManager.applyAuth(tool.authentication, {
+            headers: preparedReq.headers,
+            queryParams: {}
+        });
+        return await this.restExecutor.execute(preparedReq, tool.name, {
+            timeoutMs: context.timeoutMs
+        });
+    }
+}
+//# sourceMappingURL=adapter.js.map

package/dist/adapters/laravel/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../src/adapters/laravel/adapter.ts"],"names":[],"mappings":"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"}

package/dist/adapters/laravel/route-scanner.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Fridayy - Laravel Route Scanner
+ * Scans a Laravel application's routes/*.php files for `Route::` declarations
+ * (including prefix/middleware groups and resource/apiResource shorthand) and
+ * turns them into the same DiscoveredRoute shape the Node.js scanner produces,
+ * so both can feed the same tool-generation pipeline.
+ *
+ * This is a regex/line-based heuristic scanner, not a real PHP parser (Laravel
+ * route files can contain arbitrarily complex PHP). It handles the common,
+ * conventionally-formatted patterns Laravel's own documentation and starter
+ * kits use: one route/group-opener per line, with the group's opening `{` on
+ * the same line as `->group(`.
+ */
+export interface DiscoveredRoute {
+    method: string;
+    path: string;
+    file: string;
+    line: number;
+    description?: string;
+    pathParams: string[];
+    controller?: string;
+}
+export declare class LaravelRouteScanner {
+    /**
+     * Scans a Laravel project's routes/ directory (routes/web.php, routes/api.php,
+     * and any other *.php files under routes/) for route declarations.
+     */
+    scanDirectory(rootDir: string, maxFiles?: number): Promise<DiscoveredRoute[]>;
+    /**
+     * Scans a single route file's content. `filePath`'s basename drives Laravel's
+     * conventional default prefix: routes registered in a file named `api.php`
+     * are served under `/api` unless the path is already prefixed with it.
+     */
+    scanFileContent(content: string, filePath: string): DiscoveredRoute[];
+    private extractComment;
+    private collectRouteFiles;
+}
+export declare const HTTP_METHOD_LIST: readonly ["get", "post", "put", "patch", "delete", "options"];
+//# sourceMappingURL=route-scanner.d.ts.map

package/dist/adapters/laravel/route-scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-scanner.d.ts","sourceRoot":"","sources":["../../../src/adapters/laravel/route-scanner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAyED,qBAAa,mBAAmB;IAC9B;;;OAGG;IACU,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,SAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IA2BvF;;;;OAIG;IACI,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,eAAe,EAAE;IA8F5E,OAAO,CAAC,cAAc;IA+BtB,OAAO,CAAC,iBAAiB;CAsB1B;AAED,eAAO,MAAM,gBAAgB,+DAAe,CAAC"}

package/dist/adapters/laravel/route-scanner.js

@@ -0,0 +1,238 @@
+/**
+ * Fridayy - Laravel Route Scanner
+ * Scans a Laravel application's routes/*.php files for `Route::` declarations
+ * (including prefix/middleware groups and resource/apiResource shorthand) and
+ * turns them into the same DiscoveredRoute shape the Node.js scanner produces,
+ * so both can feed the same tool-generation pipeline.
+ *
+ * This is a regex/line-based heuristic scanner, not a real PHP parser (Laravel
+ * route files can contain arbitrarily complex PHP). It handles the common,
+ * conventionally-formatted patterns Laravel's own documentation and starter
+ * kits use: one route/group-opener per line, with the group's opening `{` on
+ * the same line as `->group(`.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+const HTTP_METHODS = ['get', 'post', 'put', 'patch', 'delete', 'options'];
+// Route::get('/users', ...), Route::post('/users', [UserController::class, 'store']), etc.
+// `any`/`match` are intentionally excluded: their effective HTTP method(s) can't be
+// determined from the call site alone.
+const ROUTE_CALL_PATTERN = /Route::(get|post|put|patch|delete|options)\s*\(\s*(['"])((?:(?!\2).)*)\2/i;
+// Route::apiResource('users', UserController::class) / Route::resource('users', UserController::class)
+const RESOURCE_CALL_PATTERN = /Route::(apiResource|resource)\s*\(\s*(['"])((?:(?!\2).)*)\2\s*,\s*([A-Za-z0-9_\\]+)(?:::class)?\s*\)/i;
+const ONLY_MODIFIER_PATTERN = /->only\(\s*\[([^\]]*)\]\s*\)/i;
+const EXCEPT_MODIFIER_PATTERN = /->except\(\s*\[([^\]]*)\]\s*\)/i;
+// Route::prefix('v1')->middleware('api')->group(function () {   <- opens a prefixed group
+const PREFIX_GROUP_OPEN_PATTERN = /Route::prefix\s*\(\s*(['"])((?:(?!\1).)*)\1\s*\)(?:\s*->\s*[a-zA-Z]+\([^)]*\))*\s*->\s*group\s*\([^{]*\{/i;
+// Route::middleware('api')->group(function () {   <- opens a group with no added path prefix
+const PLAIN_GROUP_OPEN_PATTERN = /Route::(?:middleware|group)\s*\([^)]*\)\s*->\s*group\s*\([^{]*\{/i;
+const RESOURCE_ACTIONS = {
+    apiResource: [
+        { method: 'GET', suffix: '' },
+        { method: 'POST', suffix: '' },
+        { method: 'GET', suffix: '/{id}' },
+        { method: 'PUT', suffix: '/{id}' },
+        { method: 'PATCH', suffix: '/{id}' },
+        { method: 'DELETE', suffix: '/{id}' }
+    ],
+    resource: [
+        { method: 'GET', suffix: '' },
+        { method: 'GET', suffix: '/create' },
+        { method: 'POST', suffix: '' },
+        { method: 'GET', suffix: '/{id}' },
+        { method: 'GET', suffix: '/{id}/edit' },
+        { method: 'PUT', suffix: '/{id}' },
+        { method: 'PATCH', suffix: '/{id}' },
+        { method: 'DELETE', suffix: '/{id}' }
+    ]
+};
+// Maps each synthesized action to the Laravel resource-controller method name,
+// used to honor ->only([...]) / ->except([...]) filters.
+const RESOURCE_ACTION_NAMES = {
+    'GET:': 'index',
+    'POST:': 'store',
+    'GET:/create': 'create',
+    'GET:/{id}': 'show',
+    'GET:/{id}/edit': 'edit',
+    'PUT:/{id}': 'update',
+    'PATCH:/{id}': 'update',
+    'DELETE:/{id}': 'destroy'
+};
+function joinPaths(...segments) {
+    const cleaned = segments
+        .map(s => s.trim().replace(/^\/+|\/+$/g, ''))
+        .filter(s => s.length > 0);
+    return `/${cleaned.join('/')}`;
+}
+function extractPathParams(routePath) {
+    return (routePath.match(/\{([a-zA-Z0-9_]+)\??\}/g) || []).map(p => p.replace(/[{}?]/g, ''));
+}
+export class LaravelRouteScanner {
+    /**
+     * Scans a Laravel project's routes/ directory (routes/web.php, routes/api.php,
+     * and any other *.php files under routes/) for route declarations.
+     */
+    async scanDirectory(rootDir, maxFiles = 200) {
+        const routesDir = path.join(rootDir, 'routes');
+        const discovered = [];
+        const files = this.collectRouteFiles(routesDir, maxFiles);
+        for (const file of files) {
+            try {
+                const content = fs.readFileSync(file, 'utf-8');
+                discovered.push(...this.scanFileContent(content, file));
+            }
+            catch {
+                // Skip unreadable files
+            }
+        }
+        // Deduplicate by method + path (a route registered in multiple files/groups
+        // should only produce one tool).
+        const uniqueMap = new Map();
+        for (const r of discovered) {
+            const key = `${r.method}:${r.path}`;
+            if (!uniqueMap.has(key)) {
+                uniqueMap.set(key, r);
+            }
+        }
+        return Array.from(uniqueMap.values());
+    }
+    /**
+     * Scans a single route file's content. `filePath`'s basename drives Laravel's
+     * conventional default prefix: routes registered in a file named `api.php`
+     * are served under `/api` unless the path is already prefixed with it.
+     */
+    scanFileContent(content, filePath) {
+        const routes = [];
+        const lines = content.split('\n');
+        const basename = path.basename(filePath).toLowerCase();
+        const isApiFile = basename === 'api.php';
+        const groupStack = [];
+        let depth = 0;
+        const currentPrefix = () => groupStack.map(g => g.prefix).filter(Boolean);
+        for (let lineIndex = 0; lineIndex < lines.length; lineIndex++) {
+            const line = lines[lineIndex];
+            // 1. Group openers (checked before applying this line's brace delta, since
+            // the opening brace they introduce belongs to the *new* nested depth).
+            const prefixGroupMatch = line.match(PREFIX_GROUP_OPEN_PATTERN);
+            const plainGroupMatch = !prefixGroupMatch && line.match(PLAIN_GROUP_OPEN_PATTERN);
+            const braceDelta = (line.match(/\{/g) || []).length - (line.match(/\}/g) || []).length;
+            const newDepth = depth + braceDelta;
+            if (prefixGroupMatch) {
+                groupStack.push({ prefix: prefixGroupMatch[2], depthAfterOpen: newDepth });
+            }
+            else if (plainGroupMatch) {
+                groupStack.push({ prefix: '', depthAfterOpen: newDepth });
+            }
+            depth = newDepth;
+            // Pop any group frames we've closed out of.
+            while (groupStack.length > 0 && groupStack[groupStack.length - 1].depthAfterOpen > depth) {
+                groupStack.pop();
+            }
+            // 2. Resource / apiResource shorthand.
+            const resourceMatch = line.match(RESOURCE_CALL_PATTERN);
+            if (resourceMatch) {
+                const kind = resourceMatch[1].toLowerCase() === 'apiresource' ? 'apiResource' : 'resource';
+                const resourceName = resourceMatch[3];
+                const controller = resourceMatch[4];
+                const onlyMatch = line.match(ONLY_MODIFIER_PATTERN);
+                const exceptMatch = line.match(EXCEPT_MODIFIER_PATTERN);
+                const onlyActions = onlyMatch
+                    ? onlyMatch[1].split(',').map(s => s.trim().replace(/^['"]|['"]$/g, ''))
+                    : undefined;
+                const exceptActions = exceptMatch
+                    ? exceptMatch[1].split(',').map(s => s.trim().replace(/^['"]|['"]$/g, ''))
+                    : undefined;
+                for (const action of RESOURCE_ACTIONS[kind]) {
+                    const actionName = RESOURCE_ACTION_NAMES[`${action.method}:${action.suffix}`];
+                    if (onlyActions && !onlyActions.includes(actionName))
+                        continue;
+                    if (exceptActions && exceptActions.includes(actionName))
+                        continue;
+                    const rawPath = joinPaths(...currentPrefix(), resourceName) + action.suffix;
+                    const finalPath = isApiFile && !rawPath.startsWith('/api/') && rawPath !== '/api' ? `/api${rawPath}` : rawPath;
+                    routes.push({
+                        method: action.method,
+                        path: finalPath,
+                        file: filePath,
+                        line: lineIndex + 1,
+                        description: `Laravel ${kind} route (${resourceName}.${actionName})`,
+                        pathParams: extractPathParams(finalPath),
+                        controller
+                    });
+                }
+                continue;
+            }
+            // 3. Plain Route::{method}(...) calls.
+            const routeMatch = line.match(ROUTE_CALL_PATTERN);
+            if (routeMatch) {
+                const method = routeMatch[1].toUpperCase();
+                const rawPath = joinPaths(...currentPrefix(), routeMatch[3]);
+                const finalPath = isApiFile && !rawPath.startsWith('/api/') && rawPath !== '/api' ? `/api${rawPath}` : rawPath;
+                const comment = this.extractComment(lines, lineIndex);
+                routes.push({
+                    method,
+                    path: finalPath,
+                    file: filePath,
+                    line: lineIndex + 1,
+                    description: comment,
+                    pathParams: extractPathParams(finalPath)
+                });
+            }
+        }
+        return routes;
+    }
+    extractComment(lines, lineIndex) {
+        if (lineIndex <= 0)
+            return undefined;
+        const prevLine = lines[lineIndex - 1].trim();
+        if (prevLine.startsWith('//') || prevLine.startsWith('#')) {
+            return prevLine.replace(/^(\/\/|#)\s*/, '');
+        }
+        // PHP doc block: /** ... */ possibly spanning several lines, with the
+        // route directly following the closing `*/`. Walk back to find the last
+        // non-empty content line inside the block.
+        if (prevLine === '*/' || prevLine.endsWith('*/')) {
+            for (let i = lineIndex - 2; i >= 0; i--) {
+                const line = lines[i].trim();
+                if (line.startsWith('/**') || line.startsWith('/*'))
+                    break;
+                const cleaned = line.replace(/^\*\s?/, '').trim();
+                if (cleaned.length > 0) {
+                    return cleaned;
+                }
+            }
+            return undefined;
+        }
+        if (prevLine.startsWith('*')) {
+            const cleaned = prevLine.replace(/^\*\s*/, '').trim();
+            return cleaned.length > 0 ? cleaned : undefined;
+        }
+        return undefined;
+    }
+    collectRouteFiles(routesDir, maxFiles, collected = []) {
+        if (!fs.existsSync(routesDir))
+            return collected;
+        if (collected.length >= maxFiles)
+            return collected;
+        try {
+            const entries = fs.readdirSync(routesDir, { withFileTypes: true });
+            for (const entry of entries) {
+                if (collected.length >= maxFiles)
+                    break;
+                const fullPath = path.join(routesDir, entry.name);
+                if (entry.isDirectory()) {
+                    this.collectRouteFiles(fullPath, maxFiles, collected);
+                }
+                else if (entry.isFile() && entry.name.toLowerCase().endsWith('.php')) {
+                    collected.push(fullPath);
+                }
+            }
+        }
+        catch {
+            // ignore permission errors
+        }
+        return collected;
+    }
+}
+export const HTTP_METHOD_LIST = HTTP_METHODS;
+//# sourceMappingURL=route-scanner.js.map

package/dist/adapters/laravel/route-scanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-scanner.js","sourceRoot":"","sources":["../../../src/adapters/laravel/route-scanner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAY7B,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,CAAU,CAAC;AAEnF,2FAA2F;AAC3F,oFAAoF;AACpF,uCAAuC;AACvC,MAAM,kBAAkB,GAAG,2EAA2E,CAAC;AAEvG,uGAAuG;AACvG,MAAM,qBAAqB,GACzB,uGAAuG,CAAC;AAE1G,MAAM,qBAAqB,GAAG,+BAA+B,CAAC;AAC9D,MAAM,uBAAuB,GAAG,iCAAiC,CAAC;AAElE,0FAA0F;AAC1F,MAAM,yBAAyB,GAC7B,2GAA2G,CAAC;AAE9G,6FAA6F;AAC7F,MAAM,wBAAwB,GAAG,mEAAmE,CAAC;AAOrG,MAAM,gBAAgB,GAAyD;IAC7E,WAAW,EAAE;QACX,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE;QAC7B,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE;QAC9B,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE;QAClC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE;QAClC,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE;QACpC,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE;KACtC;IACD,QAAQ,EAAE;QACR,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE;QAC7B,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE;QACpC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE;QAC9B,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE;QAClC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE;QACvC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE;QAClC,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE;QACpC,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE;KACtC;CACF,CAAC;AAEF,+EAA+E;AAC/E,yDAAyD;AACzD,MAAM,qBAAqB,GAA2B;IACpD,MAAM,EAAE,OAAO;IACf,OAAO,EAAE,OAAO;IAChB,aAAa,EAAE,QAAQ;IACvB,WAAW,EAAE,MAAM;IACnB,gBAAgB,EAAE,MAAM;IACxB,WAAW,EAAE,QAAQ;IACrB,aAAa,EAAE,QAAQ;IACvB,cAAc,EAAE,SAAS;CAC1B,CAAC;AAEF,SAAS,SAAS,CAAC,GAAG,QAAkB;IACtC,MAAM,OAAO,GAAG,QAAQ;SACrB,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;SAC5C,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC7B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;AACjC,CAAC;AAED,SAAS,iBAAiB,CAAC,SAAiB;IAC1C,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,yBAAyB,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC;AAC9F,CAAC;AAED,MAAM,OAAO,mBAAmB;IAC9B;;;OAGG;IACI,KAAK,CAAC,aAAa,CAAC,OAAe,EAAE,QAAQ,GAAG,GAAG;QACxD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAC/C,MAAM,UAAU,GAAsB,EAAE,CAAC;QACzC,MAAM,KAAK,GAAG,IAAI,CAAC,iBAAiB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAE1D,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;gBAC/C,UAAU,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;YAC1D,CAAC;YAAC,MAAM,CAAC;gBACP,wBAAwB;YAC1B,CAAC;QACH,CAAC;QAED,4EAA4E;QAC5E,iCAAiC;QACjC,MAAM,SAAS,GAAG,IAAI,GAAG,EAA2B,CAAC;QACrD,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;YAC3B,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;YACpC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBACxB,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;YACxB,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;IACxC,CAAC;IAED;;;;OAIG;IACI,eAAe,CAAC,OAAe,EAAE,QAAgB;QACtD,MAAM,MAAM,GAAsB,EAAE,CAAC;QACrC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;QACvD,MAAM,SAAS,GAAG,QAAQ,KAAK,SAAS,CAAC;QAEzC,MAAM,UAAU,GAAiB,EAAE,CAAC;QACpC,IAAI,KAAK,GAAG,CAAC,CAAC;QAEd,MAAM,aAAa,GAAG,GAAG,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAE1E,KAAK,IAAI,SAAS,GAAG,CAAC,EAAE,SAAS,GAAG,KAAK,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,CAAC;YAC9D,MAAM,IAAI,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC;YAE9B,2EAA2E;YAC3E,uEAAuE;YACvE,MAAM,gBAAgB,GAAG,IAAI,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;YAC/D,MAAM,eAAe,GAAG,CAAC,gBAAgB,IAAI,IAAI,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;YAElF,MAAM,UAAU,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;YACvF,MAAM,QAAQ,GAAG,KAAK,GAAG,UAAU,CAAC;YAEpC,IAAI,gBAAgB,EAAE,CAAC;gBACrB,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,QAAQ,EAAE,CAAC,CAAC;YAC7E,CAAC;iBAAM,IAAI,eAAe,EAAE,CAAC;gBAC3B,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,cAAc,EAAE,QAAQ,EAAE,CAAC,CAAC;YAC5D,CAAC;YAED,KAAK,GAAG,QAAQ,CAAC;YAEjB,4CAA4C;YAC5C,OAAO,UAAU,CAAC,MAAM,GAAG,CAAC,IAAI,UAAU,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,cAAc,GAAG,KAAK,EAAE,CAAC;gBACzF,UAAU,CAAC,GAAG,EAAE,CAAC;YACnB,CAAC;YAED,uCAAuC;YACvC,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;YACxD,IAAI,aAAa,EAAE,CAAC;gBAClB,MAAM,IAAI,GAA+B,aAAa,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,aAAa,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,UAAU,CAAC;gBACvH,MAAM,YAAY,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;gBACtC,MAAM,UAAU,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;gBAEpC,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;gBACpD,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;gBACxD,MAAM,WAAW,GAAG,SAAS;oBAC3B,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;oBACxE,CAAC,CAAC,SAAS,CAAC;gBACd,MAAM,aAAa,GAAG,WAAW;oBAC/B,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;oBAC1E,CAAC,CAAC,SAAS,CAAC;gBAEd,KAAK,MAAM,MAAM,IAAI,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC5C,MAAM,UAAU,GAAG,qBAAqB,CAAC,GAAG,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;oBAC9E,IAAI,WAAW,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,UAAU,CAAC;wBAAE,SAAS;oBAC/D,IAAI,aAAa,IAAI,aAAa,CAAC,QAAQ,CAAC,UAAU,CAAC;wBAAE,SAAS;oBAElE,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,aAAa,EAAE,EAAE,YAAY,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;oBAC5E,MAAM,SAAS,GAAG,SAAS,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,OAAO,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;oBAE/G,MAAM,CAAC,IAAI,CAAC;wBACV,MAAM,EAAE,MAAM,CAAC,MAAM;wBACrB,IAAI,EAAE,SAAS;wBACf,IAAI,EAAE,QAAQ;wBACd,IAAI,EAAE,SAAS,GAAG,CAAC;wBACnB,WAAW,EAAE,WAAW,IAAI,WAAW,YAAY,IAAI,UAAU,GAAG;wBACpE,UAAU,EAAE,iBAAiB,CAAC,SAAS,CAAC;wBACxC,UAAU;qBACX,CAAC,CAAC;gBACL,CAAC;gBACD,SAAS;YACX,CAAC;YAED,uCAAuC;YACvC,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;YAClD,IAAI,UAAU,EAAE,CAAC;gBACf,MAAM,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;gBAC3C,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,aAAa,EAAE,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC7D,MAAM,SAAS,GAAG,SAAS,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,OAAO,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;gBAC/G,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;gBAEtD,MAAM,CAAC,IAAI,CAAC;oBACV,MAAM;oBACN,IAAI,EAAE,SAAS;oBACf,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,SAAS,GAAG,CAAC;oBACnB,WAAW,EAAE,OAAO;oBACpB,UAAU,EAAE,iBAAiB,CAAC,SAAS,CAAC;iBACzC,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,cAAc,CAAC,KAAe,EAAE,SAAiB;QACvD,IAAI,SAAS,IAAI,CAAC;YAAE,OAAO,SAAS,CAAC;QACrC,MAAM,QAAQ,GAAG,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAE7C,IAAI,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1D,OAAO,QAAQ,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;QAC9C,CAAC;QAED,sEAAsE;QACtE,wEAAwE;QACxE,2CAA2C;QAC3C,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACjD,KAAK,IAAI,CAAC,GAAG,SAAS,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;gBACxC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;gBAC7B,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;oBAAE,MAAM;gBAC3D,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;gBAClD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACvB,OAAO,OAAO,CAAC;gBACjB,CAAC;YACH,CAAC;YACD,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,IAAI,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7B,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YACtD,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;QAClD,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAEO,iBAAiB,CAAC,SAAiB,EAAE,QAAgB,EAAE,YAAsB,EAAE;QACrF,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC;YAAE,OAAO,SAAS,CAAC;QAChD,IAAI,SAAS,CAAC,MAAM,IAAI,QAAQ;YAAE,OAAO,SAAS,CAAC;QAEnD,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;YACnE,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;gBAC5B,IAAI,SAAS,CAAC,MAAM,IAAI,QAAQ;oBAAE,MAAM;gBACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;gBAElD,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;oBACxB,IAAI,CAAC,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;gBACxD,CAAC;qBAAM,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;oBACvE,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBAC3B,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,2BAA2B;QAC7B,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;CACF;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,YAAY,CAAC"}

package/dist/adapters/nodejs/ast-scanner.d.ts

@@ -1,6 +1,6 @@
 /**
- * Fridayy - Node.js Route Scanner
- * Scans JavaScript and TypeScript files for Express/Fastify/Koa route declarations.
+ * Fridayy - Enhanced Node.js Route Scanner
+ * Scans JavaScript and TypeScript files for Express, Fastify, Koa, NestJS, and Next.js route declarations.
  */
 export interface DiscoveredRoute {
     method: string;
@@ -12,10 +12,12 @@ export interface DiscoveredRoute {
 }
 export declare class NodeJsScanner {
     /**
-     * Scans a directory recursively for Express/Fastify routes.
+     * Scans a directory recursively for Express/Fastify/Koa/NestJS/Next.js routes.
      */
     scanDirectory(rootDir: string, maxFiles?: number): Promise<DiscoveredRoute[]>;
     scanFileContent(content: string, filePath: string): DiscoveredRoute[];
+    private scanNextJsRouteFile;
+    private extractComment;
     private collectSourceFiles;
 }
 //# sourceMappingURL=ast-scanner.d.ts.map

package/dist/adapters/nodejs/ast-scanner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ast-scanner.d.ts","sourceRoot":"","sources":["../../../src/adapters/nodejs/ast-scanner.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAID,qBAAa,aAAa;IACxB;;OAEG;IACU,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,SAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAiBhF,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,eAAe,EAAE;IAkD5E,OAAO,CAAC,kBAAkB;CA8B3B"}
+{"version":3,"file":"ast-scanner.d.ts","sourceRoot":"","sources":["../../../src/adapters/nodejs/ast-scanner.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAWD,qBAAa,aAAa;IACxB;;OAEG;IACU,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,SAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IA8BhF,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,eAAe,EAAE;IAsD5E,OAAO,CAAC,mBAAmB;IAyC3B,OAAO,CAAC,cAAc;IAoBtB,OAAO,CAAC,kBAAkB;CA8B3B"}