@flaid/devmap 0.2.0

package/dist/analyzers/analysis/extractors/index.js

@@ -0,0 +1,135 @@
+import { PrismaExtractor } from "./prismaExtractor.js";
+import { SQLExtractor } from "./sqlExtractor.js";
+import { RouteFallbackExtractor } from "./fallbackExtractor.js";
+// ---------------------------------------------------------------------------
+// Extractor registry
+// ---------------------------------------------------------------------------
+/**
+ * EXTRACTORS — ordered fallback chain, diiterasi dari atas ke bawah.
+ *
+ * Tambah source baru = append extractor baru ke sini, tanpa ubah logic apapun.
+ * Orchestrator stop di extractor pertama yang canHandle() = true DAN extract() non-empty.
+ *
+ * Order penting: lebih reliable = lebih atas.
+ *   1. Prisma    — high confidence, full field + relation data
+ *   2. [future] Drizzle  → import { DrizzleExtractor } from "./drizzleExtractor.js"
+ *   3. [future] TypeORM  → import { TypeORMExtractor } from "./typeormExtractor.js"
+ *   4. [future] Mongoose → import { MongooseExtractor } from "./mongooseExtractor.js"
+ *   5. SQL       — raw pg/mysql2/better-sqlite3, table names as pseudo-entities
+ *                  (no field/relation data — lowest confidence of the schema sources,
+ *                  stays last so any ORM extractor above gets first refusal)
+ */
+const EXTRACTORS = [
+    new PrismaExtractor(),
+    // new DrizzleExtractor(),
+    // new TypeORMExtractor(),
+    // new MongooseExtractor(),
+    new SQLExtractor(),
+];
+const ROUTE_FALLBACK = new RouteFallbackExtractor();
+// ---------------------------------------------------------------------------
+// Main entry
+// ---------------------------------------------------------------------------
+/**
+ * extractEntities — scan files dan build entity graph.
+ *
+ * Fallback chain:
+ *   1. Iterate EXTRACTORS — stop di hasil pertama yang non-empty
+ *   2. Kalau semua kosong dan ada routes → route-hint fallback
+ *   3. Kalau routes juga kosong → return empty graph
+ *
+ * Relation graph di-build dari entity fields setelah semua entities terkumpul.
+ * Dedup entity dilakukan di sini (bukan di extractor) untuk handle Prisma multi-file schema.
+ */
+export function extractEntities(files, routes = []) {
+    // --- Schema-based sources ---
+    for (const extractor of EXTRACTORS) {
+        if (!extractor.canHandle(files))
+            continue;
+        const raw = extractor.extract(files);
+        if (raw.length === 0)
+            continue;
+        const entities = deduplicateEntities(raw);
+        const relations = buildRelationGraph(entities);
+        return {
+            entities,
+            relations,
+            entityNames: entities.map((e) => e.name),
+            source: extractor.name,
+        };
+    }
+    // --- Route fallback: aktif kalau semua schema source kosong ---
+    if (routes.length > 0) {
+        const entities = ROUTE_FALLBACK.extract(routes);
+        if (entities.length > 0) {
+            return {
+                entities,
+                relations: [],
+                entityNames: entities.map((e) => e.name),
+                source: "route-hint",
+            };
+        }
+    }
+    return { entities: [], relations: [], entityNames: [], source: "empty" };
+}
+// ---------------------------------------------------------------------------
+// Relation graph builder
+// ---------------------------------------------------------------------------
+/**
+ * buildRelationGraph — derive semua relasi dari field isRelation = true.
+ *
+ * Rules:
+ *   A.b  B[]   = one-to-many (A has many B)
+ *   A.b  B     = one-to-one
+ *   A.b  B[] + B.a A[] = many-to-many
+ *
+ * Duplicate guard: many-to-many A↔B hanya disimpan sekali.
+ */
+function buildRelationGraph(entities) {
+    const relations = [];
+    const entitySet = new Set(entities.map((e) => e.name));
+    for (const entity of entities) {
+        for (const field of entity.fields) {
+            if (!field.isRelation || !entitySet.has(field.type))
+                continue;
+            const target = entities.find((e) => e.name === field.type);
+            const hasListBack = target?.fields.some((f) => f.type === entity.name && f.isList) ?? false;
+            let kind;
+            if (field.isList && hasListBack) {
+                kind = "many-to-many";
+            }
+            else if (field.isList) {
+                kind = "one-to-many";
+            }
+            else {
+                kind = "one-to-one";
+            }
+            // Skip duplicate many-to-many (B→A sudah masuk waktu proses A→B)
+            const isDuplicate = relations.some((r) => r.kind === "many-to-many" &&
+                ((r.from === entity.name && r.to === field.type) ||
+                    (r.from === field.type && r.to === entity.name)));
+            if (!isDuplicate) {
+                relations.push({ from: entity.name, to: field.type, kind });
+            }
+        }
+    }
+    return relations;
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * deduplicateEntities — filter duplicate entity names.
+ * Penting buat Prisma multi-file schema dimana model bisa didefinisi di file terpisah.
+ * First-seen wins.
+ */
+function deduplicateEntities(entities) {
+    const seen = new Set();
+    return entities.filter((e) => {
+        if (seen.has(e.name))
+            return false;
+        seen.add(e.name);
+        return true;
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/analyzers/analysis/extractors/index.js.map

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

package/dist/analyzers/analysis/extractors/prismaExtractor.d.ts

@@ -0,0 +1,15 @@
+import type { ScannedFile } from "../index.js";
+import type { EntityInfo, IEntityExtractor } from "./types.js";
+/**
+ * PrismaExtractor — parse satu atau lebih .prisma files jadi list EntityInfo.
+ *
+ * Prisma supports multi-file schema via `prisma/` folder (Prisma 5+), jadi
+ * extract() iterate semua .prisma files dan merge hasilnya.
+ * Dedup dilakukan di orchestrator, bukan di sini.
+ */
+export declare class PrismaExtractor implements IEntityExtractor {
+    readonly name = "prisma";
+    canHandle(files: ScannedFile[]): boolean;
+    extract(files: ScannedFile[]): EntityInfo[];
+}
+//# sourceMappingURL=prismaExtractor.d.ts.map

package/dist/analyzers/analysis/extractors/prismaExtractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prismaExtractor.d.ts","sourceRoot":"","sources":["../../../../src/analyzers/analysis/extractors/prismaExtractor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAA2B,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAqBxF;;;;;;GAMG;AACH,qBAAa,eAAgB,YAAW,gBAAgB;IACtD,QAAQ,CAAC,IAAI,YAAY;IAEzB,SAAS,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,OAAO;IAIxC,OAAO,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,UAAU,EAAE;CAa5C"}

package/dist/analyzers/analysis/extractors/prismaExtractor.js

@@ -0,0 +1,183 @@
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/**
+ * Tipe scalar bawaan Prisma — kalau field typenya ini, bukan relasi ke entity lain.
+ * https://www.prisma.io/docs/orm/reference/prisma-schema-reference#model-field-scalar-types
+ */
+const PRISMA_SCALAR_TYPES = new Set([
+    "String", "Boolean", "Int", "BigInt", "Float",
+    "Decimal", "DateTime", "Json", "Bytes",
+    // Prisma-specific (MongoDB)
+    "ObjectId",
+]);
+// ---------------------------------------------------------------------------
+// Extractor
+// ---------------------------------------------------------------------------
+/**
+ * PrismaExtractor — parse satu atau lebih .prisma files jadi list EntityInfo.
+ *
+ * Prisma supports multi-file schema via `prisma/` folder (Prisma 5+), jadi
+ * extract() iterate semua .prisma files dan merge hasilnya.
+ * Dedup dilakukan di orchestrator, bukan di sini.
+ */
+export class PrismaExtractor {
+    name = "prisma";
+    canHandle(files) {
+        return files.some((f) => f.path.endsWith(".prisma"));
+    }
+    extract(files) {
+        const allEntities = [];
+        for (const file of files) {
+            if (!file.path.endsWith(".prisma"))
+                continue;
+            allEntities.push(...parsePrismaSchema(file.content));
+        }
+        // Build relations after all entities are parsed.
+        // We need the full entity name set to distinguish relations from scalars
+        // and to determine relation direction (one-to-many vs many-to-one).
+        return buildRelations(allEntities);
+    }
+}
+// ---------------------------------------------------------------------------
+// Parser internals
+// ---------------------------------------------------------------------------
+/**
+ * parsePrismaSchema — parse schema.prisma content jadi list EntityInfo.
+ *
+ * Prisma model syntax:
+ *   model User {
+ *     id        String     @id @default(cuid())
+ *     email     String     @unique
+ *     rooms     Room[]              ← relation one-to-many (User owns Rooms)
+ *     workspace Workspace?          ← relation one-to-one optional
+ *     userId    String              ← FK scalar, bukan relasi langsung
+ *   }
+ */
+function parsePrismaSchema(content) {
+    const entities = [];
+    // Match tiap model block — non-greedy biar gak overlap antar model
+    const modelPattern = /^model\s+(\w+)\s*\{([\s\S]*?)\n\}/gm;
+    let match = modelPattern.exec(content);
+    while (match) {
+        const name = match[1];
+        const body = match[2];
+        const fields = parsePrismaFields(body);
+        // relations di-populate di buildRelations() setelah semua entity ter-parse
+        entities.push({ name, fields, relations: [], source: "prisma" });
+        match = modelPattern.exec(content);
+    }
+    return entities;
+}
+/**
+ * parsePrismaFields — extract field list dari body satu model block.
+ *
+ * Skip:
+ * - Baris kosong
+ * - Comment (//)
+ * - Block attributes (@@index, @@unique, @@map)
+ * - Inline attributes (@id, @default, dll) yang somehow lolos
+ */
+function parsePrismaFields(body) {
+    const fields = [];
+    // fieldName  FieldType[]?  @attributes...
+    // Capture: (1) fieldName, (2) fieldType, (3) [], (4) ?
+    const fieldPattern = /^\s+(\w+)\s+(\w+)(\[\])?(\?)?/gm;
+    let match = fieldPattern.exec(body);
+    while (match) {
+        const fieldName = match[1];
+        const fieldType = match[2];
+        const isList = Boolean(match[3]);
+        const isOptional = Boolean(match[4]);
+        // Skip attribute lines yang lolos regex
+        if (fieldName.startsWith("@")) {
+            match = fieldPattern.exec(body);
+            continue;
+        }
+        // Tipe kapital + bukan scalar Prisma = relasi ke entity lain
+        const isRelation = isCapitalized(fieldType) && !PRISMA_SCALAR_TYPES.has(fieldType);
+        fields.push({ name: fieldName, type: fieldType, isRelation, isList, isOptional });
+        match = fieldPattern.exec(body);
+    }
+    return fields;
+}
+// ---------------------------------------------------------------------------
+// Relation builder
+//
+// Prisma relasi selalu bidirectional — kedua sisi model punya field relasi.
+// Kita derive arah relasi dari field type modifier:
+//
+//   User { rooms Room[] }   → User has many Room  → one-to-many (User → Room)
+//   Room { user User }      → Room belongs to User → many-to-one (Room → User)
+//   User { profile Profile? } → one-to-one optional
+//
+// Strategy: iterate tiap entity, cari field yang isRelation.
+//   - Field isList (Type[])  → from: thisEntity, to: fieldType, kind: one-to-many
+//   - Field !isList + optional → from: thisEntity, to: fieldType, kind: one-to-one
+//   - Field !isList + required → many-to-one (FK holder) — kita skip ini karena
+//     sisi lain (the "one") sudah generate one-to-many dari perspektifnya.
+//
+// Dedup: pakai Set string key biar relasi yang sama dari kedua sisi tidak double.
+//
+// Self-referential relations (Message → Message via sourceMessage/reminders):
+//   Field bertipe sama dengan entity sendiri → skip, ini bukan cross-entity relation.
+// ---------------------------------------------------------------------------
+function buildRelations(entities) {
+    const entityNames = new Set(entities.map((e) => e.name));
+    const seenRelations = new Set();
+    const allRelations = [];
+    for (const entity of entities) {
+        for (const field of entity.fields) {
+            if (!field.isRelation)
+                continue;
+            if (!entityNames.has(field.type))
+                continue;
+            // Skip self-referential — e.g. Message.sourceMessage: Message?
+            // These are valid Prisma patterns but not cross-entity ownership relations
+            if (field.type === entity.name)
+                continue;
+            if (field.isList) {
+                // Type[] → one-to-many: this entity owns many of field.type
+                // e.g. User.rooms Room[] → User → Room (one-to-many)
+                const key = `${entity.name}→${field.type}:one-to-many`;
+                if (!seenRelations.has(key)) {
+                    seenRelations.add(key);
+                    allRelations.push({ from: entity.name, to: field.type, kind: "one-to-many" });
+                }
+            }
+            else {
+                // Type or Type? (non-list) → this entity holds the FK (many-to-one side)
+                // We skip many-to-one here — the one-to-many from the parent already covers it.
+                // Exception: if there is NO corresponding list field on the other side,
+                // this might be a one-to-one — add it as such.
+                const otherEntity = entities.find((e) => e.name === field.type);
+                if (!otherEntity)
+                    continue;
+                const otherSideHasList = otherEntity.fields.some((f) => f.isRelation && f.type === entity.name && f.isList);
+                if (!otherSideHasList) {
+                    // No list on the other side → one-to-one
+                    // Use alphabetical order to deduplicate bidirectional one-to-one fields
+                    const [a, b] = [entity.name, field.type].sort();
+                    const key = `${a}↔${b}:one-to-one`;
+                    if (!seenRelations.has(key)) {
+                        seenRelations.add(key);
+                        allRelations.push({ from: entity.name, to: field.type, kind: "one-to-one" });
+                    }
+                }
+                // If other side has list → many-to-one, already handled from the list side → skip
+            }
+        }
+    }
+    // Attach relations back to each entity
+    return entities.map((entity) => ({
+        ...entity,
+        relations: allRelations.filter((r) => r.from === entity.name || r.to === entity.name),
+    }));
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function isCapitalized(str) {
+    return str.length > 0 && str[0] === str[0].toUpperCase() && str[0] !== str[0].toLowerCase();
+}
+//# sourceMappingURL=prismaExtractor.js.map

package/dist/analyzers/analysis/extractors/prismaExtractor.js.map

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

package/dist/analyzers/analysis/extractors/sqlExtractor.d.ts

@@ -0,0 +1,14 @@
+import type { ScannedFile } from "../index.js";
+import type { EntityInfo, IEntityExtractor } from "./types.js";
+/**
+ * SQLExtractor — the "[future] SQL" slot already reserved in
+ * extractors/index.ts. Produces pseudo-entities (name only, no fields or
+ * relations — raw SQL has no schema metadata to read the way Prisma does)
+ * from table names referenced in query strings, for projects with no ORM.
+ */
+export declare class SQLExtractor implements IEntityExtractor {
+    readonly name = "sql";
+    canHandle(files: ScannedFile[]): boolean;
+    extract(files: ScannedFile[]): EntityInfo[];
+}
+//# sourceMappingURL=sqlExtractor.d.ts.map

package/dist/analyzers/analysis/extractors/sqlExtractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlExtractor.d.ts","sourceRoot":"","sources":["../../../../src/analyzers/analysis/extractors/sqlExtractor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAuI/D;;;;;GAKG;AACH,qBAAa,YAAa,YAAW,gBAAgB;IACnD,QAAQ,CAAC,IAAI,SAAS;IAEtB,SAAS,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,OAAO;IAIxC,OAAO,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,UAAU,EAAE;CA4B5C"}

package/dist/analyzers/analysis/extractors/sqlExtractor.js

@@ -0,0 +1,163 @@
+import { Project, ScriptTarget, SyntaxKind } from "ts-morph";
+import { singularize } from "./fallbackExtractor.js";
+import { isArchitectureSource } from "../../graph/index.js";
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/**
+ * Raw SQL client packages. Deliberately narrow — these are the drivers
+ * actually used without an ORM layer on top. Drivers that only ever show up
+ * *underneath* an ORM (e.g. `pg` used by Drizzle) don't matter here: if an
+ * ORM extractor higher in the EXTRACTORS chain already found entities, this
+ * one never runs at all (orchestrator stops at first non-empty result).
+ */
+const RAW_SQL_IMPORTS = new Set([
+    "pg", "pg-promise",
+    "mysql2", "mysql2/promise", "mysql",
+    "better-sqlite3", "sqlite3", "node:sqlite",
+]);
+/**
+ * Table-like names that show up in real query strings but aren't domain
+ * entities — internal Postgres/SQLite catalogs and migration bookkeeping.
+ */
+const NON_ENTITY_TABLE_NAMES = new Set([
+    "information_schema", "pg_catalog", "pg_stat_activity",
+    "sqlite_master", "sqlite_sequence", "sqlite_temp_master",
+    "migrations", "schema_migrations", "knex_migrations", "_prisma_migrations",
+]);
+/**
+ * Common English function words that land right after from/into/update/join
+ * in ordinary UI copy — "Update your profile", "select a file from your
+ * computer" — but are never real table names. Without this, any project with
+ * a raw SQL client anywhere and normal SaaS/checkout copy elsewhere (confirm
+ * dialogs, toasts, form hints) produces bogus pseudo-entities like "Your".
+ */
+const ENGLISH_STOPWORDS = new Set([
+    "a", "an", "the", "this", "that", "these", "those",
+    "your", "my", "our", "their", "his", "her", "its",
+    "all", "any", "some", "each", "us", "you", "me", "them",
+]);
+/**
+ * Matches `from "pg"`, `require("mysql2")`, `require('better-sqlite3')`, etc.
+ * Content-based rather than relying on parsed imports, since IEntityExtractor
+ * only receives raw ScannedFile[] — same approach as the AI Integration
+ * content fallback in featureDetector.ts.
+ */
+function usesRawSqlClient(content) {
+    return [...RAW_SQL_IMPORTS].some((pkg) => {
+        const escaped = pkg.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+        return new RegExp(`from\\s+["']${escaped}["']|require\\(\\s*["']${escaped}["']\\s*\\)`, "i").test(content);
+    });
+}
+/**
+ * Pull table names out of query strings via the SQL keywords that precede a
+ * table name in the vast majority of real queries. This is intentionally not
+ * a SQL parser — just enough to turn `SELECT * FROM users` into a "users"
+ * pseudo-entity.
+ *
+ * String *boundaries* come from a real AST (ts-morph — already a dependency,
+ * already used the same way in tsMorphAnalyzer.ts), not from regex-pairing
+ * quote characters. A naive `"([^"]*)"` scan pairs the Nth quote with the
+ * (N+1)th regardless of which statement they actually belong to, so a single
+ * apostrophe in a comment ("doesn't", "it's") throws off parity for
+ * everything after it — silently merging JSDoc prose and unrelated code into
+ * one fake "string" that gets scanned for SQL-shaped phrases. AST nodes don't
+ * have that failure mode: a StringLiteral node is exactly the source text
+ * between one real quote pair, comments and JSX text are different node
+ * kinds entirely, so this can't happen.
+ */
+const SQL_STATEMENT_PATTERN = /\b(?:select|insert|update|delete|with)\b/i;
+const TABLE_NAME_PATTERN = /\b(?:from|into|update|join)\s+["'`]?([a-zA-Z_][a-zA-Z0-9_]*)["'`]?/gi;
+// Real table identifiers are lowercase/snake_case (`users`, `order_items`) or,
+// rarely, SCREAMING_CASE. A captured word that starts with a capital letter
+// followed by a lowercase letter (`DevMap`, `Stripe`, `Your`) reads as a
+// proper noun or a sentence's first word, not a table — the residual gap
+// after the stopword list, which can only ever cover words we thought to
+// list, not arbitrary product/brand names in CLI help text or UI copy.
+const TITLE_CASE_PATTERN = /^[A-Z][a-z]/;
+const SQL_SOURCE_EXTENSIONS = new Set([".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs"]);
+const literalProject = new Project({
+    useInMemoryFileSystem: true,
+    skipAddingFilesFromTsConfig: true,
+    compilerOptions: { allowJs: true, target: ScriptTarget.ES2022 }
+});
+function stringLiteralsIn(content) {
+    const literals = [];
+    try {
+        const sourceFile = literalProject.createSourceFile("__sql-scan.tsx", content, { overwrite: true });
+        for (const node of sourceFile.getDescendantsOfKind(SyntaxKind.StringLiteral)) {
+            literals.push(node.getLiteralText());
+        }
+        for (const node of sourceFile.getDescendantsOfKind(SyntaxKind.NoSubstitutionTemplateLiteral)) {
+            literals.push(node.getLiteralText());
+        }
+        literalProject.removeSourceFile(sourceFile);
+    }
+    catch {
+        // Best-effort: a file ts-morph can't parse just contributes no literals,
+        // same as a file with no SQL-shaped strings at all.
+    }
+    return literals;
+}
+function extractTableNames(file) {
+    const names = new Set();
+    if (!SQL_SOURCE_EXTENSIONS.has(file.extension))
+        return [];
+    for (const literal of stringLiteralsIn(file.content)) {
+        if (!SQL_STATEMENT_PATTERN.test(literal))
+            continue;
+        TABLE_NAME_PATTERN.lastIndex = 0;
+        let tableMatch = TABLE_NAME_PATTERN.exec(literal);
+        while (tableMatch) {
+            const raw = tableMatch[1];
+            const table = raw.toLowerCase();
+            if (!NON_ENTITY_TABLE_NAMES.has(table) && !ENGLISH_STOPWORDS.has(table) && !TITLE_CASE_PATTERN.test(raw)) {
+                names.add(table);
+            }
+            tableMatch = TABLE_NAME_PATTERN.exec(literal);
+        }
+    }
+    return [...names];
+}
+// ---------------------------------------------------------------------------
+// Extractor
+// ---------------------------------------------------------------------------
+/**
+ * SQLExtractor — the "[future] SQL" slot already reserved in
+ * extractors/index.ts. Produces pseudo-entities (name only, no fields or
+ * relations — raw SQL has no schema metadata to read the way Prisma does)
+ * from table names referenced in query strings, for projects with no ORM.
+ */
+export class SQLExtractor {
+    name = "sql";
+    canHandle(files) {
+        return files.some((file) => isArchitectureSource(file.path) && usesRawSqlClient(file.content));
+    }
+    extract(files) {
+        const filesByTable = new Map();
+        const sourceFiles = files.filter((file) => isArchitectureSource(file.path));
+        for (const file of sourceFiles) {
+            for (const table of extractTableNames(file)) {
+                const fileSet = filesByTable.get(table) ?? new Set();
+                fileSet.add(file.path);
+                filesByTable.set(table, fileSet);
+            }
+        }
+        const filesByEntityName = new Map();
+        for (const [table, tableFiles] of filesByTable) {
+            const entityName = singularize(table);
+            const existing = filesByEntityName.get(entityName) ?? new Set();
+            for (const file of tableFiles)
+                existing.add(file);
+            filesByEntityName.set(entityName, existing);
+        }
+        return [...filesByEntityName.entries()].map(([name, sourceFiles]) => ({
+            name,
+            fields: [],
+            relations: [],
+            source: "sql",
+            sourceFiles: [...sourceFiles].sort()
+        }));
+    }
+}
+//# sourceMappingURL=sqlExtractor.js.map

package/dist/analyzers/analysis/extractors/sqlExtractor.js.map

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

package/dist/analyzers/analysis/extractors/types.d.ts

@@ -0,0 +1,76 @@
+import type { ScannedFile } from "../index.js";
+import type { RouteInfo } from "../../detectors/index.js";
+export type EntityInfo = {
+    name: string;
+    fields: FieldInfo[];
+    relations: RelationInfo[];
+    source: "prisma" | "sql" | "route-hint";
+    /** Files this entity was actually found in — set when the source has no
+     *  reliable filename/path convention to fall back on (e.g. a "verses"
+     *  table referenced inside src/routes/quran.ts has no file named verse.ts
+     *  for the generic name-matching fallback to find). When present, this
+     *  takes priority over that fallback. */
+    sourceFiles?: string[];
+};
+export type FieldInfo = {
+    name: string;
+    type: string;
+    isRelation: boolean;
+    isList: boolean;
+    isOptional: boolean;
+};
+export type RelationInfo = {
+    from: string;
+    to: string;
+    kind: "one-to-one" | "one-to-many" | "many-to-many";
+};
+export type EntityGraph = {
+    entities: EntityInfo[];
+    relations: RelationInfo[];
+    /** Flat list of entity names — shortcut buat featureDetector & capabilityDetector */
+    entityNames: string[];
+    /** Where entities came from — consumers dapat tau seberapa reliable data ini */
+    source: "prisma" | "sql" | "route-hint" | "empty";
+};
+/**
+ * IEntityExtractor — contract yang harus diimplementasi semua extractor.
+ *
+ * Setiap extractor bertanggung jawab atas satu source (Prisma, Drizzle, dll).
+ * Orchestrator di index.ts iterate extractor list dan stop di hasil pertama
+ * yang non-empty — ini yang bikin fallback chain bisa kerja tanpa if-else panjang.
+ */
+export interface IEntityExtractor {
+    /**
+     * Nama extractor ini — untuk logging / debug.
+     * Contoh: "prisma", "drizzle", "typeorm"
+     */
+    readonly name: string;
+    /**
+     * canHandle — quick check apakah extractor ini relevan untuk file-file ini.
+     * Dipanggil sebelum extract() untuk short-circuit extractor yang tidak applicable.
+     *
+     * Contoh:
+     *   Prisma extractor → return files.some(f => f.path.endsWith(".prisma"))
+     *   Drizzle extractor → return files.some(f => isDrizzleSchemaFile(f))
+     */
+    canHandle(files: ScannedFile[]): boolean;
+    /**
+     * extract — parse files dan return list EntityInfo.
+     * Hanya dipanggil kalau canHandle() return true.
+     *
+     * Return [] kalau parse gagal / tidak ada entity ditemukan —
+     * orchestrator akan lanjut ke extractor berikutnya.
+     */
+    extract(files: ScannedFile[]): EntityInfo[];
+}
+/**
+ * IRouteFallbackExtractor — contract khusus route-hint extractor.
+ *
+ * Dipisah dari IEntityExtractor karena input-nya berbeda (RouteInfo[] bukan ScannedFile[]).
+ * Orchestrator panggil ini hanya kalau semua IEntityExtractor return kosong.
+ */
+export interface IRouteFallbackExtractor {
+    readonly name: string;
+    extract(routes: RouteInfo[]): EntityInfo[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/analyzers/analysis/extractors/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/analyzers/analysis/extractors/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAM1D,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,MAAM,EAAE,QAAQ,GAAG,KAAK,GAAG,YAAY,CAAC;IACxC;;;;6CAIyC;IACzC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,YAAY,GAAG,aAAa,GAAG,cAAc,CAAC;CACrD,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,qFAAqF;IACrF,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,gFAAgF;IAChF,MAAM,EAAE,QAAQ,GAAG,KAAK,GAAG,YAAY,GAAG,OAAO,CAAC;CACnD,CAAC;AAMF;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;;;;;OAOG;IACH,SAAS,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC;IAEzC;;;;;;OAMG;IACH,OAAO,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,UAAU,EAAE,CAAC;CAC7C;AAED;;;;;GAKG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,UAAU,EAAE,CAAC;CAC5C"}

package/dist/analyzers/analysis/extractors/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/analyzers/analysis/extractors/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/analyzers/analysis/extractors/types.ts"],"names":[],"mappings":""}