fastify-auto-sqlapi 0.1.13 → 0.2.0

package/dist/bin/generate-tables.js

@@ -22,6 +22,74 @@ function printHelp() {
     display('Table*.ts files are only created if they do not already exist.', CONSOLE_COLORS.magenta);
     display('dbTables.ts is created if missing, indexing the Table*.ts files present on disk.', CONSOLE_COLORS.magenta);
 }
+const tableVarOf = (schema) => 'Table' + schema.schemaName.replace(/^Schema/, '');
+/** Parse every Schema*.ts on disk — relation detection needs them all, even for a subset run. */
+function parseAllSchemas(schemasDir, schemaFiles) {
+    const parsed = [];
+    for (const file of schemaFiles) {
+        const content = fs.readFileSync(path.join(schemasDir, file), 'utf-8');
+        const schema = parseSchemaFile(content);
+        if (schema)
+            parsed.push(schema);
+    }
+    return parsed;
+}
+/** The schemas to emit Table files for. Exits when a requested name has no schema. */
+function selectTargetSchemas(allSchemas, all, requested) {
+    if (all)
+        return allSchemas;
+    const requestedSet = new Set(requested);
+    const targets = allSchemas.filter((s) => requestedSet.has(s.tableName));
+    const foundNames = new Set(targets.map((s) => s.tableName));
+    for (const name of requestedSet) {
+        if (!foundNames.has(name)) {
+            error(`Table "${name}" not found. Available: ${allSchemas.map((s) => s.tableName).join(', ')}`);
+            process.exit(1);
+        }
+    }
+    return targets;
+}
+/** Write the missing Table*.ts files. Existing ones are never overwritten. */
+function writeTableFiles(targetSchemas, allSchemas, tablesDir) {
+    const created = [];
+    for (const schema of targetSchemas) {
+        const tableVarName = tableVarOf(schema);
+        const tableFile = path.join(tablesDir, `${tableVarName}.ts`);
+        if (fs.existsSync(tableFile)) {
+            displayAsTableRow(`${tableVarName}.ts`, 'skipped (already exists)', 60, CONSOLE_COLORS.gray);
+            continue;
+        }
+        fs.writeFileSync(tableFile, generateSingleTableFile(schema, allSchemas));
+        created.push(tableVarName);
+        displayAsTableRow(`${tableVarName}.ts`, 'created', 60, CONSOLE_COLORS.green);
+    }
+    return created;
+}
+/**
+ * Write `dbTables.ts` only when missing. The index must reference only the Table*.ts files
+ * actually on disk: a subset run would otherwise emit imports for files never generated,
+ * and the consumer's project would not compile. When it already exists, the newly created
+ * tables are reported instead of being silently left out.
+ */
+function writeDbTablesIndex(tablesDir, allSchemas, createdTableVars) {
+    const dbTablesFile = path.join(tablesDir, 'dbTables.ts');
+    if (!fs.existsSync(dbTablesFile)) {
+        const existingTableVars = new Set(fs
+            .readdirSync(tablesDir)
+            .filter((f) => f.startsWith('Table') && f.endsWith('.ts'))
+            .map((f) => f.slice(0, -'.ts'.length)));
+        const indexSchemas = allSchemas.filter((s) => existingTableVars.has(tableVarOf(s)));
+        fs.writeFileSync(dbTablesFile, generateDbTablesIndex(indexSchemas));
+        displayAsTableRow('dbTables.ts', 'created', 60, CONSOLE_COLORS.green);
+        return;
+    }
+    displayAsTableRow('dbTables.ts', 'skipped (already exists)', 60, CONSOLE_COLORS.gray);
+    const indexContent = fs.readFileSync(dbTablesFile, 'utf-8');
+    const missing = createdTableVars.filter((v) => !indexContent.includes(v));
+    if (missing.length > 0) {
+        display(`Remember to add the new tables to dbTables.ts: ${missing.join(', ')}`, CONSOLE_COLORS.yellow);
+    }
+}
 await runCli('fastify-auto-sqlapi: generating tables template', async () => {
     const cliArgs = parseArgs({
         output: { type: 'value' },
@@ -55,72 +123,14 @@ await runCli('fastify-auto-sqlapi: generating tables template', async () => {
         display('Run sqlapi-generate-schema first.', CONSOLE_COLORS.magenta);
         process.exit(1);
     }
-    // Parse all schemas (needed for relation detection even when generating a subset)
-    const allSchemas = [];
-    for (const file of schemaFiles) {
-        const content = fs.readFileSync(path.join(schemasDir, file), 'utf-8');
-        const parsed = parseSchemaFile(content);
-        if (parsed) {
-            allSchemas.push(parsed);
-        }
-    }
+    const allSchemas = parseAllSchemas(schemasDir, schemaFiles);
     if (allSchemas.length === 0) {
         error('No valid schemas parsed.');
         process.exit(1);
     }
-    // Determine which schemas to generate Table files for
-    let targetSchemas;
-    if (cliArgs.all) {
-        targetSchemas = allSchemas;
-    }
-    else {
-        const requestedSet = new Set(cliArgs.tables);
-        targetSchemas = allSchemas.filter((s) => requestedSet.has(s.tableName));
-        const foundNames = new Set(targetSchemas.map((s) => s.tableName));
-        for (const name of requestedSet) {
-            if (!foundNames.has(name)) {
-                error(`Table "${name}" not found. Available: ${allSchemas.map((s) => s.tableName).join(', ')}`);
-                process.exit(1);
-            }
-        }
-    }
-    const tableVarOf = (schema) => 'Table' + schema.schemaName.replace(/^Schema/, '');
-    // Generate individual Table*.ts files (skip if already exists)
-    const createdTableVars = [];
-    for (const schema of targetSchemas) {
-        const tableVarName = tableVarOf(schema);
-        const tableFile = path.join(tablesDir, `${tableVarName}.ts`);
-        if (fs.existsSync(tableFile)) {
-            displayAsTableRow(`${tableVarName}.ts`, 'skipped (already exists)', 60, CONSOLE_COLORS.gray);
-        }
-        else {
-            const content = generateSingleTableFile(schema, allSchemas);
-            fs.writeFileSync(tableFile, content);
-            createdTableVars.push(tableVarName);
-            displayAsTableRow(`${tableVarName}.ts`, 'created', 60, CONSOLE_COLORS.green);
-        }
-    }
-    // Generate dbTables.ts only if it does not exist. The index must reference only
-    // Table*.ts files actually present on disk, otherwise a subset run would emit
-    // imports for files that were never generated and the project would not compile.
-    const dbTablesFile = path.join(tablesDir, 'dbTables.ts');
-    if (fs.existsSync(dbTablesFile)) {
-        displayAsTableRow('dbTables.ts', 'skipped (already exists)', 60, CONSOLE_COLORS.gray);
-        const indexContent = fs.readFileSync(dbTablesFile, 'utf-8');
-        const missing = createdTableVars.filter((v) => !indexContent.includes(v));
-        if (missing.length > 0) {
-            display(`Remember to add the new tables to dbTables.ts: ${missing.join(', ')}`, CONSOLE_COLORS.yellow);
-        }
-    }
-    else {
-        const existingTableVars = new Set(fs
-            .readdirSync(tablesDir)
-            .filter((f) => f.startsWith('Table') && f.endsWith('.ts'))
-            .map((f) => f.slice(0, -'.ts'.length)));
-        const indexSchemas = allSchemas.filter((s) => existingTableVars.has(tableVarOf(s)));
-        fs.writeFileSync(dbTablesFile, generateDbTablesIndex(indexSchemas));
-        displayAsTableRow('dbTables.ts', 'created', 60, CONSOLE_COLORS.green);
-    }
+    const targetSchemas = selectTargetSchemas(allSchemas, cliArgs.all, cliArgs.tables);
+    const createdTableVars = writeTableFiles(targetSchemas, allSchemas, tablesDir);
+    writeDbTablesIndex(tablesDir, allSchemas, createdTableVars);
     console.log('');
     display('Edit the generated Table*.ts files to customize your table configuration.', CONSOLE_COLORS.magenta);
 });

package/dist/bin/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/bin/utils.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAqBlD;AAED,eAAO,MAAM,cAAc;;;;;;;;CAQjB,CAAC;AAEX,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,KAAK,GAAE,MAAU,GAChB,IAAI,CAQN;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,IAAI,CAE7D;AAED,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAExC;AAED,KAAK,OAAO,GACR;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAErB,KAAK,QAAQ,CAAC,CAAC,SAAS,OAAO,IAC7B,CAAC,CAAC,MAAM,CAAC,SAAS,MAAM,GAAG,OAAO,GAClC,CAAC,CAAC,MAAM,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,GACnC,MAAM,GAAG,SAAS,CAAC;AAErB;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACzD,IAAI,EAAE,CAAC,EACP,IAAI,WAAwB,GAC3B;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,GAAG;IAAE,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,CAyC/D;AAED;;;GAGG;AACH,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAQjF"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/bin/utils.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAqBlD;AAED,eAAO,MAAM,cAAc;;;;;;;;CAQjB,CAAC;AAEX,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,KAAK,GAAE,MAAU,GAChB,IAAI,CAQN;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,IAAI,CAE7D;AAED,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAExC;AAED,KAAK,OAAO,GACR;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAErB,KAAK,QAAQ,CAAC,CAAC,SAAS,OAAO,IAC7B,CAAC,CAAC,MAAM,CAAC,SAAS,MAAM,GAAG,OAAO,GAClC,CAAC,CAAC,MAAM,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,GACnC,MAAM,GAAG,SAAS,CAAC;AAErB;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACzD,IAAI,EAAE,CAAC,EACP,IAAI,WAAwB,GAC3B;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,GAAG;IAAE,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,CAmB/D;AAqDD;;;GAGG;AACH,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAQjF"}

package/dist/bin/utils.js

@@ -62,51 +62,65 @@ export function error(text) {
  * (split on ',') into the list as well, supporting both "a b" and "a,b" CLI shapes.
  */
 export function parseArgs(spec, argv = process.argv.slice(2)) {
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     const out = { positional: [] };
     for (const [name, def] of Object.entries(spec)) {
         out[name] = def.type === 'flag' ? false : def.type === 'list' ? [] : undefined;
     }
-    for (let i = 0; i < argv.length; i++) {
+    let i = 0;
+    while (i < argv.length) {
         const token = argv[i];
         if (token.startsWith('--')) {
-            const name = token.slice(2);
-            const def = spec[name];
-            if (!def)
-                continue;
-            if (def.type === 'flag') {
-                out[name] = true;
-            }
-            else if (def.type === 'value' && i + 1 < argv.length) {
-                out[name] = argv[++i];
-            }
-            else if (def.type === 'list' && i + 1 < argv.length) {
-                const next = argv[++i];
-                for (const part of next.split(',')) {
-                    const t = part.trim();
-                    if (t)
-                        out[name].push(t);
-                }
-            }
+            // An option may consume the following entry as its value.
+            i += 1 + readOption(out, spec, argv, i);
         }
         else {
-            out.positional.push(token);
-            // Auto-distribute positional values into the (single) list spec, if any
-            for (const [n, def] of Object.entries(spec)) {
-                if (def.type === 'list') {
-                    for (const part of token.split(',')) {
-                        const t = part.trim();
-                        if (t)
-                            out[n].push(t);
-                    }
-                    break;
-                }
-            }
+            readPositional(out, spec, token);
+            i += 1;
         }
     }
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     return out;
 }
+/** Split on ',' and append the non-empty tokens. */
+function pushCsv(target, raw) {
+    for (const part of raw.split(',')) {
+        const t = part.trim();
+        if (t)
+            target.push(t);
+    }
+}
+/**
+ * Read one `--name [value]` option at `i`. Returns how many *extra* argv entries it
+ * consumed (1 when it took the next entry as its value, 0 otherwise).
+ */
+function readOption(out, spec, argv, i) {
+    const name = argv[i].slice(2);
+    const def = spec[name];
+    if (!def)
+        return 0;
+    const hasNext = i + 1 < argv.length;
+    if (def.type === 'flag') {
+        out[name] = true;
+    }
+    else if (def.type === 'value' && hasNext) {
+        out[name] = argv[i + 1];
+        return 1;
+    }
+    else if (def.type === 'list' && hasNext) {
+        pushCsv(out[name], argv[i + 1]);
+        return 1;
+    }
+    return 0;
+}
+/** A positional token also feeds the (single) list spec, so `a b` and `a,b` both work. */
+function readPositional(out, spec, token) {
+    out.positional.push(token);
+    for (const [name, def] of Object.entries(spec)) {
+        if (def.type === 'list') {
+            pushCsv(out[name], token);
+            break;
+        }
+    }
+}
 /**
  * CLI entry-point wrapper: prints a header, awaits `fn`, and turns thrown errors into a red message
  * with a non-zero exit code (without aborting the process synchronously, so unfinished stdout flushes).

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

@@ -1,5 +1,5 @@
 import type { DbTables, ITable, TableOperation } from '../../types.js';
-export interface ManifestField {
+interface ManifestField {
     type: string;
     /** Present (true) when the field must be sent on insert. */
     required?: boolean;
@@ -8,7 +8,7 @@ export interface ManifestField {
     /** Present (true) when the field is writable but never returned by reads (readExclude). */
     writeOnly?: boolean;
 }
-export interface ManifestJoin {
+interface ManifestJoin {
     alias: string;
     table: string;
     /** '1:N' → usable in joinMustExist/joinMultiple/joinGroup; 'N:1' → usable in joinLeft. */
@@ -50,4 +50,5 @@ export declare function buildAgentManifest(dbTables: DbTables): AgentManifest;
  * Notation: `!` required on insert, `?` nullable, `(writeOnly)` never returned by reads.
  */
 export declare function renderAgentManifestMd(manifest: AgentManifest): string;
+export {};
 //# sourceMappingURL=manifest.d.ts.map

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,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAOvE,MAAM,WAAW,aAAa;IAC5B,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,MAAM,WAAW,YAAY;IAC3B,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;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,GAAG,aAAa,CAuDpE;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,CA2CrE"}
+{"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"}

package/dist/lib/agent/manifest.js

@@ -40,6 +40,65 @@ export function tableOperations(tableConf) {
         return [...requested];
     return requested.filter((op) => !SINGLE_PK_OPERATIONS.has(op));
 }
+/** Field descriptors: type, plus the flags an agent needs to build a valid payload. */
+function manifestFields(tableConf) {
+    const schema = tableConf.Schema;
+    const required = new Set((schema.validation.required) ?? []);
+    const readExcluded = new Set(tableConf.readExclude ?? []);
+    const fields = {};
+    for (const [name, fieldSchema] of Object.entries(schema.fields)) {
+        const f = { type: shortType(fieldSchema) };
+        if (required.has(name))
+            f.required = true;
+        if (isNullable(fieldSchema))
+            f.nullable = true;
+        if (readExcluded.has(name))
+            f.writeOnly = true;
+        fields[name] = f;
+    }
+    return fields;
+}
+function manifestJoins(joins) {
+    return (joins ?? []).map((j) => ({
+        alias: j.alias,
+        table: j.joinSchema.tableName,
+        kind: j.unique ? 'N:1' : '1:N',
+    }));
+}
+function manifestExtraFilters(tableConf) {
+    const entries = Object.entries(tableConf.extraFilters ?? {});
+    if (entries.length === 0)
+        return undefined;
+    return Object.fromEntries(entries.map(([n, s]) => [n, shortType(s)]));
+}
+/** One table's entry. Optional keys are omitted entirely when empty, to keep the prompt small. */
+function manifestTable(tableConf) {
+    const entry = {
+        table: tableConf.Schema.tableName,
+        primary: tableConf.primary,
+        operations: tableOperations(tableConf),
+        fields: manifestFields(tableConf),
+    };
+    const computed = computedTypes(tableConf);
+    const extraFilters = manifestExtraFilters(tableConf);
+    const readJoins = manifestJoins(tableConf.allowedReadJoins);
+    const writeJoins = manifestJoins(tableConf.allowedWriteJoins);
+    if (tableConf.excludeFromCreation?.length)
+        entry.serverGenerated = [...tableConf.excludeFromCreation];
+    if (computed)
+        entry.computed = computed;
+    if (extraFilters)
+        entry.extraFilters = extraFilters;
+    if (readJoins.length)
+        entry.readJoins = readJoins;
+    if (writeJoins.length)
+        entry.writeJoins = writeJoins;
+    if (tableConf.tenantScope)
+        entry.tenantScoped = true;
+    if (tableConf.defaultOrder)
+        entry.defaultOrder = tableConf.defaultOrder;
+    return entry;
+}
 /**
  * Build the machine-readable description of every table exposed by this deployment:
  * fields (type/required/nullable), enabled operations, join aliases, computed fields,
@@ -50,55 +109,7 @@ export function tableOperations(tableConf) {
 export function buildAgentManifest(dbTables) {
     const tables = {};
     for (const [key, tableConf] of Object.entries(dbTables)) {
-        const schema = tableConf.Schema;
-        const required = new Set((schema.validation.required) ?? []);
-        const readExcluded = new Set(tableConf.readExclude ?? []);
-        const fields = {};
-        for (const [name, fieldSchema] of Object.entries(schema.fields)) {
-            const f = { type: shortType(fieldSchema) };
-            if (required.has(name))
-                f.required = true;
-            if (isNullable(fieldSchema))
-                f.nullable = true;
-            if (readExcluded.has(name))
-                f.writeOnly = true;
-            fields[name] = f;
-        }
-        const readJoins = (tableConf.allowedReadJoins ?? []).map((j) => ({
-            alias: j.alias,
-            table: j.joinSchema.tableName,
-            kind: j.unique ? 'N:1' : '1:N',
-        }));
-        const writeJoins = (tableConf.allowedWriteJoins ?? []).map((j) => ({
-            alias: j.alias,
-            table: j.joinSchema.tableName,
-            kind: j.unique ? 'N:1' : '1:N',
-        }));
-        const extraFilters = Object.keys(tableConf.extraFilters ?? {}).length
-            ? Object.fromEntries(Object.entries(tableConf.extraFilters).map(([n, s]) => [n, shortType(s)]))
-            : undefined;
-        const entry = {
-            table: schema.tableName,
-            primary: tableConf.primary,
-            operations: tableOperations(tableConf),
-            fields,
-        };
-        if (tableConf.excludeFromCreation?.length)
-            entry.serverGenerated = [...tableConf.excludeFromCreation];
-        const computed = computedTypes(tableConf);
-        if (computed)
-            entry.computed = computed;
-        if (extraFilters)
-            entry.extraFilters = extraFilters;
-        if (readJoins.length)
-            entry.readJoins = readJoins;
-        if (writeJoins.length)
-            entry.writeJoins = writeJoins;
-        if (tableConf.tenantScope)
-            entry.tenantScoped = true;
-        if (tableConf.defaultOrder)
-            entry.defaultOrder = tableConf.defaultOrder;
-        tables[key] = entry;
+        tables[key] = manifestTable(tableConf);
     }
     return { tables };
 }
@@ -114,40 +125,53 @@ export function renderAgentManifestMd(manifest) {
         '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.',
+        'filters: unknown keys are rejected (400), never ignored. extraFilters do not apply ' +
+            'under joinLeft — use joinMustExist on the same relation.',
         '',
     ];
     for (const t of Object.values(manifest.tables)) {
-        const pk = Array.isArray(t.primary) ? t.primary.join('+') : t.primary;
-        const flags = t.tenantScoped ? '  [tenant-scoped]' : '';
-        lines.push(`## ${t.table}  PK:${pk}  ops:${t.operations.join(',')}${flags}`);
-        const fieldParts = Object.entries(t.fields).map(([name, f]) => {
-            let s = `${name}:${f.type}`;
-            if (f.required)
-                s += '!';
-            if (f.nullable)
-                s += '?';
-            if (f.writeOnly)
-                s += '(writeOnly)';
-            return s;
-        });
-        lines.push(`fields: ${fieldParts.join(', ')}`);
-        if (t.serverGenerated)
-            lines.push(`serverGenerated: ${t.serverGenerated.join(', ')}`);
-        if (t.computed) {
-            lines.push(`computed: ${Object.entries(t.computed).map(([n, ty]) => `${n}:${ty}`).join(', ')}`);
-        }
-        if (t.extraFilters) {
-            lines.push(`extraFilters: ${Object.entries(t.extraFilters).map(([n, ty]) => `${n}:${ty}`).join(', ')}`);
-        }
-        if (t.readJoins) {
-            lines.push(`readJoins: ${t.readJoins.map((j) => `${j.alias}→${j.table}(${j.kind})`).join(', ')}`);
-        }
-        if (t.writeJoins) {
-            lines.push(`writeJoins: ${t.writeJoins.map((j) => `${j.alias}→${j.table}`).join(', ')}`);
-        }
-        if (t.defaultOrder)
-            lines.push(`defaultOrder: ${t.defaultOrder}`);
-        lines.push('');
+        lines.push(...renderTableMd(t));
     }
     return lines.join('\n');
 }
+/** `name:type` pairs — the compact form used throughout the 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)`. */
+function fieldNotation(f) {
+    let s = f.type;
+    if (f.required)
+        s += '!';
+    if (f.nullable)
+        s += '?';
+    if (f.writeOnly)
+        s += '(writeOnly)';
+    return s;
+}
+function renderTableMd(t) {
+    const pk = Array.isArray(t.primary) ? t.primary.join('+') : t.primary;
+    const flags = t.tenantScoped ? '  [tenant-scoped]' : '';
+    const ops = t.operations.join(',');
+    const lines = [`## ${t.table}  PK:${pk}  ops:${ops}${flags}`];
+    const fieldParts = Object.entries(t.fields).map(([name, f]) => `${name}:${fieldNotation(f)}`);
+    lines.push(`fields: ${fieldParts.join(', ')}`);
+    if (t.serverGenerated)
+        lines.push(`serverGenerated: ${t.serverGenerated.join(', ')}`);
+    if (t.computed)
+        lines.push(`computed: ${namedTypes(t.computed)}`);
+    if (t.extraFilters)
+        lines.push(`extraFilters: ${namedTypes(t.extraFilters)}`);
+    if (t.readJoins) {
+        const readJoins = t.readJoins.map((j) => `${j.alias}→${j.table}(${j.kind})`);
+        lines.push(`readJoins: ${readJoins.join(', ')}`);
+    }
+    if (t.writeJoins) {
+        const writeJoins = t.writeJoins.map((j) => `${j.alias}→${j.table}`);
+        lines.push(`writeJoins: ${writeJoins.join(', ')}`);
+    }
+    if (t.defaultOrder)
+        lines.push(`defaultOrder: ${t.defaultOrder}`);
+    lines.push('');
+    return lines;
+}

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

@@ -1,16 +1,11 @@
 import type { ColumnInfo } from '../../types.js';
-export declare function buildMysqlConnectionConfig(): {
+export interface MysqlConnectionConfig {
     host: string;
     port: number;
     user: string;
     password: string;
     database: string;
-};
-export declare function introspectMysqlTables(connectionConfig: {
-    host: string;
-    port: number;
-    user: string;
-    password: string;
-    database: string;
-}, schema: string): Promise<ColumnInfo[]>;
+}
+export declare function buildMysqlConnectionConfig(): MysqlConnectionConfig;
+export declare function introspectMysqlTables(connectionConfig: MysqlConnectionConfig, schema: string): Promise<ColumnInfo[]>;
 //# 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,wBAAgB,0BAA0B,IAAI;IAC5C,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,CAmBA;AAkDD,wBAAsB,qBAAqB,CACzC,gBAAgB,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,EAClG,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,UAAU,EAAE,CAAC,CA2BvB"}
+{"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"}

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

@@ -66,7 +66,6 @@ function mapMysqlType(dataType) {
     }
 }
 export async function introspectMysqlTables(connectionConfig, schema) {
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     const mysql2 = loadOptionalDependency('mysql2/promise', 'npm install mysql2');
     const connection = await mysql2.createConnection(connectionConfig);
     try {
@@ -74,13 +73,15 @@ export async function introspectMysqlTables(connectionConfig, schema) {
        FROM information_schema.columns
        WHERE table_schema = ?
        ORDER BY table_name, ordinal_position`, [schema]);
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        // `||` 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,
-            is_nullable: row.IS_NULLABLE || row.is_nullable,
+            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'),
         }));

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;AAEjD,wBAAgB,qBAAqB,IAAI,MAAM,CAY9C;AAED,wBAAsB,gBAAgB,CACpC,gBAAgB,EAAE,MAAM,EACxB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,UAAU,EAAE,CAAC,CA8BvB"}
+{"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"}

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

@@ -11,7 +11,6 @@ export function buildConnectionString() {
     return `postgres://${user}:${password}@${host}:${port}/${db}`;
 }
 export async function introspectTables(connectionString, schema) {
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     const pg = loadOptionalDependency('pg', 'npm install pg');
     const client = new pg.Client({ connectionString });
     try {

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

@@ -1,4 +1,7 @@
 import type { ColumnInfo, TableMap } from '../../types.js';
+/** Maps a DB column type to its TypeBox schema expression.
+ * @testonly Exported only so unit tests can exercise it directly.
+ */
 export declare function convertColType(udtName: string, columnInfo: {
     column_default: string | null;
     is_nullable: string;

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

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

@@ -1,4 +1,7 @@
 import { toCamelCase, toSchemaName } from '../naming.js';
+/** Maps a DB column type to its TypeBox schema expression.
+ * @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;

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

@@ -6,15 +6,22 @@ export interface ParsedSchema {
     /** PRIMARY KEY fields declared in the schema file (`primaryKey: [...]`), when present. */
     primary?: string[];
 }
-export interface DetectedRelation {
+interface DetectedRelation {
     parentSchemaName: string;
     parentField: string;
     childSchemaName: string;
     childField: string;
 }
 export declare function parseSchemaFile(content: string): ParsedSchema | null;
+/** Infers FK relations between parsed schemas.
+ * @testonly Exported only so unit tests can exercise it directly.
+ */
 export declare function detectRelations(schemas: ParsedSchema[]): DetectedRelation[];
 export declare function generateSingleTableFile(schema: ParsedSchema, allSchemas: ParsedSchema[]): string;
 export declare function generateDbTablesIndex(schemas: ParsedSchema[]): string;
+/** Legacy single-file DbTables generator.
+ * @testonly Exported only so unit tests can exercise it directly.
+ */
 export declare function generateTablesFile(schemas: ParsedSchema[]): string;
+export {};
 //# sourceMappingURL=tables-codegen.d.ts.map

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,MAAM,WAAW,gBAAgB;IAC/B,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;AAuCD,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,gBAAgB,EAAE,CAwB3E;AAID,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,GAAG,MAAM,CA6HhG;AAID,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,MAAM,CAqBrE;AAID,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,MAAM,CA6FlE"}
+{"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"}