rawsql-ts 0.11.7-beta → 0.11.9-beta

package/dist/src/reporting/models/DataFlowEdge.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DataFlowEdgeCollection = exports.DataFlowConnection = void 0;
+/**
+ * Represents a connection between nodes in the data flow
+ */
+class DataFlowConnection {
+    constructor(from, to, label) {
+        this.from = from;
+        this.to = to;
+        this.label = label;
+    }
+    getMermaidRepresentation() {
+        const arrow = this.label ? ` -->|${this.label}| ` : ' --> ';
+        return `${this.from}${arrow}${this.to}`;
+    }
+    static create(from, to, label) {
+        return new DataFlowConnection(from, to, label);
+    }
+    static createWithNullability(from, to, isNullable) {
+        const label = isNullable ? 'NULLABLE' : 'NOT NULL';
+        return new DataFlowConnection(from, to, label);
+    }
+}
+exports.DataFlowConnection = DataFlowConnection;
+/**
+ * Collection of edges with utilities for managing connections
+ */
+class DataFlowEdgeCollection {
+    constructor() {
+        this.edges = [];
+        this.connectionSet = new Set();
+    }
+    add(edge) {
+        const key = `${edge.from}->${edge.to}`;
+        if (!this.connectionSet.has(key)) {
+            this.edges.push(edge);
+            this.connectionSet.add(key);
+        }
+    }
+    addConnection(from, to, label) {
+        this.add(DataFlowConnection.create(from, to, label));
+    }
+    addJoinConnection(from, to, isNullable) {
+        this.add(DataFlowConnection.createWithNullability(from, to, isNullable));
+    }
+    hasConnection(from, to) {
+        return this.connectionSet.has(`${from}->${to}`);
+    }
+    getAll() {
+        return [...this.edges];
+    }
+    getMermaidRepresentation() {
+        return this.edges.map(edge => edge.getMermaidRepresentation()).join('\n    ');
+    }
+}
+exports.DataFlowEdgeCollection = DataFlowEdgeCollection;
+//# sourceMappingURL=DataFlowEdge.js.map

package/dist/src/reporting/models/DataFlowEdge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DataFlowEdge.js","sourceRoot":"","sources":["../../../../src/reporting/models/DataFlowEdge.ts"],"names":[],"mappings":";;;AASA;;GAEG;AACH,MAAa,kBAAkB;IAC3B,YACW,IAAY,EACZ,EAAU,EACV,KAAc;QAFd,SAAI,GAAJ,IAAI,CAAQ;QACZ,OAAE,GAAF,EAAE,CAAQ;QACV,UAAK,GAAL,KAAK,CAAS;IACtB,CAAC;IAEJ,wBAAwB;QACpB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC;QAC5D,OAAO,GAAG,IAAI,CAAC,IAAI,GAAG,KAAK,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;IAC5C,CAAC;IAED,MAAM,CAAC,MAAM,CAAC,IAAY,EAAE,EAAU,EAAE,KAAc;QAClD,OAAO,IAAI,kBAAkB,CAAC,IAAI,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;IACnD,CAAC;IAED,MAAM,CAAC,qBAAqB,CAAC,IAAY,EAAE,EAAU,EAAE,UAAmB;QACtE,MAAM,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC;QACnD,OAAO,IAAI,kBAAkB,CAAC,IAAI,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;IACnD,CAAC;CACJ;AApBD,gDAoBC;AAED;;GAEG;AACH,MAAa,sBAAsB;IAAnC;QACY,UAAK,GAAyB,EAAE,CAAC;QACjC,kBAAa,GAAG,IAAI,GAAG,EAAU,CAAC;IA6B9C,CAAC;IA3BG,GAAG,CAAC,IAAwB;QACxB,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,EAAE,CAAC;QACvC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACtB,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAChC,CAAC;IACL,CAAC;IAED,aAAa,CAAC,IAAY,EAAE,EAAU,EAAE,KAAc;QAClD,IAAI,CAAC,GAAG,CAAC,kBAAkB,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC;IACzD,CAAC;IAED,iBAAiB,CAAC,IAAY,EAAE,EAAU,EAAE,UAAmB;QAC3D,IAAI,CAAC,GAAG,CAAC,kBAAkB,CAAC,qBAAqB,CAAC,IAAI,EAAE,EAAE,EAAE,UAAU,CAAC,CAAC,CAAC;IAC7E,CAAC;IAED,aAAa,CAAC,IAAY,EAAE,EAAU;QAClC,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,IAAI,KAAK,EAAE,EAAE,CAAC,CAAC;IACpD,CAAC;IAED,MAAM;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;IAED,wBAAwB;QACpB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,wBAAwB,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAClF,CAAC;CACJ;AA/BD,wDA+BC"}

package/dist/src/reporting/models/DataFlowGraph.d.ts

@@ -0,0 +1,49 @@
+import { BaseDataFlowNode, DataSourceNode, ProcessNode, OperationNode, OutputNode } from './DataFlowNode';
+import { DataFlowConnection } from './DataFlowEdge';
+/**
+ * Represents the complete data flow graph for a SQL query
+ */
+export declare class DataFlowGraph {
+    private nodes;
+    private edges;
+    addNode(node: BaseDataFlowNode): void;
+    addEdge(edge: DataFlowConnection): void;
+    addConnection(from: string, to: string, label?: string): void;
+    hasNode(nodeId: string): boolean;
+    hasConnection(from: string, to: string): boolean;
+    getNode(nodeId: string): BaseDataFlowNode | undefined;
+    getAllNodes(): BaseDataFlowNode[];
+    getAllEdges(): DataFlowConnection[];
+    /**
+     * Generates the complete Mermaid flowchart syntax
+     */
+    generateMermaid(direction?: string, title?: string): string;
+    /**
+     * Creates or gets a table node
+     */
+    getOrCreateTable(tableName: string): DataSourceNode;
+    /**
+     * Creates or gets a CTE node
+     */
+    getOrCreateCTE(cteName: string): DataSourceNode;
+    /**
+     * Creates or gets a subquery node
+     */
+    getOrCreateSubquery(alias: string): DataSourceNode;
+    /**
+     * Creates a process node
+     */
+    createProcessNode(type: string, context: string): ProcessNode;
+    /**
+     * Creates a JOIN operation node
+     */
+    createJoinNode(joinId: string, joinType: string): OperationNode;
+    /**
+     * Creates a set operation node (UNION, EXCEPT, etc.)
+     */
+    createSetOperationNode(operationId: string, operation: string): OperationNode;
+    /**
+     * Creates an output node
+     */
+    createOutputNode(context?: string): OutputNode;
+}

package/dist/src/reporting/models/DataFlowGraph.js

@@ -0,0 +1,160 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DataFlowGraph = void 0;
+const DataFlowNode_1 = require("./DataFlowNode");
+const DataFlowEdge_1 = require("./DataFlowEdge");
+/**
+ * Represents the complete data flow graph for a SQL query
+ */
+class DataFlowGraph {
+    constructor() {
+        this.nodes = new Map();
+        this.edges = new DataFlowEdge_1.DataFlowEdgeCollection();
+    }
+    addNode(node) {
+        this.nodes.set(node.id, node);
+    }
+    addEdge(edge) {
+        this.edges.add(edge);
+    }
+    addConnection(from, to, label) {
+        this.edges.addConnection(from, to, label);
+    }
+    hasNode(nodeId) {
+        return this.nodes.has(nodeId);
+    }
+    hasConnection(from, to) {
+        return this.edges.hasConnection(from, to);
+    }
+    getNode(nodeId) {
+        return this.nodes.get(nodeId);
+    }
+    getAllNodes() {
+        return Array.from(this.nodes.values());
+    }
+    getAllEdges() {
+        return this.edges.getAll();
+    }
+    /**
+     * Generates the complete Mermaid flowchart syntax
+     */
+    generateMermaid(direction = 'TD', title) {
+        let mermaid = `flowchart ${direction}\n`;
+        // Add title if provided
+        if (title) {
+            mermaid += `    %% ${title}\n`;
+        }
+        // Add nodes
+        const nodeLines = Array.from(this.nodes.values())
+            .map(node => `    ${node.getMermaidRepresentation()}`)
+            .join('\n');
+        if (nodeLines) {
+            mermaid += nodeLines + '\n';
+        }
+        // Add blank line between nodes and edges if both exist
+        if (this.nodes.size > 0 && this.edges.getAll().length > 0) {
+            mermaid += '\n';
+        }
+        // Add edges
+        const edgeRepresentation = this.edges.getMermaidRepresentation();
+        if (edgeRepresentation) {
+            mermaid += `    ${edgeRepresentation}\n`;
+        }
+        return mermaid;
+    }
+    /**
+     * Creates or gets a table node
+     */
+    getOrCreateTable(tableName) {
+        const nodeId = `table_${tableName}`;
+        let node = this.nodes.get(nodeId);
+        if (!node) {
+            node = DataFlowNode_1.DataSourceNode.createTable(tableName);
+            this.addNode(node);
+        }
+        return node;
+    }
+    /**
+     * Creates or gets a CTE node
+     */
+    getOrCreateCTE(cteName) {
+        const nodeId = `cte_${cteName}`;
+        let node = this.nodes.get(nodeId);
+        if (!node) {
+            node = DataFlowNode_1.DataSourceNode.createCTE(cteName);
+            this.addNode(node);
+        }
+        return node;
+    }
+    /**
+     * Creates or gets a subquery node
+     */
+    getOrCreateSubquery(alias) {
+        const nodeId = `subquery_${alias}`;
+        let node = this.nodes.get(nodeId);
+        if (!node) {
+            node = DataFlowNode_1.DataSourceNode.createSubquery(alias);
+            this.addNode(node);
+        }
+        return node;
+    }
+    /**
+     * Creates a process node
+     */
+    createProcessNode(type, context) {
+        let node;
+        switch (type.toLowerCase()) {
+            case 'where':
+                node = DataFlowNode_1.ProcessNode.createWhere(context);
+                break;
+            case 'group by':
+                node = DataFlowNode_1.ProcessNode.createGroupBy(context);
+                break;
+            case 'having':
+                node = DataFlowNode_1.ProcessNode.createHaving(context);
+                break;
+            case 'select':
+                node = DataFlowNode_1.ProcessNode.createSelect(context);
+                break;
+            case 'order by':
+                node = DataFlowNode_1.ProcessNode.createOrderBy(context);
+                break;
+            case 'limit':
+                node = DataFlowNode_1.ProcessNode.createLimit(context, false);
+                break;
+            case 'limit/offset':
+                node = DataFlowNode_1.ProcessNode.createLimit(context, true);
+                break;
+            default:
+                node = new DataFlowNode_1.ProcessNode(context, type);
+        }
+        this.addNode(node);
+        return node;
+    }
+    /**
+     * Creates a JOIN operation node
+     */
+    createJoinNode(joinId, joinType) {
+        const node = DataFlowNode_1.OperationNode.createJoin(joinId, joinType);
+        this.addNode(node);
+        return node;
+    }
+    /**
+     * Creates a set operation node (UNION, EXCEPT, etc.)
+     */
+    createSetOperationNode(operationId, operation) {
+        const node = DataFlowNode_1.OperationNode.createSetOperation(operationId, operation);
+        this.addNode(node);
+        return node;
+    }
+    /**
+     * Creates an output node
+     */
+    createOutputNode(context = 'main') {
+        const node = new DataFlowNode_1.OutputNode(context);
+        this.addNode(node);
+        return node;
+    }
+}
+exports.DataFlowGraph = DataFlowGraph;
+//# sourceMappingURL=DataFlowGraph.js.map

package/dist/src/reporting/models/DataFlowGraph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DataFlowGraph.js","sourceRoot":"","sources":["../../../../src/reporting/models/DataFlowGraph.ts"],"names":[],"mappings":";;;AAAA,iDAA0G;AAC1G,iDAA4E;AAE5E;;GAEG;AACH,MAAa,aAAa;IAA1B;QACY,UAAK,GAAG,IAAI,GAAG,EAA4B,CAAC;QAC5C,UAAK,GAAG,IAAI,qCAAsB,EAAE,CAAC;IA+KjD,CAAC;IA7KG,OAAO,CAAC,IAAsB;QAC1B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,OAAO,CAAC,IAAwB;QAC5B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IAED,aAAa,CAAC,IAAY,EAAE,EAAU,EAAE,KAAc;QAClD,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;IAC9C,CAAC;IAED,OAAO,CAAC,MAAc;QAClB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC;IAED,aAAa,CAAC,IAAY,EAAE,EAAU;QAClC,OAAO,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAC9C,CAAC;IAED,OAAO,CAAC,MAAc;QAClB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC;IAED,WAAW;QACP,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,WAAW;QACP,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,YAAoB,IAAI,EAAE,KAAc;QACpD,IAAI,OAAO,GAAG,aAAa,SAAS,IAAI,CAAC;QAEzC,wBAAwB;QACxB,IAAI,KAAK,EAAE,CAAC;YACR,OAAO,IAAI,UAAU,KAAK,IAAI,CAAC;QACnC,CAAC;QAED,YAAY;QACZ,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;aAC5C,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,IAAI,CAAC,wBAAwB,EAAE,EAAE,CAAC;aACrD,IAAI,CAAC,IAAI,CAAC,CAAC;QAEhB,IAAI,SAAS,EAAE,CAAC;YACZ,OAAO,IAAI,SAAS,GAAG,IAAI,CAAC;QAChC,CAAC;QAED,uDAAuD;QACvD,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxD,OAAO,IAAI,IAAI,CAAC;QACpB,CAAC;QAED,YAAY;QACZ,MAAM,kBAAkB,GAAG,IAAI,CAAC,KAAK,CAAC,wBAAwB,EAAE,CAAC;QACjE,IAAI,kBAAkB,EAAE,CAAC;YACrB,OAAO,IAAI,OAAO,kBAAkB,IAAI,CAAC;QAC7C,CAAC;QAED,OAAO,OAAO,CAAC;IACnB,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,SAAiB;QAC9B,MAAM,MAAM,GAAG,SAAS,SAAS,EAAE,CAAC;QACpC,IAAI,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAmB,CAAC;QAEpD,IAAI,CAAC,IAAI,EAAE,CAAC;YACR,IAAI,GAAG,6BAAc,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;YAC7C,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACvB,CAAC;QAED,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,OAAe;QAC1B,MAAM,MAAM,GAAG,OAAO,OAAO,EAAE,CAAC;QAChC,IAAI,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAmB,CAAC;QAEpD,IAAI,CAAC,IAAI,EAAE,CAAC;YACR,IAAI,GAAG,6BAAc,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;YACzC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACvB,CAAC;QAED,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,mBAAmB,CAAC,KAAa;QAC7B,MAAM,MAAM,GAAG,YAAY,KAAK,EAAE,CAAC;QACnC,IAAI,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAmB,CAAC;QAEpD,IAAI,CAAC,IAAI,EAAE,CAAC;YACR,IAAI,GAAG,6BAAc,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;YAC5C,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACvB,CAAC;QAED,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,iBAAiB,CAAC,IAAY,EAAE,OAAe;QAC3C,IAAI,IAAiB,CAAC;QAEtB,QAAQ,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACzB,KAAK,OAAO;gBACR,IAAI,GAAG,0BAAW,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;gBACxC,MAAM;YACV,KAAK,UAAU;gBACX,IAAI,GAAG,0BAAW,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;gBAC1C,MAAM;YACV,KAAK,QAAQ;gBACT,IAAI,GAAG,0BAAW,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;gBACzC,MAAM;YACV,KAAK,QAAQ;gBACT,IAAI,GAAG,0BAAW,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;gBACzC,MAAM;YACV,KAAK,UAAU;gBACX,IAAI,GAAG,0BAAW,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;gBAC1C,MAAM;YACV,KAAK,OAAO;gBACR,IAAI,GAAG,0BAAW,CAAC,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;gBAC/C,MAAM;YACV,KAAK,cAAc;gBACf,IAAI,GAAG,0BAAW,CAAC,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;gBAC9C,MAAM;YACV;gBACI,IAAI,GAAG,IAAI,0BAAW,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC9C,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACnB,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,MAAc,EAAE,QAAgB;QAC3C,MAAM,IAAI,GAAG,4BAAa,CAAC,UAAU,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QACxD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACnB,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,sBAAsB,CAAC,WAAmB,EAAE,SAAiB;QACzD,MAAM,IAAI,GAAG,4BAAa,CAAC,kBAAkB,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;QACtE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACnB,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,UAAkB,MAAM;QACrC,MAAM,IAAI,GAAG,IAAI,yBAAU,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACnB,OAAO,IAAI,CAAC;IAChB,CAAC;CACJ;AAjLD,sCAiLC"}

package/dist/src/reporting/models/DataFlowNode.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Represents a node in the SQL data flow diagram
+ */
+export interface DataFlowNode {
+    id: string;
+    label: string;
+    type: NodeType;
+    shape: NodeShape;
+    details?: string[];
+}
+export type NodeType = 'table' | 'cte' | 'subquery' | 'process' | 'operation' | 'output';
+export type NodeShape = 'cylinder' | 'hexagon' | 'diamond' | 'rounded' | 'rectangle' | 'circle';
+/**
+ * Base class for all data flow nodes
+ */
+export declare abstract class BaseDataFlowNode implements DataFlowNode {
+    id: string;
+    label: string;
+    type: NodeType;
+    shape: NodeShape;
+    details?: string[] | undefined;
+    constructor(id: string, label: string, type: NodeType, shape: NodeShape, details?: string[] | undefined);
+    abstract getMermaidRepresentation(): string;
+}
+/**
+ * Represents a data source (table, CTE, subquery)
+ */
+export declare class DataSourceNode extends BaseDataFlowNode {
+    private annotations;
+    constructor(id: string, label: string, type: 'table' | 'cte' | 'subquery');
+    addAnnotation(annotation: string): void;
+    hasAnnotation(annotation: string): boolean;
+    getMermaidRepresentation(): string;
+    static createTable(tableName: string): DataSourceNode;
+    static createCTE(cteName: string): DataSourceNode;
+    static createSubquery(alias: string): DataSourceNode;
+}
+/**
+ * Represents a processing operation (WHERE, GROUP BY, SELECT, etc.)
+ */
+export declare class ProcessNode extends BaseDataFlowNode {
+    constructor(id: string, operation: string, context?: string);
+    getMermaidRepresentation(): string;
+    static createWhere(context: string): ProcessNode;
+    static createGroupBy(context: string): ProcessNode;
+    static createHaving(context: string): ProcessNode;
+    static createSelect(context: string): ProcessNode;
+    static createOrderBy(context: string): ProcessNode;
+    static createLimit(context: string, hasOffset?: boolean): ProcessNode;
+}
+/**
+ * Represents an operation (JOIN, UNION, etc.)
+ */
+export declare class OperationNode extends BaseDataFlowNode {
+    constructor(id: string, operation: string);
+    getMermaidRepresentation(): string;
+    static createJoin(joinId: string, joinType: string): OperationNode;
+    static createUnion(unionId: string, unionType?: string): OperationNode;
+    static createSetOperation(operationId: string, operation: string): OperationNode;
+}
+/**
+ * Represents the final output
+ */
+export declare class OutputNode extends BaseDataFlowNode {
+    constructor(context?: string);
+    getMermaidRepresentation(): string;
+}

package/dist/src/reporting/models/DataFlowNode.js

@@ -0,0 +1,124 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OutputNode = exports.OperationNode = exports.ProcessNode = exports.DataSourceNode = exports.BaseDataFlowNode = void 0;
+/**
+ * Base class for all data flow nodes
+ */
+class BaseDataFlowNode {
+    constructor(id, label, type, shape, details) {
+        this.id = id;
+        this.label = label;
+        this.type = type;
+        this.shape = shape;
+        this.details = details;
+    }
+}
+exports.BaseDataFlowNode = BaseDataFlowNode;
+/**
+ * Represents a data source (table, CTE, subquery)
+ */
+class DataSourceNode extends BaseDataFlowNode {
+    constructor(id, label, type) {
+        super(id, label, type, 'cylinder');
+        this.annotations = new Set();
+    }
+    addAnnotation(annotation) {
+        this.annotations.add(annotation);
+    }
+    hasAnnotation(annotation) {
+        return this.annotations.has(annotation);
+    }
+    getMermaidRepresentation() {
+        return `${this.id}[(${this.label})]`;
+    }
+    static createTable(tableName) {
+        return new DataSourceNode(`table_${tableName}`, tableName, 'table');
+    }
+    static createCTE(cteName) {
+        return new DataSourceNode(`cte_${cteName}`, `CTE:${cteName}`, 'cte');
+    }
+    static createSubquery(alias) {
+        return new DataSourceNode(`subquery_${alias}`, `QUERY:${alias}`, 'subquery');
+    }
+}
+exports.DataSourceNode = DataSourceNode;
+/**
+ * Represents a processing operation (WHERE, GROUP BY, SELECT, etc.)
+ */
+class ProcessNode extends BaseDataFlowNode {
+    constructor(id, operation, context = '') {
+        const nodeId = context ? `${context}_${operation.toLowerCase().replace(/\s+/g, '_')}` : operation.toLowerCase().replace(/\s+/g, '_');
+        super(nodeId, operation, 'process', 'hexagon');
+    }
+    getMermaidRepresentation() {
+        return `${this.id}{{${this.label}}}`;
+    }
+    static createWhere(context) {
+        return new ProcessNode(`${context}_where`, 'WHERE', context);
+    }
+    static createGroupBy(context) {
+        return new ProcessNode(`${context}_group_by`, 'GROUP BY', context);
+    }
+    static createHaving(context) {
+        return new ProcessNode(`${context}_having`, 'HAVING', context);
+    }
+    static createSelect(context) {
+        return new ProcessNode(`${context}_select`, 'SELECT', context);
+    }
+    static createOrderBy(context) {
+        return new ProcessNode(`${context}_order_by`, 'ORDER BY', context);
+    }
+    static createLimit(context, hasOffset = false) {
+        const label = hasOffset ? 'LIMIT/OFFSET' : 'LIMIT';
+        return new ProcessNode(`${context}_limit`, label, context);
+    }
+}
+exports.ProcessNode = ProcessNode;
+/**
+ * Represents an operation (JOIN, UNION, etc.)
+ */
+class OperationNode extends BaseDataFlowNode {
+    constructor(id, operation) {
+        super(id, operation, 'operation', 'diamond');
+    }
+    getMermaidRepresentation() {
+        return `${this.id}{${this.label}}`;
+    }
+    static createJoin(joinId, joinType) {
+        let label;
+        const normalizedType = joinType.trim().toLowerCase();
+        if (normalizedType === 'join') {
+            label = 'INNER JOIN';
+        }
+        else if (normalizedType.endsWith(' join')) {
+            label = normalizedType.toUpperCase();
+        }
+        else {
+            label = normalizedType.toUpperCase() + ' JOIN';
+        }
+        return new OperationNode(`join_${joinId}`, label);
+    }
+    static createUnion(unionId, unionType = 'UNION ALL') {
+        return new OperationNode(`${unionType.toLowerCase().replace(/\s+/g, '_')}_${unionId}`, unionType.toUpperCase());
+    }
+    static createSetOperation(operationId, operation) {
+        const normalizedOp = operation.toUpperCase();
+        const id = `${normalizedOp.toLowerCase().replace(/\s+/g, '_')}_${operationId}`;
+        return new OperationNode(id, normalizedOp);
+    }
+}
+exports.OperationNode = OperationNode;
+/**
+ * Represents the final output
+ */
+class OutputNode extends BaseDataFlowNode {
+    constructor(context = 'main') {
+        const label = context === 'main' ? 'Final Result' : `${context} Result`;
+        super(`${context}_output`, label, 'output', 'rounded');
+    }
+    getMermaidRepresentation() {
+        return `${this.id}(${this.label})`;
+    }
+}
+exports.OutputNode = OutputNode;
+//# sourceMappingURL=DataFlowNode.js.map

package/dist/src/reporting/models/DataFlowNode.js.map

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

package/dist/src/reporting/services/CTEHandler.d.ts

@@ -0,0 +1,17 @@
+import { WithClause } from '../../models/Clause';
+import { DataFlowGraph } from '../models/DataFlowGraph';
+/**
+ * Handles the processing of Common Table Expressions (CTEs)
+ */
+export declare class CTEHandler {
+    private graph;
+    constructor(graph: DataFlowGraph);
+    /**
+     * Processes all CTEs in a WITH clause
+     */
+    processCTEs(withClause: WithClause, cteNames: Set<string>, queryProcessor: (query: any, context: string, cteNames: Set<string>) => string): void;
+    /**
+     * Detects if a query contains recursive references to a CTE
+     */
+    private detectRecursiveReference;
+}

package/dist/src/reporting/services/CTEHandler.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CTEHandler = void 0;
+/**
+ * Handles the processing of Common Table Expressions (CTEs)
+ */
+class CTEHandler {
+    constructor(graph) {
+        this.graph = graph;
+    }
+    /**
+     * Processes all CTEs in a WITH clause
+     */
+    processCTEs(withClause, cteNames, queryProcessor) {
+        // First pass: Create all CTE nodes and add names to tracking set
+        for (let i = 0; i < withClause.tables.length; i++) {
+            const cte = withClause.tables[i];
+            const cteName = cte.getSourceAliasName();
+            // Create virtual data source node for CTE
+            const cteNode = this.graph.getOrCreateCTE(cteName);
+            // Track CTE name (this allows recursive references)
+            cteNames.add(cteName);
+            // Check if this is a recursive CTE
+            // In WITH RECURSIVE, only the first CTE is recursive
+            const isRecursive = withClause.recursive && i === 0;
+            if (isRecursive) {
+                // Add recursive annotation to the CTE node
+                cteNode.addAnnotation('recursive');
+            }
+        }
+        // Second pass: Process CTE queries now that all names are available
+        for (let i = 0; i < withClause.tables.length; i++) {
+            const cte = withClause.tables[i];
+            const cteName = cte.getSourceAliasName();
+            const cteNode = this.graph.getOrCreateCTE(cteName);
+            // Process CTE query and connect its result to the CTE virtual data source
+            const cteResultId = queryProcessor(cte.query, `cte_${cteName}`, cteNames);
+            // Connect CTE query result to CTE virtual data source
+            if (cteResultId && !this.graph.hasConnection(cteResultId, cteNode.id)) {
+                // Add RECURSIVE label for first CTE in WITH RECURSIVE clause
+                const isRecursive = withClause.recursive && i === 0;
+                const label = isRecursive ? 'RECURSIVE' : undefined;
+                this.graph.addConnection(cteResultId, cteNode.id, label);
+            }
+        }
+    }
+    /**
+     * Detects if a query contains recursive references to a CTE
+     */
+    detectRecursiveReference(query, cteName) {
+        // Simple heuristic: check if the query string contains the CTE name
+        // In a real implementation, you'd parse the query structure
+        const queryStr = query.toString().toLowerCase();
+        return queryStr.includes(cteName.toLowerCase());
+    }
+}
+exports.CTEHandler = CTEHandler;
+//# sourceMappingURL=CTEHandler.js.map

package/dist/src/reporting/services/CTEHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CTEHandler.js","sourceRoot":"","sources":["../../../../src/reporting/services/CTEHandler.ts"],"names":[],"mappings":";;;AAIA;;GAEG;AACH,MAAa,UAAU;IACnB,YAAoB,KAAoB;QAApB,UAAK,GAAL,KAAK,CAAe;IAAG,CAAC;IAE5C;;OAEG;IACH,WAAW,CACP,UAAsB,EACtB,QAAqB,EACrB,cAA8E;QAE9E,iEAAiE;QACjE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAChD,MAAM,GAAG,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YACjC,MAAM,OAAO,GAAG,GAAG,CAAC,kBAAkB,EAAE,CAAC;YAEzC,0CAA0C;YAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;YAEnD,oDAAoD;YACpD,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAEtB,mCAAmC;YACnC,qDAAqD;YACrD,MAAM,WAAW,GAAG,UAAU,CAAC,SAAS,IAAI,CAAC,KAAK,CAAC,CAAC;YACpD,IAAI,WAAW,EAAE,CAAC;gBACd,2CAA2C;gBAC3C,OAAO,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC;YACvC,CAAC;QACL,CAAC;QAED,oEAAoE;QACpE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAChD,MAAM,GAAG,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YACjC,MAAM,OAAO,GAAG,GAAG,CAAC,kBAAkB,EAAE,CAAC;YACzC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;YAEnD,0EAA0E;YAC1E,MAAM,WAAW,GAAG,cAAc,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,OAAO,EAAE,EAAE,QAAQ,CAAC,CAAC;YAE1E,sDAAsD;YACtD,IAAI,WAAW,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,WAAW,EAAE,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;gBACpE,6DAA6D;gBAC7D,MAAM,WAAW,GAAG,UAAU,CAAC,SAAS,IAAI,CAAC,KAAK,CAAC,CAAC;gBACpD,MAAM,KAAK,GAAG,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;gBACpD,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,WAAW,EAAE,OAAO,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;YAC7D,CAAC;QACL,CAAC;IACL,CAAC;IAED;;OAEG;IACK,wBAAwB,CAAC,KAAU,EAAE,OAAe;QACxD,oEAAoE;QACpE,4DAA4D;QAC5D,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC,WAAW,EAAE,CAAC;QAChD,OAAO,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IACpD,CAAC;CACJ;AA3DD,gCA2DC"}

package/dist/src/reporting/services/DataSourceHandler.d.ts

@@ -0,0 +1,25 @@
+import { SourceExpression } from '../../models/Clause';
+import { DataFlowGraph } from '../models/DataFlowGraph';
+/**
+ * Handles the processing of data sources (tables, CTEs, subqueries)
+ */
+export declare class DataSourceHandler {
+    private graph;
+    constructor(graph: DataFlowGraph);
+    /**
+     * Processes a source expression and returns the node ID
+     */
+    processSource(sourceExpr: SourceExpression, cteNames: Set<string>, queryProcessor: (query: any, context: string, cteNames: Set<string>) => string): string;
+    /**
+     * Processes a table source (including CTE references)
+     */
+    private processTableSource;
+    /**
+     * Processes a subquery source
+     */
+    private processSubquerySource;
+    /**
+     * Extracts table node IDs from a FROM clause for WHERE subqueries
+     */
+    extractTableNodeIds(fromClause: any, cteNames: Set<string>): string[];
+}