@reasoningco/infer 0.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 The Reasoning Company
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,42 @@
+# @reasoningco/infer
+
+TypeScript SDK that turns natural language questions into safe, parameterized SQL — powered by LLMs, locked down by an 8-layer security pipeline.
+
+## Install
+
+```bash
+npm install @reasoningco/infer
+```
+
+## Usage
+
+```ts
+import { Infer, PostgresConnector } from '@reasoningco/infer';
+
+const infer = new Infer({
+  connector: new PostgresConnector({
+    connectionString: process.env.DATABASE_URL,
+  }),
+  llm: { provider: 'openrouter', apiKey: process.env.LLM_API_KEY },
+  tenantId: 'tenant_123',
+});
+
+const result = await infer.ask('revenue by month last quarter');
+console.log(result.rows);
+
+await infer.close();
+```
+
+## Security
+
+Every query passes through 8 layers before touching your database:
+
+**Input validation** → **LLM planner** → **Plan validator** → **Entity resolver** → **SQL compiler** → **SQL validator** → **Secure executor** → **Result sanitizer**
+
+## LLM Providers
+
+OpenRouter, OpenAI, Anthropic, and Ollama supported out of the box.
+
+## License
+
+MIT — see [LICENSE](./LICENSE)

package/dist/catalog.d.ts

@@ -0,0 +1,39 @@
+import type { InferCatalog, IntrospectedSchema } from './types.js';
+export interface YAMLSchema {
+    datasources: Record<string, YAMLDatasource>;
+}
+export interface YAMLDatasource {
+    table: string;
+    date_column?: string;
+    estimated_rows?: number;
+    description?: string;
+    columns?: YAMLColumn[];
+    metrics?: YAMLMetric[];
+    sensitive?: string[];
+    joins?: YAMLJoin[];
+}
+export interface YAMLColumn {
+    name: string;
+    type?: string;
+    description?: string;
+    semantic?: string;
+    groupable?: boolean;
+    filterable?: boolean;
+    values?: string[];
+    references?: string;
+}
+export interface YAMLMetric {
+    id: string;
+    expression: string;
+    description?: string;
+}
+export interface YAMLJoin {
+    table: string;
+    local_column: string;
+    foreign_column: string;
+    type?: "one_to_one" | "one_to_many" | "many_to_one" | "many_to_many";
+}
+export declare function loadCatalogFromYAML(yaml: YAMLSchema): InferCatalog;
+export declare function buildCatalogFromIntrospection(schema: IntrospectedSchema): InferCatalog;
+export declare function mergeCatalogs(yamlCatalog: InferCatalog, introspected: InferCatalog): InferCatalog;
+//# sourceMappingURL=catalog.d.ts.map

package/dist/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAyE,kBAAkB,EAAqB,MAAM,YAAY,CAAC;AAI7J,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC;IACvB,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,YAAY,GAAG,aAAa,GAAG,aAAa,GAAG,cAAc,CAAC;CACtE;AAGD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,UAAU,GAAG,YAAY,CAkGlE;AAGD,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,kBAAkB,GAAG,YAAY,CA4FtF;AAGD,wBAAgB,aAAa,CAAC,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,GAAG,YAAY,CAuBjG"}

package/dist/catalog.js

@@ -0,0 +1,249 @@
+import { InferError } from './errors.js';
+import { validateMetricExpression } from './sql-validator.js';
+// ── Load from YAML object ──
+export function loadCatalogFromYAML(yaml) {
+    const datasets = {};
+    for (const [id, ds] of Object.entries(yaml.datasources)) {
+        // Parse table reference
+        const tableParts = ds.table.split('.');
+        const schema = tableParts.length > 1 ? tableParts[0] : 'public';
+        const tableName = tableParts.length > 1 ? tableParts[1] : tableParts[0];
+        // Build columns
+        const selectableColumns = [];
+        const filterableColumns = [];
+        const columnTypes = {};
+        const dimensions = [];
+        const entities = [];
+        if (ds.columns) {
+            for (const col of ds.columns) {
+                selectableColumns.push(col.name);
+                if (col.filterable !== false) {
+                    filterableColumns.push(col.name);
+                }
+                columnTypes[col.name] = mapYAMLType(col.type ?? 'text');
+                if (col.groupable) {
+                    dimensions.push({
+                        column: col.name,
+                        label: col.description ?? col.name,
+                        groupable: true,
+                    });
+                }
+                // Auto-detect entities from references
+                if (col.references) {
+                    entities.push({
+                        key: col.name,
+                        column: col.name,
+                        label: col.description ?? col.name,
+                    });
+                }
+            }
+        }
+        // Build metrics with validation
+        const metrics = [];
+        if (ds.metrics) {
+            for (const m of ds.metrics) {
+                // Validate metric expression at load time (security)
+                if (!validateMetricExpression(m.expression)) {
+                    throw new InferError('PLAN_INVALID', 'validator', `Invalid metric expression in ${id}.${m.id}: ${m.expression}`);
+                }
+                metrics.push({
+                    id: m.id,
+                    label: m.description ?? m.id,
+                    expression: m.expression,
+                    sourceColumns: extractColumnsFromExpression(m.expression),
+                    agg: detectAggregation(m.expression),
+                    description: m.description ?? '',
+                });
+            }
+        }
+        // Build joins (structured, no raw SQL)
+        const joins = [];
+        if (ds.joins) {
+            for (const j of ds.joins) {
+                joins.push({
+                    table: j.table,
+                    localColumn: j.local_column,
+                    foreignColumn: j.foreign_column,
+                    type: j.type ?? 'many_to_one',
+                });
+            }
+        }
+        datasets[id] = {
+            id,
+            table: { schema, name: tableName },
+            dateColumn: ds.date_column ?? '',
+            estimatedRows: ds.estimated_rows,
+            selectableColumns,
+            filterableColumns,
+            sensitiveColumns: ds.sensitive ?? [],
+            columnTypes,
+            entities,
+            dimensions,
+            metrics,
+            timeConfig: {
+                defaultMode: ds.date_column ? 'optional' : 'none',
+                allowedModes: ds.date_column ? ['required', 'optional', 'latest', 'none', 'relative', 'absolute'] : ['none'],
+            },
+            joins: joins.length > 0 ? joins : undefined,
+            description: ds.description,
+        };
+    }
+    return { datasets };
+}
+// ── Build catalog from introspected schema ──
+export function buildCatalogFromIntrospection(schema) {
+    const datasets = {};
+    for (const table of schema.tables) {
+        const id = table.name;
+        const selectableColumns = table.columns.map(c => c.name);
+        const filterableColumns = table.columns.map(c => c.name);
+        const columnTypes = {};
+        const dimensions = [];
+        const metrics = [];
+        let dateColumn = '';
+        for (const col of table.columns) {
+            columnTypes[col.name] = inferColumnType(col.typeCategory, col.dataType);
+            // Phase 3: Semantics - auto-detect
+            const ct = columnTypes[col.name];
+            // Auto-detect date column
+            if ((ct === 'date' || ct === 'timestamp') && !dateColumn) {
+                if (/created|updated|date|time|at$/i.test(col.name)) {
+                    dateColumn = col.name;
+                }
+            }
+            // Auto-detect groupable dimensions (low cardinality text/enum)
+            if (ct === 'text' && !col.name.endsWith('_id') && !col.name.endsWith('id')) {
+                dimensions.push({
+                    column: col.name,
+                    label: col.name.replace(/_/g, ' '),
+                    groupable: true,
+                });
+            }
+            // Auto-detect metrics (numeric columns)
+            if (ct === 'numeric' && !col.name.endsWith('_id') && col.name !== 'id') {
+                metrics.push({
+                    id: `total_${col.name}`,
+                    label: `Total ${col.name.replace(/_/g, ' ')}`,
+                    expression: `SUM(${col.name})`,
+                    sourceColumns: [col.name],
+                    agg: 'sum',
+                    description: `Sum of ${col.name}`,
+                });
+                metrics.push({
+                    id: `avg_${col.name}`,
+                    label: `Average ${col.name.replace(/_/g, ' ')}`,
+                    expression: `AVG(${col.name})`,
+                    sourceColumns: [col.name],
+                    agg: 'avg',
+                    description: `Average of ${col.name}`,
+                });
+            }
+        }
+        // Always add row count metric
+        metrics.push({
+            id: 'row_count',
+            label: 'Row count',
+            expression: 'COUNT(*)',
+            sourceColumns: [],
+            agg: 'count',
+            description: 'Number of rows',
+        });
+        // Build entity refs from foreign keys
+        const entities = table.foreignKeys.map(fk => ({
+            key: fk.column,
+            column: fk.column,
+            label: fk.column.replace(/_id$/, '').replace(/_/g, ' '),
+        }));
+        datasets[id] = {
+            id,
+            table: { schema: table.schema, name: table.name },
+            dateColumn,
+            estimatedRows: table.estimatedRows,
+            selectableColumns,
+            filterableColumns,
+            sensitiveColumns: [],
+            columnTypes,
+            entities,
+            dimensions,
+            metrics,
+            timeConfig: {
+                defaultMode: dateColumn ? 'optional' : 'none',
+                allowedModes: dateColumn ? ['required', 'optional', 'latest', 'none', 'relative', 'absolute'] : ['none'],
+            },
+        };
+    }
+    return { datasets };
+}
+// ── Merge YAML catalog with introspected data (hybrid mode) ──
+export function mergeCatalogs(yamlCatalog, introspected) {
+    const merged = { ...introspected.datasets };
+    // YAML overrides introspected
+    for (const [id, yamlDs] of Object.entries(yamlCatalog.datasets)) {
+        if (merged[id]) {
+            // Merge: YAML takes priority for explicit fields
+            merged[id] = {
+                ...merged[id],
+                ...yamlDs,
+                // Merge metrics (YAML adds to introspected)
+                metrics: [...yamlDs.metrics, ...merged[id].metrics.filter(m => !yamlDs.metrics.some(ym => ym.id === m.id))],
+                // YAML sensitive columns override
+                sensitiveColumns: yamlDs.sensitiveColumns.length > 0 ? yamlDs.sensitiveColumns : merged[id].sensitiveColumns,
+            };
+        }
+        else {
+            merged[id] = yamlDs;
+        }
+    }
+    return { datasets: merged };
+}
+// ── Helpers ──
+function mapYAMLType(type) {
+    const t = type.toLowerCase();
+    if (['int', 'integer', 'float', 'double', 'decimal', 'numeric', 'real', 'bigint', 'smallint'].includes(t))
+        return 'numeric';
+    if (['date'].includes(t))
+        return 'date';
+    if (['timestamp', 'timestamptz', 'datetime'].includes(t))
+        return 'timestamp';
+    if (['bool', 'boolean'].includes(t))
+        return 'boolean';
+    if (['json', 'jsonb'].includes(t))
+        return 'json';
+    return 'text';
+}
+function inferColumnType(typeCategory, dataType) {
+    switch (typeCategory) {
+        case 'N': return 'numeric';
+        case 'D': return dataType.includes('date') ? 'date' : 'timestamp';
+        case 'B': return 'boolean';
+        default: {
+            if (dataType.includes('json'))
+                return 'json';
+            return 'text';
+        }
+    }
+}
+function extractColumnsFromExpression(expr) {
+    const match = expr.match(/\(([^)]+)\)/);
+    if (!match)
+        return [];
+    const inner = match[1].trim();
+    if (inner === '*')
+        return [];
+    return [inner];
+}
+function detectAggregation(expr) {
+    const upper = expr.toUpperCase().trim();
+    if (upper.startsWith('SUM'))
+        return 'sum';
+    if (upper.startsWith('AVG'))
+        return 'avg';
+    if (upper.startsWith('COUNT'))
+        return 'count';
+    if (upper.startsWith('MIN'))
+        return 'min';
+    if (upper.startsWith('MAX'))
+        return 'max';
+    return 'sum';
+}
+//# sourceMappingURL=catalog.js.map

package/dist/catalog.js.map

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

package/dist/connectors.d.ts

@@ -0,0 +1,63 @@
+import type { InferConnector, ColumnMeta, IntrospectedSchema } from './types.js';
+export interface PostgresConnectorConfig {
+    connectionString?: string;
+    host?: string;
+    port?: number;
+    database?: string;
+    user?: string;
+    password?: string;
+    ssl?: boolean | object;
+    max?: number;
+    statementTimeout?: string;
+}
+export declare class PostgresConnector implements InferConnector {
+    private pool;
+    private config;
+    constructor(config: PostgresConnectorConfig);
+    private getPool;
+    execute(sql: string, params: unknown[]): Promise<{
+        rows: Record<string, unknown>[];
+        columns: ColumnMeta[];
+    }>;
+    introspect(): Promise<IntrospectedSchema>;
+    close(): Promise<void>;
+}
+export interface HTTPConnectorConfig {
+    endpoint: string;
+    headers?: Record<string, string>;
+}
+export declare class HTTPConnector implements InferConnector {
+    private config;
+    constructor(config: HTTPConnectorConfig);
+    execute(sql: string, params: unknown[]): Promise<{
+        rows: Record<string, unknown>[];
+        columns: ColumnMeta[];
+    }>;
+    introspect(): Promise<IntrospectedSchema>;
+    close(): Promise<void>;
+}
+export declare class SupabaseConnector implements InferConnector {
+    constructor(_config: {
+        projectUrl: string;
+        anonKey: string;
+    });
+    execute(): Promise<{
+        rows: Record<string, unknown>[];
+        columns: ColumnMeta[];
+    }>;
+    introspect(): Promise<IntrospectedSchema>;
+    close(): Promise<void>;
+}
+export declare class LambdaConnector implements InferConnector {
+    constructor(_config: {
+        functionArn: string;
+        region?: string;
+    });
+    execute(): Promise<{
+        rows: Record<string, unknown>[];
+        columns: ColumnMeta[];
+    }>;
+    introspect(): Promise<IntrospectedSchema>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=connectors.d.ts.map

package/dist/connectors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connectors.d.ts","sourceRoot":"","sources":["../src/connectors.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,kBAAkB,EAAyC,MAAM,YAAY,CAAC;AAGxH,MAAM,WAAW,uBAAuB;IACtC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,qBAAa,iBAAkB,YAAW,cAAc;IACtD,OAAO,CAAC,IAAI,CAAM;IAClB,OAAO,CAAC,MAAM,CAA0B;gBAE5B,MAAM,EAAE,uBAAuB;YAQ7B,OAAO;IAuBf,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;QAAC,OAAO,EAAE,UAAU,EAAE,CAAA;KAAE,CAAC;IAoC5G,UAAU,IAAI,OAAO,CAAC,kBAAkB,CAAC;IA+GzC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAM7B;AAGD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,qBAAa,aAAc,YAAW,cAAc;IAClD,OAAO,CAAC,MAAM,CAAsB;gBAExB,MAAM,EAAE,mBAAmB;IAIjC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;QAAC,OAAO,EAAE,UAAU,EAAE,CAAA;KAAE,CAAC;IAe5G,UAAU,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAczC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAC7B;AAGD,qBAAa,iBAAkB,YAAW,cAAc;gBAC1C,OAAO,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;IAGtD,OAAO,IAAI,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;QAAC,OAAO,EAAE,UAAU,EAAE,CAAA;KAAE,CAAC;IAG9E,UAAU,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAGzC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAC7B;AAGD,qBAAa,eAAgB,YAAW,cAAc;gBACxC,OAAO,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;IAGvD,OAAO,IAAI,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;QAAC,OAAO,EAAE,UAAU,EAAE,CAAA;KAAE,CAAC;IAG9E,UAAU,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAGzC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAC7B"}