@conarium-ai/core 0.2.10 → 0.2.11

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (73) hide show
  1. package/CHANGELOG.md +17 -2
  2. package/LIMITATIONS.md +26 -5
  3. package/LIMITATIONS.tr.md +26 -5
  4. package/README.md +11 -8
  5. package/bin/conarium-doctor.mjs +208 -7
  6. package/bin/doctor-sql.mjs +47 -0
  7. package/dist/config.d.ts +14 -6
  8. package/dist/config.d.ts.map +1 -1
  9. package/dist/config.js +6 -0
  10. package/dist/config.js.map +1 -1
  11. package/dist/console.d.ts.map +1 -1
  12. package/dist/console.js +14 -3
  13. package/dist/console.js.map +1 -1
  14. package/dist/governance.d.ts +8 -0
  15. package/dist/governance.d.ts.map +1 -1
  16. package/dist/governance.js +29 -78
  17. package/dist/governance.js.map +1 -1
  18. package/dist/masking-cost.d.ts +16 -0
  19. package/dist/masking-cost.d.ts.map +1 -0
  20. package/dist/masking-cost.js +31 -0
  21. package/dist/masking-cost.js.map +1 -0
  22. package/dist/server.d.ts.map +1 -1
  23. package/dist/server.js +3 -1
  24. package/dist/server.js.map +1 -1
  25. package/dist/sql-gate/dispatch.d.ts +17 -0
  26. package/dist/sql-gate/dispatch.d.ts.map +1 -0
  27. package/dist/sql-gate/dispatch.js +30 -0
  28. package/dist/sql-gate/dispatch.js.map +1 -0
  29. package/dist/sql-gate/mssql.d.ts +11 -0
  30. package/dist/sql-gate/mssql.d.ts.map +1 -0
  31. package/dist/sql-gate/mssql.js +287 -0
  32. package/dist/sql-gate/mssql.js.map +1 -0
  33. package/dist/sql-gate/oracle.d.ts +11 -0
  34. package/dist/sql-gate/oracle.d.ts.map +1 -0
  35. package/dist/sql-gate/oracle.js +227 -0
  36. package/dist/sql-gate/oracle.js.map +1 -0
  37. package/dist/sql-gate/postgres.d.ts +12 -0
  38. package/dist/sql-gate/postgres.d.ts.map +1 -0
  39. package/dist/sql-gate/postgres.js +64 -0
  40. package/dist/sql-gate/postgres.js.map +1 -0
  41. package/dist/sql-gate/rules.d.ts +14 -0
  42. package/dist/sql-gate/rules.d.ts.map +1 -0
  43. package/dist/sql-gate/rules.js +73 -0
  44. package/dist/sql-gate/rules.js.map +1 -0
  45. package/dist/sql-gate/types.d.ts +31 -0
  46. package/dist/sql-gate/types.d.ts.map +1 -0
  47. package/dist/sql-gate/types.js +9 -0
  48. package/dist/sql-gate/types.js.map +1 -0
  49. package/dist/types.d.ts +6 -0
  50. package/dist/types.d.ts.map +1 -1
  51. package/docs/API-STABILITY.md +174 -0
  52. package/docs/BENCHMARK.md +124 -0
  53. package/docs/audit/2026-08-14-e2e-health.md +69 -0
  54. package/docs/audit/2026-08-14-security-scan.md +48 -0
  55. package/docs/audit/2026-08-14-surface-sync.md +34 -0
  56. package/docs/benchmarks/latest.json +2310 -0
  57. package/docs/benchmarks/masking-cost-threshold.json +6 -0
  58. package/docs/benchmarks/overhead-20260814T1238Z-win32.json +402 -0
  59. package/docs/benchmarks/overhead-20260814T1346Z-linux.json +2310 -0
  60. package/docs/benchmarks/overhead-20260814T1644Z-win32.json +2310 -0
  61. package/docs/releases/v0.2.10.md +24 -0
  62. package/docs/releases/v0.2.8.md +23 -0
  63. package/docs/releases/v0.2.9.md +26 -0
  64. package/docs/security/PENTEST-SCOPE.md +1 -1
  65. package/docs/security/THREAT-MODEL.md +7 -5
  66. package/docs/specs/2026-08-14-mssql-bypass-inventory.md +37 -0
  67. package/docs/specs/2026-08-14-oracle-bypass-inventory.md +28 -0
  68. package/package.json +5 -2
  69. package/scripts/benchmark-overhead.mjs +492 -0
  70. package/test-vectors/README.md +3 -0
  71. package/test-vectors/sql-gate/LAST-RUN.json +11 -0
  72. package/test-vectors/sql-gate/README.md +19 -0
  73. package/test-vectors/sql-gate/vectors.json +331 -0
@@ -0,0 +1,227 @@
1
+ import { init, parse } from '@guanmingchiu/sqlparser-ts';
2
+ import { PolicyError } from '../governance.js';
3
+ import { findWriteToken, isSelectOrWith, normalizedSqlHead, } from './rules.js';
4
+ import { registerSqlGate } from './dispatch.js';
5
+ await init();
6
+ const PRE_DENY = [
7
+ { re: /\bROWNUM\b/i, reason: 'ROWNUM is not a row cap and is not permitted.' },
8
+ { re: /\bUTL_/i, reason: 'UTL_* packages are not permitted.' },
9
+ { re: /\bDBMS_/i, reason: 'DBMS_* packages are not permitted.' },
10
+ { re: /\bBEGIN\b/i, reason: 'Anonymous PL/SQL blocks are not permitted.' },
11
+ ];
12
+ function meta(partial = {}) {
13
+ return {
14
+ accessedTables: [],
15
+ accessedFunctions: [],
16
+ appliedRowCap: 0,
17
+ maskedFields: [],
18
+ maskedCount: 0,
19
+ denied: false,
20
+ ...partial,
21
+ };
22
+ }
23
+ function deny(reason, tables = []) {
24
+ throw new PolicyError(reason, meta({
25
+ accessedTables: tables,
26
+ denied: true,
27
+ denyReason: reason,
28
+ }));
29
+ }
30
+ function matchGlob(pattern, value) {
31
+ const p = pattern.trim().toLowerCase();
32
+ const v = value.trim().toLowerCase();
33
+ if (p === '*' || p === '*.*')
34
+ return true;
35
+ if (p.endsWith('.*'))
36
+ return v.startsWith(p.slice(0, -1));
37
+ if (p.startsWith('*.'))
38
+ return v.endsWith(p.slice(1));
39
+ if (p.endsWith('*'))
40
+ return v.startsWith(p.slice(0, -1));
41
+ return p === v;
42
+ }
43
+ function identValue(node) {
44
+ if (!node || typeof node !== 'object')
45
+ return undefined;
46
+ const rec = node;
47
+ if (rec.Identifier && typeof rec.Identifier === 'object') {
48
+ const value = rec.Identifier.value;
49
+ return typeof value === 'string' ? value : undefined;
50
+ }
51
+ if (typeof rec.value === 'string')
52
+ return rec.value;
53
+ return undefined;
54
+ }
55
+ function walk(node, visit) {
56
+ if (!node || typeof node !== 'object')
57
+ return;
58
+ if (Array.isArray(node)) {
59
+ for (const item of node)
60
+ walk(item, visit);
61
+ return;
62
+ }
63
+ const rec = node;
64
+ visit(rec);
65
+ for (const [key, value] of Object.entries(rec)) {
66
+ if (key === 'span' || key === 'token')
67
+ continue;
68
+ walk(value, visit);
69
+ }
70
+ }
71
+ function collectCteNames(root) {
72
+ const names = new Set();
73
+ walk(root, rec => {
74
+ if (!rec.alias || typeof rec.alias !== 'object')
75
+ return;
76
+ const alias = rec.alias;
77
+ const value = identValue(alias.name) ?? identValue(alias);
78
+ if (value && rec.query)
79
+ names.add(value.toLowerCase());
80
+ });
81
+ return names;
82
+ }
83
+ function collectTables(root, ctes) {
84
+ const tables = new Set();
85
+ walk(root, rec => {
86
+ const table = rec.Table;
87
+ if (!table || !Array.isArray(table.name))
88
+ return;
89
+ const parts = table.name.map(identValue).filter((p) => !!p);
90
+ if (parts.some(p => p.includes('@'))) {
91
+ deny('Database link (@) is not permitted.');
92
+ }
93
+ if (parts.length >= 3) {
94
+ deny(`Multi-part name '${parts.join('.')}' is not permitted.`);
95
+ }
96
+ if (parts.length === 0)
97
+ return;
98
+ if (parts.length === 1) {
99
+ if (!ctes.has(parts[0].toLowerCase())) {
100
+ deny(`Unqualified table '${parts[0]}' is not permitted; use schema.table.`);
101
+ }
102
+ return;
103
+ }
104
+ tables.add(`${parts[0].toLowerCase()}.${parts[1].toLowerCase()}`);
105
+ });
106
+ return tables;
107
+ }
108
+ function collectAliases(root, masks) {
109
+ const aliases = {};
110
+ const maskedFields = [];
111
+ const leaves = masks.map(m => m.slice(m.lastIndexOf('.') + 1).toLowerCase());
112
+ walk(root, rec => {
113
+ const aliased = rec.ExprWithAlias;
114
+ if (!aliased)
115
+ return;
116
+ const out = aliased.alias?.value?.toLowerCase();
117
+ const refs = [];
118
+ walk(aliased.expr, inner => {
119
+ const id = identValue(inner);
120
+ if (id && inner.Identifier)
121
+ refs.push(id.toLowerCase());
122
+ });
123
+ if (!out || refs.length === 0)
124
+ return;
125
+ const masked = refs.find(r => leaves.includes(r));
126
+ if (masked) {
127
+ aliases[out] = masked;
128
+ maskedFields.push(out);
129
+ }
130
+ else if (refs.length === 1) {
131
+ aliases[out] = refs[0];
132
+ }
133
+ });
134
+ return { aliases, maskedFields };
135
+ }
136
+ function policyAllows(policy, qualified) {
137
+ const allow = policy.allowTables ?? [];
138
+ const denyList = policy.denyTables ?? [];
139
+ if (denyList.some(p => matchGlob(p, qualified)))
140
+ return false;
141
+ if (allow.length === 0)
142
+ return false;
143
+ return allow.some(p => matchGlob(p, qualified));
144
+ }
145
+ function applyFetchCap(sql, cap) {
146
+ const core = sql.trim().replace(/;+\s*$/, '');
147
+ return `SELECT * FROM (${core}) conarium_cap FETCH FIRST ${cap} ROWS ONLY`;
148
+ }
149
+ export function guardOracleQuery(sql, policy) {
150
+ const cap = policy.maxRows ?? 100;
151
+ const norm = normalizedSqlHead(sql);
152
+ for (const rule of PRE_DENY) {
153
+ if (rule.re.test(sql))
154
+ deny(rule.reason);
155
+ }
156
+ if (!isSelectOrWith(norm)) {
157
+ deny('Only read-only SELECT/WITH queries are permitted.');
158
+ }
159
+ const writeTok = findWriteToken(norm);
160
+ if (writeTok)
161
+ deny(`Blocked write operation: ${writeTok}`);
162
+ let stmts;
163
+ try {
164
+ stmts = parse(sql, 'oracle');
165
+ }
166
+ catch (err) {
167
+ deny(`Failed to parse SQL: ${err.message}`);
168
+ }
169
+ if (!Array.isArray(stmts) || stmts.length === 0)
170
+ deny('Failed to parse SQL: empty AST');
171
+ if (stmts.length > 1)
172
+ deny('Multiple statements are not permitted.');
173
+ const stmt = stmts[0];
174
+ if (!stmt.Query)
175
+ deny('Only read-only SELECT/WITH queries are permitted.');
176
+ const ctes = collectCteNames(stmt);
177
+ const tables = collectTables(stmt, ctes);
178
+ for (const qualified of tables) {
179
+ if (qualified.startsWith('sys.') || qualified.startsWith('system.')) {
180
+ deny(`Access to system catalog '${qualified}' is forbidden.`, [...tables]);
181
+ }
182
+ if (!policyAllows(policy, qualified)) {
183
+ deny(`Access to table '${qualified}' is not permitted by policy.`, [...tables]);
184
+ }
185
+ }
186
+ const { aliases, maskedFields } = collectAliases(stmt, policy.maskColumns ?? []);
187
+ return {
188
+ sql: applyFetchCap(sql, cap),
189
+ aliases,
190
+ metadata: meta({
191
+ accessedTables: [...tables],
192
+ appliedRowCap: cap,
193
+ maskedFields,
194
+ }),
195
+ };
196
+ }
197
+ export const oracleAdapter = {
198
+ dialect: 'oracle',
199
+ inspect(sql) {
200
+ try {
201
+ const out = guardOracleQuery(sql, { allowTables: ['*'], maxRows: 50 });
202
+ return {
203
+ statementCount: 1,
204
+ tables: out.metadata.accessedTables,
205
+ columns: Object.keys(out.aliases),
206
+ writes: false,
207
+ functions: [],
208
+ hasRowLimitNode: /fetch\s+first\s+\d+/i.test(out.sql),
209
+ parseFailed: false,
210
+ };
211
+ }
212
+ catch (err) {
213
+ return {
214
+ statementCount: 0,
215
+ tables: [],
216
+ columns: [],
217
+ writes: false,
218
+ functions: [],
219
+ hasRowLimitNode: false,
220
+ parseFailed: true,
221
+ parseError: err.message,
222
+ };
223
+ }
224
+ },
225
+ };
226
+ registerSqlGate('oracle', guardOracleQuery);
227
+ //# sourceMappingURL=oracle.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"oracle.js","sourceRoot":"","sources":["../../src/sql-gate/oracle.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,12 @@
1
+ import type { SelectFromStatement, SelectStatement, Statement } from 'pgsql-ast-parser';
2
+ import type { DialectAdapter } from './types.js';
3
+ export declare function parsePostgresSql(sql: string): Statement[];
4
+ export declare function emitPostgresSql(statement: Statement): string;
5
+ export declare function postgresLimitTarget(statement: Statement | SelectStatement): SelectFromStatement | undefined;
6
+ export declare function applyPostgresRowCap(statement: Statement | SelectStatement, cap: number): void;
7
+ /**
8
+ * Answers the shared questions. Lineage / mask carry-over still walks the
9
+ * Postgres AST in Governance — that walk is Postgres-shaped on purpose.
10
+ */
11
+ export declare const postgresAdapter: DialectAdapter;
12
+ //# sourceMappingURL=postgres.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"postgres.d.ts","sourceRoot":"","sources":["../../src/sql-gate/postgres.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACvF,OAAO,KAAK,EAAE,cAAc,EAAoB,MAAM,YAAY,CAAA;AAElE,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,CAEzD;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAE5D;AAED,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,SAAS,GAAG,eAAe,GACrC,mBAAmB,GAAG,SAAS,CAMjC;AAED,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,SAAS,GAAG,eAAe,EACtC,GAAG,EAAE,MAAM,GACV,IAAI,CAcN;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,cA2B7B,CAAA"}
@@ -0,0 +1,64 @@
1
+ import { parse, toSql } from 'pgsql-ast-parser';
2
+ export function parsePostgresSql(sql) {
3
+ return parse(sql);
4
+ }
5
+ export function emitPostgresSql(statement) {
6
+ return toSql.statement(statement);
7
+ }
8
+ export function postgresLimitTarget(statement) {
9
+ if (statement.type === 'select')
10
+ return statement;
11
+ if (statement.type === 'with' || statement.type === 'with recursive') {
12
+ return postgresLimitTarget(statement.in);
13
+ }
14
+ return undefined;
15
+ }
16
+ export function applyPostgresRowCap(statement, cap) {
17
+ const target = postgresLimitTarget(statement);
18
+ if (!target)
19
+ return;
20
+ const existing = target.limit?.limit;
21
+ // Never RAISE a limit the caller already set below the cap — a request for
22
+ // 1 row must not become 50. Only clamp down; preserve any OFFSET.
23
+ if (existing && existing.type === 'integer' && typeof existing.value === 'number' && existing.value <= cap) {
24
+ return;
25
+ }
26
+ target.limit = {
27
+ ...(target.limit ?? {}),
28
+ limit: { type: 'integer', value: cap },
29
+ };
30
+ }
31
+ /**
32
+ * Answers the shared questions. Lineage / mask carry-over still walks the
33
+ * Postgres AST in Governance — that walk is Postgres-shaped on purpose.
34
+ */
35
+ export const postgresAdapter = {
36
+ dialect: 'postgres',
37
+ inspect(sql) {
38
+ try {
39
+ const ast = parsePostgresSql(sql);
40
+ return {
41
+ statementCount: ast.length,
42
+ tables: [],
43
+ columns: [],
44
+ writes: false,
45
+ functions: [],
46
+ hasRowLimitNode: ast.length === 1 && postgresLimitTarget(ast[0]) !== undefined,
47
+ parseFailed: false,
48
+ };
49
+ }
50
+ catch (err) {
51
+ return {
52
+ statementCount: 0,
53
+ tables: [],
54
+ columns: [],
55
+ writes: false,
56
+ functions: [],
57
+ hasRowLimitNode: false,
58
+ parseFailed: true,
59
+ parseError: err.message,
60
+ };
61
+ }
62
+ },
63
+ };
64
+ //# sourceMappingURL=postgres.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"postgres.js","sourceRoot":"","sources":["../../src/sql-gate/postgres.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAI/C,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,OAAO,KAAK,CAAC,GAAG,CAAC,CAAA;AACnB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,SAAoB;IAClD,OAAO,KAAK,CAAC,SAAS,CAAC,SAAS,CAAC,CAAA;AACnC,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,SAAsC;IAEtC,IAAI,SAAS,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAA;IACjD,IAAI,SAAS,CAAC,IAAI,KAAK,MAAM,IAAI,SAAS,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;QACrE,OAAO,mBAAmB,CAAC,SAAS,CAAC,EAAE,CAAC,CAAA;IAC1C,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,SAAsC,EACtC,GAAW;IAEX,MAAM,MAAM,GAAG,mBAAmB,CAAC,SAAS,CAAC,CAAA;IAC7C,IAAI,CAAC,MAAM;QAAE,OAAM;IAEnB,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,EAAE,KAAsD,CAAA;IACrF,2EAA2E;IAC3E,kEAAkE;IAClE,IAAI,QAAQ,IAAI,QAAQ,CAAC,IAAI,KAAK,SAAS,IAAI,OAAO,QAAQ,CAAC,KAAK,KAAK,QAAQ,IAAI,QAAQ,CAAC,KAAK,IAAI,GAAG,EAAE,CAAC;QAC3G,OAAM;IACR,CAAC;IACD,MAAM,CAAC,KAAK,GAAG;QACb,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;QACvB,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE;KACvC,CAAA;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAmB;IAC7C,OAAO,EAAE,UAAU;IACnB,OAAO,CAAC,GAAW;QACjB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAA;YACjC,OAAO;gBACL,cAAc,EAAE,GAAG,CAAC,MAAM;gBAC1B,MAAM,EAAE,EAAE;gBACV,OAAO,EAAE,EAAE;gBACX,MAAM,EAAE,KAAK;gBACb,SAAS,EAAE,EAAE;gBACb,eAAe,EAAE,GAAG,CAAC,MAAM,KAAK,CAAC,IAAI,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,SAAS;gBAC9E,WAAW,EAAE,KAAK;aACnB,CAAA;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,cAAc,EAAE,CAAC;gBACjB,MAAM,EAAE,EAAE;gBACV,OAAO,EAAE,EAAE;gBACX,MAAM,EAAE,KAAK;gBACb,SAAS,EAAE,EAAE;gBACb,eAAe,EAAE,KAAK;gBACtB,WAAW,EAAE,IAAI;gBACjB,UAAU,EAAG,GAAa,CAAC,OAAO;aACnC,CAAA;QACH,CAAC;IACH,CAAC;CACF,CAAA"}
@@ -0,0 +1,14 @@
1
+ /**
2
+ * Shared gate rules. Dialect-independent decisions.
3
+ * A new dialect must not copy these lists — it must call them.
4
+ */
5
+ export declare const WRITE_TOKENS: readonly ["DROP ", "TRUNCATE ", "DELETE ", "UPDATE ", "INSERT ", "ALTER ", "CREATE ", "GRANT ", "REVOKE ", "MERGE ", "COPY ", "CALL ", "DO ", "VACUUM "];
6
+ export declare const SAFE_BUILTIN_FUNCTIONS: Set<string>;
7
+ export declare const BLOCKED_DUMP_FUNCTIONS: Set<string>;
8
+ export declare function normalizedSqlHead(sql: string): string;
9
+ export declare function isSelectOrWith(norm: string): boolean;
10
+ export declare function findWriteToken(norm: string): string | undefined;
11
+ export declare function hasRowLockClause(norm: string): boolean;
12
+ export declare function isSafeBuiltinFunction(baseName: string, schema?: string): boolean;
13
+ export declare function isBlockedDumpFunction(baseName: string): boolean;
14
+ //# sourceMappingURL=rules.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../../src/sql-gate/rules.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,YAAY,0JAGf,CAAA;AAEV,eAAO,MAAM,sBAAsB,aAgCjC,CAAA;AAEF,eAAO,MAAM,sBAAsB,aAMjC,CAAA;AAEF,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGpD;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAM/D;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAEhF;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE/D"}
@@ -0,0 +1,73 @@
1
+ /**
2
+ * Shared gate rules. Dialect-independent decisions.
3
+ * A new dialect must not copy these lists — it must call them.
4
+ */
5
+ export const WRITE_TOKENS = [
6
+ 'DROP ', 'TRUNCATE ', 'DELETE ', 'UPDATE ', 'INSERT ', 'ALTER ', 'CREATE ',
7
+ 'GRANT ', 'REVOKE ', 'MERGE ', 'COPY ', 'CALL ', 'DO ', 'VACUUM ',
8
+ ];
9
+ export const SAFE_BUILTIN_FUNCTIONS = new Set([
10
+ 'abs',
11
+ 'avg',
12
+ 'btrim',
13
+ 'ceil',
14
+ 'ceiling',
15
+ 'char_length',
16
+ 'coalesce',
17
+ 'concat',
18
+ 'concat_ws',
19
+ 'convert_to',
20
+ 'count',
21
+ 'encode',
22
+ 'floor',
23
+ 'greatest',
24
+ 'least',
25
+ 'length',
26
+ 'lower',
27
+ 'ltrim',
28
+ 'max',
29
+ 'min',
30
+ 'nullif',
31
+ 'octet_length',
32
+ 'regexp_replace',
33
+ 'regexp_split_to_array',
34
+ 'replace',
35
+ 'round',
36
+ 'rtrim',
37
+ 'split_part',
38
+ 'sum',
39
+ 'trim',
40
+ 'upper',
41
+ ]);
42
+ export const BLOCKED_DUMP_FUNCTIONS = new Set([
43
+ 'array_agg',
44
+ 'json_agg',
45
+ 'jsonb_agg',
46
+ 'row_to_json',
47
+ 'string_agg',
48
+ ]);
49
+ export function normalizedSqlHead(sql) {
50
+ return ` ${sql.trim().toUpperCase().replace(/\s+/g, ' ')} `;
51
+ }
52
+ export function isSelectOrWith(norm) {
53
+ const head = norm.trimStart();
54
+ return head.startsWith('SELECT') || head.startsWith('WITH');
55
+ }
56
+ export function findWriteToken(norm) {
57
+ for (const tok of WRITE_TOKENS) {
58
+ const regex = new RegExp(`\\b${tok.trim()}\\b`);
59
+ if (regex.test(norm))
60
+ return tok.trim();
61
+ }
62
+ return undefined;
63
+ }
64
+ export function hasRowLockClause(norm) {
65
+ return /\bFOR\s+(?:UPDATE|SHARE|NO\s+KEY\s+UPDATE|KEY\s+SHARE)\b/.test(norm);
66
+ }
67
+ export function isSafeBuiltinFunction(baseName, schema) {
68
+ return SAFE_BUILTIN_FUNCTIONS.has(baseName) && (!schema || schema === 'pg_catalog');
69
+ }
70
+ export function isBlockedDumpFunction(baseName) {
71
+ return BLOCKED_DUMP_FUNCTIONS.has(baseName);
72
+ }
73
+ //# sourceMappingURL=rules.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"rules.js","sourceRoot":"","sources":["../../src/sql-gate/rules.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS;IAC1E,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS;CACzD,CAAA;AAEV,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,GAAG,CAAC;IAC5C,KAAK;IACL,KAAK;IACL,OAAO;IACP,MAAM;IACN,SAAS;IACT,aAAa;IACb,UAAU;IACV,QAAQ;IACR,WAAW;IACX,YAAY;IACZ,OAAO;IACP,QAAQ;IACR,OAAO;IACP,UAAU;IACV,OAAO;IACP,QAAQ;IACR,OAAO;IACP,OAAO;IACP,KAAK;IACL,KAAK;IACL,QAAQ;IACR,cAAc;IACd,gBAAgB;IAChB,uBAAuB;IACvB,SAAS;IACT,OAAO;IACP,OAAO;IACP,YAAY;IACZ,KAAK;IACL,MAAM;IACN,OAAO;CACR,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,GAAG,CAAC;IAC5C,WAAW;IACX,UAAU;IACV,WAAW;IACX,aAAa;IACb,YAAY;CACb,CAAC,CAAA;AAEF,MAAM,UAAU,iBAAiB,CAAC,GAAW;IAC3C,OAAO,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,CAAA;AAC7D,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,EAAE,CAAA;IAC7B,OAAO,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAA;AAC7D,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;QAC/C,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO,GAAG,CAAC,IAAI,EAAE,CAAA;IACzC,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,OAAO,0DAA0D,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AAC9E,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,QAAgB,EAAE,MAAe;IACrE,OAAO,sBAAsB,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,MAAM,IAAI,MAAM,KAAK,YAAY,CAAC,CAAA;AACrF,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,QAAgB;IACpD,OAAO,sBAAsB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;AAC7C,CAAC"}
@@ -0,0 +1,31 @@
1
+ /**
2
+ * Questions every SQL dialect must answer. The AST type is not shared.
3
+ * pgsql-ast-parser is an input, not a decision.
4
+ *
5
+ * A dialect that only implements `inspect` is not supported. Support means
6
+ * the C vector set is green against that dialect. This file is the contract.
7
+ */
8
+ export type SqlDialectId = 'postgres' | 'mssql' | 'oracle';
9
+ export interface DialectQuestions {
10
+ /** 0 when parse failed. */
11
+ statementCount: number;
12
+ /** schema.table, already folded the way that dialect folds. */
13
+ tables: string[];
14
+ /** Output / referenced column names the adapter could name. */
15
+ columns: string[];
16
+ writes: boolean;
17
+ functions: string[];
18
+ /** True when the adapter saw a native row-limit node it understands. */
19
+ hasRowLimitNode: boolean;
20
+ parseFailed: boolean;
21
+ parseError?: string;
22
+ }
23
+ export interface DialectAdapter {
24
+ readonly dialect: SqlDialectId;
25
+ /**
26
+ * Fail-closed: unparseable input sets parseFailed. It does not throw
27
+ * past the gate, and it does not invent an empty analysis.
28
+ */
29
+ inspect(sql: string): DialectQuestions;
30
+ }
31
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/sql-gate/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,OAAO,GAAG,QAAQ,CAAA;AAE1D,MAAM,WAAW,gBAAgB;IAC/B,2BAA2B;IAC3B,cAAc,EAAE,MAAM,CAAA;IACtB,+DAA+D;IAC/D,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,+DAA+D;IAC/D,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,MAAM,EAAE,OAAO,CAAA;IACf,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,wEAAwE;IACxE,eAAe,EAAE,OAAO,CAAA;IACxB,WAAW,EAAE,OAAO,CAAA;IACpB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAA;IAC9B;;;OAGG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,CAAA;CACvC"}
@@ -0,0 +1,9 @@
1
+ /**
2
+ * Questions every SQL dialect must answer. The AST type is not shared.
3
+ * pgsql-ast-parser is an input, not a decision.
4
+ *
5
+ * A dialect that only implements `inspect` is not supported. Support means
6
+ * the C vector set is green against that dialect. This file is the contract.
7
+ */
8
+ export {};
9
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/sql-gate/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}
package/dist/types.d.ts CHANGED
@@ -18,6 +18,12 @@ export interface GovernancePolicy {
18
18
  maskColumns?: string[];
19
19
  /** Hard cap on rows returned to the AI assistant (default 100). */
20
20
  maxRows?: number;
21
+ /**
22
+ * Which SQL gate the shipped `query` tool uses. Operator declaration —
23
+ * never inferred from the statement. Omitted = `postgres` (today's path).
24
+ * Unknown values reject the config; they do not fall back.
25
+ */
26
+ dialect?: 'postgres' | 'mssql' | 'oracle';
21
27
  /**
22
28
  * Mask names that the text itself marks as names — a title ("Sn. Ahmet
23
29
  * Yılmaz") or a field label ("Yetkili: Ayşe Demir"). Default true.
@@ -1 +1 @@
1
- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,eAAe,EAAE,CAAA;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,sDAAsD;IACtD,MAAM,CAAC,EAAE,gBAAgB,CAAA;IACzB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,WAAW,CAAA;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,kHAAkH;IAClH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;IACtB,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;IACrB,qFAAqF;IACrF,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;IACtB,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;;OAIG;IACH,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,GAAG,QAAQ,CAAA;IACzC;;;;;;;;;;;OAWG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,qDAAqD;IACrD,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;IACrB,wBAAwB;IACxB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;IACpB,iFAAiF;IACjF,eAAe,CAAC,EAAE,MAAM,EAAE,CAAA;IAC1B,kEAAkE;IAClE,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;IACzB;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;IACzC;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACtC;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,eAAe,CAAA;IAC3B;;;;;;;OAOG;IACH,cAAc,CAAC,EAAE,gBAAgB,EAAE,CAAA;CACpC;AAED,gFAAgF;AAChF,MAAM,WAAW,gBAAgB;IAC/B,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAA;IACZ,uDAAuD;IACvD,OAAO,EAAE,MAAM,CAAA;IACf,mFAAmF;IACnF,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,iEAAiE;IACjE,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,wCAAwC;AACxC,MAAM,WAAW,eAAe;IAC9B,6BAA6B;IAC7B,EAAE,CAAC,EAAE,OAAO,CAAA;IACZ,sCAAsC;IACtC,GAAG,CAAC,EAAE,OAAO,CAAA;CACd;AAED,2DAA2D;AAC3D,MAAM,WAAW,cAAc;IAC7B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;IACtB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAC5B;AAED,MAAM,WAAW,WAAW;IAC1B,wEAAwE;IACxE,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,2GAA2G;IAC3G,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,iEAAiE;IACjE,YAAY,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;IAClE,yDAAyD;IACzD,aAAa,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;CAClD;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,UAAU,GAAG,UAAU,GAAG,eAAe,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAA;IACjG,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC/B;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,YAAY,EAAE,CAAA;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,OAAO,CAAA;IACjB,SAAS,EAAE,OAAO,CAAA;IAClB,SAAS,EAAE,OAAO,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAA;IAC/B,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,OAAO,CAAA;IACjB,aAAa,EAAE,OAAO,CAAA;IACtB,gBAAgB,EAAE,OAAO,CAAA;IACzB,SAAS,EAAE,OAAO,CAAA;CACnB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,qBAAqB,CAAA;IACnC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IAC3B,UAAU,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAAA;IACpC,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAA;IAClD,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAAA;IAC5D,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAAA;CAC/D"}