fastify-auto-sqlapi 0.0.5 → 0.1.1

package/dist/routes/auto/bulk-delete.routes.js

@@ -1,27 +1,21 @@
 import { BulkDeleteTableBody, BulkDeleteTableResponse } from '../../lib/schema/bulk-delete.js';
 import { primaryAsString } from '../../types.js';
-import { mergeOnRequests } from './route-helpers.js';
+import { registerForAllTables } from './route-helpers.js';
 export default async function bulkDeleteRoutes(fastify, options) {
-    const { DbTables } = options;
-    for (const [tableName, tableConf] of Object.entries(DbTables)) {
-        const bodySchema = BulkDeleteTableBody(DbTables, tableName);
-        const responseSchema = BulkDeleteTableResponse(DbTables, tableName);
-        fastify.route({
-            method: 'POST',
-            url: `/bulk/${tableConf.Schema.tableName}/delete`,
-            schema: {
-                body: bodySchema,
-                response: { 200: responseSchema },
-                tags: [`SqlAPI-${tableName}`],
-                summary: `Bulk delete ${tableName}`,
-                description: `Delete multiple records from ${tableName} by primary key`,
-            },
-            onRequest: mergeOnRequests(options, tableConf),
-            handler: async (request, reply) => {
-                const items = request.body;
-                const ids = items.map((item) => item[primaryAsString(tableConf.primary)]);
-                reply.send(await fastify.sqlApi.bulkDelete(tableName, ids, request));
-            },
-        });
-    }
+    await registerForAllTables(fastify, options, {
+        method: 'POST',
+        url: (tc) => `/bulk/${tc.Schema.tableName}/delete`,
+        successStatus: 200,
+        schemas: (db, table) => ({
+            body: BulkDeleteTableBody(db, table),
+            response: BulkDeleteTableResponse(db, table),
+        }),
+        summary: 'Bulk delete',
+        description: (name) => `Delete multiple records from ${name} by primary key`,
+        handle: (fastify, tableName, tc, request) => {
+            const items = request.body;
+            const ids = items.map((item) => item[primaryAsString(tc.primary)]);
+            return fastify.sqlApi.bulkDelete(tableName, ids, request);
+        },
+    });
 }

package/dist/routes/auto/bulk-upsert.routes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bulk-upsert.routes.d.ts","sourceRoot":"","sources":["../../../src/routes/auto/bulk-upsert.routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAG/C,OAAO,KAAK,EAAE,mBAAmB,EAAkB,MAAM,gBAAgB,CAAC;AAE1E,wBAA8B,gBAAgB,CAC5C,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAwBf"}
+{"version":3,"file":"bulk-upsert.routes.d.ts","sourceRoot":"","sources":["../../../src/routes/auto/bulk-upsert.routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAG/C,OAAO,KAAK,EAAE,mBAAmB,EAAkB,MAAM,gBAAgB,CAAC;AAE1E,wBAA8B,gBAAgB,CAC5C,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAgBf"}

package/dist/routes/auto/bulk-upsert.routes.js

@@ -1,25 +1,19 @@
 import { BulkUpsertTableBody, BulkUpsertTableResponse } from '../../lib/schema/bulk-upsert.js';
-import { mergeOnRequests, buildWriteDescription } from './route-helpers.js';
+import { registerForAllTables, buildWriteDescription } from './route-helpers.js';
 export default async function bulkUpsertRoutes(fastify, options) {
-    const { DbTables } = options;
-    for (const [tableName, tableConf] of Object.entries(DbTables)) {
-        const bodySchema = BulkUpsertTableBody(DbTables, tableName);
-        const responseSchema = BulkUpsertTableResponse(DbTables, tableName);
-        fastify.route({
-            method: 'PUT',
-            url: `/bulk/${tableConf.Schema.tableName}`,
-            schema: {
-                body: bodySchema,
-                response: { 200: responseSchema },
-                tags: [`SqlAPI-${tableName}`],
-                summary: `Bulk upsert ${tableName}`,
-                description: buildWriteDescription('Bulk upsert records in', tableName, tableConf),
-            },
-            onRequest: mergeOnRequests(options, tableConf),
-            handler: async (request, reply) => {
-                const items = request.body;
-                reply.send(await fastify.sqlApi.bulkUpsert(tableName, items, request));
-            },
-        });
-    }
+    await registerForAllTables(fastify, options, {
+        method: 'PUT',
+        url: (tc) => `/bulk/${tc.Schema.tableName}`,
+        successStatus: 200,
+        schemas: (db, table) => ({
+            body: BulkUpsertTableBody(db, table),
+            response: BulkUpsertTableResponse(db, table),
+        }),
+        summary: 'Bulk upsert',
+        description: (name, tc) => buildWriteDescription('Bulk upsert records in', name, tc),
+        handle: (fastify, tableName, _tc, request) => {
+            const items = request.body;
+            return fastify.sqlApi.bulkUpsert(tableName, items, request);
+        },
+    });
 }

package/dist/routes/auto/delete.routes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"delete.routes.d.ts","sourceRoot":"","sources":["../../../src/routes/auto/delete.routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAI/C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE1D,wBAA8B,YAAY,CACxC,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC,CA2Bf"}
+{"version":3,"file":"delete.routes.d.ts","sourceRoot":"","sources":["../../../src/routes/auto/delete.routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAI/C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE1D,wBAA8B,YAAY,CACxC,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAmBf"}

package/dist/routes/auto/delete.routes.js

@@ -1,29 +1,23 @@
 import { Type } from '@sinclair/typebox';
 import { primaryAsString } from '../../types.js';
-import { mergeOnRequests } from './route-helpers.js';
+import { registerForAllTables } from './route-helpers.js';
 export default async function deleteRoutes(fastify, options) {
-    const { DbTables } = options;
-    for (const [tableName, tableConf] of Object.entries(DbTables)) {
-        const pkField = primaryAsString(tableConf.primary);
-        const pkType = tableConf.Schema.fields[pkField];
-        const responseSchema = Type.Object({
-            main: Type.Object({ [pkField]: pkType }),
-        });
-        fastify.route({
-            method: 'DELETE',
-            url: `/rest/${tableConf.Schema.tableName}/:id`,
-            schema: {
+    await registerForAllTables(fastify, options, {
+        method: 'DELETE',
+        url: (tc) => `/rest/${tc.Schema.tableName}/:id`,
+        successStatus: 200,
+        schemas: (_db, _table, tc) => {
+            const pkField = primaryAsString(tc.primary);
+            return {
                 params: Type.Object({ id: Type.String() }),
-                response: { 200: responseSchema },
-                tags: [`SqlAPI-${tableName}`],
-                summary: `Delete ${tableName}`,
-                description: `Delete a record from ${tableName} by primary key`,
-            },
-            onRequest: mergeOnRequests(options, tableConf),
-            handler: async (request, reply) => {
-                const { id } = request.params;
-                reply.send(await fastify.sqlApi.delete(tableName, id, request));
-            },
-        });
-    }
+                response: Type.Object({ main: Type.Object({ [pkField]: tc.Schema.fields[pkField] }) }),
+            };
+        },
+        summary: 'Delete',
+        description: (name) => `Delete a record from ${name} by primary key`,
+        handle: (fastify, tableName, _tc, request) => {
+            const { id } = request.params;
+            return fastify.sqlApi.delete(tableName, id, request);
+        },
+    });
 }

package/dist/routes/auto/get.routes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get.routes.d.ts","sourceRoot":"","sources":["../../../src/routes/auto/get.routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAG/C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE1D,wBAA8B,SAAS,CACrC,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAyBf"}
+{"version":3,"file":"get.routes.d.ts","sourceRoot":"","sources":["../../../src/routes/auto/get.routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAG/C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE1D,wBAA8B,SAAS,CACrC,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAgBf"}

package/dist/routes/auto/get.routes.js

@@ -1,26 +1,19 @@
 import { Type } from '@sinclair/typebox';
-import { mergeOnRequests } from './route-helpers.js';
+import { registerForAllTables } from './route-helpers.js';
 export default async function getRoutes(fastify, options) {
-    const { DbTables } = options;
-    for (const [tableName, tableConf] of Object.entries(DbTables)) {
-        const responseSchema = Type.Object({
-            main: Type.Partial(Type.Object(tableConf.Schema.fields)),
-        });
-        fastify.route({
-            method: 'GET',
-            url: `/rest/${tableConf.Schema.tableName}/:id`,
-            schema: {
-                params: Type.Object({ id: Type.String() }),
-                response: { 200: responseSchema },
-                tags: [`SqlAPI-${tableName}`],
-                summary: `Get ${tableName}`,
-                description: `Get a record from ${tableName} by primary key`,
-            },
-            onRequest: mergeOnRequests(options, tableConf),
-            handler: async (request, reply) => {
-                const { id } = request.params;
-                reply.send(await fastify.sqlApi.get(tableName, id, request));
-            },
-        });
-    }
+    await registerForAllTables(fastify, options, {
+        method: 'GET',
+        url: (tc) => `/rest/${tc.Schema.tableName}/:id`,
+        successStatus: 200,
+        schemas: (_db, _table, tc) => ({
+            params: Type.Object({ id: Type.String() }),
+            response: Type.Object({ main: Type.Partial(Type.Object(tc.Schema.fields)) }),
+        }),
+        summary: 'Get',
+        description: (name) => `Get a record from ${name} by primary key`,
+        handle: (fastify, tableName, _tc, request) => {
+            const { id } = request.params;
+            return fastify.sqlApi.get(tableName, id, request);
+        },
+    });
 }

package/dist/routes/auto/insert.routes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"insert.routes.d.ts","sourceRoot":"","sources":["../../../src/routes/auto/insert.routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAG/C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE1D,wBAA8B,YAAY,CACxC,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAiCf"}
+{"version":3,"file":"insert.routes.d.ts","sourceRoot":"","sources":["../../../src/routes/auto/insert.routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAG/C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE1D,wBAA8B,YAAY,CACxC,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAsBf"}

package/dist/routes/auto/insert.routes.js

@@ -1,29 +1,22 @@
 import { InsertTableBody, InsertTableResponse } from '../../lib/schema/insert.js';
-import { mergeOnRequests, buildWriteDescription } from './route-helpers.js';
+import { registerForAllTables, buildWriteDescription } from './route-helpers.js';
 export default async function insertRoutes(fastify, options) {
-    const { DbTables } = options;
-    for (const [tableName, tableConf] of Object.entries(DbTables)) {
-        const bodySchema = InsertTableBody(DbTables, tableName);
-        const responseSchema = InsertTableResponse(DbTables, tableName);
-        fastify.route({
-            method: 'POST',
-            url: `/rest/${tableConf.Schema.tableName}`,
-            schema: {
-                body: bodySchema,
-                response: { 201: responseSchema },
-                tags: [`SqlAPI-${tableName}`],
-                summary: `Insert ${tableName}`,
-                description: buildWriteDescription('Insert a record into', tableName, tableConf),
-            },
-            onRequest: mergeOnRequests(options, tableConf),
-            handler: async (request, reply) => {
-                const body = request.body;
-                const result = await fastify.sqlApi.insert(tableName, {
-                    record: body.main,
-                    secondaries: body.secondaries,
-                }, request);
-                reply.status(201).send(result);
-            },
-        });
-    }
+    await registerForAllTables(fastify, options, {
+        method: 'POST',
+        url: (tc) => `/rest/${tc.Schema.tableName}`,
+        successStatus: 201,
+        schemas: (db, table) => ({
+            body: InsertTableBody(db, table),
+            response: InsertTableResponse(db, table),
+        }),
+        summary: 'Insert',
+        description: (name, tc) => buildWriteDescription('Insert a record into', name, tc),
+        handle: (fastify, tableName, _tc, request) => {
+            const body = request.body;
+            return fastify.sqlApi.insert(tableName, {
+                record: body.main,
+                secondaries: body.secondaries,
+            }, request);
+        },
+    });
 }

package/dist/routes/auto/route-helpers.d.ts

@@ -1,7 +1,32 @@
-import type { FastifyRequest, FastifyReply } from 'fastify';
-import type { ITable, SqlApiPluginOptions } from '../../types.js';
+import type { FastifyInstance, FastifyRequest, FastifyReply } from 'fastify';
+import type { ITable, SqlApiPluginOptions, DbTables } from '../../types.js';
 type RequestHook = (request: FastifyRequest, reply: FastifyReply) => Promise<void | FastifyReply>;
 export declare function mergeOnRequests(options: SqlApiPluginOptions, tableConf: ITable): RequestHook[];
 export declare function buildWriteDescription(action: string, tableName: string, tableConf: ITable): string;
+interface RouteSchema {
+    body?: any;
+    params?: any;
+    querystring?: any;
+    response?: any;
+}
+export interface AutoRouteSpec {
+    method: 'GET' | 'POST' | 'PUT' | 'DELETE';
+    /** URL builder receiving the table configuration to read `Schema.tableName`. */
+    url: (tableConf: ITable) => string;
+    successStatus: 200 | 201;
+    /** Build per-table schemas (body, params, querystring, response). Response is wrapped with `{ [successStatus]: ... }` automatically. */
+    schemas: (dbTables: DbTables, tableName: string, tableConf: ITable) => RouteSchema;
+    summary: string;
+    description: (tableName: string, tableConf: ITable, schemas: RouteSchema) => string;
+    /** Translates the request to a sqlApi call. If it does not call reply.send/status itself,
+     * the registrar will reply.status(successStatus).send(returnValue). */
+    handle: (fastify: FastifyInstance, tableName: string, tableConf: ITable, request: FastifyRequest, reply: FastifyReply) => Promise<unknown>;
+}
+/**
+ * Iterates over every table in `options.DbTables` and registers one Fastify route for it
+ * following `spec`. Centralizes onRequest hook merging, tags, schema response wrapping,
+ * default reply when handler returns a value.
+ */
+export declare function registerForAllTables(fastify: FastifyInstance, options: SqlApiPluginOptions, spec: AutoRouteSpec): Promise<void>;
 export {};
 //# sourceMappingURL=route-helpers.d.ts.map

package/dist/routes/auto/route-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"route-helpers.d.ts","sourceRoot":"","sources":["../../../src/routes/auto/route-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC5D,OAAO,KAAK,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAElE,KAAK,WAAW,GAAG,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,GAAG,YAAY,CAAC,CAAC;AAElG,wBAAgB,eAAe,CAAC,OAAO,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,GAAG,WAAW,EAAE,CAE9F;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAQlG"}
+{"version":3,"file":"route-helpers.d.ts","sourceRoot":"","sources":["../../../src/routes/auto/route-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,KAAK,EAAE,MAAM,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE5E,KAAK,WAAW,GAAG,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,GAAG,YAAY,CAAC,CAAC;AAElG,wBAAgB,eAAe,CAAC,OAAO,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,GAAG,WAAW,EAAE,CAE9F;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAQlG;AAED,UAAU,WAAW;IAEnB,IAAI,CAAC,EAAE,GAAG,CAAC;IAEX,MAAM,CAAC,EAAE,GAAG,CAAC;IAEb,WAAW,CAAC,EAAE,GAAG,CAAC;IAElB,QAAQ,CAAC,EAAE,GAAG,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC;IAC1C,gFAAgF;IAChF,GAAG,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC;IACnC,aAAa,EAAE,GAAG,GAAG,GAAG,CAAC;IACzB,wIAAwI;IACxI,OAAO,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,WAAW,CAAC;IACnF,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,KAAK,MAAM,CAAC;IACpF;2EACuE;IACvE,MAAM,EAAE,CACN,OAAO,EAAE,eAAe,EACxB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,YAAY,KAChB,OAAO,CAAC,OAAO,CAAC,CAAC;CACvB;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,mBAAmB,EAC5B,IAAI,EAAE,aAAa,GAClB,OAAO,CAAC,IAAI,CAAC,CA8Bf"}

package/dist/routes/auto/route-helpers.js

@@ -3,10 +3,48 @@ export function mergeOnRequests(options, tableConf) {
 }
 export function buildWriteDescription(action, tableName, tableConf) {
     const joinList = tableConf.allowedWriteJoins
-        ?.map(([joinSchema]) => joinSchema.tableName)
+        ?.map((j) => j.alias)
         .join(', ');
     return [
         `${action} ${tableName}`,
         joinList && `Available secondaries: ${joinList}`,
     ].filter(Boolean).join('. ');
 }
+/**
+ * Iterates over every table in `options.DbTables` and registers one Fastify route for it
+ * following `spec`. Centralizes onRequest hook merging, tags, schema response wrapping,
+ * default reply when handler returns a value.
+ */
+export async function registerForAllTables(fastify, options, spec) {
+    const { DbTables } = options;
+    for (const [tableName, tableConf] of Object.entries(DbTables)) {
+        const schemas = spec.schemas(DbTables, tableName, tableConf);
+        // Only include schema keys that are actually defined: Fastify checks for key
+        // *presence* (not undefined value) to decide whether to emit FSTWRN001.
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const schema = {
+            tags: [`SqlAPI-${tableName}`],
+            summary: `${spec.summary} ${tableName}`,
+            description: spec.description(tableName, tableConf, schemas),
+        };
+        if (schemas.body !== undefined)
+            schema.body = schemas.body;
+        if (schemas.params !== undefined)
+            schema.params = schemas.params;
+        if (schemas.querystring !== undefined)
+            schema.querystring = schemas.querystring;
+        if (schemas.response !== undefined)
+            schema.response = { [spec.successStatus]: schemas.response };
+        fastify.route({
+            method: spec.method,
+            url: spec.url(tableConf),
+            schema,
+            onRequest: mergeOnRequests(options, tableConf),
+            handler: async (request, reply) => {
+                const result = await spec.handle(fastify, tableName, tableConf, request, reply);
+                if (!reply.sent)
+                    reply.status(spec.successStatus).send(result);
+            },
+        });
+    }
+}

package/dist/routes/auto/search.routes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"search.routes.d.ts","sourceRoot":"","sources":["../../../src/routes/auto/search.routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAG/C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE1D,wBAA8B,YAAY,CACxC,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAoDf"}
+{"version":3,"file":"search.routes.d.ts","sourceRoot":"","sources":["../../../src/routes/auto/search.routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAG/C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE1D,wBAA8B,YAAY,CACxC,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAiDf"}

package/dist/routes/auto/search.routes.js

@@ -1,50 +1,50 @@
 import { SearchTableBodyPost, SearchTableQueryString, SearchTableResponse } from '../../lib/schema/search.js';
-import { mergeOnRequests } from './route-helpers.js';
+import { registerForAllTables } from './route-helpers.js';
 export default async function searchRoutes(fastify, options) {
-    const { DbTables } = options;
-    for (const [tableName, tableConf] of Object.entries(DbTables)) {
-        const bodySchema = SearchTableBodyPost(DbTables, tableName);
-        const responseSchema = SearchTableResponse(DbTables, tableName);
-        const joinList = Object.keys(bodySchema.properties.joins?.properties || {}).join(', ');
-        const description = [
-            `Search records in ${tableName}`,
-            joinList && `Available joins: ${joinList}`,
-        ].filter(Boolean).join('. ');
-        fastify.route({
-            method: 'POST',
-            url: `/search/${tableConf.Schema.tableName}`,
-            schema: {
-                body: bodySchema,
-                querystring: SearchTableQueryString,
-                response: { 200: responseSchema },
-                tags: [`SqlAPI-${tableName}`],
-                summary: `Search ${tableName}`,
-                description,
-            },
-            onRequest: mergeOnRequests(options, tableConf),
-            handler: async (request, reply) => {
-                const body = request.body;
-                const query = request.query;
-                const result = await fastify.sqlApi.search(tableName, {
-                    filters: body.filters,
-                    conditions: body.conditions,
-                    joinFilters: body.joinFilters,
-                    joins: body.joins,
-                    joinGroups: body.joinGroups,
-                    orderBy: query.orderBy,
-                    paginator: (query.page || query.itemsPerPage)
-                        ? {
-                            page: query.page || 1,
-                            itemsPerPage: query.itemsPerPage || 500,
-                        }
-                        : undefined,
-                    computeMin: query.computeMin,
-                    computeMax: query.computeMax,
-                    computeSum: query.computeSum,
-                    computeAvg: query.computeAvg,
-                }, request);
-                reply.send({ table: tableConf.Schema.tableName, ...result });
-            },
-        });
-    }
+    await registerForAllTables(fastify, options, {
+        method: 'POST',
+        url: (tc) => `/search/${tc.Schema.tableName}`,
+        successStatus: 200,
+        schemas: (db, table) => ({
+            body: SearchTableBodyPost(db, table),
+            querystring: SearchTableQueryString,
+            response: SearchTableResponse(db, table),
+        }),
+        summary: 'Search',
+        description: (name, _tc, schemas) => {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const body = schemas.body;
+            const multiAliases = Object.keys(body?.properties?.joinMultiple?.properties || {});
+            const leftAliases = Object.keys(body?.properties?.joinLeft?.properties || {});
+            return [
+                `Search records in ${name}`,
+                multiAliases.length && `Available joinMultiple/joinMustExist/joinGroup aliases: ${multiAliases.join(', ')}`,
+                leftAliases.length && `Available joinLeft aliases: ${leftAliases.join(', ')}`,
+            ].filter(Boolean).join('. ');
+        },
+        handle: async (fastify, tableName, tc, request) => {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const body = request.body;
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const query = request.query;
+            const result = await fastify.sqlApi.search(tableName, {
+                filters: body.filters,
+                conditions: body.conditions,
+                joinMustExist: body.joinMustExist,
+                joinMultiple: body.joinMultiple,
+                joinGroup: body.joinGroup,
+                joinLeft: body.joinLeft,
+                selectComputed: body.selectComputed,
+                orderBy: query.orderBy,
+                paginator: (query.page || query.itemsPerPage)
+                    ? { page: query.page || 1, itemsPerPage: query.itemsPerPage || 500 }
+                    : undefined,
+                computeMin: query.computeMin,
+                computeMax: query.computeMax,
+                computeSum: query.computeSum,
+                computeAvg: query.computeAvg,
+            }, request);
+            return { table: tc.Schema.tableName, ...result };
+        },
+    });
 }

package/dist/routes/auto/update.routes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update.routes.d.ts","sourceRoot":"","sources":["../../../src/routes/auto/update.routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAG/C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE1D,wBAA8B,YAAY,CACxC,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAmCf"}
+{"version":3,"file":"update.routes.d.ts","sourceRoot":"","sources":["../../../src/routes/auto/update.routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAG/C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE1D,wBAA8B,YAAY,CACxC,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAwBf"}

package/dist/routes/auto/update.routes.js

@@ -1,30 +1,23 @@
 import { UpdateTableBody, UpdateTableResponse } from '../../lib/schema/update.js';
-import { mergeOnRequests, buildWriteDescription } from './route-helpers.js';
+import { registerForAllTables, buildWriteDescription } from './route-helpers.js';
 export default async function updateRoutes(fastify, options) {
-    const { DbTables } = options;
-    for (const [tableName, tableConf] of Object.entries(DbTables)) {
-        const bodySchema = UpdateTableBody(DbTables, tableName);
-        const responseSchema = UpdateTableResponse(DbTables, tableName);
-        fastify.route({
-            method: 'PUT',
-            url: `/rest/${tableConf.Schema.tableName}`,
-            schema: {
-                body: bodySchema,
-                response: { 200: responseSchema },
-                tags: [`SqlAPI-${tableName}`],
-                summary: `Update ${tableName}`,
-                description: buildWriteDescription('Update a record in', tableName, tableConf),
-            },
-            onRequest: mergeOnRequests(options, tableConf),
-            handler: async (request, reply) => {
-                const body = request.body;
-                const result = await fastify.sqlApi.update(tableName, {
-                    record: body.main,
-                    secondaries: body.secondaries,
-                    deletions: body.deletions,
-                }, request);
-                reply.send(result);
-            },
-        });
-    }
+    await registerForAllTables(fastify, options, {
+        method: 'PUT',
+        url: (tc) => `/rest/${tc.Schema.tableName}`,
+        successStatus: 200,
+        schemas: (db, table) => ({
+            body: UpdateTableBody(db, table),
+            response: UpdateTableResponse(db, table),
+        }),
+        summary: 'Update',
+        description: (name, tc) => buildWriteDescription('Update a record in', name, tc),
+        handle: (fastify, tableName, _tc, request) => {
+            const body = request.body;
+            return fastify.sqlApi.update(tableName, {
+                record: body.main,
+                secondaries: body.secondaries,
+                deletions: body.deletions,
+            }, request);
+        },
+    });
 }

package/dist/types/cli.d.ts

@@ -0,0 +1,22 @@
+import type { DialectName } from '../lib/dialect.js';
+export interface SqlApiConfig {
+    outputDir: string;
+    schema?: string;
+    dialect?: DialectName;
+    envFile?: string;
+}
+export interface ColumnInfo {
+    table_name: string;
+    column_name: string;
+    udt_name: string;
+    column_default: string | null;
+    is_nullable: string;
+}
+export interface TableMap {
+    [schemaName: string]: {
+        name: string;
+        fields: Record<string, string>;
+        colMap: Record<string, string>;
+    };
+}
+//# sourceMappingURL=cli.d.ts.map

package/dist/types/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/types/cli.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,QAAQ;IACvB,CAAC,UAAU,EAAE,MAAM,GAAG;QACpB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAChC,CAAC;CACH"}

package/dist/types/cli.js

@@ -0,0 +1 @@
+export {};

package/dist/types/computed.d.ts

@@ -0,0 +1,29 @@
+import type { TSchema } from '@sinclair/typebox';
+import type { QueryClient } from '../lib/db.js';
+/**
+ * Context passed to ComputedFieldFn when the engine resolves a computed field.
+ * - `db` exposes dialect-aware helpers (qi, ph, dialectName, dateTrunc, ...).
+ * - `qiCol(field, opts?)` returns a quoted column reference, optionally
+ *   prefixed by an alias qualifier — needed when the computed is embedded in
+ *   a `LEFT JOIN <table> AS <alias>` (joinLeft).
+ */
+export interface ComputedFieldContext {
+    db: QueryClient;
+    qiCol(field: string, opts?: {
+        qualifier?: string;
+    }): string;
+}
+/**
+ * Result returned by a ComputedFieldFn.
+ *  - `expr`: SQL fragment usable as a scalar expression.
+ *  - `values`: bound parameter values (always parameterized — never interpolate
+ *    user-derived data into `expr`).
+ *  - `type`: TypeBox schema for Swagger filters and main response (REQUIRED).
+ */
+export interface ComputedFieldExpr {
+    expr: string;
+    values: unknown[];
+    type: TSchema;
+}
+export type ComputedFieldFn = (ctx: ComputedFieldContext) => ComputedFieldExpr;
+//# sourceMappingURL=computed.d.ts.map

package/dist/types/computed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"computed.d.ts","sourceRoot":"","sources":["../../src/types/computed.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,WAAW,CAAC;IAChB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,CAAC;CAC7D;AAED;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,EAAE,CAAC;IAClB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,MAAM,eAAe,GAAG,CAAC,GAAG,EAAE,oBAAoB,KAAK,iBAAiB,CAAC"}

package/dist/types/computed.js

@@ -0,0 +1 @@
+export {};

package/dist/types/conditions.d.ts

@@ -0,0 +1,16 @@
+import type { ConditionBuilder as CB } from 'node-condition-builder';
+type SingleValueMethods = 'isEqual' | 'isNotEqual' | 'isGreater' | 'isNotGreater' | 'isGreaterOrEqual' | 'isNotGreaterOrEqual' | 'isLess' | 'isNotLess' | 'isLessOrEqual' | 'isNotLessOrEqual' | 'isLike' | 'isNotLike' | 'isILike' | 'isNotILike';
+type BetweenMethods = 'isBetween' | 'isNotBetween';
+type InMethods = 'isIn' | 'isNotIn';
+type NullMethods = 'isNull' | 'isNotNull';
+export type ConditionMethod = SingleValueMethods | BetweenMethods | InMethods | NullMethods;
+type ConditionParams<M extends ConditionMethod> = M extends SingleValueMethods ? [value: Parameters<CB[M]>[1]] : M extends BetweenMethods ? [from: Parameters<CB[M]>[1], to: Parameters<CB[M]>[2]] : M extends InMethods ? [values: Parameters<CB[M]>[1]] : M extends NullMethods ? [] : never;
+export type SearchCondition<F extends string = string> = {
+    [M in ConditionMethod]: {
+        field: F;
+        method: M;
+        params: ConditionParams<M>;
+    };
+}[ConditionMethod];
+export {};
+//# sourceMappingURL=conditions.d.ts.map

package/dist/types/conditions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conditions.d.ts","sourceRoot":"","sources":["../../src/types/conditions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,IAAI,EAAE,EAAE,MAAM,wBAAwB,CAAC;AAGrE,KAAK,kBAAkB,GACnB,SAAS,GAAG,YAAY,GACxB,WAAW,GAAG,cAAc,GAAG,kBAAkB,GAAG,qBAAqB,GACzE,QAAQ,GAAG,WAAW,GAAG,eAAe,GAAG,kBAAkB,GAC7D,QAAQ,GAAG,WAAW,GAAG,SAAS,GAAG,YAAY,CAAC;AAGtD,KAAK,cAAc,GAAG,WAAW,GAAG,cAAc,CAAC;AAGnD,KAAK,SAAS,GAAG,MAAM,GAAG,SAAS,CAAC;AAGpC,KAAK,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;AAE1C,MAAM,MAAM,eAAe,GAAG,kBAAkB,GAAG,cAAc,GAAG,SAAS,GAAG,WAAW,CAAC;AAG5F,KAAK,eAAe,CAAC,CAAC,SAAS,eAAe,IAC5C,CAAC,SAAS,kBAAkB,GAAG,CAAC,KAAK,EAAE,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAC5D,CAAC,SAAS,cAAc,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GACjF,CAAC,SAAS,SAAS,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GACpD,CAAC,SAAS,WAAW,GAAG,EAAE,GAC1B,KAAK,CAAC;AAER,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI;KACtD,CAAC,IAAI,eAAe,GAAG;QAAE,KAAK,EAAE,CAAC,CAAC;QAAC,MAAM,EAAE,CAAC,CAAC;QAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC,CAAA;KAAE;CAC5E,CAAC,eAAe,CAAC,CAAC"}

package/dist/types/conditions.js

@@ -0,0 +1 @@
+export {};