@databridgeai/core 1.0.0

package/README.md

@@ -0,0 +1,94 @@
+# @databridgeai/core
+
+**Shared types, validators, and database adapters for the DataBridge AI platform.**
+
+This is an internal dependency used by other `@databridgeai/*` packages. You typically don't need to install this directly.
+
+## Installation
+
+```bash
+npm install @databridgeai/core
+```
+
+## Types
+
+```typescript
+import type {
+  SchemaMetadata,
+  TableSchema,
+  ColumnSchema,
+  QueryDSL,
+  QueryResult,
+  ChatRequest,
+  ChatResponse,
+  UserContext,
+  ProjectRegistration,
+  DbAdapter,
+  UsageLogEntry,
+} from '@databridgeai/core';
+```
+
+## Key Types
+
+### QueryDSL
+The intermediate query representation generated by the AI:
+
+```typescript
+interface QueryDSL {
+  table: string;
+  select?: string[];
+  where?: Record<string, any>;
+  orderBy?: { column: string; direction: 'asc' | 'desc' }[];
+  limit?: number;
+  offset?: number;
+  groupBy?: string[];
+  aggregate?: { function: string; column: string; alias: string }[];
+}
+```
+
+### SchemaMetadata
+Describes your database structure:
+
+```typescript
+interface SchemaMetadata {
+  tables: TableSchema[];
+}
+
+interface TableSchema {
+  name: string;
+  columns: ColumnSchema[];
+}
+```
+
+## Database Adapters
+
+Execute validated QueryDSL against your database:
+
+```typescript
+import { PostgresAdapter, MongoAdapter } from '@databridgeai/core';
+
+// Postgres
+const pgAdapter = new PostgresAdapter(pool);
+const result = await pgAdapter.execute(queryDSL, tenantContext);
+
+// MongoDB
+const mongoAdapter = new MongoAdapter(db);
+const result = await mongoAdapter.execute(queryDSL, tenantContext);
+```
+
+## Validators
+
+Validate QueryDSL against a schema before execution:
+
+```typescript
+import { validateQueryDSL } from '@databridgeai/core';
+
+const errors = validateQueryDSL(queryDSL, schema);
+if (errors.length > 0) {
+  throw new Error(`Invalid query: ${errors.join(', ')}`);
+}
+```
+
+## License
+
+MIT

package/dist/formatter.d.ts

@@ -0,0 +1,11 @@
+import { QueryResult } from "./types";
+/**
+ * Formats query execution results into a human-readable summary string
+ * suitable for feeding back to the LLM.
+ */
+export declare function formatResultForLLM(result: QueryResult): string;
+/**
+ * Formats query results as a compact JSON payload for the chat response.
+ */
+export declare function formatResultForResponse(result: QueryResult): Record<string, any>;
+//# sourceMappingURL=formatter.d.ts.map

package/dist/formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.d.ts","sourceRoot":"","sources":["../src/formatter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEtC;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAoB9D;AASD;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,WAAW,GAClB,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAMrB"}

package/dist/formatter.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatResultForLLM = formatResultForLLM;
+exports.formatResultForResponse = formatResultForResponse;
+/**
+ * Formats query execution results into a human-readable summary string
+ * suitable for feeding back to the LLM.
+ */
+function formatResultForLLM(result) {
+    if (result.rowCount === 0) {
+        return "No results found.";
+    }
+    const header = `Found ${result.rowCount} result(s) in ${result.executionTimeMs}ms:\n`;
+    // For small result sets, render as a simple table
+    if (result.rowCount <= 20) {
+        const keys = Object.keys(result.rows[0]);
+        const rows = result.rows.map((row) => keys.map((k) => formatValue(row[k])).join(" | "));
+        const headerRow = keys.join(" | ");
+        const separator = keys.map(() => "---").join(" | ");
+        return `${header}\n${headerRow}\n${separator}\n${rows.join("\n")}`;
+    }
+    // For larger result sets, return JSON
+    return `${header}\n${JSON.stringify(result.rows, null, 2)}`;
+}
+function formatValue(value) {
+    if (value === null || value === undefined)
+        return "NULL";
+    if (value instanceof Date)
+        return value.toISOString();
+    if (typeof value === "object")
+        return JSON.stringify(value);
+    return String(value);
+}
+/**
+ * Formats query results as a compact JSON payload for the chat response.
+ */
+function formatResultForResponse(result) {
+    return {
+        rows: result.rows,
+        rowCount: result.rowCount,
+        executionTimeMs: result.executionTimeMs,
+    };
+}
+//# sourceMappingURL=formatter.js.map

package/dist/formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.js","sourceRoot":"","sources":["../src/formatter.ts"],"names":[],"mappings":";;AAMA,gDAoBC;AAYD,0DAQC;AA5CD;;;GAGG;AACH,SAAgB,kBAAkB,CAAC,MAAmB;IACpD,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,mBAAmB,CAAC;IAC7B,CAAC;IAED,MAAM,MAAM,GAAG,SAAS,MAAM,CAAC,QAAQ,iBAAiB,MAAM,CAAC,eAAe,OAAO,CAAC;IAEtF,kDAAkD;IAClD,IAAI,MAAM,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACzC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CACnC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CACjD,CAAC;QACF,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACpD,OAAO,GAAG,MAAM,KAAK,SAAS,KAAK,SAAS,KAAK,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IACrE,CAAC;IAED,sCAAsC;IACtC,OAAO,GAAG,MAAM,KAAK,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;AAC9D,CAAC;AAED,SAAS,WAAW,CAAC,KAAU;IAC7B,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC;IACzD,IAAI,KAAK,YAAY,IAAI;QAAE,OAAO,KAAK,CAAC,WAAW,EAAE,CAAC;IACtD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC5D,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED;;GAEG;AACH,SAAgB,uBAAuB,CACrC,MAAmB;IAEnB,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,eAAe,EAAE,MAAM,CAAC,eAAe;KACxC,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { type QueryDSL, type QueryFilter, type QuerySort, type QueryPagination, type QueryJoin, type QueryAggregation, type FilterOperator, type JoinType, type AggregationType, type SortDirection, type SchemaMetadata, type TableMetadata, type FieldMetadata, type RelationMetadata, type UserContext, type ChatRequest, type ChatResponse, type QueryResult, type ValidationError, type ProjectRegistration, type UsageLogEntry, type DbAdapter, MAX_JOINS, MAX_LIMIT, DEFAULT_LIMIT, NUMERIC_TYPES, } from "./types";
+export { validateQuery, injectTenantFilter, applyDefaults, } from "./validator";
+export { PostgresAdapter } from "./postgres-adapter";
+export { MongoAdapter } from "./mongo-adapter";
+export { formatResultForLLM, formatResultForResponse } from "./formatter";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,QAAQ,EACb,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,eAAe,EACpB,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,QAAQ,EACb,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAClB,KAAK,SAAS,EAEd,SAAS,EACT,SAAS,EACT,aAAa,EACb,aAAa,GACd,MAAM,SAAS,CAAC;AAEjB,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,aAAa,GACd,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,23 @@
+"use strict";
+// ─── @databridgeai/core ───────────────────────────────────────────
+// Shared types, validation, adapters, and utilities.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatResultForResponse = exports.formatResultForLLM = exports.MongoAdapter = exports.PostgresAdapter = exports.applyDefaults = exports.injectTenantFilter = exports.validateQuery = exports.NUMERIC_TYPES = exports.DEFAULT_LIMIT = exports.MAX_LIMIT = exports.MAX_JOINS = void 0;
+var types_1 = require("./types");
+// Constants
+Object.defineProperty(exports, "MAX_JOINS", { enumerable: true, get: function () { return types_1.MAX_JOINS; } });
+Object.defineProperty(exports, "MAX_LIMIT", { enumerable: true, get: function () { return types_1.MAX_LIMIT; } });
+Object.defineProperty(exports, "DEFAULT_LIMIT", { enumerable: true, get: function () { return types_1.DEFAULT_LIMIT; } });
+Object.defineProperty(exports, "NUMERIC_TYPES", { enumerable: true, get: function () { return types_1.NUMERIC_TYPES; } });
+var validator_1 = require("./validator");
+Object.defineProperty(exports, "validateQuery", { enumerable: true, get: function () { return validator_1.validateQuery; } });
+Object.defineProperty(exports, "injectTenantFilter", { enumerable: true, get: function () { return validator_1.injectTenantFilter; } });
+Object.defineProperty(exports, "applyDefaults", { enumerable: true, get: function () { return validator_1.applyDefaults; } });
+var postgres_adapter_1 = require("./postgres-adapter");
+Object.defineProperty(exports, "PostgresAdapter", { enumerable: true, get: function () { return postgres_adapter_1.PostgresAdapter; } });
+var mongo_adapter_1 = require("./mongo-adapter");
+Object.defineProperty(exports, "MongoAdapter", { enumerable: true, get: function () { return mongo_adapter_1.MongoAdapter; } });
+var formatter_1 = require("./formatter");
+Object.defineProperty(exports, "formatResultForLLM", { enumerable: true, get: function () { return formatter_1.formatResultForLLM; } });
+Object.defineProperty(exports, "formatResultForResponse", { enumerable: true, get: function () { return formatter_1.formatResultForResponse; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA,qEAAqE;AACrE,qDAAqD;;;AAErD,iCA6BiB;AALf,YAAY;AACZ,kGAAA,SAAS,OAAA;AACT,kGAAA,SAAS,OAAA;AACT,sGAAA,aAAa,OAAA;AACb,sGAAA,aAAa,OAAA;AAGf,yCAIqB;AAHnB,0GAAA,aAAa,OAAA;AACb,+GAAA,kBAAkB,OAAA;AAClB,0GAAA,aAAa,OAAA;AAGf,uDAAqD;AAA5C,mHAAA,eAAe,OAAA;AACxB,iDAA+C;AAAtC,6GAAA,YAAY,OAAA;AACrB,yCAA0E;AAAjE,+GAAA,kBAAkB,OAAA;AAAE,oHAAA,uBAAuB,OAAA"}

package/dist/mongo-adapter.d.ts

@@ -0,0 +1,18 @@
+import { Db, Document } from "mongodb";
+import { QueryDSL, QueryResult, DbAdapter } from "./types";
+/**
+ * MongoDB adapter — builds aggregation pipeline from QueryDSL and executes it.
+ */
+export declare class MongoAdapter implements DbAdapter {
+    private db;
+    private client;
+    constructor(dbOrUri: Db | string, dbName?: string);
+    connect(): Promise<void>;
+    execute(query: QueryDSL): Promise<QueryResult>;
+    /**
+     * Builds a MongoDB aggregation pipeline from QueryDSL.
+     */
+    buildPipeline(query: QueryDSL): Document[];
+    close(): Promise<void>;
+}
+//# sourceMappingURL=mongo-adapter.d.ts.map

package/dist/mongo-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongo-adapter.d.ts","sourceRoot":"","sources":["../src/mongo-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,EAAE,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EACL,QAAQ,EACR,WAAW,EACX,SAAS,EAEV,MAAM,SAAS,CAAC;AAEjB;;GAEG;AACH,qBAAa,YAAa,YAAW,SAAS;IAC5C,OAAO,CAAC,EAAE,CAAK;IACf,OAAO,CAAC,MAAM,CAAqB;gBAEvB,OAAO,EAAE,EAAE,GAAG,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;IAU3C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAMxB,OAAO,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,WAAW,CAAC;IAgBpD;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,QAAQ,GAAG,QAAQ,EAAE;IAmJpC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAK7B"}

package/dist/mongo-adapter.js

@@ -0,0 +1,186 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MongoAdapter = void 0;
+const mongodb_1 = require("mongodb");
+const types_1 = require("./types");
+/**
+ * MongoDB adapter — builds aggregation pipeline from QueryDSL and executes it.
+ */
+class MongoAdapter {
+    db;
+    client;
+    constructor(dbOrUri, dbName) {
+        if (typeof dbOrUri === "string") {
+            this.client = new mongodb_1.MongoClient(dbOrUri);
+            this.db = this.client.db(dbName);
+        }
+        else {
+            this.client = null;
+            this.db = dbOrUri;
+        }
+    }
+    async connect() {
+        if (this.client) {
+            await this.client.connect();
+        }
+    }
+    async execute(query) {
+        const start = Date.now();
+        const pipeline = this.buildPipeline(query);
+        const collection = this.db.collection(query.source.name);
+        const cursor = collection.aggregate(pipeline);
+        const rows = await cursor.toArray();
+        const executionTimeMs = Date.now() - start;
+        return {
+            rows: rows,
+            rowCount: rows.length,
+            executionTimeMs,
+        };
+    }
+    /**
+     * Builds a MongoDB aggregation pipeline from QueryDSL.
+     */
+    buildPipeline(query) {
+        const pipeline = [];
+        // ─── $match (filters) ────────────────────────────────
+        if (query.filters && query.filters.length > 0) {
+            const matchStage = {};
+            for (const filter of query.filters) {
+                switch (filter.operator) {
+                    case "eq":
+                        matchStage[filter.field] = filter.value;
+                        break;
+                    case "neq":
+                        matchStage[filter.field] = { $ne: filter.value };
+                        break;
+                    case "gt":
+                        matchStage[filter.field] = { $gt: filter.value };
+                        break;
+                    case "gte":
+                        matchStage[filter.field] = { $gte: filter.value };
+                        break;
+                    case "lt":
+                        matchStage[filter.field] = { $lt: filter.value };
+                        break;
+                    case "lte":
+                        matchStage[filter.field] = { $lte: filter.value };
+                        break;
+                    case "in":
+                        matchStage[filter.field] = { $in: filter.value };
+                        break;
+                    case "contains":
+                        matchStage[filter.field] = {
+                            $regex: filter.value,
+                            $options: "i",
+                        };
+                        break;
+                }
+            }
+            pipeline.push({ $match: matchStage });
+        }
+        // ─── $lookup (joins) ─────────────────────────────────
+        if (query.joins) {
+            for (const join of query.joins) {
+                pipeline.push({
+                    $lookup: {
+                        from: join.table,
+                        localField: join.on.localField,
+                        foreignField: join.on.foreignField,
+                        as: join.table,
+                    },
+                });
+                // For inner join, filter out docs with no matches
+                if (join.type === "inner") {
+                    pipeline.push({
+                        $match: {
+                            [join.table]: { $ne: [] },
+                        },
+                    });
+                }
+                // Unwind the joined array (one-to-one style)
+                pipeline.push({
+                    $unwind: {
+                        path: `$${join.table}`,
+                        preserveNullAndEmptyArrays: join.type !== "inner",
+                    },
+                });
+            }
+        }
+        // ─── $group (aggregation) ────────────────────────────
+        if (query.aggregation) {
+            const agg = query.aggregation;
+            const groupStage = {
+                _id: agg.groupBy ? `$${agg.groupBy}` : null,
+            };
+            switch (agg.type) {
+                case "count":
+                    groupStage["result"] = { $sum: 1 };
+                    break;
+                case "sum":
+                    groupStage["result"] = { $sum: `$${agg.field}` };
+                    break;
+                case "avg":
+                    groupStage["result"] = { $avg: `$${agg.field}` };
+                    break;
+                case "min":
+                    groupStage["result"] = { $min: `$${agg.field}` };
+                    break;
+                case "max":
+                    groupStage["result"] = { $max: `$${agg.field}` };
+                    break;
+            }
+            pipeline.push({ $group: groupStage });
+            // Rename _id to groupBy field name for cleaner output
+            if (agg.groupBy) {
+                pipeline.push({
+                    $project: {
+                        _id: 0,
+                        [agg.groupBy]: "$_id",
+                        result: 1,
+                    },
+                });
+            }
+            else {
+                pipeline.push({
+                    $project: {
+                        _id: 0,
+                        result: 1,
+                    },
+                });
+            }
+        }
+        else {
+            // ─── $project (select) ─────────────────────────────
+            if (query.select && query.select.length > 0) {
+                const projection = { _id: 0 };
+                for (const field of query.select) {
+                    projection[field] = 1;
+                }
+                pipeline.push({ $project: projection });
+            }
+        }
+        // ─── $sort ───────────────────────────────────────────
+        if (query.sort) {
+            pipeline.push({
+                $sort: {
+                    [query.sort.field]: query.sort.direction === "desc" ? -1 : 1,
+                },
+            });
+        }
+        // ─── $skip / $limit ──────────────────────────────────
+        const offset = query.pagination?.offset ?? 0;
+        if (offset > 0) {
+            pipeline.push({ $skip: offset });
+        }
+        const limit = query.pagination?.limit ?? types_1.DEFAULT_LIMIT;
+        pipeline.push({ $limit: limit });
+        return pipeline;
+    }
+    async close() {
+        if (this.client) {
+            await this.client.close();
+        }
+    }
+}
+exports.MongoAdapter = MongoAdapter;
+//# sourceMappingURL=mongo-adapter.js.map

package/dist/mongo-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongo-adapter.js","sourceRoot":"","sources":["../src/mongo-adapter.ts"],"names":[],"mappings":";;;AAAA,qCAAoD;AACpD,mCAKiB;AAEjB;;GAEG;AACH,MAAa,YAAY;IACf,EAAE,CAAK;IACP,MAAM,CAAqB;IAEnC,YAAY,OAAoB,EAAE,MAAe;QAC/C,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YAChC,IAAI,CAAC,MAAM,GAAG,IAAI,qBAAW,CAAC,OAAO,CAAC,CAAC;YACvC,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;QACnC,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;YACnB,IAAI,CAAC,EAAE,GAAG,OAAO,CAAC;QACpB,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAO;QACX,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,KAAe;QAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QAC3C,MAAM,UAAU,GAAG,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAEzD,MAAM,MAAM,GAAG,UAAU,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAC9C,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;QACpC,MAAM,eAAe,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;QAE3C,OAAO;YACL,IAAI,EAAE,IAA6B;YACnC,QAAQ,EAAE,IAAI,CAAC,MAAM;YACrB,eAAe;SAChB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,KAAe;QAC3B,MAAM,QAAQ,GAAe,EAAE,CAAC;QAEhC,wDAAwD;QACxD,IAAI,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9C,MAAM,UAAU,GAAa,EAAE,CAAC;YAChC,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;gBACnC,QAAQ,MAAM,CAAC,QAAQ,EAAE,CAAC;oBACxB,KAAK,IAAI;wBACP,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC;wBACxC,MAAM;oBACR,KAAK,KAAK;wBACR,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;wBACjD,MAAM;oBACR,KAAK,IAAI;wBACP,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;wBACjD,MAAM;oBACR,KAAK,KAAK;wBACR,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;wBAClD,MAAM;oBACR,KAAK,IAAI;wBACP,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;wBACjD,MAAM;oBACR,KAAK,KAAK;wBACR,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;wBAClD,MAAM;oBACR,KAAK,IAAI;wBACP,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;wBACjD,MAAM;oBACR,KAAK,UAAU;wBACb,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG;4BACzB,MAAM,EAAE,MAAM,CAAC,KAAK;4BACpB,QAAQ,EAAE,GAAG;yBACd,CAAC;wBACF,MAAM;gBACV,CAAC;YACH,CAAC;YACD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;QACxC,CAAC;QAED,wDAAwD;QACxD,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YAChB,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;gBAC/B,QAAQ,CAAC,IAAI,CAAC;oBACZ,OAAO,EAAE;wBACP,IAAI,EAAE,IAAI,CAAC,KAAK;wBAChB,UAAU,EAAE,IAAI,CAAC,EAAE,CAAC,UAAU;wBAC9B,YAAY,EAAE,IAAI,CAAC,EAAE,CAAC,YAAY;wBAClC,EAAE,EAAE,IAAI,CAAC,KAAK;qBACf;iBACF,CAAC,CAAC;gBAEH,kDAAkD;gBAClD,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;oBAC1B,QAAQ,CAAC,IAAI,CAAC;wBACZ,MAAM,EAAE;4BACN,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE;yBAC1B;qBACF,CAAC,CAAC;gBACL,CAAC;gBAED,6CAA6C;gBAC7C,QAAQ,CAAC,IAAI,CAAC;oBACZ,OAAO,EAAE;wBACP,IAAI,EAAE,IAAI,IAAI,CAAC,KAAK,EAAE;wBACtB,0BAA0B,EAAE,IAAI,CAAC,IAAI,KAAK,OAAO;qBAClD;iBACF,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,wDAAwD;QACxD,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;YACtB,MAAM,GAAG,GAAG,KAAK,CAAC,WAAW,CAAC;YAC9B,MAAM,UAAU,GAAa;gBAC3B,GAAG,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI;aAC5C,CAAC;YAEF,QAAQ,GAAG,CAAC,IAAI,EAAE,CAAC;gBACjB,KAAK,OAAO;oBACV,UAAU,CAAC,QAAQ,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;oBACnC,MAAM;gBACR,KAAK,KAAK;oBACR,UAAU,CAAC,QAAQ,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC;oBACjD,MAAM;gBACR,KAAK,KAAK;oBACR,UAAU,CAAC,QAAQ,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC;oBACjD,MAAM;gBACR,KAAK,KAAK;oBACR,UAAU,CAAC,QAAQ,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC;oBACjD,MAAM;gBACR,KAAK,KAAK;oBACR,UAAU,CAAC,QAAQ,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC;oBACjD,MAAM;YACV,CAAC;YAED,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;YAEtC,sDAAsD;YACtD,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;gBAChB,QAAQ,CAAC,IAAI,CAAC;oBACZ,QAAQ,EAAE;wBACR,GAAG,EAAE,CAAC;wBACN,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,MAAM;wBACrB,MAAM,EAAE,CAAC;qBACV;iBACF,CAAC,CAAC;YACL,CAAC;iBAAM,CAAC;gBACN,QAAQ,CAAC,IAAI,CAAC;oBACZ,QAAQ,EAAE;wBACR,GAAG,EAAE,CAAC;wBACN,MAAM,EAAE,CAAC;qBACV;iBACF,CAAC,CAAC;YACL,CAAC;QACH,CAAC;aAAM,CAAC;YACN,sDAAsD;YACtD,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC5C,MAAM,UAAU,GAAa,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;gBACxC,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;oBACjC,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;gBACxB,CAAC;gBACD,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC,CAAC;YAC1C,CAAC;QACH,CAAC;QAED,wDAAwD;QACxD,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;YACf,QAAQ,CAAC,IAAI,CAAC;gBACZ,KAAK,EAAE;oBACL,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,SAAS,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;iBAC7D;aACF,CAAC,CAAC;QACL,CAAC;QAED,wDAAwD;QACxD,MAAM,MAAM,GAAG,KAAK,CAAC,UAAU,EAAE,MAAM,IAAI,CAAC,CAAC;QAC7C,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;YACf,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;QACnC,CAAC;QAED,MAAM,KAAK,GAAG,KAAK,CAAC,UAAU,EAAE,KAAK,IAAI,qBAAa,CAAC;QACvD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QAEjC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAC5B,CAAC;IACH,CAAC;CACF;AA/LD,oCA+LC"}

package/dist/postgres-adapter.d.ts

@@ -0,0 +1,21 @@
+import { Pool, PoolConfig } from "pg";
+import { QueryDSL, QueryResult, DbAdapter } from "./types";
+/**
+ * Postgres adapter — builds parameterized SQL from QueryDSL and executes it.
+ */
+export declare class PostgresAdapter implements DbAdapter {
+    private pool;
+    constructor(config: PoolConfig | Pool);
+    execute(query: QueryDSL): Promise<QueryResult>;
+    /**
+     * Builds a parameterized SQL query from QueryDSL.
+     */
+    buildSQL(query: QueryDSL): {
+        text: string;
+        values: any[];
+    };
+    private buildAggregationSelect;
+    private quote;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=postgres-adapter.d.ts.map

package/dist/postgres-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-adapter.d.ts","sourceRoot":"","sources":["../src/postgres-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AACtC,OAAO,EACL,QAAQ,EACR,WAAW,EACX,SAAS,EAEV,MAAM,SAAS,CAAC;AAEjB;;GAEG;AACH,qBAAa,eAAgB,YAAW,SAAS;IAC/C,OAAO,CAAC,IAAI,CAAO;gBAEP,MAAM,EAAE,UAAU,GAAG,IAAI;IAQ/B,OAAO,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,WAAW,CAAC;IAcpD;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,GAAG,EAAE,CAAA;KAAE;IA0H1D,OAAO,CAAC,sBAAsB;IAiC9B,OAAO,CAAC,KAAK;IAMP,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}

package/dist/postgres-adapter.js

@@ -0,0 +1,177 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PostgresAdapter = void 0;
+const pg_1 = require("pg");
+const types_1 = require("./types");
+/**
+ * Postgres adapter — builds parameterized SQL from QueryDSL and executes it.
+ */
+class PostgresAdapter {
+    pool;
+    constructor(config) {
+        if (config instanceof pg_1.Pool) {
+            this.pool = config;
+        }
+        else {
+            this.pool = new pg_1.Pool(config);
+        }
+    }
+    async execute(query) {
+        const start = Date.now();
+        const { text, values } = this.buildSQL(query);
+        const result = await this.pool.query(text, values);
+        const executionTimeMs = Date.now() - start;
+        return {
+            rows: result.rows,
+            rowCount: result.rowCount ?? result.rows.length,
+            executionTimeMs,
+        };
+    }
+    /**
+     * Builds a parameterized SQL query from QueryDSL.
+     */
+    buildSQL(query) {
+        const values = [];
+        let paramIdx = 1;
+        const source = this.quote(query.source.name);
+        // ─── SELECT / Aggregation ─────────────────────────────
+        let selectClause;
+        if (query.aggregation) {
+            selectClause = this.buildAggregationSelect(query);
+        }
+        else if (query.select && query.select.length > 0) {
+            selectClause = query.select
+                .map((f) => {
+                if (f.includes(".")) {
+                    const [table, field] = f.split(".");
+                    return `${this.quote(table)}.${this.quote(field)}`;
+                }
+                return `${source}.${this.quote(f)}`;
+            })
+                .join(", ");
+        }
+        else {
+            selectClause = `${source}.*`;
+        }
+        // ─── FROM ─────────────────────────────────────────────
+        let fromClause = source;
+        // ─── JOINS ────────────────────────────────────────────
+        const joinClauses = [];
+        if (query.joins) {
+            for (const join of query.joins) {
+                const joinType = join.type === "inner" ? "INNER JOIN" : "LEFT JOIN";
+                const joinTable = this.quote(join.table);
+                joinClauses.push(`${joinType} ${joinTable} ON ${source}.${this.quote(join.on.localField)} = ${joinTable}.${this.quote(join.on.foreignField)}`);
+            }
+        }
+        // ─── WHERE ────────────────────────────────────────────
+        const whereParts = [];
+        if (query.filters) {
+            for (const filter of query.filters) {
+                const col = `${source}.${this.quote(filter.field)}`;
+                switch (filter.operator) {
+                    case "eq":
+                        whereParts.push(`${col} = $${paramIdx++}`);
+                        values.push(filter.value);
+                        break;
+                    case "neq":
+                        whereParts.push(`${col} != $${paramIdx++}`);
+                        values.push(filter.value);
+                        break;
+                    case "gt":
+                        whereParts.push(`${col} > $${paramIdx++}`);
+                        values.push(filter.value);
+                        break;
+                    case "gte":
+                        whereParts.push(`${col} >= $${paramIdx++}`);
+                        values.push(filter.value);
+                        break;
+                    case "lt":
+                        whereParts.push(`${col} < $${paramIdx++}`);
+                        values.push(filter.value);
+                        break;
+                    case "lte":
+                        whereParts.push(`${col} <= $${paramIdx++}`);
+                        values.push(filter.value);
+                        break;
+                    case "in":
+                        whereParts.push(`${col} = ANY($${paramIdx++})`);
+                        values.push(filter.value);
+                        break;
+                    case "contains":
+                        whereParts.push(`${col} ILIKE $${paramIdx++}`);
+                        values.push(`%${filter.value}%`);
+                        break;
+                }
+            }
+        }
+        // ─── GROUP BY ─────────────────────────────────────────
+        let groupByClause = "";
+        if (query.aggregation?.groupBy) {
+            groupByClause = `GROUP BY ${source}.${this.quote(query.aggregation.groupBy)}`;
+        }
+        // ─── ORDER BY ─────────────────────────────────────────
+        let orderByClause = "";
+        if (query.sort) {
+            const dir = query.sort.direction === "desc" ? "DESC" : "ASC";
+            orderByClause = `ORDER BY ${source}.${this.quote(query.sort.field)} ${dir}`;
+        }
+        // ─── LIMIT / OFFSET ──────────────────────────────────
+        const limit = query.pagination?.limit ?? types_1.DEFAULT_LIMIT;
+        const offset = query.pagination?.offset ?? 0;
+        // ─── Assemble ─────────────────────────────────────────
+        const parts = [
+            `SELECT ${selectClause}`,
+            `FROM ${fromClause}`,
+            ...joinClauses,
+            whereParts.length > 0
+                ? `WHERE ${whereParts.join(" AND ")}`
+                : "",
+            groupByClause,
+            orderByClause,
+            `LIMIT ${limit}`,
+            offset > 0 ? `OFFSET ${offset}` : "",
+        ].filter(Boolean);
+        return { text: parts.join(" "), values };
+    }
+    buildAggregationSelect(query) {
+        const agg = query.aggregation;
+        const source = this.quote(query.source.name);
+        let aggExpr;
+        switch (agg.type) {
+            case "count":
+                aggExpr = agg.field
+                    ? `COUNT(${source}.${this.quote(agg.field)})`
+                    : `COUNT(*)`;
+                break;
+            case "sum":
+                aggExpr = `SUM(${source}.${this.quote(agg.field)})`;
+                break;
+            case "avg":
+                aggExpr = `AVG(${source}.${this.quote(agg.field)})`;
+                break;
+            case "min":
+                aggExpr = `MIN(${source}.${this.quote(agg.field)})`;
+                break;
+            case "max":
+                aggExpr = `MAX(${source}.${this.quote(agg.field)})`;
+                break;
+            default:
+                aggExpr = `COUNT(*)`;
+        }
+        if (agg.groupBy) {
+            return `${source}.${this.quote(agg.groupBy)}, ${aggExpr} AS result`;
+        }
+        return `${aggExpr} AS result`;
+    }
+    quote(identifier) {
+        // Prevent SQL injection in identifiers
+        const safe = identifier.replace(/[^a-zA-Z0-9_]/g, "");
+        return `"${safe}"`;
+    }
+    async close() {
+        await this.pool.end();
+    }
+}
+exports.PostgresAdapter = PostgresAdapter;
+//# sourceMappingURL=postgres-adapter.js.map

package/dist/postgres-adapter.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,107 @@
+export type FilterOperator = "eq" | "neq" | "gt" | "gte" | "lt" | "lte" | "in" | "contains";
+export type JoinType = "inner" | "left";
+export type AggregationType = "count" | "sum" | "avg" | "min" | "max";
+export type SortDirection = "asc" | "desc";
+export interface QueryFilter {
+    field: string;
+    operator: FilterOperator;
+    value: any;
+}
+export interface QuerySort {
+    field: string;
+    direction: SortDirection;
+}
+export interface QueryPagination {
+    limit: number;
+    offset?: number;
+}
+export interface QueryJoin {
+    table: string;
+    on: {
+        localField: string;
+        foreignField: string;
+    };
+    type?: JoinType;
+}
+export interface QueryAggregation {
+    type: AggregationType;
+    field?: string;
+    groupBy?: string;
+}
+export interface QueryDSL {
+    source: {
+        name: string;
+    };
+    select?: string[];
+    filters?: QueryFilter[];
+    sort?: QuerySort;
+    pagination?: QueryPagination;
+    joins?: QueryJoin[];
+    aggregation?: QueryAggregation;
+}
+export interface FieldMetadata {
+    name: string;
+    type: string;
+}
+export interface RelationMetadata {
+    table: string;
+    localField: string;
+    foreignField: string;
+}
+export interface TableMetadata {
+    name: string;
+    fields: FieldMetadata[];
+    relations?: RelationMetadata[];
+}
+export interface SchemaMetadata {
+    tables: TableMetadata[];
+}
+export interface UserContext {
+    userId: string;
+    orgId: string;
+    role: string;
+}
+export interface ChatRequest {
+    projectId: string;
+    message: string;
+    userContext: UserContext;
+}
+export interface ChatResponse {
+    message: string;
+    data?: any;
+    tokensUsed?: number;
+    visualization?: any;
+}
+export interface QueryResult {
+    rows: Record<string, any>[];
+    rowCount: number;
+    executionTimeMs: number;
+}
+export interface ValidationError {
+    code: string;
+    message: string;
+    path?: string;
+}
+export interface ProjectRegistration {
+    projectId: string;
+    apiKey: string;
+    dbType: "postgres" | "mongo";
+    schema: SchemaMetadata;
+    tenantField?: string;
+}
+export interface UsageLogEntry {
+    projectId: string;
+    tokensUsed: number;
+    queryExecutionTimeMs: number;
+    rowCount: number;
+    timestamp: Date;
+}
+export interface DbAdapter {
+    execute(query: QueryDSL): Promise<QueryResult>;
+    close(): Promise<void>;
+}
+export declare const MAX_JOINS = 2;
+export declare const MAX_LIMIT = 200;
+export declare const DEFAULT_LIMIT = 50;
+export declare const NUMERIC_TYPES: Set<string>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,30 @@
+"use strict";
+// ─── QueryDSL ────────────────────────────────────────────────
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NUMERIC_TYPES = exports.DEFAULT_LIMIT = exports.MAX_LIMIT = exports.MAX_JOINS = void 0;
+// ─── Constants ───────────────────────────────────────────────
+exports.MAX_JOINS = 2;
+exports.MAX_LIMIT = 200;
+exports.DEFAULT_LIMIT = 50;
+// ─── Numeric field types ─────────────────────────────────────
+exports.NUMERIC_TYPES = new Set([
+    "integer",
+    "int",
+    "int4",
+    "int8",
+    "bigint",
+    "smallint",
+    "serial",
+    "bigserial",
+    "float",
+    "float4",
+    "float8",
+    "double",
+    "double precision",
+    "real",
+    "decimal",
+    "numeric",
+    "number",
+    "money",
+]);
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA,gEAAgE;;;AAsJhE,gEAAgE;AAEnD,QAAA,SAAS,GAAG,CAAC,CAAC;AACd,QAAA,SAAS,GAAG,GAAG,CAAC;AAChB,QAAA,aAAa,GAAG,EAAE,CAAC;AAEhC,gEAAgE;AAEnD,QAAA,aAAa,GAAG,IAAI,GAAG,CAAC;IACnC,SAAS;IACT,KAAK;IACL,MAAM;IACN,MAAM;IACN,QAAQ;IACR,UAAU;IACV,QAAQ;IACR,WAAW;IACX,OAAO;IACP,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,kBAAkB;IAClB,MAAM;IACN,SAAS;IACT,SAAS;IACT,QAAQ;IACR,OAAO;CACR,CAAC,CAAC"}

package/dist/validator.d.ts

@@ -0,0 +1,16 @@
+import { QueryDSL, SchemaMetadata, ValidationError, UserContext } from "./types";
+/**
+ * Validates a QueryDSL object against the project schema and hard limits.
+ * Returns an array of validation errors (empty = valid).
+ */
+export declare function validateQuery(query: QueryDSL, schema: SchemaMetadata): ValidationError[];
+/**
+ * Injects a mandatory tenant filter into the query.
+ * This is NOT exposed to the LLM — it's appended server-side.
+ */
+export declare function injectTenantFilter(query: QueryDSL, tenantField: string, userContext: UserContext): QueryDSL;
+/**
+ * Applies default pagination if not specified.
+ */
+export declare function applyDefaults(query: QueryDSL): QueryDSL;
+//# sourceMappingURL=validator.d.ts.map

package/dist/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../src/validator.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EACR,cAAc,EACd,eAAe,EAKf,WAAW,EACZ,MAAM,SAAS,CAAC;AAEjB;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,QAAQ,EACf,MAAM,EAAE,cAAc,GACrB,eAAe,EAAE,CA4PnB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,QAAQ,EACf,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,WAAW,GACvB,QAAQ,CAWV;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,QAAQ,GAAG,QAAQ,CAQvD"}

package/dist/validator.js

@@ -0,0 +1,270 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateQuery = validateQuery;
+exports.injectTenantFilter = injectTenantFilter;
+exports.applyDefaults = applyDefaults;
+const types_1 = require("./types");
+/**
+ * Validates a QueryDSL object against the project schema and hard limits.
+ * Returns an array of validation errors (empty = valid).
+ */
+function validateQuery(query, schema) {
+    const errors = [];
+    // ─── Source validation ───────────────────────────────────
+    const sourceTable = schema.tables.find((t) => t.name === query.source?.name);
+    if (!query.source?.name) {
+        errors.push({
+            code: "MISSING_SOURCE",
+            message: "Query must specify a source table/collection.",
+            path: "source.name",
+        });
+        return errors; // Can't validate further without source
+    }
+    if (!sourceTable) {
+        errors.push({
+            code: "INVALID_SOURCE",
+            message: `Table "${query.source.name}" does not exist in the schema.`,
+            path: "source.name",
+        });
+        return errors;
+    }
+    const allFieldNames = new Set(sourceTable.fields.map((f) => f.name));
+    // ─── Select validation ──────────────────────────────────
+    if (query.select) {
+        for (const field of query.select) {
+            // Allow "table.field" for joined fields
+            const bareField = field.includes(".") ? field.split(".")[1] : field;
+            const fieldTable = field.includes(".") ? field.split(".")[0] : null;
+            if (fieldTable) {
+                // Joined field — check that the joined table exists in schema
+                const joinedTable = schema.tables.find((t) => t.name === fieldTable);
+                if (!joinedTable) {
+                    errors.push({
+                        code: "INVALID_SELECT_FIELD",
+                        message: `Table "${fieldTable}" referenced in select field "${field}" is not in schema.`,
+                        path: `select`,
+                    });
+                }
+                else if (!joinedTable.fields.find((f) => f.name === bareField)) {
+                    errors.push({
+                        code: "INVALID_SELECT_FIELD",
+                        message: `Field "${bareField}" does not exist in table "${fieldTable}".`,
+                        path: `select`,
+                    });
+                }
+            }
+            else if (!allFieldNames.has(field)) {
+                errors.push({
+                    code: "INVALID_SELECT_FIELD",
+                    message: `Field "${field}" does not exist in table "${query.source.name}".`,
+                    path: `select`,
+                });
+            }
+        }
+    }
+    // ─── Filters validation ─────────────────────────────────
+    if (query.filters) {
+        const validOps = new Set([
+            "eq",
+            "neq",
+            "gt",
+            "gte",
+            "lt",
+            "lte",
+            "in",
+            "contains",
+        ]);
+        for (let i = 0; i < query.filters.length; i++) {
+            const f = query.filters[i];
+            if (!allFieldNames.has(f.field)) {
+                errors.push({
+                    code: "INVALID_FILTER_FIELD",
+                    message: `Filter field "${f.field}" does not exist in table "${query.source.name}".`,
+                    path: `filters[${i}].field`,
+                });
+            }
+            if (!validOps.has(f.operator)) {
+                errors.push({
+                    code: "INVALID_FILTER_OPERATOR",
+                    message: `Invalid operator "${f.operator}".`,
+                    path: `filters[${i}].operator`,
+                });
+            }
+            if (f.value === undefined || f.value === null) {
+                errors.push({
+                    code: "MISSING_FILTER_VALUE",
+                    message: `Filter on "${f.field}" must have a value.`,
+                    path: `filters[${i}].value`,
+                });
+            }
+            if (f.operator === "in" && !Array.isArray(f.value)) {
+                errors.push({
+                    code: "INVALID_FILTER_VALUE",
+                    message: `Filter with "in" operator must have an array value.`,
+                    path: `filters[${i}].value`,
+                });
+            }
+        }
+    }
+    // ─── Sort validation ────────────────────────────────────
+    if (query.sort) {
+        if (!allFieldNames.has(query.sort.field)) {
+            errors.push({
+                code: "INVALID_SORT_FIELD",
+                message: `Sort field "${query.sort.field}" does not exist in table "${query.source.name}".`,
+                path: "sort.field",
+            });
+        }
+        if (!["asc", "desc"].includes(query.sort.direction)) {
+            errors.push({
+                code: "INVALID_SORT_DIRECTION",
+                message: `Sort direction must be "asc" or "desc".`,
+                path: "sort.direction",
+            });
+        }
+    }
+    // ─── Pagination validation ──────────────────────────────
+    if (query.pagination) {
+        if (typeof query.pagination.limit !== "number" ||
+            query.pagination.limit < 1) {
+            errors.push({
+                code: "INVALID_LIMIT",
+                message: `Pagination limit must be a positive number.`,
+                path: "pagination.limit",
+            });
+        }
+        else if (query.pagination.limit > types_1.MAX_LIMIT) {
+            errors.push({
+                code: "LIMIT_EXCEEDED",
+                message: `Pagination limit cannot exceed ${types_1.MAX_LIMIT}. Got ${query.pagination.limit}.`,
+                path: "pagination.limit",
+            });
+        }
+        if (query.pagination.offset !== undefined &&
+            (typeof query.pagination.offset !== "number" ||
+                query.pagination.offset < 0)) {
+            errors.push({
+                code: "INVALID_OFFSET",
+                message: `Pagination offset must be a non-negative number.`,
+                path: "pagination.offset",
+            });
+        }
+    }
+    // ─── Joins validation ───────────────────────────────────
+    if (query.joins) {
+        if (query.joins.length > types_1.MAX_JOINS) {
+            errors.push({
+                code: "MAX_JOINS_EXCEEDED",
+                message: `Maximum ${types_1.MAX_JOINS} joins allowed. Got ${query.joins.length}.`,
+                path: "joins",
+            });
+        }
+        const validRelations = sourceTable.relations || [];
+        for (let i = 0; i < query.joins.length; i++) {
+            const join = query.joins[i];
+            const joinTable = schema.tables.find((t) => t.name === join.table);
+            if (!joinTable) {
+                errors.push({
+                    code: "INVALID_JOIN_TABLE",
+                    message: `Join table "${join.table}" does not exist in schema.`,
+                    path: `joins[${i}].table`,
+                });
+                continue;
+            }
+            // Check that join relationship is pre-defined
+            const relationExists = validRelations.some((r) => r.table === join.table &&
+                r.localField === join.on.localField &&
+                r.foreignField === join.on.foreignField);
+            if (!relationExists) {
+                errors.push({
+                    code: "UNDEFINED_JOIN_RELATION",
+                    message: `Join relation from "${query.source.name}" to "${join.table}" (${join.on.localField} → ${join.on.foreignField}) is not defined in schema.`,
+                    path: `joins[${i}]`,
+                });
+            }
+            if (join.type && !["inner", "left"].includes(join.type)) {
+                errors.push({
+                    code: "INVALID_JOIN_TYPE",
+                    message: `Join type must be "inner" or "left".`,
+                    path: `joins[${i}].type`,
+                });
+            }
+        }
+    }
+    // ─── Aggregation validation ─────────────────────────────
+    if (query.aggregation) {
+        const validAggs = new Set(["count", "sum", "avg", "min", "max"]);
+        if (!validAggs.has(query.aggregation.type)) {
+            errors.push({
+                code: "INVALID_AGGREGATION_TYPE",
+                message: `Invalid aggregation type "${query.aggregation.type}".`,
+                path: "aggregation.type",
+            });
+        }
+        // For sum, avg, min, max — field is required and must be numeric
+        if (query.aggregation.type !== "count") {
+            if (!query.aggregation.field) {
+                errors.push({
+                    code: "MISSING_AGGREGATION_FIELD",
+                    message: `Aggregation type "${query.aggregation.type}" requires a field.`,
+                    path: "aggregation.field",
+                });
+            }
+            else {
+                const aggFieldMeta = sourceTable.fields.find((f) => f.name === query.aggregation.field);
+                if (!aggFieldMeta) {
+                    errors.push({
+                        code: "INVALID_AGGREGATION_FIELD",
+                        message: `Aggregation field "${query.aggregation.field}" does not exist in table "${query.source.name}".`,
+                        path: "aggregation.field",
+                    });
+                }
+                else if (!types_1.NUMERIC_TYPES.has(aggFieldMeta.type.toLowerCase())) {
+                    errors.push({
+                        code: "NON_NUMERIC_AGGREGATION",
+                        message: `Aggregation "${query.aggregation.type}" is only allowed on numeric fields. "${query.aggregation.field}" is of type "${aggFieldMeta.type}".`,
+                        path: "aggregation.field",
+                    });
+                }
+            }
+        }
+        if (query.aggregation.groupBy) {
+            if (!allFieldNames.has(query.aggregation.groupBy)) {
+                errors.push({
+                    code: "INVALID_GROUPBY_FIELD",
+                    message: `GroupBy field "${query.aggregation.groupBy}" does not exist in table "${query.source.name}".`,
+                    path: "aggregation.groupBy",
+                });
+            }
+        }
+    }
+    return errors;
+}
+/**
+ * Injects a mandatory tenant filter into the query.
+ * This is NOT exposed to the LLM — it's appended server-side.
+ */
+function injectTenantFilter(query, tenantField, userContext) {
+    const tenantFilter = {
+        field: tenantField,
+        operator: "eq",
+        value: userContext.orgId,
+    };
+    return {
+        ...query,
+        filters: [...(query.filters || []), tenantFilter],
+    };
+}
+/**
+ * Applies default pagination if not specified.
+ */
+function applyDefaults(query) {
+    return {
+        ...query,
+        pagination: query.pagination || {
+            limit: types_1.DEFAULT_LIMIT,
+            offset: 0,
+        },
+    };
+}
+//# sourceMappingURL=validator.js.map

package/dist/validator.js.map

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

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@databridgeai/core",
+  "version": "1.0.0",
+  "description": "Core types, validators, and database adapters for DataBridge AI",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsc -p tsconfig.json --watch"
+  },
+  "dependencies": {
+    "pg": "^8.11.3",
+    "mongodb": "^6.3.0"
+  },
+  "devDependencies": {
+    "@types/pg": "^8.10.9",
+    "typescript": "^5.3.3"
+  },
+  "files": ["dist", "README.md"],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/rishabhAgg/DataBridgeAI.git",
+    "directory": "packages/core"
+  },
+  "homepage": "https://github.com/rishabhAgg/DataBridgeAI#readme",
+  "keywords": ["databridgeai", "ai", "database", "query", "types", "validators"],
+  "license": "MIT"
+}