@lumifai/harness-tool-pack-postgres 0.0.1

package/README.md

@@ -0,0 +1,84 @@
+# @lumifai/harness-tool-pack-postgres
+
+PostgreSQL schema inspection, JSON query, and guarded insert tools for the Lumif harness.
+
+## Setup
+
+```ts
+import { createPostgresToolPack } from '@lumifai/harness-tool-pack-postgres';
+
+createPostgresToolPack({
+  connectionString: process.env.DATABASE_URL,
+  // Per-tenant credentials: return a connection string for a least-privilege,
+  // RLS-bound role. Access control is enforced in PostgreSQL, not in the pack.
+  resolveConnectionString: async (context) => tenantDatabaseUrl(context),
+});
+```
+
+Access control (which schemas, tables, columns, and rows are visible or writable)
+is enforced in the database by the connection role's `GRANT`s and row-level
+security policies. Provision a dedicated role with the minimum privileges needed
+(for example `SELECT` for reads and `INSERT` only on approved tables) and connect
+as that role; the tools expose exactly what the role can see and write.
+
+## Tools
+
+| Tool                          | Purpose                                         |
+| ----------------------------- | ----------------------------------------------- |
+| `postgres_list_schemas`       | List accessible schemas with relation counts    |
+| `postgres_get_schema_details` | Columns, keys, foreign keys, optional indexes   |
+| `postgres_preview_data`       | Bounded preview of one relation                 |
+| `postgres_query`              | Execute a validated JSON `QueryPlan`            |
+| `postgres_insert`             | Insert rows from inline JSON or a workspace CSV |
+
+Raw SQL is intentionally unsupported.
+
+## Insert sources
+
+`postgres_insert` accepts one table target and a discriminated source:
+
+```json
+{
+  "schema": "public",
+  "relation": "users",
+  "source": {
+    "kind": "json",
+    "columns": ["email", "active"],
+    "rows": [["a@example.com", true]]
+  }
+}
+```
+
+```json
+{
+  "schema": "public",
+  "relation": "users",
+  "source": {
+    "kind": "csv",
+    "path": "/data/users.csv"
+  }
+}
+```
+
+CSV paths must be absolute within the Mastra workspace filesystem
+(for example `/data/users.csv`). Host filesystem paths are rejected. Partial
+success is intentional: valid rows commit; rejected rows are returned with
+row indexes and error codes. Structural failures (missing workspace, bad CSV,
+unknown table) fail the tool call.
+
+## Security model
+
+Defense in depth:
+
+1. PostgreSQL least-privilege role, RLS, column grants, and per-tenant credentials (the authority for access control)
+2. No raw SQL: the model emits validated JSON plans or insert payloads, compiled server-side and parameterized via `pg-sql2`
+3. Read-only transactions for queries; read-write transactions with per-row savepoints for inserts; timeouts; hard row/byte/cell limits
+4. Schema metadata is loaded on demand (schema list is a single lightweight query; details/query compile load only the schemas they need) and cached briefly per connection fingerprint
+5. CSV inserts read only through the configured Mastra workspace filesystem
+
+Extension functions are disabled by default. If enabled, configure and call them
+with the exact schema-qualified name, such as `public.mask_email`. Use
+`date_part(field, source)` instead of `EXTRACT`. `current_date` /
+`current_timestamp` are supported as niladic keywords.
+
+Bundled agent skills ship in this package and are merged into `workspace.skills` when the pack is enabled.

package/dist/cast-types.d.ts

@@ -0,0 +1 @@
+export declare function assertAllowedCastType(type: string): void;

package/dist/cast-types.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertAllowedCastType = assertAllowedCastType;
+const errors_1 = require("./errors");
+const ALLOWED_CAST_TYPES = new Set([
+    'text',
+    'varchar',
+    'integer',
+    'bigint',
+    'numeric',
+    'boolean',
+    'date',
+    'timestamp',
+    'timestamptz',
+    'json',
+    'jsonb',
+    'uuid',
+]);
+function assertAllowedCastType(type) {
+    if (!ALLOWED_CAST_TYPES.has(type.toLowerCase())) {
+        throw new errors_1.PostgresToolError('COMPILATION_ERROR', `Cast type "${type}" is not allowed.`);
+    }
+}
+//# sourceMappingURL=cast-types.js.map

package/dist/cast-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cast-types.js","sourceRoot":"","sources":["../src/cast-types.ts"],"names":[],"mappings":";;AAiBA,sDAIC;AArBD,qCAA6C;AAE7C,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC;IACjC,MAAM;IACN,SAAS;IACT,SAAS;IACT,QAAQ;IACR,SAAS;IACT,SAAS;IACT,MAAM;IACN,WAAW;IACX,aAAa;IACb,MAAM;IACN,OAAO;IACP,MAAM;CACP,CAAC,CAAC;AAEH,SAAgB,qBAAqB,CAAC,IAAY;IAChD,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;QAChD,MAAM,IAAI,0BAAiB,CAAC,mBAAmB,EAAE,cAAc,IAAI,mBAAmB,CAAC,CAAC;IAC1F,CAAC;AACH,CAAC"}

package/dist/catalog-cache.d.ts

@@ -0,0 +1,9 @@
+import type { Client } from 'pg';
+import type { PostgresCatalog } from './catalog';
+/**
+ * Loads a schema-scoped catalog, reusing an in-memory entry keyed by connection
+ * fingerprint + sorted schema list for a short TTL.
+ */
+export declare function loadCachedCatalog(connectionString: string, client: Client, schemas: string[], ttlMs?: number): Promise<PostgresCatalog>;
+/** Test helper — clears the process-local catalog cache. */
+export declare function clearCatalogCache(): void;

package/dist/catalog-cache.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadCachedCatalog = loadCachedCatalog;
+exports.clearCatalogCache = clearCatalogCache;
+const node_crypto_1 = require("node:crypto");
+const catalog_1 = require("./catalog");
+const constants_1 = require("./constants");
+const catalogCache = new Map();
+function hashConnectionKey(connectionString) {
+    return (0, node_crypto_1.createHash)('sha256').update(connectionString, 'utf8').digest('hex');
+}
+function cacheKey(connectionString, schemas) {
+    return `${hashConnectionKey(connectionString)}::${[...schemas].sort().join(',')}`;
+}
+function pruneExpiredEntries(now) {
+    for (const [key, entry] of catalogCache) {
+        if (entry.expiresAt <= now) {
+            catalogCache.delete(key);
+        }
+    }
+}
+/**
+ * Loads a schema-scoped catalog, reusing an in-memory entry keyed by connection
+ * fingerprint + sorted schema list for a short TTL.
+ */
+async function loadCachedCatalog(connectionString, client, schemas, ttlMs = constants_1.DEFAULT_CATALOG_CACHE_TTL_MS) {
+    const uniqueSchemas = [...new Set(schemas)].sort();
+    if (uniqueSchemas.length === 0) {
+        return { schemas: new Set(), relations: new Map() };
+    }
+    const key = cacheKey(connectionString, uniqueSchemas);
+    const now = Date.now();
+    const cached = catalogCache.get(key);
+    if (cached) {
+        if (cached.expiresAt > now) {
+            return cached.catalog;
+        }
+        catalogCache.delete(key);
+    }
+    const catalog = await (0, catalog_1.loadPostgresCatalog)(client, { schemas: uniqueSchemas });
+    pruneExpiredEntries(now);
+    catalogCache.set(key, { catalog, expiresAt: now + Math.max(ttlMs, 0) });
+    return catalog;
+}
+/** Test helper — clears the process-local catalog cache. */
+function clearCatalogCache() {
+    catalogCache.clear();
+}
+//# sourceMappingURL=catalog-cache.js.map

package/dist/catalog-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-cache.js","sourceRoot":"","sources":["../src/catalog-cache.ts"],"names":[],"mappings":";;AAmCA,8CAyBC;AAGD,8CAEC;AAjED,6CAAyC;AAKzC,uCAAgD;AAChD,2CAA2D;AAO3D,MAAM,YAAY,GAAG,IAAI,GAAG,EAAsB,CAAC;AAEnD,SAAS,iBAAiB,CAAC,gBAAwB;IACjD,OAAO,IAAA,wBAAU,EAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC7E,CAAC;AAED,SAAS,QAAQ,CAAC,gBAAwB,EAAE,OAAiB;IAC3D,OAAO,GAAG,iBAAiB,CAAC,gBAAgB,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;AACpF,CAAC;AAED,SAAS,mBAAmB,CAAC,GAAW;IACtC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,YAAY,EAAE,CAAC;QACxC,IAAI,KAAK,CAAC,SAAS,IAAI,GAAG,EAAE,CAAC;YAC3B,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;GAGG;AACI,KAAK,UAAU,iBAAiB,CACrC,gBAAwB,EACxB,MAAc,EACd,OAAiB,EACjB,QAAgB,wCAA4B;IAE5C,MAAM,aAAa,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACnD,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,EAAE,OAAO,EAAE,IAAI,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,GAAG,EAAE,EAAE,CAAC;IACtD,CAAC;IAED,MAAM,GAAG,GAAG,QAAQ,CAAC,gBAAgB,EAAE,aAAa,CAAC,CAAC;IACtD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACrC,IAAI,MAAM,EAAE,CAAC;QACX,IAAI,MAAM,CAAC,SAAS,GAAG,GAAG,EAAE,CAAC;YAC3B,OAAO,MAAM,CAAC,OAAO,CAAC;QACxB,CAAC;QACD,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,IAAA,6BAAmB,EAAC,MAAM,EAAE,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC,CAAC;IAC9E,mBAAmB,CAAC,GAAG,CAAC,CAAC;IACzB,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;IACxE,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,4DAA4D;AAC5D,SAAgB,iBAAiB;IAC/B,YAAY,CAAC,KAAK,EAAE,CAAC;AACvB,CAAC"}

package/dist/catalog.d.ts

@@ -0,0 +1,45 @@
+import type { Client } from 'pg';
+export type CatalogColumn = {
+    name: string;
+    dataType: string;
+    isNullable: boolean;
+    ordinalPosition: number;
+};
+export type CatalogRelation = {
+    schema: string;
+    name: string;
+    kind: 'table' | 'view';
+    columns: CatalogColumn[];
+    primaryKey: string[];
+    uniqueKeys: string[][];
+    foreignKeys: {
+        name: string;
+        columns: string[];
+        referencedSchema: string;
+        referencedTable: string;
+        referencedColumns: string[];
+    }[];
+    indexes?: {
+        name: string;
+        columns: string[];
+        isUnique: boolean;
+    }[];
+};
+export type PostgresCatalog = {
+    schemas: Set<string>;
+    relations: Map<string, CatalogRelation>;
+};
+export type SchemaSummary = {
+    name: string;
+    relation_count: number;
+};
+/**
+ * Lightweight schema listing: one query for names + relation counts.
+ * Does not load columns, keys, or foreign keys.
+ */
+export declare function listSchemaSummaries(client: Client): Promise<SchemaSummary[]>;
+export declare function loadPostgresCatalog(client: Client, options?: {
+    schemas?: string[];
+}): Promise<PostgresCatalog>;
+export declare function loadRelationIndexes(client: Client, schema: string, relation: string): Promise<CatalogRelation['indexes']>;
+export declare function getCatalogRelation(catalog: PostgresCatalog, schema: string, name: string): CatalogRelation | undefined;

package/dist/catalog.js

@@ -0,0 +1,221 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listSchemaSummaries = listSchemaSummaries;
+exports.loadPostgresCatalog = loadPostgresCatalog;
+exports.loadRelationIndexes = loadRelationIndexes;
+exports.getCatalogRelation = getCatalogRelation;
+const constants_1 = require("./constants");
+function relationKey(schema, name) {
+    return `${schema}.${name}`;
+}
+/**
+ * Lightweight schema listing: one query for names + relation counts.
+ * Does not load columns, keys, or foreign keys.
+ */
+async function listSchemaSummaries(client) {
+    const result = await client.query(`SELECT
+       s.schema_name,
+       COALESCE(t.relation_count, 0)::text AS relation_count
+     FROM information_schema.schemata s
+     LEFT JOIN (
+       SELECT table_schema, COUNT(*)::int AS relation_count
+       FROM information_schema.tables
+       WHERE table_type IN ('BASE TABLE', 'VIEW')
+       GROUP BY table_schema
+     ) t ON t.table_schema = s.schema_name
+     WHERE s.schema_name NOT IN ('pg_catalog', 'information_schema', 'pg_toast')
+       AND s.schema_name NOT LIKE 'pg_temp_%'
+       AND s.schema_name NOT LIKE 'pg_toast_temp_%'
+     ORDER BY s.schema_name`);
+    return result.rows
+        .filter((row) => !constants_1.SYSTEM_SCHEMAS.has(row.schema_name))
+        .map((row) => ({
+        name: row.schema_name,
+        relation_count: Number(row.relation_count),
+    }));
+}
+async function loadPostgresCatalog(client, options) {
+    let schemas;
+    if (options?.schemas) {
+        const requested = options.schemas.filter((name) => name.length > 0 && !constants_1.SYSTEM_SCHEMAS.has(name));
+        if (requested.length === 0) {
+            return { schemas: new Set(), relations: new Map() };
+        }
+        const schemasResult = await client.query(`SELECT schema_name
+       FROM information_schema.schemata
+       WHERE schema_name = ANY($1::text[])`, [requested]);
+        schemas = new Set(schemasResult.rows.map((row) => row.schema_name));
+    }
+    else {
+        const schemasResult = await client.query(`SELECT schema_name
+       FROM information_schema.schemata
+       WHERE schema_name NOT IN ('pg_catalog', 'information_schema', 'pg_toast')
+         AND schema_name NOT LIKE 'pg_temp_%'
+         AND schema_name NOT LIKE 'pg_toast_temp_%'`);
+        schemas = new Set(schemasResult.rows.map((row) => row.schema_name).filter((name) => !constants_1.SYSTEM_SCHEMAS.has(name)));
+    }
+    if (schemas.size === 0) {
+        return { schemas, relations: new Map() };
+    }
+    const schemaList = Array.from(schemas);
+    const tablesResult = await client.query(`SELECT table_schema, table_name, table_type
+     FROM information_schema.tables
+     WHERE table_schema = ANY($1::text[])
+       AND table_type IN ('BASE TABLE', 'VIEW')
+     ORDER BY table_schema, table_name`, [schemaList]);
+    const columnsResult = await client.query(`SELECT table_schema, table_name, column_name, data_type, is_nullable, ordinal_position
+     FROM information_schema.columns
+     WHERE table_schema = ANY($1::text[])
+     ORDER BY table_schema, table_name, ordinal_position`, [schemaList]);
+    const pkResult = await client.query(`SELECT tc.table_schema, tc.table_name, kcu.column_name, kcu.ordinal_position
+     FROM information_schema.table_constraints tc
+     JOIN information_schema.key_column_usage kcu
+       ON tc.constraint_name = kcu.constraint_name
+      AND tc.table_schema = kcu.table_schema
+     WHERE tc.constraint_type = 'PRIMARY KEY'
+       AND tc.table_schema = ANY($1::text[])
+     ORDER BY tc.table_schema, tc.table_name, kcu.ordinal_position`, [schemaList]);
+    const uniqueResult = await client.query(`SELECT tc.table_schema, tc.table_name, tc.constraint_name, kcu.column_name, kcu.ordinal_position
+     FROM information_schema.table_constraints tc
+     JOIN information_schema.key_column_usage kcu
+       ON tc.constraint_name = kcu.constraint_name
+      AND tc.table_schema = kcu.table_schema
+     WHERE tc.constraint_type = 'UNIQUE'
+       AND tc.table_schema = ANY($1::text[])
+     ORDER BY tc.table_schema, tc.table_name, tc.constraint_name, kcu.ordinal_position`, [schemaList]);
+    const fkResult = await client.query(`SELECT
+       kcu.table_schema,
+       kcu.table_name,
+       kcu.constraint_name,
+       kcu.column_name,
+       kcu.ordinal_position,
+       fcu.table_schema AS foreign_table_schema,
+       fcu.table_name AS foreign_table_name,
+       fcu.column_name AS foreign_column_name
+     FROM information_schema.referential_constraints rc
+     JOIN information_schema.key_column_usage kcu
+       ON kcu.constraint_name = rc.constraint_name
+      AND kcu.constraint_schema = rc.constraint_schema
+     JOIN information_schema.key_column_usage fcu
+       ON fcu.constraint_name = rc.unique_constraint_name
+      AND fcu.constraint_schema = rc.unique_constraint_schema
+      AND fcu.ordinal_position = kcu.position_in_unique_constraint
+     WHERE kcu.table_schema = ANY($1::text[])
+     ORDER BY kcu.table_schema, kcu.table_name, kcu.constraint_name, kcu.ordinal_position`, [schemaList]);
+    const relations = new Map();
+    for (const table of tablesResult.rows) {
+        if (!schemas.has(table.table_schema)) {
+            continue;
+        }
+        relations.set(relationKey(table.table_schema, table.table_name), {
+            schema: table.table_schema,
+            name: table.table_name,
+            kind: table.table_type === 'VIEW' ? 'view' : 'table',
+            columns: [],
+            primaryKey: [],
+            uniqueKeys: [],
+            foreignKeys: [],
+        });
+    }
+    for (const column of columnsResult.rows) {
+        const relation = relations.get(relationKey(column.table_schema, column.table_name));
+        if (!relation) {
+            continue;
+        }
+        relation.columns.push({
+            name: column.column_name,
+            dataType: column.data_type,
+            isNullable: column.is_nullable === 'YES',
+            ordinalPosition: column.ordinal_position,
+        });
+    }
+    const pkByRelation = new Map();
+    for (const row of pkResult.rows) {
+        const key = relationKey(row.table_schema, row.table_name);
+        const columns = pkByRelation.get(key) ?? [];
+        columns.push(row.column_name);
+        pkByRelation.set(key, columns);
+    }
+    for (const [key, columns] of pkByRelation) {
+        const relation = relations.get(key);
+        if (relation) {
+            relation.primaryKey = columns;
+        }
+    }
+    const uniqueByConstraint = new Map();
+    for (const row of uniqueResult.rows) {
+        const key = `${row.table_schema}.${row.table_name}.${row.constraint_name}`;
+        const columns = uniqueByConstraint.get(key) ?? [];
+        columns.push(row.column_name);
+        uniqueByConstraint.set(key, columns);
+    }
+    for (const relation of relations.values()) {
+        relation.uniqueKeys = Array.from(uniqueByConstraint.entries())
+            .filter(([key]) => key.startsWith(`${relation.schema}.${relation.name}.`))
+            .map(([, columns]) => columns);
+    }
+    const fkByConstraint = new Map();
+    for (const row of fkResult.rows) {
+        const key = `${row.table_schema}.${row.table_name}.${row.constraint_name}`;
+        const existing = fkByConstraint.get(key) ?? {
+            name: row.constraint_name,
+            columns: [],
+            referencedSchema: row.foreign_table_schema,
+            referencedTable: row.foreign_table_name,
+            referencedColumns: [],
+        };
+        existing.columns.push(row.column_name);
+        existing.referencedColumns.push(row.foreign_column_name);
+        fkByConstraint.set(key, existing);
+    }
+    for (const relation of relations.values()) {
+        relation.foreignKeys = Array.from(fkByConstraint.entries())
+            .filter(([key]) => key.startsWith(`${relation.schema}.${relation.name}.`))
+            .map(([, fk]) => fk);
+    }
+    return { schemas, relations };
+}
+async function loadRelationIndexes(client, schema, relation) {
+    const result = await client.query(`SELECT indexname, indexdef
+     FROM pg_indexes
+     WHERE schemaname = $1 AND tablename = $2
+     ORDER BY indexname`, [schema, relation]);
+    return result.rows.flatMap((row) => {
+        const columns = extractIndexColumns(row.indexdef);
+        if (!columns) {
+            return [];
+        }
+        return [
+            {
+                name: row.indexname,
+                columns,
+                isUnique: /^CREATE\s+UNIQUE\s+INDEX\b/i.test(row.indexdef),
+            },
+        ];
+    });
+}
+function extractIndexColumns(indexDef) {
+    if (/\b(?:WHERE|INCLUDE)\b/i.test(indexDef)) {
+        return undefined;
+    }
+    const open = indexDef.indexOf('(');
+    const close = indexDef.indexOf(')', open + 1);
+    if (open < 0 || close < 0) {
+        return undefined;
+    }
+    const definition = indexDef.slice(open + 1, close);
+    if (!definition || definition.includes('(')) {
+        return undefined;
+    }
+    const columns = definition.split(',').map((part) => {
+        const identifier = part
+            .trim()
+            .match(/^"?([a-zA-Z_][a-zA-Z0-9_]*)"?(?:\s+(?:ASC|DESC))?(?:\s+NULLS\s+(?:FIRST|LAST))?$/i);
+        return identifier?.[1] ?? undefined;
+    });
+    return columns.every((column) => column !== undefined) ? columns : undefined;
+}
+function getCatalogRelation(catalog, schema, name) {
+    return catalog.relations.get(relationKey(schema, name));
+}
+//# sourceMappingURL=catalog.js.map

package/dist/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":";;AAkDA,kDAwBC;AAED,kDAqOC;AAED,kDA8BC;AA4BD,gDAMC;AAjXD,2CAA6C;AAwC7C,SAAS,WAAW,CAAC,MAAc,EAAE,IAAY;IAC/C,OAAO,GAAG,MAAM,IAAI,IAAI,EAAE,CAAC;AAC7B,CAAC;AAED;;;GAGG;AACI,KAAK,UAAU,mBAAmB,CAAC,MAAc;IACtD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAC/B;;;;;;;;;;;;;4BAawB,CACzB,CAAC;IAEF,OAAO,MAAM,CAAC,IAAI;SACf,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,0BAAc,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;SACrD,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACb,IAAI,EAAE,GAAG,CAAC,WAAW;QACrB,cAAc,EAAE,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC;KAC3C,CAAC,CAAC,CAAC;AACR,CAAC;AAEM,KAAK,UAAU,mBAAmB,CACvC,MAAc,EACd,OAAgC;IAEhC,IAAI,OAAoB,CAAC;IAEzB,IAAI,OAAO,EAAE,OAAO,EAAE,CAAC;QACrB,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CACtC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,0BAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CACvD,CAAC;QACF,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,OAAO,EAAE,OAAO,EAAE,IAAI,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,GAAG,EAAE,EAAE,CAAC;QACtD,CAAC;QAED,MAAM,aAAa,GAAG,MAAM,MAAM,CAAC,KAAK,CACtC;;2CAEqC,EACrC,CAAC,SAAS,CAAC,CACZ,CAAC;QACF,OAAO,GAAG,IAAI,GAAG,CAAC,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC;IACtE,CAAC;SAAM,CAAC;QACN,MAAM,aAAa,GAAG,MAAM,MAAM,CAAC,KAAK,CACtC;;;;oDAI8C,CAC/C,CAAC;QAEF,OAAO,GAAG,IAAI,GAAG,CACf,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,0BAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAC7F,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,GAAG,EAAE,EAAE,CAAC;IAC3C,CAAC;IAED,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAEvC,MAAM,YAAY,GAAG,MAAM,MAAM,CAAC,KAAK,CAKrC;;;;uCAImC,EACnC,CAAC,UAAU,CAAC,CACb,CAAC;IAEF,MAAM,aAAa,GAAG,MAAM,MAAM,CAAC,KAAK,CAQtC;;;yDAGqD,EACrD,CAAC,UAAU,CAAC,CACb,CAAC;IAEF,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,KAAK,CAMjC;;;;;;;mEAO+D,EAC/D,CAAC,UAAU,CAAC,CACb,CAAC;IAEF,MAAM,YAAY,GAAG,MAAM,MAAM,CAAC,KAAK,CAOrC;;;;;;;uFAOmF,EACnF,CAAC,UAAU,CAAC,CACb,CAAC;IAEF,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,KAAK,CAUjC;;;;;;;;;;;;;;;;;;0FAkBsF,EACtF,CAAC,UAAU,CAAC,CACb,CAAC;IAEF,MAAM,SAAS,GAAG,IAAI,GAAG,EAA2B,CAAC;IAErD,KAAK,MAAM,KAAK,IAAI,YAAY,CAAC,IAAI,EAAE,CAAC;QACtC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC;YACrC,SAAS;QACX,CAAC;QAED,SAAS,CAAC,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,YAAY,EAAE,KAAK,CAAC,UAAU,CAAC,EAAE;YAC/D,MAAM,EAAE,KAAK,CAAC,YAAY;YAC1B,IAAI,EAAE,KAAK,CAAC,UAAU;YACtB,IAAI,EAAE,KAAK,CAAC,UAAU,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO;YACpD,OAAO,EAAE,EAAE;YACX,UAAU,EAAE,EAAE;YACd,UAAU,EAAE,EAAE;YACd,WAAW,EAAE,EAAE;SAChB,CAAC,CAAC;IACL,CAAC;IAED,KAAK,MAAM,MAAM,IAAI,aAAa,CAAC,IAAI,EAAE,CAAC;QACxC,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,WAAW,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;QACpF,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,SAAS;QACX,CAAC;QAED,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC;YACpB,IAAI,EAAE,MAAM,CAAC,WAAW;YACxB,QAAQ,EAAE,MAAM,CAAC,SAAS;YAC1B,UAAU,EAAE,MAAM,CAAC,WAAW,KAAK,KAAK;YACxC,eAAe,EAAE,MAAM,CAAC,gBAAgB;SACzC,CAAC,CAAC;IACL,CAAC;IAED,MAAM,YAAY,GAAG,IAAI,GAAG,EAAoB,CAAC;IACjD,KAAK,MAAM,GAAG,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC;QAChC,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,CAAC,YAAY,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC;QAC1D,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QAC5C,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAC9B,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACjC,CAAC;IAED,KAAK,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,YAAY,EAAE,CAAC;QAC1C,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACpC,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,CAAC,UAAU,GAAG,OAAO,CAAC;QAChC,CAAC;IACH,CAAC;IAED,MAAM,kBAAkB,GAAG,IAAI,GAAG,EAAoB,CAAC;IACvD,KAAK,MAAM,GAAG,IAAI,YAAY,CAAC,IAAI,EAAE,CAAC;QACpC,MAAM,GAAG,GAAG,GAAG,GAAG,CAAC,YAAY,IAAI,GAAG,CAAC,UAAU,IAAI,GAAG,CAAC,eAAe,EAAE,CAAC;QAC3E,MAAM,OAAO,GAAG,kBAAkB,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QAClD,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAC9B,kBAAkB,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC;IAED,KAAK,MAAM,QAAQ,IAAI,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC;QAC1C,QAAQ,CAAC,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,OAAO,EAAE,CAAC;aAC3D,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,IAAI,GAAG,CAAC,CAAC;aACzE,GAAG,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IAED,MAAM,cAAc,GAAG,IAAI,GAAG,EAS3B,CAAC;IAEJ,KAAK,MAAM,GAAG,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC;QAChC,MAAM,GAAG,GAAG,GAAG,GAAG,CAAC,YAAY,IAAI,GAAG,CAAC,UAAU,IAAI,GAAG,CAAC,eAAe,EAAE,CAAC;QAC3E,MAAM,QAAQ,GAAG,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI;YAC1C,IAAI,EAAE,GAAG,CAAC,eAAe;YACzB,OAAO,EAAE,EAAE;YACX,gBAAgB,EAAE,GAAG,CAAC,oBAAoB;YAC1C,eAAe,EAAE,GAAG,CAAC,kBAAkB;YACvC,iBAAiB,EAAE,EAAE;SACtB,CAAC;QACF,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACvC,QAAQ,CAAC,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;QACzD,cAAc,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,MAAM,QAAQ,IAAI,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC;QAC1C,QAAQ,CAAC,WAAW,GAAG,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,CAAC;aACxD,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,IAAI,GAAG,CAAC,CAAC;aACzE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;IACzB,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;AAChC,CAAC;AAEM,KAAK,UAAU,mBAAmB,CACvC,MAAc,EACd,MAAc,EACd,QAAgB;IAEhB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAI/B;;;wBAGoB,EACpB,CAAC,MAAM,EAAE,QAAQ,CAAC,CACnB,CAAC;IAEF,OAAO,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;QACjC,MAAM,OAAO,GAAG,mBAAmB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAClD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,OAAO;YACL;gBACE,IAAI,EAAE,GAAG,CAAC,SAAS;gBACnB,OAAO;gBACP,QAAQ,EAAE,6BAA6B,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC;aAC3D;SACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,mBAAmB,CAAC,QAAgB;IAC3C,IAAI,wBAAwB,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5C,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACnC,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC;IAC9C,IAAI,IAAI,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QAC1B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,UAAU,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;IACnD,IAAI,CAAC,UAAU,IAAI,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5C,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACjD,MAAM,UAAU,GAAG,IAAI;aACpB,IAAI,EAAE;aACN,KAAK,CAAC,mFAAmF,CAAC,CAAC;QAC9F,OAAO,UAAU,EAAE,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,EAAoB,EAAE,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AACjG,CAAC;AAED,SAAgB,kBAAkB,CAChC,OAAwB,EACxB,MAAc,EACd,IAAY;IAEZ,OAAO,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;AAC1D,CAAC"}

package/dist/constants.d.ts

@@ -0,0 +1,45 @@
+export declare const QUERY_PLAN_VERSION: 1;
+export declare const DEFAULT_POSTGRES_QUERY_LIMIT = 100;
+export declare const MAX_POSTGRES_QUERY_LIMIT = 500;
+export declare const DEFAULT_PREVIEW_LIMIT = 10;
+export declare const MAX_PREVIEW_LIMIT = 50;
+export declare const DEFAULT_STATEMENT_TIMEOUT_MS = 10000;
+export declare const MAX_STATEMENT_TIMEOUT_MS = 120000;
+export declare const DEFAULT_TEMP_FILE_LIMIT_KB: number;
+export declare const MAX_TEMP_FILE_LIMIT_KB: number;
+export declare const DEFAULT_LOCK_TIMEOUT_MS = 2000;
+export declare const DEFAULT_IDLE_IN_TRANSACTION_TIMEOUT_MS = 5000;
+export declare const DEFAULT_MAX_RESULT_BYTES = 256000;
+export declare const MAX_RESULT_BYTES = 4194304;
+export declare const DEFAULT_MAX_CELL_BYTES = 8192;
+export declare const CURSOR_BATCH_SIZE = 200;
+export declare const MAX_QUERY_INPUT_DEPTH = 64;
+export declare const MAX_QUERY_INPUT_NODES = 4096;
+export declare const DEFAULT_MAX_JOINS = 5;
+export declare const DEFAULT_MAX_CTES = 3;
+export declare const DEFAULT_MAX_SELECT_ITEMS = 64;
+export declare const DEFAULT_MAX_IN_LIST_SIZE = 100;
+export declare const DEFAULT_MAX_EXPRESSION_DEPTH = 8;
+export declare const DEFAULT_MAX_QUERY_NODES = 200;
+export declare const DEFAULT_EXPLAIN_COST_LIMIT = 50000;
+export declare const SYSTEM_SCHEMAS: Set<string>;
+export declare const COMPARISON_OPERATORS: readonly ["eq", "ne", "lt", "lte", "gt", "gte", "like", "ilike"];
+export declare const AGGREGATE_FUNCTIONS: readonly ["count", "sum", "avg", "min", "max", "count_distinct"];
+export declare const JOIN_TYPES: readonly ["inner", "left", "right", "full"];
+export declare const SET_OPERATIONS: readonly ["union", "union_all", "intersect", "except"];
+export declare const WINDOW_FUNCTIONS: readonly ["count", "sum", "avg", "min", "max", "row_number", "rank", "dense_rank", "lag", "lead"];
+/** Niladic SQL keywords that must not be emitted as "name"(). */
+export declare const NILADIC_KEYWORDS: Set<string>;
+/**
+ * Built-in functions that compile as identifier(args).
+ * Prefer date_part(field, source) over EXTRACT — EXTRACT needs keyword syntax.
+ * Window-only functions live in WINDOW_FUNCTIONS, not here.
+ */
+export declare const BUILTIN_FUNCTIONS: Set<string>;
+export declare const DEFAULT_CATALOG_CACHE_TTL_MS = 30000;
+export declare const DEFAULT_MAX_INSERT_ROWS = 1000;
+export declare const MAX_INSERT_ROWS = 5000;
+export declare const DEFAULT_MAX_INSERT_CSV_BYTES = 1048576;
+export declare const MAX_INSERT_CSV_BYTES = 4194304;
+export declare const DEFAULT_MAX_INSERT_REJECTION_DETAILS = 200;
+export declare const MAX_INSERT_REJECTION_DETAILS = 1000;

package/dist/constants.js

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_INSERT_REJECTION_DETAILS = exports.DEFAULT_MAX_INSERT_REJECTION_DETAILS = exports.MAX_INSERT_CSV_BYTES = exports.DEFAULT_MAX_INSERT_CSV_BYTES = exports.MAX_INSERT_ROWS = exports.DEFAULT_MAX_INSERT_ROWS = exports.DEFAULT_CATALOG_CACHE_TTL_MS = exports.BUILTIN_FUNCTIONS = exports.NILADIC_KEYWORDS = exports.WINDOW_FUNCTIONS = exports.SET_OPERATIONS = exports.JOIN_TYPES = exports.AGGREGATE_FUNCTIONS = exports.COMPARISON_OPERATORS = exports.SYSTEM_SCHEMAS = exports.DEFAULT_EXPLAIN_COST_LIMIT = exports.DEFAULT_MAX_QUERY_NODES = exports.DEFAULT_MAX_EXPRESSION_DEPTH = exports.DEFAULT_MAX_IN_LIST_SIZE = exports.DEFAULT_MAX_SELECT_ITEMS = exports.DEFAULT_MAX_CTES = exports.DEFAULT_MAX_JOINS = exports.MAX_QUERY_INPUT_NODES = exports.MAX_QUERY_INPUT_DEPTH = exports.CURSOR_BATCH_SIZE = exports.DEFAULT_MAX_CELL_BYTES = exports.MAX_RESULT_BYTES = exports.DEFAULT_MAX_RESULT_BYTES = exports.DEFAULT_IDLE_IN_TRANSACTION_TIMEOUT_MS = exports.DEFAULT_LOCK_TIMEOUT_MS = exports.MAX_TEMP_FILE_LIMIT_KB = exports.DEFAULT_TEMP_FILE_LIMIT_KB = exports.MAX_STATEMENT_TIMEOUT_MS = exports.DEFAULT_STATEMENT_TIMEOUT_MS = exports.MAX_PREVIEW_LIMIT = exports.DEFAULT_PREVIEW_LIMIT = exports.MAX_POSTGRES_QUERY_LIMIT = exports.DEFAULT_POSTGRES_QUERY_LIMIT = exports.QUERY_PLAN_VERSION = void 0;
+exports.QUERY_PLAN_VERSION = 1;
+exports.DEFAULT_POSTGRES_QUERY_LIMIT = 100;
+exports.MAX_POSTGRES_QUERY_LIMIT = 500;
+exports.DEFAULT_PREVIEW_LIMIT = 10;
+exports.MAX_PREVIEW_LIMIT = 50;
+exports.DEFAULT_STATEMENT_TIMEOUT_MS = 10_000;
+exports.MAX_STATEMENT_TIMEOUT_MS = 120_000;
+exports.DEFAULT_TEMP_FILE_LIMIT_KB = 64 * 1024;
+exports.MAX_TEMP_FILE_LIMIT_KB = 256 * 1024;
+exports.DEFAULT_LOCK_TIMEOUT_MS = 2_000;
+exports.DEFAULT_IDLE_IN_TRANSACTION_TIMEOUT_MS = 5_000;
+exports.DEFAULT_MAX_RESULT_BYTES = 256_000;
+exports.MAX_RESULT_BYTES = 4_194_304;
+exports.DEFAULT_MAX_CELL_BYTES = 8_192;
+exports.CURSOR_BATCH_SIZE = 200;
+exports.MAX_QUERY_INPUT_DEPTH = 64;
+exports.MAX_QUERY_INPUT_NODES = 4_096;
+exports.DEFAULT_MAX_JOINS = 5;
+exports.DEFAULT_MAX_CTES = 3;
+exports.DEFAULT_MAX_SELECT_ITEMS = 64;
+exports.DEFAULT_MAX_IN_LIST_SIZE = 100;
+exports.DEFAULT_MAX_EXPRESSION_DEPTH = 8;
+exports.DEFAULT_MAX_QUERY_NODES = 200;
+exports.DEFAULT_EXPLAIN_COST_LIMIT = 50_000;
+exports.SYSTEM_SCHEMAS = new Set(['pg_catalog', 'information_schema', 'pg_toast']);
+exports.COMPARISON_OPERATORS = [
+    'eq',
+    'ne',
+    'lt',
+    'lte',
+    'gt',
+    'gte',
+    'like',
+    'ilike',
+];
+exports.AGGREGATE_FUNCTIONS = ['count', 'sum', 'avg', 'min', 'max', 'count_distinct'];
+exports.JOIN_TYPES = ['inner', 'left', 'right', 'full'];
+exports.SET_OPERATIONS = ['union', 'union_all', 'intersect', 'except'];
+exports.WINDOW_FUNCTIONS = [
+    'count',
+    'sum',
+    'avg',
+    'min',
+    'max',
+    'row_number',
+    'rank',
+    'dense_rank',
+    'lag',
+    'lead',
+];
+/** Niladic SQL keywords that must not be emitted as "name"(). */
+exports.NILADIC_KEYWORDS = new Set(['current_date', 'current_timestamp']);
+/**
+ * Built-in functions that compile as identifier(args).
+ * Prefer date_part(field, source) over EXTRACT — EXTRACT needs keyword syntax.
+ * Window-only functions live in WINDOW_FUNCTIONS, not here.
+ */
+exports.BUILTIN_FUNCTIONS = new Set([
+    'coalesce',
+    'nullif',
+    'lower',
+    'upper',
+    'trim',
+    'length',
+    'abs',
+    'round',
+    'floor',
+    'ceil',
+    'date_trunc',
+    'date_part',
+    'now',
+    'concat',
+    'substring',
+    'replace',
+    'split_part',
+    'to_char',
+    'to_date',
+    'to_timestamp',
+    'greatest',
+    'least',
+    'jsonb_build_object',
+    'jsonb_extract_path_text',
+]);
+exports.DEFAULT_CATALOG_CACHE_TTL_MS = 30_000;
+exports.DEFAULT_MAX_INSERT_ROWS = 1000;
+exports.MAX_INSERT_ROWS = 5000;
+exports.DEFAULT_MAX_INSERT_CSV_BYTES = 1_048_576;
+exports.MAX_INSERT_CSV_BYTES = 4_194_304;
+exports.DEFAULT_MAX_INSERT_REJECTION_DETAILS = 200;
+exports.MAX_INSERT_REJECTION_DETAILS = 1000;
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,18 @@
+export type PostgresToolErrorCode = 'INVALID_INPUT' | 'POLICY_DENIED' | 'UNKNOWN_RELATION' | 'UNKNOWN_COLUMN' | 'COMPLEXITY_EXCEEDED' | 'COMPILATION_ERROR' | 'EXECUTION_ERROR' | 'TIMEOUT' | 'COST_EXCEEDED' | 'CONFIGURATION_ERROR';
+export declare class PostgresToolError extends Error {
+    readonly code: PostgresToolErrorCode;
+    readonly path?: string;
+    readonly hint?: string;
+    constructor(code: PostgresToolErrorCode, message: string, options?: {
+        path?: string;
+        hint?: string;
+        cause?: unknown;
+    });
+    toJSON(): {
+        code: PostgresToolErrorCode;
+        message: string;
+        path?: string;
+        hint?: string;
+    };
+}
+export declare function isPostgresToolError(error: unknown): error is PostgresToolError;

package/dist/errors.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PostgresToolError = void 0;
+exports.isPostgresToolError = isPostgresToolError;
+class PostgresToolError extends Error {
+    code;
+    path;
+    hint;
+    constructor(code, message, options) {
+        super(message, { cause: options?.cause });
+        this.name = 'PostgresToolError';
+        this.code = code;
+        this.path = options?.path;
+        this.hint = options?.hint;
+    }
+    toJSON() {
+        return {
+            code: this.code,
+            message: this.message,
+            ...(this.path ? { path: this.path } : {}),
+            ...(this.hint ? { hint: this.hint } : {}),
+        };
+    }
+}
+exports.PostgresToolError = PostgresToolError;
+function isPostgresToolError(error) {
+    return error instanceof PostgresToolError;
+}
+//# sourceMappingURL=errors.js.map