fastify-auto-sqlapi 0.2.1 → 0.2.3

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, TenantScopeAnyOf, TenantContext, ValidationError, ValidatorFn, BulkValidatorItem, BulkValidatorFn, } from './types.js';
+export type { ApiRequest, 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":"AACA,OAAO,EACL,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,eAAe,GAChB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG1E,OAAO,EAAE,UAAU,EAAE,KAAK,UAAU,EAAE,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAGjF,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAGjE,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,aAAa,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AACxH,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAG7C,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,KAAK,aAAa,EAClB,KAAK,aAAa,GACnB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,gBAAgB,EAAE,KAAK,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACtF,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,wCAAwC,CAAC;AAGxF,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACxD,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAIlH,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAGvE,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAGzD,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC5H,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAGzE,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC9E,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAGzE,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAGnE,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAGzE,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC9E,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAGzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAC3F,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAGlF,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAC3F,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAGlF,OAAO,EAAE,IAAI,EAAE,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAGtE,YAAY,EACV,UAAU,EACV,YAAY,EACZ,UAAU,EACV,QAAQ,EACR,SAAS,EACT,oBAAoB,EACpB,SAAS,EACT,QAAQ,EACR,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,MAAM,EACN,cAAc,EACd,QAAQ,EACR,mBAAmB,EACnB,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,SAAS,EACT,gBAAgB,EAChB,aAAa,EACb,mBAAmB,EACnB,YAAY,EACZ,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,oBAAoB,EACpB,iBAAiB,EACjB,SAAS,EACT,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,QAAQ,EACR,WAAW,EACX,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,WAAW,EACX,iBAAiB,EACjB,eAAe,GAChB,MAAM,YAAY,CAAC"}

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;
@@ -47,7 +49,8 @@ export declare function tableOperations(tableConf: ITable): TableOperation[];
 export declare function buildAgentManifest(dbTables: DbTables): AgentManifest;
 /**
  * Compact markdown rendering of the manifest, designed for an LLM system prompt.
- * Notation: `!` required on insert, `?` nullable, `(writeOnly)` never returned by reads.
+ * Notation: `!` required on insert, `?` nullable, `(writeOnly)` never returned by reads,
+ * `(readOnly)` returned by reads and refused by every write.
  */
 export declare function renderAgentManifestMd(manifest: AgentManifest): string;
 export {};

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;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,CAmBrE"}

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;
@@ -115,13 +119,15 @@ export function buildAgentManifest(dbTables) {
 }
 /**
  * Compact markdown rendering of the manifest, designed for an LLM system prompt.
- * Notation: `!` required on insert, `?` nullable, `(writeOnly)` never returned by reads.
+ * Notation: `!` required on insert, `?` nullable, `(writeOnly)` never returned by reads,
+ * `(readOnly)` returned by reads and refused by every write.
  */
 export function renderAgentManifestMd(manifest) {
     const lines = [
         '# Tables',
         '',
-        'Notation: `!`=required on insert, `?`=nullable, `(writeOnly)`=writable, never in reads.',
+        'Notation: `!`=required on insert, `?`=nullable, `(writeOnly)`=writable, never in reads, ' +
+            '`(readOnly)`=returned by reads, refused by every write (omit it from write payloads).',
         'serverGenerated fields: omit on insert (values from client are ignored).',
         'readJoins aliases: `1:N` → joinMustExist/joinMultiple/joinGroup; `N:1` → joinLeft.',
         'writeJoins aliases: keys for `secondaries`/`deletions` in writes.',
@@ -138,7 +144,11 @@ export function renderAgentManifestMd(manifest) {
 function namedTypes(map) {
     return Object.entries(map).map(([n, ty]) => `${n}:${ty}`).join(', ');
 }
-/** A field's type with its notation suffixes: `!` required, `?` nullable, `(writeOnly)`. */
+/**
+ * A field's type with its notation suffixes: `!` required, `?` nullable, `(writeOnly)`,
+ * `(readOnly)`. The two exclusion suffixes are mutually exclusive — `defineTable` rejects a
+ * field that is both — so at most one of them is ever appended.
+ */
 function fieldNotation(f) {
     let s = f.type;
     if (f.required)
@@ -147,6 +157,8 @@ function fieldNotation(f) {
         s += '?';
     if (f.writeOnly)
         s += '(writeOnly)';
+    if (f.readOnly)
+        s += '(readOnly)';
     return s;
 }
 function renderTableMd(t) {

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

@@ -6,6 +6,34 @@ export interface MysqlConnectionConfig {
     password: string;
     database: string;
 }
+/** information_schema.columns row. MySQL and MariaDB differ on column-name case. */
+interface MysqlColumnRow {
+    TABLE_NAME?: string;
+    table_name?: string;
+    COLUMN_NAME?: string;
+    column_name?: string;
+    DATA_TYPE?: string;
+    data_type?: string;
+    COLUMN_DEFAULT?: string | null;
+    column_default?: string | null;
+    IS_NULLABLE?: string;
+    is_nullable?: string;
+    COLUMN_KEY?: string;
+    column_key?: string;
+    EXTRA?: string;
+    extra?: string;
+    GENERATION_EXPRESSION?: string | null;
+    generation_expression?: string | null;
+    TABLE_TYPE?: string;
+    table_type?: string;
+}
 export declare function buildMysqlConnectionConfig(): MysqlConnectionConfig;
+/**
+ * One `information_schema.columns` row as the generator sees it.
+ *
+ * @testonly Exported only so unit tests can exercise it directly.
+ */
+export declare function mapMysqlColumnRow(row: MysqlColumnRow): ColumnInfo;
 export declare function introspectMysqlTables(connectionConfig: MysqlConnectionConfig, schema: string): Promise<ColumnInfo[]>;
+export {};
 //# sourceMappingURL=mysql-introspect.d.ts.map

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;AAkBD,oFAAoF;AACpF,UAAU,cAAc;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qBAAqB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,qBAAqB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,0BAA0B,IAAI,qBAAqB,CAmBlE;AAyED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,cAAc,GAAG,UAAU,CAejE;AAED,wBAAsB,qBAAqB,CACzC,gBAAgB,EAAE,qBAAqB,EACvC,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,UAAU,EAAE,CAAC,CAoBvB"}

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

@@ -65,26 +65,59 @@ 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();
+}
+/** The two `EXTRA` markers that mean a real `GENERATED ALWAYS AS (...)` column. */
+const GENERATED_EXTRA = /\b(?:virtual|stored|persistent) generated\b/;
+/**
+ * True only for a column the database computes from an expression — never writable.
+ *
+ * `EXTRA` cannot be matched on the word 'generated': MySQL writes `DEFAULT_GENERATED` there
+ * for any column with a default *expression*, `DEFAULT CURRENT_TIMESTAMP` included, so a
+ * substring match takes every such timestamp column out of the write bodies. Only
+ * `GENERATION_EXPRESSION` separates the two, and it is non-empty for generated columns alone.
+ * `EXTRA` stays as a fallback, matched on the exact markers, for a driver or an older server
+ * that does not return the expression.
+ */
+function isGenerated(row) {
+    const expression = String(row.GENERATION_EXPRESSION ?? row.generation_expression ?? '').trim();
+    return expression !== '' || GENERATED_EXTRA.test(extra(row));
+}
+/**
+ * One `information_schema.columns` row as the generator sees it.
+ *
+ * @testonly Exported only so unit tests can exercise it directly.
+ */
+export function mapMysqlColumnRow(row) {
+    // `||` 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`.
+    return {
+        table_name: row.TABLE_NAME || row.table_name || '',
+        column_name: row.COLUMN_NAME || row.column_name || '',
+        udt_name: mapMysqlType(row.DATA_TYPE || row.data_type || ''),
+        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: extra(row).includes('auto_increment'),
+        is_generated: isGenerated(row),
+        is_view: (row.TABLE_TYPE || row.table_type) === 'VIEW',
+    };
+}
 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]);
-        // `||` 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`.
-        return rows.map((row) => ({
-            table_name: row.TABLE_NAME || row.table_name || '',
-            column_name: row.COLUMN_NAME || row.column_name || '',
-            udt_name: mapMysqlType(row.DATA_TYPE || row.data_type || ''),
-            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'),
-        }));
+        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, c.generation_expression, 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]);
+        return rows.map(mapMysqlColumnRow);
     }
     finally {
         await connection.end();

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"}