fastify-auto-sqlapi 0.2.1 → 0.2.3

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/engine/bulk/bulk-upsert.js

@@ -27,12 +27,12 @@ async function finalizeUpsertedItem(params, item, inputMain, pkRow) {
     // FK auto-fill: input camelCase + generated PK
     const mainForFK = { ...inputMain, ...mainPkCamel };
     if (item.secondaries && Object.keys(item.secondaries).length > 0) {
-        const sec = await processSecondaries({ db, tableConf, dbTables, mainRecord: mainForFK, tenant }, item.secondaries);
+        const sec = await processSecondaries({ db, tableConf, dbTables, mainRecord: mainForFK, tenant, request }, item.secondaries);
         if (Object.keys(sec).length > 0)
             result.secondaries = sec;
     }
     if (item.deletions && Object.keys(item.deletions).length > 0) {
-        const del = await processDeletions({ db, tableConf, dbTables, mainRecord: mainForFK, tenant }, item.deletions);
+        const del = await processDeletions({ db, tableConf, dbTables, mainRecord: mainForFK, tenant, request }, item.deletions);
         if (Object.keys(del).length > 0)
             result.deletions = del;
     }

package/dist/lib/engine/read-hooks.d.ts

@@ -0,0 +1,19 @@
+import type { ApiRequest } from '../../types/request.js';
+import type { QueryClient } from '../db.js';
+import type { ITable, ReadSource } from '../../types.js';
+/**
+ * Run a table's `afterRead` hook over the rows a read produced.
+ *
+ * Every read path funnels through this one helper so the hook has a single meaning: it is
+ * handed camelCase rows of `tableConf`'s own table, in one batch, and mutates them in place.
+ * Batching is the contract, not an optimisation — a hook that decrypts through a remote KMS
+ * gets one call per result set instead of one per row.
+ *
+ * `tableConf` is resolved by the caller, which on a join is the JOINED table's config
+ * (`dbTables[joinSchema.tableName]`). That is what makes the hook follow a relation without
+ * being declared on the host, the way `readExclude` and `tenantScope` do (ADR 0010).
+ *
+ * An empty result set is skipped: there is nothing to transform, and the hook may be costly.
+ */
+export declare function runAfterRead(db: QueryClient, request: ApiRequest | undefined, rows: Record<string, unknown>[], tableConf: ITable | undefined, source: ReadSource, alias?: string): Promise<void>;
+//# sourceMappingURL=read-hooks.d.ts.map

package/dist/lib/engine/read-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-hooks.d.ts","sourceRoot":"","sources":["../../../src/lib/engine/read-hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,KAAK,EAAoB,MAAM,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE3E;;;;;;;;;;;;;GAaG;AACH,wBAAsB,YAAY,CAChC,EAAE,EAAE,WAAW,EACf,OAAO,EAAE,UAAU,GAAG,SAAS,EAC/B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAC/B,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,MAAM,EAAE,UAAU,EAClB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAIf"}

package/dist/lib/engine/read-hooks.js

@@ -0,0 +1,20 @@
+/**
+ * Run a table's `afterRead` hook over the rows a read produced.
+ *
+ * Every read path funnels through this one helper so the hook has a single meaning: it is
+ * handed camelCase rows of `tableConf`'s own table, in one batch, and mutates them in place.
+ * Batching is the contract, not an optimisation — a hook that decrypts through a remote KMS
+ * gets one call per result set instead of one per row.
+ *
+ * `tableConf` is resolved by the caller, which on a join is the JOINED table's config
+ * (`dbTables[joinSchema.tableName]`). That is what makes the hook follow a relation without
+ * being declared on the host, the way `readExclude` and `tenantScope` do (ADR 0010).
+ *
+ * An empty result set is skipped: there is nothing to transform, and the hook may be costly.
+ */
+export async function runAfterRead(db, request, rows, tableConf, source, alias) {
+    if (!tableConf?.afterRead || rows.length === 0)
+        return;
+    const ctx = alias === undefined ? { source } : { source, alias };
+    await tableConf.afterRead(db, request, rows, ctx);
+}

package/dist/lib/engine/rest/get.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get.d.ts","sourceRoot":"","sources":["../../../../src/lib/engine/rest/get.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9D,wBAAsB,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,CAuCrE"}
+{"version":3,"file":"get.d.ts","sourceRoot":"","sources":["../../../../src/lib/engine/rest/get.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9D,wBAAsB,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,CA0CrE"}

package/dist/lib/engine/rest/get.js

@@ -3,9 +3,10 @@ import { camelcaseObject } from '../../naming.js';
 import { buildTenantCondition, buildTenantJoin } from '../../tenant.js';
 import { httpError } from '../../errors.js';
 import { readableSelectColumns } from '../../read-access.js';
+import { runAfterRead } from '../read-hooks.js';
 import { primaryAsString, isCompositePrimary } from '../../../types.js';
 export async function getEngine(params) {
-    const { db, tableConf, id, tenant } = params;
+    const { db, tableConf, id, tenant, request } = params;
     if (isCompositePrimary(tableConf.primary)) {
         throw httpError(400, `Table "${tableConf.Schema.tableName}" has a composite primary key: get-by-id would match on "${primaryAsString(tableConf.primary)}" alone. Use search with all PK fields.`);
     }
@@ -34,5 +35,7 @@ export async function getEngine(params) {
     });
     if (rows.length === 0)
         throw httpError(404, `Record not found: ${id}`);
-    return { main: camelcaseObject(rows[0], tableConf.Schema) };
+    const main = camelcaseObject(rows[0], tableConf.Schema);
+    await runAfterRead(db, request, [main], tableConf, 'get');
+    return { main };
 }

package/dist/lib/engine/rest/insert.js

@@ -32,7 +32,7 @@ export async function insertEngine(params) {
         let secondaryResults;
         if (secondaries && Object.keys(secondaries).length > 0) {
             const mainForFK = { ...inputRecord, ...mainPkCamel };
-            secondaryResults = await processSecondaries({ db: tx, tableConf, dbTables, mainRecord: mainForFK, tenant }, secondaries);
+            secondaryResults = await processSecondaries({ db: tx, tableConf, dbTables, mainRecord: mainForFK, tenant, request }, secondaries);
         }
         // 5. afterInsert hook (camelCase — input merged with generated PK)
         if (tableConf.afterInsert) {

package/dist/lib/engine/rest/update.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../../src/lib/engine/rest/update.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EACV,YAAY,EACZ,YAAY,EAEb,MAAM,mBAAmB,CAAC;AAiC3B,wBAAsB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CA2G9E"}
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../../src/lib/engine/rest/update.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EACV,YAAY,EACZ,YAAY,EAEb,MAAM,mBAAmB,CAAC;AAiC3B,wBAAsB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CA+G9E"}

package/dist/lib/engine/rest/update.js

@@ -1,4 +1,5 @@
 import { snakecaseRecord } from '../../naming.js';
+import { removeWriteExcluded } from '../../write-access.js';
 import { processSecondaries, processDeletions } from '../write-helpers.js';
 import { stripTenantColumn, assertTenantOwnership, buildTenantUpdateExtra, enforceTenantFKOnUpdate, } from '../../tenant.js';
 import { runValidation } from '../validate.js';
@@ -46,22 +47,25 @@ export async function updateEngine(params) {
     if (tableConf.beforeUpdate) {
         await tableConf.beforeUpdate(db, request, inputRecord);
     }
-    // 5. Convert to DB format (after all user mutations)
+    // 5. Drop what the database will not be told about (generated columns, writeExclude).
+    //    After the hook on purpose: the column refuses a value whoever assigned it.
+    removeWriteExcluded(inputRecord, tableConf, schema);
+    // 6. Convert to DB format (after all user mutations)
     const snaked = snakecaseRecord(inputRecord, schema);
     const updateFields = { ...snaked };
     for (const c of pkCols)
         delete updateFields[c];
-    // 6. Strip tenant column (user cannot change tenant of an existing record).
+    // 7. Strip tenant column (user cannot change tenant of an existing record).
     //    For indirect scopes the tenant link is the through-FK (localField): it may be changed,
     //    but only to another value the caller owns — re-validate the new FK against the tenant.
     if (tenant?.scope) {
         stripTenantColumn(updateFields, tenant.scope);
         await enforceTenantFKOnUpdate(db, tenant, updateFields);
     }
-    // Steps 7-9 are atomic: a failure in secondaries or deletions rolls back the main
+    // Steps 8-10 are atomic: a failure in secondaries or deletions rolls back the main
     // update too. Degrades to non-transactional when the adapter has no connect().
     return db.withTransaction(async (tx) => {
-        // 7. Update main
+        // 8. Update main
         const hasFieldsToUpdate = Object.keys(updateFields).length > 0;
         const extraCondition = buildTenantUpdateExtra(tx, tenant);
         // WHERE matching every primary key column (single or composite).
@@ -76,23 +80,23 @@ export async function updateEngine(params) {
         }
         // Build the main response (PK-only — every PK field)
         const mainResult = Object.fromEntries(pkFields.map((f, i) => [f, pkValues[i]]));
-        // 8. Secondaries (upsert/insert with FK auto-fill — camelCase)
+        // 9. Secondaries (upsert/insert with FK auto-fill — camelCase)
         let secondaryResults;
         if (secondaries && Object.keys(secondaries).length > 0) {
             const mainForFK = { ...inputRecord };
-            secondaryResults = await processSecondaries({ db: tx, tableConf, dbTables, mainRecord: mainForFK, tenant }, secondaries);
+            secondaryResults = await processSecondaries({ db: tx, tableConf, dbTables, mainRecord: mainForFK, tenant, request }, secondaries);
         }
-        // 9. Deletions (FK auto-fill from main like secondaries)
+        // 10. Deletions (FK auto-fill from main like secondaries)
         let deletionResults;
         if (deletions && Object.keys(deletions).length > 0) {
             const mainForFK = { ...inputRecord };
-            deletionResults = await processDeletions({ db: tx, tableConf, dbTables, mainRecord: mainForFK, tenant }, deletions);
+            deletionResults = await processDeletions({ db: tx, tableConf, dbTables, mainRecord: mainForFK, tenant, request }, deletions);
         }
-        // 10. afterUpdate hook (inside the transaction: throwing rolls everything back)
+        // 11. afterUpdate hook (inside the transaction: throwing rolls everything back)
         if (tableConf.afterUpdate) {
             await tableConf.afterUpdate(tx, request, inputRecord, secondaryResults, deletionResults);
         }
-        // 11. Return PK-only
+        // 12. Return PK-only
         const result = { main: mainResult };
         if (secondaryResults && Object.keys(secondaryResults).length > 0) {
             result.secondaries = secondaryResults;

package/dist/lib/engine/search/join-families.d.ts

@@ -1,3 +1,12 @@
+/**
+ * The four join families, each executed against the rows the main query returned.
+ *
+ *   joinMustExist  child -> main, 1:N   EXISTS filter on the main query (returns no rows)
+ *   joinMultiple   child -> main, 1:N   side query, rows under result.joinMultiple.<alias>
+ *   joinGroup      child -> main, 1:N   aggregations under result.joinGroup.<alias>
+ *   joinLeft       parent -> main, N:1  real LEFT JOIN on demand + side query for the rows
+ */
+import type { ApiRequest } from '../../../types/request.js';
 import type { QueryClient } from '../../db.js';
 import type { QueryParams } from '../query-params.js';
 import type { DbTables, ITable, JoinFetchRequest, JoinGroupRequest, JoinRefFilter, TenantContext } from '../../../types.js';
@@ -26,9 +35,9 @@ export declare function buildLeftJoinOnClauses(db: QueryClient, dbTables: DbTabl
 /** The WHERE fragments a `joinLeft` request's own filters and conditions contribute. */
 export declare function buildLeftJoinFilters(db: QueryClient, dbTables: DbTables, tableConf: ITable, aliasesNeedingJoin: Set<string>, joinLeft: Record<string, JoinFetchRequest> | undefined, startIdx: number): LeftJoinFilterBuild;
 /** joinMultiple: 1:N children, returned as rows under `result.joinMultiple.<alias>`. */
-export declare function executeJoinMultiple(db: QueryClient, dbTables: DbTables, tableConf: ITable, mainResults: Record<string, unknown>[], joinMultiple: Record<string, JoinFetchRequest>, tenant?: TenantContext): Promise<Record<string, Record<string, unknown>[]>>;
+export declare function executeJoinMultiple(db: QueryClient, dbTables: DbTables, tableConf: ITable, mainResults: Record<string, unknown>[], joinMultiple: Record<string, JoinFetchRequest>, tenant?: TenantContext, request?: ApiRequest): Promise<Record<string, Record<string, unknown>[]>>;
 /** joinLeft: N:1 parents, returned as rows under `result.joinLeft.<alias>`. */
-export declare function executeJoinLeft(db: QueryClient, dbTables: DbTables, tableConf: ITable, mainResults: Record<string, unknown>[], joinLeft: Record<string, JoinFetchRequest>, tenant?: TenantContext): Promise<Record<string, Record<string, unknown>[]>>;
+export declare function executeJoinLeft(db: QueryClient, dbTables: DbTables, tableConf: ITable, mainResults: Record<string, unknown>[], joinLeft: Record<string, JoinFetchRequest>, tenant?: TenantContext, request?: ApiRequest): Promise<Record<string, Record<string, unknown>[]>>;
 export declare function executeJoinGroup(db: QueryClient, dbTables: DbTables, tableConf: ITable, mainResults: Record<string, unknown>[], joinGroup: Record<string, JoinGroupRequest>, tenant?: TenantContext): Promise<Record<string, Record<string, unknown>>>;
 export declare function buildJoinMustExistClauses(params: QueryParams, db: QueryClient, dbTables: DbTables, tableConf: ITable, joinMustExist: Record<string, JoinRefFilter>, tenant?: TenantContext): string;
 export {};

package/dist/lib/engine/search/join-families.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"join-families.d.ts","sourceRoot":"","sources":["../../../../src/lib/engine/search/join-families.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAmBtD,OAAO,KAAK,EAEV,QAAQ,EAER,MAAM,EACN,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EAGb,aAAa,EAEd,MAAM,mBAAmB,CAAC;AAI3B,UAAU,eAAe;IACvB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,MAAM,EAAE,OAAO,EAAE,CAAC;CACnB;AAED,UAAU,mBAAmB;IAC3B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,MAAM,EAAE,OAAO,EAAE,CAAC;CACnB;AAsED;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CACpC,EAAE,EAAE,WAAW,EACf,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,MAAM,EACjB,kBAAkB,EAAE,GAAG,CAAC,MAAM,CAAC,EAC/B,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,aAAa,GACrB,eAAe,CAgCjB;AAED,wFAAwF;AACxF,wBAAgB,oBAAoB,CAClC,EAAE,EAAE,WAAW,EACf,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,MAAM,EACjB,kBAAkB,EAAE,GAAG,CAAC,MAAM,CAAC,EAC/B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,GAAG,SAAS,EACtD,QAAQ,EAAE,MAAM,GACf,mBAAmB,CA0CrB;AAmGD,wFAAwF;AACxF,wBAAgB,mBAAmB,CACjC,EAAE,EAAE,WAAW,EACf,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EACtC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,EAC9C,MAAM,CAAC,EAAE,aAAa,GACrB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC,CAKpD;AAED,+EAA+E;AAC/E,wBAAgB,eAAe,CAC7B,EAAE,EAAE,WAAW,EACf,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EACtC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,EAC1C,MAAM,CAAC,EAAE,aAAa,GACrB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC,CAKpD;AAsGD,wBAAsB,gBAAgB,CACpC,EAAE,EAAE,WAAW,EACf,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EACtC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,EAC3C,MAAM,CAAC,EAAE,aAAa,GACrB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAqClD;AAyBD,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,WAAW,EACnB,EAAE,EAAE,WAAW,EACf,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,EAC5C,MAAM,CAAC,EAAE,aAAa,GACrB,MAAM,CA4BR"}
+{"version":3,"file":"join-families.d.ts","sourceRoot":"","sources":["../../../../src/lib/engine/search/join-families.ts"],"names":[],"mappings":"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"}

package/dist/lib/engine/search/join-families.js

@@ -1,15 +1,8 @@
-/**
- * The four join families, each executed against the rows the main query returned.
- *
- *   joinMustExist  child -> main, 1:N   EXISTS filter on the main query (returns no rows)
- *   joinMultiple   child -> main, 1:N   side query, rows under result.joinMultiple.<alias>
- *   joinGroup      child -> main, 1:N   aggregations under result.joinGroup.<alias>
- *   joinLeft       parent -> main, N:1  real LEFT JOIN on demand + side query for the rows
- */
 import { ConditionBuilder, Expression } from 'node-condition-builder';
 import { assertReadable, assertFiltersReadable, hasOwnField, ownField } from '../../read-access.js';
 import { ALLOWED_SET } from '../../condition-methods.js';
 import { err400, validateSchemaField, evaluateComputedField, mapRowsToCamelCase, buildSelectionColumns, } from './fields.js';
+import { runAfterRead } from '../read-hooks.js';
 import { appendJoinTenantScope, subqueryAlias, requireJoin, extractJoinRefs, } from './joins.js';
 import { tenantForTable, buildTenantRowGuard } from '../../tenant.js';
 import { dispatchConditionMethod, buildJoinRefCondition } from './conditions.js';
@@ -152,7 +145,7 @@ function scopeJoinSideQuery(cb, db, joinSchema, joinField, ids, joinTableConf, t
     const where = cb.build(1, db.ph);
     return { where, values: cb.getValues(), tenantJoins };
 }
-async function fetchJoinRows(db, dbTables, tableConf, mainResults, requests, mode, tenant) {
+async function fetchJoinRows(db, dbTables, tableConf, mainResults, requests, mode, tenant, request) {
     const result = {};
     for (const [alias, ref] of Object.entries(requests)) {
         const joinDef = requireJoin(tableConf, alias, mode.requireUnique);
@@ -182,22 +175,27 @@ async function fetchJoinRows(db, dbTables, tableConf, mainResults, requests, mod
             joins: tenantJoins.length > 0 ? tenantJoins : undefined,
         });
         result[alias] = mapRowsToCamelCase(rows, joinSchema);
+        // The joined table's own hook, not the host's: a transform belongs to the table that
+        // owns the column, wherever its rows surface.
+        await runAfterRead(db, request, result[alias], joinTableConf, mode.source, alias);
     }
     return result;
 }
 /** joinMultiple: 1:N children, returned as rows under `result.joinMultiple.<alias>`. */
-export function executeJoinMultiple(db, dbTables, tableConf, mainResults, joinMultiple, tenant) {
+export function executeJoinMultiple(db, dbTables, tableConf, mainResults, joinMultiple, tenant, request) {
     return fetchJoinRows(db, dbTables, tableConf, mainResults, joinMultiple, {
+        source: 'joinMultiple',
         requireUnique: false,
         applyRefCondition: true,
-    }, tenant);
+    }, tenant, request);
 }
 /** joinLeft: N:1 parents, returned as rows under `result.joinLeft.<alias>`. */
-export function executeJoinLeft(db, dbTables, tableConf, mainResults, joinLeft, tenant) {
+export function executeJoinLeft(db, dbTables, tableConf, mainResults, joinLeft, tenant, request) {
     return fetchJoinRows(db, dbTables, tableConf, mainResults, joinLeft, {
+        source: 'joinLeft',
         requireUnique: true,
         applyRefCondition: false,
-    }, tenant);
+    }, tenant, request);
 }
 /**
  * Resolve `aggregations.by` to a SQL expression. Accepts:

package/dist/lib/engine/search/search.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../../src/lib/engine/search/search.ts"],"names":[],"mappings":"AAgCA,OAAO,KAAK,EACV,QAAQ,EACR,YAAY,EACZ,YAAY,EAGb,MAAM,mBAAmB,CAAC;AAyP3B,wBAAsB,YAAY,CAChC,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,YAAY,CAAC,CAsFvB"}
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../../src/lib/engine/search/search.ts"],"names":[],"mappings":"AAiCA,OAAO,KAAK,EACV,QAAQ,EACR,YAAY,EACZ,YAAY,EAGb,MAAM,mBAAmB,CAAC;AAyP3B,wBAAsB,YAAY,CAChC,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,YAAY,CAAC,CA4FvB"}

package/dist/lib/engine/search/search.js

@@ -5,6 +5,7 @@ import { MAX_CONDITIONS, MAX_ORDER_BY_PARTS } from '../../condition-methods.js';
 import { primaryAsString } from '../../../types.js';
 import { err400, resolveFieldRef, evaluateComputedField, refValues, renderRef, mapRowsToCamelCase, } from './fields.js';
 import { assertJoinFilterKeys, requireJoin } from './joins.js';
+import { runAfterRead } from '../read-hooks.js';
 import { collectOrderByLeftAliases, validateOrderBy, convertConfiguredOrder } from './order-by.js';
 import { applyConditions, applyComputedFilters } from './conditions.js';
 import { appendAggConditions } from './aggregations.js';
@@ -187,12 +188,12 @@ function collectLeftJoinAliases(params) {
  * it returned.
  */
 async function attachJoinResults(result, dbTables, params, main) {
-    const { db, tableConf, joinMultiple, joinLeft, joinGroup, tenant } = params;
+    const { db, tableConf, joinMultiple, joinLeft, joinGroup, tenant, request } = params;
     if (joinMultiple && Object.keys(joinMultiple).length > 0) {
-        result.joinMultiple = await executeJoinMultiple(db, dbTables, tableConf, main, joinMultiple, tenant);
+        result.joinMultiple = await executeJoinMultiple(db, dbTables, tableConf, main, joinMultiple, tenant, request);
     }
     if (joinLeft && Object.keys(joinLeft).length > 0) {
-        result.joinLeft = await executeJoinLeft(db, dbTables, tableConf, main, joinLeft, tenant);
+        result.joinLeft = await executeJoinLeft(db, dbTables, tableConf, main, joinLeft, tenant, request);
     }
     if (joinGroup && Object.keys(joinGroup).length > 0) {
         result.joinGroup = await executeJoinGroup(db, dbTables, tableConf, main, joinGroup, tenant);
@@ -248,6 +249,11 @@ export async function searchEngine(dbTables, params) {
     }
     const result = { main };
     await attachJoinResults(result, dbTables, params, main);
+    // After the joins, not before: they correlate to the main rows by the values the DB
+    // returned (`fk IN (ids)`), and a hook that rewrites the column holding that key would
+    // have them look for a value no child row carries. `main` is the same array either way,
+    // so the response still carries the hook's mutations.
+    await runAfterRead(db, params.request, main, tableConf, 'search');
     if (pagination) {
         result.pagination = pagination;
     }

package/dist/lib/engine/validate.d.ts

@@ -1,6 +1,6 @@
-import type { FastifyRequest } from 'fastify';
+import type { ApiRequest } from '../../types/request.js';
 import type { QueryClient } from '../db.js';
 import type { ITable, BulkValidatorItem } from '../../types.js';
-export declare function runValidation(db: QueryClient, request: FastifyRequest, tableConf: ITable, main: Record<string, unknown>, secondaries?: Record<string, Record<string, unknown>[]>): Promise<void>;
-export declare function runBulkValidation(db: QueryClient, request: FastifyRequest, tableConf: ITable, items: BulkValidatorItem[]): Promise<void>;
+export declare function runValidation(db: QueryClient, request: ApiRequest, tableConf: ITable, main: Record<string, unknown>, secondaries?: Record<string, Record<string, unknown>[]>): Promise<void>;
+export declare function runBulkValidation(db: QueryClient, request: ApiRequest, tableConf: ITable, items: BulkValidatorItem[]): Promise<void>;
 //# sourceMappingURL=validate.d.ts.map

package/dist/lib/engine/validate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../src/lib/engine/validate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,KAAK,EAAE,MAAM,EAAmB,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAgBjF,wBAAsB,aAAa,CACjC,EAAE,EAAE,WAAW,EACf,OAAO,EAAE,cAAc,EACvB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,GACtD,OAAO,CAAC,IAAI,CAAC,CAOf;AAED,wBAAsB,iBAAiB,CACrC,EAAE,EAAE,WAAW,EACf,OAAO,EAAE,cAAc,EACvB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,iBAAiB,EAAE,GACzB,OAAO,CAAC,IAAI,CAAC,CAOf"}
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../src/lib/engine/validate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,KAAK,EAAE,MAAM,EAAmB,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAgBjF,wBAAsB,aAAa,CACjC,EAAE,EAAE,WAAW,EACf,OAAO,EAAE,UAAU,EACnB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,GACtD,OAAO,CAAC,IAAI,CAAC,CAOf;AAED,wBAAsB,iBAAiB,CACrC,EAAE,EAAE,WAAW,EACf,OAAO,EAAE,UAAU,EACnB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,iBAAiB,EAAE,GACzB,OAAO,CAAC,IAAI,CAAC,CAOf"}

package/dist/lib/engine/write-helpers.d.ts

@@ -1,4 +1,4 @@
-import type { FastifyRequest } from 'fastify';
+import type { ApiRequest } from '../../types/request.js';
 import type { QueryClient } from '../db.js';
 import type { ITable, DbTables, TenantContext } from '../../types.js';
 export declare function findSecondaryTableConf(dbTables: DbTables, joinTableName: string): ITable | undefined;
@@ -13,11 +13,13 @@ export interface WriteJoinPass {
     /** Main record (camelCase), the source of the FK auto-filled into every child row. */
     mainRecord: Record<string, unknown>;
     tenant?: TenantContext;
+    /** The request that triggered the write, handed to the child table's `beforeInsert`. */
+    request: ApiRequest;
 }
 interface PrepareCtx {
     db: QueryClient;
     tableConf: ITable;
-    request: FastifyRequest;
+    request: ApiRequest;
 }
 /**
  * Prepare a single record for INSERT/UPSERT:
@@ -26,7 +28,9 @@ interface PrepareCtx {
  *   3. drop excludeFromCreation fields (client-input whitelist; applied BEFORE the
  *      hook so values it assigns — e.g. a server-generated id — reach the INSERT)
  *   4. beforeInsert hook (caller can mutate the camelCase copy)
- *   5. snakecaseRecord → DB format
+ *   5. drop non-writable fields (generated columns, writeExclude) — AFTER the hook, because
+ *      the database refuses those values whoever assigned them
+ *   6. snakecaseRecord → DB format
  *
  * Returns both `camel` (input + hook mutations, used for FK auto-fill / afterInsert) and
  * `snake` (DB-ready record). The original `input` is left intact.

package/dist/lib/engine/write-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"write-helpers.d.ts","sourceRoot":"","sources":["../../../src/lib/engine/write-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAS5C,OAAO,KAAK,EACV,MAAM,EACN,QAAQ,EAGR,aAAa,EACd,MAAM,gBAAgB,CAAC;AAqDxB,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,QAAQ,EAClB,aAAa,EAAE,MAAM,GACpB,MAAM,GAAG,SAAS,CAKpB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,WAAW,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,QAAQ,CAAC;IACnB,sFAAsF;IACtF,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAmCD,UAAU,UAAU;IAClB,EAAE,EAAE,WAAW,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,cAAc,CAAC;CACzB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,UAAU,EACf,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,EACvD,OAAO,CAAC,EAAE;IAAE,YAAY,CAAC,EAAE,OAAO,CAAA;CAAE,GACnC,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC,CAe7E;AAkCD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,aAAa,EACnB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,GACrD,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC,CAkDpD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,aAAa,EACnB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,GACnD,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC,CAoBpD"}
+{"version":3,"file":"write-helpers.d.ts","sourceRoot":"","sources":["../../../src/lib/engine/write-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAU5C,OAAO,KAAK,EACV,MAAM,EACN,QAAQ,EAGR,aAAa,EACd,MAAM,gBAAgB,CAAC;AAmCxB,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,QAAQ,EAClB,aAAa,EAAE,MAAM,GACpB,MAAM,GAAG,SAAS,CAKpB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,WAAW,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,QAAQ,CAAC;IACnB,sFAAsF;IACtF,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,wFAAwF;IACxF,OAAO,EAAE,UAAU,CAAC;CACrB;AAmCD,UAAU,UAAU;IAClB,EAAE,EAAE,WAAW,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,UAAU,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,UAAU,EACf,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,EACvD,OAAO,CAAC,EAAE;IAAE,YAAY,CAAC,EAAE,OAAO,CAAA;CAAE,GACnC,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC,CAgB7E;AAkCD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,aAAa,EACnB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,GACrD,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC,CA0DpD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,aAAa,EACnB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,GACnD,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC,CAoBpD"}