@reasoningco/infer 0.0.2

package/dist/connectors.js

@@ -0,0 +1,263 @@
+import { InferError } from './errors.js';
+export class PostgresConnector {
+    pool; // pg.Pool - lazy loaded
+    config;
+    constructor(config) {
+        // Browser environment guard
+        if (typeof window !== 'undefined') {
+            throw new Error('PostgresConnector cannot run in a browser. Use HTTPConnector or a server-side API proxy.');
+        }
+        this.config = config;
+    }
+    async getPool() {
+        if (!this.pool) {
+            try {
+                // Dynamic import - pg is an optional peer dependency
+                const pg = await (Function('return import("pg")')());
+                const Pool = pg.default?.Pool || pg.Pool;
+                this.pool = new Pool({
+                    connectionString: this.config.connectionString,
+                    host: this.config.host,
+                    port: this.config.port,
+                    database: this.config.database,
+                    user: this.config.user,
+                    password: this.config.password,
+                    ssl: this.config.ssl,
+                    max: this.config.max ?? 10,
+                });
+            }
+            catch {
+                throw new InferError('CONNECTION_ERROR', 'executor', 'pg package is not installed. Run: npm install pg');
+            }
+        }
+        return this.pool;
+    }
+    async execute(sql, params) {
+        const pool = await this.getPool();
+        const client = await pool.connect();
+        try {
+            // Secure execution: read-only transaction with timeout
+            await client.query('BEGIN');
+            await client.query('SET TRANSACTION READ ONLY');
+            if (this.config.statementTimeout) {
+                const timeout = String(this.config.statementTimeout);
+                if (!/^\d+(ms|s|min)?$/.test(timeout)) {
+                    throw new Error(`Invalid statementTimeout value: ${timeout}`);
+                }
+                await client.query(`SET LOCAL statement_timeout = '${timeout}'`);
+            }
+            const result = await client.query(sql, params);
+            await client.query('COMMIT');
+            const columns = result.fields?.map((f) => ({
+                name: f.name,
+                type: pgTypeToColumnType(f.dataTypeID),
+            })) ?? [];
+            return { rows: result.rows, columns };
+        }
+        catch (error) {
+            await client.query('ROLLBACK').catch(() => { });
+            if (error?.code === '57014') {
+                throw new InferError('QUERY_TIMEOUT', 'executor', 'Statement timeout exceeded');
+            }
+            if (error instanceof InferError)
+                throw error;
+            throw new InferError('QUERY_ERROR', 'executor', 'Database query failed');
+        }
+        finally {
+            client.release();
+        }
+    }
+    async introspect() {
+        const pool = await this.getPool();
+        const client = await pool.connect();
+        try {
+            // Phase 1: Structure
+            const structureQuery = `
+        SELECT
+          n.nspname AS schema_name, c.relname AS table_name,
+          a.attname AS column_name,
+          pg_catalog.format_type(a.atttypid, a.atttypmod) AS data_type,
+          t.typcategory,
+          a.attnotnull AS not_null,
+          pg_get_expr(d.adbin, d.adrelid) AS default_value,
+          col_description(a.attrelid, a.attnum) AS column_comment,
+          c.reltuples::bigint AS estimated_rows
+        FROM pg_catalog.pg_class c
+        JOIN pg_catalog.pg_namespace n ON n.oid = c.relnamespace
+        JOIN pg_catalog.pg_attribute a ON a.attrelid = c.oid
+        JOIN pg_catalog.pg_type t ON t.oid = a.atttypid
+        LEFT JOIN pg_catalog.pg_attrdef d ON d.adrelid = c.oid AND d.adnum = a.attnum
+        WHERE c.relkind IN ('r','v','m')
+          AND n.nspname NOT IN ('pg_catalog','information_schema','pg_toast')
+          AND a.attnum > 0 AND NOT a.attisdropped
+          AND has_table_privilege(c.oid, 'SELECT')
+        ORDER BY n.nspname, c.relname, a.attnum;
+      `;
+            const { rows } = await client.query(structureQuery);
+            // Phase 1b: Foreign keys
+            const fkQuery = `
+        SELECT
+          n.nspname AS schema_name,
+          c.relname AS table_name,
+          a.attname AS column_name,
+          fn.nspname AS foreign_schema,
+          fc.relname AS foreign_table,
+          fa.attname AS foreign_column
+        FROM pg_catalog.pg_constraint con
+        JOIN pg_catalog.pg_class c ON c.oid = con.conrelid
+        JOIN pg_catalog.pg_namespace n ON n.oid = c.relnamespace
+        JOIN pg_catalog.pg_attribute a ON a.attrelid = c.oid AND a.attnum = ANY(con.conkey)
+        JOIN pg_catalog.pg_class fc ON fc.oid = con.confrelid
+        JOIN pg_catalog.pg_namespace fn ON fn.oid = fc.relnamespace
+        JOIN pg_catalog.pg_attribute fa ON fa.attrelid = fc.oid AND fa.attnum = ANY(con.confkey)
+        WHERE con.contype = 'f'
+          AND n.nspname NOT IN ('pg_catalog','information_schema');
+      `;
+            const fkResult = await client.query(fkQuery);
+            // Phase 1c: Enums
+            const enumQuery = `
+        SELECT t.typname, e.enumlabel
+        FROM pg_catalog.pg_type t
+        JOIN pg_catalog.pg_enum e ON t.oid = e.enumtypid
+        ORDER BY t.typname, e.enumsortorder;
+      `;
+            const enumResult = await client.query(enumQuery);
+            // Build schema
+            const tableMap = new Map();
+            for (const row of rows) {
+                const key = `${row.schema_name}.${row.table_name}`;
+                if (!tableMap.has(key)) {
+                    tableMap.set(key, {
+                        schema: row.schema_name,
+                        name: row.table_name,
+                        columns: [],
+                        estimatedRows: Number(row.estimated_rows) || 0,
+                        foreignKeys: [],
+                        indexes: [],
+                    });
+                }
+                tableMap.get(key).columns.push({
+                    name: row.column_name,
+                    dataType: row.data_type,
+                    typeCategory: row.typcategory,
+                    notNull: row.not_null,
+                    defaultValue: row.default_value,
+                    comment: row.column_comment,
+                });
+            }
+            // Add foreign keys
+            for (const fk of fkResult.rows) {
+                const key = `${fk.schema_name}.${fk.table_name}`;
+                const table = tableMap.get(key);
+                if (table) {
+                    table.foreignKeys.push({
+                        column: fk.column_name,
+                        foreignTable: `${fk.foreign_schema}.${fk.foreign_table}`,
+                        foreignColumn: fk.foreign_column,
+                    });
+                }
+            }
+            // Build enums
+            const enums = {};
+            for (const row of enumResult.rows) {
+                if (!enums[row.typname])
+                    enums[row.typname] = [];
+                enums[row.typname].push(row.enumlabel);
+            }
+            return {
+                tables: Array.from(tableMap.values()),
+                enums,
+            };
+        }
+        finally {
+            client.release();
+        }
+    }
+    async close() {
+        if (this.pool) {
+            await this.pool.end();
+            this.pool = null;
+        }
+    }
+}
+export class HTTPConnector {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    async execute(sql, params) {
+        const response = await fetch(this.config.endpoint, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                ...this.config.headers,
+            },
+            body: JSON.stringify({ sql, params }),
+        });
+        if (!response.ok) {
+            throw new InferError('QUERY_ERROR', 'executor', `HTTP ${response.status}: ${response.statusText}`);
+        }
+        return response.json();
+    }
+    async introspect() {
+        const response = await fetch(`${this.config.endpoint}/introspect`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                ...this.config.headers,
+            },
+        });
+        if (!response.ok) {
+            throw new InferError('CONNECTION_ERROR', 'executor', 'Introspection failed');
+        }
+        return response.json();
+    }
+    async close() { }
+}
+// ── SupabaseConnector (stub) ──
+export class SupabaseConnector {
+    constructor(_config) {
+        // Stub — full implementation in future release
+    }
+    async execute() {
+        throw new InferError('CONNECTION_ERROR', 'executor', 'SupabaseConnector is not yet implemented');
+    }
+    async introspect() {
+        throw new InferError('CONNECTION_ERROR', 'executor', 'SupabaseConnector is not yet implemented');
+    }
+    async close() { }
+}
+// ── LambdaConnector (stub) ──
+export class LambdaConnector {
+    constructor(_config) {
+        // Stub — full implementation in future release
+    }
+    async execute() {
+        throw new InferError('CONNECTION_ERROR', 'executor', 'LambdaConnector is not yet implemented');
+    }
+    async introspect() {
+        throw new InferError('CONNECTION_ERROR', 'executor', 'LambdaConnector is not yet implemented');
+    }
+    async close() { }
+}
+// ── Helpers ──
+function pgTypeToColumnType(oid) {
+    // Common PostgreSQL OIDs
+    const numericTypes = new Set([20, 21, 23, 26, 700, 701, 790, 1700]);
+    const dateTypes = new Set([1082]);
+    const timestampTypes = new Set([1114, 1184]);
+    const boolType = 16;
+    const jsonTypes = new Set([114, 3802]);
+    if (numericTypes.has(oid))
+        return 'numeric';
+    if (dateTypes.has(oid))
+        return 'date';
+    if (timestampTypes.has(oid))
+        return 'timestamp';
+    if (oid === boolType)
+        return 'boolean';
+    if (jsonTypes.has(oid))
+        return 'json';
+    return 'text';
+}
+//# sourceMappingURL=connectors.js.map

package/dist/connectors.js.map

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

package/dist/dates.d.ts

@@ -0,0 +1,35 @@
+export declare const RELATIVE_PHRASES: readonly ["today", "yesterday", "tomorrow", "this week", "last week", "next week", "last 7 days", "next 7 days", "last 30 days", "next 30 days", "this month", "last month", "next month", "this year", "last year"];
+export type RelativeDatePhrase = (typeof RELATIVE_PHRASES)[number] | `last ${number} days` | `next ${number} days` | `last ${number} weeks` | `next ${number} weeks` | `last ${number} months` | `next ${number} months`;
+export declare function formatDateISO(d: Date): string;
+export declare function startOfLocalDay(d: Date): Date;
+export declare function addDays(d: Date, n: number): Date;
+export declare function startOfWeekMonday(d: Date): Date;
+export declare function startOfMonth(d: Date): Date;
+export declare function endOfMonth(d: Date): Date;
+export declare function tryDynamicMatch(phrase: string, now: Date): {
+    start: Date;
+    end: Date;
+} | null;
+export declare function detectRelativePhrase(text: string): RelativeDatePhrase | null;
+export type ComputedRange = {
+    startISO: string;
+    endISO: string;
+    start: Date;
+    end: Date;
+};
+export declare function computeRelativeRange(phrase: RelativeDatePhrase | string, now: Date): ComputedRange;
+export declare function resolveDateRange(options: {
+    startDate?: string;
+    endDate?: string;
+    phrase?: string;
+    now?: Date;
+}): {
+    startDate: string;
+    endDate: string;
+} | null;
+export declare function parseRelativeDateRange(question: string, now?: Date): {
+    startDate: string;
+    endDate: string;
+    phrase: string;
+} | null;
+//# sourceMappingURL=dates.d.ts.map

package/dist/dates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dates.d.ts","sourceRoot":"","sources":["../src/dates.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,gBAAgB,sNAgBnB,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAC1B,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,GACjC,QAAQ,MAAM,OAAO,GACrB,QAAQ,MAAM,OAAO,GACrB,QAAQ,MAAM,QAAQ,GACtB,QAAQ,MAAM,QAAQ,GACtB,QAAQ,MAAM,SAAS,GACvB,QAAQ,MAAM,SAAS,CAAC;AAI5B,wBAAgB,aAAa,CAAC,CAAC,EAAE,IAAI,GAAG,MAAM,CAK7C;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,IAAI,GAAG,IAAI,CAE7C;AAED,wBAAgB,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAIhD;AAED,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,IAAI,GAAG,IAAI,CAI/C;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,IAAI,GAAG,IAAI,CAE1C;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,IAAI,GAAG,IAAI,CAExC;AAyLD,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,IAAI,GACR;IAAE,KAAK,EAAE,IAAI,CAAC;IAAC,GAAG,EAAE,IAAI,CAAA;CAAE,GAAG,IAAI,CASnC;AAID,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI,CAoB5E;AAID,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,IAAI,CAAC;IACZ,GAAG,EAAE,IAAI,CAAC;CACX,CAAC;AAEF,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,kBAAkB,GAAG,MAAM,EACnC,GAAG,EAAE,IAAI,GACR,aAAa,CAmCf;AAID,wBAAgB,gBAAgB,CAAC,OAAO,EAAE;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAYhD;AAID,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,GAAG,CAAC,EAAE,IAAI,GACT;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAK/D"}

package/dist/dates.js

@@ -0,0 +1,293 @@
+// ── Relative date phrases ──
+export const RELATIVE_PHRASES = [
+    "today",
+    "yesterday",
+    "tomorrow",
+    "this week",
+    "last week",
+    "next week",
+    "last 7 days",
+    "next 7 days",
+    "last 30 days",
+    "next 30 days",
+    "this month",
+    "last month",
+    "next month",
+    "this year",
+    "last year",
+];
+// ── Helper functions ──
+export function formatDateISO(d) {
+    const y = d.getFullYear();
+    const m = String(d.getMonth() + 1).padStart(2, "0");
+    const day = String(d.getDate()).padStart(2, "0");
+    return `${y}-${m}-${day}`;
+}
+export function startOfLocalDay(d) {
+    return new Date(d.getFullYear(), d.getMonth(), d.getDate());
+}
+export function addDays(d, n) {
+    const result = new Date(d);
+    result.setDate(result.getDate() + n);
+    return result;
+}
+export function startOfWeekMonday(d) {
+    const day = d.getDay();
+    const diff = day === 0 ? -6 : 1 - day;
+    return addDays(startOfLocalDay(d), diff);
+}
+export function startOfMonth(d) {
+    return new Date(d.getFullYear(), d.getMonth(), 1);
+}
+export function endOfMonth(d) {
+    return new Date(d.getFullYear(), d.getMonth() + 1, 0);
+}
+const RELATIVE_RULES = [
+    {
+        phrase: "today",
+        compute: (now) => {
+            const s = startOfLocalDay(now);
+            return { start: s, end: s };
+        },
+    },
+    {
+        phrase: "yesterday",
+        compute: (now) => {
+            const s = addDays(startOfLocalDay(now), -1);
+            return { start: s, end: s };
+        },
+    },
+    {
+        phrase: "tomorrow",
+        compute: (now) => {
+            const s = addDays(startOfLocalDay(now), 1);
+            return { start: s, end: s };
+        },
+    },
+    {
+        phrase: "this week",
+        compute: (now) => {
+            const s = startOfWeekMonday(now);
+            const e = addDays(s, 6);
+            return { start: s, end: e };
+        },
+    },
+    {
+        phrase: "last week",
+        compute: (now) => {
+            const s = addDays(startOfWeekMonday(now), -7);
+            const e = addDays(s, 6);
+            return { start: s, end: e };
+        },
+    },
+    {
+        phrase: "next week",
+        compute: (now) => {
+            const s = addDays(startOfWeekMonday(now), 7);
+            const e = addDays(s, 6);
+            return { start: s, end: e };
+        },
+    },
+    {
+        phrase: "last 7 days",
+        compute: (now) => {
+            const today = startOfLocalDay(now);
+            return { start: addDays(today, -6), end: today };
+        },
+    },
+    {
+        phrase: "next 7 days",
+        compute: (now) => {
+            const today = startOfLocalDay(now);
+            return { start: today, end: addDays(today, 6) };
+        },
+    },
+    {
+        phrase: "last 30 days",
+        compute: (now) => {
+            const today = startOfLocalDay(now);
+            return { start: addDays(today, -29), end: today };
+        },
+    },
+    {
+        phrase: "next 30 days",
+        compute: (now) => {
+            const today = startOfLocalDay(now);
+            return { start: today, end: addDays(today, 29) };
+        },
+    },
+    {
+        phrase: "this month",
+        compute: (now) => {
+            return { start: startOfMonth(now), end: endOfMonth(now) };
+        },
+    },
+    {
+        phrase: "last month",
+        compute: (now) => {
+            const prev = new Date(now.getFullYear(), now.getMonth() - 1, 1);
+            return { start: startOfMonth(prev), end: endOfMonth(prev) };
+        },
+    },
+    {
+        phrase: "next month",
+        compute: (now) => {
+            const next = new Date(now.getFullYear(), now.getMonth() + 1, 1);
+            return { start: startOfMonth(next), end: endOfMonth(next) };
+        },
+    },
+    {
+        phrase: "this year",
+        compute: (now) => {
+            return {
+                start: new Date(now.getFullYear(), 0, 1),
+                end: new Date(now.getFullYear(), 11, 31),
+            };
+        },
+    },
+    {
+        phrase: "last year",
+        compute: (now) => {
+            const y = now.getFullYear() - 1;
+            return { start: new Date(y, 0, 1), end: new Date(y, 11, 31) };
+        },
+    },
+];
+// ── Dynamic patterns ──
+const DYNAMIC_PAST_DAYS = /^last (\d+) days?$/i;
+const DYNAMIC_FUTURE_DAYS = /^next (\d+) days?$/i;
+const DYNAMIC_PAST_WEEKS = /^last (\d+) weeks?$/i;
+const DYNAMIC_FUTURE_WEEKS = /^next (\d+) weeks?$/i;
+const DYNAMIC_PAST_MONTHS = /^last (\d+) months?$/i;
+const DYNAMIC_FUTURE_MONTHS = /^next (\d+) months?$/i;
+const DYNAMIC_PATTERNS = [
+    {
+        regex: DYNAMIC_PAST_DAYS,
+        compute: (n, now) => {
+            const today = startOfLocalDay(now);
+            return { start: addDays(today, -(n - 1)), end: today };
+        },
+    },
+    {
+        regex: DYNAMIC_FUTURE_DAYS,
+        compute: (n, now) => {
+            const today = startOfLocalDay(now);
+            return { start: today, end: addDays(today, n - 1) };
+        },
+    },
+    {
+        regex: DYNAMIC_PAST_WEEKS,
+        compute: (n, now) => {
+            const monday = startOfWeekMonday(now);
+            return { start: addDays(monday, -7 * n), end: addDays(monday, -1) };
+        },
+    },
+    {
+        regex: DYNAMIC_FUTURE_WEEKS,
+        compute: (n, now) => {
+            const monday = startOfWeekMonday(now);
+            const nextMonday = addDays(monday, 7);
+            return { start: nextMonday, end: addDays(nextMonday, 7 * n - 1) };
+        },
+    },
+    {
+        regex: DYNAMIC_PAST_MONTHS,
+        compute: (n, now) => {
+            const s = new Date(now.getFullYear(), now.getMonth() - n, 1);
+            const e = new Date(now.getFullYear(), now.getMonth(), 0);
+            return { start: s, end: e };
+        },
+    },
+    {
+        regex: DYNAMIC_FUTURE_MONTHS,
+        compute: (n, now) => {
+            const s = new Date(now.getFullYear(), now.getMonth() + 1, 1);
+            const e = new Date(now.getFullYear(), now.getMonth() + 1 + n, 0);
+            return { start: s, end: e };
+        },
+    },
+];
+// ── Dynamic match ──
+export function tryDynamicMatch(phrase, now) {
+    for (const { regex, compute } of DYNAMIC_PATTERNS) {
+        const m = phrase.match(regex);
+        if (m) {
+            const n = parseInt(m[1], 10);
+            if (n > 0)
+                return compute(n, now);
+        }
+    }
+    return null;
+}
+// ── Detect a relative phrase in freeform text ──
+export function detectRelativePhrase(text) {
+    const lower = text.toLowerCase().trim();
+    // Check static phrases (longest first to prefer "last 30 days" over "last 7 days")
+    const sorted = [...RELATIVE_PHRASES].sort((a, b) => b.length - a.length);
+    for (const phrase of sorted) {
+        if (lower.includes(phrase)) {
+            return phrase;
+        }
+    }
+    // Check dynamic patterns
+    for (const { regex } of DYNAMIC_PATTERNS) {
+        const m = lower.match(regex);
+        if (m) {
+            return m[0];
+        }
+    }
+    return null;
+}
+export function computeRelativeRange(phrase, now) {
+    const lower = phrase.toLowerCase().trim();
+    // Check static rules first
+    for (const rule of RELATIVE_RULES) {
+        if (rule.phrase === lower) {
+            const { start, end } = rule.compute(now);
+            return {
+                start,
+                end,
+                startISO: formatDateISO(start),
+                endISO: formatDateISO(end),
+            };
+        }
+    }
+    // Check dynamic patterns
+    const dynamic = tryDynamicMatch(lower, now);
+    if (dynamic) {
+        return {
+            start: dynamic.start,
+            end: dynamic.end,
+            startISO: formatDateISO(dynamic.start),
+            endISO: formatDateISO(dynamic.end),
+        };
+    }
+    // Fallback: treat as today
+    const today = startOfLocalDay(now);
+    return {
+        start: today,
+        end: today,
+        startISO: formatDateISO(today),
+        endISO: formatDateISO(today),
+    };
+}
+// ── Resolve a date range from explicit dates or a phrase ──
+export function resolveDateRange(options) {
+    if (options.startDate && options.endDate) {
+        return { startDate: options.startDate, endDate: options.endDate };
+    }
+    if (options.phrase) {
+        const range = computeRelativeRange(options.phrase, options.now ?? new Date());
+        return { startDate: range.startISO, endDate: range.endISO };
+    }
+    return null;
+}
+// ── Parse a relative date range from a natural-language question ──
+export function parseRelativeDateRange(question, now) {
+    const phrase = detectRelativePhrase(question);
+    if (!phrase)
+        return null;
+    const range = computeRelativeRange(phrase, now ?? new Date());
+    return { startDate: range.startISO, endDate: range.endISO, phrase };
+}
+//# sourceMappingURL=dates.js.map

package/dist/dates.js.map

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

package/dist/entity-resolver.d.ts

@@ -0,0 +1,29 @@
+import type { SmartEntityFilter, ResolvedEntity, InferConnector } from './types.js';
+export interface EntityResolver {
+    resolve(input: string, tenantId: string): Promise<ResolvedEntity>;
+}
+export declare class EntityResolverRegistry {
+    private resolvers;
+    register(name: string, resolver: EntityResolver): void;
+    get(name: string): EntityResolver | undefined;
+    has(name: string): boolean;
+    resolveAll(entityFilters: SmartEntityFilter[], tenantId: string): Promise<ResolvedEntity[]>;
+}
+export declare class DatabaseEntityResolver implements EntityResolver {
+    private connector;
+    private tableName;
+    private idColumn;
+    private nameColumn;
+    private tenantScoped;
+    private resolverName;
+    constructor(config: {
+        connector: InferConnector;
+        tableName: string;
+        idColumn: string;
+        nameColumn: string;
+        resolverName: string;
+        tenantScoped?: boolean;
+    });
+    resolve(input: string, tenantId: string): Promise<ResolvedEntity>;
+}
+//# sourceMappingURL=entity-resolver.d.ts.map

package/dist/entity-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-resolver.d.ts","sourceRoot":"","sources":["../src/entity-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAIpF,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CACnE;AAGD,qBAAa,sBAAsB;IACjC,OAAO,CAAC,SAAS,CAAqC;IAEtD,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,IAAI;IAItD,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAI7C,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIpB,UAAU,CACd,aAAa,EAAE,iBAAiB,EAAE,EAClC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,cAAc,EAAE,CAAC;CAa7B;AAGD,qBAAa,sBAAuB,YAAW,cAAc;IAC3D,OAAO,CAAC,SAAS,CAAiB;IAClC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,YAAY,CAAU;IAC9B,OAAO,CAAC,YAAY,CAAS;gBAEjB,MAAM,EAAE;QAClB,SAAS,EAAE,cAAc,CAAC;QAC1B,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,CAAC,EAAE,OAAO,CAAC;KACxB;IASK,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;CAmDxE"}