fastify-auto-sqlapi 0.2.0 → 0.2.2

package/dist/bin/generate-schema.js

@@ -37,10 +37,10 @@ function fileStatus(filename, content) {
 function writeSchemaFiles(tableMap, schemasDir) {
     const report = { created: false, touched: false, untouched: 0, files: new Set() };
     for (const schemaName of Object.keys(tableMap)) {
-        const { name: tableName, fields, colMap, primary } = tableMap[schemaName];
+        const { name: tableName, fields, colMap, primary, generated, isView } = tableMap[schemaName];
         const filename = path.join(schemasDir, `${schemaName}.ts`);
         report.files.add(`${schemaName}.ts`);
-        const content = generateSchemaFile(schemaName, tableName, fields, colMap, primary);
+        const content = generateSchemaFile(schemaName, tableName, fields, colMap, primary, generated, isView);
         const status = fileStatus(filename, content);
         if (status === 'created')
             report.created = true;
@@ -71,6 +71,51 @@ function removeOrphanSchemas(schemasDir, generated) {
     }
     return removed;
 }
+/**
+ * Name the columns the database computes, table by table.
+ *
+ * These are the columns an INSERT or an UPDATE may not mention — both engines reject the
+ * statement — so the generator leaves them out of every write body. Saying so here matters
+ * more than the comment it also writes into the file: the generated source is not always
+ * read, whereas this output is what whoever ran the command actually sees.
+ */
+function reportGeneratedColumns(tableMap) {
+    const withGenerated = Object.keys(tableMap)
+        .map((schemaName) => tableMap[schemaName])
+        .filter((t) => t.generated.length > 0);
+    if (withGenerated.length === 0)
+        return;
+    console.log('');
+    display('Database-computed columns found (GENERATED ALWAYS AS ...):', CONSOLE_COLORS.yellow);
+    for (const table of withGenerated) {
+        display(`  ${table.name}: ${table.generated.join(', ')}`, CONSOLE_COLORS.yellow);
+    }
+    display('  They are readable but rejected by every write, so they are excluded from the insert, ' +
+        'update and bulk bodies. Do not send them: they are computed by the database.', CONSOLE_COLORS.gray);
+}
+/**
+ * Name the relations that are views.
+ *
+ * The generated `Table*.ts` says the same thing in a comment, but a generated source file is
+ * not always read — this output is what whoever ran the command actually sees, and the two
+ * assumptions worth contesting (which column is the key, whether writes make sense) are both
+ * assumptions the generator had to make without the database's help.
+ */
+function reportViews(tableMap) {
+    const views = Object.keys(tableMap)
+        .map((schemaName) => tableMap[schemaName])
+        .filter((t) => t.isView);
+    if (views.length === 0)
+        return;
+    console.log('');
+    display(`Views found: ${views.map((v) => v.name).join(', ')}`, CONSOLE_COLORS.yellow);
+    display('  A view is a table config like any other, but the database reports no PRIMARY KEY for ' +
+        'one. The table generator will NOT invent one: it uses "id" when the view has it and says ' +
+        'so, and otherwise writes a TODO placeholder. Check the key is really unique in the view ' +
+        'before exposing get/update/delete — those address rows by it.', CONSOLE_COLORS.gray);
+    display('  Writes are left off by default: only a view simple enough for the engine to make ' +
+        'updatable accepts one, and an aggregating view rejects every INSERT and UPDATE.', CONSOLE_COLORS.gray);
+}
 function reportOutcome(report) {
     console.log('');
     if (report.untouched > 0) {
@@ -117,6 +162,8 @@ await runCli('fastify-auto-sqlapi: generating schemas', async () => {
         display(`No matching tables found for: ${tableNames.join(', ')}`, CONSOLE_COLORS.magenta);
         return;
     }
+    reportViews(tableMap);
+    reportGeneratedColumns(tableMap);
     const report = writeSchemaFiles(tableMap, schemasDir);
     if (!tableNames.length && removeOrphanSchemas(schemasDir, report.files)) {
         report.touched = true;

package/dist/index.d.ts

@@ -12,7 +12,7 @@ export { resolveTenant } from './lib/tenant.js';
 export { SqlApi, createSqlApi } from './lib/sql-api.js';
 export type { SqlApiOptions, SqlApiSearchParams, SqlApiInsertParams, SqlApiUpdateParams } from './lib/sql-api.js';
 export { default as fastifyAutoSqlApi } from './routes/auto/plugin.js';
-export { setupSwagger } from './lib/setup-swagger.js';
+export { setupSwagger } from './routes/setup-swagger.js';
 export { searchEngine } from './lib/engine/search/search.js';
 export { SearchTableBodyPost, SearchTableQuery, SearchTableQueryString, SearchTableResponse } from './lib/schema/search.js';
 export { default as searchRoutes } from './routes/auto/search.routes.js';
@@ -34,5 +34,5 @@ export { BulkDeleteTableBody, BulkDeleteTableResponse } from './lib/schema/bulk-
 export { default as bulkDeleteRoutes } from './routes/auto/bulk-delete.routes.js';
 export { Type, type Static } from '@sinclair/typebox';
 export { ConditionBuilder, Expression } from 'node-condition-builder';
-export type { SqlApiConfig, ColumnInfo, TableMap, Queryable, TransactionQueryable, SqlResult, DbRecord, DbRecordValue, SelectOptions, SchemaDefinition, JoinDefinition, ITable, TableOperation, DbTables, SqlApiPluginOptions, SwaggerOptions, SearchParams, SearchResult, Paginator, PaginationResult, TableFilterFn, ExtendedConditionFn, FilterRecord, AggregationRequest, JoinGroupRequest, ComputedFieldFn, ComputedFieldContext, ComputedFieldExpr, GetParams, GetResult, DeleteParams, DeleteResult, InsertParams, InsertResult, BulkUpsertItem, BulkUpsertParams, BulkUpsertResult, BulkDeleteParams, BulkDeleteResult, ConditionMethod, SearchCondition, UpdateParams, UpdateResult, TenantId, TenantScope, TenantScopeDirect, TenantScopeIndirect, TenantContext, ValidationError, ValidatorFn, BulkValidatorItem, BulkValidatorFn, } from './types.js';
+export type { SqlApiConfig, ColumnInfo, TableMap, Queryable, TransactionQueryable, SqlResult, DbRecord, DbRecordValue, SelectOptions, SchemaDefinition, JoinDefinition, ITable, TableOperation, DbTables, SqlApiPluginOptions, SwaggerOptions, SearchParams, SearchResult, Paginator, PaginationResult, TableFilterFn, ExtendedConditionFn, FilterRecord, AggregationRequest, JoinGroupRequest, ComputedFieldFn, ComputedFieldContext, ComputedFieldExpr, GetParams, GetResult, DeleteParams, DeleteResult, InsertParams, InsertResult, BulkUpsertItem, BulkUpsertParams, BulkUpsertResult, BulkDeleteParams, BulkDeleteResult, ConditionMethod, SearchCondition, UpdateParams, UpdateResult, TenantId, TenantScope, TenantScopeDirect, TenantScopeIndirect, TenantScopeAnyOf, TenantContext, ValidationError, ValidatorFn, BulkValidatorItem, BulkValidatorFn, } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -21,7 +21,7 @@ export { SqlApi, createSqlApi } from './lib/sql-api.js';
 // Plugin
 export { default as fastifyAutoSqlApi } from './routes/auto/plugin.js';
 // Swagger
-export { setupSwagger } from './lib/setup-swagger.js';
+export { setupSwagger } from './routes/setup-swagger.js';
 // Search
 export { searchEngine } from './lib/engine/search/search.js';
 export { SearchTableBodyPost, SearchTableQuery, SearchTableQueryString, SearchTableResponse } from './lib/schema/search.js';

package/dist/lib/agent/manifest.d.ts

@@ -7,6 +7,8 @@ interface ManifestField {
     nullable?: boolean;
     /** Present (true) when the field is writable but never returned by reads (readExclude). */
     writeOnly?: boolean;
+    /** Present (true) when the field is returned by reads but refused by every write. */
+    readOnly?: boolean;
 }
 interface ManifestJoin {
     alias: string;

package/dist/lib/agent/manifest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../../src/lib/agent/manifest.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAkB,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAOvF,UAAU,aAAa;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,mDAAmD;IACnD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,2FAA2F;IAC3F,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,UAAU,YAAY;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,0FAA0F;IAC1F,IAAI,EAAE,KAAK,GAAG,KAAK,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC3B,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACtC,uFAAuF;IACvF,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,sFAAsF;IACtF,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,qEAAqE;IACrE,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,SAAS,CAAC,EAAE,YAAY,EAAE,CAAC;IAC3B,oEAAoE;IACpE,UAAU,CAAC,EAAE,YAAY,EAAE,CAAC;IAC5B,gFAAgF;IAChF,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;CACvC;AAgCD,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,EAAE,CAInE;AA0DD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,GAAG,aAAa,CAMpE;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,CAkBrE"}
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../../src/lib/agent/manifest.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAkB,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAQvF,UAAU,aAAa;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,mDAAmD;IACnD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,2FAA2F;IAC3F,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,qFAAqF;IACrF,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,UAAU,YAAY;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,0FAA0F;IAC1F,IAAI,EAAE,KAAK,GAAG,KAAK,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC3B,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACtC,uFAAuF;IACvF,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,sFAAsF;IACtF,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,qEAAqE;IACrE,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,SAAS,CAAC,EAAE,YAAY,EAAE,CAAC;IAC3B,oEAAoE;IACpE,UAAU,CAAC,EAAE,YAAY,EAAE,CAAC;IAC5B,gFAAgF;IAChF,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;CACvC;AAgCD,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,EAAE,CAInE;AA4DD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,GAAG,aAAa,CAMpE;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,CAkBrE"}

package/dist/lib/agent/manifest.js

@@ -1,4 +1,5 @@
 import { isCompositePrimary } from '../../types.js';
+import { writeExcludedFields } from '../write-access.js';
 const ALL_OPERATIONS = [
     'search', 'get', 'insert', 'update', 'delete', 'bulkUpsert', 'bulkDelete',
 ];
@@ -45,6 +46,7 @@ function manifestFields(tableConf) {
     const schema = tableConf.Schema;
     const required = new Set((schema.validation.required) ?? []);
     const readExcluded = new Set(tableConf.readExclude ?? []);
+    const writeExcluded = writeExcludedFields(tableConf, schema);
     const fields = {};
     for (const [name, fieldSchema] of Object.entries(schema.fields)) {
         const f = { type: shortType(fieldSchema) };
@@ -54,6 +56,8 @@ function manifestFields(tableConf) {
             f.nullable = true;
         if (readExcluded.has(name))
             f.writeOnly = true;
+        if (writeExcluded.has(name))
+            f.readOnly = true;
         fields[name] = f;
     }
     return fields;

package/dist/lib/cli/mysql-introspect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mysql-introspect.d.ts","sourceRoot":"","sources":["../../../src/lib/cli/mysql-introspect.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAoCD,wBAAgB,0BAA0B,IAAI,qBAAqB,CAmBlE;AAkDD,wBAAsB,qBAAqB,CACzC,gBAAgB,EAAE,qBAAqB,EACvC,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,UAAU,EAAE,CAAC,CA4BvB"}
+{"version":3,"file":"mysql-introspect.d.ts","sourceRoot":"","sources":["../../../src/lib/cli/mysql-introspect.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAsCD,wBAAgB,0BAA0B,IAAI,qBAAqB,CAmBlE;AAuDD,wBAAsB,qBAAqB,CACzC,gBAAgB,EAAE,qBAAqB,EACvC,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,UAAU,EAAE,CAAC,CAkCvB"}

package/dist/lib/cli/mysql-introspect.js

@@ -65,14 +65,21 @@ function mapMysqlType(dataType) {
             return 'varchar';
     }
 }
+/** `EXTRA`, lowercased — MySQL and MariaDB disagree on the case of both key and value. */
+function extra(row) {
+    return String(row.EXTRA || row.extra || '').toLowerCase();
+}
 export async function introspectMysqlTables(connectionConfig, schema) {
     const mysql2 = loadOptionalDependency('mysql2/promise', 'npm install mysql2');
     const connection = await mysql2.createConnection(connectionConfig);
     try {
-        const [rows] = await connection.query(`SELECT table_name, column_name, data_type, column_default, is_nullable, column_key, extra
-       FROM information_schema.columns
-       WHERE table_schema = ?
-       ORDER BY table_name, ordinal_position`, [schema]);
+        const [rows] = await connection.query(`SELECT c.table_name, c.column_name, c.data_type, c.column_default, c.is_nullable,
+              c.column_key, c.extra, t.table_type
+       FROM information_schema.columns c
+       JOIN information_schema.tables t
+         ON t.table_schema = c.table_schema AND t.table_name = c.table_name
+       WHERE c.table_schema = ?
+       ORDER BY c.table_name, c.ordinal_position`, [schema]);
         // `||` is kept as-is from the untyped version: this change types the driver, it does
         // not alter behaviour. The trailing fallbacks only satisfy ColumnInfo, which cannot
         // hold `undefined`.
@@ -83,7 +90,10 @@ export async function introspectMysqlTables(connectionConfig, schema) {
             column_default: row.COLUMN_DEFAULT || row.column_default || null,
             is_nullable: row.IS_NULLABLE || row.is_nullable || '',
             is_primary: (row.COLUMN_KEY || row.column_key) === 'PRI',
-            is_auto_increment: String(row.EXTRA || row.extra || '').includes('auto_increment'),
+            is_auto_increment: extra(row).includes('auto_increment'),
+            // 'VIRTUAL GENERATED' / 'STORED GENERATED': computed from an expression, never writable.
+            is_generated: extra(row).includes('generated'),
+            is_view: (row.TABLE_TYPE || row.table_type) === 'VIEW',
         }));
     }
     finally {

package/dist/lib/cli/pg-introspect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pg-introspect.d.ts","sourceRoot":"","sources":["../../../src/lib/cli/pg-introspect.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAmBjD,wBAAgB,qBAAqB,IAAI,MAAM,CAY9C;AAED,wBAAsB,gBAAgB,CACpC,gBAAgB,EAAE,MAAM,EACxB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,UAAU,EAAE,CAAC,CA6BvB"}
+{"version":3,"file":"pg-introspect.d.ts","sourceRoot":"","sources":["../../../src/lib/cli/pg-introspect.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAmBjD,wBAAgB,qBAAqB,IAAI,MAAM,CAY9C;AAcD,wBAAsB,gBAAgB,CACpC,gBAAgB,EAAE,MAAM,EACxB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,UAAU,EAAE,CAAC,CAmEvB"}

package/dist/lib/cli/pg-introspect.js

@@ -15,20 +15,59 @@ export async function introspectTables(connectionString, schema) {
     const client = new pg.Client({ connectionString });
     try {
         await client.connect();
-        const result = await client.query(`SELECT c.table_name, c.column_name, c.udt_name, c.column_default, c.is_nullable,
-              (pk.column_name IS NOT NULL) AS is_primary
-       FROM information_schema.columns c
-       LEFT JOIN (
-         SELECT kcu.table_name, kcu.column_name
-         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 = $1
-       ) pk ON pk.table_name = c.table_name AND pk.column_name = c.column_name
-       WHERE c.table_schema = $1
-       ORDER BY c.table_name, c.ordinal_position`, [schema]);
-        return result.rows;
+        const result = await client.query(
+        // The UNION picks up materialized views, which `information_schema` does not describe at
+        // all: they live only in `pg_catalog`, and without this half they were silently absent
+        // from every generation run. Their columns are cast to the same shapes the standard view
+        // returns, so the two halves stay union-compatible.
+        `SELECT * FROM (
+         SELECT c.table_name::text, c.column_name::text, c.udt_name::text,
+                c.column_default::text, c.is_nullable::text,
+                c.is_identity::text, c.is_generated::text,
+                (pk.column_name IS NOT NULL) AS is_primary,
+                (t.table_type = 'VIEW') AS is_view,
+                c.ordinal_position::int AS ordinal_position
+         FROM information_schema.columns c
+         JOIN information_schema.tables t
+           ON t.table_schema = c.table_schema AND t.table_name = c.table_name
+         LEFT JOIN (
+           SELECT kcu.table_name, kcu.column_name
+           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 = $1
+         ) pk ON pk.table_name = c.table_name AND pk.column_name = c.column_name
+         WHERE c.table_schema = $1
+         UNION ALL
+         SELECT mc.relname::text, ma.attname::text, mt.typname::text,
+                NULL::text, CASE WHEN ma.attnotnull THEN 'NO' ELSE 'YES' END,
+                'NO'::text, 'NEVER'::text,
+                false, true, ma.attnum::int
+         FROM pg_class mc
+         JOIN pg_namespace mn ON mn.oid = mc.relnamespace
+         JOIN pg_attribute ma
+           ON ma.attrelid = mc.oid AND ma.attnum > 0 AND NOT ma.attisdropped
+         JOIN pg_type mt ON mt.oid = ma.atttypid
+         WHERE mc.relkind = 'm' AND mn.nspname = $1
+       ) cols
+       ORDER BY table_name, ordinal_position`, [schema]);
+        // The query's own columns are spelled out rather than spread: `is_identity` and
+        // `is_generated` arrive as the standard's string enums and `ordinal_position` only exists
+        // to order the union, so none of the three belongs in the `ColumnInfo` handed back.
+        return result.rows.map((row) => ({
+            table_name: row.table_name,
+            column_name: row.column_name,
+            udt_name: row.udt_name,
+            column_default: row.column_default,
+            is_nullable: row.is_nullable,
+            is_primary: row.is_primary,
+            is_view: row.is_view,
+            // An identity column has no `column_default`, so without this flag it is emitted as a
+            // mandatory field and the table cannot be inserted into at all.
+            ...(row.is_identity === 'YES' ? { is_auto_increment: true } : {}),
+            ...(row.is_generated === 'ALWAYS' ? { is_generated: true } : {}),
+        }));
     }
     finally {
         await client.end();

package/dist/lib/cli/schema-codegen.d.ts

@@ -6,6 +6,7 @@ export declare function convertColType(udtName: string, columnInfo: {
     column_default: string | null;
     is_nullable: string;
     is_auto_increment?: boolean;
+    is_generated?: boolean;
 }): string;
 export declare function buildTableMap(rows: ColumnInfo[]): TableMap;
 /**
@@ -15,5 +16,5 @@ export declare function buildTableMap(rows: ColumnInfo[]): TableMap;
  * Returns the names of the excluded tables, in map order.
  */
 export declare function applyExcludeTables(tableMap: TableMap, excludeTables?: string[]): string[];
-export declare function generateSchemaFile(schemaName: string, tableName: string, fields: Record<string, string>, colMap: Record<string, string>, primary?: string[]): string;
+export declare function generateSchemaFile(schemaName: string, tableName: string, fields: Record<string, string>, colMap: Record<string, string>, primary?: string[], generated?: string[], isView?: boolean): string;
 //# sourceMappingURL=schema-codegen.d.ts.map

package/dist/lib/cli/schema-codegen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema-codegen.d.ts","sourceRoot":"","sources":["../../../src/lib/cli/schema-codegen.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE3D;;GAEG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,UAAU,EAAE;IAAE,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAAE,GAC9F,MAAM,CA0DR;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,QAAQ,CAqC1D;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAoBzF;AAED,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,OAAO,CAAC,EAAE,MAAM,EAAE,GACjB,MAAM,CA8CR"}
+{"version":3,"file":"schema-codegen.d.ts","sourceRoot":"","sources":["../../../src/lib/cli/schema-codegen.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE3D;;GAEG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,UAAU,EAAE;IACV,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,GACA,MAAM,CA6DR;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,QAAQ,CA0C1D;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAoBzF;AAED,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,OAAO,CAAC,EAAE,MAAM,EAAE,EAClB,SAAS,CAAC,EAAE,MAAM,EAAE,EACpB,MAAM,CAAC,EAAE,OAAO,GACf,MAAM,CAoDR"}

package/dist/lib/cli/schema-codegen.js

@@ -3,8 +3,10 @@ import { toCamelCase, toSchemaName } from '../naming.js';
  * @testonly Exported only so unit tests can exercise it directly.
  */
 export function convertColType(udtName, columnInfo) {
-    // AUTO_INCREMENT (mysql) behaves like a default: the DB generates the value.
-    const hasDefault = columnInfo.column_default || columnInfo.is_auto_increment;
+    // AUTO_INCREMENT (mysql) and IDENTITY (postgres) behave like a default: the DB generates
+    // the value. A generated column goes further — it refuses one — so it can never be a
+    // mandatory field either, whatever its nullability says.
+    const hasDefault = columnInfo.column_default || columnInfo.is_auto_increment || columnInfo.is_generated;
     const isNullable = columnInfo.is_nullable === 'YES';
     const wrap = (t) => {
         // Nullable columns need the type-array form (`Nullable(T)` → type: [..., 'null']):
@@ -69,6 +71,8 @@ export function buildTableMap(rows) {
                 fields: {},
                 colMap: {},
                 primary: [],
+                generated: [],
+                isView: row.is_view === true,
             };
         }
         const fieldName = toCamelCase(row.column_name);
@@ -85,6 +89,9 @@ export function buildTableMap(rows) {
         if (row.is_primary) {
             acc[schemaName].primary.push(fieldName);
         }
+        if (row.is_generated) {
+            acc[schemaName].generated.push(fieldName);
+        }
         return acc;
     }, {});
 }
@@ -113,10 +120,16 @@ export function applyExcludeTables(tableMap, excludeTables) {
     }
     return excluded;
 }
-export function generateSchemaFile(schemaName, tableName, fields, colMap, primary) {
+export function generateSchemaFile(schemaName, tableName, fields, colMap, primary, generated, isView) {
     const fieldsStr = JSON.stringify(fields, null, 2).replace(/"(.*?)"\s*:\s*"Type(.*?)"/g, '$1: Type$2');
     const colMapStr = JSON.stringify(colMap, null, 2);
     const primaryKeyLine = primary?.length ? `\n  primaryKey: ${JSON.stringify(primary)},` : '';
+    // Published so the table generator — and the runtime — know which columns the database
+    // computes: those are readable but reject every write.
+    const generatedLine = generated?.length ? `\n  generatedFields: ${JSON.stringify(generated)},` : '';
+    // A view has no PRIMARY KEY constraint to introspect, so the table generator has to be told
+    // it may not read the absence of one as "no key exists on this data".
+    const isViewLine = isView ? `\n  isView: true,` : '';
     const usesNullable = Object.values(fields).some((t) => t.includes('Nullable('));
     const valueImports = usesNullable ? 'Type, Nullable' : 'Type';
     return `// Auto-generated by fastify-auto-sqlapi. Do not edit.
@@ -144,7 +157,7 @@ export const Schema = {
   fields: _Schema,
   validation,
   tableName: "${tableName}",
-  partialValidation,${primaryKeyLine}
+  partialValidation,${primaryKeyLine}${generatedLine}${isViewLine}
 };
 export const ${schemaName} = Schema;
 export type TypeSchema = Static<typeof Schema.validation>;

package/dist/lib/cli/tables-codegen.d.ts

@@ -5,6 +5,10 @@ export interface ParsedSchema {
     fieldTypes: Record<string, string>;
     /** PRIMARY KEY fields declared in the schema file (`primaryKey: [...]`), when present. */
     primary?: string[];
+    /** Database-computed fields declared in the schema file (`generatedFields: [...]`). */
+    generated?: string[];
+    /** True when the schema file declares `isView: true` — the relation is a view. */
+    isView?: boolean;
 }
 interface DetectedRelation {
     parentSchemaName: string;

package/dist/lib/cli/tables-codegen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tables-codegen.d.ts","sourceRoot":"","sources":["../../../src/lib/cli/tables-codegen.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,0FAA0F;IAC1F,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,UAAU,gBAAgB;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;CACpB;AAID,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAuCpE;AAyCD;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,gBAAgB,EAAE,CAwB3E;AAyED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,GAAG,MAAM,CAgFhG;AAID,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,MAAM,CAqBrE;AA8CD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,MAAM,CAoClE"}
+{"version":3,"file":"tables-codegen.d.ts","sourceRoot":"","sources":["../../../src/lib/cli/tables-codegen.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,0FAA0F;IAC1F,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,uFAAuF;IACvF,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,kFAAkF;IAClF,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,UAAU,gBAAgB;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;CACpB;AAID,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAoCpE;AA4GD;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,gBAAgB,EAAE,CAwB3E;AAgID,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,GAAG,MAAM,CAwFhG;AAID,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,MAAM,CAqBrE;AAqDD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,MAAM,CAoClE"}

package/dist/lib/cli/tables-codegen.js

@@ -20,43 +20,91 @@ export function parseSchemaFile(content) {
     }
     if (fields.length === 0)
         return null;
-    // primaryKey: ["code"] — emitted by generate-schema from DB introspection
-    let primary;
-    const pkMatch = /primaryKey:\s*\[([^\]]*)\]/.exec(content);
-    if (pkMatch) {
-        primary = pkMatch[1]
-            .split(',')
-            .map((s) => s.trim().replace(/^["']|["']$/g, ''))
-            .filter(Boolean);
-        if (primary.length === 0)
-            primary = undefined;
-    }
+    // primaryKey: ["code"] / generatedFields: ["total"] — emitted by generate-schema from
+    // DB introspection. Both are absent on hand-written schema files.
+    const primary = parseFieldList(content, 'primaryKey');
+    const generated = parseFieldList(content, 'generatedFields');
+    const isView = /isView:\s*true/.test(content);
     return {
         schemaName: exportMatch[1],
         tableName: tableNameMatch[1],
         fields,
         fieldTypes,
         primary,
+        generated,
+        ...(isView ? { isView: true } : {}),
     };
 }
+/** Read a `<key>: ["a", "b"]` list out of a generated schema file. */
+function parseFieldList(content, key) {
+    const match = new RegExp(`${key}:\\s*\\[([^\\]]*)\\]`).exec(content);
+    if (!match)
+        return undefined;
+    const values = match[1]
+        .split(',')
+        .map((s) => s.trim().replace(/^["']|["']$/g, ''))
+        .filter(Boolean);
+    return values.length ? values : undefined;
+}
 // ─── Detection ───────────────────────────────────────────────
+/** Stands in for a primary key nobody can infer. `defineTable` refuses it beyond search. */
+const PK_PLACEHOLDER = 'TODO_pick_a_unique_column';
 function detectPrimaryKey(schema) {
     // Preferred source: the PK introspected from the DB (primaryKey in the schema file).
     if (schema.primary?.length) {
         const pk = schema.primary.length === 1 ? schema.primary[0] : schema.primary;
         const first = schema.primary[0];
-        return { pk, autoIncrement: schema.fieldTypes[first]?.includes('Optional') ?? false };
+        return {
+            pk,
+            autoIncrement: schema.fieldTypes[first]?.includes('Optional') ?? false,
+            source: 'declared',
+        };
+    }
+    // A view carries no PRIMARY KEY constraint, so an absent one says nothing about the data.
+    // Only `id` is a strong enough signal to act on; the type-based fallback below would take
+    // any integer column — a count, a year — and hand back a key that is not unique, which
+    // `get/:id`, update and delete would then address rows by. Guessing is the one thing that
+    // must not happen quietly here.
+    if (schema.isView) {
+        return schema.fields.includes('id')
+            ? { pk: 'id', autoIncrement: false, source: 'inferred' }
+            : { pk: PK_PLACEHOLDER, autoIncrement: false, source: 'unresolved' };
     }
     // Heuristic fallback for hand-written/legacy schema files without primaryKey.
     if (schema.fields.includes('id')) {
-        return { pk: 'id', autoIncrement: schema.fieldTypes['id']?.includes('Optional') ?? false };
+        return {
+            pk: 'id',
+            autoIncrement: schema.fieldTypes['id']?.includes('Optional') ?? false,
+            source: 'inferred',
+        };
     }
     for (const field of schema.fields) {
         if (schema.fieldTypes[field]?.includes('Integer')) {
-            return { pk: field, autoIncrement: schema.fieldTypes[field].includes('Optional') };
+            return {
+                pk: field,
+                autoIncrement: schema.fieldTypes[field].includes('Optional'),
+                source: 'inferred',
+            };
         }
     }
-    return { pk: schema.fields[0], autoIncrement: false };
+    return { pk: schema.fields[0], autoIncrement: false, source: 'inferred' };
+}
+/**
+ * The `writeExclude` slot, plus the list of columns the database computes for this table.
+ *
+ * Those are excluded from every write by the runtime already — the Schema publishes them in
+ * `generatedFields` — so the line stays commented: it is here to say *why* the fields are
+ * missing from the write bodies, and to give a place to add fields of your own.
+ */
+function writeExcludeLines(schema) {
+    if (!schema.generated?.length) {
+        return ['  // writeExclude: [],'];
+    }
+    return [
+        `  // Computed by the database (GENERATED ALWAYS AS ...): ${schema.generated.join(', ')}`,
+        '  // — readable, never writable. Already excluded from every write body.',
+        '  // writeExclude: [],',
+    ];
 }
 /** First PK field: used for defaultOrder, relations and example snippets. */
 function pkFirst(pk) {
@@ -157,9 +205,48 @@ function allowedReadJoinsLines(parentRels) {
     lines.push(`  // ],`);
     return lines;
 }
+// ─── Views ───────────────────────────────────────────────────
+/**
+ * The header a view's config gets: what the generator could not read from the database, and
+ * what it therefore assumed.
+ */
+function viewNotice(schema, source) {
+    if (!schema.isView)
+        return [];
+    const lines = [
+        `// "${schema.tableName}" is a VIEW. It is a table config like any other, but the database`,
+        `// reports no PRIMARY KEY for it and only a view the engine can make updatable accepts a`,
+        `// write — an aggregating one rejects every INSERT and UPDATE outright.`,
+    ];
+    if (source === 'inferred') {
+        lines.push(`// The primary key below was inferred from the column names, NOT read from the database:`, `// check that it is actually unique in this view before exposing get/update/delete.`);
+    }
+    else {
+        lines.push(`// No column was a plausible primary key, so none was invented. As generated this config`, `// serves search only, which never needs one. To expose get/update/delete, replace the`, `// placeholder with a column that is unique in this view and widen \`operations\`.`);
+    }
+    return lines;
+}
+/**
+ * A view's route whitelist. Reads only: writing through a view works solely when the engine
+ * can make that view updatable, which is a property of the view's own SQL rather than of
+ * anything declared here — so the generated starting point is the one that always works, and
+ * widening it is a deliberate edit. This is not the runtime default (ADR 0002), which stays
+ * open: it is what the generator writes into a file the developer then owns.
+ */
+function viewOperationsLine(schema, source) {
+    if (!schema.isView)
+        return [];
+    return source === 'unresolved'
+        ? [`  operations: ['search'],`]
+        : [`  operations: ['search', 'get'],`];
+}
+/** Ordering must not fall back to a primary key that does not exist. */
+function defaultOrderField(schema, pk, source) {
+    return source === 'unresolved' ? schema.fields[0] : pkFirst(pk);
+}
 export function generateSingleTableFile(schema, allSchemas) {
     const { byParent, byChild } = indexRelations(detectRelations(allSchemas));
-    const { pk, autoIncrement } = detectPrimaryKey(schema);
+    const { pk, autoIncrement, source } = detectPrimaryKey(schema);
     const tableVarName = 'Table' + schema.schemaName.replace(/^Schema/, '');
     const parentRels = byParent.get(schema.schemaName) ?? [];
     const childRels = byChild.get(schema.schemaName) ?? [];
@@ -180,6 +267,7 @@ export function generateSingleTableFile(schema, allSchemas) {
     lines.push(`// });`);
     // Table definition
     lines.push(``);
+    lines.push(...viewNotice(schema, source));
     lines.push(`// Fields: ${schema.fields.join(', ')}`);
     lines.push(`export const ${tableVarName} = defineTable({`);
     lines.push(`  primary: ${formatPrimary(pk)},`);
@@ -194,15 +282,21 @@ export function generateSingleTableFile(schema, allSchemas) {
     lines.push(`  //     if (filters.q) condition.isILike(\`\${Schema.tableName}.\${Schema.col('${schema.fields.includes('name') ? 'name' : schema.fields[0]}')}\`, \`%\${filters.q}%\`);`);
     lines.push(`  //   }`);
     lines.push(`  // ),`);
-    lines.push(`  defaultOrder: '${pkFirst(pk)}',`);
-    if (autoIncrement) {
-        lines.push(`  excludeFromCreation: ['${pkFirst(pk)}'],`);
-    }
-    else {
-        lines.push(`  // excludeFromCreation: [],`);
+    lines.push(`  defaultOrder: '${defaultOrderField(schema, pk, source)}',`);
+    lines.push(...viewOperationsLine(schema, source));
+    // A view is never inserted into by the auto routes as generated, so the creation whitelist
+    // would be a line about an operation that is not exposed.
+    if (!schema.isView) {
+        if (autoIncrement) {
+            lines.push(`  excludeFromCreation: ['${pkFirst(pk)}'],`);
+        }
+        else {
+            lines.push(`  // excludeFromCreation: [],`);
+        }
     }
     // Hide columns from every read (writes still accept them, e.g. a password hash)
     lines.push(`  // readExclude: [],`);
+    lines.push(...writeExcludeLines(schema));
     lines.push(...allowedReadJoinsLines(parentRels));
     const upsertPk = pkFields(pk).map((p) => `'${p}'`).join(', ');
     lines.push(`  // upsertMap: buildUpsertRules(buildUpsertRule(Schema, [${upsertPk}])),`);
@@ -243,22 +337,26 @@ export function generateDbTablesIndex(schemas) {
 // ─── Code Generation (legacy) ───────────────────────────────
 /** One `defineTable({...})` block for the legacy single-file generator. */
 function legacyTableBlock(schema, parentRels, childRels) {
-    const { pk, autoIncrement } = detectPrimaryKey(schema);
+    const { pk, autoIncrement, source } = detectPrimaryKey(schema);
     const tableVarName = 'Table' + schema.schemaName.replace(/^Schema/, '');
     const upsertPk = pkFields(pk).map((p) => `'${p}'`).join(', ');
     const exampleField = schema.fields.find((f) => !pkFields(pk).includes(f)) || schema.fields[0];
     const lines = [
         ``,
         `// ─── ${schema.tableName} ──────────────────────────────`,
+        ...viewNotice(schema, source),
         `// Fields: ${schema.fields.join(', ')}`,
         `const ${tableVarName} = defineTable({`,
         `  primary: ${formatPrimary(pk)},`,
         `  ...exportTableInfo(${schema.schemaName}),`,
-        `  defaultOrder: '${pkFirst(pk)}',`,
-        autoIncrement
-            ? `  excludeFromCreation: ['${pkFirst(pk)}'],`
-            : `  // excludeFromCreation: [],`,
+        `  defaultOrder: '${defaultOrderField(schema, pk, source)}',`,
+        ...viewOperationsLine(schema, source),
     ];
+    if (!schema.isView) {
+        lines.push(autoIncrement
+            ? `  excludeFromCreation: ['${pkFirst(pk)}'],`
+            : `  // excludeFromCreation: [],`);
+    }
     lines.push(...allowedReadJoinsLines(parentRels));
     lines.push(`  // upsertMap: buildUpsertRules(buildUpsertRule(${schema.schemaName}, [${upsertPk}])),`, `  // schemaOverrides: {},`, `  validate: async (db, req, main, secondaries) => {`, `    const errors: ValidationError[] = [];`, `    // if (!main.${exampleField}) errors.push(['${exampleField}', 'required']);`, `    return errors;`, `  },`, `  // beforeInsert: async (db, req, record) => {},`, `  // beforeUpdate: async (db, req, fields) => {},`, tenantScopeLine(childRels), `});`);
     return lines;

package/dist/lib/db.d.ts

@@ -37,7 +37,12 @@ export declare class QueryClient {
     insert(table: string, record: DbRecord, pkCol: string | string[]): Promise<Record<string, unknown>>;
     insertOrUpdate(table: string, record: DbRecord, conflictKeys: string[], pkCol: string | string[]): Promise<Record<string, unknown>>;
     bulkInsert(table: string, records: DbRecord[], pkCol: string | string[], chunkSize?: number): Promise<Record<string, unknown>[]>;
-    bulkInsertOrUpdate(table: string, records: DbRecord[], conflictKeys: string[], pkCol: string | string[], chunkSize?: number): Promise<Record<string, unknown>[]>;
+    /**
+     * `immutableCols` are written when the row is inserted but left untouched when the statement
+     * lands on an existing row — like the conflict keys, which are never in the update set either.
+     * Used by tenant isolation to keep an upsert from re-assigning a row's owner.
+     */
+    bulkInsertOrUpdate(table: string, records: DbRecord[], conflictKeys: string[], pkCol: string | string[], chunkSize?: number, immutableCols?: string[]): Promise<Record<string, unknown>[]>;
     update(table: string, record: DbRecord, where: DbRecord, extraCondition?: ConditionBuilder): Promise<number>;
     delete(table: string, where: DbRecord, extraCondition?: ConditionBuilder): Promise<number>;
     select<T = Record<string, unknown>>({ tableName, columns, where, values, limit, orderBy, joins, distinct, }: SelectOptions): Promise<T[]>;