@ganju/utils 0.0.16 → 0.0.18

package/dist/dataQueries.js

@@ -0,0 +1,513 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runQuery = exports.queriesFor = exports.dropQuery = exports.saveQuery = exports.listQueries = exports.checkQueryPlan = exports.compileQuerySql = exports.DATA_DEFAULT_QUERY_ROWS = exports.DATA_MAX_QUERY_PARAMS = exports.DATA_MAX_QUERY_SQL = exports.DATA_MAX_QUERIES = exports.DATA_QUERY_PARAM_TYPES = void 0;
+// Named queries: a SELECT the owner writes once, with named parameters, for
+// reports the structured query can't express. Functions run them by name, and
+// so may the assistant when the owner allows it; nobody sends SQL at run time.
+//
+// A Durable Object refuses `PRAGMA query_only`, so nothing in SQLite stops a
+// statement from writing. The check when a query is saved is the whole guard,
+// in two layers:
+// - our tokenizer: one statement, starting with SELECT or WITH, naming none
+//   of SQLite's or our own tables, with named parameters only. A Durable
+//   Object's exec runs every statement in a string ("SELECT 1; DELETE FROM
+//   orders" deletes), so the single statement is checked here, on tokens.
+// - SQLite's own parser: the statement is compiled with EXPLAIN, never run,
+//   and refused if its program opens anything for writing or reads a table
+//   that isn't one of the owner's.
+const dataIdentifiers_1 = require("./dataIdentifiers");
+const dataCompiler_1 = require("./dataCompiler");
+const dataTypes_1 = require("./dataTypes");
+exports.DATA_QUERY_PARAM_TYPES = [
+    'text',
+    'integer',
+    'decimal',
+    'boolean',
+    'date',
+    'datetime'
+];
+exports.DATA_MAX_QUERIES = 100;
+exports.DATA_MAX_QUERY_SQL = 10_000;
+exports.DATA_MAX_QUERY_PARAMS = 20;
+exports.DATA_DEFAULT_QUERY_ROWS = 100;
+const WORD_START = /[\p{L}_]/u;
+const WORD_PART = /[\p{L}\p{N}_$]/u;
+const unterminated = (what) => new dataTypes_1.DataError(`The SQL has an unterminated ${what}.`);
+// SQLite's lexical rules, as far as telling statements, names, literals and
+// parameters apart needs: comments and whitespace are dropped, everything
+// else becomes a token that keeps its place in the text.
+const tokenize = (sql) => {
+    const tokens = [];
+    let i = 0;
+    const push = (kind, start, end) => tokens.push({ kind, text: sql.slice(start, end), start, end });
+    while (i < sql.length) {
+        const ch = sql[i];
+        if (/\s/.test(ch)) {
+            i++;
+        }
+        else if (ch === '-' && sql[i + 1] === '-') {
+            const end = sql.indexOf('\n', i);
+            i = end === -1 ? sql.length : end + 1;
+        }
+        else if (ch === '/' && sql[i + 1] === '*') {
+            const end = sql.indexOf('*/', i + 2);
+            if (end === -1)
+                throw unterminated('comment');
+            i = end + 2;
+        }
+        else if (ch === "'" || ch === '"' || ch === '`' || ch === '[') {
+            const close = ch === '[' ? ']' : ch;
+            let j = i + 1;
+            for (;;) {
+                if (j >= sql.length) {
+                    throw unterminated(ch === "'" ? 'string' : 'quoted name');
+                }
+                if (sql[j] === close) {
+                    // A doubled quote is the quote itself, except in [brackets].
+                    if (close !== ']' && sql[j + 1] === close) {
+                        j += 2;
+                        continue;
+                    }
+                    break;
+                }
+                j++;
+            }
+            push(ch === "'" ? 'string' : 'quoted', i, j + 1);
+            i = j + 1;
+        }
+        else if (ch === ':' || ch === '@' || ch === '$') {
+            let j = i + 1;
+            while (j < sql.length && WORD_PART.test(sql[j]))
+                j++;
+            if (j === i + 1) {
+                push('other', i, j);
+            }
+            else {
+                push('param', i, j);
+            }
+            i = j;
+        }
+        else if (ch === '?') {
+            let j = i + 1;
+            while (j < sql.length && /\d/.test(sql[j]))
+                j++;
+            push('positional', i, j);
+            i = j;
+        }
+        else if (ch === ';') {
+            push('semicolon', i, i + 1);
+            i++;
+        }
+        else if (/\d/.test(ch) || (ch === '.' && /\d/.test(sql[i + 1] ?? ''))) {
+            let j = i + 1;
+            while (j < sql.length && /[\w.]/.test(sql[j]))
+                j++;
+            push('number', i, j);
+            i = j;
+        }
+        else if (WORD_START.test(ch)) {
+            let j = i + 1;
+            while (j < sql.length && WORD_PART.test(sql[j]))
+                j++;
+            push('word', i, j);
+            i = j;
+        }
+        else {
+            push('other', i, i + 1);
+            i++;
+        }
+    }
+    return tokens;
+};
+// A quoted name's text without its quotes, the way SQLite reads it.
+const nameOf = (token) => {
+    if (token.kind !== 'quoted')
+        return token.text.toLowerCase();
+    const inner = token.text.slice(1, -1);
+    const quote = token.text[0];
+    return (quote === '[' ? inner : inner.split(quote + quote).join(quote)).toLowerCase();
+};
+const FORBIDDEN_WORDS = new Set(['pragma', 'attach', 'detach', 'vacuum']);
+const reservedName = (name) => name.startsWith('_ganju_') ||
+    name.startsWith('sqlite_') ||
+    name.startsWith('pragma_') ||
+    name.includes('__');
+/**
+ * Checks a named query's text and compiles its parameters to positions. Pure:
+ * what only SQLite can tell (that it reads, and what) is checked when it is
+ * saved, by checkQueryPlan.
+ */
+const compileQuerySql = (sql) => {
+    if (typeof sql !== 'string' || !sql.trim()) {
+        throw new dataTypes_1.DataError('"sql" is the SELECT to run.');
+    }
+    if (sql.length > exports.DATA_MAX_QUERY_SQL) {
+        throw new dataTypes_1.DataError(`A named query is up to ${exports.DATA_MAX_QUERY_SQL.toLocaleString('en-US')} characters.`);
+    }
+    const tokens = tokenize(sql);
+    // Trailing semicolons are harmless; any other ends the statement early, and
+    // what follows would run as a second one.
+    while (tokens.length && tokens[tokens.length - 1].kind === 'semicolon') {
+        tokens.pop();
+    }
+    if (tokens.some(t => t.kind === 'semicolon')) {
+        throw new dataTypes_1.DataError('A named query is one statement: remove the ";" inside it.');
+    }
+    const head = tokens[0];
+    if (!head ||
+        head.kind !== 'word' ||
+        !['select', 'with'].includes(head.text.toLowerCase())) {
+        throw new dataTypes_1.DataError('A named query starts with SELECT or WITH; it only reads.');
+    }
+    const params = [];
+    let out = '';
+    let last = 0;
+    for (const token of tokens) {
+        if (token.kind === 'positional') {
+            throw new dataTypes_1.DataError('Use named parameters (:from, :to) instead of "?", so each one can be described.');
+        }
+        if (token.kind === 'word' &&
+            FORBIDDEN_WORDS.has(token.text.toLowerCase())) {
+            throw new dataTypes_1.DataError(`${token.text.toUpperCase()} isn't allowed in a named query.`);
+        }
+        if ((token.kind === 'word' || token.kind === 'quoted') &&
+            reservedName(nameOf(token))) {
+            throw new dataTypes_1.DataError(`"${nameOf(token)}" isn't one of this database's tables or columns; named queries read the tables you defined.`);
+        }
+        if (token.kind === 'param') {
+            const name = token.text.slice(1);
+            if (!dataIdentifiers_1.DATA_IDENTIFIER_PATTERN.test(name)) {
+                throw new dataTypes_1.DataError(`Parameter ${token.text}: use lowercase letters, digits and _, starting with a letter.`);
+            }
+            let index = params.indexOf(name);
+            if (index === -1)
+                index = params.push(name) - 1;
+            out += `${sql.slice(last, token.start)}?${index + 1}`;
+            last = token.end;
+        }
+    }
+    out += sql.slice(last, tokens.length ? tokens[tokens.length - 1].end : 0);
+    if (params.length > exports.DATA_MAX_QUERY_PARAMS) {
+        throw new dataTypes_1.DataError(`A named query takes up to ${exports.DATA_MAX_QUERY_PARAMS} parameters.`);
+    }
+    return { sql: out, params };
+};
+exports.compileQuerySql = compileQuerySql;
+// What SQLite's program does
+// Opcodes that only appear in a program that changes the database file. A
+// SELECT's own scratch tables (ORDER BY, DISTINCT, IN lists) use ephemeral
+// cursors and never these.
+const WRITE_OPCODES = new Set([
+    'OpenWrite',
+    'Clear',
+    'Destroy',
+    'CreateBtree',
+    'ParseSchema',
+    'DropTable',
+    'DropIndex',
+    'DropTrigger',
+    'VUpdate',
+    'VCreate',
+    'VDestroy',
+    'SqlExec',
+    'Vacuum',
+    'IncrVacuum',
+    'SetCookie',
+    'JournalMode'
+]);
+// Virtual tables are opened with VOpen, not OpenRead, and the program names
+// no module. What it does give is the virtual table's address, and the
+// built-in ones (json_each, dbstat) keep one per connection: so json_each's
+// and json_tree's are read off a query of their own, and any other is
+// refused. dbstat, for one, lists every table with its size.
+const ALLOWED_VIRTUAL_TABLES = [
+    "SELECT 1 FROM json_each('[]')",
+    "SELECT 1 FROM json_tree('[]')"
+];
+const virtualTablesOf = (program) => program.filter(step => String(step.opcode) === 'VOpen').map(step => step.p4);
+// SQLite's own error, without the code and offset it appends.
+const sqliteMessage = (error) => (error instanceof Error ? error.message : String(error))
+    .replace(/\s*at offset \d+/, '')
+    .replace(/:\s*SQLITE_\w+$/, '')
+    .trim();
+const placeholders = (count) => Array(count).fill(null);
+/**
+ * Compiles the statement with EXPLAIN (nothing runs) and checks its program:
+ * it may not open anything for writing or start a write transaction, and every
+ * table it reads must be one of `schema`'s. Returns those tables and the plan.
+ */
+const checkQueryPlan = (runner, schema, compiled) => {
+    let program;
+    try {
+        program = runner.all(`EXPLAIN ${compiled.sql}`, placeholders(compiled.params.length));
+    }
+    catch (error) {
+        throw new dataTypes_1.DataError(`The SQL doesn't compile: ${sqliteMessage(error)}.`);
+    }
+    const roots = new Map();
+    for (const row of runner.all("SELECT rootpage, tbl_name FROM sqlite_schema WHERE type IN ('table', 'index')")) {
+        roots.set(Number(row.rootpage), String(row.tbl_name));
+    }
+    const owned = new Set(schema.tables.map(t => t.name));
+    const opened = virtualTablesOf(program);
+    if (opened.length > 0) {
+        const allowed = new Set(ALLOWED_VIRTUAL_TABLES.flatMap(sql => virtualTablesOf(runner.all(`EXPLAIN ${sql}`))));
+        if (opened.some(vtab => typeof vtab !== 'string' || !allowed.has(vtab))) {
+            throw new dataTypes_1.DataError("A named query reads only this database's tables, with json_each and json_tree for JSON; not other virtual tables such as dbstat.");
+        }
+    }
+    const tables = new Set();
+    for (const step of program) {
+        const opcode = String(step.opcode);
+        if (WRITE_OPCODES.has(opcode) ||
+            (opcode === 'Transaction' && Number(step.p2) !== 0)) {
+            throw new dataTypes_1.DataError('A named query only reads: this one would change the database.');
+        }
+        if (opcode === 'OpenRead') {
+            const table = roots.get(Number(step.p2));
+            if (!table || !owned.has(table)) {
+                throw new dataTypes_1.DataError(`A named query reads only this database's tables${table ? `, not "${table}"` : ''}.`);
+            }
+            tables.add(table);
+        }
+    }
+    const plan = runner
+        .all(`EXPLAIN QUERY PLAN ${compiled.sql}`, placeholders(compiled.params.length))
+        .map(row => String(row.detail));
+    return { tables: [...tables].sort(), plan };
+};
+exports.checkQueryPlan = checkQueryPlan;
+const parseList = (raw) => {
+    try {
+        const value = JSON.parse(String(raw));
+        return Array.isArray(value) ? value : [];
+    }
+    catch {
+        return [];
+    }
+};
+const fromRow = (row) => {
+    const stored = row;
+    return {
+        name: stored.name,
+        description: stored.description,
+        sql: stored.sql,
+        params: parseList(stored.params),
+        assistant: Boolean(stored.assistant),
+        tables: parseList(stored.tables),
+        plan: parseList(stored.plan),
+        updatedAt: stored.updated_at,
+        updatedBy: stored.updated_by
+    };
+};
+const listQueries = (runner) => runner.all('SELECT * FROM _ganju_queries ORDER BY name').map(fromRow);
+exports.listQueries = listQueries;
+const findQuery = (runner, name) => {
+    const row = typeof name === 'string'
+        ? runner.all('SELECT * FROM _ganju_queries WHERE name = ?', [name])[0]
+        : undefined;
+    if (!row) {
+        const names = (0, exports.listQueries)(runner).map(query => query.name);
+        throw new dataTypes_1.DataError(`There is no named query "${String(name)}". Named queries: ${names.join(', ') || '(none)'}.`, 'not_found');
+    }
+    return fromRow(row);
+};
+const isPlainObject = (value) => value !== null && typeof value === 'object' && !Array.isArray(value);
+const normaliseParams = (raw, used) => {
+    const list = raw === undefined || raw === null ? [] : raw;
+    if (!Array.isArray(list)) {
+        throw new dataTypes_1.DataError('"params" is a list of { name, type, description }.');
+    }
+    const params = list.map((entry, i) => {
+        if (!isPlainObject(entry) || typeof entry.name !== 'string') {
+            throw new dataTypes_1.DataError(`params[${i}] needs a name.`);
+        }
+        if (!exports.DATA_QUERY_PARAM_TYPES.includes(entry.type)) {
+            throw new dataTypes_1.DataError(`Parameter ${entry.name}: "type" is one of ${exports.DATA_QUERY_PARAM_TYPES.join(', ')}.`);
+        }
+        const description = typeof entry.description === 'string' && entry.description.trim()
+            ? entry.description.trim().slice(0, dataTypes_1.DATA_MAX_DESCRIPTION)
+            : null;
+        return {
+            name: entry.name,
+            type: entry.type,
+            ...(description ? { description } : {}),
+            ...(entry.required === false ? { required: false } : {})
+        };
+    });
+    const declared = params.map(p => p.name);
+    const undeclared = used.filter(name => !declared.includes(name));
+    if (undeclared.length) {
+        throw new dataTypes_1.DataError(`Declare the type of ${undeclared.map(n => `:${n}`).join(', ')} in "params".`);
+    }
+    const unused = declared.filter(name => !used.includes(name));
+    if (unused.length) {
+        throw new dataTypes_1.DataError(`The SQL doesn't use ${unused.map(n => `:${n}`).join(', ')}.`);
+    }
+    return used.map(name => params.find(p => p.name === name));
+};
+/**
+ * Saves a named query, replacing one by the same name. Refused unless it
+ * passes both checks; the tables it reads and its plan are kept with it.
+ */
+const saveQuery = (runner, schema, caller, input) => {
+    if (!isPlainObject(input))
+        throw new dataTypes_1.DataError('A named query is an object.');
+    const name = input.name;
+    if (typeof name !== 'string' || !dataIdentifiers_1.DATA_IDENTIFIER_PATTERN.test(name)) {
+        throw new dataTypes_1.DataError('A named query needs a name: lowercase letters, digits and _, starting with a letter.');
+    }
+    const compiled = (0, exports.compileQuerySql)(input.sql);
+    const params = normaliseParams(input.params, compiled.params);
+    const { tables, plan } = (0, exports.checkQueryPlan)(runner, schema, compiled);
+    const description = typeof input.description === 'string' && input.description.trim()
+        ? input.description.trim().slice(0, dataTypes_1.DATA_MAX_DESCRIPTION)
+        : null;
+    const exists = runner.all('SELECT 1 FROM _ganju_queries WHERE name = ?', [name]).length >
+        0;
+    if (!exists) {
+        const count = Number(runner.all('SELECT count(*) AS n FROM _ganju_queries')[0]?.n ?? 0);
+        if (count >= exports.DATA_MAX_QUERIES) {
+            throw new dataTypes_1.DataError(`A database holds up to ${exports.DATA_MAX_QUERIES} named queries.`);
+        }
+    }
+    runner.all(`INSERT INTO _ganju_queries (name, description, sql, params, assistant, tables, plan, updated_at, updated_by)
+     VALUES (?, ?, ?, ?, ?, ?, ?, strftime('%Y-%m-%dT%H:%M:%fZ', 'now'), ?)
+     ON CONFLICT(name) DO UPDATE SET description = excluded.description, sql = excluded.sql,
+       params = excluded.params, assistant = excluded.assistant, tables = excluded.tables,
+       plan = excluded.plan, updated_at = excluded.updated_at, updated_by = excluded.updated_by`, [
+        name,
+        description,
+        input.sql.trim(),
+        JSON.stringify(params),
+        input.assistant === true ? 1 : 0,
+        JSON.stringify(tables),
+        JSON.stringify(plan),
+        caller.actor
+    ]);
+    return findQuery(runner, name);
+};
+exports.saveQuery = saveQuery;
+const dropQuery = (runner, name) => {
+    const query = findQuery(runner, name);
+    runner.all('DELETE FROM _ganju_queries WHERE name = ?', [query.name]);
+    return { dropped: query.name };
+};
+exports.dropQuery = dropQuery;
+// The queries a caller may run: all of them, or for a channel bot those the
+// owner let the assistant run that read only tables it may read, none of
+// them scoped to a customer. A named query's SQL can't be scoped, so it could
+// read every customer's rows.
+const mayRun = (schema, caller, query) => {
+    if (caller.tables &&
+        !query.tables.every(name => caller.tables?.includes(name))) {
+        return false;
+    }
+    if (!caller.restricted)
+        return true;
+    if (!query.assistant)
+        return false;
+    return query.tables.every(name => {
+        const table = schema.tables.find(t => t.name === name);
+        return Boolean(table && dataTypes_1.DATA_ACCESS_RANK[table.access] >= 1 && !(0, dataCompiler_1.isScoped)(caller, table));
+    });
+};
+const queriesFor = (runner, schema, caller) => (0, exports.listQueries)(runner).filter(query => mayRun(schema, caller, query));
+exports.queriesFor = queriesFor;
+// A parameter's value as the column of its type would store it.
+const bindParam = (param, value, timeZone) => {
+    const column = {
+        name: param.name,
+        type: param.type,
+        required: param.required !== false
+    };
+    try {
+        return (0, dataCompiler_1.toStored)({ name: 'params' }, column, value, timeZone);
+    }
+    catch (error) {
+        if (error instanceof dataTypes_1.DataError) {
+            throw new dataTypes_1.DataError(error.message.replace(/^params\./, 'Parameter '));
+        }
+        throw error;
+    }
+};
+/**
+ * Runs a named query with `params`, up to `limit` rows (100 by default, 500 at
+ * most) and 1 MB. A query that would scan a table over 200,000 rows is refused
+ * before it runs: the database serves one request at a time.
+ */
+const runQuery = (runner, schema, caller, args) => {
+    if (!isPlainObject(args))
+        throw new dataTypes_1.DataError('Arguments are an object.');
+    const query = findQuery(runner, args.name ?? args.query);
+    if (!mayRun(schema, caller, query)) {
+        throw new dataTypes_1.DataError(`There is no named query "${query.name}" the assistant may run.`, 'not_found');
+    }
+    const given = args.params === undefined || args.params === null ? {} : args.params;
+    if (!isPlainObject(given)) {
+        throw new dataTypes_1.DataError('"params" is an object, e.g. { "from": "2026-10-01" }.');
+    }
+    const unknown = Object.keys(given).filter(key => !query.params.some(p => p.name === key));
+    if (unknown.length) {
+        throw new dataTypes_1.DataError(`${query.name} takes ${query.params.map(p => p.name).join(', ') || 'no parameters'}; not ${unknown.join(', ')}.`);
+    }
+    const limit = args.limit === undefined || args.limit === null
+        ? exports.DATA_DEFAULT_QUERY_ROWS
+        : args.limit;
+    if (typeof limit !== 'number' ||
+        !Number.isInteger(limit) ||
+        limit < 1 ||
+        limit > dataTypes_1.DATA_MAX_PAGE) {
+        throw new dataTypes_1.DataError(`"limit" is 1 to ${dataTypes_1.DATA_MAX_PAGE}.`);
+    }
+    const values = query.params.map(param => bindParam(param, given[param.name], caller.timeZone));
+    const compiled = (0, exports.compileQuerySql)(query.sql);
+    // A full scan shows in the plan as "SCAN x", with or without "USING
+    // (COVERING) INDEX": either way it reads every row, and on a large table
+    // that is the request everyone else waits behind.
+    const scans = query.plan.some(line => {
+        const detail = line.trim();
+        return (detail.startsWith('SCAN ') &&
+            !detail.startsWith('SCAN CONSTANT ROW') &&
+            !detail.includes('VIRTUAL TABLE'));
+    });
+    if (scans) {
+        for (const name of query.tables) {
+            const n = Number(runner.all(`SELECT max(id) AS n FROM ${(0, dataIdentifiers_1.quoteIdentifier)(name)}`)[0]?.n ?? 0);
+            if (n > dataTypes_1.DATA_LARGE_TABLE_ROWS) {
+                throw new dataTypes_1.DataError(`${query.name} reads all of ${name}, which has about ${n.toLocaleString('en-US')} rows; filter on an indexed column (id, or a column marked filterable, unique or a relation).`, 'too_large');
+            }
+        }
+    }
+    const rows = [];
+    let bytes = 0;
+    let truncated = false;
+    try {
+        for (const row of runner.iterate(compiled.sql, values)) {
+            if (rows.length === limit) {
+                truncated = true;
+                break;
+            }
+            const size = JSON.stringify(row).length;
+            if (rows.length > 0 && bytes + size > dataTypes_1.DATA_MAX_RESULT_BYTES) {
+                truncated = true;
+                break;
+            }
+            bytes += size;
+            rows.push({ ...row });
+        }
+    }
+    catch (error) {
+        throw new dataTypes_1.DataError(`${query.name} failed: ${sqliteMessage(error)}.`);
+    }
+    return {
+        query: query.name,
+        rows,
+        ...(truncated
+            ? {
+                truncated: `stopped at ${rows.length} rows; narrow the parameters or ask the owner for a query that returns fewer`
+            }
+            : {})
+    };
+};
+exports.runQuery = runQuery;

package/dist/dataRpc.d.ts

@@ -1,4 +1,6 @@
 import type { DataCaller, DataDeleteImpact, DataResult, DataSchema, DataTable, DataTableCopy } from './dataTypes';
+import type { DataQuery } from './dataQueries';
+import type { DataTrigger, DataTriggerWithSecret, SavedTrigger } from './dataTriggers';
 export type ExportFormat = 'jsonl' | 'csv';
 export interface ExportFile {
     table: string | null;
@@ -36,6 +38,7 @@ export interface DatabaseInfo {
     initializedAt: string | null;
     deletedAt: string | null;
     firstWriteAt: string | null;
+    timeZone: string | null;
     schemaVersion: number;
     size: number;
     tables: {
@@ -62,6 +65,9 @@ export interface ProjectDatabaseRpc {
     size(): R<{
         bytes: number;
     }>;
+    setTimeZone(caller: DataCaller, args: {
+        timeZone: string | null;
+    }): R<DatabaseInfo>;
     markDeleted(caller: DataCaller): R<{
         deletedAt: string | null;
         bookmark: string;
@@ -117,6 +123,44 @@ export interface ProjectDatabaseRpc {
         limit?: number;
         cursor?: number;
     }): R<unknown>;
+    listQueries(caller: DataCaller): R<DataQuery[]>;
+    saveQuery(caller: DataCaller, input: unknown): R<DataQuery>;
+    dropQuery(caller: DataCaller, name: string): R<{
+        dropped: string;
+    }>;
+    runQuery(caller: DataCaller, args: {
+        name: string;
+        params?: Record<string, unknown>;
+        limit?: number;
+    }): R<{
+        query: string;
+        rows: Record<string, unknown>[];
+        truncated?: string;
+    }>;
+    listTriggers(caller: DataCaller): R<{
+        triggers: DataTrigger[];
+        pending: number;
+    }>;
+    getTrigger(nameOrId: string): R<DataTriggerWithSecret>;
+    saveTrigger(caller: DataCaller, input: unknown): R<SavedTrigger>;
+    dropTrigger(caller: DataCaller, name: string): R<{
+        dropped: string;
+    }>;
+    setTriggerEnabled(caller: DataCaller, args: {
+        name: string;
+        enabled: boolean;
+        reason?: string | null;
+    }): R<DataTrigger>;
+    replaceManagedTriggers(caller: DataCaller, inputs: unknown): R<{
+        triggers: DataTrigger[];
+        removed: string[];
+        secrets: Record<string, string>;
+    }>;
+    clearOutbox(args: {
+        before: number;
+    }): R<{
+        cleared: number;
+    }>;
     exportStart(caller: DataCaller, args?: {
         format?: ExportFormat;
     }): R<{

package/dist/dataRpc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dataRpc.d.ts","sourceRoot":"","sources":["../src/dataRpc.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,UAAU,EACV,gBAAgB,EAChB,UAAU,EACV,UAAU,EACV,SAAS,EACT,aAAa,EACd,MAAM,aAAa,CAAC;AAErB,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,KAAK,CAAC;AAE3C,MAAM,WAAW,UAAU;IAEzB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE;QACN,GAAG,EAAE,MAAM,CAAC;QACZ,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE;YAAE,UAAU,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;QAC9C,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QAGd,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;KACzB,GAAG,IAAI,CAAC;IACT,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAGlE,IAAI,EAAE,aAAa,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,KAAK,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;AAEnC,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,IAAI,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,CAAC,CAAC,YAAY,CAAC,CAAC;IAClE,IAAI,IAAI,CAAC,CAAC,YAAY,CAAC,CAAC;IACxB,MAAM,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,CAAC,CAAC,YAAY,CAAC,CAAC;IAChD,IAAI,IAAI,CAAC,CAAC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7B,WAAW,CACT,MAAM,EAAE,UAAU,GACjB,CAAC,CAAC;QAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrD,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,CAAC,CAAC,YAAY,CAAC,CAAC;IAC9C,KAAK,IAAI,CAAC,CAAC;QAAE,MAAM,EAAE,IAAI,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,eAAe,IAAI,CAAC,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3C,SAAS,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,CAAC,CAAC,aAAa,CAAC,CAAC;IAC7E,iBAAiB,CAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,CAAC,CAAC,aAAa,CAAC,CAAC;IAChE,UAAU,IAAI,CAAC,CAAC,UAAU,CAAC,CAAC;IAC5B,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC;IAC9D,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC;IAC7E,SAAS,CACP,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,MAAM,GACZ,CAAC,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5C,SAAS,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC;IAC3E,YAAY,CACV,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,OAAO,GACb,CAAC,CAAC;QAAE,KAAK,EAAE,SAAS,CAAC;QAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,IAAI,EAAE,aAAa,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;IAChF,UAAU,CACR,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,CAAC,CAAC;QAAE,KAAK,EAAE,SAAS,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,aAAa,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;IAEzE,WAAW,CAAC,MAAM,EAAE,UAAU,GAAG,CAAC,CAAC;QAAE,IAAI,EAAE,IAAI,CAAA;KAAE,CAAC,CAAC;IACnD,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC;IACzD,KAAK,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC;IACrD,KAAK,CACH,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,OAAO,GACZ,CAAC,CAAC;QAAE,EAAE,EAAE,IAAI,CAAC;QAAC,OAAO,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC,CAAC;IACvC,YAAY,CACV,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GACtC,CAAC,CAAC,gBAAgB,CAAC,CAAC;IACvB,OAAO,CACL,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GACnE,CAAC,CAAC,OAAO,CAAC,CAAC;IACd,WAAW,CACT,MAAM,EAAE,UAAU,EAClB,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,YAAY,CAAA;KAAE,GAC/B,CAAC,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAA;KAAE,CAAC,CAAC;IAC1D,YAAY,CAAC,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC;CAC5D"}
+{"version":3,"file":"dataRpc.d.ts","sourceRoot":"","sources":["../src/dataRpc.ts"],"names":[],"mappings":"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"}

package/dist/dataTools.d.ts

@@ -0,0 +1,40 @@
+import type { DataCaller, DataSchema } from './dataTypes';
+import type { DataQuery } from './dataQueries';
+export declare const DATA_TOOL_DESCRIBE = "data-describe";
+export declare const DATA_TOOL_QUERY = "data-query";
+export declare const DATA_TOOL_WRITE = "data-write";
+export declare const DATA_TOOL_ADMIN = "data-admin";
+export declare const DATA_TOOL_NAMES: readonly ["data-describe", "data-query", "data-write", "data-admin"];
+export declare const DATA_TOOL_TITLES: Record<string, string>;
+export declare const DATA_TOOL_MAX_LIMIT = 100;
+export interface DataToolDefinition {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+    annotations: {
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        openWorldHint: boolean;
+    };
+}
+/** Whether the caller may use the data tools at all: it sees a table. */
+export declare const hasDataToolTables: (schema: DataSchema, caller: DataCaller) => boolean;
+/**
+ * data-describe, data-query and, when the caller may add rows somewhere,
+ * data-write. Only tables the caller may see are named, so a hidden table
+ * doesn't exist for the model. `queries` are the named queries it may run.
+ */
+export declare const dataToolDefinitions: (schema: DataSchema, caller: DataCaller, options?: {
+    queries?: DataQuery[];
+}) => DataToolDefinition[];
+export declare const DATA_ADMIN_ACTIONS: readonly ["schema", "create_table", "update_table", "drop_table", "add_column", "update_column", "drop_column", "save_query", "drop_query", "import", "export"];
+export type DataAdminAction = (typeof DATA_ADMIN_ACTIONS)[number];
+/**
+ * data-admin: the owner's own MCP client managing the database's structure.
+ * One tool, so it costs one slot in the session it exists in; destructive, so
+ * every call goes through confirmation and, after outside content, the
+ * approval link.
+ */
+export declare const dataAdminToolDefinition: () => DataToolDefinition;
+//# sourceMappingURL=dataTools.d.ts.map

package/dist/dataTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataTools.d.ts","sourceRoot":"","sources":["../src/dataTools.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,UAAU,EAEV,UAAU,EAEX,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C,eAAO,MAAM,kBAAkB,kBAAkB,CAAC;AAClD,eAAO,MAAM,eAAe,eAAe,CAAC;AAC5C,eAAO,MAAM,eAAe,eAAe,CAAC;AAC5C,eAAO,MAAM,eAAe,eAAe,CAAC;AAC5C,eAAO,MAAM,eAAe,sEAKlB,CAAC;AAIX,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAKnD,CAAC;AAIF,eAAO,MAAM,mBAAmB,MAAM,CAAC;AAEvC,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,WAAW,EAAE;QACX,YAAY,EAAE,OAAO,CAAC;QACtB,eAAe,EAAE,OAAO,CAAC;QACzB,aAAa,EAAE,OAAO,CAAC;KACxB,CAAC;CACH;AA2DD,yEAAyE;AACzE,eAAO,MAAM,iBAAiB,GAAI,QAAQ,UAAU,EAAE,QAAQ,UAAU,YACpC,CAAC;AAErC;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAC9B,QAAQ,UAAU,EAClB,QAAQ,UAAU,EAClB,UAAS;IAAE,OAAO,CAAC,EAAE,SAAS,EAAE,CAAA;CAAO,KACtC,kBAAkB,EA6JpB,CAAC;AAEF,eAAO,MAAM,kBAAkB,iKAYrB,CAAC;AACX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAElE;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,QAAO,kBAsCzC,CAAC"}