sammy-sdk 0.1.0

package/dist/discovery/extractors/model-extractor.js

@@ -0,0 +1,256 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { SyntaxKind } from "ts-morph";
+import { createAstContext, addFile } from "../ast/project.js";
+import { listProjectSourceFiles } from "../ast/source-files.js";
+export async function extractModels(projectRoot, ast) {
+    // Prisma uses its own schema DSL (not TypeScript), so it takes priority and
+    // short-circuits the TS-based ORM parsers.
+    const prismaSchema = findPrismaSchema(projectRoot);
+    if (prismaSchema) {
+        return parsePrismaSchema(prismaSchema);
+    }
+    const context = ast ?? createAstContext(projectRoot);
+    return [...parseDrizzleModels(projectRoot, context), ...parseMongooseModels(projectRoot, context)];
+}
+// ── Prisma ────────────────────────────────────────────────────────────────
+function findPrismaSchema(projectRoot) {
+    const candidates = [
+        path.join(projectRoot, "prisma", "schema.prisma"),
+        path.join(projectRoot, "schema.prisma"),
+        path.join(projectRoot, "src", "prisma", "schema.prisma"),
+    ];
+    for (const candidate of candidates) {
+        if (fs.existsSync(candidate))
+            return candidate;
+    }
+    return null;
+}
+function parsePrismaSchema(schemaPath) {
+    const content = fs.readFileSync(schemaPath, "utf-8");
+    const models = [];
+    const modelRegex = /model\s+(\w+)\s*\{([^}]+)\}/g;
+    let modelMatch;
+    while ((modelMatch = modelRegex.exec(content)) !== null) {
+        const modelName = modelMatch[1];
+        const body = modelMatch[2];
+        const fields = [];
+        const relations = [];
+        const lines = body.split("\n").map((l) => l.trim()).filter((l) => l && !l.startsWith("//") && !l.startsWith("@@"));
+        for (const line of lines) {
+            const fieldMatch = line.match(/^(\w+)\s+(\w+)(\[\])?([\?!])?\s*(.*)?$/);
+            if (!fieldMatch)
+                continue;
+            const [, fieldName, fieldType, isArray, optionalMarker, attributes] = fieldMatch;
+            const fullType = isArray ? `${fieldType}[]` : fieldType;
+            if (attributes && attributes.includes("@relation")) {
+                relations.push({ name: fieldName, type: isArray ? "many" : "one", model: fieldType });
+            }
+            else if (/^[A-Z]/.test(fieldType) && !["String", "Int", "Float", "Boolean", "DateTime", "Json", "Bytes", "BigInt", "Decimal"].includes(fieldType)) {
+                relations.push({ name: fieldName, type: isArray ? "many" : "one", model: fieldType });
+            }
+            else {
+                fields.push({ name: fieldName, type: fullType, optional: optionalMarker === "?" });
+            }
+        }
+        models.push({ name: modelName, fields, relations, source: "prisma" });
+    }
+    return models;
+}
+// ── Drizzle ─────────────────────────────────────────────────────────────────
+const DRIZZLE_TABLE_FNS = new Set(["pgTable", "mysqlTable", "sqliteTable"]);
+function parseDrizzleModels(projectRoot, ast) {
+    const models = [];
+    const byName = new Map();
+    const relationCalls = [];
+    // Single pass: collect tables and relation() calls. Relations are linked
+    // afterwards, since a relation may reference a table defined in another file.
+    for (const filePath of listProjectSourceFiles(projectRoot)) {
+        let content;
+        try {
+            content = fs.readFileSync(filePath, "utf-8");
+        }
+        catch {
+            continue;
+        }
+        if (!/pgTable|mysqlTable|sqliteTable|\brelations\s*\(/.test(content))
+            continue;
+        let sourceFile;
+        try {
+            sourceFile = addFile(ast, filePath);
+        }
+        catch {
+            continue;
+        }
+        if (!sourceFile)
+            continue;
+        for (const vd of sourceFile.getVariableDeclarations()) {
+            const call = vd.getInitializer()?.asKind(SyntaxKind.CallExpression);
+            const fnName = call?.getExpression().asKind(SyntaxKind.Identifier)?.getText();
+            if (!call || !fnName || !DRIZZLE_TABLE_FNS.has(fnName))
+                continue;
+            const colsObj = call.getArguments()[1]?.asKind(SyntaxKind.ObjectLiteralExpression);
+            const model = {
+                name: vd.getName(),
+                fields: colsObj ? drizzleFields(colsObj) : [],
+                relations: [],
+                source: "drizzle",
+            };
+            models.push(model);
+            byName.set(model.name, model);
+        }
+        for (const call of sourceFile.getDescendantsOfKind(SyntaxKind.CallExpression)) {
+            if (call.getExpression().asKind(SyntaxKind.Identifier)?.getText() === "relations") {
+                relationCalls.push(call);
+            }
+        }
+    }
+    for (const call of relationCalls)
+        linkDrizzleRelation(call, byName);
+    return models;
+}
+function drizzleFields(colsObj) {
+    const obj = colsObj.asKind(SyntaxKind.ObjectLiteralExpression);
+    if (!obj)
+        return [];
+    const fields = [];
+    for (const prop of obj.getProperties()) {
+        const assignment = prop.asKind(SyntaxKind.PropertyAssignment);
+        if (!assignment)
+            continue;
+        const name = assignment.getName().replace(/['"]/g, "");
+        const valueText = assignment.getInitializer()?.getText() ?? "";
+        const type = valueText.match(/^(\w+)\s*\(/)?.[1] ?? "unknown";
+        const optional = !/\.notNull\(\)/.test(valueText) && !/\.primaryKey\(\)/.test(valueText);
+        fields.push({ name, type, optional });
+    }
+    return fields;
+}
+// Link a single `relations(users, ({ many, one }) => ({ posts: many(posts) }))`
+// call onto its model.
+function linkDrizzleRelation(call, byName) {
+    const callExpr = call.asKind(SyntaxKind.CallExpression);
+    if (!callExpr)
+        return;
+    const tableName = callExpr.getArguments()[0]?.asKind(SyntaxKind.Identifier)?.getText();
+    const model = tableName ? byName.get(tableName) : undefined;
+    if (!model)
+        return;
+    const fn = callExpr.getArguments()[1];
+    const body = fn?.asKind(SyntaxKind.ArrowFunction)?.getBody();
+    const obj = unwrapParenObject(body)?.asKind(SyntaxKind.ObjectLiteralExpression);
+    if (!obj)
+        return;
+    for (const prop of obj.getProperties()) {
+        const assignment = prop.asKind(SyntaxKind.PropertyAssignment);
+        const relCall = assignment?.getInitializer()?.asKind(SyntaxKind.CallExpression);
+        const relType = relCall?.getExpression().asKind(SyntaxKind.Identifier)?.getText();
+        if (!assignment || !relCall || (relType !== "many" && relType !== "one"))
+            continue;
+        const target = relCall.getArguments()[0]?.asKind(SyntaxKind.Identifier)?.getText() ?? "unknown";
+        model.relations.push({ name: assignment.getName().replace(/['"]/g, ""), type: relType, model: target });
+    }
+}
+function unwrapParenObject(body) {
+    if (!body)
+        return undefined;
+    const paren = body.asKind(SyntaxKind.ParenthesizedExpression)?.getExpression() ?? body;
+    return paren.asKind(SyntaxKind.ObjectLiteralExpression);
+}
+// ── Mongoose ─────────────────────────────────────────────────────────────────
+function parseMongooseModels(projectRoot, ast) {
+    const models = [];
+    for (const filePath of listProjectSourceFiles(projectRoot)) {
+        let content;
+        try {
+            content = fs.readFileSync(filePath, "utf-8");
+        }
+        catch {
+            continue;
+        }
+        if (!/new\s+(mongoose\.)?Schema|\.model\s*\(|\bmodel\s*\(/.test(content))
+            continue;
+        let sourceFile;
+        try {
+            sourceFile = addFile(ast, filePath);
+        }
+        catch {
+            continue;
+        }
+        if (!sourceFile)
+            continue;
+        // Map schema variable name → model name via `model("Name", schemaVar)`.
+        const varToModelName = new Map();
+        for (const call of sourceFile.getDescendantsOfKind(SyntaxKind.CallExpression)) {
+            if (!/(^|\.)model$/.test(call.getExpression().getText()))
+                continue;
+            const name = call.getArguments()[0]?.asKind(SyntaxKind.StringLiteral)?.getLiteralText();
+            if (!name)
+                continue;
+            const schemaArg = call.getArguments()[1];
+            const inlineSchema = schemaArg?.asKind(SyntaxKind.NewExpression);
+            if (inlineSchema && isSchemaNew(inlineSchema)) {
+                models.push({ name, fields: mongooseFields(inlineSchema), relations: [], source: "mongoose" });
+            }
+            else {
+                const ident = schemaArg?.asKind(SyntaxKind.Identifier)?.getText();
+                if (ident)
+                    varToModelName.set(ident, name);
+            }
+        }
+        for (const vd of sourceFile.getVariableDeclarations()) {
+            const newExpr = vd.getInitializer()?.asKind(SyntaxKind.NewExpression);
+            if (!newExpr || !isSchemaNew(newExpr))
+                continue;
+            models.push({
+                name: varToModelName.get(vd.getName()) ?? capitalize(vd.getName()),
+                fields: mongooseFields(newExpr),
+                relations: [],
+                source: "mongoose",
+            });
+        }
+    }
+    return models;
+}
+function isSchemaNew(newExpr) {
+    const callee = newExpr.asKind(SyntaxKind.NewExpression)?.getExpression().getText() ?? "";
+    return /(^|\.)Schema$/.test(callee);
+}
+function mongooseFields(newExpr) {
+    const obj = newExpr.asKind(SyntaxKind.NewExpression)?.getArguments()[0]?.asKind(SyntaxKind.ObjectLiteralExpression);
+    if (!obj)
+        return [];
+    const fields = [];
+    for (const prop of obj.getProperties()) {
+        const assignment = prop.asKind(SyntaxKind.PropertyAssignment);
+        if (!assignment)
+            continue;
+        const name = assignment.getName().replace(/['"]/g, "");
+        const value = assignment.getInitializer();
+        if (!value)
+            continue;
+        let type = "unknown";
+        let optional = true;
+        const config = value.asKind(SyntaxKind.ObjectLiteralExpression);
+        if (config) {
+            const typeProp = config.getProperty("type")?.asKind(SyntaxKind.PropertyAssignment)?.getInitializer();
+            type = typeProp?.getText() ?? "unknown";
+            const requiredProp = config.getProperty("required")?.asKind(SyntaxKind.PropertyAssignment)?.getInitializer();
+            if (requiredProp?.getText() === "true")
+                optional = false;
+        }
+        else if (value.getKind() === SyntaxKind.ArrayLiteralExpression) {
+            const inner = value.asKind(SyntaxKind.ArrayLiteralExpression)?.getElements()[0]?.getText() ?? "unknown";
+            type = `${inner}[]`;
+        }
+        else {
+            type = value.getText();
+        }
+        fields.push({ name, type, optional });
+    }
+    return fields;
+}
+function capitalize(s) {
+    return s ? s.charAt(0).toUpperCase() + s.slice(1) : s;
+}
+//# sourceMappingURL=model-extractor.js.map

package/dist/discovery/extractors/model-extractor.js.map

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

package/dist/discovery/extractors/nestjs-extractor.d.ts

@@ -0,0 +1,4 @@
+import type { RouteCapability } from "../types.js";
+import type { AstContext } from "../ast/project.js";
+export declare function extractNestRoutes(projectRoot: string, ast: AstContext): RouteCapability[];
+//# sourceMappingURL=nestjs-extractor.d.ts.map

package/dist/discovery/extractors/nestjs-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nestjs-extractor.d.ts","sourceRoot":"","sources":["../../../src/discovery/extractors/nestjs-extractor.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAgB,MAAM,aAAa,CAAC;AACjE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAqBpD,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,UAAU,GAAG,eAAe,EAAE,CAgDzF"}

package/dist/discovery/extractors/nestjs-extractor.js

@@ -0,0 +1,156 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { SyntaxKind } from "ts-morph";
+import { addFile } from "../ast/project.js";
+import { listProjectSourceFiles } from "../ast/source-files.js";
+import { resolveDefinitions } from "../ast/resolve.js";
+import { traceSideEffects } from "../ast/side-effect-tracer.js";
+import { enumerateClassProperties } from "../ast/param-extractor.js";
+const VERB_DECORATORS = {
+    Get: "GET",
+    Post: "POST",
+    Put: "PUT",
+    Delete: "DELETE",
+    Patch: "PATCH",
+    Options: "OPTIONS",
+    Head: "HEAD",
+    All: "ALL",
+};
+// Discover NestJS controllers: classes decorated with @Controller whose methods
+// carry HTTP-verb decorators. Params come from @Body/@Param/@Query, side effects
+// from tracing the method body (including this.service.method() delegation).
+export function extractNestRoutes(projectRoot, ast) {
+    const routes = [];
+    for (const filePath of listProjectSourceFiles(projectRoot)) {
+        let content;
+        try {
+            content = fs.readFileSync(filePath, "utf-8");
+        }
+        catch {
+            continue;
+        }
+        if (!content.includes("@Controller"))
+            continue;
+        const relativePath = path.relative(projectRoot, filePath).replace(/\\/g, "/");
+        try {
+            const sourceFile = addFile(ast, filePath);
+            if (!sourceFile)
+                continue;
+            for (const cls of sourceFile.getClasses()) {
+                const controller = cls.getDecorator("Controller");
+                if (!controller)
+                    continue;
+                const basePath = stringArg(controller) ?? "";
+                const classGuarded = Boolean(cls.getDecorator("UseGuards"));
+                for (const method of cls.getMethods()) {
+                    const verb = methodVerb(method);
+                    if (!verb)
+                        continue;
+                    const subPath = stringArg(method.getDecorator(verbDecoratorName(method))) ?? "";
+                    const guarded = classGuarded || Boolean(method.getDecorator("UseGuards"));
+                    routes.push({
+                        path: joinPath(basePath, subPath),
+                        method: verb,
+                        filePath: relativePath,
+                        parameters: extractParams(method),
+                        auth: guarded ? "nest-guard" : null,
+                        sideEffects: safeTrace(method.getBody()),
+                    });
+                }
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    return routes;
+}
+function methodVerb(method) {
+    const m = method.asKind(SyntaxKind.MethodDeclaration);
+    if (!m)
+        return null;
+    for (const dec of m.getDecorators()) {
+        const verb = VERB_DECORATORS[dec.getName()];
+        if (verb)
+            return verb;
+    }
+    return null;
+}
+function verbDecoratorName(method) {
+    const m = method.asKind(SyntaxKind.MethodDeclaration);
+    if (!m)
+        return null;
+    for (const dec of m.getDecorators()) {
+        if (VERB_DECORATORS[dec.getName()])
+            return dec.getName();
+    }
+    return null;
+}
+function extractParams(method) {
+    const m = method.asKind(SyntaxKind.MethodDeclaration);
+    if (!m)
+        return [];
+    const params = [];
+    for (const param of m.getParameters()) {
+        const body = param.getDecorator("Body");
+        if (body) {
+            const key = stringArg(body);
+            if (key) {
+                params.push({ name: key, type: paramType(param), required: !param.hasQuestionToken() });
+            }
+            else {
+                params.push(...dtoParams(param));
+            }
+            continue;
+        }
+        for (const decoratorName of ["Param", "Query"]) {
+            const dec = param.getDecorator(decoratorName);
+            if (!dec)
+                continue;
+            const name = stringArg(dec) ?? param.getName();
+            params.push({ name, type: paramType(param), required: !param.hasQuestionToken() });
+            break;
+        }
+    }
+    return params;
+}
+// `@Body() dto: CreateUserDto` → expand the DTO's declared properties.
+function dtoParams(param) {
+    const p = param.asKind(SyntaxKind.Parameter);
+    const typeNode = p?.getTypeNode();
+    const ref = typeNode?.asKind(SyntaxKind.TypeReference);
+    const nameNode = ref?.getTypeName().asKind(SyntaxKind.Identifier);
+    if (!nameNode)
+        return [];
+    for (const def of resolveDefinitions(nameNode)) {
+        const props = enumerateClassProperties(def);
+        if (props.length > 0)
+            return props;
+    }
+    return [];
+}
+function paramType(param) {
+    const p = param.asKind(SyntaxKind.Parameter);
+    const typeNode = p?.getTypeNode();
+    return typeNode ? typeNode.getText() : "unknown";
+}
+// The first string-literal argument of a decorator, if any.
+function stringArg(decorator) {
+    const args = decorator?.asKind(SyntaxKind.Decorator)?.getArguments() ?? [];
+    const arg = args[0];
+    const str = arg?.asKind(SyntaxKind.StringLiteral);
+    return str ? str.getLiteralText() : undefined;
+}
+function joinPath(base, sub) {
+    const segments = `${base}/${sub}`.split("/").filter(Boolean);
+    return `/${segments.join("/")}`;
+}
+function safeTrace(body) {
+    try {
+        return traceSideEffects(body, "route");
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=nestjs-extractor.js.map

package/dist/discovery/extractors/nestjs-extractor.js.map

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

package/dist/discovery/extractors/remix-extractor.d.ts

@@ -0,0 +1,5 @@
+import type { RouteCapability } from "../types.js";
+import type { AstContext } from "../ast/project.js";
+export declare function extractRemixRoutes(projectRoot: string, ast: AstContext): RouteCapability[];
+export declare function remixFilePathToUrl(relPath: string): string;
+//# sourceMappingURL=remix-extractor.d.ts.map

package/dist/discovery/extractors/remix-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remix-extractor.d.ts","sourceRoot":"","sources":["../../../src/discovery/extractors/remix-extractor.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAgB,MAAM,aAAa,CAAC;AACjE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAWpD,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,UAAU,GAAG,eAAe,EAAE,CA2C1F;AAKD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CA8B1D"}

package/dist/discovery/extractors/remix-extractor.js

@@ -0,0 +1,118 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { addFile } from "../ast/project.js";
+import { listSourceFilesUnder } from "../ast/source-files.js";
+import { findNamedExports } from "../ast/named-export-finder.js";
+import { traceSideEffects } from "../ast/side-effect-tracer.js";
+import { extractRouteParams } from "../ast/param-extractor.js";
+const AUTH_HINT = /authenticator|requireUser|requireAuth|getSession|isAuthenticated/;
+// Discover Remix routes: `loader` (read) and `action` (mutation) exports in
+// app/routes/**. Paths follow the v2 flat-route convention.
+export function extractRemixRoutes(projectRoot, ast) {
+    const routesDir = [
+        path.join(projectRoot, "app", "routes"),
+        path.join(projectRoot, "src", "app", "routes"),
+    ].find((d) => fs.existsSync(d));
+    if (!routesDir)
+        return [];
+    const routes = [];
+    for (const filePath of listSourceFilesUnder(routesDir)) {
+        let content;
+        try {
+            content = fs.readFileSync(filePath, "utf-8");
+        }
+        catch {
+            continue;
+        }
+        if (!/\b(loader|action)\b/.test(content))
+            continue;
+        const relFromRoutes = path.relative(routesDir, filePath).replace(/\\/g, "/");
+        const urlPath = remixFilePathToUrl(relFromRoutes);
+        const relativePath = path.relative(projectRoot, filePath).replace(/\\/g, "/");
+        const auth = AUTH_HINT.test(content) ? "remix-auth" : null;
+        try {
+            const sourceFile = addFile(ast, filePath);
+            if (!sourceFile)
+                continue;
+            for (const ex of findNamedExports(sourceFile, ["loader", "action"])) {
+                routes.push({
+                    path: urlPath,
+                    method: ex.name, // "loader" | "action"
+                    filePath: relativePath,
+                    parameters: mergeParams(pathParams(urlPath), safeParams(ex.body)),
+                    auth,
+                    sideEffects: safeTrace(ex.body),
+                });
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    return routes;
+}
+// Remix v2 flat-route file id → URL path. Handles dot-segments, folder routes,
+// dynamic ($id), splat ($), optional (($lang)), index (_index) and pathless
+// layout (leading _) segments.
+export function remixFilePathToUrl(relPath) {
+    let id = relPath.replace(/\.(tsx?|jsx?)$/, "");
+    id = id.replace(/\/(route|index)$/, ""); // folder route → folder id
+    id = id.replace(/\//g, "."); // unify nested folders into dot-segments
+    const segments = [];
+    for (let seg of id.split(".")) {
+        if (!seg)
+            continue;
+        if (seg === "_index")
+            continue; // index route
+        if (seg.startsWith("_"))
+            continue; // pathless layout
+        seg = seg.replace(/_$/, ""); // trailing _ opts out of nesting
+        if (seg === "$") {
+            segments.push("*");
+            continue;
+        }
+        const optional = seg.match(/^\((.+)\)$/);
+        if (optional) {
+            const inner = optional[1];
+            segments.push(inner.startsWith("$") ? `:${inner.slice(1)}?` : `${inner}?`);
+            continue;
+        }
+        if (seg.startsWith("$")) {
+            segments.push(`:${seg.slice(1)}`);
+            continue;
+        }
+        segments.push(seg);
+    }
+    return "/" + segments.join("/");
+}
+function pathParams(urlPath) {
+    const params = [];
+    for (const seg of urlPath.split("/")) {
+        if (seg.startsWith(":"))
+            params.push({ name: seg.slice(1).replace(/\?$/, ""), type: "string", required: !seg.endsWith("?") });
+        else if (seg.startsWith("*"))
+            params.push({ name: seg.slice(1) || "splat", type: "string", required: false });
+    }
+    return params;
+}
+function mergeParams(a, b) {
+    const seen = new Set(a.map((p) => p.name));
+    return [...a, ...b.filter((p) => !seen.has(p.name))];
+}
+function safeParams(body) {
+    try {
+        return extractRouteParams(body);
+    }
+    catch {
+        return [];
+    }
+}
+function safeTrace(body) {
+    try {
+        return traceSideEffects(body, "route");
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=remix-extractor.js.map

package/dist/discovery/extractors/remix-extractor.js.map

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

package/dist/discovery/extractors/route-extractor.d.ts

@@ -0,0 +1,4 @@
+import type { RouteCapability } from "../types.js";
+import type { AstContext } from "../ast/project.js";
+export declare function extractRoutes(projectRoot: string, ast?: AstContext): Promise<RouteCapability[]>;
+//# sourceMappingURL=route-extractor.d.ts.map

package/dist/discovery/extractors/route-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-extractor.d.ts","sourceRoot":"","sources":["../../../src/discovery/extractors/route-extractor.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAkBpD,wBAAsB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CA+CrG"}