fastify-auto-sqlapi 0.1.14 → 0.2.1

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 };
 }
@@ -119,37 +130,48 @@ export function renderAgentManifestMd(manifest) {
         '',
     ];
     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"}

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

@@ -1,13 +1,13 @@
 import { toUnderscore } from '../naming.js';
 // ─── Parsing ─────────────────────────────────────────────────
 export function parseSchemaFile(content) {
-    const tableNameMatch = content.match(/tableName:\s*"([^"]+)"/);
+    const tableNameMatch = /tableName:\s*"([^"]+)"/.exec(content);
     if (!tableNameMatch)
         return null;
-    const exportMatch = content.match(/export const (Schema\w+)\s*=\s*Schema/);
+    const exportMatch = /export const (Schema\w+)\s*=\s*Schema/.exec(content);
     if (!exportMatch)
         return null;
-    const schemaBlockMatch = content.match(/const _Schema\s*=\s*\{([\s\S]*?)};/);
+    const schemaBlockMatch = /const _Schema\s*=\s*\{([\s\S]*?)};/.exec(content);
     if (!schemaBlockMatch)
         return null;
     const fields = [];
@@ -22,7 +22,7 @@ export function parseSchemaFile(content) {
         return null;
     // primaryKey: ["code"] — emitted by generate-schema from DB introspection
     let primary;
-    const pkMatch = content.match(/primaryKey:\s*\[([^\]]*)\]/);
+    const pkMatch = /primaryKey:\s*\[([^\]]*)\]/.exec(content);
     if (pkMatch) {
         primary = pkMatch[1]
             .split(',')
@@ -64,12 +64,18 @@ function pkFirst(pk) {
 }
 /** Render the `primary:` value for the defineTable template. */
 function formatPrimary(pk) {
-    return Array.isArray(pk) ? `[${pk.map((p) => `'${p}'`).join(', ')}]` : `'${pk}'`;
+    if (!Array.isArray(pk))
+        return `'${pk}'`;
+    const quoted = pk.map((p) => `'${p}'`);
+    return `[${quoted.join(', ')}]`;
 }
 /** All PK fields as an array, for "non-PK field" lookups in example snippets. */
 function pkFields(pk) {
     return Array.isArray(pk) ? pk : [pk];
 }
+/** Infers FK relations between parsed schemas.
+ * @testonly Exported only so unit tests can exercise it directly.
+ */
 export function detectRelations(schemas) {
     const tableBySnakeName = new Map();
     for (const schema of schemas) {
@@ -96,36 +102,68 @@ export function detectRelations(schemas) {
     return relations;
 }
 // ─── Single Table File Generation ────────────────────────────
-export function generateSingleTableFile(schema, allSchemas) {
-    const relations = detectRelations(allSchemas);
-    const relsByParent = new Map();
-    const relsByChild = new Map();
+/** Relations grouped by the schema they hang off, in both directions. */
+function indexRelations(relations) {
+    const byParent = new Map();
+    const byChild = new Map();
     for (const rel of relations) {
-        const arr = relsByParent.get(rel.parentSchemaName) || [];
-        arr.push(rel);
-        relsByParent.set(rel.parentSchemaName, arr);
-        const childArr = relsByChild.get(rel.childSchemaName) || [];
+        const parentArr = byParent.get(rel.parentSchemaName) ?? [];
+        parentArr.push(rel);
+        byParent.set(rel.parentSchemaName, parentArr);
+        const childArr = byChild.get(rel.childSchemaName) ?? [];
         childArr.push(rel);
-        relsByChild.set(rel.childSchemaName, childArr);
+        byChild.set(rel.childSchemaName, childArr);
     }
-    const { pk, autoIncrement } = detectPrimaryKey(schema);
-    const tableVarName = 'Table' + schema.schemaName.replace(/^Schema/, '');
-    const parentRels = relsByParent.get(schema.schemaName) || [];
-    const childRels = relsByChild.get(schema.schemaName) || [];
-    // Collect related schema names for commented imports
-    const relatedSchemas = new Set();
-    for (const rel of parentRels) {
-        if (rel.childSchemaName !== schema.schemaName)
-            relatedSchemas.add(rel.childSchemaName);
-        if (rel.parentSchemaName !== schema.schemaName)
-            relatedSchemas.add(rel.parentSchemaName);
+    return { byParent, byChild };
+}
+/** Schemas on the other end of a relation — emitted as commented-out imports. */
+function collectRelatedSchemas(ownName, ...relationGroups) {
+    const related = new Set();
+    for (const rels of relationGroups) {
+        for (const rel of rels) {
+            if (rel.childSchemaName !== ownName)
+                related.add(rel.childSchemaName);
+            if (rel.parentSchemaName !== ownName)
+                related.add(rel.parentSchemaName);
+        }
     }
-    for (const rel of childRels) {
-        if (rel.parentSchemaName !== schema.schemaName)
-            relatedSchemas.add(rel.parentSchemaName);
-        if (rel.childSchemaName !== schema.schemaName)
-            relatedSchemas.add(rel.childSchemaName);
+    return related;
+}
+/** A plausible `schemaOverrides` example: an email format if there is one, else a minLength. */
+function schemaOverridesLine(schema, pk) {
+    const emailField = schema.fields.find((f) => f.toLowerCase().includes('email'));
+    if (emailField) {
+        return `  // schemaOverrides: { ${emailField}: Type.String({ format: 'email' }) },`;
+    }
+    const stringField = schema.fields.find((f) => !pkFields(pk).includes(f) && schema.fieldTypes[f]?.includes('String'));
+    return stringField
+        ? `  // schemaOverrides: { ${stringField}: Type.String({ minLength: 1 }) },`
+        : `  // schemaOverrides: {},`;
+}
+/** Indirect scope when the table hangs off a parent, direct scope otherwise. */
+function tenantScopeLine(childRels) {
+    const rel = childRels[0];
+    if (!rel)
+        return `  // tenantScope: { column: 'tenant_col' },`;
+    return `  // tenantScope: { column: 'tenant_col', through: { schema: ${rel.parentSchemaName}, localField: '${rel.childField}', foreignField: '${rel.parentField}' } },`;
+}
+function allowedReadJoinsLines(parentRels) {
+    if (parentRels.length === 0)
+        return [`  // allowedReadJoins: [],`];
+    const lines = [`  // allowedReadJoins: [`];
+    for (const rel of parentRels) {
+        lines.push(`  //   buildRelation(${rel.parentSchemaName}, '${rel.parentField}', ${rel.childSchemaName}, '${rel.childField}'),`);
     }
+    lines.push(`  // ],`);
+    return lines;
+}
+export function generateSingleTableFile(schema, allSchemas) {
+    const { byParent, byChild } = indexRelations(detectRelations(allSchemas));
+    const { pk, autoIncrement } = detectPrimaryKey(schema);
+    const tableVarName = 'Table' + schema.schemaName.replace(/^Schema/, '');
+    const parentRels = byParent.get(schema.schemaName) ?? [];
+    const childRels = byChild.get(schema.schemaName) ?? [];
+    const relatedSchemas = collectRelatedSchemas(schema.schemaName, parentRels, childRels);
     const lines = [];
     // Imports
     lines.push(`import {defineTable, exportTableInfo, Type} from 'fastify-auto-sqlapi';`);
@@ -165,31 +203,10 @@ export function generateSingleTableFile(schema, allSchemas) {
     }
     // Hide columns from every read (writes still accept them, e.g. a password hash)
     lines.push(`  // readExclude: [],`);
-    if (parentRels.length > 0) {
-        lines.push(`  // allowedReadJoins: [`);
-        for (const rel of parentRels) {
-            lines.push(`  //   buildRelation(${rel.parentSchemaName}, '${rel.parentField}', ${rel.childSchemaName}, '${rel.childField}'),`);
-        }
-        lines.push(`  // ],`);
-    }
-    else {
-        lines.push(`  // allowedReadJoins: [],`);
-    }
-    lines.push(`  // upsertMap: buildUpsertRules(buildUpsertRule(Schema, [${pkFields(pk).map((p) => `'${p}'`).join(', ')}])),`);
-    // schemaOverrides: suggest email format if email field exists, otherwise minLength on first string field
-    const emailField = schema.fields.find(f => f.toLowerCase().includes('email'));
-    if (emailField) {
-        lines.push(`  // schemaOverrides: { ${emailField}: Type.String({ format: 'email' }) },`);
-    }
-    else {
-        const stringField = schema.fields.find(f => !pkFields(pk).includes(f) && schema.fieldTypes[f]?.includes('String'));
-        if (stringField) {
-            lines.push(`  // schemaOverrides: { ${stringField}: Type.String({ minLength: 1 }) },`);
-        }
-        else {
-            lines.push(`  // schemaOverrides: {},`);
-        }
-    }
+    lines.push(...allowedReadJoinsLines(parentRels));
+    const upsertPk = pkFields(pk).map((p) => `'${p}'`).join(', ');
+    lines.push(`  // upsertMap: buildUpsertRules(buildUpsertRule(Schema, [${upsertPk}])),`);
+    lines.push(schemaOverridesLine(schema, pk));
     // validate: use first non-PK field for example
     const exampleField = schema.fields.find(f => !pkFields(pk).includes(f)) || schema.fields[0];
     lines.push(`  validate: async (db, req, main, secondaries) => {`);
@@ -199,13 +216,7 @@ export function generateSingleTableFile(schema, allSchemas) {
     lines.push(`  },`);
     lines.push(`  // beforeInsert: async (db, req, record) => {},`);
     lines.push(`  // beforeUpdate: async (db, req, fields) => {},`);
-    if (childRels.length > 0) {
-        const rel = childRels[0];
-        lines.push(`  // tenantScope: { column: 'tenant_col', through: { schema: ${rel.parentSchemaName}, localField: '${rel.childField}', foreignField: '${rel.parentField}' } },`);
-    }
-    else {
-        lines.push(`  // tenantScope: { column: 'tenant_col' },`);
-    }
+    lines.push(tenantScopeLine(childRels));
     lines.push(`});`);
     lines.push(``);
     return lines.join('\n');
@@ -230,18 +241,33 @@ export function generateDbTablesIndex(schemas) {
     return lines.join('\n');
 }
 // ─── Code Generation (legacy) ───────────────────────────────
+/** One `defineTable({...})` block for the legacy single-file generator. */
+function legacyTableBlock(schema, parentRels, childRels) {
+    const { pk, autoIncrement } = 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} ──────────────────────────────`,
+        `// Fields: ${schema.fields.join(', ')}`,
+        `const ${tableVarName} = defineTable({`,
+        `  primary: ${formatPrimary(pk)},`,
+        `  ...exportTableInfo(${schema.schemaName}),`,
+        `  defaultOrder: '${pkFirst(pk)}',`,
+        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;
+}
+/** Legacy single-file DbTables generator.
+ * @testonly Exported only so unit tests can exercise it directly.
+ */
 export function generateTablesFile(schemas) {
-    const relations = detectRelations(schemas);
-    const relsByParent = new Map();
-    const relsByChild = new Map();
-    for (const rel of relations) {
-        const arr = relsByParent.get(rel.parentSchemaName) || [];
-        arr.push(rel);
-        relsByParent.set(rel.parentSchemaName, arr);
-        const childArr = relsByChild.get(rel.childSchemaName) || [];
-        childArr.push(rel);
-        relsByChild.set(rel.childSchemaName, childArr);
-    }
+    const { byParent, byChild } = indexRelations(detectRelations(schemas));
     const lines = [];
     // Imports
     lines.push(`import {defineTable, exportTableInfo, Type} from 'fastify-auto-sqlapi';`);
@@ -253,51 +279,7 @@ export function generateTablesFile(schemas) {
     }
     // Table definitions
     for (const schema of schemas) {
-        const { pk, autoIncrement } = detectPrimaryKey(schema);
-        const tableVarName = 'Table' + schema.schemaName.replace(/^Schema/, '');
-        const parentRels = relsByParent.get(schema.schemaName) || [];
-        lines.push(``);
-        lines.push(`// ─── ${schema.tableName} ──────────────────────────────`);
-        lines.push(`// Fields: ${schema.fields.join(', ')}`);
-        lines.push(`const ${tableVarName} = defineTable({`);
-        lines.push(`  primary: ${formatPrimary(pk)},`);
-        lines.push(`  ...exportTableInfo(${schema.schemaName}),`);
-        lines.push(`  defaultOrder: '${pkFirst(pk)}',`);
-        if (autoIncrement) {
-            lines.push(`  excludeFromCreation: ['${pkFirst(pk)}'],`);
-        }
-        else {
-            lines.push(`  // excludeFromCreation: [],`);
-        }
-        if (parentRels.length > 0) {
-            lines.push(`  // allowedReadJoins: [`);
-            for (const rel of parentRels) {
-                lines.push(`  //   buildRelation(${rel.parentSchemaName}, '${rel.parentField}', ${rel.childSchemaName}, '${rel.childField}'),`);
-            }
-            lines.push(`  // ],`);
-        }
-        else {
-            lines.push(`  // allowedReadJoins: [],`);
-        }
-        lines.push(`  // upsertMap: buildUpsertRules(buildUpsertRule(${schema.schemaName}, [${pkFields(pk).map((p) => `'${p}'`).join(', ')}])),`);
-        lines.push(`  // schemaOverrides: {},`);
-        const exampleFieldLegacy = schema.fields.find(f => !pkFields(pk).includes(f)) || schema.fields[0];
-        lines.push(`  validate: async (db, req, main, secondaries) => {`);
-        lines.push(`    const errors: ValidationError[] = [];`);
-        lines.push(`    // if (!main.${exampleFieldLegacy}) errors.push(['${exampleFieldLegacy}', 'required']);`);
-        lines.push(`    return errors;`);
-        lines.push(`  },`);
-        lines.push(`  // beforeInsert: async (db, req, record) => {},`);
-        lines.push(`  // beforeUpdate: async (db, req, fields) => {},`);
-        const childRels = relsByChild.get(schema.schemaName) || [];
-        if (childRels.length > 0) {
-            const rel = childRels[0];
-            lines.push(`  // tenantScope: { column: 'tenant_col', through: { schema: ${rel.parentSchemaName}, localField: '${rel.childField}', foreignField: '${rel.parentField}' } },`);
-        }
-        else {
-            lines.push(`  // tenantScope: { column: 'tenant_col' },`);
-        }
-        lines.push(`});`);
+        lines.push(...legacyTableBlock(schema, byParent.get(schema.schemaName) ?? [], byChild.get(schema.schemaName) ?? []));
     }
     // DbTables export
     lines.push(``);

package/dist/lib/condition-methods.d.ts

@@ -1,11 +1,21 @@
-export declare const SINGLE_VALUE_METHODS: readonly ["isEqual", "isNotEqual", "isGreater", "isNotGreater", "isGreaterOrEqual", "isNotGreaterOrEqual", "isLess", "isNotLess", "isLessOrEqual", "isNotLessOrEqual", "isLike", "isNotLike", "isILike", "isNotILike"];
-export declare const BETWEEN_METHODS: readonly ["isBetween", "isNotBetween"];
-export declare const IN_METHODS: readonly ["isIn", "isNotIn"];
-export declare const NULL_METHODS: readonly ["isNull", "isNotNull"];
 export declare const ALLOWED_METHODS: readonly ["isEqual", "isNotEqual", "isGreater", "isNotGreater", "isGreaterOrEqual", "isNotGreaterOrEqual", "isLess", "isNotLess", "isLessOrEqual", "isNotLessOrEqual", "isLike", "isNotLike", "isILike", "isNotILike", "isBetween", "isNotBetween", "isIn", "isNotIn", "isNull", "isNotNull"];
 export declare const SINGLE_VALUE_SET: Set<string>;
 export declare const BETWEEN_SET: Set<string>;
 export declare const IN_SET: Set<string>;
 export declare const NULL_SET: Set<string>;
 export declare const ALLOWED_SET: Set<string>;
+/**
+ * Caps on how much work one search request may ask for.
+ *
+ * Every dotted condition and every 3-part `orderBy` token becomes its own correlated subquery,
+ * so an uncapped list turns a single request into arbitrarily many — `maxItemsPerPage` bounds
+ * the rows returned, not the work done to find them. They live here, in the data module both
+ * the engine and the TypeBox schema builders already share, so the request schema advertises
+ * exactly the limit the engine enforces.
+ */
+export declare const MAX_CONDITIONS = 100;
+/** Token cap the engine applies to `orderBy`, counted over its comma-separated parts. */
+export declare const MAX_ORDER_BY_PARTS = 20;
+/** Character cap the request schema applies to `orderBy` — generous for MAX_ORDER_BY_PARTS. */
+export declare const MAX_ORDER_BY_LENGTH = 1024;
 //# sourceMappingURL=condition-methods.d.ts.map